diff mbox series

[v3,3/3] dt-bindings: sbrmi: Add SB-RMI hwmon driver bindings

Message ID 20210720055737.8666-3-nchatrad@amd.com (mailing list archive)
State Superseded
Headers show
Series [v3,1/3] hwmon: sbrmi: Add support for sbrmi power module | expand

Commit Message

Naveen Krishna Chatradhi July 20, 2021, 5:57 a.m. UTC 
From: Akshay Gupta <Akshay.Gupta@amd.com>

- Document device tree bindings for AMD SB-RMI emulated service.

Signed-off-by: Akshay Gupta <Akshay.Gupta@amd.com>
Signed-off-by: Naveen Krishna Chatradhi <nchatrad@amd.com>
---
Changes since v2:
None

 .../devicetree/bindings/hwmon/amd,sbrmi.yaml  | 53 +++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml

Comments

Guenter Roeck July 25, 2021, 9:36 p.m. UTC | #1 
On 7/19/21 10:57 PM, Naveen Krishna Chatradhi wrote:
> From: Akshay Gupta <Akshay.Gupta@amd.com>
> 
> - Document device tree bindings for AMD SB-RMI emulated service.
> 
> Signed-off-by: Akshay Gupta <Akshay.Gupta@amd.com>
> Signed-off-by: Naveen Krishna Chatradhi <nchatrad@amd.com>

Devicetree files need to be approved by a dt maintainer.
They can't do that if they are not copied on devicetree patches.

Guenter

> ---
> Changes since v2:
> None
> 
>   .../devicetree/bindings/hwmon/amd,sbrmi.yaml  | 53 +++++++++++++++++++
>   1 file changed, 53 insertions(+)
>   create mode 100644 Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
> 
> diff --git a/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml b/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
> new file mode 100644
> index 000000000000..7598b083979c
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
> @@ -0,0 +1,53 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/hwmon/amd,sbrmi.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: >
> +  Sideband Remote Management Interface (SB-RMI) compliant
> +  AMD SoC power device.
> +
> +maintainers:
> +  - Akshay Gupta <Akshay.Gupta@amd.com>
> +
> +description: |
> +  SB Remote Management Interface (SB-RMI) is an SMBus compatible
> +  interface that reports AMD SoC's Power (normalized Power) using,
> +  Mailbox Service Request and resembles a typical 8-pin remote power
> +  sensor's I2C interface to BMC. The power attributes in hwmon
> +  reports power in microwatts.
> +
> +properties:
> +  compatible:
> +    enum:
> +      - amd,sbrmi
> +
> +  reg:
> +    maxItems: 1
> +    description: |
> +      I2C bus address of the device as specified in Section SBI SMBus Address
> +      of the SoC register reference. The SB-RMI address is normally 78h for
> +      socket 0 and 70h for socket 1, but it could vary based on hardware
> +      address select pins.
> +      \[open source SoC register reference\]
> +        https://www.amd.com/en/support/tech-docs?keyword=55898
> +
> +required:
> +  - compatible
> +  - reg
> +
> +additionalProperties: false
> +
> +examples:
> +  - |
> +    i2c0 {
> +        #address-cells = <1>;
> +        #size-cells = <0>;
> +
> +        sbrmi@3c {
> +                compatible = "amd,sbrmi";
> +                reg = <0x3c>;
> +        };
> +    };
> +...
>
Chatradhi, Naveen Krishna July 26, 2021, 4:36 a.m. UTC | #2 
[AMD Official Use Only]

Hi Guenter,

Regards,
Naveenk

-----Original Message-----
From: Guenter Roeck <groeck7@gmail.com> On Behalf Of Guenter Roeck
Sent: Monday, July 26, 2021 3:07 AM
To: Chatradhi, Naveen Krishna <NaveenKrishna.Chatradhi@amd.com>; linux-hwmon@vger.kernel.org
Cc: Gupta, Akshay <Akshay.Gupta@amd.com>
Subject: Re: [PATCH v3 3/3] dt-bindings: sbrmi: Add SB-RMI hwmon driver bindings

