On 11/20, Krzysztof Kozlowski wrote: > On Tue, Nov 19, 2024 at 09:53:40AM -0300, Marcelo Schmitt wrote: > > Extend the AD4000 series device tree documentation to also describe > > PulSAR devices. > > > > Signed-off-by: Marcelo Schmitt <marcelo.schmitt@xxxxxxxxxx> > > --- > > No changes from v2 -> v3. > > > > .../bindings/iio/adc/adi,ad4000.yaml | 71 +++++++++++++++++++ > > 1 file changed, 71 insertions(+) > > > > diff --git a/Documentation/devicetree/bindings/iio/adc/adi,ad4000.yaml b/Documentation/devicetree/bindings/iio/adc/adi,ad4000.yaml > > index e413a9d8d2a2..4dbb3d2876f9 100644 > > --- a/Documentation/devicetree/bindings/iio/adc/adi,ad4000.yaml > > +++ b/Documentation/devicetree/bindings/iio/adc/adi,ad4000.yaml > > @@ -19,6 +19,20 @@ description: | > > https://www.analog.com/media/en/technical-documentation/data-sheets/ad4020-4021-4022.pdf > > https://www.analog.com/media/en/technical-documentation/data-sheets/adaq4001.pdf > > https://www.analog.com/media/en/technical-documentation/data-sheets/adaq4003.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7685.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7686.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7687.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7688.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7690.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7691.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7693.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7942.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7946.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7980.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7982.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7983.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7984.pdf > > + https://www.analog.com/media/en/technical-documentation/data-sheets/ad7988-1_7988-5.pdf > > > > $ref: /schemas/spi/spi-peripheral-props.yaml# > > > > @@ -63,6 +77,37 @@ properties: > > > > - const: adi,adaq4003 > > > > + - const: adi,ad7946 > > All such cases are just one enum. That's the preferred syntax. > Ack > > > + - items: > > + - enum: > > + - adi,ad7942 > > + - const: adi,ad7946 > > + > > + - const: adi,ad7983 > > + - items: > > + - enum: > > + - adi,ad7980 > > + - adi,ad7988-5 > > + - adi,ad7686 > > + - adi,ad7685 > > Keep alphabetical order. Do the fallbacks declared here have any impact on the match try order or on how the compatible list should be ordered? The only significant difference between each group of devices is the sample rate. A faster device can read at slower sample rates so if somebody knows to have a 16-bit pseudo-differential PulSAR but doesn't know about the exact model they could have a compatible like compatible = "adi,ad7980", "adi,ad7988-5", "adi,ad7686", "adi,ad7685", "adi,ad7988-1", "adi,ad7983"; to try from fastest to slowest device. The dt doc would indicate that order in the fallback list? - items: - enum: - adi,ad7980 # Fastest 16-bit pseudo-differential ADC - adi,ad7988-5 # 2nd fastest 16-bit pseudo-differential ADC - adi,ad7686 # 3rd fastest 16-bit pseudo-differential ADC - adi,ad7685 # 4th fastest 16-bit pseudo-differential ADC - adi,ad7988-1 # 5th fastest 16-bit pseudo-differential ADC - const: adi,ad7983 # Slowest 16-bit pseudo-differential ADC https://www.analog.com/media/en/technical-documentation/data-sheets/ad7691.pdf has a nice table with the different devices and sample rates. writing-bindings.rst says "DO use fallback compatibles when devices are the same as or a subset of prior implementations." But, how can we use fallbacks properly?
