[PATCH v2 1/2] ref-manual/variables.rst: document UBOOT_INITIAL_ENV_BINARY variables

[PATCH v2 1/2] ref-manual/variables.rst: document UBOOT_INITIAL_ENV_BINARY variables

[pierre-loup.gosse]

From: Pierre-Loup GOSSE <pierre-loup.gosse@smile.fr>

Added by commit cf11b14a4cfc ("u-boot: make initial environment binary
image") in OE-Core.

Signed-off-by: Pierre-Loup GOSSE <pierre-loup.gosse@smile.fr>
Cc: Antonin Godard <antonin.godard@bootlin.com>
---
Changes in v2:
- Rephrase UBOOT_INITIAL_ENV_BINARY
- Add link to WIC doc
- Rephrase UBOOT_INITIAL_ENV_BINARY_REDUND
- Remove empty line
---
 documentation/ref-manual/variables.rst | 46 ++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index ee776c110..b5d072983 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -10974,6 +10974,52 @@ system and gives an overview of their function and contents.
 
       See the :ref:`ref-classes-uboot-sign` class for details.
 
+   :term:`UBOOT_INITIAL_ENV_BINARY`
+      This variable enables the generation of the U-Boot initial environment in
+      binary format.
+
+      Its default value is "0", set it to "1" to enable this functionality::
+
+         UBOOT_INITIAL_ENV_BINARY = "1"
+
+      If set to "1", you must also set the size of the environment with
+      :term:`UBOOT_INITIAL_ENV_BINARY_SIZE`.
+
+      This variable is used in the :ref:`ref-classes-uboot-config` class.
+
+      The resulting binary can be flashed using :doc:`WIC </dev-manual/wic>` or
+      any other flashing method at the environment offset, overriding any
+      existing environment if one is present. Below is an example of a WKS file
+      to flash the binary::
+
+         part --source rawcopy --sourceparams="file=u-boot-initial-env-sd.bin" --ondisk sda --no-table --offset 4096k
+
+      In this example, the U-Boot initial environment binary
+      `u-boot-initial-env-sd.bin` is flashed at offset 4096 kibibyte.
+
+   :term:`UBOOT_INITIAL_ENV_BINARY_REDUND`
+      If redundant environment support is enabled in U-boot's configuration,
+      this variable should to properly generate the redundant environment in the
+      output U-boot environment binary file.
+
+      Its default value is "0", set it to "1" to enable this functionality::
+
+         UBOOT_INITIAL_ENV_BINARY_REDUND = "1"
+
+      The :term:`UBOOT_INITIAL_ENV_BINARY` must also be set to "1" if
+      :term:`UBOOT_INITIAL_ENV_BINARY_REDUND` is enabled.
+
+      This variable is used in the :ref:`ref-classes-uboot-config` class.
+
+   :term:`UBOOT_INITIAL_ENV_BINARY_SIZE`
+      This variable sets the binary size (in bytes) of the U-Boot initial
+      environment. Both hexadecimal and decimal values are supported and can be
+      set as follows::
+
+         UBOOT_INITIAL_ENV_BINARY_SIZE = "0x4000"
+
+      This variable is used in the :ref:`ref-classes-uboot-config` class.
+
    :term:`UBOOT_LOADADDRESS`
       Specifies the load address for the U-Boot image. During U-Boot image
       creation, the :term:`UBOOT_LOADADDRESS` variable is passed as a
-- 
2.34.1

[PATCH v2 2/2] migration-guides/release-notes-6.0.rst: add U-Boot initial env binary

[pierre-loup.gosse]

From: Pierre-Loup GOSSE <pierre-loup.gosse@smile.fr>

Added by commit cf11b14a4cfc ("u-boot: make initial environment binary
image") in OE-Core.

Signed-off-by: Pierre-Loup GOSSE <pierre-loup.gosse@smile.fr>
Cc: Antonin Godard <antonin.godard@bootlin.com>
---
No changes in v2
---
 documentation/migration-guides/release-notes-6.0.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/documentation/migration-guides/release-notes-6.0.rst b/documentation/migration-guides/release-notes-6.0.rst
index cfc51fc3a..13ce28b3b 100644
--- a/documentation/migration-guides/release-notes-6.0.rst
+++ b/documentation/migration-guides/release-notes-6.0.rst
@@ -71,6 +71,12 @@ New Features / Enhancements in |yocto-ver|
 
 -  :ref:`ref-classes-sanity` class changes:
 
+-  U-boot related changes:
+
+   -  :ref:`ref-classes-uboot-config`: Add support for generating the U-Boot
+      initial environment in binary format using
+      :term:`UBOOT_INITIAL_ENV_BINARY`.
+
 -  Miscellaneous changes:
 
 Known Issues in |yocto-ver|
-- 
2.34.1

Re: [docs] [PATCH v2 1/2] ref-manual/variables.rst: document UBOOT_INITIAL_ENV_BINARY variables

[Antonin Godard]

On Fri Jan 9, 2026 at 10:33 AM CET, Pierre-loup GOSSE via lists.yoctoproject.org wrote:
> From: Pierre-Loup GOSSE <pierre-loup.gosse@smile.fr>
>
> Added by commit cf11b14a4cfc ("u-boot: make initial environment binary
> image") in OE-Core.
>
> Signed-off-by: Pierre-Loup GOSSE <pierre-loup.gosse@smile.fr>
> Cc: Antonin Godard <antonin.godard@bootlin.com>
> ---
> Changes in v2:
> - Rephrase UBOOT_INITIAL_ENV_BINARY
> - Add link to WIC doc
> - Rephrase UBOOT_INITIAL_ENV_BINARY_REDUND
> - Remove empty line
> ---
>  documentation/ref-manual/variables.rst | 46 ++++++++++++++++++++++++++
>  1 file changed, 46 insertions(+)
>
> diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
> index ee776c110..b5d072983 100644
> --- a/documentation/ref-manual/variables.rst
> +++ b/documentation/ref-manual/variables.rst
> @@ -10974,6 +10974,52 @@ system and gives an overview of their function and contents.
>  
>        See the :ref:`ref-classes-uboot-sign` class for details.
>  
> +   :term:`UBOOT_INITIAL_ENV_BINARY`
> +      This variable enables the generation of the U-Boot initial environment in
> +      binary format.
> +
> +      Its default value is "0", set it to "1" to enable this functionality::
> +
> +         UBOOT_INITIAL_ENV_BINARY = "1"
> +
> +      If set to "1", you must also set the size of the environment with
> +      :term:`UBOOT_INITIAL_ENV_BINARY_SIZE`.
> +
> +      This variable is used in the :ref:`ref-classes-uboot-config` class.
> +
> +      The resulting binary can be flashed using :doc:`WIC </dev-manual/wic>` or
> +      any other flashing method at the environment offset, overriding any
> +      existing environment if one is present. Below is an example of a WKS file
> +      to flash the binary::
> +
> +         part --source rawcopy --sourceparams="file=u-boot-initial-env-sd.bin" --ondisk sda --no-table --offset 4096k
> +
> +      In this example, the U-Boot initial environment binary
> +      `u-boot-initial-env-sd.bin` is flashed at offset 4096 kibibyte.
> +
> +   :term:`UBOOT_INITIAL_ENV_BINARY_REDUND`
> +      If redundant environment support is enabled in U-boot's configuration,
> +      this variable should to properly generate the redundant environment in the

Oops, missing "be set" after "should". I'll add it when merging, as the rest if
fine to me.

A nitpick on the second patch I'll mention here: since I've given you my
Reviewed-by in the first version, you can add it as part of the patch, below
your Signed-off-by. So its kept across series.

Thanks!
Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [PATCH v2 1/2] ref-manual/variables.rst: document UBOOT_INITIAL_ENV_BINARY variables

[Antonin Godard]

On Fri, 09 Jan 2026 10:33:04 +0100, pierre-loup.gosse@smile.fr wrote:
> Added by commit cf11b14a4cfc ("u-boot: make initial environment binary
> image") in OE-Core.
> 
> 

Applied, thanks!

[1/2] ref-manual/variables.rst: document UBOOT_INITIAL_ENV_BINARY variables
      commit: 4f7ad2a2279d5551cb3cae59bc315510998a3445
[2/2] migration-guides/release-notes-6.0.rst: add U-Boot initial env binary
      commit: ee21053b9eccb00ee69f828d6f76e81c9af7c726

Best regards,
--