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