linux-kernel - Re: [PATCH v3 1/2] dt-bindings: iio: dac: add docs for ad8460

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20240907180149.67fdc636@jic23-huawei>
Date: Sat, 7 Sep 2024 18:01:49 +0100
From: Jonathan Cameron <jic23@...nel.org>
To: Krzysztof Kozlowski <krzk@...nel.org>
Cc: Mariel Tinaco <Mariel.Tinaco@...log.com>, linux-iio@...r.kernel.org,
 devicetree@...r.kernel.org, linux-kernel@...r.kernel.org, Lars-Peter
 Clausen <lars@...afoo.de>, Rob Herring <robh@...nel.org>, Krzysztof
 Kozlowski <krzk+dt@...nel.org>, Michael Hennerich
 <Michael.Hennerich@...log.com>, Conor Dooley <conor+dt@...nel.org>, Marcelo
 Schmitt <marcelo.schmitt1@...il.com>, Dimitri Fedrau
 <dima.fedrau@...il.com>, David Lechner <dlechner@...libre.com>, Nuno
 Sá <noname.nuno@...il.com>
Subject: Re: [PATCH v3 1/2] dt-bindings: iio: dac: add docs for ad8460

On Wed, 4 Sep 2024 08:20:53 +0200
Krzysztof Kozlowski <krzk@...nel.org> wrote:

> On Wed, Sep 04, 2024 at 10:30:39AM +0800, Mariel Tinaco wrote:
> > This adds the bindings documentation for the 14-bit  
> 
> Please do not use "This commit/patch/change", but imperative mood. See
> longer explanation here:
> https://elixir.bootlin.com/linux/v5.17.1/source/Documentation/process/submitting-patches.rst#L95
> 
> > High Voltage, High Current, Waveform Generator
> > Digital-to-Analog converter.
> > 
> > Signed-off-by: Mariel Tinaco <Mariel.Tinaco@...log.com>
> > ---
> >  .../bindings/iio/dac/adi,ad8460.yaml          | 154 ++++++++++++++++++
> >  MAINTAINERS                                   |   7 +
> >  2 files changed, 161 insertions(+)
> >  create mode 100644 Documentation/devicetree/bindings/iio/dac/adi,ad8460.yaml  
> 
> > +  adi,range-microvolt:
> > +    description: Voltage output range specified as <minimum, maximum>
> > +    oneOf:  
> 
> This oneOf does not make sense. There is only one condition. Drop.
> 
> > +      - items:
> > +          - enum: [0, -10000000, -20000000, -30000000, -40000000, -55000000]
> > +          - enum: [10000000, 20000000, 30000000, 40000000, 55000000]  
> 
> What's the default? It's not a required property.
> 
> > +
> > +  adi,range-microamp:
> > +    description: Current output range specified as <minimum, maximum>
> > +    oneOf:
> > +      - items:
> > +          - enum: [-50000, -100000, -300000, -500000, -1000000]  
> 
> I don't understand why 0 is not listed here.

I'm not sure why it is a list at all. Seems like the hardware
allows a continuous value so this should just specify max and min.

> 
> > +          - enum: [50000, 100000, 300000, 500000, 1000000]
> > +      - items:
> > +          - const: 0
> > +          - enum: [50000, 100000, 300000, 500000, 1000000]
> > +  
> 
> What's the default? It's not a required property.
> 
> > +  adi,max-millicelsius:
> > +    description: Overtemperature threshold
> > +    default: 50000
> > +    minimum: 20000
> > +    maximum: 150000
> > +
> > +  shutdown-reset-gpios:
> > +    description: Corresponds to SDN_RESET pin. To exit shutdown
> > +      or sleep mode, pulse SDN_RESET HIGH, then leave LOW.
> > +    maxItems: 1
> > +
> > +  reset-gpios:
> > +    description: Manual Power On Reset (POR). Pull this GPIO pin
> > +      LOW and then HIGH to reset all digital registers to default
> > +    maxItems: 1
> > +
> > +  shutdown-gpios:
> > +    description: Corresponds to SDN_IO pin. Shutdown may be
> > +      initiated by the user, by pulsing SDN_IO high. To exit shutdown,
> > +      pulse SDN_IO low, then float.
> > +    maxItems: 1
> > +
> > +required:
> > +  - compatible
> > +  - reg
> > +  - clocks  
> 
> Some supplies are for sure required. Devices rarely can operate without
> power provided.
> 
> > +
> > +allOf:
> > +  - $ref: /schemas/spi/spi-peripheral-props.yaml#
> > +
> > +additionalProperties: false  
> 
> unevaluatedProperties instead.
> 
> Best regards,
> Krzysztof
>