README-kirkwood.txt							20121114

Note that some Kirkwood based devices do not consult the SD card for uboot
information, in which case the following commands must be entered and/or stored
in the uboot environment to load this image. Note, the root= paramaters may need
to be altered for your system:

For USB storage (to boot from the Nth USB device (numbered from 0) and
Pth partition (numbered from 1):
e.g. 0:1 for /dev/sda1, 2:3 for /dev/sdc3

Replace ROOT_DEV with the root filesystem details, e.g.:
root=/dev/sdb3, or root=LABEL=rootfs, or root=UUID=(UUID of partition)

  usb start
  ext2load usb N:P 0x6400000 uImage
  ext2load usb N:P 0x7400000 uInitrd
  setenv bootargs_sd console=ttyS0,115200 ro root=ROOT_DEV rootwait
  bootm 0x6400000 0x7400000

For SD storage (note the Dreamplug's SD cards appear as USB storage):

  mmcinit
  ext2load mmc 0:1 0x6400000 uImage
  ext2load mmc 0:1 0x7400000 uInitrd
  setenv bootargs_sd console=ttyS0,115200 ro root=/dev/mmcblk0p1 rootwait
  bootm 0x6400000 0x7400000

If your U-boot supports the source (or the earlier autoscr) command, then
boot.scr files can be used to automate the boot process.

If your U-boot uses the autoscr, replace instances of source below with autoscr.

To boot from the first/second/third USB device, use the boot.scr.usb[012]
uboot script files.

To boot from the mmc device, use the boot.scr.mmc uboot script file.

The commands to use are (where N is the nth USB device numbered from 0):
  usb start
  ext2load usb N:1 0x600000 boot.scr.usbN
  source 0x600000

or for mmc
  mmcinit
  ext2load mmc 0:1 0x600000 boot.scr.mmc
  source 0x600000

This can be automated for booting with the following uboot environment setting:

  bootcmd usb start; ext2load usb N:1 0x600000 boot.scr.usbN; source 0x600000

or

  bootcmd mmcinit; ext2load mmc 0:1 0x600000 boot.scr.mmc; source 0x600000

To create other boot script files, create a file boot.cmd.XXXX containing the
commands you want, using the boot.cmd.* files as templates, and then run:

/usr/bin/mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Kirkwood F18" -d boot.cmd.XXXX boot.scr.XXXX

Copy boot.scr.XXXX to the boot partition (/boot), and proceed as above.