| Message ID | 20240425213701.655540-5-eajames@linux.ibm.com |
|---|---|
| State | New |
| Headers | show |
| Series | ARM: dts: aspeed: Add IBM P11 BMC Boards | expand |
On 25/04/2024 23:36, Eddie James wrote: > Switch to yaml for the OCC documentation. Also document the fact > that the OCC "bridge" device will often have the hwmon node as a > child. > > Signed-off-by: Eddie James <eajames@linux.ibm.com> > --- > .../devicetree/bindings/fsi/ibm,p9-occ.txt | 16 -------- > .../devicetree/bindings/fsi/ibm,p9-occ.yaml | 41 +++++++++++++++++++ > 2 files changed, 41 insertions(+), 16 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt > create mode 100644 Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml > > diff --git a/Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt b/Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt > deleted file mode 100644 > index e73358075a90..000000000000 > --- a/Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt > +++ /dev/null > @@ -1,16 +0,0 @@ > -Device-tree bindings for FSI-attached POWER9/POWER10 On-Chip Controller (OCC) > ------------------------------------------------------------------------------ > - > -This is the binding for the P9 or P10 On-Chip Controller accessed over FSI from > -a service processor. See fsi.txt for details on bindings for FSI slave and CFAM > -nodes. The OCC is not an FSI slave device itself, rather it is accessed > -through the SBE FIFO. > - > -Required properties: > - - compatible = "ibm,p9-occ" or "ibm,p10-occ" > - > -Examples: > - > - occ { > - compatible = "ibm,p9-occ"; > - }; > diff --git a/Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml b/Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml > new file mode 100644 > index 000000000000..1fa87d452489 > --- /dev/null > +++ b/Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml > @@ -0,0 +1,41 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/fsi/ibm,p9-occ.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: IBM FSI-attached On-Chip Controller (OCC) > + > +maintainers: > + - Eddie James <eajames@linux.ibm.com> > + > +description: > + The POWER processor On-Chip Controller (OCC) helps manage power and > + thermals for the system, accessed through the FSI-attached SBEFIFO > + from a service processor. > + > +properties: > + compatible: > + enum: > + - ibm,p9-occ > + - ibm,p10-occ > + > + reg: > + items: > + - description: Processor index > + > +required: > + - compatible required goes after all properties, so below. > + > +patternProperties: > + "^occ-hwmon(@.*)?": > + type: object > + $ref: /schemas/hwmon/ibm,occ-hwmon.yaml Drop occ, not relevant. Why unit address is optional? This is supposed to be specific. Use proper regex as well for hex numbers. > + > +additionalProperties: false > + > +examples: > + - | > + occ { > + compatible = "ibm,p9-occ"; Not complete. Best regards, Krzysztof
On 4/26/24 01:19, Krzysztof Kozlowski wrote: > On 25/04/2024 23:36, Eddie James wrote: >> Switch to yaml for the OCC documentation. Also document the fact >> that the OCC "bridge" device will often have the hwmon node as a >> child. >> >> Signed-off-by: Eddie James <eajames@linux.ibm.com> >> --- >> .../devicetree/bindings/fsi/ibm,p9-occ.txt | 16 -------- >> .../devicetree/bindings/fsi/ibm,p9-occ.yaml | 41 +++++++++++++++++++ >> 2 files changed, 41 insertions(+), 16 deletions(-) >> delete mode 100644 Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt >> create mode 100644 Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml >> >> diff --git a/Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt b/Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt >> deleted file mode 100644 >> index e73358075a90..000000000000 >> --- a/Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt >> +++ /dev/null >> @@ -1,16 +0,0 @@ >> -Device-tree bindings for FSI-attached POWER9/POWER10 On-Chip Controller (OCC) >> ------------------------------------------------------------------------------ >> - >> -This is the binding for the P9 or P10 On-Chip Controller accessed over FSI from >> -a service processor. See fsi.txt for details on bindings for FSI slave and CFAM >> -nodes. The OCC is not an FSI slave device itself, rather it is accessed >> -through the SBE FIFO. >> - >> -Required properties: >> - - compatible = "ibm,p9-occ" or "ibm,p10-occ" >> - >> -Examples: >> - >> - occ { >> - compatible = "ibm,p9-occ"; >> - }; >> diff --git a/Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml b/Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml >> new file mode 100644 >> index 000000000000..1fa87d452489 >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml >> @@ -0,0 +1,41 @@ >> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) >> +%YAML 1.2 >> +--- >> +$id: http://devicetree.org/schemas/fsi/ibm,p9-occ.yaml# >> +$schema: http://devicetree.org/meta-schemas/core.yaml# >> + >> +title: IBM FSI-attached On-Chip Controller (OCC) >> + >> +maintainers: >> + - Eddie James <eajames@linux.ibm.com> >> + >> +description: >> + The POWER processor On-Chip Controller (OCC) helps manage power and >> + thermals for the system, accessed through the FSI-attached SBEFIFO >> + from a service processor. >> + >> +properties: >> + compatible: >> + enum: >> + - ibm,p9-occ >> + - ibm,p10-occ >> + >> + reg: >> + items: >> + - description: Processor index >> + >> +required: >> + - compatible > required goes after all properties, so below. Ack. > >> + >> +patternProperties: >> + "^occ-hwmon(@.*)?": >> + type: object >> + $ref: /schemas/hwmon/ibm,occ-hwmon.yaml > Drop occ, not relevant. Why unit address is optional? This is supposed > to be specific. Use proper regex as well for hex numbers. Well, there isn't really any concept of address here, it's a 1-to-1 relationship. I should just drop the unit address. > >> + >> +additionalProperties: false >> + >> +examples: >> + - | >> + occ { >> + compatible = "ibm,p9-occ"; > Not complete. Ack. > > > Best regards, > Krzysztof >
diff --git a/Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt b/Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt deleted file mode 100644 index e73358075a90..000000000000 --- a/Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt +++ /dev/null @@ -1,16 +0,0 @@ -Device-tree bindings for FSI-attached POWER9/POWER10 On-Chip Controller (OCC) ------------------------------------------------------------------------------ - -This is the binding for the P9 or P10 On-Chip Controller accessed over FSI from -a service processor. See fsi.txt for details on bindings for FSI slave and CFAM -nodes. The OCC is not an FSI slave device itself, rather it is accessed -through the SBE FIFO. - -Required properties: - - compatible = "ibm,p9-occ" or "ibm,p10-occ" - -Examples: - - occ { - compatible = "ibm,p9-occ"; - }; diff --git a/Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml b/Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml new file mode 100644 index 000000000000..1fa87d452489 --- /dev/null +++ b/Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml @@ -0,0 +1,41 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/fsi/ibm,p9-occ.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: IBM FSI-attached On-Chip Controller (OCC) + +maintainers: + - Eddie James <eajames@linux.ibm.com> + +description: + The POWER processor On-Chip Controller (OCC) helps manage power and + thermals for the system, accessed through the FSI-attached SBEFIFO + from a service processor. + +properties: + compatible: + enum: + - ibm,p9-occ + - ibm,p10-occ + + reg: + items: + - description: Processor index + +required: + - compatible + +patternProperties: + "^occ-hwmon(@.*)?": + type: object + $ref: /schemas/hwmon/ibm,occ-hwmon.yaml + +additionalProperties: false + +examples: + - | + occ { + compatible = "ibm,p9-occ"; + };
Switch to yaml for the OCC documentation. Also document the fact that the OCC "bridge" device will often have the hwmon node as a child. Signed-off-by: Eddie James <eajames@linux.ibm.com> --- .../devicetree/bindings/fsi/ibm,p9-occ.txt | 16 -------- .../devicetree/bindings/fsi/ibm,p9-occ.yaml | 41 +++++++++++++++++++ 2 files changed, 41 insertions(+), 16 deletions(-) delete mode 100644 Documentation/devicetree/bindings/fsi/ibm,p9-occ.txt create mode 100644 Documentation/devicetree/bindings/fsi/ibm,p9-occ.yaml