MLK-25246-1 dt-bindings: imx: add DT Binding doc for S400-api

Add DT schema binding document for S400 Baseline API.

Reviewed-by: Ye Li <ye.li@nxp.com>
Signed-off-by: Alice Guo <alice.guo@nxp.com>
(cherry picked from commit 98904bbd47143cefd981654587be7e23b2da7c71)

1 files changed, 48 insertions, 0 deletions

diff --git a/Documentation/devicetree/bindings/arm/freescale/fsl,s400-api.yaml b/Documentation/devicetree/bindings/arm/freescale/fsl,s400-api.yaml
new file mode 100644
index 000000000000..fe2c2b69b63c
--- /dev/null
+++ b/Documentation/devicetree/bindings/arm/freescale/fsl,s400-api.yaml
@@ -0,0 +1,48 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/arm/freescale/fsl,s400-api.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: NXP S400 Baseline API module
+
+maintainers:
+  - Alice Guo <alice.guo@nxp.com>
+
+description: |
+  In the Sentinel application, the security subsystem uses S4 MU-AP to
+  communicate and coordinate with the SoC host processor. The s400-api firmware
+  driver provides the services to transmit data to and receive data from the
+  S4 MU-AP.
+
+properties:
+  compatible:
+    items:
+      - const: fsl,imx8ulp-s400
+
+  mboxes:
+    description: |
+      Use the mailbox provided by S4 MU-AP device to communicate with the S400.
+      It should contain 2 mailboxes, one for transmitting messages and another
+      for receiving.
+    maxItems: 1
+
+  mbox-names:
+    items:
+      - const: tx
+      - const: rx
+
+required:
+  - compatible
+  - mboxes
+  - mbox-names
+
+additionalProperties: false
+
+examples:
+  - |
+    s400-api {
+        compatible = "fsl,imx8ulp-s400";
+        mboxes = <&s4muap 0 0 &s4muap 1 0>;
+        mbox-names = "tx", "rx";
+    };