[PATCH master 1/4] Documentation: migration-guide: fix TQMA8MPxL section

[PATCH master 1/4] Documentation: migration-guide: fix TQMA8MPxL section

[Ahmad Fatoum]

This was erroneously a .md file, but we expect .rst files.
Rename the file and reformat the entry a bit.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/migration-guides/migration-master.md  | 10 ----------
 Documentation/migration-guides/migration-master.rst | 11 +++++++++++
 2 files changed, 11 insertions(+), 10 deletions(-)
 delete mode 100644 Documentation/migration-guides/migration-master.md

diff --git a/Documentation/migration-guides/migration-master.md b/Documentation/migration-guides/migration-master.md
deleted file mode 100644
index 0cf45d071377..000000000000
--- a/Documentation/migration-guides/migration-master.md
+++ /dev/null
@@ -1,10 +0,0 @@
-:orphan:
-
-Boards
-------
-
-TQMA8MPxL
-^^^^^^^^^
-
-The config option has been renamed from MACH_TQ_MBA8MPXL to MACH_TQ_MBA8MPXX to
-accommodate the support for TQMA8MPxS boards with the same binary.
diff --git a/Documentation/migration-guides/migration-master.rst b/Documentation/migration-guides/migration-master.rst
index 026dbe85889c..32813ed7da2b 100644
--- a/Documentation/migration-guides/migration-master.rst
+++ b/Documentation/migration-guides/migration-master.rst
@@ -1,2 +1,13 @@
 :orphan:
 
+Boards
+------
+
+TQMA8MPxL
+^^^^^^^^^
+
+The config option has been renamed from ``CONFIG_MACH_TQ_MBA8MPXL`` to
+``CONFIG_MACH_TQ_MBA8MPXX`` to accommodate the support for TQMA8MPxS
+boards with the same binary.
+The binary has been renamed from ``barebox-tqma8mpxl.img``
+to ``barebox-tqma8mpxx.img``.
-- 
2.47.3

[PATCH master 2/4] Documentation: migration-guide: reinstate HABv4-enablement

[Ahmad Fatoum]

This got dropped inadvertently. Restore it as the upcoming release will
be the first to include it.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/migration-guides/migration-master.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Documentation/migration-guides/migration-master.rst b/Documentation/migration-guides/migration-master.rst
index 32813ed7da2b..3fad2f1053c6 100644
--- a/Documentation/migration-guides/migration-master.rst
+++ b/Documentation/migration-guides/migration-master.rst
@@ -11,3 +11,9 @@ The config option has been renamed from ``CONFIG_MACH_TQ_MBA8MPXL`` to
 boards with the same binary.
 The binary has been renamed from ``barebox-tqma8mpxl.img``
 to ``barebox-tqma8mpxx.img``.
+
+HABv4-enablement
+^^^^^^^^^^^^^^^^
+
+When the SRK hash is written, the corresponding fuse bank is now locked automatically.
+With that the ``IMX_SRK_HASH_WRITE_LOCK`` flag is removed.
-- 
2.47.3

[PATCH master 3/4] Documentation: migration-guide: mention TF-A v2.14 compatibility

[Ahmad Fatoum]

While this is not caused by barebox, it's something worth considering when
doing a migration, so add a short explanation.

The patch that restores TF-A v2.14 SCMI clock compatibility will be
part of the next release.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/migration-guides/migration-master.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Documentation/migration-guides/migration-master.rst b/Documentation/migration-guides/migration-master.rst
index 3fad2f1053c6..4a1de042d589 100644
--- a/Documentation/migration-guides/migration-master.rst
+++ b/Documentation/migration-guides/migration-master.rst
@@ -17,3 +17,14 @@ HABv4-enablement
 
 When the SRK hash is written, the corresponding fuse bank is now locked automatically.
 With that the ``IMX_SRK_HASH_WRITE_LOCK`` flag is removed.
+
+
+TF-A v2.14 compatibility
+------------------------
+
+TF-A v2.14 has `broken compatibility <https://lists.trustedfirmware.org/archives/list/tf-a@lists.trustedfirmware.org/thread/LKJVRDGRH7F73FWSTZC46I7IT3BRYQXC/>`_
+with SCMI consumers that implement only version 2.0 of the clock protocol.
+This includes barebox v2026.03.1, but also Linux v6.6.
+
+barebox v2026.04.0 is the first release that's compatible with both TF-A
+releases older than v2.14 as well as v2.14 itself.
-- 
2.47.3

[PATCH master 4/4] Documentation: migration-guide: add note about ZynqMP OP-TEE

[Ahmad Fatoum]

This popped up looking through AI-detected relevant device tree changes.
Assuming OP-TEE unconditionally was not a good idea anyways, so we won't
work around it and will just document this.

Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de>
---
 Documentation/migration-guides/migration-master.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/Documentation/migration-guides/migration-master.rst b/Documentation/migration-guides/migration-master.rst
index 4a1de042d589..251e6f67d7b3 100644
--- a/Documentation/migration-guides/migration-master.rst
+++ b/Documentation/migration-guides/migration-master.rst
@@ -12,6 +12,15 @@ boards with the same binary.
 The binary has been renamed from ``barebox-tqma8mpxl.img``
 to ``barebox-tqma8mpxx.img``.
 
+ZynqMP
+^^^^^^
+
+The Linux v7.0 device trees imported into this barebox release no
+longer feature an unconditional `"linaro,optee-tz"` compatible OF node.
+
+If OP-TEE use in barebox is desired, this node must be added back to the
+barebox device tree.
+
 HABv4-enablement
 ^^^^^^^^^^^^^^^^
 
-- 
2.47.3

Re: [PATCH master 1/4] Documentation: migration-guide: fix TQMA8MPxL section

[Sascha Hauer]

On Fri, 17 Apr 2026 10:52:24 +0200, Ahmad Fatoum wrote:
> This was erroneously a .md file, but we expect .rst files.
> Rename the file and reformat the entry a bit.
> 
> 

Applied, thanks!

[1/4] Documentation: migration-guide: fix TQMA8MPxL section
      https://git.pengutronix.de/cgit/barebox/commit/?id=c70327456540 (link may not be stable)
[2/4] Documentation: migration-guide: reinstate HABv4-enablement
      https://git.pengutronix.de/cgit/barebox/commit/?id=e390001c168d (link may not be stable)
[3/4] Documentation: migration-guide: mention TF-A v2.14 compatibility
      https://git.pengutronix.de/cgit/barebox/commit/?id=b35eae69b4d3 (link may not be stable)
[4/4] Documentation: migration-guide: add note about ZynqMP OP-TEE
      https://git.pengutronix.de/cgit/barebox/commit/?id=e6e6706f9353 (link may not be stable)

Best regards,
-- 
Sascha Hauer <s.hauer@pengutronix.de>