Hi Hans,
Many thanks for the response & comments.
> Subject: Re: [PATCH v2 6/7] dt-bindings: media: Add Renesas R-Car DRIF
> binding
>
> On 01/10/2017 10:31 AM, Ramesh Shanmugasundaram wrote:
> > Hi Laurent,
> >
> >>>>>> On Wednesday 21 Dec 2016 08:10:37 Ramesh Shanmugasundaram wrote:
> >>>>>>> Add binding documentation for Renesas R-Car Digital Radio
> >>>>>>> Interface
> >>>>>>> (DRIF) controller.
> >>>>>>>
> >>>>>>> Signed-off-by: Ramesh Shanmugasundaram
> >>>>>>> <ramesh.shanmugasundaram@xxxxxxxxxxxxxx> ---
> >>>>>>>
> >>>>>>> .../devicetree/bindings/media/renesas,drif.txt | 202
> >> +++++++++++++
> >>>>>>> 1 file changed, 202 insertions(+) create mode 100644
> >>>>>>>
> >>>>>>> Documentation/devicetree/bindings/media/renesas,drif.txt
> >>>>>>>
> >>>>>>> diff --git
> >>>>>>> a/Documentation/devicetree/bindings/media/renesas,drif.txt
> >>>>>>> b/Documentation/devicetree/bindings/media/renesas,drif.txt new
> >>>>>>> file mode 100644 index 0000000..1f3feaf
> >>>>>>> --- /dev/null
> >>>>>>> +++ b/Documentation/devicetree/bindings/media/renesas,drif.txt
> >>>>>>>
> >>>>>>> +Optional properties of an internal channel when:
> >>>>>>> + - It is the only enabled channel of the bond (or)
> >>>>>>> + - If it acts as primary among enabled bonds
> >>>>>>> +--------------------------------------------------------
> >>>>>>> +- renesas,syncmd : sync mode
> >>>>>>> + 0 (Frame start sync pulse mode. 1-bit
> >>>>>>> +width
> >>>>>>> pulse
> >>>>>>> + indicates start of a frame)
> >>>>>>> + 1 (L/R sync or I2S mode) (default)
> >>>>>>> +- renesas,lsb-first : empty property indicates lsb bit is
> >> received
> >>>>>>> first.
> >>>>>>> + When not defined msb bit is received
> >>>>>>> +first
> >>>>>>> +(default)
> >>>>>>> +- renesas,syncac-active: Indicates sync signal polarity, 0/1
> >>>>>>> +for
> >>>>>>> low/high
> >>>
> >>> Shouldn't this be 'renesas,sync-active' instead of syncac-active?
> >>>
> >>> I'm not sure if syncac is intended or if it is a typo.
> >>>
> >>>>>>> + respectively. The default is 1 (active
> high)
> >>>>>>> +- renesas,dtdl : delay between sync signal and start of
> >>>>>>> reception.
> >>>>>>> + The possible values are represented in
> >>>>>>> + 0.5
> >> clock
> >>>>>>> + cycle units and the range is 0 to 4. The
> >> default
> >>>>>>> + value is 2 (i.e.) 1 clock cycle delay.
> >>>>>>> +- renesas,syncdl : delay between end of reception and sync
> >>>>>>> signal edge.
> >>>>>>> + The possible values are represented in
> >>>>>>> + 0.5
> >> clock
> >>>>>>> + cycle units and the range is 0 to 4 & 6.
> >>>>>>> + The
> >>>>>>> default
> >>>>>>> + value is 0 (i.e.) no delay.
>
> Are these properties actually going to be used by anyone? Just curious.
Yes. Each of this property should be set appropriately based on the master device it interfaces with.
>
> >>>>>>
> >>>>>> Most of these properties are pretty similar to the video bus
> >>>>>> properties defined at the endpoint level in
> >>>>>> Documentation/devicetree/bindings/media/video-interfaces.txt. I
> >>>>>> believe it would make sense to use OF graph and try to
> >>>>>> standardize these properties similarly.
> >>>
> >>> Other than sync-active, is there really anything else that is similar?
> >>> And even the sync-active isn't a good fit since here there is only
> >>> one sync signal instead of two for video (h and vsync).
> >>
> >> That's why I said similar, not identical :-) My point is that, if we
> >> consider that we could connect multiple sources to the DRIF, using OF
> >> graph would make sense, and the above properties should then be
> >> defined per endpoint.
> >
> > Thanks for the clarifications. I have some questions.
> >
> > - Assuming two devices are interfaced with DRIF and they are represented
> using two endpoints, the control signal related properties of DRIF might
> still need to be same for both endpoints? For e.g. syncac-active cannot be
> different in both endpoints?
>
> Usually that's the case, but HW designers are weird :-)
>
> >
> > - I suppose "lsb-first", "dtdl" & "syncdl" may be defined per endpoint.
> However, h/w manual says same register values needs to be programmed for
> both the internal channels of a channel. Same with "syncmd" property.
> >
> > We could still define them as per endpoint property with a note that
> they need to be same. But I am not sure if that is what you intended?
> >
> > If we define them per endpoint we should then also try
> >> standardize the ones that are not really Renesas-specific (that's at
> >> least syncac-active).
> >
> > OK. I will call it "sync-active".
>
> That's better, yes.
Thanks.
>
> >
> > For the syncmd and lsb-first properties, it could also
> >> make sense to query them from the connected subdev at runtime, as
> >> they're similar in purpose to formats and media bus configuration
> >> (struct v4l2_mbus_config).
>
> I consider this unlikely. I wouldn't spend time on that as this can always
> be done later.
>
> > May I know in bit more detail about what you had in mind? Please
> > correct me if my understanding is wrong here but when I looked at the
> > code
> >
> > 1) mbus_config is part of subdev_video_ops only. I assume we don't want
> to support this as part of tuner subdev. The next closest is pad_ops with
> "struct v4l2_mbus_framefmt" but it is fully video specific config unless I
> come up with new MEDIA_BUS_FMT_xxxx in media-bus-format.h and use the code
> field? For e.g.
> >
> > #define MEDIA_BUS_FMT_SDR_I2S_PADHI_BE 0x7001
> > #define MEDIA_BUS_FMT_SDR_I2S_PADHI_LE 0x7002
> >
> > 2) The framework does not seem to mandate pad ops for all subdev. As the
> tuner can be any third party subdev, is it fair to assume that these
> properties can be queried from subdev?
> >
> > 3) Assuming pad ops is not available on the subdev shouldn't we still
> need a way to define these properties on DRIF DT?
> >
> >>
> >> I'm not an SDR expert, so I'd like to have your opinion on this.
>
> Neither am I :-)
>
> I think using the endpoint idea does make sense since this helps in
> describing the routing.
OK.
I am not sure what properties to put in there,
> though.
>
> Can you describe a bit more which properties belong to which syncmd mode?
> That will help me make a decision.
OK. The documentation for this control is not accurate in many places of the h/w manual. My observations are based on tests with MAX2175 tuner master device using I2S mode.
Applicable parameters for both Frame Start Sync pulse & I2S modes
- sync-active
- lsb/msb first
- dtdl
For I2S mode, syncdl property should be set to value zero only.
Below are timing diagram examples.
Frame start sync pulse mode:
-----------------------------
<------------ 1 frame ------------------>
.---. .---. .---. .---. .---. .---. .---.
___| |___| |___| |___| |___| |___| |___| |___ SCK
.-------. .-------.
___| |_______________________________| |_______ SYNC/SS
| |
|-No data delay No sync delay |
__ ______ ______ ______ ______ ______ ______ ______
\/ \/ \/ \/ \/ \/ \/ Rx Data
__/\______/\______/\______/\______/\______/\______/\______
|-1 bit delay No sync delay |
__________ ______ ______ ______ ______ ______ ______
\/ \/ \/ \/ \/ \/ Rx Data
__________/\______/\______/\______/\______/\______/\______
1 bit delay => DTDL = 1 (i.e.) 1 clock cycle delay
No Sync delay => SYNCDL = 0
I2S mode:
----------
<------------ 1 frame -------------------------->
.---. .---. .---. .---. .---. .---. .---.
___| |___| |___| |___| |___| |___| |___| |___ SCK
___ _______________________
| | | SYNC/SS
+-----------------------+ +-------
| |
|-No data delay No sync delay |
__ ______ ______ ______ ______ ______ ______ ______
\/ \/ \/ \/ \/ \/ \/ Rx Data
__/\______/\______/\______/\______/\______/\______/\______
|-1 bit delay No sync delay |
__________ ______ ______ ______ ______ ______ ______
\/ \/ \/ \/ \/ \/ Rx Data
__________/\______/\______/\______/\______/\______/\______
Please share your thoughts.
Thanks,
Ramesh
