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