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 following table lists the module names and the
  11       corresponding U-Boot configuration name:
  12
  13       Module Name               U-Boot config
  14       ---------------------------------------
  15       TX51-8xx0                 tx51-8xx0_config
  16       TX51-8xx1                 tx51-8xx1_2_config
  17       TX51-8xx2                 tx51-8xx1_2_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.kernelconcepts.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 tx51-8xx?_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
  53 cpu_clk       <CPU freq [MHz]>
  54 touchpanel    {tsc2007|edt-ft5x06}
  55 otg_mode      [host|device|none]
  56 video_mode    <video mode as understood by Linux fb_find_mode() function>
  57               e.g.: VGA-1:640x480MR-24@60
  58 baseboard     {stk5-v3|stk5-v5} selects type of baseboard
  59               'stk5-v5' setting disables USB Host mode on USBOTG port.
  60               strings not starting in 'stk5' prevent the STK5 specific
  61               pad initialization to be done.
  62 splashimage   either: memory address (e.g. ${loadaddr}) of a BMP file
  63               to be displayed instead of the built-in logo. Since NAND
  64               flash is not accessible in a memory mapped fashion,
  65               U-Boot will try to load the contents of the flash
  66               partition 'logo.bmp' to the address given with
  67               'splashimage'.
  68
  69               or: the name of an MTD partition, that contains a raw
  70               dump of the frame buffer contents which will be loaded
  71               to the framebuffer.
  72
  73 splashpos     (when 'splashimage' contains a memory address) the
  74               position ('x,y') on the screen at which the BMP image
  75               will be displayed.
  76               Setting splashpos to 'm,m' will center the image on the
  77               screen.
  78
  79 Note: Some variables (like 'cpu_clk' or 'splashimage') may render the
  80       board unbootable if incorrectly set. Therefore these variables
  81       will not be evaluated in case the board has been reset through a
  82       watchdog reset or a character is available on the serial console
  83       during startup to give the user a chance to recover from this
  84       situation.