[PATCH v2 1/2] dt-bindings: iio: adc: Require generic adc-chan name for channel nodes

From: Marijn Suijten
Date: Thu Jan 19 2023 - 16:41:37 EST


As discussed in [1] it is more convenient to use a generic adc-chan node
name for ADC channels while storing a friendly - board-specific instead
of PMIC-specific - name in the label, if/when desired to overwrite the
channel description already contained (but previously unused) in the
driver [2].

Replace the .* name pattern with the adc-chan literal, but leave the
label property optional for bindings to choose to fall back a channel
label hardcoded in the driver [2] instead.

[1]: https://lore.kernel.org/linux-arm-msm/20221106193018.270106-1-marijn.suijten@xxxxxxxxxxxxxx/T/#u
[2]: https://lore.kernel.org/linux-arm-msm/20230116220909.196926-4-marijn.suijten@xxxxxxxxxxxxxx/

Signed-off-by: Marijn Suijten <marijn.suijten@xxxxxxxxxxxxxx>
---
.../bindings/iio/adc/qcom,spmi-vadc.yaml | 16 +++++++++-------
1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/Documentation/devicetree/bindings/iio/adc/qcom,spmi-vadc.yaml b/Documentation/devicetree/bindings/iio/adc/qcom,spmi-vadc.yaml
index bd6e0d6f6e0c..9b1a60fe7599 100644
--- a/Documentation/devicetree/bindings/iio/adc/qcom,spmi-vadc.yaml
+++ b/Documentation/devicetree/bindings/iio/adc/qcom,spmi-vadc.yaml
@@ -54,7 +54,7 @@ required:
- '#io-channel-cells'

patternProperties:
- "^.*@[0-9a-f]+$":
+ "^adc-chan@[0-9a-f]+$":
type: object
additionalProperties: false
description: |
@@ -148,7 +148,7 @@ allOf:

then:
patternProperties:
- "^.*@[0-9a-f]+$":
+ "^adc-chan@[0-9a-f]+$":
properties:
qcom,decimation:
enum: [ 512, 1024, 2048, 4096 ]
@@ -171,7 +171,7 @@ allOf:

then:
patternProperties:
- "^.*@[0-9a-f]+$":
+ "^adc-chan@[0-9a-f]+$":
properties:
qcom,decimation:
enum: [ 256, 512, 1024 ]
@@ -194,7 +194,7 @@ allOf:

then:
patternProperties:
- "^.*@[0-9a-f]+$":
+ "^adc-chan@[0-9a-f]+$":
properties:
qcom,decimation:
enum: [ 250, 420, 840 ]
@@ -217,7 +217,7 @@ allOf:

then:
patternProperties:
- "^.*@[0-9a-f]+$":
+ "^adc-chan@[0-9a-f]+$":
properties:
qcom,decimation:
enum: [ 85, 340, 1360 ]
@@ -292,16 +292,18 @@ examples:
#io-channel-cells = <1>;

/* Other properties are omitted */
- xo-therm@44 {
+ adc-chan@44 {
reg = <PMK8350_ADC7_AMUX_THM1_100K_PU>;
qcom,ratiometric;
qcom,hw-settle-time = <200>;
+ label = "xo_therm";
};

- conn-therm@47 {
+ adc-chan@47 {
reg = <PM8350_ADC7_AMUX_THM4_100K_PU(1)>;
qcom,ratiometric;
qcom,hw-settle-time = <200>;
+ label = "conn_therm";
};
};
};
--
2.39.1