2021-04-09 12:49:32

by Mauro Carvalho Chehab

[permalink] [raw]
Subject: [PATCH v3 2/8] dt-bindings: fix references for iio-bindings.txt

The iio-bindings.txt was converted into two files and merged
at the dt-schema git tree at:

https://github.com/devicetree-org/dt-schema

Yet, some documents still refer to the old file. Fix their
references, in order to point to the right URL.

Fixes: dba91f82d580 ("dt-bindings:iio:iio-binding.txt Drop file as content now in dt-schema")
Acked-by: Jonathan Cameron <[email protected]>
Acked-by: Guenter Roeck <[email protected]>
Signed-off-by: Mauro Carvalho Chehab <[email protected]>
---
Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt | 2 +-
Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml | 5 +++--
Documentation/devicetree/bindings/input/adc-joystick.yaml | 4 +++-
.../bindings/input/touchscreen/resistive-adc-touch.txt | 5 ++++-
Documentation/devicetree/bindings/mfd/ab8500.txt | 4 +++-
5 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt b/Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt
index 37f18d684f6a..4c5c3712970e 100644
--- a/Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt
+++ b/Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt
@@ -32,7 +32,7 @@ Optional node properties:
- "#thermal-sensor-cells" Used to expose itself to thermal fw.

Read more about iio bindings at
- Documentation/devicetree/bindings/iio/iio-bindings.txt
+ https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/

Example:
ncp15wb473@0 {
diff --git a/Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml b/Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml
index 9f414dbdae86..433a3fb55a2e 100644
--- a/Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml
+++ b/Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml
@@ -14,8 +14,9 @@ description: >
Industrial I/O subsystem bindings for ADC controller found in
Ingenic JZ47xx SoCs.

- ADC clients must use the format described in iio-bindings.txt, giving
- a phandle and IIO specifier pair ("io-channels") to the ADC controller.
+ ADC clients must use the format described in
+ https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml,
+ giving a phandle and IIO specifier pair ("io-channels") to the ADC controller.

properties:
compatible:
diff --git a/Documentation/devicetree/bindings/input/adc-joystick.yaml b/Documentation/devicetree/bindings/input/adc-joystick.yaml
index 054406bbd22b..721878d5b7af 100644
--- a/Documentation/devicetree/bindings/input/adc-joystick.yaml
+++ b/Documentation/devicetree/bindings/input/adc-joystick.yaml
@@ -24,7 +24,9 @@ properties:
description: >
List of phandle and IIO specifier pairs.
Each pair defines one ADC channel to which a joystick axis is connected.
- See Documentation/devicetree/bindings/iio/iio-bindings.txt for details.
+ See
+ https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml
+ for details.

'#address-cells':
const: 1
diff --git a/Documentation/devicetree/bindings/input/touchscreen/resistive-adc-touch.txt b/Documentation/devicetree/bindings/input/touchscreen/resistive-adc-touch.txt
index fee0da12474e..af5223bb5bdd 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/resistive-adc-touch.txt
+++ b/Documentation/devicetree/bindings/input/touchscreen/resistive-adc-touch.txt
@@ -5,7 +5,10 @@ Required properties:
- compatible: must be "resistive-adc-touch"
The device must be connected to an ADC device that provides channels for
position measurement and optional pressure.
-Refer to Documentation/devicetree/bindings/iio/iio-bindings.txt for details
+Refer to
+https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml
+for details
+
- iio-channels: must have at least two channels connected to an ADC device.
These should correspond to the channels exposed by the ADC device and should
have the right index as the ADC device registers them. These channels
diff --git a/Documentation/devicetree/bindings/mfd/ab8500.txt b/Documentation/devicetree/bindings/mfd/ab8500.txt
index d2a6e835c257..937b3e5505e0 100644
--- a/Documentation/devicetree/bindings/mfd/ab8500.txt
+++ b/Documentation/devicetree/bindings/mfd/ab8500.txt
@@ -72,7 +72,9 @@ Required child device properties:
pwm|regulator|rtc|sysctrl|usb]";

A few child devices require ADC channels from the GPADC node. Those follow the
- standard bindings from iio/iio-bindings.txt and iio/adc/adc.txt
+ standard bindings from
+ https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml
+ and Documentation/devicetree/bindings/iio/adc/adc.yaml

abx500-temp : io-channels "aux1" and "aux2" for measuring external
temperatures.
--
2.30.2


2021-04-09 16:30:07

by Rob Herring

[permalink] [raw]
Subject: Re: [PATCH v3 2/8] dt-bindings: fix references for iio-bindings.txt

