diff mbox series

[meta-raspberrypi,4/4] docs: Add multiconfig documentation

Message ID 20220907213959.1115886-4-andrei@gherzan.com
State New
Headers show
Series [meta-raspberrypi,1/4] machine: Define firmware packages from separate variables | expand

Commit Message

Andrei Gherzan Sept. 7, 2022, 9:39 p.m. UTC
From: Andrei Gherzan <andrei.gherzan@huawei.com>

Signed-off-by: Andrei Gherzan <andrei.gherzan@huawei.com>
 docs/index.rst      |  1 +
 docs/multiconfig.md | 40 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+)
 create mode 100644 docs/multiconfig.md
diff mbox series


diff --git a/docs/index.rst b/docs/index.rst
index 3f8a088..806ce87 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -14,6 +14,7 @@  Contents:
+   multiconfig
diff --git a/docs/multiconfig.md b/docs/multiconfig.md
new file mode 100644
index 0000000..fecbfce
--- /dev/null
+++ b/docs/multiconfig.md
@@ -0,0 +1,40 @@ 
+SPDX-FileCopyrightText: Andrei Gherzan <andrei.gherzan@huawei.com>
+SPDX-License-Identifier: CC-BY-4.0
+# Multiconfig Support
+The build system provides functionality for building multiple configurations in
+the same build invocation while also supporting dependencies between them. For
+more info check the
+[official documentation](https://docs.yoctoproject.org/dev-manual/common-tasks.html#building-images-for-multiple-targets-using-multiple-configurations).
+`meta-raspberrypi` uses this to provide the ability to generate images that can
+boot on multiple targets (for example, being able to boot either a Raspberry Pi
+3 or a Raspberry Pi 4 in 32bit mode using the same image). This is in contrast
+to the classic builds where the `MACHINE` defines the only target intended for
+the final image artefact.
+## Generating an Image For Multiple Raspberry Pi Boards
+Once you've set up a build environment, the multiconfigs need to be enabled
+adding to the build's `local.conf` the following:
+    BBMULTICONFIG += "raspberrypi raspberrypi3"
+With that configured, any image can now be build using the `raspberrypi`
+multiconfig.  Here is an example that will build the `core-image-base`:
+    bitbake mc:raspberrypi:core-image-base
+The final image will be available in:
+    <BUILDDIR>/tmp-multi-raspberrypi/deploy/images/raspberrypi4/
+This image will boot and provide the support for all the machines listed below.
+## Supported Machines for Multiconfig Builds
+* raspberrypi3
+* raspberrypi4