2023-05-24 14:38:10

by Francesco Dolcini

[permalink] [raw]
Subject: [PATCH v1 1/5] dt-bindings: arm: ti: add toradex,verdin-am62 et al.

From: Francesco Dolcini <[email protected]>

Add toradex,verdin-am62 for Toradex Verdin AM62 SoM, its
nonwifi and wifi variants and the carrier boards (Dahlia,
Verdin Development Board and Yavia) they may be mated in.

Link: https://developer.toradex.com/hardware/verdin-som-family/modules/verdin-am62/
Link: https://www.toradex.com/computer-on-modules/verdin-arm-family/ti-am62
Signed-off-by: Francesco Dolcini <[email protected]>
---
.../devicetree/bindings/arm/ti/k3.yaml | 20 +++++++++++++++++++
1 file changed, 20 insertions(+)

diff --git a/Documentation/devicetree/bindings/arm/ti/k3.yaml b/Documentation/devicetree/bindings/arm/ti/k3.yaml
index e1183f90bb06..e3aee191d403 100644
--- a/Documentation/devicetree/bindings/arm/ti/k3.yaml
+++ b/Documentation/devicetree/bindings/arm/ti/k3.yaml
@@ -33,6 +33,26 @@ properties:
- ti,am62-lp-sk
- const: ti,am625

+ - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards
+ items:
+ - enum:
+ - toradex,verdin-am62-nonwifi-dahlia # Verdin AM62 Module on Dahlia
+ - toradex,verdin-am62-nonwifi-dev # Verdin AM62 Module on Verdin Development Board
+ - toradex,verdin-am62-nonwifi-yavia # Verdin AM62 Module on Yavia
+ - const: toradex,verdin-am62-nonwifi # Verdin AM62 Module without Wi-Fi / BT
+ - const: toradex,verdin-am62 # Verdin AM62 Module
+ - const: ti,am625
+
+ - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards with Wi-Fi / BT
+ items:
+ - enum:
+ - toradex,verdin-am62-wifi-dahlia # Verdin AM62 Wi-Fi / BT Module on Dahlia
+ - toradex,verdin-am62-wifi-dev # Verdin AM62 Wi-Fi / BT M. on Verdin Development B.
+ - toradex,verdin-am62-wifi-yavia # Verdin AM62 Wi-Fi / BT Module on Yavia
+ - const: toradex,verdin-am62-wifi # Verdin AM62 Wi-Fi / BT Module
+ - const: toradex,verdin-am62 # Verdin AM62 Module
+ - const: ti,am625
+
- description: K3 AM642 SoC
items:
- enum:
--
2.25.1



2023-05-24 17:57:55

by Andrew Davis

[permalink] [raw]
Subject: Re: [PATCH v1 1/5] dt-bindings: arm: ti: add toradex,verdin-am62 et al.

On 5/24/23 9:36 AM, Francesco Dolcini wrote:
> From: Francesco Dolcini <[email protected]>
>
> Add toradex,verdin-am62 for Toradex Verdin AM62 SoM, its
> nonwifi and wifi variants and the carrier boards (Dahlia,
> Verdin Development Board and Yavia) they may be mated in.
>
> Link: https://developer.toradex.com/hardware/verdin-som-family/modules/verdin-am62/
> Link: https://www.toradex.com/computer-on-modules/verdin-arm-family/ti-am62
> Signed-off-by: Francesco Dolcini <[email protected]>
> ---
> .../devicetree/bindings/arm/ti/k3.yaml | 20 +++++++++++++++++++
> 1 file changed, 20 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/arm/ti/k3.yaml b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> index e1183f90bb06..e3aee191d403 100644
> --- a/Documentation/devicetree/bindings/arm/ti/k3.yaml
> +++ b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> @@ -33,6 +33,26 @@ properties:
> - ti,am62-lp-sk
> - const: ti,am625
>
> + - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards
> + items:
> + - enum:
> + - toradex,verdin-am62-nonwifi-dahlia # Verdin AM62 Module on Dahlia
> + - toradex,verdin-am62-nonwifi-dev # Verdin AM62 Module on Verdin Development Board
> + - toradex,verdin-am62-nonwifi-yavia # Verdin AM62 Module on Yavia
> + - const: toradex,verdin-am62-nonwifi # Verdin AM62 Module without Wi-Fi / BT

