diff mbox

[PATCHv2,1/2] dt-bindings: adi,adv7511.txt: document cec clock

Message ID 20170919073331.29007-2-hverkuil@xs4all.nl (mailing list archive)
State Superseded
Delegated to: Geert Uytterhoeven
Headers show

Commit Message

Hans Verkuil Sept. 19, 2017, 7:33 a.m. UTC
From: Hans Verkuil <hans.verkuil@cisco.com>

Document the cec clock binding.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Acked-by: Rob Herring <robh@kernel.org>
---
 Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
 1 file changed, 4 insertions(+)

Comments

Sergei Shtylyov Sept. 19, 2017, 9:20 a.m. UTC | #1
Hello!

On 9/19/2017 10:33 AM, Hans Verkuil wrote:

> From: Hans Verkuil <hans.verkuil@cisco.com>
> 
> Document the cec clock binding.
> 
> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
> Acked-by: Rob Herring <robh@kernel.org>
> ---
>   Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
>   1 file changed, 4 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
> index 06668bca7ffc..4497ae054d49 100644
> --- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
> +++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
> @@ -68,6 +68,8 @@ Optional properties:
>   - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
>     generator. The chip will rely on the sync signals in the DSI data lanes,
>     rather than generate its own timings for HDMI output.
> +- clocks: from common clock binding: handle to CEC clock.

    It's called "phandle" in the DT speak. :-)
    Are you sure the clock specifier would always be absent?

> +- clock-names: from common clock binding: must be "cec".
>   
>   Required nodes:
>   
[...]

MBR, Sergei
Hans Verkuil (hansverk) Sept. 19, 2017, 9:29 a.m. UTC | #2
On 09/19/17 11:20, Sergei Shtylyov wrote:
> Hello!
> 
> On 9/19/2017 10:33 AM, Hans Verkuil wrote:
> 
>> From: Hans Verkuil <hans.verkuil@cisco.com>
>>
>> Document the cec clock binding.
>>
>> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
>> Acked-by: Rob Herring <robh@kernel.org>
>> ---
>>   Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
>>   1 file changed, 4 insertions(+)
>>
>> diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>> index 06668bca7ffc..4497ae054d49 100644
>> --- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>> +++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>> @@ -68,6 +68,8 @@ Optional properties:
>>   - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
>>     generator. The chip will rely on the sync signals in the DSI data lanes,
>>     rather than generate its own timings for HDMI output.
>> +- clocks: from common clock binding: handle to CEC clock.
> 
>     It's called "phandle" in the DT speak. :-)
>     Are you sure the clock specifier would always be absent?

Sorry? I don't understand the question. Did you mean: "can be absent?"?

Regards,

        Hans

> 
>> +- clock-names: from common clock binding: must be "cec".
>>   
>>   Required nodes:
>>   
> [...]
> 
> MBR, Sergei
>
Sergei Shtylyov Sept. 19, 2017, 9:35 a.m. UTC | #3
On 9/19/2017 12:29 PM, Hans Verkuil wrote:

>>> From: Hans Verkuil <hans.verkuil@cisco.com>
>>>
>>> Document the cec clock binding.
>>>
>>> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
>>> Acked-by: Rob Herring <robh@kernel.org>
>>> ---
>>>    Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
>>>    1 file changed, 4 insertions(+)
>>>
>>> diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>> index 06668bca7ffc..4497ae054d49 100644
>>> --- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>> +++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>> @@ -68,6 +68,8 @@ Optional properties:
>>>    - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
>>>      generator. The chip will rely on the sync signals in the DSI data lanes,
>>>      rather than generate its own timings for HDMI output.
>>> +- clocks: from common clock binding: handle to CEC clock.
>>
>>      It's called "phandle" in the DT speak. :-)
>>      Are you sure the clock specifier would always be absent?
> 
> Sorry? I don't understand the question. Did you mean: "can be absent?"?

    No, you only say that there'll be the clock phandle only. The clock 
specifier may follow the phandle for the clock devices that have 
"#clock-cells" prop != 0.

> Regards,
> 
>          Hans
[...]

