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. 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 TX51 module.
  12       E.g. TX53-8031 => 'make tx53-xx31_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.kernelconcepts.de/karo-tx-uboot.git master
  22
  23
  24 Compiling U-Boot
  25 ----------------
  26 export ARCH=arm
  27 export CROSS_COMPILE=arm-cortexa8-linux-gnueabi-
  28 make tx53-xx3?_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 and program it like any other flash
  36 partition with:
  37 nand erase.part u-boot;nand write ${fileaddr} u-boot ${filesize}
  38
  39 If you want to revive a bricked module, you can use one of the
  40 flashtools provided with the BSP to reprogram the flash.
  41
  42
  43 U-Boot Features
  44 ---------------
  45
  46 Environment variables:
  47
  48 cpu_clk       <CPU freq [MHz]>
  49 touchpanel    {tsc2007|edt-ft5x06}
  50 otg_mode      [host|device|none]
  51 video_mode    <video mode as understood by Linux fb_find_mode() function>
  52               e.g.: VGA-1:640x480MR-24@60
  53 baseboard     {stk5-v3|stk5-v5} selects type of baseboard
  54               'stk5-v5' setting enables CAN transceiver switch on GPIO4_21 and
  55               disables USB Host mode on USBOTG port.
  56               strings not starting in 'stk5' prevent the STK5 specific
  57               pad initialization to be done.
  58 splashimage   either: memory address (e.g. ${loadaddr}) of a BMP file
  59               to be displayed instead of the built-in logo. Since NAND
  60               flash is not accessible in a memory mapped fashion,
  61               U-Boot will try to load the contents of the flash
  62               partition 'logo.bmp' to the address given with
  63               'splashimage'.
  64
  65               or: the name of an MTD partition, that contains a raw
  66               dump of the frame buffer contents which will be loaded
  67               to the framebuffer.
  68
  69 splashpos     (when 'splashimage' contains a memory address) the
  70               position ('x,y') on the screen at which the BMP image
  71               will be displayed.
  72               Setting splashpos to 'm,m' will center the image on the
  73               screen.
  74
  75 Note: Some variables (like 'cpu_clk' or 'splashimage') may render the
  76       board unbootable if incorrectly set. Therefore these variables
  77       will not be evaluated in case the board has been reset through a
  78       watchdog reset or a character is available on the serial console
  79       during startup to give the user a chance to recover from this
  80       situation.