aboutsummaryrefslogtreecommitdiffstats
path: root/docs/0_Getting_Started
diff options
context:
space:
mode:
authorJan-Simon Möller <jsmoeller@linuxfoundation.org>2022-01-26 12:25:31 +0100
committerJan-Simon Moeller <jsmoeller@linuxfoundation.org>2022-02-02 11:50:02 +0000
commit8160b5cdc8547277f3f31ee1e41524754d5d987d (patch)
tree6ebbcfa9802c82de6b552733ef53d411247e1cdd /docs/0_Getting_Started
parent835363f430c5dee0b53b7c415572cdfdcc02ad18 (diff)
Update to documentation before Marlinmarlin_12.92.0marlin/12.92.012.92.0
This is mostly a cleanup before the Magic Marlin Release. We do have the Application Framework chapter rewrite pending. Bug-AGL: SPEC-4236 Signed-off-by: Jan-Simon Möller <jsmoeller@linuxfoundation.org> Change-Id: I7e1f39667b4db417497b1d0c84065c173fa18439 Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/27097
Diffstat (limited to 'docs/0_Getting_Started')
-rw-r--r--docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md2
-rw-r--r--docs/0_Getting_Started/2_Building_AGL_Image/3_Initializing_Your_Build_Environment.md130
-rw-r--r--docs/0_Getting_Started/2_Building_AGL_Image/5_1_x86_Emulation_and_Hardware.md47
3 files changed, 92 insertions, 87 deletions
diff --git a/docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md b/docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md
index a10becd..eaae38e 100644
--- a/docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md
+++ b/docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md
@@ -44,7 +44,7 @@ AGL provides a number of pre-built ready-made images of various versions.
```sh
$ ( sleep 5 && vinagre --vnc-scale localhost ) > /tmp/vinagre.log 2>&1 &
- qemu-system-x86_64 -device virtio-net-pci,netdev=net0,mac=52:54:00:12:35:02 -netdev user,id=net0,hostfwd=tcp::2222-:22 \
+ $ qemu-system-x86_64 -device virtio-net-pci,netdev=net0,mac=52:54:00:12:35:02 -netdev user,id=net0,hostfwd=tcp::2222-:22 \
-drive file=agl-demo-platform-crosssdk-qemux86-64.ext4,if=virtio,format=raw -show-cursor -usb -usbdevice tablet -device virtio-rng-pci \
-snapshot -vga virtio \
-vnc :0 -soundhw hda -machine q35 -cpu kvm64 -cpu qemu64,+ssse3,+sse4.1,+sse4.2,+popcnt -enable-kvm \
diff --git a/docs/0_Getting_Started/2_Building_AGL_Image/3_Initializing_Your_Build_Environment.md b/docs/0_Getting_Started/2_Building_AGL_Image/3_Initializing_Your_Build_Environment.md
index 15ad5ed..efe7001 100644
--- a/docs/0_Getting_Started/2_Building_AGL_Image/3_Initializing_Your_Build_Environment.md
+++ b/docs/0_Getting_Started/2_Building_AGL_Image/3_Initializing_Your_Build_Environment.md
@@ -36,8 +36,6 @@ Available machines:
bbe # BeagleBoneEnhanced
beaglebone # BeagleBone
cubox-i # multiple i.MX6 boards
- cyclone5 # CycloneV
- dra7xx-evm # TI DRA7xx-EVM 'vayu'
dragonboard-410c # Qualcomm Dragonboard 410c
dragonboard-820c # Qualcomm Dragonboard 820c
ebisu # Renesas RCar Ebisu
@@ -50,6 +48,7 @@ Available machines:
imx8mqevk # i.MX8 w etnaviv
imx8mqevk-viv # i.MX8 w vivante
intel-corei7-64 # x86-64 (Intel flavour)
+ j7-evm # TI Jacinto 7 EVM
m3-salvator-x # Renesas RCar Salvator/M3
m3ulcb # Renesas RCar M3
m3ulcb-kf # Renesas RCar M3 w Kingfisher Board
@@ -59,6 +58,8 @@ Available machines:
qemuarm64 # Qemu AArch 64 (ARM 64bit)
* qemux86-64 # Qemu x86-64
raspberrypi4 # Raspberry Pi 4
+ virtio-aarch64 # Virtio Guest
+
```
## AGL Features
@@ -72,54 +73,50 @@ Following is a list of the available features:
```sh
Available features:
- [meta-agl]
- agl-all-features :( agl-demo agl-appfw-smack agl-hmi-framework agl-profile-graphical-qt5 agl-profile-graphical agl-pipewire agl-speech-framework agl-netboot )
- agl-appfw-smack
- agl-archiver
- agl-buildstats
- agl-ci
- agl-ci-change-features :( agl-demo agl-appfw-smack agl-hmi-framework agl-profile-graphical-qt5 agl-profile-graphical agl-pipewire agl-speech-framework agl-devel agl-netboot agl-pipewire agl-cloudproxy agl-buildstats agl-ptest )
- agl-ci-change-features-nogfx :( agl-demo agl-appfw-smack agl-hmi-framework agl-profile-graphical-qt5 agl-profile-graphical agl-pipewire agl-speech-framework agl-devel agl-netboot agl-pipewire agl-cloudproxy agl-buildstats agl-ptest )
- agl-ci-snapshot-features :( agl-demo agl-appfw-smack agl-hmi-framework agl-profile-graphical-qt5 agl-profile-graphical agl-pipewire agl-speech-framework agl-devel agl-netboot agl-archiver agl-pipewire agl-buildstats agl-ptest )
- agl-ci-snapshot-features-nogfx :( agl-demo agl-appfw-smack agl-hmi-framework agl-profile-graphical-qt5 agl-profile-graphical agl-pipewire agl-speech-framework agl-devel agl-netboot agl-archiver agl-pipewire agl-buildstats agl-ptest )
- agl-devel
- agl-fossdriver
- agl-gplv2
- agl-hmi-framework
- agl-netboot
- agl-pipewire
- agl-profile-cluster :( agl-profile-graphical )
- agl-profile-cluster-qt5 :( agl-profile-graphical-qt5 agl-profile-graphical )
- agl-profile-graphical
- agl-profile-graphical-html5 :( agl-profile-graphical )
- agl-profile-graphical-qt5 :( agl-profile-graphical )
- agl-profile-hud
- agl-profile-telematics
- agl-ptest
- agl-sign-wgts
- agl-sota
- agl-virt
- agl-virt-guest-xen
- agl-virt-xen :( agl-virt )
- agl-weston-remoting :( agl-profile-graphical )
- [meta-agl-cluster-demo]
- agl-cluster-demo :( agl-profile-cluster-qt5 agl-profile-graphical-qt5 agl-profile-graphical agl-hmi-framework )
- agl-cluster-demo-preload
- [meta-agl-demo]
- agl-cloudproxy
- agl-cluster-demo-support :( agl-weston-remoting agl-profile-graphical )
- agl-demo :( agl-appfw-smack agl-hmi-framework agl-profile-graphical-qt5 agl-profile-graphical agl-pipewire agl-speech-framework )
- agl-demo-preload
- agl-demo-soundmanager :( agl-appfw-smack agl-hmi-framework agl-profile-graphical-qt5 agl-profile-graphical agl-audio-soundmanager-framework )
- [meta-agl-devel]
- agl-jailhouse
- agl-speech-framework
- agl-voiceagent-alexa :( agl-speech-framework )
- agl-voiceagent-alexa-wakeword :( agl-voiceagent-alexa agl-speech-framework )
- [meta-agl-extra]
- agl-localdev
- [meta-agl-telematics-demo]
- agl-telematics-demo :( agl-profile-telematics )
+
+ [meta-agl] # CORE layer
+ agl-all-features :( agl-demo agl-pipewire agl-app-framework agl-netboot )
+ # For the usual demo image
+ agl-app-framework # Application Framework
+ agl-archiver # Source Archiver
+ agl-buildstats # Build Statistics
+ agl-devel :( agl-package-management ) # Developer Env (root login)
+ agl-fossdriver # Fossology integration
+ agl-gplv2 # GPLv2-only packages
+ agl-localdev # inclusion of local development folder
+ agl-netboot # network boot (e.g. CI)
+ agl-package-management # include package management (e.g. rpm)
+ agl-pipewire # include pipewire
+ agl-ptest # enable ptest pckages
+ agl-refhw-h3 # enable reference hardware
+ agl-virt # EG-Virt features
+ agl-virt-guest-xen # EG-Virt features
+ agl-virt-xen :( agl-virt ) # EG-Virt features
+ agl-weston-remoting :( agl-demo agl-pipewire agl-app-framework )
+ agl-weston-waltham-remoting :( agl-demo agl-pipewire agl-app-framework )
+
+ [meta-agl-demo] # DEMO layer
+ agl-cluster-demo-support :( agl-weston-remoting agl-demo agl-pipewire agl-app-framework )
+ # sample IVI demo
+ agl-demo :( agl-pipewire agl-app-framework ) # default IVI demo
+ agl-demo-preload # Add Tokens and sample files
+
+ [meta-agl-devel] # Development layer
+ agl-basesystem # Toyota basesystem
+ agl-drm-lease # DRM lease support
+ agl-egvirt # EG-Virt feature
+ agl-flutter # Flutter support
+ agl-jailhouse # GSoC: jailhouse enablement
+ agl-lxc :( agl-drm-lease agl-pipewire ) # IC-EG container support
+ agl-ros2 # GSoC: ros2 enablement
+
+Specialized features (e.g. CI):
+ agl-ci # Tweaks for CI
+ agl-ci-change-features :( agl-demo agl-pipewire agl-app-framework agl-devel agl-package-management agl-netboot agl-pipewire agl-buildstats agl-ptest )
+ agl-ci-change-features-nogfx :( agl-demo agl-pipewire agl-app-framework agl-devel agl-package-management agl-netboot agl-pipewire agl-buildstats agl-ptest )
+ agl-ci-snapshot-features :( agl-demo agl-pipewire agl-app-framework agl-devel agl-package-management agl-netboot agl-archiver agl-pipewire agl-buildstats agl-ptest )
+ agl-ci-snapshot-features-nogfx :( agl-demo agl-pipewire agl-app-framework agl-devel agl-package-management agl-netboot agl-archiver agl-pipewire agl-buildstats agl-ptest )
+
```
To find out exactly what a feature provides, check out the respective layer and its README.
@@ -136,8 +133,7 @@ Following are brief descriptions of the AGL features you can specify on the
* **agl-all-features**: A set of AGL default features.
Do not think of this set of features as all the AGL features.
-* **agl-appfw-smack**: Enables IoT.bzh Application Framework plus SMACK and
- Cynara.
+* **agl-app-framework**: Application Framework
* **agl-archiver**: Enables the archiver class for releases.
@@ -163,45 +159,15 @@ Following are brief descriptions of the AGL features you can specify on the
Netboot is needed for CI and useful for development to avoid writing
sdcards. Needs additional setup.
-<!--
-* **agl-profile**: A group or set of Layers and a Package Group as used
- by the Yocto Project.
- This feature helps define dependency for various profiles and layers
- used during the build.
- For example, "agl-demo" depends on "agl-profile-graphical-qt", which
- in turn depends on "agl-profile-graphical", which in turn depends
- on "agl-profile-core".
-
- agl-profile-graphical
- agl-profile-graphical-html5
- agl-profile-graphical-qt5
- agl-profile-hud
- agl-profile-telematics
-
- **NOTE:** For information on Package Groups, see the
- "[Customizing Images Using Custom Package Groups](https://www.yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)"
- section in the Yocto Project Development Tasks Manual.
- You can also find general information about Layers in the
- "[Layers](https://www.yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#yocto-project-layers)"
- section in that same manual.
--->
-
* **agl-ptest**: Enables
[Ptest](https://yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#testing-packages-with-ptest)
as part of the build.
-* **agl-sota**: Enables Software Over-the-Air (SOTA) components and dependencies.
- Includes meta-updater, meta-updater-qemux86-64, meta-filesystems, and meta-python.
-
* **agl-demo**: Enables the layers meta-agl-demo and meta-qt5.
You need agl-demo if you are going to build the agl-demo-platform.
-* **agl-sdl**: Enables or adds SDL to the build.
-
* **agl-pipewire**: Enables AGLs pipewire support.
-* **agl-audio-soundmanager-framework**: Enables Soundmanager framework, which is an exclusive switch for audio framework.
-
* **agl-localdev**: Adds a local layer named "meta-localdev" in the
meta directory and a local.dev.inc configuration file when that file
is present.
diff --git a/docs/0_Getting_Started/2_Building_AGL_Image/5_1_x86_Emulation_and_Hardware.md b/docs/0_Getting_Started/2_Building_AGL_Image/5_1_x86_Emulation_and_Hardware.md
index 0f2121c..7282f66 100644
--- a/docs/0_Getting_Started/2_Building_AGL_Image/5_1_x86_Emulation_and_Hardware.md
+++ b/docs/0_Getting_Started/2_Building_AGL_Image/5_1_x86_Emulation_and_Hardware.md
@@ -18,7 +18,7 @@ using the `aglsetup.sh` script.
If you are building the AGL demo image for emulation, you need to specify some
specific options when you run the script:
-**Qt based IVI demo :**
+**Sample Qt based IVI demo :**
```sh
$ source meta-agl/scripts/aglsetup.sh -f -m qemux86-64 -b qemux86-64 agl-demo agl-devel
@@ -28,7 +28,7 @@ $ echo 'SSTATE_DIR = "$AGL_TOP/sstate-cache/"' >> $AGL_TOP/site.conf
$ ln -sf $AGL_TOP/site.conf conf/
```
-**HTML5 based IVI demo :**
+**Sample HTML5 based IVI demo :**
```sh
$ source meta-agl/scripts/aglsetup.sh -f -m qemux86-64 -b qemux86-64 agl-demo agl-devel agl-profile-graphical-html5
@@ -38,6 +38,26 @@ $ echo 'SSTATE_DIR = "$AGL_TOP/sstate-cache/"' >> $AGL_TOP/site.conf
$ ln -sf $AGL_TOP/site.conf conf/
```
+**IVI-EG Flutter based demo :**
+
+```sh
+$ source meta-agl/scripts/aglsetup.sh -f -m qemux86-64 -b qemux86-64 agl-flutter agl-devel
+$ echo '# reuse download directories' >> $AGL_TOP/site.conf
+$ echo 'DL_DIR = "$HOME/downloads/"' >> $AGL_TOP/site.conf
+$ echo 'SSTATE_DIR = "$AGL_TOP/sstate-cache/"' >> $AGL_TOP/site.conf
+$ ln -sf $AGL_TOP/site.conf conf/
+```
+
+**IC-EG container image :**
+```sh
+### TBD
+```
+
+**Virt-EG demo image :**
+```sh
+### TBD
+```
+
The "-m" option specifies the "qemux86-64" machine.
The list of AGL features used with script are appropriate for development of
the AGL demo image suited for either QEMU or VirtualBox.
@@ -50,7 +70,7 @@ Start the build using the `bitbake` command.
CPU and and Internet connection speeds.
The build also takes approximately 100G-bytes of free disk space.
-**Qt based IVI demo :**
+**Sample Qt based IVI demo :**
The target is `agl-demo-platform`.
```sh
@@ -65,7 +85,7 @@ By default, the build process puts the resulting image in the Build Directory an
$ export IMAGE_NAME=agl-demo-platform-qemux86-64.vmdk.xz
```
-**HTML5 based IVI demo :**
+**Sample HTML5 based IVI demo :**
The target is `agl-demo-platform-html5`.
```sh
@@ -80,10 +100,29 @@ By default, the build process puts the resulting image in the Build Directory an
$ export IMAGE_NAME=agl-demo-platform-html5-qemux86-64.vmdk.xz
```
+**IVI-EG Flutter based demo :**
+The target is `agl-image-flutter`.
+
+```sh
+$ time bitbake agl-image-flutter
+```
+
+**IC-EG container image :**
+```sh
+# TBD
+```
+
+**Virt-EG demo image :**
+```sh
+# TBD
+```
+
## 3. Deploying the AGL Demo Image
Deploying the image consists of decompressing the image and then
booting it using either QEMU, VirtualBox or physical system.
+The examples below are usually for the 'agl-demo-platform' target.
+Please adapt accordingly to your target image.
**3.1 QEMU**