NAME

       kwboot - Boot Marvell Kirkwood SoCs over a serial link.

SYNOPSIS

       kwboot [-b image] [-p] [-t] [-B baudrate] TTY

DESCRIPTION

       The  mkimage  program  boots boards based on Marvell's Kirkwood platform over their integrated UART. Boot
       image files will typically contain a second stage boot loader,  such  as  U-Boot.  The  image  file  must
       conform to Marvell's BootROM firmware image format (kwbimage), created using a tool such as mkimage.

       Following  power-up  or  a  system  reset, system BootROM code polls the UART for a brief period of time,
       sensing a handshake message which initiates an image upload. This program sends this boot  message  until
       it receives a positive acknowledgement. The image is transferred using Xmodem.

       Additionally,  this  program  implements a minimal terminal mode, which can be used either standalone, or
       entered immediately following boot image transfer completion. This is often useful to  catch  early  boot
       messages, or to manually interrupt a default boot procedure performed by the second-stage loader.

OPTIONS

       -b image
              Handshake; then upload file image over TTY.

              Note that for the encapsulated boot code to be executed, image must be of type "UART boot" (0x69).
              Boot images of different types, such as backup images of vendor  firmware  downloaded  from  flash
              memory (type 0x8B), will not work (or not as expected). See -p for a workaround.

              This mode writes handshake status and upload progress indication to stdout.

       -p     In combination with -b, patches the header in image prior to upload, to "UART boot" type.

              This  option  attempts  on-the-fly  conversion of some none-UART image types, such as images which
              were originally formatted to be stored in flash memory.

              Conversion is performed in memory. The contents of image will not be altered.

       -t     Run a terminal program, connecting standard input and output to TTY.

              If used in combination with -b, terminal mode is entered immediately following a successful  image
              upload.

              If  standard  I/O  streams connect to a console, this mode will terminate after receiving 'ctrl-\'
              followed by 'c' from console input.

       -B baudrate
              Adjust the baud rate on TTY. Default rate is 115200.

SEE ALSO

       mkimage(1)

AUTHORS

       Daniel Stodden <daniel.stodden@gmail.com>
       Luka Perkov <luka@openwrt.org>
       David Purdy <david.c.purdy@gmail.com>

                                                   2012-05-19                                          KWBOOT(1)