oe-build
Note that building an entire distribution is a long process. It also requires a big amount of free disk space.
The support for Microchip MPU SoC family is included in a particular Yocto Project layer: meta-mchp. The source for this layer are hosted on Linux4Microchip GitHub account: https://github.com/linux4microchip/meta-mchp
Building environment
A step-by-step comprehensive installation is explained in the Yocto Project Quick Build. The following lines have to be considered as an add-on that is MPU specific or that can facilitate your setup.
Step by step build procedure
here is the README procedure available directly in the meta-mchp-common layer. This file in the meta-mchp layer repository must be considered as the reference and the following copy can be out-of-sync.
starting with Linux4Microchip 2025.04 release, the meta-mchp layer supports Yocto Project templates, so make sure you create a new build environment using oe-init-build-env
OpenEmbedded/Yocto Project BSP layer for Microchip's SoCs
Description
The meta-mchp-common layer consolidates common Board Support Package (BSP) components and metadata for Microchip platforms, streamlining development across various Microchip devices for use with OpenEmbedded and/or Yocto Project.
Supported Machines
The meta-mchp-common layer provides support for various Microchip platforms. For detailed information about supported machines, please refer to the documentation in the relevant sub-layers:
Prerequisites
Before starting, please refer to the Required Packages for Build Host section in the Yocto Project Documentation to install required dependencies for the build environment:
For instance, on Ubuntu or Debian, these packages need to be installed on your development host:
build-essential chrpath socat cpio python3 python3-pip python3-pexpect \
xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev \
pylint3 xterm repo
Usage
To integrate this layer into your Yocto Project build environment:
Clone the necessary repositories:
Create an empty directory to hold the workspace:
cd yocto-dev
Use the repo tool to fetch all the required repositories
Make sure to install the repo utility first.
Replace and with the Yocto release branch and the manifest required. For example:
Fetch all the required repositories using the following repo command:
Initialize the build environment:
The meta-mchp repository provides sample configuration templates that help set up BitBake layers and key configuration files in the Yocto build directory.
Set the TEMPLATECONF environment variable to point to the appropriate configuration template before initializing the build environment:
Replace meta-layer above with the desired layer based on your target platform. For example:
Note: Setting TEMPLATECONF is only needed the first time you will run the source command.
Then initialize the Yocto build environment:
Set the target machine and build the image:
Each sub-layer provides several images that include demos and applications tailored for its respective platform.
For more information on the supported images, please refer to the README:
Layer Dependencies
This layer depends on the following layers:
- URI: git://git.openembedded.org/meta-openembedded
- Layers: meta-oe, meta-networking, meta-python
- openembedded-core
- URI: git://git.openembedded.org/openembedded-core
- Layers: meta
For information on the specific revisions used, refer to the meta-mchp manifest repository.
Licensing
The contents of this layer are licensed under the MIT License. See COPYING.MIT for details.
Contributing
If you want to contribute changes, you can send Github pull requests at https://github.com/linux4microchip/meta-mchp/pulls.
See CONTRIBUTING.md for additional information about contribution guidelines.
Maintainers
- Hari Prasath G E <hari.prasathge@microchip.com>
- Valentina Fernandez Alanis <valentina.fernandezalanis@microchip.com>
- Dharma Balasubiramani <dharma.b@microchip.com>
