diff options
author | Jörg Sommer <joerg.sommer@navimatix.de> | 2023-09-26 15:00:29 +0200 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2024-01-12 11:34:06 +0000 |
commit | b0f2fd0fade52ced1d249f17457da436f7cc58f6 (patch) | |
tree | c4cab71a4a32018f4243c64b207fdfb2de111e94 /documentation/ref-manual | |
parent | ed6c38e3aff120a2caf817bb9fe4324979278edc (diff) | |
download | poky-b0f2fd0fade52ced1d249f17457da436f7cc58f6.tar.gz |
documentation: Add UBOOT_BINARY, extend UBOOT_CONFIG
UBOOT_CONFIG accepts a third parameter for the UBOOT_BINARY that isn't
documented. To show its usage another example from the meta-freescale layer
was picked.
(From yocto-docs rev: 8b227582efbe9957026cdce4aef5621661af1fa5)
Signed-off-by: Jörg Sommer <joerg.sommer@navimatix.de>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r-- | documentation/ref-manual/classes.rst | 2 | ||||
-rw-r--r-- | documentation/ref-manual/variables.rst | 39 |
2 files changed, 24 insertions, 17 deletions
diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 26d0e55cb4..844433c551 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst | |||
@@ -3229,7 +3229,7 @@ The :ref:`ref-classes-uboot-config` class provides support for U-Boot configurat | |||
3229 | a machine. Specify the machine in your recipe as follows:: | 3229 | a machine. Specify the machine in your recipe as follows:: |
3230 | 3230 | ||
3231 | UBOOT_CONFIG ??= <default> | 3231 | UBOOT_CONFIG ??= <default> |
3232 | UBOOT_CONFIG[foo] = "config,images" | 3232 | UBOOT_CONFIG[foo] = "config,images,binary" |
3233 | 3233 | ||
3234 | You can also specify the machine using this method:: | 3234 | You can also specify the machine using this method:: |
3235 | 3235 | ||
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index b394d31099..6f7d6ff01e 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -9383,23 +9383,30 @@ system and gives an overview of their function and contents. | |||
9383 | See the machine include files in the :term:`Source Directory` | 9383 | See the machine include files in the :term:`Source Directory` |
9384 | for these features. | 9384 | for these features. |
9385 | 9385 | ||
9386 | :term:`UBOOT_BINARY` | ||
9387 | Specifies the name of the binary build by U-Boot. | ||
9388 | |||
9386 | :term:`UBOOT_CONFIG` | 9389 | :term:`UBOOT_CONFIG` |
9387 | Configures the :term:`UBOOT_MACHINE` and can | 9390 | Configures one or more U-Boot configurations to build. Each |
9388 | also define :term:`IMAGE_FSTYPES` for individual | 9391 | configuration can define the :term:`UBOOT_MACHINE` and optionally the |
9389 | cases. | 9392 | :term:`IMAGE_FSTYPES` and the :term:`UBOOT_BINARY`. |
9390 | 9393 | ||
9391 | Following is an example from the ``meta-fsl-arm`` layer. :: | 9394 | Following is an example from the ``meta-freescale`` layer. :: |
9392 | 9395 | ||
9393 | UBOOT_CONFIG ??= "sd" | 9396 | UBOOT_CONFIG ??= "sdcard-ifc-secure-boot sdcard-ifc sdcard-qspi lpuart qspi secure-boot nor" |
9394 | UBOOT_CONFIG[sd] = "mx6qsabreauto_config,sdcard" | 9397 | UBOOT_CONFIG[nor] = "ls1021atwr_nor_defconfig" |
9395 | UBOOT_CONFIG[eimnor] = "mx6qsabreauto_eimnor_config" | 9398 | UBOOT_CONFIG[sdcard-ifc] = "ls1021atwr_sdcard_ifc_defconfig,,u-boot-with-spl-pbl.bin" |
9396 | UBOOT_CONFIG[nand] = "mx6qsabreauto_nand_config,ubifs" | 9399 | UBOOT_CONFIG[sdcard-qspi] = "ls1021atwr_sdcard_qspi_defconfig,,u-boot-with-spl-pbl.bin" |
9397 | UBOOT_CONFIG[spinor] = "mx6qsabreauto_spinor_config" | 9400 | UBOOT_CONFIG[lpuart] = "ls1021atwr_nor_lpuart_defconfig" |
9398 | 9401 | UBOOT_CONFIG[qspi] = "ls1021atwr_qspi_defconfig" | |
9399 | In this example, "sd" is selected as the configuration of the possible four for the | 9402 | UBOOT_CONFIG[secure-boot] = "ls1021atwr_nor_SECURE_BOOT_defconfig" |
9400 | :term:`UBOOT_MACHINE`. The "sd" configuration defines | 9403 | UBOOT_CONFIG[sdcard-ifc-secure-boot] = "ls1021atwr_sdcard_ifc_SECURE_BOOT_defconfig,,u-boot-with-spl-pbl.bin" |
9401 | "mx6qsabreauto_config" as the value for :term:`UBOOT_MACHINE`, while the | 9404 | |
9402 | "sdcard" specifies the :term:`IMAGE_FSTYPES` to use for the U-Boot image. | 9405 | In this example, all possible seven configurations are selected. Each |
9406 | configuration specifies "..._defconfig" as :term:`UBOOT_MACHINE`, and | ||
9407 | the "sd..." configurations define an individual name for | ||
9408 | :term:`UBOOT_BINARY`. No configuration defines a second parameter for | ||
9409 | :term:`IMAGE_FSTYPES` to use for the U-Boot image. | ||
9403 | 9410 | ||
9404 | For more information on how the :term:`UBOOT_CONFIG` is handled, see the | 9411 | For more information on how the :term:`UBOOT_CONFIG` is handled, see the |
9405 | :ref:`ref-classes-uboot-config` class. | 9412 | :ref:`ref-classes-uboot-config` class. |