doc/README.KARO-TX6

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