[PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo

Robby Cai posted 1 patch 1 month, 1 week ago
There is a newer version of this series
.../devicetree/bindings/media/nxp,imx8mq-mipi-csi2.yaml       | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
[PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
Posted by Robby Cai 1 month, 1 week ago
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
Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
Posted by Krzysztof Kozlowski 1 month, 1 week ago
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
Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
Posted by Laurent Pinchart 1 month, 1 week ago
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
Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
Posted by Krzysztof Kozlowski 1 month, 1 week ago
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
Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
Posted by Laurent Pinchart 1 month, 1 week ago
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
Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
Posted by Krzysztof Kozlowski 1 month, 1 week ago
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
Re: [PATCH] media: dt-bindings: nxp,imx8mq-mipi-csi2: Fix example endpoint label typo
Posted by Laurent Pinchart 1 month, 1 week ago
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