summaryrefslogtreecommitdiffstats
path: root/meta-rcar-gen2/README.proprietary
blob: 4cbcfad49278ec8a581fa33677bf23c6f5354305 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
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 = "mesa"
			   PREFERRED_PROVIDER_libgbm = "libgbm"
			   PREFERRED_RPROVIDER_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"