2022-09-25 20:46:48

by Luca Weiss

[permalink] [raw]
Subject: [PATCH] ARM: dts: qcom-pma8084: fix vadc channel node names

Node names for the channel are supposed to be adc-chan@REG.

Signed-off-by: Luca Weiss <[email protected]>
---
arch/arm/boot/dts/qcom-pma8084.dtsi | 17 +++++++++++------
1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/arch/arm/boot/dts/qcom-pma8084.dtsi b/arch/arm/boot/dts/qcom-pma8084.dtsi
index e77602e9f95c..7ad573c7b4ac 100644
--- a/arch/arm/boot/dts/qcom-pma8084.dtsi
+++ b/arch/arm/boot/dts/qcom-pma8084.dtsi
@@ -64,22 +64,27 @@ pma8084_vadc: adc@3100 {
#size-cells = <0>;
#io-channel-cells = <1>;

- die_temp {
+ adc-chan@8 {
reg = <VADC_DIE_TEMP>;
};
- ref_625mv {
+
+ adc-chan@9 {
reg = <VADC_REF_625MV>;
};
- ref_1250v {
+
+ adc-chan@10 {
reg = <VADC_REF_1250MV>;
};
- ref_buf_625mv {
+
+ adc-chan@12 {
reg = <VADC_SPARE1>;
};
- ref_gnd {
+
+ adc-chan@14 {
reg = <VADC_GND_REF>;
};
- ref_vdd {
+
+ adc-chan@15 {
reg = <VADC_VDD_VADC>;
};
};
--
2.37.3


2022-09-26 08:47:15

by Neil Armstrong

[permalink] [raw]
Subject: Re: [PATCH] ARM: dts: qcom-pma8084: fix vadc channel node names

On 25/09/2022 22:21, Luca Weiss wrote:
> Node names for the channel are supposed to be adc-chan@REG.
>
> Signed-off-by: Luca Weiss <[email protected]>
> ---
> arch/arm/boot/dts/qcom-pma8084.dtsi | 17 +++++++++++------
> 1 file changed, 11 insertions(+), 6 deletions(-)
>
> diff --git a/arch/arm/boot/dts/qcom-pma8084.dtsi b/arch/arm/boot/dts/qcom-pma8084.dtsi
> index e77602e9f95c..7ad573c7b4ac 100644
> --- a/arch/arm/boot/dts/qcom-pma8084.dtsi
> +++ b/arch/arm/boot/dts/qcom-pma8084.dtsi
> @@ -64,22 +64,27 @@ pma8084_vadc: adc@3100 {
> #size-cells = <0>;
> #io-channel-cells = <1>;
>
> - die_temp {
> + adc-chan@8 {
> reg = <VADC_DIE_TEMP>;
> };
> - ref_625mv {
> +
> + adc-chan@9 {
> reg = <VADC_REF_625MV>;
> };
> - ref_1250v {
> +
> + adc-chan@10 {
> reg = <VADC_REF_1250MV>;
> };
> - ref_buf_625mv {
> +
> + adc-chan@12 {
> reg = <VADC_SPARE1>;
> };
> - ref_gnd {
> +
> + adc-chan@14 {
> reg = <VADC_GND_REF>;
> };
> - ref_vdd {
> +
> + adc-chan@15 {
> reg = <VADC_VDD_VADC>;
> };
> };

I don't see where this is required, bindings doesn't mandate this naming:

patternProperties:

"^.*@[0-9a-f]+$":
Neil

2022-09-26 17:06:32

by Luca Weiss

[permalink] [raw]
Subject: Re: [PATCH] ARM: dts: qcom-pma8084: fix vadc channel node names

Hi Neil,

On Montag, 26. September 2022 10:27:54 CEST Neil Armstrong wrote:
> On 25/09/2022 22:21, Luca Weiss wrote:
> > Node names for the channel are supposed to be adc-chan@REG.
> >
> > Signed-off-by: Luca Weiss <[email protected]>
> > ---
> >
> > arch/arm/boot/dts/qcom-pma8084.dtsi | 17 +++++++++++------
> > 1 file changed, 11 insertions(+), 6 deletions(-)
> >
> > diff --git a/arch/arm/boot/dts/qcom-pma8084.dtsi
> > b/arch/arm/boot/dts/qcom-pma8084.dtsi index e77602e9f95c..7ad573c7b4ac
> > 100644
> > --- a/arch/arm/boot/dts/qcom-pma8084.dtsi
> > +++ b/arch/arm/boot/dts/qcom-pma8084.dtsi
> > @@ -64,22 +64,27 @@ pma8084_vadc: adc@3100 {
> >
> > #size-cells = <0>;
> > #io-channel-cells = <1>;
> >
> > - die_temp {
> > + adc-chan@8 {
> >
> > reg = <VADC_DIE_TEMP>;
> >
> > };
> >
> > - ref_625mv {
> > +
> > + adc-chan@9 {
> >
> > reg = <VADC_REF_625MV>;
> >
> > };
> >
> > - ref_1250v {
> > +
> > + adc-chan@10 {
> >
> > reg = <VADC_REF_1250MV>;
> >
> > };
> >
> > - ref_buf_625mv {
> > +
> > + adc-chan@12 {
> >
> > reg = <VADC_SPARE1>;
> >
> > };
> >
> > - ref_gnd {
> > +
> > + adc-chan@14 {
> >
> > reg = <VADC_GND_REF>;
> >
> > };
> >
> > - ref_vdd {
> > +
> > + adc-chan@15 {
> >
> > reg = <VADC_VDD_VADC>;
> >
> > };
> >
> > };
>
> I don't see where this is required, bindings doesn't mandate this naming:
>
> patternProperties:
>
> "^.*@[0-9a-f]+$":

They don't require the "adc-chan" part (although dt nodes are supposed to have
common names and adc-chan is used for adc for that; and dt node names are not
supposed to have underscores), but this validation error happens without this
commit:

<snip>/arch/arm/boot/dts/qcom-apq8084-ifc6540.dtb: pma8084@0: adc@3100:
'oneOf' conditional failed, one must be fixed:
'#address-cells', '#size-cells', 'die_temp', 'ref_1250v', 'ref_625mv',
'ref_buf_625mv', 'ref_gnd', 'ref_vdd' do not match any of the regexes:
'pinctrl-[0-9]+'
'die_temp', 'ref_1250v', 'ref_625mv', 'ref_buf_625mv', 'ref_gnd',
'ref_vdd' do not match any of the regexes: '^.*@[0-9a-f]+$', 'pinctrl-[0-9]+'
'qcom,spmi-iadc' was expected
From schema: <snip>/Documentation/devicetree/bindings/mfd/qcom,spmi-
pmic.yaml

So while e.g. ref-vdd@15 would also work, adc-chan@15 is more correct.

Regards
Luca


> Neil




2022-09-26 17:51:17

by Krzysztof Kozlowski

[permalink] [raw]
Subject: Re: [PATCH] ARM: dts: qcom-pma8084: fix vadc channel node names

On 26/09/2022 16:57, Luca Weiss wrote:
> Hi Neil,
>
> On Montag, 26. September 2022 10:27:54 CEST Neil Armstrong wrote:
>> On 25/09/2022 22:21, Luca Weiss wrote:
>>> Node names for the channel are supposed to be adc-chan@REG.
>>>
>>> Signed-off-by: Luca Weiss <[email protected]>
>>> ---
>>>
>>> arch/arm/boot/dts/qcom-pma8084.dtsi | 17 +++++++++++------
>>> 1 file changed, 11 insertions(+), 6 deletions(-)
>>>
>>> diff --git a/arch/arm/boot/dts/qcom-pma8084.dtsi
>>> b/arch/arm/boot/dts/qcom-pma8084.dtsi index e77602e9f95c..7ad573c7b4ac
>>> 100644
>>> --- a/arch/arm/boot/dts/qcom-pma8084.dtsi
>>> +++ b/arch/arm/boot/dts/qcom-pma8084.dtsi
>>> @@ -64,22 +64,27 @@ pma8084_vadc: adc@3100 {
>>>
>>> #size-cells = <0>;
>>> #io-channel-cells = <1>;
>>>
>>> - die_temp {
>>> + adc-chan@8 {
>>>
>>> reg = <VADC_DIE_TEMP>;
>>>
>>> };
>>>
>>> - ref_625mv {
>>> +
>>> + adc-chan@9 {
>>>
>>> reg = <VADC_REF_625MV>;
>>>
>>> };
>>>
>>> - ref_1250v {
>>> +
>>> + adc-chan@10 {
>>>
>>> reg = <VADC_REF_1250MV>;
>>>
>>> };
>>>
>>> - ref_buf_625mv {
>>> +
>>> + adc-chan@12 {
>>>
>>> reg = <VADC_SPARE1>;
>>>
>>> };
>>>
>>> - ref_gnd {
>>> +
>>> + adc-chan@14 {
>>>
>>> reg = <VADC_GND_REF>;
>>>
>>> };
>>>
>>> - ref_vdd {
>>> +
>>> + adc-chan@15 {
>>>
>>> reg = <VADC_VDD_VADC>;
>>>
>>> };
>>>
>>> };
>>
>> I don't see where this is required, bindings doesn't mandate this naming:
>>
>> patternProperties:
>>
>> "^.*@[0-9a-f]+$":
>
> They don't require the "adc-chan" part (although dt nodes are supposed to have
> common names and adc-chan is used for adc for that; and dt node names are not
> supposed to have underscores), but this validation error happens without this
> commit:
>
> <snip>/arch/arm/boot/dts/qcom-apq8084-ifc6540.dtb: pma8084@0: adc@3100:
> 'oneOf' conditional failed, one must be fixed:
> '#address-cells', '#size-cells', 'die_temp', 'ref_1250v', 'ref_625mv',
> 'ref_buf_625mv', 'ref_gnd', 'ref_vdd' do not match any of the regexes:
> 'pinctrl-[0-9]+'
> 'die_temp', 'ref_1250v', 'ref_625mv', 'ref_buf_625mv', 'ref_gnd',
> 'ref_vdd' do not match any of the regexes: '^.*@[0-9a-f]+$', 'pinctrl-[0-9]+'
> 'qcom,spmi-iadc' was expected
> From schema: <snip>/Documentation/devicetree/bindings/mfd/qcom,spmi-
> pmic.yaml
>
> So while e.g. ref-vdd@15 would also work, adc-chan@15 is more correct.

The commit msg is not precise here. What the nodes are missing is unit
address (required by VADC bindings) and replace of underscore (coding
style). I think bindings do not require the adc-chan and we could apply
here rule from DT spec that node name should reflect it's
purpose/function, so die-temp@xxxx could be fine. Other places use
already adc-chan, so consistency could be an argument. But anyway commit
msg is not really describing why you are doing this.

Best regards,
Krzysztof