Installation guide

Supported platforms

  • i.MX 8

    • CCPilot V510

    • CCPilot V700

    • CCPilot V710

    • CCPilot V1000

    • CCPilot V1200

    • CCPilot V1090

    • CCPilot V1290

Prerequisites

v1.4.+

  • CCL 4.+ OS

  • Qt-6.8 Runtime

Unlock /appfs for development/testing

For experimental testing, a quick way to deploy ccwebbrowser is to format /appfs and make it writable by ccs user. Real deployment should use RAUC package to deploy browser and Qt runtime in one bundle.

  1. Open an ssh session to the target ssh ccs<ip-address>

  2. Check which version partition /appfs is mounted to rauc status

  3. Unmount /appfs sudo umount /appfs

  4. Format the partition sudo mkfs.ext4 /dev/<partition>

  5. Remount /appfs sudo mount /dev/<partition> /appfs

  6. Make it writable for ccs user during test: chown -R ccs /appfs

Installing CC Web browser

  1. Download ccwebbrowser_1.4.2_<target-display>.tar.gz from the support site under:
    Web browser module -> Downloads -> Device Download -> CC Linux 5.0 -> <target-display>

  2. Transfer the tarball to the device scp ccwebbrowser_1.4.2_.tar.gz ccs@<ip-address>:/tmp

  3. Open an ssh session to the target ssh ccs@<ip-address>

  4. Change directory to /appfs cd /appfs

  5. Move the tarball to /appfs sudo mv /tmp/ccwebbrowser_1.4.2_.tar.gz .

  6. Unpack the tarball to /appfs sudo tar xzf ccwebbrowser_1.4.2_.tar.gz

  7. Edit the /appfs/ccwebbrowser/config/browser.conf file to add your url.

  8. By default the web browser is running with Qt platform -platform eglfs. If the browser should run as a wayland client, edit the ccwebbrowser.service systemd script and change the platform to -platform wayland instead.

  9. Enable the systemd service file to automatically start the web browser sudo systemctl enable ccwebbrowser

  10. Download and extract qt-runtime--6.8.3-5.0.0.0.tar.gz to /appfs folder.

  11. Now the web browser should automatically start at boot

Create a RAUC bundle

Reference the CC Linux - Using RAUC documentation on the support web site for more information about how to generate a RAUC bundle. A appfs partition created as above can be used in the RAUC package to create a deployment package.

Troubleshooting

Please refer to our KnowledgeBase for further information and troubleshooting guides.