[PATCH linux-next v5 07/13] dt-bindings: mfd: Add a document for PECI client mfd

Subsystems: multifunction devices (mfd), open firmware and flattened device tree bindings, the rest

STALE3039d

5 messages, 2 authors, 2018-06-18 · open the first message on its own page

[PATCH linux-next v5 07/13] dt-bindings: mfd: Add a document for PECI client mfd

From: Jae Hyun Yoo <hidden>
Date: 2018-06-01 18:22:22

This commit adds a dt-bindings document for PECI client multi-function
device.

Signed-off-by: Jae Hyun Yoo <redacted>
Cc: Andrew Jeffery <redacted>
Cc: James Feist <redacted>
Cc: Jason M Biils <redacted>
Cc: Joel Stanley <joel@jms.id.au>
Cc: Vernon Mauery <redacted>
---
 .../devicetree/bindings/mfd/peci-client.txt   | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/mfd/peci-client.txt
diff --git a/Documentation/devicetree/bindings/mfd/peci-client.txt b/Documentation/devicetree/bindings/mfd/peci-client.txt
new file mode 100644
index 000000000000..4eb8f6bb6ca4
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/peci-client.txt
@@ -0,0 +1,23 @@
+* Intel PECI client bindings
+
+Required properties:
+- compatible : Should be "intel,peci-client", "simple-mfd".
+- reg        : Should contain address of a client CPU. Address range of CPU
+	       clients is starting from 0x30 based on PECI specification.
+
+Example:
+	peci-bus@0 {
+		#address-cells = <1>;
+		#size-cells = <0>;
+		< more properties >
+
+		peci-client@30 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x30>;
+		};
+
+		peci-client@31 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x31>;
+		};
+	};
-- 
2.17.0

Re: [PATCH linux-next v5 07/13] dt-bindings: mfd: Add a document for PECI client mfd

From: Lee Jones <hidden>
Date: 2018-06-13 06:16:44

All s/mfd/MFD/
This commit adds a dt-bindings document for PECI client multi-function
device.
Multi-Function Device
quoted hunk
Signed-off-by: Jae Hyun Yoo <redacted>
Cc: Andrew Jeffery <redacted>
Cc: James Feist <redacted>
Cc: Jason M Biils <redacted>
Cc: Joel Stanley <joel@jms.id.au>
Cc: Vernon Mauery <redacted>
---
 .../devicetree/bindings/mfd/peci-client.txt   | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/mfd/peci-client.txt
diff --git a/Documentation/devicetree/bindings/mfd/peci-client.txt b/Documentation/devicetree/bindings/mfd/peci-client.txt
new file mode 100644
index 000000000000..4eb8f6bb6ca4
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/peci-client.txt
@@ -0,0 +1,23 @@
+* Intel PECI client bindings
Now it the time to expand on what a "PECI client" is.
quoted hunk
+Required properties:
+- compatible : Should be "intel,peci-client", "simple-mfd".
+- reg        : Should contain address of a client CPU. Address range of CPU
+	       clients is starting from 0x30 based on PECI specification.
s/is starting/start/
+Example:
+	peci-bus@0 {
0?
+		#address-cells = <1>;
+		#size-cells = <0>;
No 'reg' property?
+		< more properties >
Remove this.
quoted hunk
+		peci-client@30 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x30>;
+		};
+
+		peci-client@31 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x31>;
+		};
+	};
-- 
Lee Jones [李琼斯]
Linaro Services Technical Lead
Linaro.org │ Open source software for ARM SoCs
Follow Linaro: Facebook | Twitter | Blog

Re: [PATCH linux-next v5 07/13] dt-bindings: mfd: Add a document for PECI client mfd

From: Jae Hyun Yoo <hidden>
Date: 2018-06-14 17:25:43

Thanks for the review. Please check my answers inline.

On 6/12/2018 11:16 PM, Lee Jones wrote:
All s/mfd/MFD/
Got it. Will fix it.
quoted
This commit adds a dt-bindings document for PECI client multi-function
device.
Multi-Function Device
Will fix it.
quoted
Signed-off-by: Jae Hyun Yoo <redacted>
Cc: Andrew Jeffery <redacted>
Cc: James Feist <redacted>
Cc: Jason M Biils <redacted>
Cc: Joel Stanley <joel@jms.id.au>
Cc: Vernon Mauery <redacted>
---
  .../devicetree/bindings/mfd/peci-client.txt   | 23 +++++++++++++++++++
  1 file changed, 23 insertions(+)
  create mode 100644 Documentation/devicetree/bindings/mfd/peci-client.txt