[CAUTION: External Email]

On 7/19/21 10:57 PM, Naveen Krishna Chatradhi wrote:
> From: Akshay Gupta <Akshay.Gupta@amd.com>
>
> - Document device tree bindings for AMD SB-RMI emulated service.
>
> Signed-off-by: Akshay Gupta <Akshay.Gupta@amd.com>
> Signed-off-by: Naveen Krishna Chatradhi <nchatrad@amd.com>

Devicetree files need to be approved by a dt maintainer.
They can't do that if they are not copied on devicetree patches.
[naveenk:] Yes, my bad. Can I add the devicetree list now here or should I submit v4
of the patch-set with your reviewed-by on other 2 patches and copying the devicetree list.

Guenter

> ---
> Changes since v2:
> None
>
>   .../devicetree/bindings/hwmon/amd,sbrmi.yaml  | 53 +++++++++++++++++++
>   1 file changed, 53 insertions(+)
>   create mode 100644 
> Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
>
> diff --git a/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml 
> b/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
> new file mode 100644
> index 000000000000..7598b083979c
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
> @@ -0,0 +1,53 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) %YAML 1.2
> +---
> +$id: 
> +https://nam11.safelinks.protection.outlook.com/?url=http%3A%2F%2Fdevi
> +cetree.org%2Fschemas%2Fhwmon%2Famd%2Csbrmi.yaml%23&amp;data=04%7C01%7
> +CNaveenKrishna.Chatradhi%40amd.com%7C8a8332e2358f4c37030d08d94fb456ac
> +%7C3dd8961fe4884e608e11a82d994e183d%7C0%7C0%7C637628458245183191%7CUn
> +known%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
> +WwiLCJXVCI6Mn0%3D%7C1000&amp;sdata=Xwsc2G6T34oiV4aTzYLEb%2FLpoTj%2BW%
> +2B6LmRkAFyeauQ8%3D&amp;reserved=0
> +$schema: 
> +https://nam11.safelinks.protection.outlook.com/?url=http%3A%2F%2Fdevi
> +cetree.org%2Fmeta-schemas%2Fcore.yaml%23&amp;data=04%7C01%7CNaveenKri
> +shna.Chatradhi%40amd.com%7C8a8332e2358f4c37030d08d94fb456ac%7C3dd8961
> +fe4884e608e11a82d994e183d%7C0%7C0%7C637628458245183191%7CUnknown%7CTW
> +FpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI
> +6Mn0%3D%7C1000&amp;sdata=ieeFYJjYCyDzHrcGjvHWkkU6QHqXcBqOa4Kfsmqk3Ek%
> +3D&amp;reserved=0
> +
> +title: >
> +  Sideband Remote Management Interface (SB-RMI) compliant
> +  AMD SoC power device.
> +
> +maintainers:
> +  - Akshay Gupta <Akshay.Gupta@amd.com>
> +
> +description: |
> +  SB Remote Management Interface (SB-RMI) is an SMBus compatible
> +  interface that reports AMD SoC's Power (normalized Power) using,
> +  Mailbox Service Request and resembles a typical 8-pin remote power
> +  sensor's I2C interface to BMC. The power attributes in hwmon
> +  reports power in microwatts.
> +
> +properties:
> +  compatible:
> +    enum:
> +      - amd,sbrmi
> +
> +  reg:
> +    maxItems: 1
> +    description: |
> +      I2C bus address of the device as specified in Section SBI SMBus Address
> +      of the SoC register reference. The SB-RMI address is normally 78h for
> +      socket 0 and 70h for socket 1, but it could vary based on hardware
> +      address select pins.
> +      \[open source SoC register reference\]
> +        
> + https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Fww
> + w.amd.com%2Fen%2Fsupport%2Ftech-docs%3Fkeyword%3D55898&amp;data=04%7
> + C01%7CNaveenKrishna.Chatradhi%40amd.com%7C8a8332e2358f4c37030d08d94f
> + b456ac%7C3dd8961fe4884e608e11a82d994e183d%7C0%7C0%7C6376284582451831
> + 91%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBT
> + iI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&amp;sdata=eG384k%2FtNMNJD17u7qdIhjI
> + p2sz%2B6Qs5PpAprL54saU%3D&amp;reserved=0
> +
> +required:
> +  - compatible
> +  - reg
> +
> +additionalProperties: false
> +
> +examples:
> +  - |
> +    i2c0 {
> +        #address-cells = <1>;
> +        #size-cells = <0>;
> +
> +        sbrmi@3c {
> +                compatible = "amd,sbrmi";
> +                reg = <0x3c>;
> +        };
> +    };
> +...
>
Guenter Roeck July 26, 2021, 4:58 a.m. UTC | #3 
On 7/25/21 9:36 PM, Chatradhi, Naveen Krishna wrote:
> [AMD Official Use Only]
> 

