aboutsummaryrefslogtreecommitdiffstats
path: root/meta-rcar-gen3/docs/sample/patch/patch-for-linaro-gcc/0001-rcar-gen3-add-readme-for-building-with-Linaro-Gcc.patch
blob: 0ca101757b375d6badceb5a7d468640e4e583115 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
From a217313adcfb331634c99be786b93516d38d943a Mon Sep 17 00:00:00 2001
From: Thuy Tran <thuy.tran.xh@rvc.renesas.com>
Date: Tue, 24 Oct 2017 14:39:24 +0700
Subject: [PATCH] rcar-gen3: Add readme for building with Linaro Gcc

This patch add the dependent layer information, build instructions
for using Linaro Gcc.

Updated on Dec, 2016:
- Add H3ULCB
- Change supported branch from jethro to krogoth
- Change Maintainer information.

Updated on Oct, 2017:
- Add M3N
- Add M3ULCB
- Add meta-optee layer

Updated on Feb, 2018:
- Add E3
- Add elinux.org reference

Signed-off-by: Phong Man Tran <phong.tran.wh@rvc.renesas.com>
Signed-off-by: Thao Nguyen <thao.nguyen.yb@rvc.renesas.com>
Signed-off-by: Thuy Tran <thuy.tran.xh@rvc.renesas.com>
Signed-off-by: Takamitsu Honda <takamitsu.honda.pv@renesas.com>
---
 meta-rcar-gen3/README.linaro | 127 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 127 insertions(+)
 create mode 100644 meta-rcar-gen3/README.linaro

diff --git a/meta-rcar-gen3/README.linaro b/meta-rcar-gen3/README.linaro
new file mode 100644
index 0000000..e1fe40a
--- /dev/null
+++ b/meta-rcar-gen3/README.linaro
@@ -0,0 +1,127 @@
+meta-rcar-gen3
+==============
+
+This layer provides that evaluation board is mounted ARM SoCs of Renesas
+Electronics, called the R-Car Generation 3. Currently, this supports
+board and the SoCs of the following:
+    - Board: Salvator-X   / SoC: R8A7795 (R-Car H3), R8A7796 (R-Car M3), R8A77965 (R-Car M3N)
+    - Board: R-Car Starter Kit premier(H3ULCB)   / SoC: R8A7795
+    - Board: R-Car Starter Kit pro(M3ULCB) / SoC: R8A7796
+    - Board: Ebisu / SoC: R8A77990 (R-Car E3)
+
+Patches
+=======
+
+Please submit any patches for this layer to: takamitsu.honda.pv@renesas.com
+Please see the MAINTAINERS file for more details.
+
+Dependencies
+============
+
+This layer depends on:
+
+    URI: git://git.yoctoproject.org/poky
+    layers: meta, meta-yocto, meta-yocto-bsp
+    branch: rocko
+
+    URI: https://git.linaro.org/openembedded/meta-linaro.git
+    layers: meta-linaro-toolchain, meta-optee
+    branch: rocko
+
+    URI: git://git.openembedded.org/meta-openembedded
+    layers: meta-oe
+    branch: rocko
+
+Build Instructions
+==================
+
+The following instructions require a Poky installation (or equivalent).
+
+Initialize a build using the 'oe-init-build-env' script in Poky. e.g.:
+
+    $ source poky/oe-init-build-env
+
+After that, initialized configure bblayers.conf by adding meta-rcar-gen3 layer. e.g.:
+
+    BBLAYERS ?= " \
+        <path to layer>/poky/meta \
+        <path to layer>/poky/meta-yocto \
+        <path to layer>/poky/meta-yocto-bsp \
+        <path to layer>/meta-renesas/meta-rcar-gen3 \
+        <path to layer>/meta-linaro/meta-linaro-toolchain \
+        <path to layer>/meta-linaro/meta-optee \
+        <path to layer>/meta-openembedded/meta-oe \
+    "
+
+To build a specific target BSP, configure the associated machine in local.conf:
+
+    MACHINE ??= "<supported board name>"
+
+Select the SOC
+
+    For H3: r8a7795
+    SOC_FAMILY = "r8a7795"
+
+    For M3: r8a7796
+    SOC_FAMILY = "r8a7796"
+
+    For M3N: r8a77965
+    SOC_FAMILY = "r8a77965"
+
+    For E3: r8a77990
+    SOC_FAMILY = "r8a77990"
+    Already added in machine config: ebisu.conf
+
+Must Change the Gcc version in local.conf.
+
+    GCCVERSION="linaro-7.2"
+
+Configure for systemd init in local.conf:
+
+    DISTRO_FEATURES_append = " systemd"
+    VIRTUAL-RUNTIME_init_manager = "systemd"
+Configure for ivi-shell and ivi-extension
+
+   DISTRO_FEATURES_append = " ivi-shell"
+
+Configure for USB 3.0
+
+   MACHINE_FEATURES_append = " usb3"
+
+Enable tuning support for Capacity Aware migration Strategy (CAS)
+
+   MACHINE_FEATURES_append = " cas"
+
+Build the target file system image using bitbake:
+
+    $ bitbake core-image-minimal
+
+After completing the images for the target machine will be available in the output
+directory 'tmp/deploy/images/<supported board name>'.
+
+Images generated:
+    * Image (generic Linux Kernel binary image file)
+    * Image-<machine name>.dtb (DTB for target machine)
+    * core-image-minimal-<machine name>.tar.bz2 (rootfs tar+bzip2)
+    * core-image-minimal-<machine name>.ext4  (rootfs ext4 format)
+
+Build Instructions for SDK
+==========================
+This may be changed in the near feature. These instructions are tentative.
+
+Should define the staticdev in SDK image feature for installing the static libs
+to SDK in local.conf.
+
+    SDKIMAGE_FEATURES_append = " staticdev-pkgs"
+
+Use bitbake -c populate_sdk for generating the toolchain SDK:
+For 64-bit target SDK (aarch64):
+
+    $ bitbake core-image-minimal -c populate_sdk
+
+The SDK can be found in the output directory 'tmp/deploy/sdk'
+    * poky-glibc-x86_64-core-image-minimal-aarch64-toolchain-x.x.sh
+
+Usage of toolchain SDK:
+Install the SDK to the default: /opt/poky/x.x
+(x.x is YP version, i.e. 2.1.)
+For 64-bit target SDK:
+
+    $ sh poky-glibc-x86_64-core-image-minimal-aarch64-toolchain-x.x.sh
+
+For 64-bit application use environment script in /opt/poky/x.x
+
+    $ source /opt/poky/x.x/environment-setup-aarch64-poky-linux
+
+ULCB Information
+================
+Refer to the following for more information of ULCB:
+
+    http://elinux.org/R-Car
+
+The information on building and running Yocto on R-Car Generation 3
+=========================
+Refer to the following for more information:
+
+    https://elinux.org/R-Car/Boards/Yocto-Gen3
-- 
1.9.1