doc/README.KARO-TX48

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