The syntax '&{$<orphan_name>/<path>}' allows to reference by path a node
that belongs to an orphan node.

Add a test related to this kind of references.

Signed-off-by: Herve Codina <herve.codina@bootlin.com>
---
 .../metadata_addon_references.dtb.dts.expect  | 48 +++++++++++++++++++
 tests/metadata_addon_references.dtb.expect    | 48 +++++++++++++++++++
 tests/metadata_addon_references.dts           | 43 +++++++++++++++++
 .../metadata_addon_references.dts.dts.expect  | 48 +++++++++++++++++++
 tests/run_tests.sh                            |  2 +-
 5 files changed, 188 insertions(+), 1 deletion(-)
 create mode 100644 tests/metadata_addon_references.dtb.dts.expect
 create mode 100644 tests/metadata_addon_references.dtb.expect
 create mode 100644 tests/metadata_addon_references.dts
 create mode 100644 tests/metadata_addon_references.dts.dts.expect

diff --git a/tests/metadata_addon_references.dtb.dts.expect b/tests/metadata_addon_references.dtb.dts.expect
new file mode 100644
index 0000000..267a929
--- /dev/null
+++ b/tests/metadata_addon_references.dtb.dts.expect
@@ -0,0 +1,48 @@
+/dts-v1/;
+/addon/;
+
+/ {
+
+	sub-node {
+		ref1-base1 = <&base1>;
+		ref2-base1-addon-node = <&{$base1/addon-node}>;
+		ref3-base1-addon-node = <&{$base1/addon-node}>;
+		ref4-base1-addon-node = <&{$base1/addon-node}>;
+		ref5-base3 = <&{$base3}>;
+		ref6-base3 = <&{$base3}>;
+		ref7-base3-subsubnode = <&{$base3/sub-node/sub-subnode}>;
+		phandle = <0x04>;
+	};
+};
+
+&base1 {
+
+	addon-node {
+		prop = <0x02>;
+		phandle = <0x01>;
+	};
+};
+
+&base2 {
+
+	addon-node1 {
+		ref-base1-addon-node = <&{$base1/addon-node}>;
+	};
+
+	addon-node2 {
+		ref-root-sub-node = <&{/sub-node}>;
+	};
+};
+
+&base3 {
+	phandle = <0x02>;
+
+	sub-node {
+		prop = <0x03>;
+
+		sub-subnode {
+			prop = <0x04>;
+			phandle = <0x03>;
+		};
+	};
+};
diff --git a/tests/metadata_addon_references.dtb.expect b/tests/metadata_addon_references.dtb.expect
new file mode 100644
index 0000000..d8db6cb
--- /dev/null
+++ b/tests/metadata_addon_references.dtb.expect
@@ -0,0 +1,48 @@
+/dts-v1/;
+/addon/;
+
+/ {
+    sub-node {
+        ref1-base1 = <0xffffffff>;
+        // [FDT_REF_PHANDLE] ref1-base1[0], ref = base1
+        ref2-base1-addon-node = <0x00000001>;
+        // [FDT_REF_LOCAL] ref2-base1-addon-node[0]
+        ref3-base1-addon-node = <0x00000001>;
+        // [FDT_REF_LOCAL] ref3-base1-addon-node[0]
+        ref4-base1-addon-node = <0x00000001>;
+        // [FDT_REF_LOCAL] ref4-base1-addon-node[0]
+        ref5-base3 = <0x00000002>;
+        // [FDT_REF_LOCAL] ref5-base3[0]
+        ref6-base3 = <0x00000002>;
+        // [FDT_REF_LOCAL] ref6-base3[0]
+        ref7-base3-subsubnode = <0x00000003>;
+        // [FDT_REF_LOCAL] ref7-base3-subsubnode[0]
+        phandle = <0x00000004>;
+    };
+};
+&base1 {
+    addon-node {
+        prop = <0x00000002>;
+        phandle = <0x00000001>;
+    };
+};
+&base2 {
+    addon-node1 {
+        ref-base1-addon-node = <0x00000001>;
+        // [FDT_REF_LOCAL] ref-base1-addon-node[0]
+    };
+    addon-node2 {
+        ref-root-sub-node = <0x00000004>;
+        // [FDT_REF_LOCAL] ref-root-sub-node[0]
+    };
+};
+&base3 {
+    phandle = <0x00000002>;
+    sub-node {
+        prop = <0x00000003>;
+        sub-subnode {
+            prop = <0x00000004>;
+            phandle = <0x00000003>;
+        };
+    };
+};
diff --git a/tests/metadata_addon_references.dts b/tests/metadata_addon_references.dts
new file mode 100644
index 0000000..239c141
--- /dev/null
+++ b/tests/metadata_addon_references.dts
@@ -0,0 +1,43 @@
+// SPDX-License-Identifier: (GPL-2.0-or-later OR BSD-2-Clause)
+/*
+ * Copyright (C) 2026 Bootlin
+ */
+
+/dts-v1/;
+/addon/;
+
+/ {
+	sub_node: sub-node {
+		ref1-base1 = <&base1>;
+		ref2-base1-addon-node = <&b1_addon>;
+		ref3-base1-addon-node = <&{$base1/addon-node}>;
+		ref4-base1-addon-node = <&{$base1/addon-node/}>;
+		ref5-base3 = <&{$base3}>;
+		ref6-base3 = <&{$base3/}>;
+		ref7-base3-subsubnode = <&{$base3/sub-node/sub-subnode}>;
+	};
+};
+
+&base1 {
+	b1_addon: addon-node {
+		prop = <2>;
+	};
+};
+
+&base2 {
+	addon-node1 {
+		ref-base1-addon-node = <&b1_addon>;
+	};
+	addon-node2 {
+		ref-root-sub-node = <&sub_node>;
+	};
+};
+
+&base3 {
+	sub-node {
+		prop = <3>;
+		sub-subnode {
+			prop = <4>;
+		};
+	};
+};
diff --git a/tests/metadata_addon_references.dts.dts.expect b/tests/metadata_addon_references.dts.dts.expect
new file mode 100644
index 0000000..dff893e
--- /dev/null
+++ b/tests/metadata_addon_references.dts.dts.expect
@@ -0,0 +1,48 @@
+/dts-v1/;
+/addon/;
+
+/ {
+
+	sub_node: sub-node {
+		ref1-base1 = <&base1>;
+		ref2-base1-addon-node = <&b1_addon>;
+		ref3-base1-addon-node = <&{$base1/addon-node}>;
+		ref4-base1-addon-node = <&{$base1/addon-node/}>;
+		ref5-base3 = <&{$base3}>;
+		ref6-base3 = <&{$base3/}>;
+		ref7-base3-subsubnode = <&{$base3/sub-node/sub-subnode}>;
+		phandle = <0x04>;
+	};
+};
+
+&base1 {
+
+	b1_addon: addon-node {
+		prop = <0x02>;
+		phandle = <0x01>;
+	};
+};
+
+&base2 {
+
+	addon-node1 {
+		ref-base1-addon-node = <&b1_addon>;
+	};
+
+	addon-node2 {
+		ref-root-sub-node = <&sub_node>;
+	};
+};
+
+&base3 {
+	phandle = <0x02>;
+
+	sub-node {
+		prop = <0x03>;
+
+		sub-subnode {
+			prop = <0x04>;
+			phandle = <0x03>;
+		};
+	};
+};
diff --git a/tests/run_tests.sh b/tests/run_tests.sh
index 12418bf..a371377 100755
--- a/tests/run_tests.sh
+++ b/tests/run_tests.sh
@@ -1129,7 +1129,7 @@ metadata_tests() {
 		  metadata_addon_base metadata_exportsyms_local \
 		  metadata_exportsyms_ref metadata_importsyms \
 		  metadata_addon_orphan1 metadata_addon_orphan2 \
-		  metadata_addon_orphan3; do
+		  metadata_addon_orphan3 metadata_addon_references; do
 		run_dtc_test -I dts -O dts -o $dt.dts.dts "$SRCDIR/$dt.dts"
 		base_run_test check_diff $dt.dts.dts "$SRCDIR/$dt.dts.dts.expect"
 		run_dtc_test -I dts -O dtb -o $dt.dtb "$SRCDIR/$dt.dts"
-- 
2.52.0