MBR, Sergei
Hans Verkuil Sept. 19, 2017, 10:07 a.m. UTC | #4
On 09/19/17 11:35, Sergei Shtylyov wrote:
> On 9/19/2017 12:29 PM, Hans Verkuil wrote:
> 
>>>> From: Hans Verkuil <hans.verkuil@cisco.com>
>>>>
>>>> Document the cec clock binding.
>>>>
>>>> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
>>>> Acked-by: Rob Herring <robh@kernel.org>
>>>> ---
>>>>    Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
>>>>    1 file changed, 4 insertions(+)
>>>>
>>>> diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>> index 06668bca7ffc..4497ae054d49 100644
>>>> --- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>> +++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>> @@ -68,6 +68,8 @@ Optional properties:
>>>>    - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
>>>>      generator. The chip will rely on the sync signals in the DSI data lanes,
>>>>      rather than generate its own timings for HDMI output.
>>>> +- clocks: from common clock binding: handle to CEC clock.
>>>
>>>      It's called "phandle" in the DT speak. :-)
>>>      Are you sure the clock specifier would always be absent?
>>
>> Sorry? I don't understand the question. Did you mean: "can be absent?"?
> 
>     No, you only say that there'll be the clock phandle only. The clock 
> specifier may follow the phandle for the clock devices that have 
> "#clock-cells" prop != 0.

I have to say that I just copy-and-pasted this from other bindings. Would
this be better?

- clocks: list of clock specifiers, corresponding to entries in
  the clock-names property;
- clock-names: from common clock binding: must be "cec".

Regards,

	Hans
Sergei Shtylyov Sept. 19, 2017, 10:15 a.m. UTC | #5
On 9/19/2017 1:07 PM, Hans Verkuil wrote:

>>>>> From: Hans Verkuil <hans.verkuil@cisco.com>
>>>>>
>>>>> Document the cec clock binding.
>>>>>
>>>>> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
>>>>> Acked-by: Rob Herring <robh@kernel.org>
>>>>> ---
>>>>>     Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
>>>>>     1 file changed, 4 insertions(+)
>>>>>
>>>>> diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>> index 06668bca7ffc..4497ae054d49 100644
>>>>> --- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>> +++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>> @@ -68,6 +68,8 @@ Optional properties:
>>>>>     - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
>>>>>       generator. The chip will rely on the sync signals in the DSI data lanes,
>>>>>       rather than generate its own timings for HDMI output.
>>>>> +- clocks: from common clock binding: handle to CEC clock.
>>>>
>>>>       It's called "phandle" in the DT speak. :-)
>>>>       Are you sure the clock specifier would always be absent?
>>>
>>> Sorry? I don't understand the question. Did you mean: "can be absent?"?
>>
>>      No, you only say that there'll be the clock phandle only. The clock
>> specifier may follow the phandle for the clock devices that have
>> "#clock-cells" prop != 0.
> 
> I have to say that I just copy-and-pasted this from other bindings.

    :-)

> Would this be better?
> 
> - clocks: list of clock specifiers, corresponding to entries in
>    the clock-names property;

    Didn't you say that there'll be only one clock, "cec"? If so, there's 
gonna  be a single clock phandle+specifier pair. They always go in pairs. :-)

> - clock-names: from common clock binding: must be "cec".
> 
> Regards,
> 
> 	Hans

MBR, Sergei
Hans Verkuil Sept. 19, 2017, 10:35 a.m. UTC | #6
On 09/19/17 12:15, Sergei Shtylyov wrote:
> On 9/19/2017 1:07 PM, Hans Verkuil wrote:
> 
>>>>>> From: Hans Verkuil <hans.verkuil@cisco.com>
>>>>>>
>>>>>> Document the cec clock binding.
>>>>>>
>>>>>> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
>>>>>> Acked-by: Rob Herring <robh@kernel.org>
>>>>>> ---
>>>>>>     Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
>>>>>>     1 file changed, 4 insertions(+)
>>>>>>
>>>>>> diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>> index 06668bca7ffc..4497ae054d49 100644
>>>>>> --- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>> +++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>> @@ -68,6 +68,8 @@ Optional properties:
>>>>>>     - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
>>>>>>       generator. The chip will rely on the sync signals in the DSI data lanes,
>>>>>>       rather than generate its own timings for HDMI output.
>>>>>> +- clocks: from common clock binding: handle to CEC clock.
>>>>>
>>>>>       It's called "phandle" in the DT speak. :-)
>>>>>       Are you sure the clock specifier would always be absent?
>>>>
>>>> Sorry? I don't understand the question. Did you mean: "can be absent?"?
>>>
>>>      No, you only say that there'll be the clock phandle only. The clock
>>> specifier may follow the phandle for the clock devices that have
>>> "#clock-cells" prop != 0.
>>
>> I have to say that I just copy-and-pasted this from other bindings.
> 
>     :-)
> 
>> Would this be better?
>>
>> - clocks: list of clock specifiers, corresponding to entries in
>>    the clock-names property;
> 
>     Didn't you say that there'll be only one clock, "cec"? If so, there's 
> gonna  be a single clock phandle+specifier pair. They always go in pairs. :-)
> 
>> - clock-names: from common clock binding: must be "cec".

