diff options
Diffstat (limited to 'README-AGL.md')
| -rw-r--r-- | README-AGL.md | 411 |
1 files changed, 3 insertions, 408 deletions
diff --git a/README-AGL.md b/README-AGL.md index 146d6ff16..9ae0ee1e9 100644 --- a/README-AGL.md +++ b/README-AGL.md @@ -1,7 +1,7 @@ ?README-AGL.md: The Automotive Grade Linux Distribution ====================================================== -AGL is creating an automotive specific Linux distribution (AGL UCB) +[AGL](https://www.automotivelinux.org/) 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. @@ -26,411 +26,6 @@ For information abount Getting started with AGL 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 += "wic.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.wic.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 (registration/login required) - - - The sub-page for the driver is: - - https://www.renesas.com/en-eu/media/secret/solutions/automotive/rcar-demoboard/R-Car_Series_Evaluation_Software_Package_of_Linux_Drivers-20151228.zip - - !!! The files need to be in `${HOME}/Downloads` ( `$XDG_DOWNLOAD_DIR` ) !!! - -#### Getting Source Code and Build image - -(latest version here: https://wiki.automotivelinux.org/agl-distro/source-code) -To build an image from 'meta-agl' only: - -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 - - Alternatively, to enable the reference UI: - > $ source meta-agl/scripts/aglsetup.sh -m porter agl-demo - - Alternatively, to also enable also the security framework: - > $ source meta-agl/scripts/aglsetup.sh -m porter agl-demo agl agl-appfw-smack - - Alternatively, to also enable debugging tools and the network-boot (nbd) capabilities: - > $ source meta-agl/scripts/aglsetup.sh -m porter agl-demo agl agl-appfw-smack agl-devel agl-netboot - -4. (optional) edit conf/local.conf )* see below - > $ vi conf/local.conf - -5. Build agl-image-ivi - > $ bitbake agl-image-ivi - - or alternatively, if you enabled the 'agl-demo' feature: - > $ bitbake agl-demo-platform - - -)* : - - 4 . Optional edits to conf/local.conf - - * 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` MACHINE_FEATURES enables the meta-renesas's specific multimedia configuration. - The version of GStreamer1.0 which AGL distro will use is changed - to 1.2.3 (meta-renesas prefers it) over 1.4.1 (meta-agl default) - by this switch. - -* 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 <command>``. -> If not, programs should not launch by error, -> 'EGL not available'. - - -### Deployment (SDCARD) - -#### Instructions on the host - -1. Format SD-Card and then, create single EXT4 partition on it. - -2. Mount the SD-Card, for example `/media/$SDCARD_LABEL`. - -3. Copy AGL root file system onto the SD-Card - 1. Go to build directory - > $ cd $AGL_TOP/build/tmp/deploy/images/porter - - 2. Extract the root file system into the SD-Card - > $ sudo tar --extract --numeric-owner --preserve-permissions --preserve-order \ - > --totals --directory=/media/$SDCARD_LABEL --file=agl-image-ivi-porter.tar.bz2 - - 3. Copy kernel and DTB into the `/boot` of the SD-Card - > $ sudo cp uImage uImage-r8a7791-porter.dtb /media/$SDCARD_LABEL/boot - -4. After the copy finished, unmount SD-Card and insert it into the SD-Card slot of the porter board. - -#### Instructions on the target - -NOTE: There is details about porter board [here](http://elinux.org/R-Car/Boards/Porter). - -NOTE: To boot weston on porter board, we need keyboard and mouse. (USB2.0 can be use for this) - -##### Change U-Boot parameters to boot from SD card - -1. Power up the board and, using your preferred terminal emulator, stop the board's autoboot by hitting any key. - - ``Debug serial settings are 38400 8N1. Any standard terminal emulator program can be used.** - -2. Set the follow environment variables and save them -> => setenv bootargs_console console=ttySC6,${baudrate} -> => setenv bootargs_video vmalloc=384M video=HDMI-A-1:1024x768-32@60 -> => setenv bootcmd_sd 'ext4load mmc 0:1 0x40007fc0 boot/uImage;ext4load mmc 0:1 0x40f00000 boot/uImage-r8a7791-porter.dtb' -> => setenv bootcmd 'setenv bootargs ${bootargs_console} ${bootargs_video} root=/dev/mmcblk0p1 rw rootfstype=ext4;run bootcmd_sd;bootm 0x40007fc0 - 0x40f00000' -> => saveenv - -##### Boot from SD card - -1. After board reset, U-Boot is started and after a countdown, ... - Linux boot message should be displayed. Please wait a moment. - -2. Then weston is booted automatically, and weston-terminal appears. - -3. Have fun! :) - -### Deployment (TFTP/NFS) - -NOTE: These instructions are based on Embedded Linux Wiki, [here](http://www.elinux.org/R-Car/Boards/Yocto#Loading_kernel_via_TFTP_and_rootfs_via_NFS). And a Debian (wheezy, ip: 192.168.30.70) is used as the host for this instructions. - -#### Instructions on the host -1. Setup a TFTP server - 1. Install necessary packages - > $ sudo apt-get install tftp tftpd-hpa - - 2. Go to build directory, and copy kernel and DTB into TFTP server root (default server dir: /srv/tftp) - > $cd $AGL_TOP/build/tmp/deploy/images/porter - > $ sudo cp uImage uImage-r8a7791-porter.dtb /srv/tftp - - 3. Verify TFTP server is working - > $ ls uImage - ls: cannot access uImage: No such file or directory - - > $ cd /tmp/ - > $ tftp 192.168.30.70 - > tftp> get uImage - > Received 3583604 bytes in 0.2 seconds - > tftp> q - > $ ls uImage - > uImage - -2. set NFS server - 1. Install necessary packages - > $ sudo apt-get install nfs-kernel-server nfs-common - - 2. Go to build directory, and extract the root file system into a dedicated directory (here we use /nfs/porter) - > $ cd $AGL_TOP/build/tmp/deploy/images/porter - > $ sudo mkdir -p /nfs/porter - > $ sudo tar --extract --numeric-owner --preserve-permissions --preserve-order \ - > --totals --directory=/nfs/porter --file=agl-demo-platform-porter.tar.bz2 - - 3. Edit /etc/exports - > $ sudo vi /etc/exports - Add - > - > /nfs/porter *(rw,no_subtree_check,sync,no_root_squash,no_all_squash) - > - Save the file and exit. - - 4. Restart nfs service - > $ sudo service nfs-kernel-server restart - - 5. Verify NFS server is working - > $ sudo mount -t nfs 192.168.30.70:/nfs/porter /tmp/ - > $ ls /tmp - > bin boot dev etc home lib media mnt proc run sbin sys tmp usr var - -#### Instructions on the target board - -NOTE: There is details about porter board [here](http://elinux.org/R-Car/Boards/Porter). - -NOTE: To boot weston on porter board, we need keyboard and mouse. (USB2.0 can be use for this) - -##### Change U-Boot parameters to boot from TFTP/NFS - -1. Power up the board and, using your preferred terminal emulator, stop the board's autoboot by hitting any key. - - > Debug serial settings are 38400 8N1. Any standard terminal emulator program can be used. - -2. Set the follow environment variables and save them -> => setenv ipaddr <board-ip> -> => setenv serverip <host-ip> -> => setenv bootargs_console console=ttySC6,${baudrate} -> => setenv bootargs_video vmalloc=384M video=HDMI-A-1:1024x768-32@60 -> => setenv bootcmd_net 'tftp 0x40007fc0 uImage; tftp 0x40f00000 uImage-r8a7791-porter.dtb' -> => setenv bootcmd 'setenv bootargs ${bootargs_console} ${bootargs_video} ip=${ipaddr} root=/dev/nfs nfsroot=${serverip}:/nfs/porter,vers=3;run bootcmd_net;bootm 0x40007fc0 - 0x40f00000' -> => saveenv - - Replace <board-ip> with a proper IP address for the board, like 192.168.30.60. - Replace <host-ip> with the IP address of the host, here we use 192.168.30.70. - -##### Boot from TFTP/NFS - -1. After board reset, U-Boot is started and after a countdown, ... - Linux boot message should be displayed. Please wait a moment. -2. Then weston is booted automatically, and weston-terminal appears. -3. Have fun! :) +For more documentation about AGL: +* [docs.automotivelinux.org](http://docs.automotivelinux.org) |