From 4c216d7d2d29af6cbc231f772e90f23ab619f109 Mon Sep 17 00:00:00 2001 From: Duy Dang Date: Thu, 30 Aug 2018 10:40:11 +0700 Subject: 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 Signed-off-by: Khang Nguyen Signed-off-by: Takamitsu Honda --- meta-rcar-gen3/README.proprietary.md | 181 +++++++++++++++++++++++++++++++++++ 1 file changed, 181 insertions(+) create mode 100644 meta-rcar-gen3/README.proprietary.md (limited to 'meta-rcar-gen3/README.proprietary.md') diff --git a/meta-rcar-gen3/README.proprietary.md b/meta-rcar-gen3/README.proprietary.md new file mode 100644 index 0000000..b3f395b --- /dev/null +++ b/meta-rcar-gen3/README.proprietary.md @@ -0,0 +1,181 @@ +# 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. + +``` + I/ Board configuration + II/ Build with GLES + III/ Build with Renesas multimedia libraries + IV/ Enable Linux ICCOM driver and Linux ICCOM library +``` + +There are 2 main paths: + +* 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. + +**Note:** + +* 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 + ```bash + MACHINE = "salvator-x" + ``` + * For R-Car Starter Kit Premier(H3ULCB) board + ```bash + MACHINE = "h3ulcb" + ``` + * For R-Car Starter Kit Pro(M3ULCB) board + ```bash + MACHINE = "m3ulcb" + ``` + * For Ebisu board + ```bash + MACHINE = "ebisu" + ``` +* Set SOC family name: + + * For H3: r8a7795 + ```bash + SOC_FAMILY = "r8a7795" + ``` + * For M3: r8a7796 + ```bash + SOC_FAMILY = "r8a7796" + ``` + * For M3N: r8a77965 + ```bash + SOC_FAMILY = "r8a77965" + ``` + * For E3: r8a77990 + ```bash + # Already added in machine config: ebisu.conf + SOC_FAMILY = "r8a77990" + ``` + +## II/ Build with GLES + +For wayland with GSX + +1. Please copy proprietary libraries to the directory of recipes. +2. Set local.conf the following. + +```bash + # 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 + +```bash + $ 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. +```bash + # 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 +```bash + # 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: +```bash + 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: +```bash + # 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. +```bash + DISTRO_FEATURES_append = " iccom" +``` -- cgit 1.2.3-korg