- clocks: cec clock phandle, corresponding to the clock-names entry.
- clock-names: from common clock binding: must be "cec".

This OK?

Regards,

	Hans
Sergei Shtylyov Sept. 19, 2017, 10:42 a.m. UTC | #7
On 9/19/2017 1:35 PM, Hans Verkuil wrote:

>>>>>>> From: Hans Verkuil <hans.verkuil@cisco.com>
>>>>>>>
>>>>>>> Document the cec clock binding.
>>>>>>>
>>>>>>> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
>>>>>>> Acked-by: Rob Herring <robh@kernel.org>
>>>>>>> ---
>>>>>>>      Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
>>>>>>>      1 file changed, 4 insertions(+)
>>>>>>>
>>>>>>> diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>>> index 06668bca7ffc..4497ae054d49 100644
>>>>>>> --- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>>> +++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>>> @@ -68,6 +68,8 @@ Optional properties:
>>>>>>>      - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
>>>>>>>        generator. The chip will rely on the sync signals in the DSI data lanes,
>>>>>>>        rather than generate its own timings for HDMI output.
>>>>>>> +- clocks: from common clock binding: handle to CEC clock.
>>>>>>
>>>>>>        It's called "phandle" in the DT speak. :-)
>>>>>>        Are you sure the clock specifier would always be absent?
>>>>>
>>>>> Sorry? I don't understand the question. Did you mean: "can be absent?"?
>>>>
>>>>       No, you only say that there'll be the clock phandle only. The clock
>>>> specifier may follow the phandle for the clock devices that have
>>>> "#clock-cells" prop != 0.
>>>
>>> I have to say that I just copy-and-pasted this from other bindings.
>>
>>      :-)
>>
>>> Would this be better?
>>>
>>> - clocks: list of clock specifiers, corresponding to entries in
>>>     the clock-names property;
>>
>>      Didn't you say that there'll be only one clock, "cec"? If so, there's
>> gonna  be a single clock phandle+specifier pair. They always go in pairs. :-)
>>
>>> - clock-names: from common clock binding: must be "cec".
> 
> - clocks: cec clock phandle, corresponding to the clock-names entry.

    The clock phandle and specifier.

> - clock-names: from common clock binding: must be "cec".
> 
> This OK?

    Well, you seem to be going in circles, the above was almost the same as 
the original prop description...

> Regards,
> 
> 	Hans

MBR, Sergei
Hans Verkuil (hansverk) Sept. 19, 2017, 10:59 a.m. UTC | #8
On 09/19/17 12:42, Sergei Shtylyov wrote:
> On 9/19/2017 1:35 PM, Hans Verkuil wrote:
> 
>>>>>>>> From: Hans Verkuil <hans.verkuil@cisco.com>
>>>>>>>>
>>>>>>>> Document the cec clock binding.
>>>>>>>>
>>>>>>>> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
>>>>>>>> Acked-by: Rob Herring <robh@kernel.org>
>>>>>>>> ---
>>>>>>>>      Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
>>>>>>>>      1 file changed, 4 insertions(+)
>>>>>>>>
>>>>>>>> diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>>>> index 06668bca7ffc..4497ae054d49 100644
>>>>>>>> --- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>>>> +++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>>>> @@ -68,6 +68,8 @@ Optional properties:
>>>>>>>>      - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
>>>>>>>>        generator. The chip will rely on the sync signals in the DSI data lanes,
>>>>>>>>        rather than generate its own timings for HDMI output.
>>>>>>>> +- clocks: from common clock binding: handle to CEC clock.
>>>>>>>
>>>>>>>        It's called "phandle" in the DT speak. :-)
>>>>>>>        Are you sure the clock specifier would always be absent?
>>>>>>
>>>>>> Sorry? I don't understand the question. Did you mean: "can be absent?"?
>>>>>
>>>>>       No, you only say that there'll be the clock phandle only. The clock
>>>>> specifier may follow the phandle for the clock devices that have
>>>>> "#clock-cells" prop != 0.
>>>>
>>>> I have to say that I just copy-and-pasted this from other bindings.
>>>
>>>      :-)
>>>
>>>> Would this be better?
>>>>
>>>> - clocks: list of clock specifiers, corresponding to entries in
>>>>     the clock-names property;
>>>
>>>      Didn't you say that there'll be only one clock, "cec"? If so, there's
>>> gonna  be a single clock phandle+specifier pair. They always go in pairs. :-)
>>>
>>>> - clock-names: from common clock binding: must be "cec".
>>
>> - clocks: cec clock phandle, corresponding to the clock-names entry.
> 
>     The clock phandle and specifier.
> 
>> - clock-names: from common clock binding: must be "cec".
>>
>> This OK?
> 
>     Well, you seem to be going in circles, the above was almost the same as 
> the original prop description...

