Gitiles
Code Review Sign In
gerrit.cesnet.cz / github / trini / u-boot / 52c0e5f8a39ef022ee5ab2dfd67661d1d34941c7 / . / doc / README.davinci
blob: ea81279a0f336485b7f9ba3eff24d8e2b8a9c150 [file] [log] [blame]
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -0500[diff] [blame]1Summary
2=======
3
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]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.
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 -0500[diff] [blame]9
10Currently the following boards are supported:
11
Sekhar Nori718f7462010-11-19 11:39:46 -0500[diff] [blame]12* TI DA850 EVM
13
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]14* TI OMAP-L138 LCDK
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -0500[diff] [blame]15
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]16* Lego EV3
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -0500[diff] [blame]17
18Build
19=====
20
Sekhar Nori718f7462010-11-19 11:39:46 -0500[diff] [blame]21* TI DA850 EVM:
22
23make da850evm_config
24make
25
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]26* TI OMAP-L138 LCDK
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -0500[diff] [blame]27
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]28make omapl138_lcdk_defconfig
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -0500[diff] [blame]29make
30
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]31* Lego EV3
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -0500[diff] [blame]32
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]33make legoev3_defconfig
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -0500[diff] [blame]34make
35
36Bootloaders
37===============
38
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]39For DA850 an SPL (secondary program loader, see doc/README.SPL) is provided
Adam Ford5f1600e2020-06-29 18:32:02 -0500[diff] [blame]40to load U-Boot from SPI flash, MMC or NAND. The SPL takes care of the low level
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]41initialization.
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -0500[diff] [blame]42
Adam Ford5f1600e2020-06-29 18:32:02 -0500[diff] [blame]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.
Christian Riesch3d2c8e62011-12-09 09:47:37 +0000[diff] [blame]49
Sekhar Nori4f6fc152010-11-19 11:39:48 -0500[diff] [blame]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
Tom Rini6e7df1d2023-01-10 11:19:45 -0500[diff] [blame]61If "maxcpuclk" is not defined, the configuration CFG_DA850_EVM_MAX_CPU_CLK
Sekhar Nori4f6fc152010-11-19 11:39:48 -0500[diff] [blame]62is used to obtain this information.
63
Sandeep Paulraj6406d6d2009-11-21 13:13:59 -0500[diff] [blame]64Links
65=====
66
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]671) TI DA850 EVM
Sekhar Nori718f7462010-11-19 11:39:46 -0500[diff] [blame]68http://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 +0000[diff] [blame]70
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]712) TI OMAP-L138 LCDK
72http://focus.ti.com/docs/prod/folders/print/omap-l138.html
Nishanth Menona94a4072023-11-01 15:56:03 -0500[diff] [blame]73https://www.ti.com/tool/TMDXLCDK138
Bartosz Golaszewski655d2162019-04-30 09:39:25 +0200[diff] [blame]74
Heiko Schocher337c4332011-09-14 19:59:37 +0000[diff] [blame]75Davinci special defines
76=======================
77
Tom Rini65cc0e22022-11-16 13:10:41 -0500[diff] [blame]78CFG_SYS_DV_NOR_BOOT_CFG: AM18xx based boards, booting in NOR Boot mode
Heiko Schocher337c4332011-09-14 19:59:37 +0000[diff] [blame]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