Skip to content

Commit eed1230

Browse files
committed
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>
1 parent 2f27184 commit eed1230

1 file changed

Lines changed: 31 additions & 35 deletions

File tree

source/linux/Demo_User_Guides/Chromium_Browser.rst

Lines changed: 31 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,15 @@ Chromium Browser - User Guide
1010
Overview
1111
--------
1212

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/)
1414
is accelerated using OpenGLES.
1515

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:
1717

1818
.. code-block:: console
1919
2020
$ chromium --version
21-
Chromium 123.0.6312.122 stable
21+
Chromium 132.0.6834.83 stable
2222
2323
The version of Chromium shown here is the one that GPU acceleration is verified to work with.
2424

@@ -29,17 +29,15 @@ Launching Chromium Browser
2929

3030
For security reasons it is suggested never to run Chromium as the root user.
3131

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):
3533

3634
Switch to the weston user:
3735

3836
.. code-block:: console
3937
4038
$ su weston
4139
42-
And then run the chromium binary:
40+
Then run the chromium binary:
4341

4442
.. code-block:: console
4543
@@ -61,14 +59,13 @@ Will open the aquarium 3d benchmark in a fullscreen window on the Weston desktop
6159

6260
The :console:`--start-fullscreen` switch will make the chromium browser consume the entire screen including overwriting the Weston menu bar.
6361

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.
6663

6764
Graphics Feature Status
6865
-----------------------
6966

7067
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.
7269

7370
.. code-block:: text
7471
@@ -88,7 +85,7 @@ rendered with this information. The below example shows what is enabled/disabled
8885
* WebGPU: Disabled
8986
9087
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
9289
using the :console:`--disable-gpu` flag:
9390

9491
.. code-block:: console
@@ -106,38 +103,38 @@ To get raw performance numbers from the GPU, you may want to disable frame sync
106103
Running Chromium as the root user
107104
---------------------------------
108105

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.
110107
To run in this mode you also have to provide the :console:`--no-sandbox` switch, which disables all sandboxing
111108
of the browser from the base system and could leave you open for a malicious webpage to do something
112109
nefarious.
113110

114111

115-
How to build Chromuim under Yocto
112+
How to build Chromium under Yocto
116113
---------------------------------
117114

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.
119116

120117
meta-browser should be pinned to commit:
121118

122119
.. code-block:: text
123120
124-
commit 1ed2254d72a4c25879014c98be287a7e3e22904c
125-
Author: Max Ihlenfeldt <max@igalia.com>
126-
Date: Wed May 22 14:54:02 2024 +0200
121+
commit 27ca52f635a31f5f9762813a8527dd31323549b7
122+
Author: Ariel D'Alessandro <ariel.dalessandro@gmail.com>
123+
Date: Thu Feb 20 06:59:07 2025 -0300
127124
128-
chromium: Backport missing dependency in NewTabPage (#816)
125+
chromium: Update to 132.0.6834.83 (#867)
129126
130-
meta-clang needs to be pinned to HEAD commit of branch "scarthgap", as of the time of writing that equates to this commit:
127+
meta-lts-mixins should be pinned to commit:
131128

132129
.. code-block:: text
133130
134-
commit e7dceb1c92caf7f21ef1d7b49c85328c30cffd90 (HEAD -> scarthgap, origin/scarthgap)
135-
Author: Etienne Cordonnier <ecordonnier@snap.com>
136-
Date: Fri May 3 17:47:46 2024 +0200
131+
commit a8046d5ec53b1856169ac795aa87cb0d5db84c04
132+
Author: Khem Raj <raj.khem@gmail.com>
133+
Date: Wed Apr 30 23:33:39 2025 -0700
137134
138-
clang: use release tarball instead of git
135+
rust: Fix build with GCC-15 on aarch64/musl
139136
140-
With these layers pinned to the correct commit, you need to make sure they are referenced in :console:`build/conf/bblayers.conf`
137+
With these layers pinned to the correct commit, you need to make sure they are referenced in :console:`build/conf/bblayers.conf`.
141138
This is done automatically if you use the oe-layersetup tool.
142139

143140
.. code-block:: console
@@ -146,23 +143,23 @@ This is done automatically if you use the oe-layersetup tool.
146143
$ ./oe-layersetup -f config/arago-scarthgap-chromium-config.txt
147144
148145
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
150147
adding Chromium to the root filesystem image.
151148

152149
.. tip::
153150

154151
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
156153
to build Chromium. A full Yocto Scarthgap build that includes Chromium can easily take 400GBytes of SSD.
157154

158155
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:
160157

161158
.. code-block:: console
162159
163160
$ MACHINE=<machine> bitbake tisdk-default-image
164161
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
166163
directly using the following:
167164

168165
.. code-block:: console
@@ -185,15 +182,14 @@ Somewhere into your :file:`build/conf/local.conf` file.
185182
Limitations
186183
-----------
187184

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.
190186

191187
Performance
192188
-----------
193189

194190
**Performance of WebGL Aquarium**
195191

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
197193

198194
Run as the weston user with the command line :console:`chromium https://webglsamples.org/aquarium/aquarium.html --start-fullscreen`
199195

@@ -259,7 +255,7 @@ Run as the weston user with the command line :console:`chromium https://webglsam
259255

260256
**Performance of MotionMarkv1.3**
261257

262-
Standard Javascript benchmarks available at these URLS: https://browserbench.org/MotionMark/
258+
Standard Javascript benchmarks available at these URLs: https://browserbench.org/MotionMark/
263259

264260
Run as the weston user with the command line :console:`chromium https://browserbench.org/MotionMark/ --start-fullscreen`
265261
use the mouse to click the "Run Benchmark" button.
@@ -313,10 +309,10 @@ Video Streaming
313309
.. ifconfig:: CONFIG_part_variant not in ('AM62X', 'J721E')
314310

315311
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__|.
317313
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.
318314

319-
Tested streaming sources include HTML5 video playback, YouTube, and Vimeo.
315+
Tested streaming sources include HTML5, YouTube, and Vimeo video playback.
320316

321317
.. rubric:: HTML5 Video Playback
322318

@@ -353,7 +349,7 @@ Chromium falls back to **software decoding** when using those codecs, resulting
353349
.. ifconfig:: CONFIG_part_variant not in ('AM62X', 'J721E')
354350

355351
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.
357353

358354
.. code-block:: console
359355

0 commit comments

Comments
 (0)