Merge tag 'pull-24apr19' of git://git.denx.de/u-boot-dm
[platform/kernel/u-boot.git] / doc / README.rmobile
1 Summary
2 =======
3
4 This README is about U-Boot support for Renesas's ARM Cortex-A9 based RMOBILE[1]
5 and Cortex-A9/A53/A57 based R-Car[2] family of SoCs. Renesas's RMOBILE/R-Car SoC
6 family contains an ARM Cortex-A9/A53/A57.
7
8 Currently the following boards are supported:
9
10 | SoC           | Board                                  | defconfig
11 |===============+========================================+===================
12 | R8A73A0       | KMC KZM-A9-GT [3]                      | kzm9g_config
13 | R8A7734       | Atmark-Techno Armadillo-800-EVA [4]    | armadillo-800eva_config
14 |===============+========================================+===================
15 | R8A7790  H2   | Renesas Electronics Lager              | lager_defconfig
16 |               | Renesas Electronics Stout              | stout_defconfig
17 |---------------+----------------------------------------+-------------------
18 | R8A7791  M2-W | Renesas Electronics Koelsch            | koelsch_defconfig
19 |               | Renesas Electronics Porter             | porter_defconfig
20 |---------------+----------------------------------------+-------------------
21 | R8A7792  V2H  | Renesas Electronics Blanche            | blanche_defconfig
22 |---------------+----------------------------------------+-------------------
23 | R8A7793  M2-N | Renesas Electronics Gose               | gose_defconfig
24 |---------------+----------------------------------------+-------------------
25 | R8A7794  E2   | Renesas Electronics Alt                | alt_defconfig
26 |               | Renesas Electronics Silk               | silk_defconfig
27 |===============+========================================+===================
28 | R8A7795  H3   | Renesas Electronics Salvator-XS ES2.0+ | r8a7795_salvator-x_defconfig
29 | R8A7795  H3   | Renesas Electronics ULCB ES2.0+        | r8a7795_ulcb
30 |---------------+----------------------------------------+-------------------
31 | R8A7796  M3-W | Renesas Electronics Salvator-X         | r8a7796_salvator-x_defconfig
32 | R8A7796  M3-W | Renesas Electronics ULCB               | r8a7796_ulcb
33 |---------------+----------------------------------------+-------------------
34 | R8A77965 M3-N | Renesas Electronics Salvator-XS        | r8a77965_salvator-x_defconfig
35 | R8A77965 M3-N | Renesas Electronics ULCB               | r8a77965_ulcb
36 |---------------+----------------------------------------+-------------------
37 | R8A77970 V3M  | Renesas Electronics Eagle              | r8a77970_eagle_defconfig
38 |---------------+----------------------------------------+-------------------
39 | R8A77995 D3   | Renesas Electronics Draak              | r8a77995_draak_defconfig
40 '===============+========================================+===================
41
42 Toolchain
43 =========
44
45 Either ARMv7 toolchain for 32bit Cortex-A9 systems or ARMv8 (aarch64)
46 toolchain for 64bit Cortex-A53/A57 systems. Currently we compile the
47 32bit systems with -march=armv5 to allow more compilers to work. (For
48 U-Boot code this has no performance impact.)
49
50 Currently, ELDK[5], Linaro[6], CodeSourcery[7] and Emdebian[8] supports
51 ARMv7. Modern distributions also contain ARMv7 and ARMv8 crosstoolchains
52 in their package feeds.
53
54 Build
55 =====
56
57 Locate defconfig in the table above. Then apply standard build procedure:
58
59   make <board>_defconfig
60   make
61
62   Note: Armadillo-800-EVA's U-Boot supports booting from SDcard only.
63         Please see "B.2 Appendix B Boot Specifications" in hardware manual.
64
65 Links
66 =====
67
68 [1] Renesas RMOBILE:
69
70 http://am.renesas.com/products/soc/assp/mobile/r_mobile/index.jsp
71
72 [2] Renesas R-Car:
73
74 http://am.renesas.com/products/soc/assp/automotive/index.jsp
75
76 [3] KZM-A9-GT
77
78 http://www.kmckk.co.jp/kzma9-gt/index.html
79
80 [4] Armadillo-800-EVA
81
82 http://armadillo.atmark-techno.com/armadillo-800-EVA
83
84 [5] ELDK
85
86 http://www.denx.de/wiki/view/ELDK-5/WebHome#Section_1.6.
87
88 [6] Linaro
89
90 http://www.linaro.org/downloads/
91
92 [7] CodeSourcey
93
94 http://www.mentor.com/embedded-software/codesourcery
95
96 [8] Emdebian
97
98 http://www.emdebian.org/crosstools.html