On Fri, Apr 9, 2021 at 7:48 AM Mauro Carvalho Chehab
<[email protected]> wrote:
>
> The iio-bindings.txt was converted into two files and merged
> at the dt-schema git tree at:
>
> https://github.com/devicetree-org/dt-schema
>
> Yet, some documents still refer to the old file. Fix their
> references, in order to point to the right URL.
>
> Fixes: dba91f82d580 ("dt-bindings:iio:iio-binding.txt Drop file as content now in dt-schema")
> Acked-by: Jonathan Cameron <[email protected]>
> Acked-by: Guenter Roeck <[email protected]>
> Signed-off-by: Mauro Carvalho Chehab <[email protected]>
> ---
> Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt | 2 +-
> Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml | 5 +++--
> Documentation/devicetree/bindings/input/adc-joystick.yaml | 4 +++-
> .../bindings/input/touchscreen/resistive-adc-touch.txt | 5 ++++-
> Documentation/devicetree/bindings/mfd/ab8500.txt | 4 +++-
> 5 files changed, 14 insertions(+), 6 deletions(-)
>
> diff --git a/Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt b/Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt
> index 37f18d684f6a..4c5c3712970e 100644
> --- a/Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt
> +++ b/Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt
> @@ -32,7 +32,7 @@ Optional node properties:
> - "#thermal-sensor-cells" Used to expose itself to thermal fw.
>
> Read more about iio bindings at
> - Documentation/devicetree/bindings/iio/iio-bindings.txt
> + https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/
>
> Example:
> ncp15wb473@0 {
> diff --git a/Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml b/Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml
> index 9f414dbdae86..433a3fb55a2e 100644
> --- a/Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml
> +++ b/Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml
> @@ -14,8 +14,9 @@ description: >
> Industrial I/O subsystem bindings for ADC controller found in
> Ingenic JZ47xx SoCs.
>
> - ADC clients must use the format described in iio-bindings.txt, giving
> - a phandle and IIO specifier pair ("io-channels") to the ADC controller.
> + ADC clients must use the format described in
> + https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml,
> + giving a phandle and IIO specifier pair ("io-channels") to the ADC controller.
>
> properties:
> compatible:
> diff --git a/Documentation/devicetree/bindings/input/adc-joystick.yaml b/Documentation/devicetree/bindings/input/adc-joystick.yaml
> index 054406bbd22b..721878d5b7af 100644
> --- a/Documentation/devicetree/bindings/input/adc-joystick.yaml
> +++ b/Documentation/devicetree/bindings/input/adc-joystick.yaml
> @@ -24,7 +24,9 @@ properties:
> description: >
> List of phandle and IIO specifier pairs.
> Each pair defines one ADC channel to which a joystick axis is connected.
> - See Documentation/devicetree/bindings/iio/iio-bindings.txt for details.
> + See
> + https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml
> + for details.

Please just drop this one. We don't need every user of a common
property to link to the common schema. If we do, then we should figure
out how to generate that (there are some json-schema to docs projects
I'd like to investigate some day).

>
> '#address-cells':
> const: 1
> diff --git a/Documentation/devicetree/bindings/input/touchscreen/resistive-adc-touch.txt b/Documentation/devicetree/bindings/input/touchscreen/resistive-adc-touch.txt
> index fee0da12474e..af5223bb5bdd 100644
> --- a/Documentation/devicetree/bindings/input/touchscreen/resistive-adc-touch.txt
> +++ b/Documentation/devicetree/bindings/input/touchscreen/resistive-adc-touch.txt
> @@ -5,7 +5,10 @@ Required properties:
> - compatible: must be "resistive-adc-touch"
> The device must be connected to an ADC device that provides channels for
> position measurement and optional pressure.
> -Refer to Documentation/devicetree/bindings/iio/iio-bindings.txt for details
> +Refer to
> +https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml
> +for details
> +
> - iio-channels: must have at least two channels connected to an ADC device.
> These should correspond to the channels exposed by the ADC device and should
> have the right index as the ADC device registers them. These channels
> diff --git a/Documentation/devicetree/bindings/mfd/ab8500.txt b/Documentation/devicetree/bindings/mfd/ab8500.txt
> index d2a6e835c257..937b3e5505e0 100644
> --- a/Documentation/devicetree/bindings/mfd/ab8500.txt
> +++ b/Documentation/devicetree/bindings/mfd/ab8500.txt
> @@ -72,7 +72,9 @@ Required child device properties:
> pwm|regulator|rtc|sysctrl|usb]";
>
> A few child devices require ADC channels from the GPADC node. Those follow the
> - standard bindings from iio/iio-bindings.txt and iio/adc/adc.txt
> + standard bindings from
> + https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml
> + and Documentation/devicetree/bindings/iio/adc/adc.yaml
>
> abx500-temp : io-channels "aux1" and "aux2" for measuring external
> temperatures.
> --
> 2.30.2
>

2021-04-09 19:19:35

by Rob Herring

[permalink] [raw]
Subject: Re: [PATCH v3 2/8] dt-bindings: fix references for iio-bindings.txt

On Fri, 09 Apr 2021 14:47:46 +0200, Mauro Carvalho Chehab wrote:
> The iio-bindings.txt was converted into two files and merged
> at the dt-schema git tree at:
>
> https://github.com/devicetree-org/dt-schema
>
> Yet, some documents still refer to the old file. Fix their
> references, in order to point to the right URL.
>
> Fixes: dba91f82d580 ("dt-bindings:iio:iio-binding.txt Drop file as content now in dt-schema")
> Acked-by: Jonathan Cameron <[email protected]>
> Acked-by: Guenter Roeck <[email protected]>
> Signed-off-by: Mauro Carvalho Chehab <[email protected]>
> ---
> Documentation/devicetree/bindings/hwmon/ntc_thermistor.txt | 2 +-
> Documentation/devicetree/bindings/iio/adc/ingenic,adc.yaml | 5 +++--
> Documentation/devicetree/bindings/input/adc-joystick.yaml | 4 +++-
> .../bindings/input/touchscreen/resistive-adc-touch.txt | 5 ++++-
> Documentation/devicetree/bindings/mfd/ab8500.txt | 4 +++-
> 5 files changed, 14 insertions(+), 6 deletions(-)
>

Applied, thanks!