summaryrefslogtreecommitdiffstats
path: root/meta-rcar-gen3/README.md
diff options
context:
space:
mode:
authorDuy Dang <duy.dang.yw@rvc.renesas.com>2018-08-30 10:40:11 +0700
committerDuy Dang <duy.dang.yw@rvc.renesas.com>2018-10-26 09:45:38 +0700
commit4c216d7d2d29af6cbc231f772e90f23ab619f109 (patch)
tree04071f8f368b83860ac9db0386811ad39012eae9 /meta-rcar-gen3/README.md
parentbea3b6c35a6592f3e5522af29a36a0e883bb0582 (diff)
rcar-gen3: README: Use Markdown formatting
This commit edits README files to use Markdown formatting. There are also some modifications: - Removed dependency on meta-renesas itself in meta-rcar-gen3/README.md and meta-rcar-gen3/README.linaro - Added E3 SoC information to meta-rcar-gen3/README.md - Replaced core-image-x11 by core-image-minimal in README.md, this image is not maintained. Signed-off-by: Duy Dang <duy.dang.yw@rvc.renesas.com> Signed-off-by: Khang Nguyen <khang.nguyen.xw@renesas.com> Signed-off-by: Takamitsu Honda <takamitsu.honda.pv@renesas.com>
Diffstat (limited to 'meta-rcar-gen3/README.md')
-rw-r--r--meta-rcar-gen3/README.md138
1 files changed, 138 insertions, 0 deletions
diff --git a/meta-rcar-gen3/README.md b/meta-rcar-gen3/README.md
new file mode 100644
index 0000000..1f6d55b
--- /dev/null
+++ b/meta-rcar-gen3/README.md
@@ -0,0 +1,138 @@
+# 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: 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).
+
+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>"
+```
+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"
+```
+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