From 1ba3cd7c884dc6c3d78c6bedc15e081f5000c8c9 Mon Sep 17 00:00:00 2001 From: Antonin Godard Date: Wed, 12 Aug 2026 08:33:21 +0200 Subject: [PATCH] ref-manual/variables.rst: document the QB_DEFAULT_BIOS variable The QB_DEFAULT_BIOS allows setting the -bios parameter of QEMU, which can be used to emulate U-Boot, for example. (From yocto-docs rev: dc9a5aa19ca2a0b5ad866f0329b8a030542ca0c6) Signed-off-by: Antonin Godard (cherry picked from commit f2eef5268aa94b31e986e4eef4ce1fe0094b70c4) Signed-off-by: Antonin Godard Signed-off-by: Paul Barker --- documentation/ref-manual/variables.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 61ffb479a1..e00bab1e02 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -7380,6 +7380,25 @@ system and gives an overview of their function and contents. replaces the ``@CLIENT@`` and ``@GATEWAY@`` place holders by the IP and the gateway address of the QEMU guest. + :term:`QB_DEFAULT_BIOS` + The :term:`QB_DEFAULT_BIOS` variable can be used to provide a default + value for the path of a file located in :term:`DEPLOY_DIR_IMAGE` and + used by ``runqemu`` to specify the `-bios `__ + option of QEMU. For example, this variable can be set as follows to + emulate U-Boot for the :oecore_path:`qemuarm64 ` + machine:: + + QB_DEFAULT_BIOS = "u-boot.bin" + + The above example makes the assumption the U-Boot recipe was built + and that the ``u-boot.bin`` is deployed in the :term:`DEPLOY_DIR_IMAGE` + directory. + + .. note:: + + When using ``runqemu``, the ``BIOS`` environment variable takes + precedence over this variable. + :term:`QB_DEFAULT_FSTYPE` The :term:`QB_DEFAULT_FSTYPE` variable controls the default filesystem