[PATCH 11/15] dt-bindings: soc: xilinx: Add Versal AI Engine DT binding

From: Gregory Williams

Date: Wed Nov 18 2026 - 18:33:13 EST


Add documentation to describe Versal AI Engine device tree bindings. AI
Engine is a tile array based processor with many cores and local memory
cache. Data routing between the cores is done through internal switches,
interface tiles are used to connect to external sources such as memory
or PL. Configuration registers of the device are accessed through a
memory mapped AXI address space.

Signed-off-by: Gregory Williams <gregory.williams@xxxxxxx>
---
.../bindings/soc/xilinx/xlnx,ai-engine.yaml | 61 +++++++++++++++++++
1 file changed, 61 insertions(+)
create mode 100644 Documentation/devicetree/bindings/soc/xilinx/xlnx,ai-engine.yaml

diff --git a/Documentation/devicetree/bindings/soc/xilinx/xlnx,ai-engine.yaml b/Documentation/devicetree/bindings/soc/xilinx/xlnx,ai-engine.yaml
new file mode 100644
index 000000000000..6c97b5f0fb03
--- /dev/null
+++ b/Documentation/devicetree/bindings/soc/xilinx/xlnx,ai-engine.yaml
@@ -0,0 +1,61 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+# Copyright(C) 2026 Advanced Micro Devices, Inc. All rights reserved.
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/soc/xilinx/xlnx,ai-engine.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: AMD AI Engine for Versal SoCs
+
+maintainers:
+ - Gregory Williams <gregory.williams@xxxxxxx>
+
+description:
+ The AMD AI Engine is a tile processor with many cores (up to 400) that
+ can run in parallel with some devices containing local cache (memory tiles).
+ The data routing between cores is configured through internal switches, and
+ shim tiles interface with external interconnect, such as memory or PL.
+
+properties:
+ compatible:
+ enum:
+ - xlnx,versal2-aieml
+
+ reg:
+ maxItems: 1
+
+ clocks:
+ maxItems: 1
+
+ clock-names:
+ const: aclk0
+
+ xlnx,firmware-device-id:
+ description:
+ Device identifier as defined by Versal firmware interface. This value is
+ passed unchanged to firmware calls.
+ $ref: /schemas/types.yaml#/definitions/uint32
+
+required:
+ - compatible
+ - reg
+ - clocks
+ - clock-names
+ - xlnx,firmware-device-id
+
+additionalProperties: false
+
+examples:
+ - |
+ soc {
+ #address-cells = <2>;
+ #size-cells = <2>;
+
+ ai_engine: ai-engine@20000000000 {
+ compatible = "xlnx,versal2-aieml";
+ reg = <0x200 0x00 0x01 0x00>;
+ clocks = <&aclk0>;
+ clock-names = "aclk0";
+ xlnx,firmware-device-id = <0x18224072>;
+ };
+ };
--
2.34.1