From 8a395e3f42e0f1a6f0d91a6e3af1d5108dc74566 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 5 Jun 2019 19:10:36 -0700 Subject: Renesas Gen3 Boards "flounder": Renamed files. I renamed the files to have the ".md" extension. They were causing 404 errors during the doc build. The links now work as well. Signed-off-by: Scott Rifenbark Change-Id: I558763170ac5844238d961d89baa872a2056fde4 --- meta-rcar-gen3/README | 145 ----------------------------------- meta-rcar-gen3/README.md | 145 +++++++++++++++++++++++++++++++++++ meta-rcar-gen3/README.proprietary | 139 --------------------------------- meta-rcar-gen3/README.proprietary.md | 139 +++++++++++++++++++++++++++++++++ 4 files changed, 284 insertions(+), 284 deletions(-) delete mode 100644 meta-rcar-gen3/README create mode 100644 meta-rcar-gen3/README.md delete mode 100644 meta-rcar-gen3/README.proprietary create mode 100644 meta-rcar-gen3/README.proprietary.md diff --git a/meta-rcar-gen3/README b/meta-rcar-gen3/README deleted file mode 100644 index 96b2d3a..0000000 --- a/meta-rcar-gen3/README +++ /dev/null @@ -1,145 +0,0 @@ -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://github.com/renesas-rcar/meta-renesas - layers: meta-rcar-gen3 - 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.: - - $ source poky/oe-init-build-env - -After that, initialized configure bblayers.conf by adding meta-rcar-gen3 layer. e.g.: - - BBLAYERS ?= " \ - /poky/meta \ - /poky/meta-yocto \ - /poky/meta-yocto-bsp \ - /meta-renesas/meta-rcar-gen3 \ - /meta-linaro/meta-optee \ - /meta-openembedded/meta-oe \ - " - -To build a specific target BSP, configure the associated machine in local.conf: - - MACHINE ??= "" - -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 - -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/'. - -Images generated: - * Image (generic Linux Kernel binary image file) - * Image-.dtb (DTB for target machine) - * core-image-minimal-.tar.bz2 (rootfs tar+bzip2) - * core-image-minimal-.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 -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 diff --git a/meta-rcar-gen3/README.md b/meta-rcar-gen3/README.md new file mode 100644 index 0000000..96b2d3a --- /dev/null +++ b/meta-rcar-gen3/README.md @@ -0,0 +1,145 @@ +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://github.com/renesas-rcar/meta-renesas + layers: meta-rcar-gen3 + 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.: + + $ source poky/oe-init-build-env + +After that, initialized configure bblayers.conf by adding meta-rcar-gen3 layer. e.g.: + + BBLAYERS ?= " \ + /poky/meta \ + /poky/meta-yocto \ + /poky/meta-yocto-bsp \ + /meta-renesas/meta-rcar-gen3 \ + /meta-linaro/meta-optee \ + /meta-openembedded/meta-oe \ + " + +To build a specific target BSP, configure the associated machine in local.conf: + + MACHINE ??= "" + +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 + +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/'. + +Images generated: + * Image (generic Linux Kernel binary image file) + * Image-.dtb (DTB for target machine) + * core-image-minimal-.tar.bz2 (rootfs tar+bzip2) + * core-image-minimal-.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 +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 diff --git a/meta-rcar-gen3/README.proprietary b/meta-rcar-gen3/README.proprietary deleted file mode 100644 index 4411c6a..0000000 --- a/meta-rcar-gen3/README.proprietary +++ /dev/null @@ -1,139 +0,0 @@ -Proprietary libraries for meta-rcar-gen3 -======================================== - -The meta-rcar-gen3 layer of meta-renesas is supported Graphic GLES(GSX) libraries, -proprietary library of multimedia, and ICCOM software. -This README describes how to use these features and setting to local.conf. - -There are 2 main paths: - I/ Board configuration - II/ Build with GLES - III/ Build with Renesas multimedia libraries - -Please check section II to config for GLES. -Please check section III to enable Multimedia functions. - -If you would like to use Linux ICCOM driver and Linux ICCOM library, -please check section IV. - -However, to have a completed local.conf, -please also refer to Build Instruction in meta-renesas/meta-rcar-gen3/README. - -In addition, these libraries are not provided with recipes. If you would like to use, -you will need to get them from Renesas. - -I/ Board configuration -================== -* Add this line to local.conf - For Salvator-X board - MACHINE = "salvator-x" - For R-Car Starter Kit Premier(H3ULCB) board - MACHINE = "h3ulcb" - For R-Car Starter Kit Pro(M3ULCB) board - MACHINE = "m3ulcb" - -* Set SOC family name: - For H3: r8a7795 - SOC_FAMILY = "r8a7795" - For M3: r8a7796 - SOC_FAMILY = "r8a7796" - For M3N: r8a77965 - SOC_FAMILY = "r8a77965" - -II/ Build with GLES -================== - * For wayland with GSX - - 1. Please copy proprietary libraries to the directory of recipes. - 2. Set local.conf the following. - - # Enable Gfx Pkgs - MACHINE_FEATURES_append = " gsx" - MULTI_PROVIDER_WHITELIST += "virtual/libgl virtual/egl virtual/libgles1 virtual/libgles2" - - # for Wayland/Weston - DISTRO_FEATURES_NATIVESDK_append = " wayland" - DISTRO_FEATURES_append = " pam" - PREFERRED_PROVIDER_virtual/libgles1 = "" - PREFERRED_PROVIDER_virtual/libgles2 = "gles-user-module" - PREFERRED_PROVIDER_virtual/egl = "libegl" - PREFERRED_PROVIDER_virtual/libgl = "" - PREFERRED_PROVIDER_virtual/mesa = "" - PREFERRED_PROVIDER_libgbm = "libgbm" - PREFERRED_PROVIDER_libgbm-dev = "libgbm" - BBMASK = "mesa-gl" - - 3. Run 'bitbake core-image-weston' - -III/ Build with Renesas multimedia libraries -============================================ - Multimedia portions depend on GLES portions. - - A/ Configuration for Multimedia features - 1. Please copy proprietary libraries to the directory of recipes. - 2. Please set local.conf the following. - - # Enable multimedia features. - # This provides package group of plug-ins of the GStreamer, multimedia - # libraries and kernel drivers. - - MACHINE_FEATURES_append = " multimedia" - - B/ Configuration for optional codecs and middleware - 1. Please copy proprietary libraries to the directory of recipes. - 2. Add features to DISTRO_FEATURES_append to local.conf - # Additional configuration in OMX module - " h263dec_lib" - for OMX Media Component H263 Decoder Library - " h264dec_lib" - for OMX Media Component H264 Decoder Library - " h264enc_lib" - for OMX Media Component H.264 Encoder Library - " h265dec_lib" - for OMX Media Component H265 Decoder Library - " mpeg2dec_lib" - for OMX Media Component MPEG2 Decoder Library - " mpeg4dec_lib" - for OMX Media Component MPEG4 Decoder Library - " vc1dec_lib" - for OMX Media Component VC-1 Decoder Library - " divxdec_lib" - for OMX Media Component DivX Decoder Library - " rvdec_lib" - for OMX Media Component RealVideo Decoder Library - " alacdec_lib" - for OMX Media Component ALAC Decoder Library - " flacdec_lib" - for OMX Media Component FLAC Decoder Library - " aaclcdec_lib" - for OMX Media Component AAC-LC Decoder Library - " aaclcdec_mdw" - for AAC-LC 2ch Decoder Middleware for Linux - " aacpv2dec_lib" - for OMX Media Component aacPlus V2 Decoder Library - " aacpv2dec_mdw" - for aacPlus V2 Decoder Middleware for Linux - " mp3dec_lib" - for OMX Media Component MP3 Decoder Library - " mp3dec_mdw" - for MP3 Decoder Middleware for Linux - " wmadec_lib" - for OMX Media Component WMA Standard Decoder Library - " wmadec_mdw" - for WMA Standard Decoder Middleware for Linux - " dddec_lib" - for OMX Media Component Dolby(R) Digital Decoder Library - " dddec_mdw" - for Dolby(R) Digital Decoder Middleware for Linux - " aaclcenc_lib" - for OMX Media Component AAC-LC Encoder Library - " vp8dec_lib" - for OMX Media Component VP8 Decoder Library for Linux - " vp8enc_lib" - for OMX Media Component VP8 Encoder Library for Linux - " vp9dec_lib" - for OMX Media Component VP9 Decoder Library for Linux - " aaclcenc_mdw" - for AAC-LC Encoder Middleware for Linux - " cmsbcm" - for CMS Basic Color Management Middleware for Linux - " cmsblc" - for CMS CMM3 Backlight Control Middleware for Linux - " cmsdgc" - for CMS VSP2 Dynamic Gamma Correction Middleware for Linux - " dtv" - for ISDB-T DTV Software Package for Linux - " dvd" - for DVD Core-Middleware for Linux - " adsp" - for ADSP driver, ADSP interface and ADSP framework for Linux - " avb" - for AVB Software Package for Linux - - Ex: - DISTRO_FEATURES_append = " h264dec_lib h265dec_lib mpeg2dec_lib aaclcdec_lib aaclcdec_mdw" - - C/ Configuration for test packages - Must ensure that Multimedia features have been enabled. - (Please refer to III/A to enable Multimedia.) - Please add feature to DISTRO_FEATURES_append to local.conf. - # Configuration for multimedia test package - - DISTRO_FEATURES_append = " mm-test" - -IV/ Enable Linux ICCOM driver and Linux ICCOM library -===================================================== - For Linux ICCOM driver and Linux ICCOM library - - 1. Please copy proprietary libraries to the directory of recipes. - 2. Please set local.conf the following. - - DISTRO_FEATURES_append = " iccom" -END. diff --git a/meta-rcar-gen3/README.proprietary.md b/meta-rcar-gen3/README.proprietary.md new file mode 100644 index 0000000..4411c6a --- /dev/null +++ b/meta-rcar-gen3/README.proprietary.md @@ -0,0 +1,139 @@ +Proprietary libraries for meta-rcar-gen3 +======================================== + +The meta-rcar-gen3 layer of meta-renesas is supported Graphic GLES(GSX) libraries, +proprietary library of multimedia, and ICCOM software. +This README describes how to use these features and setting to local.conf. + +There are 2 main paths: + I/ Board configuration + II/ Build with GLES + III/ Build with Renesas multimedia libraries + +Please check section II to config for GLES. +Please check section III to enable Multimedia functions. + +If you would like to use Linux ICCOM driver and Linux ICCOM library, +please check section IV. + +However, to have a completed local.conf, +please also refer to Build Instruction in meta-renesas/meta-rcar-gen3/README. + +In addition, these libraries are not provided with recipes. If you would like to use, +you will need to get them from Renesas. + +I/ Board configuration +================== +* Add this line to local.conf + For Salvator-X board + MACHINE = "salvator-x" + For R-Car Starter Kit Premier(H3ULCB) board + MACHINE = "h3ulcb" + For R-Car Starter Kit Pro(M3ULCB) board + MACHINE = "m3ulcb" + +* Set SOC family name: + For H3: r8a7795 + SOC_FAMILY = "r8a7795" + For M3: r8a7796 + SOC_FAMILY = "r8a7796" + For M3N: r8a77965 + SOC_FAMILY = "r8a77965" + +II/ Build with GLES +================== + * For wayland with GSX + + 1. Please copy proprietary libraries to the directory of recipes. + 2. Set local.conf the following. + + # Enable Gfx Pkgs + MACHINE_FEATURES_append = " gsx" + MULTI_PROVIDER_WHITELIST += "virtual/libgl virtual/egl virtual/libgles1 virtual/libgles2" + + # for Wayland/Weston + DISTRO_FEATURES_NATIVESDK_append = " wayland" + DISTRO_FEATURES_append = " pam" + PREFERRED_PROVIDER_virtual/libgles1 = "" + PREFERRED_PROVIDER_virtual/libgles2 = "gles-user-module" + PREFERRED_PROVIDER_virtual/egl = "libegl" + PREFERRED_PROVIDER_virtual/libgl = "" + PREFERRED_PROVIDER_virtual/mesa = "" + PREFERRED_PROVIDER_libgbm = "libgbm" + PREFERRED_PROVIDER_libgbm-dev = "libgbm" + BBMASK = "mesa-gl" + + 3. Run 'bitbake core-image-weston' + +III/ Build with Renesas multimedia libraries +============================================ + Multimedia portions depend on GLES portions. + + A/ Configuration for Multimedia features + 1. Please copy proprietary libraries to the directory of recipes. + 2. Please set local.conf the following. + + # Enable multimedia features. + # This provides package group of plug-ins of the GStreamer, multimedia + # libraries and kernel drivers. + + MACHINE_FEATURES_append = " multimedia" + + B/ Configuration for optional codecs and middleware + 1. Please copy proprietary libraries to the directory of recipes. + 2. Add features to DISTRO_FEATURES_append to local.conf + # Additional configuration in OMX module + " h263dec_lib" - for OMX Media Component H263 Decoder Library + " h264dec_lib" - for OMX Media Component H264 Decoder Library + " h264enc_lib" - for OMX Media Component H.264 Encoder Library + " h265dec_lib" - for OMX Media Component H265 Decoder Library + " mpeg2dec_lib" - for OMX Media Component MPEG2 Decoder Library + " mpeg4dec_lib" - for OMX Media Component MPEG4 Decoder Library + " vc1dec_lib" - for OMX Media Component VC-1 Decoder Library + " divxdec_lib" - for OMX Media Component DivX Decoder Library + " rvdec_lib" - for OMX Media Component RealVideo Decoder Library + " alacdec_lib" - for OMX Media Component ALAC Decoder Library + " flacdec_lib" - for OMX Media Component FLAC Decoder Library + " aaclcdec_lib" - for OMX Media Component AAC-LC Decoder Library + " aaclcdec_mdw" - for AAC-LC 2ch Decoder Middleware for Linux + " aacpv2dec_lib" - for OMX Media Component aacPlus V2 Decoder Library + " aacpv2dec_mdw" - for aacPlus V2 Decoder Middleware for Linux + " mp3dec_lib" - for OMX Media Component MP3 Decoder Library + " mp3dec_mdw" - for MP3 Decoder Middleware for Linux + " wmadec_lib" - for OMX Media Component WMA Standard Decoder Library + " wmadec_mdw" - for WMA Standard Decoder Middleware for Linux + " dddec_lib" - for OMX Media Component Dolby(R) Digital Decoder Library + " dddec_mdw" - for Dolby(R) Digital Decoder Middleware for Linux + " aaclcenc_lib" - for OMX Media Component AAC-LC Encoder Library + " vp8dec_lib" - for OMX Media Component VP8 Decoder Library for Linux + " vp8enc_lib" - for OMX Media Component VP8 Encoder Library for Linux + " vp9dec_lib" - for OMX Media Component VP9 Decoder Library for Linux + " aaclcenc_mdw" - for AAC-LC Encoder Middleware for Linux + " cmsbcm" - for CMS Basic Color Management Middleware for Linux + " cmsblc" - for CMS CMM3 Backlight Control Middleware for Linux + " cmsdgc" - for CMS VSP2 Dynamic Gamma Correction Middleware for Linux + " dtv" - for ISDB-T DTV Software Package for Linux + " dvd" - for DVD Core-Middleware for Linux + " adsp" - for ADSP driver, ADSP interface and ADSP framework for Linux + " avb" - for AVB Software Package for Linux + + Ex: + DISTRO_FEATURES_append = " h264dec_lib h265dec_lib mpeg2dec_lib aaclcdec_lib aaclcdec_mdw" + + C/ Configuration for test packages + Must ensure that Multimedia features have been enabled. + (Please refer to III/A to enable Multimedia.) + Please add feature to DISTRO_FEATURES_append to local.conf. + # Configuration for multimedia test package + + DISTRO_FEATURES_append = " mm-test" + +IV/ Enable Linux ICCOM driver and Linux ICCOM library +===================================================== + For Linux ICCOM driver and Linux ICCOM library + + 1. Please copy proprietary libraries to the directory of recipes. + 2. Please set local.conf the following. + + DISTRO_FEATURES_append = " iccom" +END. -- cgit 1.2.3-korg