Chromium on TX8M
===================

You are able to integrate Chromium into your image to get a graphics-accelerated browser on your StarterKit.

Set up your build-directory with these settings:

.. code-block:: shell

	DISTRO=fsl-imx-xwayland MACHINE=tx8m-xxxx source karo-nxp-release.sh -b <build-dir>

Inside your build directory add this to *conf/local.conf*:

.. code-block:: shell

  CORE_IMAGE_EXTRA_INSTALL += "chromium-ozone-wayland"

Build the QT image:

.. code-block:: shell

  bitbake fsl-image-qt5

.. note:: Before starting a build, you should consider enabling the **SSTATE CACHE** to speedup the build process.

  	See :ref:`yocto-sumo-sstate`.

When your build has finished, flash your module with the image. See :ref:`uuu`.

Running Chromium
------------------

When booting your previously flashed module, the Weston desktop should come up.

Plug a USB-hub into your StarterKit's USB host port and insert keyboard, mouse and/or touchscreen.
Open the terminal (icon in top-left corner), or connect via the Terminal from your host computer.
The desktop comes up as user *root*, so you have to start Chromium with an extra argument.

Run:

.. code-block:: shell

   chromium --no-sandbox

.. hint:: On every first start of Chromium it will tell you, that there's not enough entropy initialized to start Chromium. Move your mouse or hit some keys on your keyboard until the browser comes up. See the sections below how to prevent this.

Autostarting Chromium
----------------------

Entropy problem
~~~~~~~~~~~~~~~~

As mentioned above, it takes some time til your board has enough entropy collected from user-input or other actions that generate randomness. To tell your system, that there **is** enough entropy, add the following to your Kernel-Commandline in U-Boot:

``rng_core.default_quality=1000``

Creating Service
~~~~~~~~~~~~~~~~~

Create a start script for Chromium and modify the Weston service. Modify/create the three files below:

1. Create **/etc/default/weston**:

.. literalinclude:: ./chromium-scripts/etc-default-weston


2. Create **/home/root/startchromium.sh**

.. literalinclude:: ./chromium-scripts/startchromium.sh


3. Modify **/lib/systemd/system/weston.service**:

.. literalinclude:: ./chromium-scripts/weston.service


.. tip:: Reboot your system and see Chromium coming up.