Port the Yocto labs to Scarthgap

[antznin]

Overall the lab content and flow is the same. Any notable change is described below, so trainers can prepare and take the changes into account when updating their setup.

Slides

• Change the kirkstone references to scarthgap.
• Update to the classes-global/classes-recipe naming in the intro on classes.

Labs

• Common to all boards:

  • Image names now contain .rootfs (e.g. bootlinlabs-image-minimal-bootlinlabs.rootfs.tar.xz).
  • Update the list of host dependencies by extracting from the YP documentation.
  • When creating a recipe with devtool, only sha256 sums of SRC_URI are generated, so remove the suggestions to delete others sums (md5, etc.).
  • SDK file names are slightly different for each board.

• Beagleplay/Beaglebone: the kernels in use were swapped! Now:

  • The Beagleplay uses linux-ti-staging.
  • The Beaglebone uses linux-bb.org.
  • The meta-ti layer is by default overriding the DEPLOY_DIR variable to make point to a directory next to TMPDIR, which is unusual. Override this behavior as it is non-standard (apply patch on meta-ti).

• Beaglebone:

  • When creating a new machine configuration file, two new steps are required:
    • Need to add a custom MACHINEOVERRIDES in the machine configuration, because the kernel and bootloader recipes are using COMPATIBLE_MACHINE to match against beagle.* (instruct to add the override beaglebone).
    • Need to explicitly add tar.xz to IMAGE_FSTYPES, it's not implied by default anymore.

• Beagleplay:

  • Add patches that simplify the meta-ti repository:
    • Remove their DEPLOY_DIR customization that does not follow the standards. Also remove a TMPDIR customization that depends on the former DEPLOY_DIR customization.
    • Update the default defconfig file and remove the override directories, to make it simpler to override the defconfig with Joystick support enabled later in lab5.
    • Update the patch for extlinux support, instead of the default Grub boot.
    • Add support for saving the environment to the boot partition.
  • Stopping U-boot and setting boot_targets is not needed anymore, but booting with bootflow scan -b is necessary for U-boot to boot with extlinux.
  • The instructions to create a new machine are the same, but the content of the machine configuration file have changed quite a lot (based on the default beagleplay configuration file).
  • Fix 32-bit 🡒 64-bit architecture instruction when running file against ctris.

• STM32:

  • Uses scarthgap 5.0.1, not the latest 5.0.4, because at the time of running the labs, meta-st-stm32 was not compatible with the latest version of poky.
  • The extlinux configuration now has multiple entries, so specify which one has to be modified.
  • defconfig update for kernel 6.1 (NFS and joystick/nunchuk support).
  • Custom MACHINE: some variable names have been changed, update them in the instructions.

[github-actions]

All contributors have signed the CLA ✍️ ✅
_{Posted by the CLA Assistant Lite bot.}

[Tropicao]

Hello @antznin, as a side note, as a Bootlin employee you don't have to sign the CAA,. This issue has been fixed recently, if you want the bot to correctly detect that it's ok for you, I suggest to rebase your PR on top of current master and force-push it (unfortunately, if anyone has started reviewing your work, the force push will mark everything as "new", but I have no other way of updating the bot status since the PR has been opened before the CAA fix)

[lucaceresoli]

Thanks for the very accurate work!
It looks very good to me overall. I just added a few minor notes for clarifications or additional improvements.

Luca

[lucaceresoli]

I'd update the "kirkstone or honister" below to "kirkstone or scarthgap" as well.

[lucaceresoli]

An additional note that came to mind just now: we should also update all or most of the places where the classes directory is mentioned and convert that to classes-recipe and classes-global.

This includes changing slides "Introduction to classes" and "Common classes" to mention the new directory organization, and possibly keeping the old classes-dir-only used until Kirkstone as a historical note just like now we have the "note about the future" mentioning the post-Langdale note.

It also includes all or most of the slides reachable by git grep "classes/", e.g. classes/mirrors.bbclass should now be classes-global/mirrors.bbclass.

There might be other places to update in the slides but none came to mind after the training I gave last week, and definitely they can be fixed later on if/when we notice them.

[antznin]

@lucaceresoli:

An additional note that came to mind just now: we should also update all or most of the places where the classes directory is mentioned and convert that to classes-recipe and classes-global.

This includes changing slides "Introduction to classes" and "Common classes" to mention the new directory organization, and possibly keeping the old classes-dir-only used until Kirkstone as a historical note just like now we have the "note about the future" mentioning the post-Langdale note.

The classes/ directory is still in use, though! Example: https://git.openembedded.org/openembedded-core/tree/meta/classes/useradd.bbclass?h=scarthgap.

This is how it's documented at the moment: classes/ - classes whose usage context is not clearly defined. So I think the best it to introduce classes-recipe, classes-global, and note that the classes/ directory exists for classes with an unclear usage context. What do you think?

It also includes all or most of the slides reachable by git grep "classes/", e.g. classes/mirrors.bbclass should now be classes-global/mirrors.bbclass.

There might be other places to update in the slides but none came to mind after the training I gave last week, and definitely they can be fixed later on if/when we notice them.

Will change all of that in this PR.

Edit: see 818a55f.

[lucaceresoli]

Whole series:
Reviewed-by: Luca Ceresoli [email protected]