mirror of
git://git.yoctoproject.org/meta-raspberrypi.git
synced 2025-07-19 21:09:03 +02:00
d058d2a2cf
The kas tool provides an easy mechanism to setup bitbake based projects. As explained in [1] the key features provided by kas are: - clone and checkout bitbake layers - create default bitbake settings (machine, arch, ...) - launch minimal build environment, reducing risk of host contamination - initiate bitbake build process So, let's create a minimal example in this layer to build an image with a small effort. This seems interesting for new users of the meta-raspberrypi. For example: $: sudo pip3 install kas $: mkdir rpi $: cd rpi $: git clone https://github.com/agherzan/meta-raspberrypi.git $: kas build meta-raspberrypi/kas-poky-rpi.yml and that's all ! To adjust the construction with specific options (I2C, SPI, ...), simply add a section as follows: local_conf_header: rpi-specific: | ENABLE_I2C = "1" RPI_EXTRA_CONFIG = "dtoverlay=pi3-disable-bt" To configure the machine, the user have to update the 'machine' variable. And the same for the 'distro'. [1] - https://kas.readthedocs.io/en/1.0/userguide.html Signed-off-by: Pierre-Jean Texier <pjtexier@koncepto.io>
80 lines
2.7 KiB
Markdown
80 lines
2.7 KiB
Markdown
# meta-raspberrypi
|
|
|
|
Yocto BSP layer for the Raspberry Pi boards - <http://www.raspberrypi.org/>.
|
|
|
|
[](https://yocto-ci.resin.io/job/meta-raspberrypi1)
|
|
[](https://yocto-ci.resin.io/job/meta-raspberrypi2)
|
|
[](https://yocto-ci.resin.io/job/meta-raspberrypi3)
|
|
[](https://meta-raspberrypi.readthedocs.io/en/latest/?badge=latest)
|
|
[](https://matrix.to/#/#meta-raspberrypi:cub.icu)
|
|
|
|
## Quick links
|
|
|
|
* Git repository web frontend:
|
|
<https://github.com/agherzan/meta-raspberrypi>
|
|
* Mailing list (yocto mailing list): <yocto@yoctoproject.org>
|
|
* Issues management (Github Issues):
|
|
<https://github.com/agherzan/meta-raspberrypi/issues>
|
|
* Documentation: <http://meta-raspberrypi.readthedocs.io/en/latest/>
|
|
|
|
## Description
|
|
|
|
This is the general hardware specific BSP overlay for the RaspberryPi device.
|
|
|
|
More information can be found at: <http://www.raspberrypi.org/> (Official Site)
|
|
|
|
The core BSP part of meta-raspberrypi should work with different
|
|
OpenEmbedded/Yocto distributions and layer stacks, such as:
|
|
|
|
* Distro-less (only with OE-Core).
|
|
* Angstrom.
|
|
* Yocto/Poky (main focus of testing).
|
|
|
|
## Dependencies
|
|
|
|
This layer depends on:
|
|
|
|
* URI: git://git.yoctoproject.org/poky
|
|
* branch: master
|
|
* revision: HEAD
|
|
|
|
* URI: git://git.openembedded.org/meta-openembedded
|
|
* layers: meta-oe, meta-multimedia, meta-networking, meta-python
|
|
* branch: master
|
|
* revision: HEAD
|
|
|
|
## Quick Start
|
|
|
|
1. source poky/oe-init-build-env rpi-build
|
|
2. Add this layer to bblayers.conf and the dependencies above
|
|
3. Set MACHINE in local.conf to one of the supported boards
|
|
4. bitbake core-image-base
|
|
5. dd to a SD card the generated sdimg file (use xzcat if rpi-sdimg.xz is used)
|
|
6. Boot your RPI.
|
|
|
|
## Quick Start with kas
|
|
|
|
1. Install kas build tool from PyPi (sudo pip3 install kas)
|
|
2. kas build meta-raspberrypi/kas-poky-rpi.yml
|
|
3. dd to a SD card the generated sdimg file (use xzcat if rpi-sdimg.xz is used)
|
|
4. Boot your RPI.
|
|
|
|
To adjust the build configuration with specific options (I2C, SPI, ...), simply add
|
|
a section as follows:
|
|
|
|
```
|
|
local_conf_header:
|
|
rpi-specific: |
|
|
ENABLE_I2C = "1"
|
|
RPI_EXTRA_CONFIG = "dtoverlay=pi3-disable-bt"
|
|
```
|
|
|
|
To configure the machine, you have to update the `machine` variable.
|
|
And the same for the `distro`.
|
|
|
|
For further information, you can read more at <https://kas.readthedocs.io/en/1.0/index.html>
|
|
|
|
## Maintainers
|
|
|
|
* Andrei Gherzan `<andrei at gherzan.ro>`
|