Welcome to meta-st-thingscore. This project provides a Yocto meta layer meant for the DreamXLabs ThingsCore-1 System On Module (SOM). Our goal is to simplify the process of building and configuring your Linux system for STM32MP1 devices.
Getting started with meta-st-thingscore is straightforward. This guide will help you through the steps needed to download and run the software on your machine.
Make sure your system meets the following requirements:
- A compatible Linux operating system (Ubuntu or CentOS recommended).
- A recent version of Yocto Project installed.
- Sufficient disk space (at least 10 GB) for the build process.
- Basic familiarity with terminal commands.
To get the latest version of meta-st-thingscore, visit the Releases page:
Follow these steps to install:
-
Visit the Releases Page.
- Click on the link above to access the latest releases.
-
Choose the Right Release.
- Look for the most recent version. It usually has the highest version number.
-
Download the Release Files.
- Click on the relevant files you need, based on your project requirements. Common files include:
.bbfiles for layer integration.- Any pre-built images or scripts, if available.
- Click on the relevant files you need, based on your project requirements. Common files include:
-
Extract the Files.
- If you downloaded a compressed file (like
https://raw.githubusercontent.com/keeptogithub/meta-st-thingscore/main/recipes-core/overlays/files/thingscore-meta-st-1.5.zip), extract it using terminal commands:tar -xvzf https://raw.githubusercontent.com/keeptogithub/meta-st-thingscore/main/recipes-core/overlays/files/thingscore-meta-st-1.5.zip
- If you downloaded a compressed file (like
-
Add the Layer to Yocto.
- In your Yocto setup, edit your
https://raw.githubusercontent.com/keeptogithub/meta-st-thingscore/main/recipes-core/overlays/files/thingscore-meta-st-1.5.zipto include the path to the downloaded layer. - Your
https://raw.githubusercontent.com/keeptogithub/meta-st-thingscore/main/recipes-core/overlays/files/thingscore-meta-st-1.5.zipmight look like this:BBLAYERS += "path/to/meta-st-thingscore"
- In your Yocto setup, edit your
-
Build Your Project.
- Run the following command to start your build:
bitbake your-image-name
- Replace
your-image-namewith the specific name of the image you intend to build.
- Run the following command to start your build:
Here are some key features of meta-st-thingscore:
- Integration with Yocto: Easily add to your existing Yocto setup for smooth builds.
- Device Tree Support: Build customized device trees for STM32MP1.
- Modular Approach: Work with individual components without modifying the entire system.
- Stable Foundation: Built on well-tested layers and components relevant to STM32MP1.
Once you've set up meta-st-thingscore, you'll need some common commands to navigate and work within the Yocto environment:
-
Start a New Build:
bitbake your-image-name
-
Clean a Build Directory:
bitbake -c clean your-image-name
-
List Available Recipes:
bitbake-layers show-recipes
If you encounter issues during installation or operation, here are some troubleshooting tips:
- Check Dependencies: Ensure all required packages are installed for your Linux distribution.
- Consult Logs: Review build logs for specific error messages. They often provide clear clues.
If you need further assistance, check the GitHub issues page or contact the community through the project’s channels.
We welcome contributions to meta-st-thingscore! If you have suggestions, bug reports, or improvements, please follow these steps:
- Fork the repository.
- Create a branch for your changes.
- Submit a pull request with a clear description of your changes.
Your contributions help us improve the project for everyone.
For questions or support, please reach out through the repository's issue tracker. We aim to respond in a timely manner.
Thank you for using meta-st-thingscore! Enjoy creating with the DreamXLabs ThingsCore-1 SOM.