Re: [PATCH v3 01/31] dt-bindings: media: add DW MIPI CSI-2 Host support

[Laurent Pinchart <laurent.pinchart@ideasonboard.com>]

On Mon, Oct 27, 2025 at 05:05:09PM -0400, Frank Li wrote:
> On Mon, Oct 27, 2025 at 10:51:21PM +0200, Sakari Ailus wrote:
> > On Mon, Oct 27, 2025 at 12:32:28PM -0400, Frank Li wrote:
> > > On Mon, Oct 27, 2025 at 10:31:25AM +0200, Sakari Ailus wrote:
> > > > On Thu, Aug 21, 2025 at 04:15:36PM -0400, Frank Li wrote:
> > > > > From: Eugen Hristev <eugen.hristev@linaro.org>
> > > > >
> > > > > Add bindings for Synopsys DesignWare MIPI CSI-2 host, which used at i.MX93
> > > > > and i.MX95 platform.
> > > > >
> > > > > Signed-off-by: Luis Oliveira <lolivei@synopsys.com>
> > > > > Signed-off-by: Eugen Hristev <eugen.hristev@linaro.org>
> > > > > Signed-off-by: Frank Li <Frank.Li@nxp.com>
> > > > > ---
> > > > > Change in v3
> > > > > - drop remote-endpoint: true
> > > > > - drop clock-lanes
> > > > >
> > > > > Change in v2
> > > > > - remove Eugen Hristev <eugen.hristev@microchip.com> from mantainer.
> > > > > - update ugen Hristev's s-o-b tag to align original author's email address
> > > > > - remove single snps,dw-mipi-csi2-v150 compatible string
> > > > > - move additionalProperties after required
> > > > > ---
> > > > >  .../bindings/media/snps,dw-mipi-csi2-v150.yaml     | 151 +++++++++++++++++++++
> > > > >  MAINTAINERS                                        |   1 +
> > > > >  2 files changed, 152 insertions(+)
> > > > >
> > > > > diff --git a/Documentation/devicetree/bindings/media/snps,dw-mipi-csi2-v150.yaml b/Documentation/devicetree/bindings/media/snps,dw-mipi-csi2-v150.yaml
> > > > > new file mode 100644
> > > > > index 0000000000000000000000000000000000000000..d950daa4ee9cfd504ef84b83271b2a1b710ffd6b
> > > > > --- /dev/null
> > > > > +++ b/Documentation/devicetree/bindings/media/snps,dw-mipi-csi2-v150.yaml
> > > > > @@ -0,0 +1,151 @@
> > > > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> > > > > +%YAML 1.2
> > > > > +---
> > > > > +$id: http://devicetree.org/schemas/media/snps,dw-mipi-csi2-v150.yaml#
> > > > > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > > > > +
> > > > > +title: Synopsys DesignWare CSI-2 Host controller (csi2host)
> > > > > +
> > > > > +maintainers:
> > > > > +  - Frank Li <Frank.Li@nxp.com>
> > > > > +
> > > > > +description:
> > > > > +  CSI2HOST is used to receive image coming from an MIPI CSI-2 compatible
> > > > > +  camera. It will convert the incoming CSI-2 stream into a dedicated
> > > > > +  interface called the Synopsys IDI (Image Data Interface).
> > > > > +  This interface is a 32-bit SoC internal only, and can be assimilated
> > > > > +  with a CSI-2 interface.
> > > > > +
> > > > > +properties:
> > > > > +  compatible:
> > > > > +    items:
> > > > > +      - enum:
> > > > > +          - fsl,imx93-mipi-csi2
> > > > > +      - const: snps,dw-mipi-csi2-v150
> > > > > +
> > > > > +  reg:
> > > > > +    items:
> > > > > +      - description: MIPI CSI-2 core register
> > > > > +
> > > > > +  reg-names:
> > > > > +    items:
> > > > > +      - const: core
> > > > > +
> > > > > +  clocks:
> > > > > +    maxItems: 2
> > > > > +
> > > > > +  clock-names:
> > > > > +    items:
> > > > > +      - const: per
> > > > > +      - const: pixel
> > > > > +
> > > > > +  phys:
> > > > > +    maxItems: 1
> > > > > +    description: MIPI D-PHY
> > > > > +
> > > > > +  phy-names:
> > > > > +    items:
> > > > > +      - const: rx
> > > > > +
> > > > > +  resets:
> > > > > +    maxItems: 1
> > > > > +
> > > > > +  interrupts:
> > > > > +    maxItems: 1
> > > > > +
> > > > > +  power-domains:
> > > > > +    maxItems: 1
> > > > > +
> > > > > +  ports:
> > > > > +    $ref: /schemas/graph.yaml#/properties/ports
> > > > > +
> > > > > +    properties:
> > > > > +      port@0:
> > > > > +        $ref: /schemas/graph.yaml#/$defs/port-base
> > > > > +        unevaluatedProperties: false
> > > > > +        description:
> > > > > +          Input port node, single endpoint describing the input port.
> > > > > +
> > > > > +        properties:
> > > > > +          endpoint:
> > > > > +            $ref: video-interfaces.yaml#
> > > > > +            unevaluatedProperties: false
> > > > > +            description: Endpoint connected to input device
> > > > > +
> > > > > +            properties:
> > > > > +              bus-type:
> > > > > +                const: 4
> > > >
> > > > If 4 is the only value supported, you can drop the property altogether.
> > >
> > > Sorry, What's your means here? There are more options in video-interfaces.yaml.
> > > here just add restriction for bus-type. otherwise other value can be
> > > provide in dts file.
> >
> > It could, but wouldn't any other value be incorrect?
> 
> at least that 5 # Parallel doesn't make sense for CSI2's input.

The point is that, if the only valid value is CSI-2 DPHY (4), then
there's no need to specify it in DT. The driver would know the input bus
is CSI-2 DPHY, so there's no need to convey that information in the
device tree.

> > In other words, this property is redundant and should be dropped.
> >
> > > > > +
> > > > > +              data-lanes:
> > > > > +                minItems: 1
> > > > > +                maxItems: 4
> > > > > +                items:
> > > > > +                  maximum: 4
> > > > > +
> > > > > +      port@1:
> > > > > +        $ref: /schemas/graph.yaml#/$defs/port-base
> > > > > +        unevaluatedProperties: false
> > > > > +        description:
> > > > > +          Output port node, single endpoint describing the output port.
> > > > > +
> > > > > +        properties:
> > > > > +          endpoint:
> > > > > +            unevaluatedProperties: false
> > > > > +            $ref: video-interfaces.yaml#
> > > > > +            description: Endpoint connected to output device
> > > > > +
> > > > > +            properties:
> > > > > +              bus-type:
> > > > > +                const: 4
> > > >
> > > > Are both input and output of this block CSI-2 with D-PHY?
> > >
> > > Yes, input from camera sensor, output to others image processors to do data
> > > transfer or format convert.
> >
> > The description appears to be saying this is "Synopsys IDI", not CSI-2 with
> > D-PHY. We don't have a bus-type for IDI. Couldn't you simply drop it?

-- 
Regards,

Laurent Pinchart