diff options
author | Jörg Sommer <joerg.sommer@navimatix.de> | 2023-09-26 15:00:29 +0200 |
---|---|---|
committer | Steve Sakoman <steve@sakoman.com> | 2024-01-24 04:04:56 -1000 |
commit | f634b9852e22b359fa8ffd4fceb0881e5da9f666 (patch) | |
tree | b5bb7c3f941ff000004095ae2ec8258bbcbfa233 | |
parent | 78e79d47c2e08a15b7833bc50ceb47f4854e8efe (diff) | |
download | poky-f634b9852e22b359fa8ffd4fceb0881e5da9f666.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: aba67b58711019a6ba439b2b77337f813ed799ac)
Signed-off-by: Jörg Sommer <joerg.sommer@navimatix.de>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
-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 0677157b3b..216b236e33 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst | |||
@@ -3131,7 +3131,7 @@ The :ref:`ref-classes-uboot-config` class provides support for U-Boot configurat | |||
3131 | a machine. Specify the machine in your recipe as follows:: | 3131 | a machine. Specify the machine in your recipe as follows:: |
3132 | 3132 | ||
3133 | UBOOT_CONFIG ??= <default> | 3133 | UBOOT_CONFIG ??= <default> |
3134 | UBOOT_CONFIG[foo] = "config,images" | 3134 | UBOOT_CONFIG[foo] = "config,images,binary" |
3135 | 3135 | ||
3136 | You can also specify the machine using this method:: | 3136 | You can also specify the machine using this method:: |
3137 | 3137 | ||
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index fe0b993bd8..ae14c450dd 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -8932,23 +8932,30 @@ system and gives an overview of their function and contents. | |||
8932 | See the machine include files in the :term:`Source Directory` | 8932 | See the machine include files in the :term:`Source Directory` |
8933 | for these features. | 8933 | for these features. |
8934 | 8934 | ||
8935 | :term:`UBOOT_BINARY` | ||
8936 | Specifies the name of the binary build by U-Boot. | ||
8937 | |||
8935 | :term:`UBOOT_CONFIG` | 8938 | :term:`UBOOT_CONFIG` |
8936 | Configures the :term:`UBOOT_MACHINE` and can | 8939 | Configures one or more U-Boot configurations to build. Each |
8937 | also define :term:`IMAGE_FSTYPES` for individual | 8940 | configuration can define the :term:`UBOOT_MACHINE` and optionally the |
8938 | cases. | 8941 | :term:`IMAGE_FSTYPES` and the :term:`UBOOT_BINARY`. |
8939 | 8942 | ||
8940 | Following is an example from the ``meta-fsl-arm`` layer. :: | 8943 | Following is an example from the ``meta-freescale`` layer. :: |
8941 | 8944 | ||
8942 | UBOOT_CONFIG ??= "sd" | 8945 | UBOOT_CONFIG ??= "sdcard-ifc-secure-boot sdcard-ifc sdcard-qspi lpuart qspi secure-boot nor" |
8943 | UBOOT_CONFIG[sd] = "mx6qsabreauto_config,sdcard" | 8946 | UBOOT_CONFIG[nor] = "ls1021atwr_nor_defconfig" |
8944 | UBOOT_CONFIG[eimnor] = "mx6qsabreauto_eimnor_config" | 8947 | UBOOT_CONFIG[sdcard-ifc] = "ls1021atwr_sdcard_ifc_defconfig,,u-boot-with-spl-pbl.bin" |
8945 | UBOOT_CONFIG[nand] = "mx6qsabreauto_nand_config,ubifs" | 8948 | UBOOT_CONFIG[sdcard-qspi] = "ls1021atwr_sdcard_qspi_defconfig,,u-boot-with-spl-pbl.bin" |
8946 | UBOOT_CONFIG[spinor] = "mx6qsabreauto_spinor_config" | 8949 | UBOOT_CONFIG[lpuart] = "ls1021atwr_nor_lpuart_defconfig" |
8947 | 8950 | UBOOT_CONFIG[qspi] = "ls1021atwr_qspi_defconfig" | |
8948 | In this example, "sd" is selected as the configuration of the possible four for the | 8951 | UBOOT_CONFIG[secure-boot] = "ls1021atwr_nor_SECURE_BOOT_defconfig" |
8949 | :term:`UBOOT_MACHINE`. The "sd" configuration defines | 8952 | UBOOT_CONFIG[sdcard-ifc-secure-boot] = "ls1021atwr_sdcard_ifc_SECURE_BOOT_defconfig,,u-boot-with-spl-pbl.bin" |
8950 | "mx6qsabreauto_config" as the value for :term:`UBOOT_MACHINE`, while the | 8953 | |
8951 | "sdcard" specifies the :term:`IMAGE_FSTYPES` to use for the U-Boot image. | 8954 | In this example, all possible seven configurations are selected. Each |
8955 | configuration specifies "..._defconfig" as :term:`UBOOT_MACHINE`, and | ||
8956 | the "sd..." configurations define an individual name for | ||
8957 | :term:`UBOOT_BINARY`. No configuration defines a second parameter for | ||
8958 | :term:`IMAGE_FSTYPES` to use for the U-Boot image. | ||
8952 | 8959 | ||
8953 | For more information on how the :term:`UBOOT_CONFIG` is handled, see the | 8960 | For more information on how the :term:`UBOOT_CONFIG` is handled, see the |
8954 | :ref:`uboot-config <ref-classes-uboot-config>` | 8961 | :ref:`uboot-config <ref-classes-uboot-config>` |