summaryrefslogtreecommitdiffstats
path: root/meta-rcar-gen3/README.proprietary.md
diff options
context:
space:
mode:
Diffstat (limited to 'meta-rcar-gen3/README.proprietary.md')
-rw-r--r--meta-rcar-gen3/README.proprietary.md181
1 files changed, 181 insertions, 0 deletions
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"
+```