Message ID | 20170919073331.29007-2-hverkuil@xs4all.nl (mailing list archive) |
---|---|
State | Superseded |
Delegated to: | Geert Uytterhoeven |
Headers | show |
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
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 >
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
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
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
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
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
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
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 --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";