v2024.08.0 was the first release included in OpenEmbedded core, so add migration guides for later releases to aid users in updating.
November 2024 didn't have a release, so that's why only seven migration guides are added. Signed-off-by: Ahmad Fatoum <[email protected]> --- .../migration-guides/migration-2024.09.0.rst | 8 +++++ .../migration-guides/migration-2024.10.0.rst | 15 +++++++++ .../migration-guides/migration-2024.12.0.rst | 26 ++++++++++++++++ .../migration-guides/migration-2025.01.0.rst | 31 +++++++++++++++++++ .../migration-guides/migration-2025.02.0.rst | 21 +++++++++++++ .../migration-guides/migration-2025.03.0.rst | 25 +++++++++++++++ .../migration-guides/migration-2025.04.0.rst | 12 +++++++ 7 files changed, 138 insertions(+) create mode 100644 Documentation/migration-guides/migration-2024.09.0.rst create mode 100644 Documentation/migration-guides/migration-2024.10.0.rst create mode 100644 Documentation/migration-guides/migration-2024.12.0.rst create mode 100644 Documentation/migration-guides/migration-2025.01.0.rst create mode 100644 Documentation/migration-guides/migration-2025.02.0.rst create mode 100644 Documentation/migration-guides/migration-2025.03.0.rst create mode 100644 Documentation/migration-guides/migration-2025.04.0.rst diff --git a/Documentation/migration-guides/migration-2024.09.0.rst b/Documentation/migration-guides/migration-2024.09.0.rst new file mode 100644 index 000000000000..3cd4a6b053a2 --- /dev/null +++ b/Documentation/migration-guides/migration-2024.09.0.rst @@ -0,0 +1,8 @@ +Release v2024.09.0 +================== + +Board support +------------- + +The board code of the TQMA8MPXL SoM is now applied to all boards using the SoM +and not only to the official TQ baseboards. diff --git a/Documentation/migration-guides/migration-2024.10.0.rst b/Documentation/migration-guides/migration-2024.10.0.rst new file mode 100644 index 000000000000..de652819dec0 --- /dev/null +++ b/Documentation/migration-guides/migration-2024.10.0.rst @@ -0,0 +1,15 @@ +Release v2024.10.0 +================== + +Fastboot +-------- + +* ``fastboot getvar all`` is now the only way to list fastboot variables. + The unintended shortcuts (``"al"``, ``"a"`` and ``""``) are now an error. + +* ``fastboot getvar`` no longer aborts the boot countdown as the ``fwupd`` + fastboot plugin was found to probe some variables automatically, + inadvertently halting device boot. + Other calls like ``fastboot oem`` or ``fastboot flash`` continue to abort + the countdown as before. + diff --git a/Documentation/migration-guides/migration-2024.12.0.rst b/Documentation/migration-guides/migration-2024.12.0.rst new file mode 100644 index 000000000000..9aff9fd88cc1 --- /dev/null +++ b/Documentation/migration-guides/migration-2024.12.0.rst @@ -0,0 +1,26 @@ +Release v2024.12.0 +================== + +spi-gpio DT bindings +-------------------- + +Support for the old deprecated device tree binding has been removed. +If spi-gpio binding is to be used in barebox, the new binding +(e.g. ``sck-gpios`` instead of ``gpio-sck``) must be used. + +Configuration options +--------------------- + +* ``CONFIG_CRYPTO_RSA_KEY`` has been renamed to ``CONFIG_CRYPTO_PUBLIC_KEYS`` + to reflect that it now accepts multiple entries and is no longer limited + to RSA with the addition of ECDSA support. + +* ``CONFIG_CRYPTO_RSA_KEY_NAME_HINT`` has been removed. To specify a hint, add it + in front of the key into ``CRYPTO_PUBLIC_KEYS``, e.g. ``hint1:file1 hint2:file2``. + +LZ4 compression +--------------- + +barebox now expects ``lz4`` to be available instead of ``lz4c`` if +the barebox proper binary is configured to be LZ4-compressed. +Customizing the name is possible via the ``LZ4`` environment variable. diff --git a/Documentation/migration-guides/migration-2025.01.0.rst b/Documentation/migration-guides/migration-2025.01.0.rst new file mode 100644 index 000000000000..d1ff7da9787c --- /dev/null +++ b/Documentation/migration-guides/migration-2025.01.0.rst @@ -0,0 +1,31 @@ +Release v2025.01.0 +================== + +Layerscape +---------- + +Support for the NXP-specific PPA Secure Monitor has been removed in +favor of ARM Trusted Firmware-A as the former has been long unmaintained. + +I2C Adapter numbering +--------------------- + +``i2c0`` to ``i2c31`` are now reserved for I2C adapters with device tree +aliases. Do not rely on a fixed numbering for other non-aliased adapters. + +OP-TEE for Rockchip +------------------- + +The BL32 firmware images are now called ``firmware/rk3XXX-bl32.bin`` +instead of ``firmware/rk3XXX-op-tee.bin``. Raw OP-TEE binaries without +a header now use the load address the vendor blobs are hardcoded to +run at instead of the previous ``0x200000``. To override, use an OP-TEE +image with a header specifying the correct load address. + +TFTP +---- + +The default TFTP window size has been reverted to 1 as many network +drivers couldn't cope with the increased throughput. +This can be reverted by setting ``CONFIG_FS_TFTP_MAX_WINDOW_SIZE`` +or at runtime via the ``global.tftp.windowsize`` variable. diff --git a/Documentation/migration-guides/migration-2025.02.0.rst b/Documentation/migration-guides/migration-2025.02.0.rst new file mode 100644 index 000000000000..c585d2e96341 --- /dev/null +++ b/Documentation/migration-guides/migration-2025.02.0.rst @@ -0,0 +1,21 @@ +Release v2025.02.0 +================== + +Environment Auto-Probe +---------------------- + +A new magic variable ``global.env.autoprobe`` now controls whether barebox +will automatically probe known block devices for a GPT barebox environment +partition if no environment was specified by other means. + +The variable defaults to ``0`` (false) if ``CONFIG_INSECURE`` is disabled. + +The most secure option remains disabling ``CONFIG_ENV_HANDLING`` completely +or, starting with v2025.10.0, using the security policy support for runtime +access control. + +Zynq 7000 +--------- + +The MMC controller numbering is now fixed: ``mmc0`` & ``mmc1`` for +``&sdhci0`` and ``&sdhci1`` respectively. diff --git a/Documentation/migration-guides/migration-2025.03.0.rst b/Documentation/migration-guides/migration-2025.03.0.rst new file mode 100644 index 000000000000..4f2a25eb3d40 --- /dev/null +++ b/Documentation/migration-guides/migration-2025.03.0.rst @@ -0,0 +1,25 @@ +Release v2025.03.0 +================== + +OMAP console fixup +------------------ + +The option ``CONFIG_DRIVER_SERIAL_NS16550_OMAP_TTYS`` now controls whether +barebox fixes up ``ttyS`` or ``ttyO`` into the kernel command line +``console=`` option. + +fixed-partitions on SD/MMC +-------------------------- + +Linux v6.13-rc1 added ``CONFIG_OF_PARTITION``, which interprets +``fixed partitions`` nodes in SD/MMC nods differently to the barebox +behavior: It ignores the GPT/MBR if fixed-partitions are specified, +instead of allowing them to co-exist like in barebox. + +To accommodate both the existing barebox and the new kernel functionality, +users should replace ``fixed-partitions``-compatible device tree subnodes +of SD/eMMC with ``barebox,fixed-partitions``. + +Similarly, the default for ``global.of_partition_binding`` has been changed +to the new ``adaptive`` option, which fixes up ``barebox,fixed-partitions`` +except for MTD. diff --git a/Documentation/migration-guides/migration-2025.04.0.rst b/Documentation/migration-guides/migration-2025.04.0.rst new file mode 100644 index 000000000000..de7efdf47fe6 --- /dev/null +++ b/Documentation/migration-guides/migration-2025.04.0.rst @@ -0,0 +1,12 @@ +Release v2025.04.0 +================== + +Boot overrides +-------------- + +It's no longer possible to override ``global.bootm.image`` with +the new ``boot -o`` syntax. This override led to issues when +substituting wildly different boot image formats. + +This feature will likely be added back in future in a more +conservative form. -- 2.47.3
