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/software-overview/layers/?searchTerm=meta-raspberrypi).
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. kas build meta-raspberrypi/kas-poky-rpi.yml
743. Use bmaptool to copy the generated .wic.bz2 file to the SD card
754. Boot your RPI
76
77To adjust the build configuration with specific options (I2C, SPI, ...), simply add
78a section as follows:
79
80```
81local_conf_header:
82  rpi-specific: |
83    ENABLE_I2C = "1"
84    RPI_EXTRA_CONFIG = "dtoverlay=pi3-disable-bt"
85```
86
87To configure the machine, you have to update the `machine` variable.
88And the same for the `distro`.
89
90For further information, you can read more at <https://kas.readthedocs.io/en/latest/index.html>
91
92## Contributing
93
94You can send patches using the GitHub pull request process or/and through the
95Yocto mailing list. Refer to the
96[documentation](https://meta-raspberrypi.readthedocs.io/en/latest/contributing.html)
97for more information.
98
99## Maintainers
100
101* Andrei Gherzan `<andrei at gherzan.com>`
102