[1/3] dt-bindings: hwmon: jedec,spd5118: Add bindings

Commit Message

Guenter Roeck May 29, 2024, 8:52 p.m. UTC

Add device tree bindings for the SPD hub present in DDR5 modules.

Signed-off-by: Guenter Roeck <[e-mail]>
---
I am not sure about the "pec-enable" property since it is not really
a chip property but a SMBus property. It is also not chip specific;
there are other chips with the capability to enable or disable PEC
support. There are no generic SMBus bindings, though, so I don't know
a better place (or name - maybe it should be 'smbus,pec-enable', but
there are no other similar bindings, or at least I didn't find any).

 .../bindings/hwmon/jedec,spd5118.yaml         | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/hwmon/jedec,spd5118.yaml

Patch

diff --git a/Documentation/devicetree/bindings/hwmon/jedec,spd5118.yaml b/Documentation/devicetree/bindings/hwmon/jedec,spd5118.yaml
new file mode 100644
index 000000000000..1717f75129da
--- /dev/null
+++ b/Documentation/devicetree/bindings/hwmon/jedec,spd5118.yaml
@@ -0,0 +1,52 @@ 
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/hwmon/jedec,spd5118.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: JEDEC JESD300-5B (SPD5118) compatible DDR5 SPD hub
+
+maintainers:
+  - Guenter Roeck <[e-mail]>
+
+description: |
+  JEDEC JESD300-5B.01 SPD5118 Hub and Serial Presence Detect
+  https://www.jedec.org/standards-documents/docs/jesd300-5b01
+
+select:
+  properties:
+    compatible:
+      const: jedec,spd5118
+
+  required:
+    - compatible
+    - reg
+
+properties:
+  compatible:
+    const: jedec,spd5118
+
+  reg:
+    maxItems: 1
+
+  pec-enable:
+    description: Set to enable PEC (Packet Error Checking).
+    type: boolean
+
+required:
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        temp-sensor@51 {
+            compatible = "jedec,spd5118";
+            reg = <0x51>;
+        };
+    };