[PATCH v1 5/5] dt-bindings: misc: Add binding document for SB-RMI I3C

[Akshay Gupta]

- Document the dt-binding for AMD SB-RMI

Reviewed-by: Naveen Krishna Chatradhi <naveenkrishna.chatradhi@xxxxxxx>
Signed-off-by: Akshay Gupta <akshay.gupta@xxxxxxx>
---
 .../bindings/misc/amd,sbrmi-i3c.yaml          | 56 +++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/misc/amd,sbrmi-i3c.yaml

diff --git a/Documentation/devicetree/bindings/misc/amd,sbrmi-i3c.yaml b/Documentation/devicetree/bindings/misc/amd,sbrmi-i3c.yaml
new file mode 100644
index 000000000000..1d19571c2095
--- /dev/null
+++ b/Documentation/devicetree/bindings/misc/amd,sbrmi-i3c.yaml
@@ -0,0 +1,56 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/misc/amd,sbrmi-i3c.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: >
+  Sideband Remote Management Interface (SB-RMI) compliant
+  AMD SoC.
+
+maintainers:
+  - Akshay Gupta <Akshay.Gupta@xxxxxxx>
+
+description: |
+  SB Remote Management Interface (SB-RMI) is an SMBus compatible
+  interface that reports AMD SoC's Power (normalized Power) using,
+  Mailbox Service Request over I3C interface to BMC.
+  The power attributes in hwmon reports power in microwatts.
+
+properties:
+  reg:
+    - description: |
+        Encodes the static I2C address.
+      Socket 0: 0x3c
+      Socket 1: 0x38
+    - description: |
+        First half of the Provisioned ID (following the PID
+        definition provided by the I3C specification).
+        Contains the manufacturer ID left-shifted by 1 (0x224).
+    - description: |
+        Second half of the Provisioned ID (following the PID
+        definition provided by the I3C specification).
+        Contains the ORing of the part ID left-shifted by 16,
+        the instance ID left-shifted by 12 and extra information (0x00000002).
+
+  assigned-address:
+    - description: |
+	Dynamic address to be assigned to this device. As static address is
+	present, this address is assigned using SETDASA.
+
+required:
+  - reg
+  - assigned-address
+
+additionalProperties: false
+
+examples:
+  - |
+    i3c {
+        /* I3C device with a static I2C address and assigned address. */
+	sbrmi_p0_1: sbrmi@3c,22400000002 {
+		reg = <0x3c 0x224 0x00000002>;
+		assigned-address = <0x3c>;
+	};
+    };
+...
-- 
2.25.1