You really should get rid of this...

> Hi Guenter,
> 
> Regards,
> Naveenk
> 
> -----Original Message-----
> From: Guenter Roeck <groeck7@gmail.com> On Behalf Of Guenter Roeck
> Sent: Monday, July 26, 2021 3:07 AM
> To: Chatradhi, Naveen Krishna <NaveenKrishna.Chatradhi@amd.com>; linux-hwmon@vger.kernel.org
> Cc: Gupta, Akshay <Akshay.Gupta@amd.com>
> Subject: Re: [PATCH v3 3/3] dt-bindings: sbrmi: Add SB-RMI hwmon driver bindings
> 
> [CAUTION: External Email]
> 
> On 7/19/21 10:57 PM, Naveen Krishna Chatradhi wrote:
>> From: Akshay Gupta <Akshay.Gupta@amd.com>
>>
>> - Document device tree bindings for AMD SB-RMI emulated service.
>>
>> Signed-off-by: Akshay Gupta <Akshay.Gupta@amd.com>
>> Signed-off-by: Naveen Krishna Chatradhi <nchatrad@amd.com>
> 
> Devicetree files need to be approved by a dt maintainer.
> They can't do that if they are not copied on devicetree patches.
> [naveenk:] Yes, my bad. Can I add the devicetree list now here or should I submit v4
> of the patch-set with your reviewed-by on other 2 patches and copying the devicetree list.
> 

Probably better to submit v4

Guenter

