commit BSP v1.8.0

Signed-off-by: Nobuhiro Iwamatsu <nobuhiro.iwamatsu.yj@renesas.com>

1 files changed, 170 insertions, 0 deletions

diff --git a/meta-rcar-gen2/README.proprietary b/meta-rcar-gen2/README.proprietary
new file mode 100644
index 0000000..0da8afe
--- /dev/null
+++ b/meta-rcar-gen2/README.proprietary
@@ -0,0 +1,170 @@
+Proprietary libraries for meta-rcar-gen2
+========================================
+
+The meta-rcar-gen2 of meta-renesas is supported GLES(RGX and SGX) libraries
+for x11 and Weston, and proprietary library of multimedia. This README describes
+how to use these features and setting to local.conf.
+There are 4 main paths:
+	I/ Board configuration
+	II/ Build with or without GLES
+	III/ Build with Renesas multimedia libraries
+	IV/ Configuration for unmasking packages
+
+The default package is without GLES and including multimedia feature with H264 decoder.
+Therefore, please check section II to config for GLES,
+And check section III for configuration of optional multimedia packages.
+
+In addition, these binaries are not provided at the recipes. If you want to use,
+you will need to get from Renesas.
+
+I/ Board configuration
+==================
+* Please add this line to local.conf depending on your board
+	A. For Lager board
+		   MACHINE ??= "lager"
+	B. For Koelsch board
+		   MACHINE ??= "koelsch"
+	C. For Gose board
+		   MACHINE ??= "gose"
+	D. For Alt board
+		   MACHINE ??= "alt"
+
+II/ Build with or without GLES
+==================
+	A/ Build with GLES
+		* For wayland with rgx/sgx
+
+		1. Please copy proprietary libraries to the directory of recipes.
+		2. Please set local.conf the following.
+			Step 1: Adding features and preferred providers:
+
+			   MACHINE_FEATURES_append = " sgx"
+			   MULTI_PROVIDER_WHITELIST += "virtual/libgl virtual/egl virtual/libgles1 virtual/libgles2"
+			   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"
+
+			 NOTE: The r8a7790 uses rgx, r8a7791, r8a7793 and r8a7794 uses sgx.
+				   If you want to use rgx, please set to 'rgx' instead of 'sgx'.
+				   For r8a7790, if you want to use OPENGLES3,
+				   Please set following in local.conf (default is OPENGLES2)
+					  OPENGLES3 = "1"
+			Step 2: Unmask the graphic recipes
+
+				#BBMASK .= "|gles-kernel-module|gles-user-module"
+
+		  3. Please run 'bitbake core-image-weston'
+
+		* For X11 with rgx/sgx
+		1. Please copy proprietary libraries to the directory of recipes.
+		2. Please set local.conf the following.
+			Step 1: Adding features and preferred providers:
+
+			   MACHINE_FEATURES_append = " sgx"
+			   MULTI_PROVIDER_WHITELIST += "virtual/libgl virtual/egl virtual/libgles1 virtual/libgles2"
+			   PREFERRED_PROVIDER_virtual/libgles2 = "gles-user-module"
+			   PREFERRED_PROVIDER_virtual/egl = "gles-user-module"
+			   DISTRO_FEATURES_remove = "wayland"
+			   BBMASK .= "|libegl|libgbm|wayland-kms"
+
+			 NOTE: The r8a7790 uses rgx, r8a7791, r8a7793 and r8a7794 uses sgx.
+				   If you want to use rgx, please set to 'rgx' instead of 'sgx'.
+				   For r8a7790, if you want to use OPENGLES3,
+				   Please set following in local.conf (default is OPENGLES2)
+					  OPENGLES3 = "1"
+			Step 2: Unmask the graphic recipes
+
+				#BBMASK .= "|gles-kernel-module|gles-user-module"
+
+		  3. Please run 'bitbake core-image-x11'
+
+	B/ Build without GLES
+		* For X11 without rgx/sgx
+		1. Please copy proprietary libraries to the directory of recipes.
+		2. Please set local.conf the following.
+
+			  DISTRO_FEATURES_remove = "wayland"
+			  BBMASK .= "|libegl|libgbm|wayland-kms"
+
+		If you need to install multimedia packages.
+		Please check section of 'Build with Renesas multimedia libraries'.
+
+III/ Build with Renesas multimedia libraries
+============================================
+	A/ Configuration for Multimedia and DTV features
+		1. Please copy proprietary libraries to the directory of recipes.
+		2. Please set local.conf the following.
+
+			# For multimedia feature
+			This provides package group of plug-ins of the GStreamer, multimedia
+			libraries and kernel drivers.
+
+				MACHINE_FEATURES_append = " multimedia"
+
+			# For DTV feature
+		    This provides package group of dtv libraries with packagegroup-rcar-gen2-multimedia.
+			Step 1 : Adding MACHINE_FEATURES
+
+				MACHINE_FEATURES_append = " dtv"
+
+			Step 2: Unmask dtv recipes
+
+				#BBMASK .= "|dtv-module|ssp-module|scu-module"
+
+	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
+			" vc1dec_lib"     - for OMX Media Component VC-1 Decoder Library
+			" mpeg4dec_lib"   - for OMX Media Component MPEG-4 Decoder Library
+			" mpeg2dec_lib"   - for VCP3 Driver Adapted for Linux MPEG-2 Decoder Library
+			" divxdec_lib"    - for DivX Decoder Library for Linux
+			" h264avcenc_lib" - for Encoder Library for Linux
+
+			# Configuration for audio decoders
+			" aacp2dec_lib"   - for ARM 5.1ch aacPlus V2 Decoder for Linux
+			" mp3dec_lib"     - for ARM MP3 Decoder for Linux
+			" wmadec_lib"     - for ARM WMA Decoder for Linux
+			" ddddec_lib"     - for ARM 5.1ch Dolby Digital Decoder for Linux
+			" alacdec_lib"    - for ARM ALAC Decoder for Linux
+			" flacdec_lib"    - for ARM FLAC Decoder for Linux
+			" aacenc_lib"     - for ARM AAC Encoder for Linux
+
+			# Configuration for audio middlewares
+			" armaccp2dec_mdw"  - for ARM 5.1ch aacPlus V2 Decode Middleware for Linux
+			" mp3dec_mdw"       - for ARM MP3 Decode Middleware for Linux
+			" wmadec_mdw"       - for ARM WMA Decode Middleware for Linux
+			" ddddec_mdw"       - for ARM 5.1ch Dolby Digital Decode Middleware for Linux
+			" alacdec_mdw"      - for ARM ALAC Decode Middleware for Linux
+			" flacdec_mdw"      - for ARM FLAC Decode Middleware for Linux
+			" aacenc_mdw"       - for ARM AAC Encode Middleware for Linux
+		Ex:
+
+				DISTRO_FEATURES_append = " mp3dec_lib wmadec_lib mp3dec_mdw wmadec_mdw"
+
+	C/ Configuration for test packages
+		1. Please copy proprietary libraries to the directory of recipes.
+		2. Add features to DISTRO_FEATURES_append to local.conf
+
+			# Configuration for multimedia test package
+			Step 1 : Adding DISTRO_FEATURES
+
+				DISTRO_FEATURES_append = " mm-test"
+
+			Step 2: Unmask multimedia test recipes
+
+				#BBMASK .= "|${BB_MULTIMEDIA_TEST_MODULE}"
+
+			# Configuration for gles test package
+			Step 1 : Adding DISTRO_FEATURES
+
+				DISTRO_FEATURES_append = " gles-test"
+
+			Step 2: Unmask gles test recipes
+
+				#BBMASK .= "|gles-test-module"