Does this add anything? Not sure we need to split compatibles based on this, things
like wifi vs nowifi can be described in DT, same for different memory size models, etc..

In fact I'm not sure we get much value at all out of top level whole-SoC compatible
strings. Maybe we did when there was matching in kernel to do device specific fixups,
but that isn't really used much in ARM64.

Andrew

> + - const: toradex,verdin-am62 # Verdin AM62 Module
> + - const: ti,am625
> +
> + - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards with Wi-Fi / BT
> + items:
> + - enum:
> + - toradex,verdin-am62-wifi-dahlia # Verdin AM62 Wi-Fi / BT Module on Dahlia
> + - toradex,verdin-am62-wifi-dev # Verdin AM62 Wi-Fi / BT M. on Verdin Development B.
> + - toradex,verdin-am62-wifi-yavia # Verdin AM62 Wi-Fi / BT Module on Yavia
> + - const: toradex,verdin-am62-wifi # Verdin AM62 Wi-Fi / BT Module
> + - const: toradex,verdin-am62 # Verdin AM62 Module
> + - const: ti,am625
> +
> - description: K3 AM642 SoC
> items:
> - enum:

2023-05-24 19:37:08

by Francesco Dolcini

[permalink] [raw]
Subject: Re: [PATCH v1 1/5] dt-bindings: arm: ti: add toradex,verdin-am62 et al.

Hello Andrew,

On Wed, May 24, 2023 at 12:48:34PM -0500, Andrew Davis wrote:
> On 5/24/23 9:36 AM, Francesco Dolcini wrote:
> > From: Francesco Dolcini <[email protected]>
> >
> > Add toradex,verdin-am62 for Toradex Verdin AM62 SoM, its
> > nonwifi and wifi variants and the carrier boards (Dahlia,
> > Verdin Development Board and Yavia) they may be mated in.
> >
> > Link: https://developer.toradex.com/hardware/verdin-som-family/modules/verdin-am62/
> > Link: https://www.toradex.com/computer-on-modules/verdin-arm-family/ti-am62
> > Signed-off-by: Francesco Dolcini <[email protected]>
> > ---
> > .../devicetree/bindings/arm/ti/k3.yaml | 20 +++++++++++++++++++
> > 1 file changed, 20 insertions(+)
> >
> > diff --git a/Documentation/devicetree/bindings/arm/ti/k3.yaml b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> > index e1183f90bb06..e3aee191d403 100644
> > --- a/Documentation/devicetree/bindings/arm/ti/k3.yaml
> > +++ b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> > @@ -33,6 +33,26 @@ properties:
> > - ti,am62-lp-sk
> > - const: ti,am625
> > + - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards
> > + items:
> > + - enum:
> > + - toradex,verdin-am62-nonwifi-dahlia # Verdin AM62 Module on Dahlia
> > + - toradex,verdin-am62-nonwifi-dev # Verdin AM62 Module on Verdin Development Board
> > + - toradex,verdin-am62-nonwifi-yavia # Verdin AM62 Module on Yavia
> > + - const: toradex,verdin-am62-nonwifi # Verdin AM62 Module without Wi-Fi / BT
>
> Does this add anything? Not sure we need to split compatibles based on this, things
> like wifi vs nowifi can be described in DT, same for different memory size models, etc..
>
> In fact I'm not sure we get much value at all out of top level whole-SoC compatible
> strings. Maybe we did when there was matching in kernel to do device specific fixups,
> but that isn't really used much in ARM64.

This is useful, as an example, once you add DT overlays to the mix and
you use the compatible to match for "compatibility". An overlay could be
compatible with the SoC, with the SoM (module + SoC) or with the
complete board (Soc + SoM + carrier board).

Our system is modular and this is described with this multiple layer of
DT compatibles and with a similar layering of dtsi includes.

