Re: [PATCH 3/6] dt-bindings: connector: Add Toradex camera connector

[Francesco Dolcini]

Hello Kieran,

On Sat, Sep 19, 2026 at 12:24:38PM +0100, Kieran Bingham wrote:
> Quoting Rob Herring (2026-09-18 20:24:47)
> > On Thu, Sep 10, 2026 at 07:12:05PM +0200, Francesco Dolcini wrote:
> > > On Thu, Sep 10, 2026 at 12:01:51PM -0500, Frank Li wrote:
> > > > On Thu, Sep 10, 2026 at 06:39:30PM +0200, Ernest Van Hoecke wrote:
> > > > > Hi Frank,
> > > > >
> > > > > Thanks for reviewing this so quickly.
> > > > >
> > > > > On Thu, Sep 10, 2026 at 11:26:22AM -0500, Frank Li wrote:
> > > > > > On Thu, Sep 10, 2026 at 05:37:59PM +0200, Ernest Van Hoecke wrote:
> > > > > > > From: Ernest Van Hoecke <ernest.vanhoecke@xxxxxxxxxxx>
> > > > > > >
> > > > > > > Toradex boards route the sideband signals of their 24-pin camera
> > > > > > > connectors to different GPIO controllers. Camera overlays which name
> > > > > > > those controllers directly must therefore be duplicated for each host
> > > > > > > board.
> > > > > > >
> > > > > > > Describe reset, power-down, detection and power-control as
> > > > > > > connector-local GPIO functions. This lets an accessory overlay remain
> > > > > > > independent of the host wiring. MIPI CSI-2, I2C, clocks and supplies
> > > > > > > remain described separately because the GPIO nexus does not abstract
> > > > > > > them.
> > > > > > >
> > > > > > > Signed-off-by: Ernest Van Hoecke <ernest.vanhoecke@xxxxxxxxxxx>
> > > > > > > ---
> > > > > > >  .../connector/toradex,camera-connector.yaml        | 86 ++++++++++++++++++++++
> > > > > > >  1 file changed, 86 insertions(+)
> > > > > > >
> > > > > > > diff --git a/Documentation/devicetree/bindings/connector/toradex,camera-connector.yaml b/Documentation/devicetree/bindings/connector/toradex,camera-connector.yaml
> > > > > > > new file mode 100644
> > > > > > > index 000000000000..06e6836e1aa6
> > > > > > > --- /dev/null
> > > > > > > +++ b/Documentation/devicetree/bindings/connector/toradex,camera-connector.yaml
> > > > > > > @@ -0,0 +1,86 @@
> > > > > > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> > > > > > > +%YAML 1.2
> > > > > > > +---
> > > > > > > +$id: http://devicetree.org/schemas/connector/toradex,camera-connector.yaml#
> > > > > > > +$schema: http://devicetree.org/meta-schemas/base.yaml#
> > > > > > > +
> > > > > > > +title: Toradex camera connector GPIO nexus
> > > > > > > +
> > > > > > > +maintainers:
> > > > > > > +  - Ernest Van Hoecke <ernest.vanhoecke@xxxxxxxxxxx>
> > > > > > > +  - Toradex Linux BSP Team <linux-bsp@xxxxxxxxxxx>
> > > > > > > +
> > > > > > > +description: |
> > > > > > > +  Toradex boards provide 24-pin camera connectors carrying MIPI CSI-2, I2C,
> > > > > > > +  clock, power, and sideband GPIO signals. This binding describes the sideband
> > > > > > > +  signals as a GPIO nexus. The other connector resources remain described by
> > > > > > > +  the surrounding board device tree.
> > > > > > > +
> > > > > > > +  The nexus exposes connector-local GPIO function numbers to camera overlays
> > > > > > > +  and maps the functions wired by a carrier board to their GPIO controllers.
> > > > > > > +  GPIO specifiers contain a function number followed by standard GPIO flags.
> > > > > > > +  A board may omit functions which it does not wire.
> > > > > > > +
> > > > > > > +  The function numbers are:
> > > > > > > +    - 0: Camera reset, connector pin 11
> > > > > > > +    - 1: Camera power-down, connector pin 22
> > > > > > > +    - 2: Camera identification, connector pin 23
> > > > > > > +    - 3: Camera power control, connector pin 24
> > > > > > > +
> > > > > > > +properties:
> > > > > > > +  compatible:
> > > > > > > +    const: toradex,camera-connector
> > > > > >
> > > > > > Name is too generally, suggest use board name, we got similar comments at
> > > > > >
> > > > > > https://lore.kernel.org/imx/20260629074734.3643227-2-chancel.liu@xxxxxxxxxxx/
> > > > >
> > > > > I saw that and it made me reconsider this name.
> > > > >
> > > > > However, I believe that in our case it is specific enough. It is really
> > > > > the same on all our carrier boards, and Toradex specific. It's also only
> > > > > for cameras, which is more defined than just "io". Curious to see if
> > > > > others agree or if we should come up with a name for this.
> > > > 
> > > > If some days later, you update hardware connector to 30pin from 24pins.
> > > 
> > > That connector is there since years, not days.
> > > 
> > > We have multiple cameras, designed to mate with it.
> > > 
> > > If tomorrow we will define a new camera connector (that is absolutely
> > > possible), the new connector will get its name, maybe
> > > toradex,camera-connector-v2, or toradex,camera-connector-22pin or
> > > whatever that connector would be named, not just in the DT, but also as
> > > a product and on the actual HW.
> > 
> 
> Diving in because, cameras :D
> 
> 
> > I for one hate 'v2' naming.
> > 
> 
> Me too. I wouldn't ever call it v2, but a future
> toradex,camera-connector-24pin might be appropriate.
> 
> Note that I specifically said 24 as an example because there is already
> a 22 pin Raspberry Pi connector.
> 
> If Toradex were to produce boards with a 22 pin connector, I would
> anticipate it to be the same pinout as the Raspberry Pi connector.
> 
> Raspberry Pi camera connectors have already somewhat become a defacto
> standard (albeit for both positives and negatives there).
> 
> So I would imagine if a 22 pin layout were ever made it would be
> compatible with RPi 22. And if Toradex ever make a 22 pin connector
> which is not RPi compatible ... well I might scream into the void ;-)
> but then it would have a toradex prefix I guess!
> 
> 
> Equally we have other vendors who have 30 pin connectors (There are
> quite a few, so I have myself a research project to go find out how
> {in,}compatible they all are here ...)
> 
> So, I would imagine if we're giong to name connectors we should set out
> an expectation to start with
> 
>   toradex,camera-connector-30pin
>   raspberrypi,camera-connector-15pin
>   raspberrypi,camera-connector-22pin
> 
> And if Toradex were to make a *different* 22 pin connector then it would
> be:
> 
>   toradex,camera-connector-22pin,
> 
> But if it's RPi layout, then it would be defined as such.
> 
> 
> All that to say - I think Toradex certainly warrant a specific
> 
>   toradex,camera-connector
> 
> But I think specifiying the pin count already could be useful (but not
> essential).

As Toradex, this is how this connector is called, and there is no plan
to design a new one. If you want a full descriptive name you can call it
"Toradex MIPI CSI-2 Camera Connector".

I see no evidence that we are going to have a connector with a different
amount of pins anytime, if we would redesign the connector today it will
likely have the same pin count but 1v8 logic instead of 3v3, and your
proposal would not help.

A little bit more data on what we have today, the connector is a 24-pin
0.5mm pitch FFC/FPC, it goes back to 2017 and it never changed after
that. It is currently implemented in Apalis, Verdin, Aquila, SMARC and
OSM Toradex Carrier boards.

Francesco