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

From: Kieran Bingham

Date: Sat Sep 19 2026 - 07:24:54 EST


Hi all,

+Dave @ Rpi

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).

It's a bit like Raspberry Pi's original 15 pin connector. If we wound
the clock back 15 years and tried this with RPi we'd have:

raspberrypi,camera-connector
raspberrypi,camera-connector-22pin

I mean that's fine too - but if we're specifying the pin in one we may
as well do it in all...


> I agree the name seems a bit generic, but if you really can't come up
> with something better, then fine. The next connector name just has to be
> something different.

Indeed.

I'm very happy that we have actual progress on how we might handle
camera connectors though!

I'm going to have to try to do the same proposal for RPi connectors
aren't I ;-)

If I post patches, I'll use the full form:


raspberrypi,camera-connector-15pin
raspberrypi,camera-connector-22pin


I'm curious if anyone at RPi has any opinion, given it's 'their' standard.

Dave? any thoughts here ?

--
Kieran


>
> Rob