[PATCH v3 2/6] dt-bindings: firmware: add i.MX95 SCMI Extension protocol

From: Peng Fan (OSS)
Date: Fri Apr 12 2024 - 06:40:05 EST


From: Peng Fan <peng.fan@xxxxxxx>

Add i.MX SCMI Extension protocols bindings for:
- Battery Backed Module(BBM) Protocol
This contains persistent storage (GPR), an RTC, and the ON/OFF button.
The protocol can also provide access to similar functions implemented via
external board components.
- MISC Protocol.
This includes controls that are misc settings/actions that must be exposed
from the SM to agents. They are device specific and are usually define to
access bit fields in various mix block control modules, IOMUX_GPR, and other
GPR/CSR owned by the SM.

Signed-off-by: Peng Fan <peng.fan@xxxxxxx>
---
.../devicetree/bindings/firmware/arm,scmi.yaml | 21 +++++++++++++
.../bindings/firmware/nxp,imx95-scmi.yaml | 36 ++++++++++++++++++++++
2 files changed, 57 insertions(+)

diff --git a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
index 93fb7d05f849..fa2cc910c485 100644
--- a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
+++ b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
@@ -247,6 +247,27 @@ properties:
reg:
const: 0x18

+ protocol@81:
+ $ref: '#/$defs/protocol-node'
+ unevaluatedProperties: false
+
+ properties:
+ reg:
+ const: 0x81
+
+ protocol@84:
+ type: object
+ anyOf:
+ - allOf:
+ - $ref: /schemas/firmware/nxp,imx95-scmi.yaml
+ - $ref: '#/$defs/protocol-node'
+
+ unevaluatedProperties: false
+
+ properties:
+ reg:
+ const: 0x84
+
additionalProperties: false

$defs:
diff --git a/Documentation/devicetree/bindings/firmware/nxp,imx95-scmi.yaml b/Documentation/devicetree/bindings/firmware/nxp,imx95-scmi.yaml
new file mode 100644
index 000000000000..b84c4a53b78a
--- /dev/null
+++ b/Documentation/devicetree/bindings/firmware/nxp,imx95-scmi.yaml
@@ -0,0 +1,36 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+# Copyright 2024 NXP
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/firmware/nxp,imx95-scmi.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: i.MX95 System Control and Management Interface(SCMI) Vendor Protocols Extension
+
+maintainers:
+ - Peng Fan <peng.fan@xxxxxxx>
+
+properties:
+ nxp,wakeup-sources:
+ description:
+ Each entry consists of 2 integers, represents the source and electric signal edge
+ items:
+ items:
+ - description: the wakeup source
+ - description: the wakeup electric signal edge
+ minItems: 1
+ maxItems: 32
+ $ref: /schemas/types.yaml#/definitions/uint32-matrix
+
+if:
+ properties:
+ reg:
+ const: 0x84
+then:
+ properties:
+ nxp,wakeup-sources: true
+else:
+ properties:
+ nxp,wakeup-sources: false
+
+additionalProperties: true

--
2.37.1