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