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.
AGL demo image can only be built on a Linux development host, so either a Linux development host or a virtual machine with Linux installed in the client should be used.
Before building AGL demo image it's important to make sure the build machine has all required packages installed. Please refer to Automotive Grade Linux official documentation where examples for different host Linux distributions are provided: http://docs.automotivelinux.org/master/docs/getting_started/en/dev/reference/source-code.html
- Video output. The HSDK board does not support HDMI so a USB-to-HDMI or USB-to-DVI adapter is required for external video output to HDMI. As of today there's only one such type of devices that fully supported in the Linux kernel - those based on DisplayLink USB 2.0 chips (i.e. DL-1x5, DL-1x0). Tested adapter is Accell J131B-001B. On manufacturer's web-site: Accell J131B-001B
- Bluetooth. The HSDK board does not have onboard bluetooth adapter so a USB Bluetooth dongle is required for demonstration purposes. Tested adapter is ASUS USB-BT400. On amazon web-site: ASUS USB-BT400
- AM/FM Tuner. The AGL demo application "Radio" requires a radio receiver, which is not present on HSDK board. Tested adapter is GIGABYTE GT-U7300: On manufacturer's web-site: GT-U7300 According AGL Wiki it is recommended to use RTL-SDR dongles
- Download necessary files using repo utility
repo init -m agl-demo-2018.09.xml -u https://github.com/EvgeniiDidin/agl_manifest_synopsys
repo sync -j4
- Initialize build directory by using template files
source meta-agl/scripts/aglsetup.sh -m hsdk agl-demo agl-netboot agl-appfw-smack
- Build image for Synopsys ARC HSDK platform (currently, the rootfs is used as initramfs)
bitbake agl-demo-platform
In order to run this image a microSD-card with a capacity of at least 8 GB is required.
After build procedure have finished the artifacts are stored in build/tmp/deploy/images/hsdk/ directory. Deploy agl-demo-platform-hsdk.wic.xz file on microSD-card:
- On Linux hosts, use dd command as follows:
xz -cd agl-demo-platform-hsdk.wic.xz | sudo dd of=/dev/mmcblkp0 bs=4M; sync - On Windows hosts, use "Win32 Disk Imager" utility, available here: https://sourceforge.net/projects/win32diskimager/
Once the agl-demo-platform-hsdk.ext4 file is deployed on microSD-card, just insert it in the microSD-card slot of the HSDK and reset the board. Note DIP-switch BIM should be in 1:off, 2:on state while both BMC and BCS should be in 1: on, 2:on state.
After boot you will see the main menu on the screen:
The Settings application can be used to connect the board to a smartphone via Bluetooth and to a WI-FI hotspot. Also it can show version info. Note: Changing Date&Time does not change actual onboard time.
The Mixer application can change the sound volume of input and output audio devices.
The Mediaplayer is an application which can play audio files from smartphone using Bluetooth connection. Connect HSDK board to the smartphone using "Settings"->Bluetooth, then open the audio player on smartphone and play audio file.
The Phone application requires established Bluetooth connection with smartphone. Enter the number and press button with cellphone symbol.
The Radio application requires AM/FM Tuner plugged into the HSDK board. Using arrows or slider it is possible to change radio frequency to tune to a given station.
The HVAC application is used for automotive climate control. Currently devices like ventilator or air conditioning are not supported on HSDK board. Note: read Known issues section 1
The Navigation application can simulate automotive driving on map. All movement changes are accompanied by the sound of a voice assistant. This application requires navigation data, which is not provided by AGL build system. Download navigation data from navi_data, then unpack this archive and put navi_data directory on /root partition in /home/ direcotory Usage:
- Make a log click in some place of the map (similar to finger tap).
- When a point on the map is present, click the button on the top of right corner.
- When the root is drawn, click the button from the paragraph "2" again.
The Dashboard application is a monitor of the car's condition. Currently no sensors are supported to demonstrate capability of this application.
- afm-util - utility, which can start application without GUI.
$ afm-util list
$ afm-util run <application_id>
- In case of multiple audio devices use pacmd and pactl commands:
$ pactl list sinks short
$ pacmd set-default-sink 1
- Bluetooth:
- Useful link: https://wiki.automotivelinux.org/bluetooth
- To reset any known pairings just remove everything in directory /var/lib/bluetooth/{bluetooth-adapter-mac}/
- Scrolling temperature in HVAC application causes crash.
- Some crashes may be seen after running the application for several minutes (under investigation). If this happens, reboot the board to restore the system.
- Running all 8 applications can cause lack of available RAM. Before OOM killer kills the HomeScreen application check free memory using free utility. If the number of free memory is less them 10000 run:
sync; echo 1 > /proc/sys/vm/drop_caches