xref: /openbmc/u-boot/doc/README.davinci (revision d9b23e26)
1Summary
2=======
3
4This README is about U-Boot support for TI's ARM 926EJS based family of SoCs.
5These SOCs are used for cameras, video security and surveillance, DVR's, etc.
6DaVinci SOC's comprise of DM644x, DM646x, DM35x and DM36x series of SOC's
7Additionally there are some SOCs meant for the audio market which though have
8an OMAP part number are very similar to the DaVinci series of SOC's
9Additionally, some family members contain a TI DSP and/or graphics
10co processors along with a host of other peripherals.
11
12Currently the following boards are supported:
13
14* TI DaVinci DM644x EVM
15
16* TI DaVinci DM646x EVM
17
18* TI DaVinci DM355 EVM
19
20* TI DaVinci DM365 EVM
21
22* TI DA830 EVM
23
24* TI DA850 EVM
25
26* DM355 based Leopard board
27
28* DM644x based schmoogie board
29
30* DM644x based sffsdr board
31
32* DM644x based sonata board
33
34Build
35=====
36
37* TI DaVinci DM644x EVM:
38
39make davinci_dvevm_config
40make
41
42* TI DaVinci DM646x EVM:
43
44make davinci_dm6467evm_config
45make
46
47* TI DaVinci DM355 EVM:
48
49make davinci_dm355evm_config
50make
51
52* TI DaVinci DM365 EVM:
53
54make davinci_dm365evm_config
55make
56
57* TI DA830 EVM:
58
59make da830evm_config
60make
61
62* TI DA850 EVM:
63
64make da850evm_config
65make
66
67* DM355 based Leopard board:
68
69make davinci_dm355leopard_config
70make
71
72* DM644x based schmoogie board:
73
74make davinci_schmoogie_config
75make
76
77* DM644x based sffsdr board:
78
79make davinci_sffsdr_config
80make
81
82* DM644x based sonata board:
83
84make davinci_sonata_config
85make
86
87Bootloaders
88===============
89
90The DaVinci SOC's use 2 bootloaders. The low level initialization
91is done by a UBL(user boot loader). The UBL is written to a NAND/NOR/SPI flash
92by a programmer. During initial bootup, the ROM Bootloader reads the UBL
93from a storage device and loads it into the IRAM. The UBL then loads the U-Boot
94into the RAM.
95The programmers and UBL are always released as part of any standard TI
96software release associated with an SOC.
97
98Alternative boot method (DA850 EVM only):
99For the DA850 EVM an SPL (secondary program loader, see doc/README.SPL)
100is provided to load U-Boot directly from SPI flash. In this case, the
101SPL does the low level initialization that is otherwise done by the SPL.
102To build U-Boot with this SPL, do
103make da850evm_config
104make u-boot.ais
105and program the resulting u-boot.ais file to the SPI flash of the DA850 EVM.
106
107Environment Variables
108=====================
109
110The DA850 EVM allows the user to specify the maximum cpu clock allowed by the
111silicon, in Hz, via an environment variable "maxcpuclk".
112
113The maximum clock rate allowed depends on the silicon populated on the EVM.
114Please make sure you understand the restrictions placed on this clock in the
115device specific datasheet before setting up this variable. This information is
116passed to the Linux kernel using the ATAG_REVISION atag.
117
118If "maxcpuclk" is not defined, the configuration CONFIG_DA850_EVM_MAX_CPU_CLK
119is used to obtain this information.
120
121Links
122=====
123
1241) TI DaVinci DM355 EVM:
125http://focus.ti.com/docs/prod/folders/print/tms320dm355.html
126http://www.spectrumdigital.com/product_info.php?cPath=103&products_id=203&osCsid=c499af6087317f11b3da19b4e8f1af32
127
1282) TI DaVinci DM365 EVM:
129http://focus.ti.com/docs/prod/folders/print/tms320dm365.html?247SEM=
130http://support.spectrumdigital.com/boards/evmdm365/revc/
131
1323) DaVinci DM355 based leopard board
133http://designsomething.org/leopardboard/default.aspx
134http://www.spectrumdigital.com/product_info.php?cPath=103&products_id=192&osCsid=67c20335668ffc57cb35727106eb24b1
135
1364) TI DaVinci DM6467 EVM:
137http://focus.ti.com/docs/prod/folders/print/tms320dm6467.html
138http://support.spectrumdigital.com/boards/evmdm6467/revf/
139
1405) TI DaVinci DM6446 EVM:
141http://focus.ti.com/docs/prod/folders/print/tms320dm6446.html
142http://www.spectrumdigital.com/product_info.php?cPath=103&products_id=222
143
1446) TI DA830 EVM
145http://focus.ti.com/apps/docs/gencontent.tsp?appId=1&contentId=52385
146http://www.spectrumdigital.com/product_info.php?cPath=37&products_id=214
147
1487) TI DA850 EVM
149http://focus.ti.com/docs/prod/folders/print/omap-l138.html
150http://www.logicpd.com/products/development-kits/zoom-omap-l138-evm-development-kit
151
152Davinci special defines
153=======================
154
155CONFIG_SYS_DV_NOR_BOOT_CFG:	AM18xx based boards, booting in NOR Boot mode
156				need a "NOR Boot Configuration Word" stored
157				in the NOR Flash. This define adds this.
158				More Info about this, see:
159				spraba5a.pdf chapter 3.1
160