Message ID | 20180601182216.23894-1-jae.hyun.yoo@linux.intel.com |
---|---|
State | Changes Requested, archived |
Headers | show |
Series | PECI device driver introduction | expand |
All s/mfd/MFD/ > This commit adds a dt-bindings document for PECI client multi-function > device. Multi-Function Device > Signed-off-by: Jae Hyun Yoo <jae.hyun.yoo@linux.intel.com> > Cc: Andrew Jeffery <andrew@aj.id.au> > Cc: James Feist <james.feist@linux.intel.com> > Cc: Jason M Biils <jason.m.bills@linux.intel.com> > Cc: Joel Stanley <joel@jms.id.au> > Cc: Vernon Mauery <vernon.mauery@linux.intel.com> > --- > .../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. > +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. > + peci-client@30 { > + compatible = "intel,peci-client", "simple-mfd"; > + reg = <0x30>; > + }; > + > + peci-client@31 { > + compatible = "intel,peci-client", "simple-mfd"; > + reg = <0x31>; > + }; > + };
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. >> This commit adds a dt-bindings document for PECI client multi-function >> device. > > Multi-Function Device > Will fix it. >> Signed-off-by: Jae Hyun Yoo <jae.hyun.yoo@linux.intel.com> >> Cc: Andrew Jeffery <andrew@aj.id.au> >> Cc: James Feist <james.feist@linux.intel.com> >> Cc: Jason M Biils <jason.m.bills@linux.intel.com> >> Cc: Joel Stanley <joel@jms.id.au> >> Cc: Vernon Mauery <vernon.mauery@linux.intel.com> >> --- >> .../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". >> +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 ...". >> +Example: >> + peci-bus@0 { > > 0? > Because the actual reg value of the peci bus is reg = <0x0 0x60> but anyway it's an example. >> + #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>; }; >> + < 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? >> + peci-client@30 { >> + compatible = "intel,peci-client", "simple-mfd"; >> + reg = <0x30>; >> + }; >> + >> + peci-client@31 { >> + compatible = "intel,peci-client", "simple-mfd"; >> + reg = <0x31>; >> + }; >> + }; > -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
On Thu, 14 Jun 2018, Jae Hyun Yoo wrote: [...] > > > +Example: > > > + peci-bus@0 { > > > > 0? > > > > Because the actual reg value of the peci bus is reg = <0x0 0x60> but > anyway it's an example. > > > > + #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>; > }; > > > > + < 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. > > > + peci-client@30 { > > > + compatible = "intel,peci-client", "simple-mfd"; > > > + reg = <0x30>; > > > + }; > > > + > > > + peci-client@31 { > > > + compatible = "intel,peci-client", "simple-mfd"; > > > + reg = <0x31>; > > > + }; > > > + }; > >
On 6/17/2018 11:03 PM, Lee Jones wrote: > On Thu, 14 Jun 2018, Jae Hyun Yoo wrote: > > [...] > >>>> +Example: >>>> + peci-bus@0 { >>> >>> 0? >>> >> >> Because the actual reg value of the peci bus is reg = <0x0 0x60> but >> anyway it's an example. >> >>>> + #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. >> 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>; >> }; >> >>>> + < 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! >>>> + peci-client@30 { >>>> + compatible = "intel,peci-client", "simple-mfd"; >>>> + reg = <0x30>; >>>> + }; >>>> + >>>> + peci-client@31 { >>>> + compatible = "intel,peci-client", "simple-mfd"; >>>> + reg = <0x31>; >>>> + }; >>>> + }; >>> > -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
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>; + }; + };
This commit adds a dt-bindings document for PECI client multi-function device. Signed-off-by: Jae Hyun Yoo <jae.hyun.yoo@linux.intel.com> Cc: Andrew Jeffery <andrew@aj.id.au> Cc: James Feist <james.feist@linux.intel.com> Cc: Jason M Biils <jason.m.bills@linux.intel.com> Cc: Joel Stanley <joel@jms.id.au> Cc: Vernon Mauery <vernon.mauery@linux.intel.com> --- .../devicetree/bindings/mfd/peci-client.txt | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 Documentation/devicetree/bindings/mfd/peci-client.txt