]> git.ipfire.org Git - thirdparty/u-boot.git/blame - doc/README.davinci
Merge branch '2024-05-02-assorted-updates'
[thirdparty/u-boot.git] / doc / README.davinci
CommitLineData
6406d6da
SP
1Summary
2=======
3
655d216a
BG
4Note: this document used to be about the entire family of DaVinci SOCs but the
5support for the DM* family and DA830 has since been dropped.
6406d6da 6
655d216a
BG
7This README is about U-Boot support for TI's DA850 SoC. This SOC has an OMAP
8part number but is very similar to the DaVinci series.
6406d6da 9
655d216a 10Currently the following boards are supported:
6406d6da 11
718f7464
SN
12* TI DA850 EVM
13
655d216a 14* TI OMAP-L138 LCDK
6406d6da 15
655d216a 16* Lego EV3
6406d6da
SP
17
18Build
19=====
20
718f7464
SN
21* TI DA850 EVM:
22
23make da850evm_config
24make
25
655d216a 26* TI OMAP-L138 LCDK
6406d6da 27
655d216a 28make omapl138_lcdk_defconfig
6406d6da
SP
29make
30
655d216a 31* Lego EV3
6406d6da 32
655d216a 33make legoev3_defconfig
6406d6da
SP
34make
35
36Bootloaders
37===============
38
655d216a 39For DA850 an SPL (secondary program loader, see doc/README.SPL) is provided
5f1600e0 40to load U-Boot from SPI flash, MMC or NAND. The SPL takes care of the low level
655d216a
BG
41initialization.
42
5f1600e0
AF
43The SPL is built as u-boot.ais for all DA850 defconfigs except those booting
44from NOR flash. The resulting image file can be programmed to the SPI flash
45of the DA850 EVM/LCDK.
46
47Devices that support booting from NOR utilize execute in place (XIP) and do
48not require SPL to perform low level initialization.
3d2c8e6c 49
4f6fc15b
SN
50Environment Variables
51=====================
52
53The DA850 EVM allows the user to specify the maximum cpu clock allowed by the
54silicon, in Hz, via an environment variable "maxcpuclk".
55
56The maximum clock rate allowed depends on the silicon populated on the EVM.
57Please make sure you understand the restrictions placed on this clock in the
58device specific datasheet before setting up this variable. This information is
59passed to the Linux kernel using the ATAG_REVISION atag.
60
6e7df1d1 61If "maxcpuclk" is not defined, the configuration CFG_DA850_EVM_MAX_CPU_CLK
4f6fc15b
SN
62is used to obtain this information.
63
6406d6da
SP
64Links
65=====
66
655d216a 671) TI DA850 EVM
718f7464
SN
68http://focus.ti.com/docs/prod/folders/print/omap-l138.html
69http://www.logicpd.com/products/development-kits/zoom-omap-l138-evm-development-kit
337c4333 70
655d216a
BG
712) TI OMAP-L138 LCDK
72http://focus.ti.com/docs/prod/folders/print/omap-l138.html
a94a4071 73https://www.ti.com/tool/TMDXLCDK138
655d216a 74
337c4333
HS
75Davinci special defines
76=======================
77
65cc0e2a 78CFG_SYS_DV_NOR_BOOT_CFG: AM18xx based boards, booting in NOR Boot mode
337c4333
HS
79 need a "NOR Boot Configuration Word" stored
80 in the NOR Flash. This define adds this.
81 More Info about this, see:
82 spraba5a.pdf chapter 3.1