doc/README.KARO-TX28

   1                                         U-Boot for TX28
   2                                         ===============
   3
   4 Building U-Boot
   5 ---------------
   6
   7 Note: There are currently two variants of the TX28 module, that
   8       require slightly different U-Boot configurations. They are
   9       distinguished through the last digit of the module name. Replace
  10       the '?' in the following description with the corresponding
  11       number from your TX28 module.
  12       E.g. TX28-4031 => 'make tx28-40x1_config'
  13
  14 Unpacking the source
  15 --------------------
  16 mkdir u-boot
  17 cd u-boot
  18 tar -xjf /cdrom/U-Boot/u-boot-src.tar.bz2
  19
  20 Alternatively you can access the current source via the git repository:
  21 git://git.karo-electronics.de/karo-tx-uboot.git master
  22
  23
  24 Compiling U-Boot
  25 ----------------
  26 export ARCH=arm
  27 export CROSS_COMPILE=arm-926ejs-linux-gnueabi-
  28 make tx28-4?x?_config            (see above Note!)
  29 make
  30
  31
  32 Flashing U-Boot Image
  33 ---------------------
  34 If you want to replace a working U-Boot with a new version, you can
  35 load the new U-Boot image via TFTP or SD-Card and write it to flash
  36 with the 'romupdate' command.
  37
  38 If you want to revive a bricked module, U-Boot can be downloaded via
  39 USB with the 'sbloader' tool in recovery boot mode (Bootmode jumper ST3
  40 on Starterkit-5 baseboard closed). See TX28_U-Boot.pdf for details.
  41
  42 e.g.: /cdrom/Flashtools/Linux/sbloader/sbloader-x86_32 -s /cdrom/U-Boot/u-boot-tx28-4031.bin
  43 (This command can be used from within the ARMSK-VM)
  44
  45
  46 U-Boot Features
  47 ---------------
  48
  49 Environment variables:
  50 boot_mode     selects which boot script will be used by 'bootcmd' to
  51               boot the application (Linux)
  52               supported values:
  53               nand: (default) load kernel from NAND partition 'linux'
  54                               and mount rootfs (fstype UBIFS)
  55                               from partition 'rootfs'.
  56               mmc:            load kernel from file 'uImage' on first
  57                               partition (FAT) on (first) SD/MMC card
  58                               and mount rootfs (fstype autodetected)
  59                               from second partition.
  60               net:            load kernel image via tftp (file uImage)
  61                               and mount rootfs via NFS. This requires
  62                               the additional variables 'nfsroot'
  63                               (path to rootfs on NFS server) and
  64                               'nfs_server' (hostname or IP address of
  65                               NFS server) to be set.
  66               jffs2: (legacy) load kernel from NAND partition 'linux'
  67                               and mount rootfs (fstype JFFS2)
  68                               from partition 'rootfs'.
  69
  70 cpu_clk       <CPU freq [MHz]> CPU clock frequency set after boot.
  71
  72 touchpanel    {tsc2007|edt-ft5x06|imx28-lradc} type of touchpanel.
  73               No touchpanel will be enabled when unset.
  74
  75 otg_mode      [host|device|none] operation mode of the USBOTG port
  76
  77 video_mode    <one of the display names from the Glyn Family Concept or
  78               a video mode as understood by Linux fb_find_mode() function
  79               (e.g.: 640x480MR-24@60)>
  80               LCD interface will be disabled when unset.
  81
  82 baseboard     {stk5-v3|stk5-v5} selects type of baseboard
  83               'stk5-v5' setting disables USB Host mode on USBOTG port
  84               and redefines the LCD0 pin as CAN transceiver control pin.
  85               Strings not starting in 'stk5' prevent the STK5 specific
  86               pad initialization to be done.
  87
  88 splashimage   either: memory address (e.g. ${loadaddr}) of a BMP file
  89               to be displayed instead of the built-in logo. Since NAND
  90               flash is not accessible in a memory mapped fashion,
  91               U-Boot will try to load the contents of the flash
  92               partition 'logo.bmp' to the address given with
  93               'splashimage'.
  94
  95               or: the name of an MTD partition, that contains a raw
  96               dump of the frame buffer contents which will be loaded
  97               to the framebuffer.
  98
  99 splashpos     (when 'splashimage' contains a memory address) the
 100               position ('x,y') on the screen at which the BMP image
 101               will be displayed.
 102               Setting splashpos to 'm,m' will center the image on the
 103               screen.
 104
 105 Note: Some variables (like 'cpu_clk' or 'splashimage') may render the
 106       board unbootable if incorrectly set. Therefore these variables
 107       will not be evaluated in case the board has been reset through a
 108       watchdog reset or <CTRL-C> is detected on the serial console
 109       during startup to give the user a chance to recover from this
 110       situation. You should press and hold <CTRL-C> before applying
 111       power to the module, for this to work.