diff mbox series

[2/4] dt-bindings: tegra: Document Jetson Orin Nano

Message ID 20230331163159.17145-2-thierry.reding@gmail.com (mailing list archive)
State New, archived
Headers show
Series [1/4] dt-bindings: Document additional Jetson Orin NX SKUs | expand

Commit Message

Thierry Reding March 31, 2023, 4:31 p.m. UTC
From: Thierry Reding <treding@nvidia.com>

The Jetson Orin Nano is the little sibling of the Jetson Orin NX.
Document the corresponding compatible strings for these devices.

Signed-off-by: Thierry Reding <treding@nvidia.com>
---
 Documentation/devicetree/bindings/arm/tegra.yaml | 7 +++++++
 1 file changed, 7 insertions(+)

Comments

Krzysztof Kozlowski March 31, 2023, 8:20 p.m. UTC | #1
On 31/03/2023 18:31, Thierry Reding wrote:
> From: Thierry Reding <treding@nvidia.com>
> 
> The Jetson Orin Nano is the little sibling of the Jetson Orin NX.
> Document the corresponding compatible strings for these devices.
> 
> Signed-off-by: Thierry Reding <treding@nvidia.com>
> ---
>  Documentation/devicetree/bindings/arm/tegra.yaml | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/arm/tegra.yaml b/Documentation/devicetree/bindings/arm/tegra.yaml
> index 61e638c9cad7..60c151da5e06 100644
> --- a/Documentation/devicetree/bindings/arm/tegra.yaml
> +++ b/Documentation/devicetree/bindings/arm/tegra.yaml
> @@ -220,6 +220,13 @@ properties:
>                - nvidia,p3767-0001
>                - nvidia,p3767-0002
>            - const: nvidia,tegra234
> +      - description: Jetson Orin Nano
> +        items:
> +          - enum:
> +              - nvidia,p3767-0003
> +              - nvidia,p3767-0004
> +              - nvidia,p3767-0005

Similar questions as for patch #1. Where are the DTSes? Where are the
differences? If we keep documenting every SKU which is the same from
user/OS perspective, this list would grow crazy.

Best regards,
Krzysztof
Thierry Reding April 4, 2023, 10:59 a.m. UTC | #2
On Fri, Mar 31, 2023 at 10:20:16PM +0200, Krzysztof Kozlowski wrote:
> On 31/03/2023 18:31, Thierry Reding wrote:
> > From: Thierry Reding <treding@nvidia.com>
> > 
> > The Jetson Orin Nano is the little sibling of the Jetson Orin NX.
> > Document the corresponding compatible strings for these devices.
> > 
> > Signed-off-by: Thierry Reding <treding@nvidia.com>
> > ---
> >  Documentation/devicetree/bindings/arm/tegra.yaml | 7 +++++++
> >  1 file changed, 7 insertions(+)
> > 
> > diff --git a/Documentation/devicetree/bindings/arm/tegra.yaml b/Documentation/devicetree/bindings/arm/tegra.yaml
> > index 61e638c9cad7..60c151da5e06 100644
> > --- a/Documentation/devicetree/bindings/arm/tegra.yaml
> > +++ b/Documentation/devicetree/bindings/arm/tegra.yaml
> > @@ -220,6 +220,13 @@ properties:
> >                - nvidia,p3767-0001
> >                - nvidia,p3767-0002
> >            - const: nvidia,tegra234
> > +      - description: Jetson Orin Nano
> > +        items:
> > +          - enum:
> > +              - nvidia,p3767-0003
> > +              - nvidia,p3767-0004
> > +              - nvidia,p3767-0005
> 
> Similar questions as for patch #1. Where are the DTSes? Where are the
> differences? If we keep documenting every SKU which is the same from
> user/OS perspective, this list would grow crazy.

Most of the differences will be user-noticeable, even if they can be
runtime detected. Besides the mentioned differences in DRAM size, things
like the number of CPUs, GPU compute units or video encoders/decoders
can vary depending on the SKU. While the OS should certainly be able to
abstract all of that away as best as possible, on user may still end up
with SKU 3 and another with SKU 5 and it's important for people to know
what they have.

So I think we have to find a way to both keep things simple from a DTS
point of view (as I said, we should be able to make do with one DTS file
for the Jetson Orin NX and one for the Jetson Orin Nano with UEFI taking
care of fixing up the DTS per SKU), and not lying to users. If users get
a SKU 3, then that's what we should report instead of 3 (or whatever
ends up being the SKU that we use in the DTS).

So I want to be as complete as possible in documenting these so that
when people go look for the part numbers, they can at least find some
reference to them.

