blob: 973b18fa93f424e77817457d2fac23c7c0b2c3c7 [file] [log] [blame]
Eric Nelsond67b0d92013-03-11 08:44:53 +00001U-Boot for the Boundary Devices Nitrogen6X and
2Freescale i.MX6Q SabreLite boards
3
4This file contains information for the port of
5U-Boot to the Boundary Devices Nitrogen6X and
6Freescale i.MX6Q SabreLite boards.
7
81. Boot source, boot from SPI NOR
9---------------------------------
10The configuration in this directory supports both the
11Nitrogen6X and Freescale SabreLite board, but in a
12different fashion from Freescale's implementation in
13board/freescale/mx6qsabrelite.
14
15In particular, this image supports booting from SPI NOR
16and saving the environment to SPI NOR.
17
18It does not support 'boot from SD' at offset 0x400
19except through the 'bmode' command.
20 http://lists.denx.de/pipermail/u-boot/2012-August/131151.html
21
222. Boots using 6x_bootscript on SATA or SD card
23-----------------------------------------------
24The default bootcmd for these boards is configured
25to look for and source a boot script named '6x_bootscript'
26in the root of the first partition of the following
27devices:
28
29 sata 0
30 mmc 0
31 mmc 1
32
33They're searched in the order listed above, trying both the
34ext2 and fat filesystems.
35
362. Maintaining the SPI NOR
37--------------------------
38A 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
463. Display support
47------------------
48U-Boot support for the following displays is configured by
49default:
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
56Since the ipuv3_fb display driver currently supports only a single display,
57this code auto-detects panel by probing the HDMI Phy for Hot Plug Detect
58or the I2C touch controller of the LVDS and RGB displays in the priority
59listed above.
60
61Setting 'panel' environment variable to one of the names above will
62override auto-detection and force activation of the specified panel.
63
644. Building
65------------
66
67To build U-Boot for one of the Nitrogen6x or SabreLite board:
68
69 make nitrogen6x_config
Fabio Estevam7aa378e2014-01-24 09:15:47 -020070 make
Eric Nelsond67b0d92013-03-11 08:44:53 +000071
72Note that 'nitrogen6x' is a placeholder. The complete list of supported
Fabio Estevamfd5cc212014-01-24 09:27:37 -020073board configurations is shown in the boards.cfg file:
Eric Nelsond67b0d92013-03-11 08:44:53 +000074 nitrogen6q i.MX6Q/6D 1GB
75 nitrogen6dl i.MX6DL 1GB
76 nitrogen6s i.MX6S 512MB
Wolfgang Denk0cf207e2021-09-27 17:42:39 +020077 nitrogen6q2g i.MX6Q/6D 2GB
Eric Nelsond67b0d92013-03-11 08:44:53 +000078 nitrogen6dl2g i.MX6DL 2GB
79 nitrogen6s1g i.MX6S 1GB
80
81The -6q variants support either the i.MX6Quad or i.MX6Dual processors
82and are configured for a 64-bit memory bus at 1066 MHz.
83
84The -6dl variants also use a 64-bit memory bus, operated at 800MHz.
85
86The -6s variants use a 32-bit memory bus at 800MHz.
87
88If you place the u-boot.imx into a single-partition SD card
89along with a binary version of the boot script 6x_upgrade.txt,
90you can program it using 'upgradeu':
91
92 U-Boot> run upgradeu