diff --git a/Documentation/devicetree/bindings/mfd/peci-client.txt b/Documentation/devicetree/bindings/mfd/peci-client.txt
new file mode 100644
index 000000000000..4eb8f6bb6ca4
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/peci-client.txt
@@ -0,0 +1,23 @@
+* Intel PECI client bindings
Now it the time to expand on what a "PECI client" is.
Okay, I'll add more description about the "PECI client".
quoted
+Required properties:
+- compatible : Should be "intel,peci-client", "simple-mfd".
+- reg        : Should contain address of a client CPU. Address range of CPU
+	       clients is starting from 0x30 based on PECI specification.
s/is starting/start/
Will change it to "Address range of CPU clients starts from ...".
quoted
+Example:
+	peci-bus@0 {
0?
Because the actual reg value of the peci bus is reg = <0x0 0x60> but
anyway it's an example.
quoted
+		#address-cells = <1>;
+		#size-cells = <0>;
No 'reg' property?
This is the actual peci bus node which is a parent of this MFD node:
	peci0: peci-bus@0 {
		compatible = "aspeed,ast2500-peci";
		reg = <0x0 0x60>;
		#address-cells = <1>;
		#size-cells = <0>;
		interrupts = <15>;
		clocks = <&syscon ASPEED_CLK_GATE_REFCLK>;
		resets = <&syscon ASPEED_RESET_PECI>;
		clock-frequency = <24000000>;
		msg-timing = <1>;
		addr-timing = <1>;
		rd-sampling-point = <8>;
		cmd-timeout-ms = <1000>;
	};
quoted
+		< more properties >
Remove this.
I dropped all other properties into < more properties > because I want
to show the #address-cells and #size-cells to state its sub-nodes
should have a single unique reg value. Should I remove this line or the
whole parent node?
quoted
+		peci-client@30 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x30>;
+		};
+
+		peci-client@31 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x31>;
+		};
+	};

Re: [PATCH linux-next v5 07/13] dt-bindings: mfd: Add a document for PECI client mfd

From: Lee Jones <hidden>
Date: 2018-06-18 06:03:13

On Thu, 14 Jun 2018, Jae Hyun Yoo wrote:

[...]
quoted
quoted
+Example:
+	peci-bus@0 {
0?
Because the actual reg value of the peci bus is reg = <0x0 0x60> but
anyway it's an example.
quoted
quoted
+		#address-cells = <1>;
+		#size-cells = <0>;
No 'reg' property?
0 is fine, but you really should have a 'reg' property.
This is the actual peci bus node which is a parent of this MFD node:
	peci0: peci-bus@0 {
		compatible = "aspeed,ast2500-peci";
		reg = <0x0 0x60>;
		#address-cells = <1>;
		#size-cells = <0>;
		interrupts = <15>;
		clocks = <&syscon ASPEED_CLK_GATE_REFCLK>;
		resets = <&syscon ASPEED_RESET_PECI>;
		clock-frequency = <24000000>;
		msg-timing = <1>;
		addr-timing = <1>;
		rd-sampling-point = <8>;
		cmd-timeout-ms = <1000>;
	};
quoted
quoted
+		< more properties >
Remove this.
I dropped all other properties into < more properties > because I want
to show the #address-cells and #size-cells to state its sub-nodes
should have a single unique reg value. Should I remove this line or the
whole parent node?
Just drop the properties which are unimportant for the example.  You
do not need to replace them with anything, especially with a non-DT
compliant string.
quoted
quoted
+		peci-client@30 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x30>;
+		};
+
+		peci-client@31 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x31>;
+		};
+	};
-- 
Lee Jones [李琼斯]
Linaro Services Technical Lead
Linaro.org │ Open source software for ARM SoCs
Follow Linaro: Facebook | Twitter | Blog

Re: [PATCH linux-next v5 07/13] dt-bindings: mfd: Add a document for PECI client mfd

From: Jae Hyun Yoo <hidden>
Date: 2018-06-18 17:12:03

On 6/17/2018 11:03 PM, Lee Jones wrote:
On Thu, 14 Jun 2018, Jae Hyun Yoo wrote:

[...]
quoted
quoted
quoted
+Example:
+	peci-bus@0 {
0?
Because the actual reg value of the peci bus is reg = <0x0 0x60> but
anyway it's an example.
quoted
quoted
+		#address-cells = <1>;
+		#size-cells = <0>;
No 'reg' property?
0 is fine, but you really should have a 'reg' property.
Okay, I'll add reg setting example.
quoted
This is the actual peci bus node which is a parent of this MFD node:
	peci0: peci-bus@0 {
		compatible = "aspeed,ast2500-peci";
		reg = <0x0 0x60>;
		#address-cells = <1>;
		#size-cells = <0>;
		interrupts = <15>;
		clocks = <&syscon ASPEED_CLK_GATE_REFCLK>;
		resets = <&syscon ASPEED_RESET_PECI>;
		clock-frequency = <24000000>;
		msg-timing = <1>;
		addr-timing = <1>;
		rd-sampling-point = <8>;
		cmd-timeout-ms = <1000>;
	};
quoted
quoted
+		< more properties >
Remove this.
I dropped all other properties into < more properties > because I want
to show the #address-cells and #size-cells to state its sub-nodes
should have a single unique reg value. Should I remove this line or the
whole parent node?
Just drop the properties which are unimportant for the example.  You
do not need to replace them with anything, especially with a non-DT
compliant string.
Okay, I'll fix it. Thanks a lot!
quoted
quoted
quoted
+		peci-client@30 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x30>;
+		};
+
+		peci-client@31 {
+			compatible = "intel,peci-client", "simple-mfd";
+			reg = <0x31>;
+		};
+	};
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help