README
Fedora ARM Tools
=================

arm-image-installer
-------------------

This script will automate the process of preparing a Fedora
ARM disk image for use with various hardware targets.

 - Write the selected disk image to media (optional)
 - customize media with platform specific U-Boot file(s)
 - Turn SE Linux on and off
 - Remove the root password
 - Update U-Boot for another Target
 
To add additional support, create a code snippet file 
(bash script) in the "boards.d" subdirectory with the commands 
needed to write U-Boot for the target board. 

Usage: arm-image-installer <options>

   --image=IMAGE    - xz compressed image file name
   --target=TARGET  - target board
		      [Bananapi|beaglebone|Cubieboard|Cubieboard2|Cubietruck|Mele_A1000|Mele_A1000G|panda|trimslice|wandboard_dual|wandboard_quad|wandboard_solo]
   --media=DEVICE   - media device file (/dev/[sdX|mmcblkX])
   --selinux=ON/OFF - Turn SELinux off/on as needed
   --norootpass     - Remove the root password
    -y		    - Assumes yes, will not wait for confirmation
   --version	    - Display version and exit

Example: arm-image-installer --image=Fedora-Rawhide.xz --target=panda --media=/dev/mmcblk0 --selinux=OFF


create-install-media
--------------------

Create network installation media for supported ARM devices. This script will format specified media, rsync the 
pxeimages directory from the Fedora 22 Alpha release and create a custom 'extlinux.conf' for a network installation.
Requires U-Boot be written to mSD/SD on target platform. Tested on USB with Cubietruck and Banana Pi. 

Usage: create-install-media <options>

   --media=DEVICE   - media device file (/dev/[sdX|mmcblkX])
   --url=URL	    - Optional URL, Mastermirror used as default

Example: create-install-media --media=/dev/mmcblk0


update-uboot
------------

Update to a new u-boot on a disk image from a local host install. Optionally download a specified
newer u-boot from koji by specifying a koji tag.

Usage: update-uboot <options>

   --target=TARGET  - target board
                      [Bananapi|beaglebone|Cubieboard|Cubieboard2|Cubietruck|Mele_A1000|Mele_A1000G|panda|trimslice|wandboard_dual|wandboard_quad|wandboard_solo]
   --media=DEVICE   - media device file (/dev/[sdX|mmcblkX])
   --tag=KOJI TAG   - koji tag (Default is f22. f21, f21-updates etc..)

Example: update-uboot --target=panda --media=/dev/mmcblk0