board/boundary/nitrogen6x/README

   1 U-Boot for the Boundary Devices Nitrogen6X and
   2 Freescale i.MX6Q SabreLite boards
   3
   4 This file contains information for the port of
   5 U-Boot to the Boundary Devices Nitrogen6X and
   6 Freescale i.MX6Q SabreLite boards.
   7
   8 1. Boot source, boot from SPI NOR
   9 ---------------------------------
  10 The configuration in this directory supports both the
  11 Nitrogen6X and Freescale SabreLite board, but in a
  12 different fashion from Freescale's implementation in
  13 board/freescale/mx6qsabrelite.
  14
  15 In particular, this image supports booting from SPI NOR
  16 and saving the environment to SPI NOR.
  17
  18 It does not support 'boot from SD' at offset 0x400
  19 except through the 'bmode' command.
  20         http://lists.denx.de/pipermail/u-boot/2012-August/131151.html
  21
  22 2. Boots using 6x_bootscript on SATA or SD card
  23 -----------------------------------------------
  24 The default bootcmd for these boards is configured
  25 to look for and source a boot script named '6x_bootscript'
  26 in the root of the first partition of the following
  27 devices:
  28
  29         sata 0
  30         mmc 0
  31         mmc 1
  32
  33 They're searched in the order listed above, trying both the
  34 ext2 and fat filesystems.
  35
  36 2. Maintaining the SPI NOR
  37 --------------------------
  38 A couple of convenience commands
  39
  40         clearenv - clear environment to factory default
  41         upgradeu - look and source a boot script named
  42                 '6x_upgrade' to upgrade the U-Boot version
  43                 in SPI NOR. The search is the same as for
  44                 6x_bootscript described above.
  45
  46 3. Display support
  47 ------------------
  48 U-Boot support for the following displays is configured by
  49 default:
  50
  51     HDMI           - 1024 x 768 for maximum compatibility
  52     Hannstar-XGA   - 1024 x 768 LVDS (Freescale part number MCIMX-LVDS1)
  53     wsvga-lvds     - 1024 x 600 LVDS (Boundary p/n Nit6X_1024x600)
  54     wvga-rgb       - 800 x 480 RGB (Boundary p/n Nit6X_800x480)
  55
  56 Since the ipuv3_fb display driver currently supports only a single display,
  57 this code auto-detects panel by probing the HDMI Phy for Hot Plug Detect
  58 or the I2C touch controller of the LVDS and RGB displays in the priority
  59 listed above.
  60
  61 Setting 'panel' environment variable to one of the names above will
  62 override auto-detection and force activation of the specified panel.
  63
  64 4. Building
  65 ------------
  66
  67 To build U-Boot for one of the Nitrogen6x or SabreLite board:
  68
  69         make nitrogen6x_config
  70         make
  71
  72 Note that 'nitrogen6x' is a placeholder. The complete list of supported
  73 board configurations is shown in the boards.cfg file:
  74         nitrogen6q              i.MX6Q/6D       1GB
  75         nitrogen6dl             i.MX6DL         1GB
  76         nitrogen6s              i.MX6S          512MB
  77         nitrogen6q2g            i.MX6Q/6D       2GB
  78         nitrogen6dl2g           i.MX6DL         2GB
  79         nitrogen6s1g            i.MX6S          1GB
  80
  81 The -6q variants support either the i.MX6Quad or i.MX6Dual processors
  82 and are configured for a 64-bit memory bus at 1066 MHz.
  83
  84 The -6dl variants also use a 64-bit memory bus, operated at 800MHz.
  85
  86 The -6s variants use a 32-bit memory bus at 800MHz.
  87
  88 If you place the u-boot.imx into a single-partition SD card
  89 along with a binary version of the boot script 6x_upgrade.txt,
  90 you can program it using 'upgradeu':
  91
  92         U-Boot> run upgradeu