?README-AGL.md: The Automotive Grade Linux Distribution ====================================================== AGL is creating an automotive specific Linux distribution (AGL UCB) that unifies the software that has been written in a number of places already, such as GENIVI and Tizen IVI. The layer 'meta-agl' provides a minimal set of software to boot system of AGL Distribution. 'meta-agl' is the minimal core which is used build AGL profiles on top of it. The reference UI is part of 'meta-agl-demo'. Additional components like the security framework are part of 'meta-agl-extra'. The AGL community appreciates feedback, ideas, suggestion, bugs and documentation just as much as code. Please join the irc conversation at the #automotive channel on irc.freenode.net and our mailing list. For infomation for subscribing to the mailing list [automotive-discussions](http://lists.linuxfoundation.org/mailman/listinfo/automotive-discussions) For information about AGL Distribution, see the [AGL Distribution](https://wiki.automotivelinux.org/agl-distro) For information abount Getting started with AGL [here](https://wiki.automotivelinux.org/start/getting-started) For information about contributing to the AGL Distro [here](https://wiki.automotivelinux.org/agl-distro/contributing) Quick start guide ----------------- The latest version is available at [AGL wiki](https://wiki.automotivelinux.org/agl-distro/source-code) for the following targets: * [QEMU](https://wiki.automotivelinux.org/agl-distro/source-code) * [Renesas Porter board](https://wiki.automotivelinux.org/start/building_for_the_renesas_r-car_m2) * [Raspberry Pi 2/3](https://wiki.automotivelinux.org/agl-distro/agl-raspberrypi) To build an image from 'meta-agl' 1. Prepare repo: > $ mkdir ~/bin > $ export PATH=~/bin:$PATH > $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo > $ chmod a+x ~/bin/repo 2. Get all layers: > $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo > $ repo sync 3. Check available targets and extensions, select target machine: > $ source meta-agl/scripts/aglsetup.sh -h > $ source meta-agl/scripts/aglsetup.sh -m porter 4. Build agl-image-ivi > $ bitbake agl-image-ivi To build the agl-demo-platform (as demo'ed @ALS) replace 3. and 4. with: 3. Check available targets and extensions, select target machine: > $ source meta-agl/scripts/aglsetup.sh -h > $ source meta-agl/scripts/aglsetup.sh -m porter agl-demo [agl-appfw-smack] [agl-devel] [agl-netboot] 4. Build agl-demo-platform > $ bitbake agl-demo-platform Note: this uses more layers and not only meta-agl AGL Layers and dependencies: ---------------------------- Check the README.md of the respective layers: - meta-agl (= core, no UI) - meta-agl-demo (= reference UI) - meta-agl-extra (= extra components) In addition, the reference hardware (Renesas R-Car Gen2 / porter) has this dependency: URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-renesas > branch: agl-1.0-bsp-1.8.0 > tested revision: 82611ccadef36ab0b8a6fd6fb1cf055e115f1ef5 Supported Machines ------------------ Reference hardware: * QEMU (x86-64) - emulated machine: qemux86-64 * Renesas R-Car Gen2 (R-Car M2) - machine: porter Community contributed hardware: * See: https://wiki.automotivelinux.org/agl-distro#supported_hardware Supported Target of bitbake --------------------------- meta-agl: * `agl-image-ivi` The baseline image of AGL Distributions (console only) * `agl-image-minimal` For internal use to develop distribution (experimental) * `agl-image-weston` For internal use to develop distribution (experimental) meta-agl-demo: * `agl-demo-platform` The demo/reference image (with graphical UI) Run this command for a full list of machines, features and targets: > $ source ./meta-agl/scripts/aglsetup.sh -h Supposed Directory Tree of Layers to build ------------------------------------------- > $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo > $ repo sync > $ tree -L 1 . |-- meta-agl |-- meta-agl-demo |-- meta-agl-devel |-- meta-agl-extra |-- meta-amb |-- meta-fsl-arm |-- meta-fsl-arm-extra |-- meta-intel |-- meta-intel-iot-security |-- meta-openembedded |-- meta-qcom |-- meta-qt5 |-- meta-raspberrypi |-- meta-renesas |-- meta-rust |-- meta-security-isafw |-- meta-ti `-- poky 18 directories, 0 files Build a QEMU image ------------------ You can build a QEMU image using the following steps: (latest version here: https://wiki.automotivelinux.org/agl-distro/source-code) To build an image from 'meta-agl' 1. Prepare repo: > $ mkdir ~/bin > $ export PATH=~/bin:$PATH > $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo > $ chmod a+x ~/bin/repo 2. Get all layers: > $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo > $ repo sync 3. Check available targets and extensions, select target machine: > $ source meta-agl/scripts/aglsetup.sh -h > $ source meta-agl/scripts/aglsetup.sh -m qemux86-64 Alternatively, to enable the reference UI feature ('agl-demo'): > $ source meta-agl/scripts/aglsetup.sh -m qemux86-64 agl-demo Alternatively, to also enable also the security framework ('agl-appfw-smack'): > $ source meta-agl/scripts/aglsetup.sh -m qemux86-64 agl-demo agl agl-appfw-smack Alternatively, to also enable debugging tools ('agl-devel') and the network-boot (nbd) capabilities ('agl-netboot'): > $ source meta-agl/scripts/aglsetup.sh -m qemux86-64 agl-demo agl agl-appfw-smack agl-devel agl-netboot 4. Build agl-image-ivi > $ bitbake agl-image-ivi or alternatively, if you enabled the 'agl-demo' feature: > $ bitbake agl-demo-platform - If you want to run QEMU directly as VM in Virtual Box or your other favorite VM software then add this line to your "conf/local.conf" file. > IMAGE_FSTYPES += "vmdk" 5. Run in the emulator > $ runqemu agl-image-ivi qemux86-64 > or > $ runqemu agl-demo-platform qemux86-64 For a large screen: > $ runqemu agl-image-ivi qemux86-64 bootparams="uvesafb.mode_option=1280x720-32" To extend the amount of memory, add to runqemu: qemuparams="-m 512" > $ runqemu agl-image-ivi qemux86-64 qemuparame="-m 512" bootparams="uvesafb.mode_option=1280x720-32" To separate console from VGA screen (to avoid corrupt screen while booting), add to runqemu: serial > $ runqemu agl-image-ivi qemux86-64 bootparams="uvesafb.mode_option=1280x720-32" serial **Or use the virtual disk in Virtual Box from this location:** > tmp/deploy/images/qemux86-64/agl-demo-platform-qemux86-64.vmdk 6. Some weston samples are available from weston terminal (click top left icon). Check the folder `/opt/AGL/ALS2016`. Build a R-Car M2 (porter) image ------------------------------- ### Software setup NOTE: You will need to download the matching binary driver package from renesas. As of this writing, the version from 20151228. The main URL to retrieve these is: - https://www.renesas.com/en-eu/solutions/automotive/rcar-demoboard.html As of this writing, the necessary libary and driver packages linked to by above site are: - The subpage for the library is: - https://www.renesas.com/en-eu/software/D3017410.html (registr