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|                           |                                        |
9|:-:                        | :-:                                    |
10| Build server sponsored by | [balena.io](https://www.balena.io/) |
11
12## Quick links
13
14* Git repository web frontend:
15  <https://github.com/agherzan/meta-raspberrypi>
16* Mailing list (yocto mailing list): <yocto@lists.yoctoproject.org>
17* Issues management (Github Issues):
18  <https://github.com/agherzan/meta-raspberrypi/issues>
19* Documentation: <http://meta-raspberrypi.readthedocs.io/en/latest/>
20
21## Description
22
23This is the general hardware specific BSP overlay for the RaspberryPi device.
24
25More information can be found at: <http://www.raspberrypi.org/> (Official Site)
26
27The core BSP part of meta-raspberrypi should work with different
28OpenEmbedded/Yocto distributions and layer stacks, such as:
29
30* Distro-less (only with OE-Core).
31* Yoe Disto (Video and Camera Products).
32* Yocto/Poky (main focus of testing).
33
34## Dependencies
35
36This layer depends on:
37
38* URI: git://git.yoctoproject.org/poky
39  * branch: master
40  * revision: HEAD
41
42## Quick Start
43
441. source poky/oe-init-build-env rpi-build
452. Add this layer to bblayers.conf and the dependencies above
463. Set MACHINE in local.conf to one of the supported boards
474. bitbake core-image-base
485. Use bmaptool to copy the generated .wic.bz2 file to the SD card
496. Boot your RPI
50
51## Quick Start with kas
52
531. Install kas build tool from PyPi (sudo pip3 install kas)
542. kas build meta-raspberrypi/kas-poky-rpi.yml
553. Use bmaptool to copy the generated .wic.bz2 file to the SD card
564. Boot your RPI
57
58To adjust the build configuration with specific options (I2C, SPI, ...), simply add
59a section as follows:
60
61```
62local_conf_header:
63  rpi-specific: |
64    ENABLE_I2C = "1"
65    RPI_EXTRA_CONFIG = "dtoverlay=pi3-disable-bt"
66```
67
68To configure the machine, you have to update the `machine` variable.
69And the same for the `distro`.
70
71For further information, you can read more at <https://kas.readthedocs.io/en/latest/index.html>
72
73## Contributing
74
75You can send patches using the GitHub pull request process or/and through the
76Yocto mailing list. Refer to the
77[documentation](https://meta-raspberrypi.readthedocs.io/en/latest/contributing.html)
78for more information.
79
80## Maintainers
81
82* Andrei Gherzan `<andrei at gherzan.com>`
83