On Mon, Apr 03, 2017 at 09:11:35AM -0500, Rob Herring wrote: > On Wed, Mar 29, 2017 at 09:39:05AM +0100, Russell King - ARM Linux wrote: > > On Tue, Mar 28, 2017 at 07:21:34PM -0500, Rob Herring wrote: > > > On Mon, Mar 27, 2017 at 7:40 PM, Steve Longerbeam <slongerbeam@xxxxxxxxx> wrote: > > > > Add bindings documentation for the i.MX media driver. > > > > > > > > Signed-off-by: Steve Longerbeam <steve_longerbeam@xxxxxxxxxx> > > > > --- > > > > Documentation/devicetree/bindings/media/imx.txt | 74 +++++++++++++++++++++++++ > > > > 1 file changed, 74 insertions(+) > > > > create mode 100644 Documentation/devicetree/bindings/media/imx.txt > > > > > > > > diff --git a/Documentation/devicetree/bindings/media/imx.txt b/Documentation/devicetree/bindings/media/imx.txt > > > > new file mode 100644 > > > > index 0000000..3059c06 > > > > --- /dev/null > > > > +++ b/Documentation/devicetree/bindings/media/imx.txt > > > > @@ -0,0 +1,74 @@ > > > > +Freescale i.MX Media Video Device > > > > +================================= > > > > + > > > > +Video Media Controller node > > > > +--------------------------- > > > > + > > > > +This is the media controller node for video capture support. It is a > > > > +virtual device that lists the camera serial interface nodes that the > > > > +media device will control. > > > > + > > > > +Required properties: > > > > +- compatible : "fsl,imx-capture-subsystem"; > > > > +- ports : Should contain a list of phandles pointing to camera > > > > + sensor interface ports of IPU devices > > > > + > > > > +example: > > > > + > > > > +capture-subsystem { > > > > + compatible = "fsl,imx-capture-subsystem"; > > > > + ports = <&ipu1_csi0>, <&ipu1_csi1>; > > > > +}; > > > > + > > > > +fim child node > > > > +-------------- > > > > + > > > > +This is an optional child node of the ipu_csi port nodes. If present and > > > > +available, it enables the Frame Interval Monitor. Its properties can be > > > > +used to modify the method in which the FIM measures frame intervals. > > > > +Refer to Documentation/media/v4l-drivers/imx.rst for more info on the > > > > +Frame Interval Monitor. > > > > + > > > > +Optional properties: > > > > +- fsl,input-capture-channel: an input capture channel and channel flags, > > > > + specified as <chan flags>. The channel number > > > > + must be 0 or 1. The flags can be > > > > + IRQ_TYPE_EDGE_RISING, IRQ_TYPE_EDGE_FALLING, or > > > > + IRQ_TYPE_EDGE_BOTH, and specify which input > > > > + capture signal edge will trigger the input > > > > + capture event. If an input capture channel is > > > > + specified, the FIM will use this method to > > > > + measure frame intervals instead of via the EOF > > > > + interrupt. The input capture method is much > > > > + preferred over EOF as it is not subject to > > > > + interrupt latency errors. However it requires > > > > + routing the VSYNC or FIELD output signals of > > > > + the camera sensor to one of the i.MX input > > > > + capture pads (SD1_DAT0, SD1_DAT1), which also > > > > + gives up support for SD1. > > > > + > > > > + > > > > +mipi_csi2 node > > > > +-------------- > > > > + > > > > +This is the device node for the MIPI CSI-2 Receiver, required for MIPI > > > > +CSI-2 sensors. > > > > + > > > > +Required properties: > > > > +- compatible : "fsl,imx6-mipi-csi2", "snps,dw-mipi-csi2"; > > > > > > As I mentioned in v5, there's a DW CSI2 binding in progress. This > > > needs to be based on that. > > > > Maybe someone can provide some kind of reference to it, and it's > > associated driver? > > Let me Google that for you (TM). The reference is in my comments on v5. > Here's a reference to it [1]. Looking at the actual driver, it seems to at least have a different register layout: register imx6 dw version 0x000 0x000 n_lanes 0x004 0x004 phy_shutdownz 0x008 - dphy_resetz 0x00c - resetn 0x010 0x008 phy_state 0x014 - data_ids_1 0x018 0x010 data_ids_2 0x01c 0x014 err1 0x020 - err2 0x024 - msk1 0x028 - msk2 0x02c - phy_tst_ctrl0 0x030 - phy_tst_ctrl1 0x034 - sft_reset 0xf00 - (not part of CSI2, but a IMX6 specific CSI2 to IPU gasket layer, but lives in CSI2's register region) The DW version has many more registers than are documented by the iMX6 version. Only the first two registers appear to be common between these two devices, and maybe five registers exist (I haven't checked whether their bit layouts are the same though.) So, I would say that these are two different devices. As for the bindings, the differences are: compatible: dw uses "snps,dw-mipi-csi" imx6 uses "fsl,imx6-mipi-csi2", "snps,dw-mipi-csi2" reg: dw and imx6 both use a single base address interrupts: dw requires one interrupt, imx6 has up to two interrupts output-type: relevant for DW, meaningless on imx6 (not documented) phys: DW seems to specify a separate PHY, on imx6 the PHY control/status is tightly integrated into the CSI2 register set, and the PHY itself is undocumented except for some specific programming documented in source code. resets: DW lists this under "required", but suffixes it with (optional), so is it optional or is it not? Meaningless on imx6. port: imx6 requires this, and must specify all (5) connectivity - one node to connect to the camera, and four nodes connecting to the rest of the capture system. dw specifies only one port node to be connected to the camera. dw document is unclear whether this is an optional or required property. imx6 requires all five nodes. clocks, imx6 requires the clocks and clock names to be specified, clock-names: dw requires no clocks. DW binding would need these to be optional. So, the only common properties are "reg" and maybe "interrupts". The DW binding also looks specific to the SoC implementation - the lack of any specification in it as to how the module relates to other parts of the capture system _appears_ to mean that its relationship with those other parts can't be established from DT. That's a problem when it comes to iMX6, because the CSI2 relationship to the one or two IPU units depends on the SoC (whether it's a single/dual-lite or dual/quad version.) Therefore, it does not make sense to (a) use the same compatible, or (b) use the same binding. -- RMK's Patch system: http://www.armlinux.org.uk/developer/patches/ FTTC broadband for 0.8mile line: currently at 9.6Mbps down 400kbps up according to speedtest.net. -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html