On the wifi vs non-wifi topic, that is IMO the most conflicting one, the
main reason is that the SoM has different assembly options, and this
affects the pinmux and the functionality available to the carrier, up to
the SoM edge connector (this could make an overlay compatible only with
a board with/without-wifi). As an example there is a SDIO interface
that is used for the on-SoM Wi-Fi in the Wi-Fi/BT variant, or available
on the edge connector otherwise. An overlay using this SDIO interface
would be compatible only with the non-wifi variant. Additional GPIOs or
other signals might have the exact same situations.

On this last variant (wifi vs non-wifi) I am not sure how often is used,
we have the exact same approach with multiple NXP i.MX based boards and it
proved itself to work fine.

Francesco


2023-05-24 19:40:53

by Conor Dooley

[permalink] [raw]
Subject: Re: [PATCH v1 1/5] dt-bindings: arm: ti: add toradex,verdin-am62 et al.

On Wed, May 24, 2023 at 04:36:27PM +0200, Francesco Dolcini wrote:
> From: Francesco Dolcini <[email protected]>
>
> Add toradex,verdin-am62 for Toradex Verdin AM62 SoM, its
> nonwifi and wifi variants and the carrier boards (Dahlia,
> Verdin Development Board and Yavia) they may be mated in.
>
> Link: https://developer.toradex.com/hardware/verdin-som-family/modules/verdin-am62/
> Link: https://www.toradex.com/computer-on-modules/verdin-arm-family/ti-am62
> Signed-off-by: Francesco Dolcini <[email protected]>

Seems fine to me, provided the platform maintainers are okay with it!
Reviewed-by: Conor Dooley <[email protected]>

Thanks,
Conor.

> ---
> .../devicetree/bindings/arm/ti/k3.yaml | 20 +++++++++++++++++++
> 1 file changed, 20 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/arm/ti/k3.yaml b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> index e1183f90bb06..e3aee191d403 100644
> --- a/Documentation/devicetree/bindings/arm/ti/k3.yaml
> +++ b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> @@ -33,6 +33,26 @@ properties:
> - ti,am62-lp-sk
> - const: ti,am625
>
> + - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards
> + items:
> + - enum:
> + - toradex,verdin-am62-nonwifi-dahlia # Verdin AM62 Module on Dahlia
> + - toradex,verdin-am62-nonwifi-dev # Verdin AM62 Module on Verdin Development Board
> + - toradex,verdin-am62-nonwifi-yavia # Verdin AM62 Module on Yavia
> + - const: toradex,verdin-am62-nonwifi # Verdin AM62 Module without Wi-Fi / BT
> + - const: toradex,verdin-am62 # Verdin AM62 Module
> + - const: ti,am625
> +
> + - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards with Wi-Fi / BT
> + items:
> + - enum:
> + - toradex,verdin-am62-wifi-dahlia # Verdin AM62 Wi-Fi / BT Module on Dahlia
> + - toradex,verdin-am62-wifi-dev # Verdin AM62 Wi-Fi / BT M. on Verdin Development B.
> + - toradex,verdin-am62-wifi-yavia # Verdin AM62 Wi-Fi / BT Module on Yavia
> + - const: toradex,verdin-am62-wifi # Verdin AM62 Wi-Fi / BT Module
> + - const: toradex,verdin-am62 # Verdin AM62 Module
> + - const: ti,am625
> +
> - description: K3 AM642 SoC
> items:
> - enum:
> --
> 2.25.1
>


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

2023-05-24 19:42:42

by Nishanth Menon

[permalink] [raw]
Subject: Re: [PATCH v1 1/5] dt-bindings: arm: ti: add toradex,verdin-am62 et al.

On 12:48-20230524, Andrew Davis wrote:

[..]

> In fact I'm not sure we get much value at all out of top level whole-SoC compatible
> strings. Maybe we did when there was matching in kernel to do device specific fixups,
> but that isn't really used much in ARM64.

If you are arguing about const: ti,am625 - there is a bunch more other
S/w systems that use compatibles for various purposes in addition to
usage in userspace (test systems etc) that benefit. Unless there is a
ARM64 wide trend to drop it, I don't see a reason to have a discussion
on that.

