Re: [PATCH 2/2] dt-bindings: iio: adc: nxp,imx93-adc.yaml: Add calibration properties

From: Andrej Picej <andrej.picej@norik.com>
To: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>,
	haibo.chen@nxp.com, linux-iio@vger.kernel.org,
	devicetree@vger.kernel.org
Cc: jic23@kernel.org, lars@metafoo.de, shawnguo@kernel.org,
	s.hauer@pengutronix.de, kernel@pengutronix.de,
	festevam@gmail.com, imx@lists.linux.dev,
	linux-arm-kernel@lists.infradead.org,
	linux-kernel@vger.kernel.org, robh@kernel.org,
	krzysztof.kozlowski+dt@linaro.org, conor+dt@kernel.org,
	upstream@lists.phytec.de
Subject: Re: [PATCH 2/2] dt-bindings: iio: adc: nxp,imx93-adc.yaml: Add calibration properties
Date: Fri, 22 Mar 2024 08:39:01 +0100	[thread overview]
Message-ID: <40e08a5e-e7e9-47c7-9102-24a2bbba67cf@norik.com> (raw)
In-Reply-To: <7e58bf96-3c38-467f-86b6-06ff5feedb31@linaro.org>

On 20. 03. 24 13:15, Krzysztof Kozlowski wrote:
> On 20/03/2024 13:05, Andrej Picej wrote:
>> Hi Krzysztof,
>>
>> On 20. 03. 24 11:26, Krzysztof Kozlowski wrote:
>>> On 20/03/2024 11:04, Andrej Picej wrote:
>>>> Document calibration properties and how to set them.
>>>
>>> Bindings are before users.
>>
>> will change patch order when I send a v2.
>>
>>>
>>> Please use subject prefixes matching the subsystem. You can get them for
>>> example with `git log --oneline -- DIRECTORY_OR_FILE` on the directory
>>> your patch is touching.
>>> There is no file extension in prefixes.
>>
>> So: dt-bindings: iio/adc: nxp,imx93-adc: Add calibration properties?
> 
> Did you run the command I proposed? I don't see much of "/", but except
> that looks good.

Ok noted.

> 
>>
>>>
>>>>
>>>> Signed-off-by: Andrej Picej <andrej.picej@norik.com>
>>>> ---
>>>>    .../bindings/iio/adc/nxp,imx93-adc.yaml           | 15 +++++++++++++++
>>>>    1 file changed, 15 insertions(+)
>>>>
>>>> diff --git a/Documentation/devicetree/bindings/iio/adc/nxp,imx93-adc.yaml b/Documentation/devicetree/bindings/iio/adc/nxp,imx93-adc.yaml
>>>> index dacc526dc695..64958be62a6a 100644
>>>> --- a/Documentation/devicetree/bindings/iio/adc/nxp,imx93-adc.yaml
>>>> +++ b/Documentation/devicetree/bindings/iio/adc/nxp,imx93-adc.yaml
>>>> @@ -46,6 +46,21 @@ properties:
>>>>      "#io-channel-cells":
>>>>        const: 1
>>>>    
>>>> +  nxp,calib-avg-en:
>>>> +    description:
>>>> +      Enable or disable averaging of calibration time.
>>>> +    enum: [ 0, 1 ]
>>>> +
>>>> +  nxp,calib-nr-samples:
>>>> +    description:
>>>> +      Selects the number of averaging samples to be used during calibration.
>>>> +    enum: [ 16, 32, 128, 512 ]
>>>> +
>>>> +  nxp,calib-t-samples:
>>>> +    description:
>>>> +      Specifies the sample time of calibration conversions.
>>>> +    enum: [ 8, 16, 22, 32 ]
>>>
>>> No, use existing, generic properties. Open other bindings for this.
>>
>> You mean I should use generic properties for the ADC calibration
>> settings? Is there already something in place? Because as I understand
>> it, these calib-* values only effect the calibration process of the ADC.
> 
> Please take a look at other devices and dtschema. We already have some
> properties for this... but maybe they cannot be used?
> 

I did look into other ADC devices, grep across iio/adc, adc bindings 
folders and couldn't find anything closely related to what we are 
looking for. Could you please point me to the properties that you think 
should be used for this?

Thank you.
Andrej

> 
> Best regards,
> Krzysztof
> 