diff mbox series

[2/2] dt-bindings: lcdif: Add optional power-domain

Message ID 20221207151400.1572582-2-alexander.stein@ew.tq-group.com
State Not Applicable, archived
Headers show
Series [1/2] dt-bindings: lcdif: Fix clock constraints for imx8mp | expand

Checks

Context Check Description
robh/checkpatch success
robh/patch-applied success
robh/dtbs-check warning build log
robh/dt-meta-schema success

Commit Message

Alexander Stein Dec. 7, 2022, 3:14 p.m. UTC
i.MX8MP requires a power-domain for this peripheral to use. Add it as
an optional property.

Signed-off-by: Alexander Stein <alexander.stein@ew.tq-group.com>
---
 Documentation/devicetree/bindings/display/fsl,lcdif.yaml | 3 +++
 1 file changed, 3 insertions(+)

Comments

Marek Vasut Dec. 7, 2022, 4 p.m. UTC | #1
On 12/7/22 16:14, Alexander Stein wrote:
> i.MX8MP requires a power-domain for this peripheral to use. Add it as
> an optional property.
> 
> Signed-off-by: Alexander Stein <alexander.stein@ew.tq-group.com>
> ---
>   Documentation/devicetree/bindings/display/fsl,lcdif.yaml | 3 +++
>   1 file changed, 3 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
> index 793e8eccf8b8b..9d9fb5ad587c2 100644
> --- a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
> +++ b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
> @@ -52,6 +52,9 @@ properties:
>     interrupts:
>       maxItems: 1
>   
> +  power-domains:
> +    maxItems: 1
> +
>     port:
>       $ref: /schemas/graph.yaml#/properties/port
>       description: The LCDIF output port

Should this be required on mx8mp then ?
Rob Herring (Arm) Dec. 7, 2022, 5:44 p.m. UTC | #2
On Wed, 07 Dec 2022 16:14:00 +0100, Alexander Stein wrote:
> i.MX8MP requires a power-domain for this peripheral to use. Add it as
> an optional property.
> 
> Signed-off-by: Alexander Stein <alexander.stein@ew.tq-group.com>
> ---
>  Documentation/devicetree/bindings/display/fsl,lcdif.yaml | 3 +++
>  1 file changed, 3 insertions(+)
> 

Acked-by: Rob Herring <robh@kernel.org>
Alexander Stein Dec. 8, 2022, 5:59 a.m. UTC | #3
Am Mittwoch, 7. Dezember 2022, 17:00:22 CET schrieb Marek Vasut:
> On 12/7/22 16:14, Alexander Stein wrote:
> > i.MX8MP requires a power-domain for this peripheral to use. Add it as
> > an optional property.
> > 
> > Signed-off-by: Alexander Stein <alexander.stein@ew.tq-group.com>
> > ---
> > 
> >   Documentation/devicetree/bindings/display/fsl,lcdif.yaml | 3 +++
> >   1 file changed, 3 insertions(+)
> > 
> > diff --git a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
> > b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml index
> > 793e8eccf8b8b..9d9fb5ad587c2 100644
> > --- a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
> > +++ b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
> > 
> > @@ -52,6 +52,9 @@ properties:
> >     interrupts:
> >       maxItems: 1
> > 
> > +  power-domains:
> > +    maxItems: 1
> > +
> > 
> >     port:
> >       $ref: /schemas/graph.yaml#/properties/port
> >       description: The LCDIF output port
> 
> Should this be required on mx8mp then ?

I'm hesitating to add a required property later on. But I'm okay with both.
Rob, Krzysztof: Any preference here? Shall power-domains be made required for 
fsl,imx8mp-lcdif only?

Best regards,
Alexander
Krzysztof Kozlowski Dec. 8, 2022, 8:25 a.m. UTC | #4
On 08/12/2022 06:59, Alexander Stein wrote:
> Am Mittwoch, 7. Dezember 2022, 17:00:22 CET schrieb Marek Vasut:
>> On 12/7/22 16:14, Alexander Stein wrote:
>>> i.MX8MP requires a power-domain for this peripheral to use. Add it as
>>> an optional property.
>>>
>>> Signed-off-by: Alexander Stein <alexander.stein@ew.tq-group.com>
>>> ---
>>>
>>>   Documentation/devicetree/bindings/display/fsl,lcdif.yaml | 3 +++
>>>   1 file changed, 3 insertions(+)
>>>
>>> diff --git a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
>>> b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml index
>>> 793e8eccf8b8b..9d9fb5ad587c2 100644
>>> --- a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
>>> +++ b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
>>>
>>> @@ -52,6 +52,9 @@ properties:
>>>     interrupts:
>>>       maxItems: 1
>>>
>>> +  power-domains:
>>> +    maxItems: 1
>>> +
>>>
>>>     port:
>>>       $ref: /schemas/graph.yaml#/properties/port
>>>       description: The LCDIF output port
>>
>> Should this be required on mx8mp then ?
> 
> I'm hesitating to add a required property later on. But I'm okay with both.
> Rob, Krzysztof: Any preference here? Shall power-domains be made required for 
> fsl,imx8mp-lcdif only?

