aboutsummaryrefslogtreecommitdiffstats
path: root/meta-rcar-gen3/README.md
blob: 555e6443e39f2387f9f38f06783e125c97b8ea6d (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
# 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 (R-Car H3)
- Board: R-Car Starter Kit pro(M3ULCB) / SoC: R8A7796 (R-Car M3)
- Board: R-Car Starter Kit pro(M3NULCB) / SoC: R8A77965 (R-Car M3N)
- 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: git://git.linaro.org/openembedded/meta-linaro.git
    layers: 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).

This also needs git user name and email defined:
```bash
   $ git config --global user.email "you@example.com"
   $ git config --global user.name "Your Name"
```

Initialize a build using the 'oe-init-build-env' script in Poky. e.g.:
```bash
    $ source poky/oe-init-build-env
```

After that, initialized configure bblayers.conf by adding meta-rcar-gen3 layer. e.g.:
```bash
    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-optee \
        <path to layer>/meta-openembedded/meta-oe \
    "
```
To build a specific target BSP, configure the associated machine in local.conf:
```bash
    MACHINE ??= "<supported board name>"
```

Board|MACHINE
-----|-------
Salvator-X/XS|MACHINE="salvator-x"
Ebisu|MACHINE="ebisu"
Starter Kit Pro (M3ULCB)|MACHINE="m3ulcb"
Starter Kit Pro (M3NULCB)|MACHINE="m3nulcb"
Starter Kit Premier (H3ULCB)|MACHINE="h3ulcb"

Select the SOC:
```bash
    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
```
Configure for systemd init in local.conf:
```bash
    DISTRO_FEATURES_append = " systemd"
    VIRTUAL-RUNTIME_init_manager = "systemd"
```
Configure for ivi-shell and ivi-extension
```bash
    DISTRO_FEATURES_append = " ivi-shell"
```
Configure for USB 3.0
```bash
    MACHINE_FEATURES_append = " usb3"
```
Enable tuning support for Capacity Aware migration Strategy (CAS)
```bash
    MACHINE_FEATURES_append = " cas"
```

For a list of sample local.conf file, please refer to: [docs/sample/conf/](docs/sample/conf/)

Build the target file system image using bitbake:
```bash
    $ 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.
```bash
    SDKIMAGE_FEATURES_append = " staticdev-pkgs"
```
Use bitbake -c populate_sdk for generating the toolchain SDK:
For 64-bit target SDK (aarch64):
```bash
    $ 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_
For 64-bit target SDK:
```bash
    $ 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_
```bash
    $ 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