You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(chromium): Update layer pins and reflect HW video decode support
- Update meta-browser to Chromium 132.0.6834.83
- Replace meta-clang with meta-lts-mixins as the required Scarthgap layer
- Remove audio/video limitation; HW decode is now supported via Wave5
- Fix various typos, grammar and punctuation issues
Signed-off-by: Thorsten Lannynd <t-lannynd@ti.com>
Copy file name to clipboardExpand all lines: source/linux/Demo_User_Guides/Chromium_Browser.rst
+31-35Lines changed: 31 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,15 +10,15 @@ Chromium Browser - User Guide
10
10
Overview
11
11
--------
12
12
13
-
On TI devices with IMG Rogue class GPU's. The Chromium browser (available from https://chromium.googlesource.com/chromium/src/)
13
+
On TI devices with IMG Rogue class GPUs. The Chromium browser (available from https://chromium.googlesource.com/chromium/src/)
14
14
is accelerated using OpenGLES.
15
15
16
-
The version of Chromium that is build can be obtained with this command:
16
+
The version of Chromium that is built can be obtained with this command:
17
17
18
18
.. code-block:: console
19
19
20
20
$ chromium --version
21
-
Chromium 123.0.6312.122 stable
21
+
Chromium 132.0.6834.83 stable
22
22
23
23
The version of Chromium shown here is the one that GPU acceleration is verified to work with.
24
24
@@ -29,17 +29,15 @@ Launching Chromium Browser
29
29
30
30
For security reasons it is suggested never to run Chromium as the root user.
31
31
32
-
To launch the Chromium browser:
33
-
34
-
Assuming you are logged in as the root user.
32
+
To launch the Chromium browser (assuming you are logged in as root):
35
33
36
34
Switch to the weston user:
37
35
38
36
.. code-block:: console
39
37
40
38
$ su weston
41
39
42
-
And then run the chromium binary:
40
+
Then run the chromium binary:
43
41
44
42
.. code-block:: console
45
43
@@ -61,14 +59,13 @@ Will open the aquarium 3d benchmark in a fullscreen window on the Weston desktop
61
59
62
60
The :console:`--start-fullscreen` switch will make the chromium browser consume the entire screen including overwriting the Weston menu bar.
63
61
64
-
This will start chromium and provided you have network connectivity to the internet from the TI platform it will
65
-
connect to an example application that uses WebGL/Javascript and renders fish swimming in a fish bowl using the 3D GPU.
62
+
This will start Chromium. With network connectivity, it will connect to an example application that uses WebGL/Javascript and renders fish swimming in a fish bowl using the 3D GPU.
66
63
67
64
Graphics Feature Status
68
65
-----------------------
69
66
70
67
To see the GPU features that are in use, enter :code:`chrome://gpu` into the Chromium URL/Navigation bar. A web page will be
71
-
rendered with this information. The below example shows what is enabled/disabled when GPU acceleration is working correctly
68
+
rendered with this information. The below example shows what is enabled/disabled when GPU acceleration is working correctly.
72
69
73
70
.. code-block:: text
74
71
@@ -88,7 +85,7 @@ rendered with this information. The below example shows what is enabled/disabled
88
85
* WebGPU: Disabled
89
86
90
87
91
-
If for some reason you suspect the GPU is rending something incorrectly, you can run chromium with GPU disabled
88
+
If for some reason you suspect the GPU is rendering something incorrectly, you can run chromium with GPU disabled
92
89
using the :console:`--disable-gpu` flag:
93
90
94
91
.. code-block:: console
@@ -106,38 +103,38 @@ To get raw performance numbers from the GPU, you may want to disable frame sync
106
103
Running Chromium as the root user
107
104
---------------------------------
108
105
109
-
This is absolutely not recommended, as to do so gives a web page too much access to your system.
106
+
This is absolutely not recommended, as to do so gives a web page too much access to your system.
110
107
To run in this mode you also have to provide the :console:`--no-sandbox` switch, which disables all sandboxing
111
108
of the browser from the base system and could leave you open for a malicious webpage to do something
112
109
nefarious.
113
110
114
111
115
-
How to build Chromuim under Yocto
112
+
How to build Chromium under Yocto
116
113
---------------------------------
117
114
118
-
Pull in the meta-browser and meta-clang layer into a Scarthgap Yocto build.
115
+
Pull in the meta-browser and meta-lts-mixins layer into a Scarthgap Yocto build.
Once this is done, use bitbake to create the tisdk-default-image. This will
149
-
detect the meta-browser and meta-clang layers, automatically building and
146
+
detect the meta-browser and meta-lts-mixins layers, automatically building and
150
147
adding Chromium to the root filesystem image.
151
148
152
149
.. tip::
153
150
154
151
Build times of Chromium can be very long depending on the size of your build machine. It has been found that you need
155
-
at least 64Gigs of RAM, and on a 28 thread Intel Core-I9 with an SSD for the build driver it will still take upwards of 2 hours just
152
+
at least 64 GB of RAM, and on a 28 thread Intel Core-I9 with an SSD for the build driver it will still take upwards of 2 hours just
156
153
to build Chromium. A full Yocto Scarthgap build that includes Chromium can easily take 400GBytes of SSD.
157
154
158
155
The following will initiate a full tisdk-default-image build that would include
159
-
Chromium if the meta-browser and meta-clang layers are present:
156
+
Chromium if the meta-browser and meta-lts-mixins layers are present:
160
157
161
158
.. code-block:: console
162
159
163
160
$ MACHINE=<machine> bitbake tisdk-default-image
164
161
165
-
If you want to significantly reduced image size, the IPKs can be built
162
+
If you want to significantly reduce image size, the IPKs can be built
166
163
directly using the following:
167
164
168
165
.. code-block:: console
@@ -185,15 +182,14 @@ Somewhere into your :file:`build/conf/local.conf` file.
185
182
Limitations
186
183
-----------
187
184
188
-
* Audio/video within the browser is not supported.
189
-
* Hardware acceleration of video either decode or encode is not supported.
185
+
* Hardware acceleration of video encode is not supported.
190
186
191
187
Performance
192
188
-----------
193
189
194
190
**Performance of WebGL Aquarium**
195
191
196
-
Standard WebGL benchmarks available at these URLS: https://webglsamples.org/aquarium/aquarium.html
192
+
Standard WebGL benchmarks available at these URLs: https://webglsamples.org/aquarium/aquarium.html
197
193
198
194
Run as the weston user with the command line :console:`chromium https://webglsamples.org/aquarium/aquarium.html --start-fullscreen`
199
195
@@ -259,7 +255,7 @@ Run as the weston user with the command line :console:`chromium https://webglsam
259
255
260
256
**Performance of MotionMarkv1.3**
261
257
262
-
Standard Javascript benchmarks available at these URLS: https://browserbench.org/MotionMark/
258
+
Standard Javascript benchmarks available at these URLs: https://browserbench.org/MotionMark/
263
259
264
260
Run as the weston user with the command line :console:`chromium https://browserbench.org/MotionMark/ --start-fullscreen`
265
261
use the mouse to click the "Run Benchmark" button.
@@ -313,10 +309,10 @@ Video Streaming
313
309
.. ifconfig:: CONFIG_part_variant not in ('AM62X', 'J721E')
314
310
315
311
Streaming platforms and demuxed videos support hardware acceleration for video playback.
316
-
This is achieved using the V4L2 stateful decoder API that interfaces with the :ref:`Wave 5<foundational-components-multimedia>` hardware decoder present on |__PART_FAMILY_DEVICE_NAMES__|.
312
+
This is achieved using the V4L2 stateful decoder API that interfaces with the :ref:`Wave5<foundational-components-multimedia>` hardware decoder present on |__PART_FAMILY_DEVICE_NAMES__|.
317
313
Hardware acceleration has been successfully verified with the `W3C WebCodecs VideoDecoder Interface <https://www.w3.org/TR/webcodecs/#videodecoder-interface>`_, which serves as the backend technology for streaming platforms such as YouTube and Vimeo.
318
314
319
-
Tested streaming sources include HTML5 video playback, YouTube, and Vimeo.
315
+
Tested streaming sources include HTML5, YouTube, and Vimeo video playback.
320
316
321
317
.. rubric:: HTML5 Video Playback
322
318
@@ -353,7 +349,7 @@ Chromium falls back to **software decoding** when using those codecs, resulting
353
349
.. ifconfig:: CONFIG_part_variant not in ('AM62X', 'J721E')
354
350
355
351
To enable hardware acceleration, **Chromium requires an extension** that forces YouTube to use the **H.264 codec**.
356
-
Once this extension is installed, YouTube streams can be hardware decoded using the V4L2 decoder.
352
+
With this extension installed, YouTube streams are hardware decoded using the V4L2 decoder.
0 commit comments