On Thu, Oct 27, 2022 at 03:53:25PM -0400, Krzysztof Kozlowski wrote: > On 27/10/2022 13:03, Russell King (Oracle) wrote: > > Add the DT binding for the Apple Mac System Management Controller GPIOs. > > > > Signed-off-by: Russell King (Oracle) <rmk+kernel@xxxxxxxxxxxxxxx> > > --- > > .../devicetree/bindings/gpio/gpio-macsmc.yaml | 28 +++++++++++++++++++ > > 1 file changed, 28 insertions(+) > > create mode 100644 Documentation/devicetree/bindings/gpio/gpio-macsmc.yaml > > > > diff --git a/Documentation/devicetree/bindings/gpio/gpio-macsmc.yaml b/Documentation/devicetree/bindings/gpio/gpio-macsmc.yaml > > new file mode 100644 > > index 000000000000..a3883d62292d > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/gpio/gpio-macsmc.yaml > > Filename based on compatible, so "apple,smc-gpio.yaml" Many of the other yaml files in gpio/ are named as such. > > @@ -0,0 +1,28 @@ > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > > +%YAML 1.2 > > +--- > > +$id: http://devicetree.org/schemas/gpio/gpio-macsmc.yaml# > > +$schema: http://devicetree.org/meta-schemas/core.yaml# > > + > > +title: Apple Mac System Management Controller GPIO > > + > > +maintainers: > > + - Hector Martin <marcan@xxxxxxxxx> > > + > > +description: > > + This describes the binding for the Apple Mac System Management Controller > > Drop "This describes the binding for" > > > + GPIO block. > > + > > +properties: > > + compatible: > > + allOf: > > That's not proper syntax. Look at other examples (e.g. Apple bindings) > doing it. Probably you wanted items here. Really? You're joking. I had sent an email to Rob to ask how this should be done because my first guess spat out unhelpful error messages from dt_bindings_check, and this is the best I could come up with based on other "examples". I tried "- items:" but that made no difference - dt_bindings_check spat errors, so that's clearly incorrect. Specifically, I tried: properties: compatible: - items: - enum: - apple,t8103-smc - const: apple,smc-gpio That doesn't work: Documentation/devicetree/bindings/gpio/gpio-macsmc.yaml: properties:compatible: [{'items': [{'const': 'apple,t8103-smc'}, {'const': 'apple,smc-gpio'}]}] is not of type 'object', 'boolean' from schema $id: http://json-schema.org/draft-07/schema# > > + - enum: > > + - apple,t8103-smc > > + - const: apple,smc-gpio > > + > > + gpio-controller: true > > + > > + '#gpio-cells': > > + const: 2 > > Missing required properties. Start from new bindings or example-schema. What's missing? All the other bindings that I see follow this pattern. > > + > > +additionalProperties: false > > Missing example, it's necessary to validate these. Documentation states that examples are optional according to the "writing-schema" documentation. Honestly, I find this YAML stuff extremely difficult, especially given the lack of documentation on how to write it and the cryptic error messages from the tooling. It's impossible to get it right before submitting it - and I suspect from what I see above, it's impossible for reviewers to know what is correct either, since some of what you've said above appears to be wrong! -- RMK's Patch system: https://www.armlinux.org.uk/developer/patches/ FTTP is here! 40Mbps down 10Mbps up. Decent connectivity at last!