Thierry
Thierry Reding April 4, 2023, 11:03 a.m. UTC | #3
On Fri, Mar 31, 2023 at 10:20:16PM +0200, Krzysztof Kozlowski wrote:
> On 31/03/2023 18:31, Thierry Reding wrote:
> > From: Thierry Reding <treding@nvidia.com>
> > 
> > The Jetson Orin Nano is the little sibling of the Jetson Orin NX.
> > Document the corresponding compatible strings for these devices.
> > 
> > Signed-off-by: Thierry Reding <treding@nvidia.com>
> > ---
> >  Documentation/devicetree/bindings/arm/tegra.yaml | 7 +++++++
> >  1 file changed, 7 insertions(+)
> > 
> > diff --git a/Documentation/devicetree/bindings/arm/tegra.yaml b/Documentation/devicetree/bindings/arm/tegra.yaml
> > index 61e638c9cad7..60c151da5e06 100644
> > --- a/Documentation/devicetree/bindings/arm/tegra.yaml
> > +++ b/Documentation/devicetree/bindings/arm/tegra.yaml
> > @@ -220,6 +220,13 @@ properties:
> >                - nvidia,p3767-0001
> >                - nvidia,p3767-0002
> >            - const: nvidia,tegra234
> > +      - description: Jetson Orin Nano
> > +        items:
> > +          - enum:
> > +              - nvidia,p3767-0003
> > +              - nvidia,p3767-0004
> > +              - nvidia,p3767-0005
> 
> Similar questions as for patch #1. Where are the DTSes? Where are the
> differences? If we keep documenting every SKU which is the same from
> user/OS perspective, this list would grow crazy.

As for the concern of this list growing crazy: as far as I know it's
complete after this. I'm not aware of any other SKUs being planned for
the future. Obviously that could always change, but again, I think there
is some advantage in being as complete as possible when documenting
these, otherwise someone will eventually come across a SKU that's not
documented and be easily confused.

Thierry
Krzysztof Kozlowski April 7, 2023, 8:59 a.m. UTC | #4
On 04/04/2023 12:59, Thierry Reding wrote:
> On Fri, Mar 31, 2023 at 10:20:16PM +0200, Krzysztof Kozlowski wrote:
>> On 31/03/2023 18:31, Thierry Reding wrote:
>>> From: Thierry Reding <treding@nvidia.com>
>>>
>>> The Jetson Orin Nano is the little sibling of the Jetson Orin NX.
>>> Document the corresponding compatible strings for these devices.
>>>
>>> Signed-off-by: Thierry Reding <treding@nvidia.com>
>>> ---
>>>  Documentation/devicetree/bindings/arm/tegra.yaml | 7 +++++++
>>>  1 file changed, 7 insertions(+)
>>>
>>> diff --git a/Documentation/devicetree/bindings/arm/tegra.yaml b/Documentation/devicetree/bindings/arm/tegra.yaml
>>> index 61e638c9cad7..60c151da5e06 100644
>>> --- a/Documentation/devicetree/bindings/arm/tegra.yaml
>>> +++ b/Documentation/devicetree/bindings/arm/tegra.yaml
>>> @@ -220,6 +220,13 @@ properties:
>>>                - nvidia,p3767-0001
>>>                - nvidia,p3767-0002
>>>            - const: nvidia,tegra234
>>> +      - description: Jetson Orin Nano
>>> +        items:
>>> +          - enum:
>>> +              - nvidia,p3767-0003
>>> +              - nvidia,p3767-0004
>>> +              - nvidia,p3767-0005
>>
>> Similar questions as for patch #1. Where are the DTSes? Where are the
>> differences? If we keep documenting every SKU which is the same from
>> user/OS perspective, this list would grow crazy.
> 
> Most of the differences will be user-noticeable, even if they can be
> runtime detected. Besides the mentioned differences in DRAM size, things
> like the number of CPUs, 

You need different DTS for different number of CPUs. It's not the case
we talk here.

> GPU compute units or video encoders/decoders

I would argue that for these as well you will have different DTS.

> can vary depending on the SKU. While the OS should certainly be able to
> abstract all of that away as best as possible, on user may still end up
> with SKU 3 and another with SKU 5 and it's important for people to know
> what they have.

Depends. They know what do they have. If the DTS is the same, then it is
apparently not important to know what do they have because it is all
"the same" (in a compatible meaning).

> 
> So I think we have to find a way to both keep things simple from a DTS
> point of view (as I said, we should be able to make do with one DTS file
> for the Jetson Orin NX and one for the Jetson Orin Nano with UEFI taking
> care of fixing up the DTS per SKU), and not lying to users. If users get
> a SKU 3, then that's what we should report instead of 3 (or whatever
> ends up being the SKU that we use in the DTS).
> 
> So I want to be as complete as possible in documenting these so that
> when people go look for the part numbers, they can at least find some
> reference to them.

To Chromium guys I need to spend effort to ask to document at least
something, as they claim any board compatible bindings are useless for
them. It's one border case.

Here, I need to bring it to the middle from another side and border case
- documenting many unneeded compatibles which do not exist in DTS.

It would be much easier if you folks get together and exchange
arguments, not through me. :)

Let me be clear then for this case:
We do not document compatibles for stuff somewhere out-of-tree, just
because it is there or you want it to be there. We document the stuff in
the kernel or other SW projects.

Best regards,
Krzysztof
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/arm/tegra.yaml b/Documentation/devicetree/bindings/arm/tegra.yaml
index 61e638c9cad7..60c151da5e06 100644
--- a/Documentation/devicetree/bindings/arm/tegra.yaml
+++ b/Documentation/devicetree/bindings/arm/tegra.yaml
@@ -220,6 +220,13 @@  properties:
               - nvidia,p3767-0001
               - nvidia,p3767-0002
           - const: nvidia,tegra234
+      - description: Jetson Orin Nano
+        items:
+          - enum:
+              - nvidia,p3767-0003
+              - nvidia,p3767-0004
+              - nvidia,p3767-0005
+          - const: nvidia,tegra234
       - description: Jetson Orin NX Engineering Reference Developer Kit
         items:
           - const: nvidia,p3768-0000+p3767-0000