I don't know. That's not the question to us, but to someone who knows
the hardware/datasheet.

Best regards,
Krzysztof
Alexander Stein Dec. 8, 2022, 8:50 a.m. UTC | #5
Hello Krzysztof,

Am Donnerstag, 8. Dezember 2022, 09:25:31 CET schrieb Krzysztof Kozlowski:
> On 08/12/2022 06:59, Alexander Stein wrote:
> > Am Mittwoch, 7. Dezember 2022, 17:00:22 CET schrieb Marek Vasut:
> >> On 12/7/22 16:14, Alexander Stein wrote:
> >>> i.MX8MP requires a power-domain for this peripheral to use. Add it as
> >>> an optional property.
> >>> 
> >>> Signed-off-by: Alexander Stein <alexander.stein@ew.tq-group.com>
> >>> ---
> >>> 
> >>>   Documentation/devicetree/bindings/display/fsl,lcdif.yaml | 3 +++
> >>>   1 file changed, 3 insertions(+)
> >>> 
> >>> diff --git a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
> >>> b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml index
> >>> 793e8eccf8b8b..9d9fb5ad587c2 100644
> >>> --- a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
> >>> +++ b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
> >>> 
> >>> @@ -52,6 +52,9 @@ properties:
> >>>     interrupts:
> >>>       maxItems: 1
> >>> 
> >>> +  power-domains:
> >>> +    maxItems: 1
> >>> +
> >>> 
> >>>     port:
> >>>       $ref: /schemas/graph.yaml#/properties/port
> >>>       description: The LCDIF output port
> >> 
> >> Should this be required on mx8mp then ?
> > 
> > I'm hesitating to add a required property later on. But I'm okay with
> > both.
> > Rob, Krzysztof: Any preference here? Shall power-domains be made required
> > for fsl,imx8mp-lcdif only?
> 
> I don't know. That's not the question to us, but to someone who knows
> the hardware/datasheet.

I was not talking about the hardware, which needs the power-domain, but the DT 
schema. Sorry to be not specific about this.
Is it okay to add a required property for a compatible later on?

Best regards,
Alexander
Krzysztof Kozlowski Dec. 8, 2022, 8:57 a.m. UTC | #6
On 08/12/2022 09:50, Alexander Stein wrote:
> Hello Krzysztof,
> 
> Am Donnerstag, 8. Dezember 2022, 09:25:31 CET schrieb Krzysztof Kozlowski:
>> On 08/12/2022 06:59, Alexander Stein wrote:
>>> Am Mittwoch, 7. Dezember 2022, 17:00:22 CET schrieb Marek Vasut:
>>>> On 12/7/22 16:14, Alexander Stein wrote:
>>>>> i.MX8MP requires a power-domain for this peripheral to use. Add it as
>>>>> an optional property.
>>>>>
>>>>> Signed-off-by: Alexander Stein <alexander.stein@ew.tq-group.com>
>>>>> ---
>>>>>
>>>>>   Documentation/devicetree/bindings/display/fsl,lcdif.yaml | 3 +++
>>>>>   1 file changed, 3 insertions(+)
>>>>>
>>>>> diff --git a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
>>>>> b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml index
>>>>> 793e8eccf8b8b..9d9fb5ad587c2 100644
>>>>> --- a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
>>>>> +++ b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
>>>>>
>>>>> @@ -52,6 +52,9 @@ properties:
>>>>>     interrupts:
>>>>>       maxItems: 1
>>>>>
>>>>> +  power-domains:
>>>>> +    maxItems: 1
>>>>> +
>>>>>
>>>>>     port:
>>>>>       $ref: /schemas/graph.yaml#/properties/port
>>>>>       description: The LCDIF output port
>>>>
>>>> Should this be required on mx8mp then ?
>>>
>>> I'm hesitating to add a required property later on. But I'm okay with
>>> both.
>>> Rob, Krzysztof: Any preference here? Shall power-domains be made required
>>> for fsl,imx8mp-lcdif only?
>>
>> I don't know. That's not the question to us, but to someone who knows
>> the hardware/datasheet.
> 
> I was not talking about the hardware, which needs the power-domain, but the DT 
> schema. Sorry to be not specific about this.
> Is it okay to add a required property for a compatible later on?

Yes, it is okay, assuming:
1. Linux implementation still works without it thus preserving ABI.
2. It is really required, e.g. device cannot operate without it (your
commit msg suggests that).
3. The property should be required since beginning, but we did not add
it due to mistake/forgot/lack of docs etc.

Best regards,
Krzysztof
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
index 793e8eccf8b8b..9d9fb5ad587c2 100644
--- a/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
+++ b/Documentation/devicetree/bindings/display/fsl,lcdif.yaml
@@ -52,6 +52,9 @@  properties:
   interrupts:
     maxItems: 1
 
+  power-domains:
+    maxItems: 1
+
   port:
     $ref: /schemas/graph.yaml#/properties/port
     description: The LCDIF output port