diff options
author | Duy Dang <duy.dang.yw@rvc.renesas.com> | 2018-08-30 10:40:11 +0700 |
---|---|---|
committer | Duy Dang <duy.dang.yw@rvc.renesas.com> | 2018-10-26 09:45:38 +0700 |
commit | 4c216d7d2d29af6cbc231f772e90f23ab619f109 (patch) | |
tree | 04071f8f368b83860ac9db0386811ad39012eae9 /meta-rcar-gen3/README.md | |
parent | bea3b6c35a6592f3e5522af29a36a0e883bb0582 (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.md | 138 |
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 |