- clocks: from common clock binding: reference to the CEC clock.
- clock-names: from common clock binding: must be "cec".

This avoids the whole issue of having just a phandle or a phandle + specifier.

Regards,

	Hans
Sergei Shtylyov Sept. 19, 2017, 12:27 p.m. UTC | #9
On 09/19/2017 01:59 PM, Hans Verkuil wrote:

>>>>>>>>> From: Hans Verkuil <hans.verkuil@cisco.com>
>>>>>>>>>
>>>>>>>>> Document the cec clock binding.
>>>>>>>>>
>>>>>>>>> Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
>>>>>>>>> Acked-by: Rob Herring <robh@kernel.org>
>>>>>>>>> ---
>>>>>>>>>       Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt | 4 ++++
>>>>>>>>>       1 file changed, 4 insertions(+)
>>>>>>>>>
>>>>>>>>> diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>>>>> index 06668bca7ffc..4497ae054d49 100644
>>>>>>>>> --- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>>>>> +++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
>>>>>>>>> @@ -68,6 +68,8 @@ Optional properties:
>>>>>>>>>       - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
>>>>>>>>>         generator. The chip will rely on the sync signals in the DSI data lanes,
>>>>>>>>>         rather than generate its own timings for HDMI output.
>>>>>>>>> +- clocks: from common clock binding: handle to CEC clock.
>>>>>>>>
>>>>>>>>         It's called "phandle" in the DT speak. :-)
>>>>>>>>         Are you sure the clock specifier would always be absent?
>>>>>>>
>>>>>>> Sorry? I don't understand the question. Did you mean: "can be absent?"?
>>>>>>
>>>>>>        No, you only say that there'll be the clock phandle only. The clock
>>>>>> specifier may follow the phandle for the clock devices that have
>>>>>> "#clock-cells" prop != 0.
>>>>>
>>>>> I have to say that I just copy-and-pasted this from other bindings.
>>>>
>>>>       :-)
>>>>
>>>>> Would this be better?
>>>>>
>>>>> - clocks: list of clock specifiers, corresponding to entries in
>>>>>      the clock-names property;
>>>>
>>>>       Didn't you say that there'll be only one clock, "cec"? If so, there's
>>>> gonna  be a single clock phandle+specifier pair. They always go in pairs. :-)
>>>>
>>>>> - clock-names: from common clock binding: must be "cec".
>>>
>>> - clocks: cec clock phandle, corresponding to the clock-names entry.
>>
>>      The clock phandle and specifier.
>>
>>> - clock-names: from common clock binding: must be "cec".
>>>
>>> This OK?
>>
>>      Well, you seem to be going in circles, the above was almost the same as
>> the original prop description...
> 
> - clocks: from common clock binding: reference to the CEC clock.
> - clock-names: from common clock binding: must be "cec".
> 
> This avoids the whole issue of having just a phandle or a phandle + specifier.

    OK, let's go with this one. Thank you!

> Regards,
> 
> 	Hans

MBR, Sergei
diff mbox

Patch

diff --git a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
index 06668bca7ffc..4497ae054d49 100644
--- a/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
+++ b/Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
@@ -68,6 +68,8 @@  Optional properties:
 - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
   generator. The chip will rely on the sync signals in the DSI data lanes,
   rather than generate its own timings for HDMI output.
+- clocks: from common clock binding: handle to CEC clock.
+- clock-names: from common clock binding: must be "cec".
 
 Required nodes:
 
@@ -89,6 +91,8 @@  Example
 		reg = <39>;
 		interrupt-parent = <&gpio3>;
 		interrupts = <29 IRQ_TYPE_EDGE_FALLING>;
+		clocks = <&cec_clock>;
+		clock-names = "cec";
 
 		adi,input-depth = <8>;
 		adi,input-colorspace = "rgb";