meta-agl-demo, the Yocto layer for DEMO platform of Automotive Grade Linux ========================================================================== The yocto layer 'meta-agl-demo' provides a demo platform and applications of AGL Distribution. AGL is creating an automotive specific Linux distribution that unifies the software that has been written in a number of places already, such as GENIVI and Tizen IVI. 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) Layer Dependencies ------------------ URI: git://git.yoctoproject.org/poky > branch: dizzy > revision: df87cb27efeaea1455f20692f9f1397c6fcab254 URI: git://git.openembedded.org/meta-openembedded > layer: meta-oe, meta-multimedia, meta-ruby > branch: dizzy > revision: 9efaed99125b1c4324663d9a1b2d3319c74e7278 URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-agl > branch: master > revision: 4d71b6fbe454ff51342ab1eb6791fad66ba98c3e > (or later) URI: https://github.com/meta-qt5/meta-qt5.git > branch: jethro (b/c of qt-5.5.x) > revision: adeca0db212d61a933d7952ad44ea1064cfca747 ## The Renesas R-Car Gen2 (Porter) board depends in addition on: ## URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-renesas > branch: agl-1.0-bsp-1.8.0 > revision: bf30de66badcac7ef82d3758aa44c116ee791a28 > (or later) Packagegroups ------------- AGL Demo Platform's package group design: * packagegroup-agl-demo-platform This is for making image 'agl-demo-platform' which is full image for IVI profile of AGL distro. As meta-agl's design of packagegroups, ``agl-demo-platform.bb`` contains only ``packagegroup-agl-demo-platform`` and packages of DEMO apps. ``packagegroup-agl-demo-platform`` has 4 packagegroups in it, ``packagegroup-agl-core``, ``packagegroup-agl-ivi``, ``packagegroup-agl-ivi-common-core``, and ``packagegroup-agl-appfw``. * packagegroup-agl-appfw* These packagegroups contains packages for application framework of AGL Distro. Subsystem should maintain ``packagegroup-agl-appfw-[subsystem].bb`` which should hold sufficient packages for application framework of AGL Distro. Subsystems also can maintain their own packagegroups under appropriate ``recipes-*/``. For example, Qt5 has 2 packagegroups in ``meta-agl-demo``, ``packagegroup-agl-appfw-native-qt5`` and ``packagegroup-agl-demo-qt-examples`` which are under ``recipes-qt/``. The ``packagegroup-agl-appfw-native-qt5`` is included by ``packagegroup-agl-appfw-native`` because Qt5 belongs to native application framework of AGL Distro. The ``packagegroup-agl-demo-qt-examples`` is added to local.conf if needed because they are not mandatory for AGL application framework and AGL Demo Platform. Supported Machine ----------------- * QEMU (x86-64) - emulated machine: qemux86-64 * Renesas R-Car Gen2 (R-Car M2) - machine: porter Supported Target of bitbake ------------------------ * `agl-demo-platform` The full image of AGL Demo Platform and applications Supposed Directory Trees of Layers to build ------------------------------------------- * For QEMU ${TOPDIR}/ meta-agl/ meta-agl-demo/ meta-openembedded/ meta-qt5/ poky/ * For R-Car M2 ${TOPDIR}/ meta-agl/ meta-agl-demo/ meta-openembedded/ meta-qt5/ meta-renesas/ poky/ Downloading the Source -------------------- You can use repo tool to get all layers which are needed to build AGL Distribution. 1. Installing Repo. Make sure you have a bin/ in your $HOME and it's included in your $PATH. $ mkdir ~/bin $ export PATH=~/bin:$PATH Download the repo tool. $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo $ chmod a+x ~/bin/repo 2. Preparing download. Create an empty directory to hold all recipes and build environment. You can make it as any name you like. $ mkdir WORKING-DIRECTORY $ cd WORKING-DIRECTORY 3. Getting all layers. $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo $ repo sync Build a QEMU image ------------------ You can build a QEMU image using the following steps: 1. Set up environment: You can specify any name for directory which storing all stuffs to build. $ source meta-agl/scripts/envsetup.sh qemux86-64 [BUILD_DIR] 2. Build the full image of AGL Demo Platform and applications $ bitbake agl-demo-platform 2a. 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" 2b. The Weston IVI-Shell always gets built ; it will not be started, however, unless you specify the following in your "conf/local.conf" file : IMAGE_INSTALL_append = " \ weston-ivi-shell-config \ " or you manually overwrite the "/etc/xdg/weston/weston.ini" file with a correct one. 3. Run the emulator. The path for the emulator (runqemu) was added during the envsetup. $ cd tmp/deploy/images/qemex86-64 $ runqemu bzImage-qemux86-64.bin agl-demo-platform-qemux86-64.ext3 For large screen: $ runqemu bzImage-qemux86-64.bin agl-demo-platform-qemux86-64.ext3 \ bootparams="uvesafb.mode_option=1280x720-32" To extend the amount of memory, add to runqemu: qemuparams="-m 512" To separate console from VGA screen (to avoid corrupt screen while booting), add to runqemu: serial or use the virtual disk in Virtual Box from this location: tmp/deploy/images/qemux86-64/agl-demo-platform-qemux86-64.vmdk 4. Some weston samples are available from weston terminal. Build a R-Car M2 (porter) image ------------------------------- #### Obtain and Install Renesas Graphics/Multimedia Drivers 1. Download packages from Renesas The graphics and multimedia acceleration packages for the R-Car M2 Porter board can be download directory from [here](http://www.renesas.com/secret/r_car_download/rcar_demoboard.jsp). There are 2 ZIP files can be downloaded. * Multimedia and Graphics library which require registeration and click through license > r-car_series_evaluation_software_package_for_linux-*.zip * Related Linux drivers > r-car_series_evaluation_software_package_of_linux_drivers-*.zip These 2 files from Renesas should be store in your download directory in $HOME. (e.g. $HOME/Downloads) If not, envsetup.sh in below will stop and show some instruction, then please follow it. #### Build from the Source code You can build a R-Car2 M2 (porter) image using the following steps: 1. Set up environment: You can specify any name for directory which storing all stuffs to build. $ source meta-agl/scripts/envsetup.sh porter [BUILD_DIR] 2. (Optional) If you want to install various Qt5 examples, add below configuration to your local.conf. IMAGE_INSTALL_append = " \ packagegroup-agl-demo-qt-examples \ " PACKAGECONFIG_append_pn-qtbase = " examples" IMPORTANT NOTE: To run examples with wayland-egl plugin, use ``LD_PRELOAD=/usr/lib/libEGL.so ``. If not, programs should not launch by error, 'EGL not available'. 3. (Optional) If you want to use multimedia accelerations, uncomment manually 4 `IMAGE_INSTALL_append_porter` in conf/local.conf. #IMAGE_INSTALL_append_porter = " \ # gstreamer1.0-plugins-bad-waylandsink \ # " #IMAGE_INSTALL_append_porter = " \ # gstreamer1.0-plugins-base-videorate \ ... #" #IMAGE_INSTALL_append_porter = " \ # libegl libegl-dev libgbm-dev \ ... # " #IMAGE_INSTALL_append_porter = " \ # packagegroup-rcar-gen2-multimedia \ ... # " Also it is needed to uncomment this, #MACHINE_FEATURES_append = " multimedia" This `multimedia` enables meta-renesas's multimedia configuration. The version of GStreamer1.0 which AGL distro use, will be chan