blob: ea81279a0f336485b7f9ba3eff24d8e2b8a9c150 [file] [log] [blame]
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -05001Summary
2=======
3
Bartosz Golaszewski655d2162019-04-30 09:39:25 +02004Note: 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.
6
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.
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -05009
10Currently the following boards are supported:
11
Sekhar Nori718f7462010-11-19 11:39:46 -050012* TI DA850 EVM
13
Bartosz Golaszewski655d2162019-04-30 09:39:25 +020014* TI OMAP-L138 LCDK
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -050015
Bartosz Golaszewski655d2162019-04-30 09:39:25 +020016* Lego EV3
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -050017
18Build
19=====
20
Sekhar Nori718f7462010-11-19 11:39:46 -050021* TI DA850 EVM:
22
23make da850evm_config
24make
25
Bartosz Golaszewski655d2162019-04-30 09:39:25 +020026* TI OMAP-L138 LCDK
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -050027
Bartosz Golaszewski655d2162019-04-30 09:39:25 +020028make omapl138_lcdk_defconfig
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -050029make
30
Bartosz Golaszewski655d2162019-04-30 09:39:25 +020031* Lego EV3
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -050032
Bartosz Golaszewski655d2162019-04-30 09:39:25 +020033make legoev3_defconfig
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -050034make
35
36Bootloaders
37===============
38
Bartosz Golaszewski655d2162019-04-30 09:39:25 +020039For DA850 an SPL (secondary program loader, see doc/README.SPL) is provided
Adam Ford5f1600e2020-06-29 18:32:02 -050040to load U-Boot from SPI flash, MMC or NAND. The SPL takes care of the low level
Bartosz Golaszewski655d2162019-04-30 09:39:25 +020041initialization.
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -050042
Adam Ford5f1600e2020-06-29 18:32:02 -050043The 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.
Christian Riesch3d2c8e62011-12-09 09:47:37 +000049
Sekhar Nori4f6fc152010-11-19 11:39:48 -050050Environment 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
Tom Rini6e7df1d2023-01-10 11:19:45 -050061If "maxcpuclk" is not defined, the configuration CFG_DA850_EVM_MAX_CPU_CLK
Sekhar Nori4f6fc152010-11-19 11:39:48 -050062is used to obtain this information.
63
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -050064Links
65=====
66
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200671) TI DA850 EVM
Sekhar Nori718f7462010-11-19 11:39:46 -050068http://focus.ti.com/docs/prod/folders/print/omap-l138.html
69http://www.logicpd.com/products/development-kits/zoom-omap-l138-evm-development-kit
Heiko Schocher337c4332011-09-14 19:59:37 +000070
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200712) TI OMAP-L138 LCDK
72http://focus.ti.com/docs/prod/folders/print/omap-l138.html
Nishanth Menona94a4072023-11-01 15:56:03 -050073https://www.ti.com/tool/TMDXLCDK138
Bartosz Golaszewski655d2162019-04-30 09:39:25 +020074
Heiko Schocher337c4332011-09-14 19:59:37 +000075Davinci special defines
76=======================
77
Tom Rini65cc0e22022-11-16 13:10:41 -050078CFG_SYS_DV_NOR_BOOT_CFG: AM18xx based boards, booting in NOR Boot mode
Heiko Schocher337c4332011-09-14 19:59:37 +000079 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