1# Layer Contents
2
3## Supported Machines
4
5* raspberrypi
6* raspberrypi0
7* raspberrypi0-wifi
8* raspberrypi0-2w-64
9* raspberrypi2
10* raspberrypi3
11* raspberrypi3-64 (64 bit kernel & userspace)
12* raspberrypi4
13* raspberrypi4-64 (64 bit kernel & userspace)
14* raspberrypi-cm (dummy alias for raspberrypi)
15* raspberrypi-cm3
16
17Note: The raspberrypi3 machines include support for Raspberry Pi 3B+.
18
19## Multi-board Machines
20
21This layer generally provides support for machines that are targetting a single
22Raspberry Pi board (or a very few subsets of them). This is so that the build
23infrastructure can tune and tweak the configuration with the flexibility to
24optimise for both runtime performance and disk storage.
25
26For usecases where compatibility of more boards is required, the layer provides
27machines that are tagetting a wider support of Raspberry Pi boards.
28
29### raspberrypi-armv7
30
31This machine targets support for all the ARMv7-based Raspberry Pi boards. It
32will pull in the firmware and deploy the kernel image and kernel modules for
33all the relevant boards.
34
35### raspberrypi-armv8
36
37This machine targets support for all the ARMv8-based Raspberry Pi boards. It
38will pull in the firmware and deploy the kernel image and kernel modules for
39all the relevant boards.
40
41## Images
42
43* rpi-test-image
44  * Image based on core-image-base which includes most of the packages in this
45    layer and some media samples.
46
47For other uses it's recommended to base images on `core-image-minimal` or
48`core-image-base` as appropriate.
49
50## WiFi and Bluetooth Firmware
51
52Be aware that the WiFi and Bluetooth firmware for the supported boards
53is not available in the base version of `linux-firmware` from OE-Core
54(poky). The files are added from Raspbian repositories in this layer's
55bbappends to that recipe. All machines define
56`MACHINE_EXTRA_RRECOMMENDS` to include the required wireless firmware;
57raspberrypi3 supports 3, 3B, and 3B+ and so include multiple firmware
58packages.
59