doc/README.KARO-TX51

   1                                         U-Boot for TX51
   2                                         ===============
   3
   4 Building U-Boot
   5 ---------------
   6
   7 Note: There are currently three variants of the TX51 module, that
   8       require slightly different U-Boot configurations. They are
   9       distinguished through the last digit of the module name
  10       suffix. The configuration names depending on the last digit of
  11       the module name are:
  12       TX51-8??0                 tx51-8xx0_config
  13       TX51-8??1                 tx51-8xx1_2_config
  14       TX51-8??2                 tx51-8xx1_2_config
  15
  16
  17 Unpacking the source
  18 --------------------
  19 mkdir u-boot
  20 cd u-boot
  21 tar -xjf /cdrom/U-Boot/u-boot-src.tar.bz2
  22
  23 Alternatively you can access the current source via the git repository:
  24 git://git.karo-electronics.de/karo-tx-uboot.git master
  25
  26
  27 Compiling U-Boot
  28 ----------------
  29 export ARCH=arm
  30 export CROSS_COMPILE=arm-cortexa8-linux-gnueabi-
  31 make tx51-8xx?_config            (see above Note!)
  32 make
  33
  34
  35 Flashing U-Boot Image
  36 ---------------------
  37 If you want to replace a working U-Boot with a new version, you can
  38 load the new U-Boot image via TFTP and program it like any other flash
  39 partition with:
  40 nand erase.part u-boot;nand write ${fileaddr} u-boot ${filesize}
  41
  42 If you want to revive a bricked module, you can use one of the
  43 flashtools provided with the BSP to reprogram the flash.
  44
  45
  46 U-Boot Features
  47 ---------------
  48
  49 Environment variables:
  50
  51 cpu_clk       <CPU freq [MHz]> CPU clock frequency set after boot.
  52
  53 touchpanel    {tsc2007|edt-ft5x06} type of touchpanel.
  54               No touchpanel will be enabled when unset.
  55
  56 otg_mode      [host|device|none] operation mode of the USBOTG port
  57
  58 video_mode    <one of the display names from the Glyn Family Concept or
  59               a video mode as understood by Linux fb_find_mode() function
  60               (e.g.: 640x480MR-24@60)>
  61               LCD interface will be disabled when unset.
  62
  63 baseboard     {stk5-v3|stk5-v5} selects type of baseboard
  64               'stk5-v5' setting disables USB Host mode on USBOTG port
  65               and redefines the LCD0 pin as CAN transceiver control pin.
  66               Strings not starting in 'stk5' prevent the STK5 specific
  67               pad initialization to be done.
  68
  69 splashimage   either: memory address (e.g. ${loadaddr}) of a BMP file
  70               to be displayed instead of the built-in logo. Since NAND
  71               flash is not accessible in a memory mapped fashion,
  72               U-Boot will try to load the contents of the flash
  73               partition 'logo.bmp' to the address given with
  74               'splashimage'.
  75
  76               or: the name of an MTD partition, that contains a raw
  77               dump of the frame buffer contents which will be loaded
  78               to the framebuffer.
  79
  80 splashpos     (when 'splashimage' contains a memory address) the
  81               position ('x,y') on the screen at which the BMP image
  82               will be displayed.
  83               Setting splashpos to 'm,m' will center the image on the
  84               screen.
  85
  86 Note: Some variables (like 'cpu_clk' or 'splashimage') may render the
  87       board unbootable if incorrectly set. Therefore these variables
  88       will not be evaluated in case the board has been reset through a
  89       watchdog reset or <CTRL-C> is detected on the serial console
  90       during startup to give the user a chance to recover from this
  91       situation. You should press and hold <CTRL-C> before applying
  92       power to the module, for this to work.