X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=docs%2F0_Getting_Started%2F2_Building_AGL_Image%2F3_Initializing_Your_Build_Environment.md;h=199a1e82da27e239a569d3a0a274683b444d2e67;hb=refs%2Ftags%2Fneedlefish_14.0.0;hp=15ad5ed27acf21295cafa26b04d0f9c820d36a67;hpb=f89dc1a25200480f19094c468b2122462bfdfc45;p=AGL%2Fdocumentation.git 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..199a1e8 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 @@ -10,7 +10,7 @@ run to initialize the build environment. You can find this script here: ```sh -$AGL_TOP/master/meta-agl/scripts/aglsetup.sh +$AGL_TOP/needlefish/meta-agl/scripts/aglsetup.sh ``` The script accepts many options that allow you to define build parameters such @@ -18,7 +18,7 @@ as the target hardware (i.e. the machine), build directory, and so forth. Use the following commands to see the available options and script syntax: ```sh -$ cd $AGL_TOP/master +$ cd $AGL_TOP/needlefish $ source meta-agl/scripts/aglsetup.sh -h ``` @@ -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-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. @@ -256,7 +222,7 @@ Common targets are: Running the script creates the Build Directory if it does not already exist. The default Build Directory is `$AGL_TOP//build`, and the nomenclature to be used throughout this doc is going to be `$AGL_TOP//` -For this example, the Build Directory is `$AGL_TOP/master/qemux86-64`. +For this example, the Build Directory is `$AGL_TOP/needlefish/qemux86-64`. The script's output also indicates the machine and AGL features selected for the build.