3. Initializing Your Build Environment

Part of the downloaded AGL software is a setup script that you must run to initialize the build environment.

aglsetup.sh Script

You can find this script here:

$AGL_TOP/meta-agl/scripts/aglsetup.sh

The script accepts many options that allow you to define build parameters such 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:

$ bash
$ cd $AGL_TOP
$ source meta-agl/scripts/aglsetup.sh -h

AGL Features

Before running the aglsetup.sh, you should understand what AGL features you want to include as part of your image. The script's help output lists available features and shows you the layers in which they reside.

Following is a list of the available features:

Available features:
   [meta-agl]
       agl-all-features :( agl-demo  agl-appfw-smack  agl-devel  agl-hmi-framework  agl-netboot  agl-sota  agl-sdl )
       agl-appfw-smack
       agl-archiver
       agl-ci
       agl-ci-change-features :( agl-demo  agl-appfw-smack  agl-devel  agl-hmi-framework  agl-devel  agl-netboot  agl-appfw-smack  agl-sdl )
       agl-ci-change-features-nogfx :( agl-devel  agl-netboot  agl-appfw-smack )
       agl-ci-snapshot-features :( agl-demo  agl-appfw-smack  agl-devel  agl-hmi-framework  agl-devel  agl-netboot  agl-appfw-smack  agl-archiver  agl-sdl  agl-ptest )
       agl-ci-snapshot-features-nogfx :( agl-devel  agl-netboot  agl-appfw-smack  agl-isafw  agl-archiver  agl-ptest )
       agl-devel
       agl-isafw
       agl-netboot
       agl-ptest
       agl-sota
   [meta-agl-demo]
       agl-demo :( agl-appfw-smack  agl-devel  agl-hmi-framework )
       agl-iotivity
       agl-sdl
   [meta-agl-devel]
       agl-audio-4a-framework
       agl-audio-soundmanager-framework
       agl-egvirt
       agl-hmi-framework
       agl-oem-extra-libs
       agl-renesas-kernel
   [meta-agl-extra]
       agl-localdev
       eas

To find out exactly what a feature provides, WE NEED SOME GUIDANCE HERE. MAYBE SOME INDIVIDUAL README FILES LOCATED IN THE TEMPLATE AREAS FOR THE FEATURES.

An AGL feature is a configuration that accounts for specific settings and dependencies needed for a particular build. For example, specifying the "agl-demo" feature makes sure that the aglsetup.sh script creates configuration files needed to build the image for the AGL demo.

Following are brief descriptions of the AGL features you can specify on the aglsetup.sh command line:

  • 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-archiver: Enables the archiver class for releases.

  • agl-ci: Flags used for Continuous Integration (CI). Using this feature changes the value of the IMAGE_FSTYPES variable.

  • agl-ci-change-features: Enables features for CI builds for Gerrit changes.

  • agl-ci-change-features-nogfx: Enables features for CI builds for Gerrit changes for targets that use binary graphics drivers (i.e. builds without graphics).

  • agl-ci-snapshot-features: Enables features for CI daily snapshot builds.

  • agl-ci-snapshot-features-nogfx: Enables features for CI daily snapshot builds for targets that use binary graphics drivers (i.e. builds without graphics).

  • agl-devel: Activates development options such as an empty root password, debuggers, strace, valgrind, and so forth.

  • agl-isafw: Enables an image security analysis framework. NOTE: This feature is deprecated.

  • agl-netboot: Enables network boot support through Trivial File Transfer Protocol (TFTP) and Network Block Device (NBD) protocol. Netboot is needed for CI and useful for development to avoid writing sdcards. Needs additional setup.

  • agl-ptest: Enables Ptest as part of the build.

  • agl-sota: Enables Software Over-the-Air (SOTA) components and dependencies. Includes meta-updater, meta-updater-qemux86-64, and meta-filesystems.

  • 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-iotivity: Enables iotivity such as status unclear, needs check, and needs removal.

  • agl-sdl: Enables or adds SDL to the build.

  • agl-audio-4a-framework: Enables AGL advanced audio architecture, which is an exclusive switch for audio framework.

  • agl-audio-soundmanager-framework: Enables Soundmanager framework, which is an exclusive switch for audio framework.

  • agl-egvirt: Enables virtualization support for the R-Car.

  • agl-hmi-framework: Enables HMI framework. HMI framework is enabled by default.

  • agl-oem-extra-libs: Pulls in additional libraries. NOTE: This feature is under construction. It needs further work and testing.

  • agl-renesas-kernel: Enables renesas-specific kernel options.

  • agl-telemetry: Enables the telemetry demo. To use this feature, you must convert it into agl-profile-telematics. NOTE: agl-telemetry is not in the layer.

  • 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.

This feature provides a shortcut for using the layer meta-localdev in the top-level folder for easy modifications to your own recipes.

  • eas: I don't know what this does.

Example

Following is an example that initializes the build environment, selects "beaglebone" for the machine, and chooses the "agl-demo" feature, which also includes the "agl-appfw-smack", "agl-devel", and "agl-hmi-framework" features:

$ source meta-agl/scripts/aglsetup.sh -m beaglebone agl-demo
aglsetup.sh: Starting
Generating configuration files:
   Build dir: /home/scottrif/workspace_agl/build
   Machine: beaglebone
   Features: agl-appfw-smack agl-demo agl-devel agl-hmi-framework
   Running /home/scottrif/workspace_agl/poky/oe-init-build-env
   Templates dir: /home/scottrif/workspace_agl/meta-agl/templates/base
   Config: /home/scottrif/workspace_agl/build/conf/bblayers.conf
   Config: /home/scottrif/workspace_agl/build/conf/local.conf
   Setup script: /home/scottrif/workspace_agl/build/conf/setup.sh
   Executing setup script ... --- beginning of setup script
 fragment /home/scottrif/workspace_agl/meta-agl/templates/base/01_setup_EULAfunc.sh
 fragment /home/scottrif/workspace_agl/meta-agl/templates/base/99_setup_EULAconf.sh
 end of setup script
OK
Generating setup file: /home/scottrif/workspace_agl/build/agl-init-build-env ... OK
aglsetup.sh: Done

 Shell environment set up for builds.

You can now run 'bitbake target'

Common targets are:
  - meta-agl:          (core system)
    agl-image-minimal
    agl-image-minimal-qa

    agl-image-ivi
    agl-image-ivi-qa
    agl-image-ivi-crosssdk

    agl-image-weston

  - meta-agl-demo:     (demo with UI)
    agl-demo-platform  (* default demo target)
    agl-demo-platform-qa
    agl-demo-platform-crosssdk

    agl-demo-platform-html5
$

Running the script creates the Build Directory if it does not already exist. For this example, the Build Directory is "$AGL_TOP/workspace_agl/build".

The script's output also indicates the machine and AGL features selected for the build.

The script creates two primary configuration files used for the build: local.conf and bblayers.conf. Both these configuration files are located in the Build Directory in the conf folder. If you were to examine these files, you would find standard Yocto Project configurations along with AGL configuration fragments, which are driven by the machine (i.e. beaglebone) and the AGL features specified as part of the script's command line.

The end result is configuration files specific for your build in the AGL development environment.

Finally, part of the aglsetup.sh script makes sure that any End User License Agreements (EULA) are considered. You can see that processing in the script's output as well.

NOTE: Use of the local.conf and bblayers.conf configuration files is fundamental in the Yocto Project build environment. Consequently, it is fundamental in the AGL build environment. You can find lots of information on configuring builds in the Yocto Project documentation set. Here are some references if you want to dig into configuration further: