2024-05-10 21:04:54

by David Lechner

[permalink] [raw]
Subject: [PATCH] dt-bindings: iio: adc: adi,axi-adc: tweak example node name

It is always recommended to use generic node names for devicetree nodes.
The documentation [1] of the AXI ADC IP core says "The most important
part of the core is the Receiver PHY module.", so using phy as the node
name seems appropriate.

[1]: https://wiki.analog.com/resources/fpga/docs/axi_adc_ip

Signed-off-by: David Lechner <[email protected]>
---
Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml b/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
index e1f450b80db2..9cad4c439045 100644
--- a/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
+++ b/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
@@ -57,7 +57,7 @@ additionalProperties: false

examples:
- |
- axi-adc@44a00000 {
+ phy@44a00000 {
compatible = "adi,axi-adc-10.0.a";
reg = <0x44a00000 0x10000>;
dmas = <&rx_dma 0>;

---
base-commit: 5e3c5871138da700796587aa5f096d39135f9d36
change-id: 20240510-b4-iio-axi-adc-dt-binding-tweak-054f97a78bff



2024-05-11 13:00:54

by Conor Dooley

[permalink] [raw]
Subject: Re: [PATCH] dt-bindings: iio: adc: adi,axi-adc: tweak example node name

On Fri, May 10, 2024 at 04:04:38PM -0500, David Lechner wrote:
> It is always recommended to use generic node names for devicetree nodes.
> The documentation [1] of the AXI ADC IP core says "The most important
> part of the core is the Receiver PHY module.", so using phy as the node
> name seems appropriate.
>
> [1]: https://wiki.analog.com/resources/fpga/docs/axi_adc_ip
>
> Signed-off-by: David Lechner <[email protected]>

Acked-by: Conor Dooley <[email protected]>

Cheers,
Conor.


Attachments:
(No filename) (516.00 B)
signature.asc (235.00 B)
Download all attachments

2024-05-12 11:53:15

by Jonathan Cameron

[permalink] [raw]
Subject: Re: [PATCH] dt-bindings: iio: adc: adi,axi-adc: tweak example node name

On Sat, 11 May 2024 14:00:40 +0100
Conor Dooley <[email protected]> wrote:

> On Fri, May 10, 2024 at 04:04:38PM -0500, David Lechner wrote:
> > It is always recommended to use generic node names for devicetree nodes.
> > The documentation [1] of the AXI ADC IP core says "The most important
> > part of the core is the Receiver PHY module.", so using phy as the node
> > name seems appropriate.
> >
> > [1]: https://wiki.analog.com/resources/fpga/docs/axi_adc_ip
> >
> > Signed-off-by: David Lechner <[email protected]>
>
> Acked-by: Conor Dooley <[email protected]>
>
Sure, I guess phy is sort of applicable here.

Applied,

> Cheers,
> Conor.


2024-05-13 14:19:17

by Rob Herring (Arm)

[permalink] [raw]
Subject: Re: [PATCH] dt-bindings: iio: adc: adi,axi-adc: tweak example node name

On Fri, May 10, 2024 at 04:04:38PM -0500, David Lechner wrote:
> It is always recommended to use generic node names for devicetree nodes.
> The documentation [1] of the AXI ADC IP core says "The most important
> part of the core is the Receiver PHY module.", so using phy as the node
> name seems appropriate.
>
> [1]: https://wiki.analog.com/resources/fpga/docs/axi_adc_ip
>
> Signed-off-by: David Lechner <[email protected]>
> ---
> Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml b/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
> index e1f450b80db2..9cad4c439045 100644
> --- a/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
> +++ b/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
> @@ -57,7 +57,7 @@ additionalProperties: false
>
> examples:
> - |
> - axi-adc@44a00000 {
> + phy@44a00000 {

phy should be used when there's #phy-cells which is not the case here.
'adc' is somewhat standard. Or maybe it should be tied to
#io-backend-cells.

Until we have something defined as ti what it should be, we should just
leave node names alone.

Rob

2024-05-19 17:41:41

by Jonathan Cameron

[permalink] [raw]
Subject: Re: [PATCH] dt-bindings: iio: adc: adi,axi-adc: tweak example node name

On Mon, 13 May 2024 09:19:06 -0500
Rob Herring <[email protected]> wrote:

> On Fri, May 10, 2024 at 04:04:38PM -0500, David Lechner wrote:
> > It is always recommended to use generic node names for devicetree nodes.
> > The documentation [1] of the AXI ADC IP core says "The most important
> > part of the core is the Receiver PHY module.", so using phy as the node
> > name seems appropriate.
> >
> > [1]: https://wiki.analog.com/resources/fpga/docs/axi_adc_ip
> >
> > Signed-off-by: David Lechner <[email protected]>
> > ---
> > Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml | 2 +-
> > 1 file changed, 1 insertion(+), 1 deletion(-)
> >
> > diff --git a/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml b/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
> > index e1f450b80db2..9cad4c439045 100644
> > --- a/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
> > +++ b/Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
> > @@ -57,7 +57,7 @@ additionalProperties: false
> >
> > examples:
> > - |
> > - axi-adc@44a00000 {
> > + phy@44a00000 {
>
> phy should be used when there's #phy-cells which is not the case here.
> 'adc' is somewhat standard. Or maybe it should be tied to
> #io-backend-cells.
>
> Until we have something defined as ti what it should be, we should just
> leave node names alone.
>
> Rob
>
Unapplied.