1# meta-raspberrypi
2
3Yocto BSP layer for the Raspberry Pi boards - <http://www.raspberrypi.org/>.
4
5[![Documentation Status](https://readthedocs.org/projects/meta-raspberrypi/badge/?version=latest)](https://meta-raspberrypi.readthedocs.io/en/latest/?badge=latest)
6[![Matrix](https://img.shields.io/badge/chat-meta--raspberrypi-brightgreen)](https://matrix.to/#/#meta-raspberrypi:matrix.org)
7
8<table border="0" rules="none">
9<tr border="0">
10<td width="140" height="100" align="center">
11  <br />
12  <a href="https://www.yoctoproject.org/ecosystem/branding/">
13    <img alt="Yocto Project Layer Compatible" src="img/LF_17_02_Yocto-Badge-Update_Compatible_Final_Blank.png">
14  </a>
15</td>
16<td width="150" height="100" align="center">
17  Sponsored by:<br />
18  <a href="https://balena.io">
19    <img alt="balena.io" src="img/balena.png">
20  </a>
21</td>
22</tr>
23</table>
24
25## Quick links
26
27* Git repository web frontend:
28  <https://github.com/agherzan/meta-raspberrypi>
29* Mailing list (yocto mailing list): <yocto@lists.yoctoproject.org>
30* Issues management (Github Issues):
31  <https://github.com/agherzan/meta-raspberrypi/issues>
32* Documentation: <http://meta-raspberrypi.readthedocs.io/en/latest/>
33
34## Description
35
36This is the general hardware specific BSP overlay for the RaspberryPi device.
37
38More information can be found at: <http://www.raspberrypi.org/> (Official Site)
39
40The core BSP part of meta-raspberrypi should work with different
41OpenEmbedded/Yocto distributions and layer stacks, such as:
42
43* Distro-less (only with OE-Core).
44* Yoe Disto (Video and Camera Products).
45* Yocto/Poky (main focus of testing).
46
47## Yocto Project Compatible Layer
48
49This layer is officially approved as part of the `Yocto Project Compatible
50Layers Program`. You can find details of that on the official Yocto Project
51[website](https://www.yoctoproject.org/development/yocto-project-compatible-layers/).
52
53## Dependencies
54
55This layer depends on:
56
57* URI: git://git.yoctoproject.org/poky
58  * branch: master
59  * revision: HEAD
60
61## Quick Start
62
631. source poky/oe-init-build-env rpi-build
642. Add this layer to bblayers.conf and the dependencies above
653. Set MACHINE in local.conf to one of the supported boards
664. bitbake core-image-base
675. Use bmaptool to copy the generated .wic.bz2 file to the SD card
686. Boot your RPI
69
70## Quick Start with kas
71
721. Install kas build tool from PyPi (sudo pip3 install kas)
732. Set the `machine: ` in kas-poky-rpi.yml to one of the supported boards (see conf/machine/*.conf)
743. kas build meta-raspberrypi/kas-poky-rpi.yml
754. Use bmaptool to copy the generated .wic.bz2 file to the SD card
765. Boot your RPI
77
78To adjust the build configuration with specific options (I2C, SPI, ...), simply add
79a section as follows:
80
81```
82local_conf_header:
83  rpi-specific: |
84    ENABLE_I2C = "1"
85    RPI_EXTRA_CONFIG = "dtoverlay=disable-bt"
86```
87
88To configure the machine, you have to update the `machine` variable.
89And the same for the `distro`.
90
91For further information, you can read more at <https://kas.readthedocs.io/en/latest/index.html>
92
93## Contributing
94
95You can send patches using the GitHub pull request process or/and through the
96Yocto mailing list. Refer to the
97[documentation](https://meta-raspberrypi.readthedocs.io/en/latest/contributing.html)
98for more information.
99
100## Maintainers
101
102* Andrei Gherzan `<andrei at gherzan.com>`
103