public inbox for devicetree@vger.kernel.org
 help / color / mirror / Atom feed
* [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
@ 2026-05-06  9:01 Robby Cai
  2026-05-06 11:20 ` Laurent Pinchart
  2026-05-06 13:33 ` Krzysztof Kozlowski
  0 siblings, 2 replies; 7+ messages in thread
From: Robby Cai @ 2026-05-06  9:01 UTC (permalink / raw)
  To: laurent.pinchart, Frank.Li, martink, rmfrfs, kernel, mchehab,
	robh, krzk+dt, conor+dt, s.hauer, kernel, festevam,
	martin.kepplinger
  Cc: imx, linux-media, devicetree, linux-arm-kernel, linux-kernel

The example in imx8mq-mipi-csi2.yaml uses imx8mm_mipi_csi_{in,out} endpoint
labels, which is confusing for an i.MX8MQ binding. Rename the labels to
imx8mq_mipi_csi_{in,out} for consistency.

Fixes: 37255747ecbd ("media: dt-bindings: media: document the nxp,imx8mq-mipi-csi2 receiver phy and controller")
Signed-off-by: Robby Cai <robby.cai@nxp.com>
---
 .../devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
index 4fcfc4fd3565..71f79651dd96 100644
--- a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
+++ b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
@@ -220,7 +220,7 @@ examples:
             port@0 {
                 reg = <0>;
 
-                imx8mm_mipi_csi_in: endpoint {
+                imx8mq_mipi_csi_in: endpoint {
                     remote-endpoint = <&imx477_out>;
                     data-lanes = <1 2 3 4>;
                 };
@@ -229,7 +229,7 @@ examples:
             port@1 {
                 reg = <1>;
 
-                imx8mm_mipi_csi_out: endpoint {
+                imx8mq_mipi_csi_out: endpoint {
                     remote-endpoint = <&csi_in>;
                 };
             };
-- 
2.37.1


^ permalink raw reply related	[flat|nested] 7+ messages in thread

* Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
  2026-05-06  9:01 [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo Robby Cai
@ 2026-05-06 11:20 ` Laurent Pinchart
  2026-05-06 13:33 ` Krzysztof Kozlowski
  1 sibling, 0 replies; 7+ messages in thread
From: Laurent Pinchart @ 2026-05-06 11:20 UTC (permalink / raw)
  To: Robby Cai
  Cc: Frank.Li, martink, rmfrfs, kernel, mchehab, robh, krzk+dt,
	conor+dt, s.hauer, kernel, festevam, martin.kepplinger, imx,
	linux-media, devicetree, linux-arm-kernel, linux-kernel

Hi Robby,

Thank you for the patch.

On Wed, May 06, 2026 at 05:01:24PM +0800, Robby Cai wrote:
> The example in imx8mq-mipi-csi2.yaml uses imx8mm_mipi_csi_{in,out} endpoint
> labels, which is confusing for an i.MX8MQ binding. Rename the labels to
> imx8mq_mipi_csi_{in,out} for consistency.
> 
> Fixes: 37255747ecbd ("media: dt-bindings: media: document the nxp,imx8mq-mipi-csi2 receiver phy and controller")
> Signed-off-by: Robby Cai <robby.cai@nxp.com>

Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

> ---
>  .../devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml       | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> index 4fcfc4fd3565..71f79651dd96 100644
> --- a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> +++ b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> @@ -220,7 +220,7 @@ examples:
>              port@0 {
>                  reg = <0>;
>  
> -                imx8mm_mipi_csi_in: endpoint {
> +                imx8mq_mipi_csi_in: endpoint {
>                      remote-endpoint = <&imx477_out>;
>                      data-lanes = <1 2 3 4>;
>                  };
> @@ -229,7 +229,7 @@ examples:
>              port@1 {
>                  reg = <1>;
>  
> -                imx8mm_mipi_csi_out: endpoint {
> +                imx8mq_mipi_csi_out: endpoint {
>                      remote-endpoint = <&csi_in>;
>                  };
>              };

-- 
Regards,

Laurent Pinchart

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
  2026-05-06  9:01 [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo Robby Cai
  2026-05-06 11:20 ` Laurent Pinchart
@ 2026-05-06 13:33 ` Krzysztof Kozlowski
  2026-05-06 14:21   ` Laurent Pinchart
  1 sibling, 1 reply; 7+ messages in thread
From: Krzysztof Kozlowski @ 2026-05-06 13:33 UTC (permalink / raw)
  To: Robby Cai, laurent.pinchart, Frank.Li, martink, rmfrfs, kernel,
	mchehab, robh, krzk+dt, conor+dt, s.hauer, kernel, festevam,
	martin.kepplinger
  Cc: imx, linux-media, devicetree, linux-arm-kernel, linux-kernel

On 06/05/2026 11:01, Robby Cai wrote:
> The example in imx8mq-mipi-csi2.yaml uses imx8mm_mipi_csi_{in,out} endpoint
> labels, which is confusing for an i.MX8MQ binding. Rename the labels to
> imx8mq_mipi_csi_{in,out} for consistency.
> 
> Fixes: 37255747ecbd ("media: dt-bindings: media: document the nxp,imx8mq-mipi-csi2 receiver phy and controller")

Nothing to fix here. Otherwise explain the bug.

> Signed-off-by: Robby Cai <robby.cai@nxp.com>
> ---
>  .../devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml       | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> index 4fcfc4fd3565..71f79651dd96 100644
> --- a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> +++ b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> @@ -220,7 +220,7 @@ examples:
>              port@0 {
>                  reg = <0>;
>  
> -                imx8mm_mipi_csi_in: endpoint {
> +                imx8mq_mipi_csi_in: endpoint {

Drop the labels instead - they are not used.

This is just churn and for sure not a fix.

NAK


Best regards,
Krzysztof

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
  2026-05-06 13:33 ` Krzysztof Kozlowski
@ 2026-05-06 14:21   ` Laurent Pinchart
  2026-05-06 14:24     ` Krzysztof Kozlowski
  0 siblings, 1 reply; 7+ messages in thread
From: Laurent Pinchart @ 2026-05-06 14:21 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Robby Cai, Frank.Li, martink, rmfrfs, kernel, mchehab, robh,
	krzk+dt, conor+dt, s.hauer, kernel, festevam, martin.kepplinger,
	imx, linux-media, devicetree, linux-arm-kernel, linux-kernel

On Wed, May 06, 2026 at 03:33:57PM +0200, Krzysztof Kozlowski wrote:
> On 06/05/2026 11:01, Robby Cai wrote:
> > The example in imx8mq-mipi-csi2.yaml uses imx8mm_mipi_csi_{in,out} endpoint
> > labels, which is confusing for an i.MX8MQ binding. Rename the labels to
> > imx8mq_mipi_csi_{in,out} for consistency.
> > 
> > Fixes: 37255747ecbd ("media: dt-bindings: media: document the nxp,imx8mq-mipi-csi2 receiver phy and controller")
> 
> Nothing to fix here. Otherwise explain the bug.
> 
> > Signed-off-by: Robby Cai <robby.cai@nxp.com>
> > ---
> >  .../devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml       | 4 ++--
> >  1 file changed, 2 insertions(+), 2 deletions(-)
> > 
> > diff --git a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> > index 4fcfc4fd3565..71f79651dd96 100644
> > --- a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> > +++ b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> > @@ -220,7 +220,7 @@ examples:
> >              port@0 {
> >                  reg = <0>;
> >  
> > -                imx8mm_mipi_csi_in: endpoint {
> > +                imx8mq_mipi_csi_in: endpoint {
> 
> Drop the labels instead - they are not used.

I think the label has value, it improves readability of the example by
making the purpose of the endpoints more explicit. I won't fight for it
though, I know it's hard to change your mind.

> This is just churn and for sure not a fix.
> 
> NAK

-- 
Regards,

Laurent Pinchart

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
  2026-05-06 14:21   ` Laurent Pinchart
@ 2026-05-06 14:24     ` Krzysztof Kozlowski
  2026-05-06 14:30       ` Laurent Pinchart
  0 siblings, 1 reply; 7+ messages in thread
From: Krzysztof Kozlowski @ 2026-05-06 14:24 UTC (permalink / raw)
  To: Laurent Pinchart
  Cc: Robby Cai, Frank.Li, martink, rmfrfs, kernel, mchehab, robh,
	krzk+dt, conor+dt, s.hauer, kernel, festevam, martin.kepplinger,
	imx, linux-media, devicetree, linux-arm-kernel, linux-kernel

On 06/05/2026 16:21, Laurent Pinchart wrote:
> On Wed, May 06, 2026 at 03:33:57PM +0200, Krzysztof Kozlowski wrote:
>> On 06/05/2026 11:01, Robby Cai wrote:
>>> The example in imx8mq-mipi-csi2.yaml uses imx8mm_mipi_csi_{in,out} endpoint
>>> labels, which is confusing for an i.MX8MQ binding. Rename the labels to
>>> imx8mq_mipi_csi_{in,out} for consistency.
>>>
>>> Fixes: 37255747ecbd ("media: dt-bindings: media: document the nxp,imx8mq-mipi-csi2 receiver phy and controller")
>>
>> Nothing to fix here. Otherwise explain the bug.
>>
>>> Signed-off-by: Robby Cai <robby.cai@nxp.com>
>>> ---
>>>  .../devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml       | 4 ++--
>>>  1 file changed, 2 insertions(+), 2 deletions(-)
>>>
>>> diff --git a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
>>> index 4fcfc4fd3565..71f79651dd96 100644
>>> --- a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
>>> +++ b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
>>> @@ -220,7 +220,7 @@ examples:
>>>              port@0 {
>>>                  reg = <0>;
>>>  
>>> -                imx8mm_mipi_csi_in: endpoint {
>>> +                imx8mq_mipi_csi_in: endpoint {
>>
>> Drop the labels instead - they are not used.
> 
> I think the label has value, it improves readability of the example by
> making the purpose of the endpoints more explicit. I won't fight for it
> though, I know it's hard to change your mind.

Then should not have imx8mq in the first place. The only information
coming here is that it is input endpoint. IMO it is close to obvious
from the opposite of "remote-endpoint = <&imx477_out>;" (if remote is
OUT, then this must be IN). But keeping the redundant data or actually
correcting wrong redundant data into correct redundant data, is still
undesirable. Such patterns then keep spreading to new code.

Best regards,
Krzysztof

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
  2026-05-06 14:24     ` Krzysztof Kozlowski
@ 2026-05-06 14:30       ` Laurent Pinchart
  2026-05-06 14:38         ` Krzysztof Kozlowski
  0 siblings, 1 reply; 7+ messages in thread
From: Laurent Pinchart @ 2026-05-06 14:30 UTC (permalink / raw)
  To: Krzysztof Kozlowski
  Cc: Robby Cai, Frank.Li, martink, rmfrfs, kernel, mchehab, robh,
	krzk+dt, conor+dt, s.hauer, kernel, festevam, martin.kepplinger,
	imx, linux-media, devicetree, linux-arm-kernel, linux-kernel

On Wed, May 06, 2026 at 04:24:35PM +0200, Krzysztof Kozlowski wrote:
> On 06/05/2026 16:21, Laurent Pinchart wrote:
> > On Wed, May 06, 2026 at 03:33:57PM +0200, Krzysztof Kozlowski wrote:
> >> On 06/05/2026 11:01, Robby Cai wrote:
> >>> The example in imx8mq-mipi-csi2.yaml uses imx8mm_mipi_csi_{in,out} endpoint
> >>> labels, which is confusing for an i.MX8MQ binding. Rename the labels to
> >>> imx8mq_mipi_csi_{in,out} for consistency.
> >>>
> >>> Fixes: 37255747ecbd ("media: dt-bindings: media: document the nxp,imx8mq-mipi-csi2 receiver phy and controller")
> >>
> >> Nothing to fix here. Otherwise explain the bug.
> >>
> >>> Signed-off-by: Robby Cai <robby.cai@nxp.com>
> >>> ---
> >>>  .../devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml       | 4 ++--
> >>>  1 file changed, 2 insertions(+), 2 deletions(-)
> >>>
> >>> diff --git a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> >>> index 4fcfc4fd3565..71f79651dd96 100644
> >>> --- a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> >>> +++ b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
> >>> @@ -220,7 +220,7 @@ examples:
> >>>              port@0 {
> >>>                  reg = <0>;
> >>>  
> >>> -                imx8mm_mipi_csi_in: endpoint {
> >>> +                imx8mq_mipi_csi_in: endpoint {
> >>
> >> Drop the labels instead - they are not used.
> > 
> > I think the label has value, it improves readability of the example by
> > making the purpose of the endpoints more explicit. I won't fight for it
> > though, I know it's hard to change your mind.
> 
> Then should not have imx8mq in the first place. The only information
> coming here is that it is input endpoint. IMO it is close to obvious
> from the opposite of "remote-endpoint = <&imx477_out>;" (if remote is
> OUT, then this must be IN). But keeping the redundant data or actually
> correcting wrong redundant data into correct redundant data, is still
> undesirable. Such patterns then keep spreading to new code.

Dropping the imx8mm_ prefix instead of renaming it is a good idea,
thanks for proposing it. As for the Fixes: tag, I don't see a need to
backport this, so I'd leave it out too.

-- 
Regards,

Laurent Pinchart

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
  2026-05-06 14:30       ` Laurent Pinchart
@ 2026-05-06 14:38         ` Krzysztof Kozlowski
  0 siblings, 0 replies; 7+ messages in thread
From: Krzysztof Kozlowski @ 2026-05-06 14:38 UTC (permalink / raw)
  To: Laurent Pinchart
  Cc: Robby Cai, Frank.Li, martink, rmfrfs, kernel, mchehab, robh,
	krzk+dt, conor+dt, s.hauer, kernel, festevam, martin.kepplinger,
	imx, linux-media, devicetree, linux-arm-kernel, linux-kernel

On 06/05/2026 16:30, Laurent Pinchart wrote:
> On Wed, May 06, 2026 at 04:24:35PM +0200, Krzysztof Kozlowski wrote:
>> On 06/05/2026 16:21, Laurent Pinchart wrote:
>>> On Wed, May 06, 2026 at 03:33:57PM +0200, Krzysztof Kozlowski wrote:
>>>> On 06/05/2026 11:01, Robby Cai wrote:
>>>>> The example in imx8mq-mipi-csi2.yaml uses imx8mm_mipi_csi_{in,out} endpoint
>>>>> labels, which is confusing for an i.MX8MQ binding. Rename the labels to
>>>>> imx8mq_mipi_csi_{in,out} for consistency.
>>>>>
>>>>> Fixes: 37255747ecbd ("media: dt-bindings: media: document the nxp,imx8mq-mipi-csi2 receiver phy and controller")
>>>>
>>>> Nothing to fix here. Otherwise explain the bug.
>>>>
>>>>> Signed-off-by: Robby Cai <robby.cai@nxp.com>
>>>>> ---
>>>>>  .../devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml       | 4 ++--
>>>>>  1 file changed, 2 insertions(+), 2 deletions(-)
>>>>>
>>>>> diff --git a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
>>>>> index 4fcfc4fd3565..71f79651dd96 100644
>>>>> --- a/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
>>>>> +++ b/Documentation/devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml
>>>>> @@ -220,7 +220,7 @@ examples:
>>>>>              port@0 {
>>>>>                  reg = <0>;
>>>>>  
>>>>> -                imx8mm_mipi_csi_in: endpoint {
>>>>> +                imx8mq_mipi_csi_in: endpoint {
>>>>
>>>> Drop the labels instead - they are not used.
>>>
>>> I think the label has value, it improves readability of the example by
>>> making the purpose of the endpoints more explicit. I won't fight for it
>>> though, I know it's hard to change your mind.
>>
>> Then should not have imx8mq in the first place. The only information
>> coming here is that it is input endpoint. IMO it is close to obvious
>> from the opposite of "remote-endpoint = <&imx477_out>;" (if remote is
>> OUT, then this must be IN). But keeping the redundant data or actually
>> correcting wrong redundant data into correct redundant data, is still
>> undesirable. Such patterns then keep spreading to new code.
> 
> Dropping the imx8mm_ prefix instead of renaming it is a good idea,
> thanks for proposing it. As for the Fixes: tag, I don't see a need to
> backport this, so I'd leave it out too.

Fixes is not only for backporting but indicating that there was a bug,
being fixed here. For example for stats. There was no bug, because DTS
example absolutely does not matter - it's example code - therefore
redundant incorrect information in label matters even less.

Best regards,
Krzysztof

^ permalink raw reply	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2026-05-06 14:38 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-05-06  9:01 [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo Robby Cai
2026-05-06 11:20 ` Laurent Pinchart
2026-05-06 13:33 ` Krzysztof Kozlowski
2026-05-06 14:21   ` Laurent Pinchart
2026-05-06 14:24     ` Krzysztof Kozlowski
2026-05-06 14:30       ` Laurent Pinchart
2026-05-06 14:38         ` Krzysztof Kozlowski

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox