Adding a new machine to the Yocto Project is a straightforward process. This section describes how to add machines that are similar to those that the Yocto Project already supports. Note : Although well within the capabilities of the Yocto Project, adding a totally new architecture might require changes to gcc/glibc and to the site information, which is beyond the scope of this manual.

Execution & Command Syntax

Terminalbash
find full details on these variables in the reference section
Terminalbash
find several kernel recipe examples in the Source Directory at meta/recipes-kernel/linux that you can use as references
Terminalbash
make defconfig command or, more commonly, by copying in a suitable defconfig file and then running make oldconfig

Technical Implementation Details

For a complete example that shows how to add a new machine, see the “Creating a New BSP Layer Using the yocto-bsp Script” section in the Yocto Project Board Support Package (BSP) Developer’s Guide. Adding the Machine Configuration File To add a new machine, you need to add a new machine configuration file to the layer’s conf/machine directory. This configuration file provides details about the device you are adding. The OpenEmbedded build system uses the root name of the machine configuration file to reference the new machine. For example, given a machine configuration file named crownbay.conf, the build system recognizes the machine as “crownbay”. The most important variables you must set in your machine configuration file or include from a lower-level configuration file are as follows: TARGET_ARCH (e.g.

Gotchas and Common Issues

  • Permission Verification - confirm execution permissions and path variables before invoking system binaries.

  • Version Compatibility - check software version release notes for deprecated flags or syntax changes.

  • Log Monitoring - inspect system logs (journalctl or /var/log) to troubleshoot execution failures.

Following these steps ensures clean configuration, proper security boundaries, and reliable execution for adding new machine in yocto bitbake meta layers.