X-Git-Url: https://git.karo-electronics.de/?a=blobdiff_plain;f=doc%2FREADME.KARO-TX53;h=b20a7595a8591fc12443ea1b9e83413cf516fae9;hb=cbea103e903ae3b567c5c49d8d26f51e54f9e0ca;hp=2150204d917d1e596a507b8dda68979463952fc2;hpb=bb0f32d0bad65fc6948ce6032f9004a70e11fef4;p=karo-tx-uboot.git

diff --git a/doc/README.KARO-TX53 b/doc/README.KARO-TX53
index 2150204d91..b20a7595a8 100644
--- a/doc/README.KARO-TX53
+++ b/doc/README.KARO-TX53
@@ -5,11 +5,16 @@ Building U-Boot
 ---------------
 
 Note: There are currently two variants of the TX53 module, that
-      require slightly different U-Boot configurations. They are
-      distinguished through the last digit of the module name. Replace
-      the '?' in the following description with the corresponding
-      number from your TX51 module.
-      E.g. TX53-8031 => 'make tx53-xx31_config'
+      require slightly different U-Boot configurations. The mapping
+      between module names and U-Boot config make targets is as
+      following:
+
+      Module Name       U-Boot config target
+      =====================================
+      TX53-8030		tx53-x030_config'
+      TX53-8130		tx53-x130_config'
+      TX53-1030		tx53-x030_config'
+      TX53-1331		tx53-x131_config'
 
 Unpacking the source
 --------------------
@@ -17,11 +22,15 @@ mkdir u-boot
 cd u-boot
 tar -xjf /cdrom/U-Boot/u-boot-src.tar.bz2
 
+Alternatively you can access the current source via the git repository:
+git://git.karo-electronics.de/karo-tx-uboot.git master
+
+
 Compiling U-Boot
 ----------------
 export ARCH=arm
 export CROSS_COMPILE=arm-cortexa8-linux-gnueabi-
-make tx53-xx3?_config            (see above Note!)
+make tx53-x?3?_config            (see above Note!)
 make
 
 
@@ -40,26 +49,65 @@ U-Boot Features
 ---------------
 
 Environment variables:
+boot_mode     selects which boot script will be used by 'bootcmd' to
+	      boot the application (Linux)
+	      supported values:
+	      nand: (default) load kernel from NAND partition 'linux'
+			      and mount rootfs (fstype UBIFS)
+			      from partition 'rootfs'. 
+	      mmc:	      load kernel from file 'uImage' on first
+	      		      partition (FAT) on (first) SD/MMC card
+			      and mount rootfs (fstype autodetected)
+			      from second partition.
+	      net:	      load kernel image via tftp (file uImage)
+	      		      and mount rootfs via NFS. This requires
+			      the additional variables 'nfsroot'
+			      (path to rootfs on NFS server) and
+			      'nfs_server' (hostname or IP address of
+			      NFS server) to be set.
+	      jffs2: (legacy) load kernel from NAND partition 'linux'
+			      and mount rootfs (fstype JFFS2)
+			      from partition 'rootfs'.
+
+cpu_clk       <CPU freq [MHz]> CPU clock frequency set after boot.
+
+touchpanel    {tsc2007|edt-ft5x06|egalax_ts} type of touchpanel.
+	      No touchpanel will be enabled when unset.
+
+otg_mode      [host|device|none] operation mode of the USBOTG port
+
+video_mode    <one of the display names from the Glyn Family Concept or
+	      a video mode as understood by Linux fb_find_mode() function
+              (e.g.: 640x480MR-24@60)>
+	      LCD interface will be disabled when unset.
 
-cpu_clk       <CPU freq [MHz]>
-touchpanel    {tsc2007|edt-ft5x06}
-otg_mode      [host|device|none]
-video_mode    <video mode as understood by Linux fb_find_mode() function>
-              e.g.: VGA-1:640x480MR-24@60
 baseboard     {stk5-v3|stk5-v5} selects type of baseboard
-	      'stk5-v5' setting enables CAN transceiver switch on GPIO4_21 and
-	      disables USB Host mode on USBOTG port.
-	      strings not starting in 'stk5' prevent the STK5 specific
+	      'stk5-v5' setting disables USB Host mode on USBOTG port
+	      and redefines the LCD0 pin as CAN transceiver control pin.
+	      Strings not starting in 'stk5' prevent the STK5 specific
 	      pad initialization to be done.
-splashimage   memory address of a BMP file to be displayed instead of
-	      the built-in logo. Since NAND flash is not accessible in
-	      a memory mapped fashion, U-Boot will try to load the
-	      contents of the flash partition 'logo' to the address
-	      given with 'splashimage'.
+
+splashimage   either: memory address (e.g. ${loadaddr}) of a BMP file
+	      to be displayed instead of the built-in logo. Since NAND
+	      flash is not accessible in a memory mapped fashion,
+	      U-Boot will try to load the contents of the flash
+	      partition 'logo.bmp' to the address given with
+	      'splashimage'.
+
+	      or: the name of an MTD partition, that contains a raw
+	      dump of the frame buffer contents which will be loaded
+	      to the framebuffer.
+
+splashpos     (when 'splashimage' contains a memory address) the
+	      position ('x,y') on the screen at which the BMP image
+	      will be displayed.
+	      Setting splashpos to 'm,m' will center the image on the
+	      screen.
 
 Note: Some variables (like 'cpu_clk' or 'splashimage') may render the
       board unbootable if incorrectly set. Therefore these variables
       will not be evaluated in case the board has been reset through a
-      watchdog reset or a character is available on the serial console
+      watchdog reset or <CTRL-C> is detected on the serial console
       during startup to give the user a chance to recover from this
-      situation.
+      situation. You should press and hold <CTRL-C> before applying
+      power to the module, for this to work.