First commit.Renesas-Yocto-v2.16.0

Renesas BSP v3.5.1 (kernel v4.9 stable)

[Environment]
poky: yocto-2.1.2 (cca8dd15c8096626052f6d8d25ff1e9a606104a3)
meta-openembedded: 55c8a76da5dc099a7bc3838495c672140cedb78e
meta-linaro: 2f51d38048599d9878f149d6d15539fb97603f8f

[Information]
- U-boot: Changed load address from H'49000000 to H'50000000
- XDG_RUNTIME_DIR has been changed from "/run/user/root" to "/run/user/0"
- Change location of include directory, which stores common user header
  files, to $(INCSHARED)
- In BSP Only, core-image-weston is not supported even though
  local-wayland.conf is provided.
- Please set Salvator-x SW7 Pin-1. In after Yocto BSP v2.12.0, it is
　necessary to enable BKUP_TRG signal for Suspend to RAM.
- The dtb filename was changed in R-Car H3. Only
  "Image-r8a7795-es1-salvator-x.dtb" is supported in this version.
  Please use "Image-r8a7795-es1-salvator-x.dtb" It supports R-Car H3
  WS1.0 and WS1.1.
- Please update your local.conf and bblayers.conf corresponding to Yocto
  v2.16.0 package. You can refer to meta-rcargen3/docs/sample/conf/ for
  updated contents.
- You have to re-compile out-of-recipe software like user application by
  v2.16.0 SDK toolchains.
- In some boards, the resuming from System Suspend to RAM may cause
  unstable operation or failed to resume.

Signed-off-by: Takamitsu Honda <takamitsu.honda.pv@renesas.com>

1 files changed, 133 insertions, 0 deletions

diff --git a/meta-rcar-gen3/README.proprietary b/meta-rcar-gen3/README.proprietary
new file mode 100644
index 0000000..ac3a958
--- /dev/null
+++ b/meta-rcar-gen3/README.proprietary
@@ -0,0 +1,133 @@
+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"
+
+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_append = " pam"
+                PREFERRED_PROVIDER_virtual/libgles1 = ""
+                PREFERRED_PROVIDER_virtual/libgles2 = "gles-user-module"
+                PREFERRED_PROVIDER_virtual/egl = "gles-user-module"
+                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
+                " 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.