--
Regards,
Nishanth Menon
Key (0xDDB5849D1736249D) / Fingerprint: F8A2 8693 54EB 8232 17A3 1A34 DDB5 849D 1736 249D

2023-05-30 12:22:14

by Nishanth Menon

[permalink] [raw]
Subject: Re: [PATCH v1 1/5] dt-bindings: arm: ti: add toradex,verdin-am62 et al.

On 16:36-20230524, Francesco Dolcini wrote:
> From: Francesco Dolcini <[email protected]>
>
> Add toradex,verdin-am62 for Toradex Verdin AM62 SoM, its
> nonwifi and wifi variants and the carrier boards (Dahlia,
> Verdin Development Board and Yavia) they may be mated in.
>
> Link: https://developer.toradex.com/hardware/verdin-som-family/modules/verdin-am62/
> Link: https://www.toradex.com/computer-on-modules/verdin-arm-family/ti-am62
> Signed-off-by: Francesco Dolcini <[email protected]>
> ---
> .../devicetree/bindings/arm/ti/k3.yaml | 20 +++++++++++++++++++
> 1 file changed, 20 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/arm/ti/k3.yaml b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> index e1183f90bb06..e3aee191d403 100644
> --- a/Documentation/devicetree/bindings/arm/ti/k3.yaml
> +++ b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> @@ -33,6 +33,26 @@ properties:
> - ti,am62-lp-sk
> - const: ti,am625
>
> + - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards
> + items:
> + - enum:
> + - toradex,verdin-am62-nonwifi-dahlia # Verdin AM62 Module on Dahlia
> + - toradex,verdin-am62-nonwifi-dev # Verdin AM62 Module on Verdin Development Board
> + - toradex,verdin-am62-nonwifi-yavia # Verdin AM62 Module on Yavia

Does'nt one of these indicate the rest?

> + - const: toradex,verdin-am62-nonwifi # Verdin AM62 Module without Wi-Fi / BT
> + - const: toradex,verdin-am62 # Verdin AM62 Module
> + - const: ti,am625
> +
> + - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards with Wi-Fi / BT
> + items:
> + - enum:
> + - toradex,verdin-am62-wifi-dahlia # Verdin AM62 Wi-Fi / BT Module on Dahlia
> + - toradex,verdin-am62-wifi-dev # Verdin AM62 Wi-Fi / BT M. on Verdin Development B.
> + - toradex,verdin-am62-wifi-yavia # Verdin AM62 Wi-Fi / BT Module on Yavia

Same?

> + - const: toradex,verdin-am62-wifi # Verdin AM62 Wi-Fi / BT Module
> + - const: toradex,verdin-am62 # Verdin AM62 Module
> + - const: ti,am625
> +
> - description: K3 AM642 SoC
> items:
> - enum:
> --
> 2.25.1
>

--
Regards,
Nishanth Menon
Key (0xDDB5849D1736249D) / Fingerprint: F8A2 8693 54EB 8232 17A3 1A34 DDB5 849D 1736 249D

2023-05-30 17:10:28

by Francesco Dolcini

[permalink] [raw]
Subject: Re: [PATCH v1 1/5] dt-bindings: arm: ti: add toradex,verdin-am62 et al.

