FoundriesFactory

Changes from Honister that impact a FoundriesFactory

The Yocto Project has made critical changes in the Honister release (3.4). This post details two changes that impact a FoundriesFactory:

A future LmP version will be released based on Honister. These changes do not impact the current version (v85). By knowing what to expect in future LmP versions, plans can be made to ease the transition.

Override Syntax

The syntax of the override operation from underline (_) to a colon (:) This way, an override operation is visually differentiated from a variable created with a mix of uppercase and lowercase separated by one character.

Tip: When using the new override syntax, make sure to use CONF_VERSION = "2" in <build-dir>/conf/local.conf.

The table below shows some common use cases for overrides, with their syntactical change.

BeforeAfter
SRC_URI_appendSRC_URI:append
SRC_URI_removeSRC_URI:remove
SRC_URI_prependSRC_URI:prepend
SRC_URI_machineSRC_URI:machine
EXTRA_OEMAKE_machineEXTRA_OEMAKE:machine
FILESEXTRAPATHS_prependFILESEXTRAPATHS:prepend

It also applies to the append of a function from a .bbappend file. For example:

BeforeAfter
do_install_append() {
//instructions
}
do_install:append() {
//instructions
}

The community provides a script to help with the migration, available in the openembedded-core repository. The instructions on howto use the script is shown in the following command lines:

cd <factory>/layers
./openembedded-core/scripts/contrib/convert-overrides.py meta-subscriber-overrides/
cd meta-subscriber-overrides/
git diff --word-diff

The script should be used to ease the migration process, but remember to review the changes and perform tests to make sure there is no abnormal behavior. The script may not convert a line when there are two overrides, for example PREFERRED_PROVIDER_virtual/kernel:<machine>:lmp, another example is SRC_URI:append:<my-machine>.

In instances where a variable name has mixed case and underline, for example SRC_URI_extra is a new variable and not an override. This variable is in use when a package requires a fetch from two or more sources, where it is common to create a new variable for them.

Tip: Search for any _machine occurrence in your FoundriesFactory to make sure the needed ones are converted to :machine instead (replacing machine with your machine name).

Some terms to search during the convert process:

Core Tune Files

The tune files were reorganized into a directory structure where the files are organized by architecture. It impacts any machine defined in a FoundriesFactory which includes a tune file.

When using the old file location, a BitBake error message, ParseError is printed, with a Could not include required file log. It is only a matter of finding the new directory for that file. For example, the file tune-cortexa53.inc has changed from openembedded-core/meta/conf/machine/include/tune-cortexa53.inc to openembedded-core/meta/conf/machine/include/arm/armv8a/tune-cortexa53.inc

User Password Definition

Starting with Honister, it is not possible to assign a plain text password to a user (the parameter --clear-password does not work). When using LmP, the variable LMP_PASSWORD is set in the file meta-lmp-base/conf/distro/include/lmp.inc.

To define a different password, from the build host:

mkpasswd -m sha512crypt password

It is important to escape any $ characters from the generated hash, and the sha512crypt method is recommended. In case another method is preferred, the appropriate library must be installed to the image.

References

Related posts

Keep up to date with Foundries.io