]> git.sur5r.net Git - u-boot/blob - doc/README.at91-soc
Merge branch 'sr@denx.de' of git://git.denx.de/u-boot-staging
[u-boot] / doc / README.at91-soc
1  New C structure AT91 SoC access
2 =================================
3
4 The goal
5 --------
6
7 Currently the at91 arch uses hundreds of address defines and special
8 at91_xxxx_write/read functions to access the SOC.
9 The u-boot project perferred method is to access memory mapped hw
10 regisister via a c structure.
11
12 e.g. old
13
14         *AT91C_PIOA_IDR = AT91_PMX_AA_TWD | AT91_PMX_AA_TWCK;
15         *AT91C_PIOC_PUDR = AT91_PMX_AA_TWD | AT91_PMX_AA_TWCK;
16         *AT91C_PIOC_PER = AT91_PMX_AA_TWD | AT91_PMX_AA_TWCK;
17         *AT91C_PIOC_OER = AT91_PMX_AA_TWD | AT91_PMX_AA_TWCK;
18         *AT91C_PIOC_PIO = AT91_PMX_AA_TWD | AT91_PMX_AA_TWCK;
19
20         at91_sys_write(AT91_RSTC_CR,
21                 AT91_RSTC_KEY | AT91_RSTC_PROCRST | AT91_RSTC_PERRST);
22
23 e.g new
24         pin = AT91_PMX_AA_TWD | AT91_PMX_AA_TWCK;
25         writel(pin, &pio->pioa.idr);
26         writel(pin, &pio->pioa.pudr);
27         writel(pin, &pio->pioa.per);
28         writel(pin, &pio->pioa.oer);
29         writel(pin, &pio->pioa.sodr);
30
31         writel(AT91_RSTC_KEY | AT91_RSTC_CR_PROCRST |
32                 AT91_RSTC_CR_PERRST, &rstc->cr);
33
34 The method for updating
35 ------------------------
36
37 1. add's the temporary CONFIG_AT91_LEGACY to all at91 board configs
38 2. Display a compile time warning, if the board has not been converted
39 3. add new structures for SoC access
40 4. Convert arch, driver and boards file to new SoC
41 5. remove legacy code, if all boards and drives are ready