doc/README.KARO-TX53

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