> Guenter
> 
>> ---
>> Changes since v2:
>> None
>>
>>    .../devicetree/bindings/hwmon/amd,sbrmi.yaml  | 53 +++++++++++++++++++
>>    1 file changed, 53 insertions(+)
>>    create mode 100644
>> Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
>>
>> diff --git a/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
>> b/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
>> new file mode 100644
>> index 000000000000..7598b083979c
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
>> @@ -0,0 +1,53 @@
>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) %YAML 1.2
>> +---
>> +$id:
>> +https://nam11.safelinks.protection.outlook.com/?url=http%3A%2F%2Fdevi
>> +cetree.org%2Fschemas%2Fhwmon%2Famd%2Csbrmi.yaml%23&amp;data=04%7C01%7
>> +CNaveenKrishna.Chatradhi%40amd.com%7C8a8332e2358f4c37030d08d94fb456ac
>> +%7C3dd8961fe4884e608e11a82d994e183d%7C0%7C0%7C637628458245183191%7CUn
>> +known%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1ha
>> +WwiLCJXVCI6Mn0%3D%7C1000&amp;sdata=Xwsc2G6T34oiV4aTzYLEb%2FLpoTj%2BW%
>> +2B6LmRkAFyeauQ8%3D&amp;reserved=0
>> +$schema:
>> +https://nam11.safelinks.protection.outlook.com/?url=http%3A%2F%2Fdevi
>> +cetree.org%2Fmeta-schemas%2Fcore.yaml%23&amp;data=04%7C01%7CNaveenKri
>> +shna.Chatradhi%40amd.com%7C8a8332e2358f4c37030d08d94fb456ac%7C3dd8961
>> +fe4884e608e11a82d994e183d%7C0%7C0%7C637628458245183191%7CUnknown%7CTW
>> +FpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI
>> +6Mn0%3D%7C1000&amp;sdata=ieeFYJjYCyDzHrcGjvHWkkU6QHqXcBqOa4Kfsmqk3Ek%
>> +3D&amp;reserved=0
>> +
>> +title: >
>> +  Sideband Remote Management Interface (SB-RMI) compliant
>> +  AMD SoC power device.
>> +
>> +maintainers:
>> +  - Akshay Gupta <Akshay.Gupta@amd.com>
>> +
>> +description: |
>> +  SB Remote Management Interface (SB-RMI) is an SMBus compatible
>> +  interface that reports AMD SoC's Power (normalized Power) using,
>> +  Mailbox Service Request and resembles a typical 8-pin remote power
>> +  sensor's I2C interface to BMC. The power attributes in hwmon
>> +  reports power in microwatts.
>> +
>> +properties:
>> +  compatible:
>> +    enum:
>> +      - amd,sbrmi
>> +
>> +  reg:
>> +    maxItems: 1
>> +    description: |
>> +      I2C bus address of the device as specified in Section SBI SMBus Address
>> +      of the SoC register reference. The SB-RMI address is normally 78h for
>> +      socket 0 and 70h for socket 1, but it could vary based on hardware
>> +      address select pins.
>> +      \[open source SoC register reference\]
>> +
>> + https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Fww
>> + w.amd.com%2Fen%2Fsupport%2Ftech-docs%3Fkeyword%3D55898&amp;data=04%7
>> + C01%7CNaveenKrishna.Chatradhi%40amd.com%7C8a8332e2358f4c37030d08d94f
>> + b456ac%7C3dd8961fe4884e608e11a82d994e183d%7C0%7C0%7C6376284582451831
>> + 91%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBT
>> + iI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&amp;sdata=eG384k%2FtNMNJD17u7qdIhjI
>> + p2sz%2B6Qs5PpAprL54saU%3D&amp;reserved=0
>> +
>> +required:
>> +  - compatible
>> +  - reg
>> +
>> +additionalProperties: false
>> +
>> +examples:
>> +  - |
>> +    i2c0 {
>> +        #address-cells = <1>;
>> +        #size-cells = <0>;
>> +
>> +        sbrmi@3c {
>> +                compatible = "amd,sbrmi";
>> +                reg = <0x3c>;
>> +        };
>> +    };
>> +...
>>
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml b/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
new file mode 100644
index 000000000000..7598b083979c
--- /dev/null
+++ b/Documentation/devicetree/bindings/hwmon/amd,sbrmi.yaml
@@ -0,0 +1,53 @@ 
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/hwmon/amd,sbrmi.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: >
+  Sideband Remote Management Interface (SB-RMI) compliant
+  AMD SoC power device.
+
+maintainers:
+  - Akshay Gupta <Akshay.Gupta@amd.com>
+
+description: |
+  SB Remote Management Interface (SB-RMI) is an SMBus compatible
+  interface that reports AMD SoC's Power (normalized Power) using,
+  Mailbox Service Request and resembles a typical 8-pin remote power
+  sensor's I2C interface to BMC. The power attributes in hwmon
+  reports power in microwatts.
+
+properties:
+  compatible:
+    enum:
+      - amd,sbrmi
+
+  reg:
+    maxItems: 1
+    description: |
+      I2C bus address of the device as specified in Section SBI SMBus Address
+      of the SoC register reference. The SB-RMI address is normally 78h for
+      socket 0 and 70h for socket 1, but it could vary based on hardware
+      address select pins.
+      \[open source SoC register reference\]
+        https://www.amd.com/en/support/tech-docs?keyword=55898
+
+required:
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c0 {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        sbrmi@3c {
+                compatible = "amd,sbrmi";
+                reg = <0x3c>;
+        };
+    };
+...