Using AGL as the User OS

This tutorial describes the steps to run Automotive Grade Linux (AGL) as the User OS on ACRN hypervisor and the existing issues we still have. We hope the steps documented in this article will help others reproduce the issues we’re seeing, and provide information for further debugging. We’re using an Apollo Lake-based NUC model NUC6CAYH and other platforms may be used as well.


Introduction to AGL

Automotive Grade Linux is a collaborative open source project that is bringing together automakers, suppliers, and technology companies to accelerate the development and adoption of a fully open software stack for the connected car. With Linux at its core, AGL is developing an open platform from the ground up that can serve as the de facto industry standard to enable rapid development of new features and technologies. For more information about AGL, please visit AGL’s official website.

Steps for using AGL as the UOS

  1. Follow the instructions found in the Using SDC Mode on the NUC to boot “The ACRN Service OS”

  2. In SOS, download the release of AGL from We’re using release eel_5.1.0 for our example:

    $ cd ~
    $ wget
    $ unxz agl-demo-platform-crosssdk-intel-corei7-64.wic.xz
  3. Deploy the UOS kernel modules to UOS virtual disk image

    $ sudo losetup -f -P --show ~/agl-demo-platform-crosssdk-intel-corei7-64.wic
    $ sudo mount /dev/loop0p2 /mnt
    $ sudo cp -r /usr/lib/modules/4.19.0-27.iot-lts2018 /mnt/lib/modules/
    $ sudo umount /mnt
    $ sync


    Follow the instructions in Using SDC Mode on the NUC, the linux-iot-lts2018 kernels and modules will be installed by default after adding the bundle kernel-iot-lts2018. Here the version of modules is 4.19.0-27.iot-lts2018.

  4. Adjust the /usr/share/acrn/samples/nuc/ script to match your installation. These are the couple of lines you need to modify

    -s 3,virtio-blk,/root/agl-demo-platform-crosssdk-intel-corei7-64.wic \
    -k /usr/lib/kernel/default-iot-lts2018 \
    -B "root=/dev/vda2 ...


    In case you have downloaded a different AGL image or stored the image in another directory, you will need to modify the AGL file name or directory (the -s 3,virtio-blk argument) to match what you have downloaded above. Likewise, you may need to adjust the kernel file name to default-iot-lts2018.

  5. Start the User OS (UOS)

    $ sudo /usr/share/acrn/samples/nuc/

    Congratulations, you are now watching the User OS booting up!

    And you should be able to see the console of AGL:


    When you see this output on the console, AGL has been successfully loaded and now you can operate on the console.

Enable the AGL display

By following these setup steps, you will get a black screen in AGL. We provide a workaround for this black screen in the steps below. By debugging, we identified the problem as an issue with the (not well supported) library. We can light the screen with the weston GUI, as shown below.


To enable weston in AGL, we need to modify weston’s weston.ini configuration file.

$ vim /etc/xdg/weston/weston.ini

Make these changes to weston.ini:

  1. Comment out
  2. Check the name of output is HDMI-A-2

After that, set up an environment variable and restart the weston service:

$ export XDG_RUNTIME_DIR=/run/platform/display
$ systemctl restart weston

You should now see the weston GUI in AGL.

Follow up

ACRN Hypervisor is expanding support for more operating systems, and AGL is an example of this effort. We continue to debug the issue, and investigating why the AGL GUI is not launching as expected.