On Tue, May 30, 2023 at 07:12:31AM -0500, Nishanth Menon wrote:
> On 16:36-20230524, Francesco Dolcini wrote:
> > From: Francesco Dolcini <[email protected]>
> >
> > Add toradex,verdin-am62 for Toradex Verdin AM62 SoM, its
> > nonwifi and wifi variants and the carrier boards (Dahlia,
> > Verdin Development Board and Yavia) they may be mated in.
> >
> > Link: https://developer.toradex.com/hardware/verdin-som-family/modules/verdin-am62/
> > Link: https://www.toradex.com/computer-on-modules/verdin-arm-family/ti-am62
> > Signed-off-by: Francesco Dolcini <[email protected]>
> > ---
> > .../devicetree/bindings/arm/ti/k3.yaml | 20 +++++++++++++++++++
> > 1 file changed, 20 insertions(+)
> >
> > diff --git a/Documentation/devicetree/bindings/arm/ti/k3.yaml b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> > index e1183f90bb06..e3aee191d403 100644
> > --- a/Documentation/devicetree/bindings/arm/ti/k3.yaml
> > +++ b/Documentation/devicetree/bindings/arm/ti/k3.yaml
> > @@ -33,6 +33,26 @@ properties:
> > - ti,am62-lp-sk
> > - const: ti,am625
> >
> > + - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards
> > + items:
> > + - enum:
> > + - toradex,verdin-am62-nonwifi-dahlia # Verdin AM62 Module on Dahlia
> > + - toradex,verdin-am62-nonwifi-dev # Verdin AM62 Module on Verdin Development Board
> > + - toradex,verdin-am62-nonwifi-yavia # Verdin AM62 Module on Yavia
>
> Does'nt one of these indicate the rest?

Strictly speaking it does.

However it's convenient to have a tuple with more generic compatible
afterward.

I tried to explain some of the reasoning for that on this email [1].

More in general this tuple of compatible is matching how the actual system
is layered (SoC -> base SoM -> SoM variant -> carrier board) that is
also reflected on the dtsi include hierarchy.

FWIW, this is the standard approach you can see on fsl.yaml, where such
kind of modular system are pretty much standard.

[1] https://lore.kernel.org/all/ZG5jYV%[email protected]/

Francesco


2023-05-31 08:37:51

by Krzysztof Kozlowski

[permalink] [raw]
Subject: Re: [PATCH v1 1/5] dt-bindings: arm: ti: add toradex,verdin-am62 et al.

On 24/05/2023 19:48, Andrew Davis wrote:
> On 5/24/23 9:36 AM, Francesco Dolcini wrote:
>> From: Francesco Dolcini <[email protected]>
>>
>> Add toradex,verdin-am62 for Toradex Verdin AM62 SoM, its
>> nonwifi and wifi variants and the carrier boards (Dahlia,
>> Verdin Development Board and Yavia) they may be mated in.
>>
>> Link: https://developer.toradex.com/hardware/verdin-som-family/modules/verdin-am62/
>> Link: https://www.toradex.com/computer-on-modules/verdin-arm-family/ti-am62
>> Signed-off-by: Francesco Dolcini <[email protected]>
>> ---
>> .../devicetree/bindings/arm/ti/k3.yaml | 20 +++++++++++++++++++
>> 1 file changed, 20 insertions(+)
>>
>> diff --git a/Documentation/devicetree/bindings/arm/ti/k3.yaml b/Documentation/devicetree/bindings/arm/ti/k3.yaml
>> index e1183f90bb06..e3aee191d403 100644
>> --- a/Documentation/devicetree/bindings/arm/ti/k3.yaml
>> +++ b/Documentation/devicetree/bindings/arm/ti/k3.yaml
>> @@ -33,6 +33,26 @@ properties:
>> - ti,am62-lp-sk
>> - const: ti,am625
>>
>> + - description: K3 AM62x SoC Toradex Verdin Modules and Carrier Boards
>> + items:
>> + - enum:
>> + - toradex,verdin-am62-nonwifi-dahlia # Verdin AM62 Module on Dahlia
>> + - toradex,verdin-am62-nonwifi-dev # Verdin AM62 Module on Verdin Development Board
>> + - toradex,verdin-am62-nonwifi-yavia # Verdin AM62 Module on Yavia
>> + - const: toradex,verdin-am62-nonwifi # Verdin AM62 Module without Wi-Fi / BT
>
> Does this add anything? Not sure we need to split compatibles based on this, things
> like wifi vs nowifi can be described in DT, same for different memory size models, etc..
>
> In fact I'm not sure we get much value at all out of top level whole-SoC compatible
> strings. Maybe we did when there was matching in kernel to do device specific fixups,
> but that isn't really used much in ARM64.

If I understand correctly, this is different SoM, so different hardware.
It is fine to have different board compatibles, because you will have
two different DTS.

Best regards,
Krzysztof