diff mbox series

[v4,5/5] media: bcm2835-unicam: Add TODO file

Message ID 20201110174036.220883-6-jacopo@jmondi.org
State New
Headers show
Series media: staging: Add bcm2835-unicam driver | expand

Commit Message

Jacopo Mondi Nov. 10, 2020, 5:40 p.m. UTC
The bcm2835-unicam driver is currently in staging mainly for
two reasons:
- Handling of CSI-2 embedded data
- Usage of both media controller API and subdev kAPI

Provide a more detailed description of the currently on-going design
discussions in the associated TODO file.

Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>
---
 drivers/staging/media/bcm2835-unicam/TODO | 37 +++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 drivers/staging/media/bcm2835-unicam/TODO

Comments

Sakari Ailus Dec. 2, 2020, 10:06 p.m. UTC | #1
Hi Jacopo,

On Tue, Nov 10, 2020 at 06:40:36PM +0100, Jacopo Mondi wrote:
> The bcm2835-unicam driver is currently in staging mainly for

> two reasons:

> - Handling of CSI-2 embedded data

> - Usage of both media controller API and subdev kAPI

> 

> Provide a more detailed description of the currently on-going design

> discussions in the associated TODO file.

> 

> Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>

> ---

>  drivers/staging/media/bcm2835-unicam/TODO | 37 +++++++++++++++++++++++

>  1 file changed, 37 insertions(+)

>  create mode 100644 drivers/staging/media/bcm2835-unicam/TODO

> 

> diff --git a/drivers/staging/media/bcm2835-unicam/TODO b/drivers/staging/media/bcm2835-unicam/TODO

> new file mode 100644

> index 0000000000000..c7840872eea4c

> --- /dev/null

> +++ b/drivers/staging/media/bcm2835-unicam/TODO

> @@ -0,0 +1,37 @@

> +BCM2835 Unicam driver TODO list

> +===============================

> +

> +The unicam driver could be considered ready to be moved out of the staging

> +directory in terms of code quality and expected functionalities.

> +

> +However there currently are two design issues that suggest the driver is

> +better kept in staging for the time being.

> +

> +CSI-2 Embedded data support:

> +----------------------------

> +

> +The RaspberryPi camera stack and camera applications rely on the availability of

> +the sensor produced CSI-2 embedded data, whose support is currently not

> +finalized in mainline Linux.

> +

> +The driver conditionally registers an additional video device node

> +'unicam-embedded' with a single sink pad which connects to the sensor

> +sub-device source pad #1 to expose ancillary data.

> +

> +Currently none of the mainline sensor drivers register more than a single pad,

> +and consequentially no embedded data from the sensor are exposed to userspace.

> +

> +The current implementation is then subject to changes depending on how support

> +for CSI-2 embedded data gets finalized in Linux.


Are you looking to use out-of-tree sensor drivers that have two pads? I'd
rather see sensor drivers merged to mainline proper.

But as noted in the other e-mail, we need VC / stream support so this needs
to be addressed for reasons not related to Unicam.

> +

> +Media controller support:

> +-------------------------

> +

> +Due to compatibility reasons with the existing RaspberryPi software ecosystem

> +the unicam driver implements the media controller interface to allow the

> +enumeration of the connected entities but handles the configuration of the

> +sensor sub-device using the v4l2-subdev kAPI instead of delegating that to

> +user-space.

> +

> +Discussions are on-going on how this should be better handled (driver option,

> +KConfig option etc etc).


That's a fair use case. There are two ways to handle it, either in the
kernel where the choice affects how the user space looks like. You have an
option of module parameter or Kconfig option there, and both are true
annoyances.

Another option is to work around it in the user space, wrapping the IOCTL
calls. This way no kernel build or module load time parameters would be
needed to switch between the two sets of user space programs.

We probably can't decide it now, but could an MC-only driver + user space
compatibility layer be an option here?

-- 
Kind regards,

Sakari Ailus
Dave Stevenson Dec. 3, 2020, 11:42 a.m. UTC | #2
Hi Sakari

On Wed, 2 Dec 2020 at 22:07, Sakari Ailus <sakari.ailus@iki.fi> wrote:
>

> Hi Jacopo,

>

> On Tue, Nov 10, 2020 at 06:40:36PM +0100, Jacopo Mondi wrote:

> > The bcm2835-unicam driver is currently in staging mainly for

> > two reasons:

> > - Handling of CSI-2 embedded data

> > - Usage of both media controller API and subdev kAPI

> >

> > Provide a more detailed description of the currently on-going design

> > discussions in the associated TODO file.

> >

> > Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>

> > ---

> >  drivers/staging/media/bcm2835-unicam/TODO | 37 +++++++++++++++++++++++

> >  1 file changed, 37 insertions(+)

> >  create mode 100644 drivers/staging/media/bcm2835-unicam/TODO

> >

> > diff --git a/drivers/staging/media/bcm2835-unicam/TODO b/drivers/staging/media/bcm2835-unicam/TODO

> > new file mode 100644

> > index 0000000000000..c7840872eea4c

> > --- /dev/null

> > +++ b/drivers/staging/media/bcm2835-unicam/TODO

> > @@ -0,0 +1,37 @@

> > +BCM2835 Unicam driver TODO list

> > +===============================

> > +

> > +The unicam driver could be considered ready to be moved out of the staging

> > +directory in terms of code quality and expected functionalities.

> > +

> > +However there currently are two design issues that suggest the driver is

> > +better kept in staging for the time being.

> > +

> > +CSI-2 Embedded data support:

> > +----------------------------

> > +

> > +The RaspberryPi camera stack and camera applications rely on the availability of

> > +the sensor produced CSI-2 embedded data, whose support is currently not

> > +finalized in mainline Linux.

> > +

> > +The driver conditionally registers an additional video device node

> > +'unicam-embedded' with a single sink pad which connects to the sensor

> > +sub-device source pad #1 to expose ancillary data.

> > +

> > +Currently none of the mainline sensor drivers register more than a single pad,

> > +and consequentially no embedded data from the sensor are exposed to userspace.

> > +

> > +The current implementation is then subject to changes depending on how support

> > +for CSI-2 embedded data gets finalized in Linux.

>

> Are you looking to use out-of-tree sensor drivers that have two pads? I'd

> rather see sensor drivers merged to mainline proper.

>

> But as noted in the other e-mail, we need VC / stream support so this needs

> to be addressed for reasons not related to Unicam.


There's a downstream patch for imx219 that adds the second pad [1].
The imx477 driver that is currently only out-of-tree also supports it,
and should be upstreamed once this first wave of patches have got
somewhere.

[1] https://github.com/raspberrypi/linux/commit/fa8131cb1399f2c22de3f29e08ec1658db76552b
It's on the rpi-5.10.y branch too, but that is still being frequently
rebased so no stable commit hashes

> > +

> > +Media controller support:

> > +-------------------------

> > +

> > +Due to compatibility reasons with the existing RaspberryPi software ecosystem

> > +the unicam driver implements the media controller interface to allow the

> > +enumeration of the connected entities but handles the configuration of the

> > +sensor sub-device using the v4l2-subdev kAPI instead of delegating that to

> > +user-space.

> > +

> > +Discussions are on-going on how this should be better handled (driver option,

> > +KConfig option etc etc).

>

> That's a fair use case. There are two ways to handle it, either in the

> kernel where the choice affects how the user space looks like. You have an

> option of module parameter or Kconfig option there, and both are true

> annoyances.

>

> Another option is to work around it in the user space, wrapping the IOCTL

> calls. This way no kernel build or module load time parameters would be

> needed to switch between the two sets of user space programs.

>

> We probably can't decide it now, but could an MC-only driver + user space

> compatibility layer be an option here?


Iff the user-space compatibility layer worked with all standard users
(eg v4l2-ctl, FFmpeg and Gstreamer), then it's plausible, but is that
realistic?

The non-MC approach is mainly for things like the TC358743 HDMI->CSI
bridge and ADV728x-M chips where MC adds nothing, and they do just
work with the likes of FFmpeg and Gstreamer.
Image sensors are generally going to be used under libcamera umbrella,
so there MC works.

Kconfig isn't an option for us as one kernel build needs to support
all potential source devices via DT / runtime changes alone.

I haven't looked in detail at what the previous VC / stream patches
proposed as the API for passing the configuration. We only need MC for
the more complex use cases, so if that VC/stream API usage can be
detected at probe then we can switch to MC. It doesn't seem
unreasonable to expect any sensor drivers to be upgraded to correctly
use the new API even if they don't actually produce embedded data.
We also want MC for ADV748x HDMI&analog->CSI bridges that expose
multiple subdevs, but there we can look at the upstream endpoint and
see if it has any sink pads. Sink pads mean MC is needed. (I now have
a board with an ADV7482 on, so when time allows I'm intending to have
an experiment with it).
Use a module parameter as a last resort should the detection fail, or
I guess if you want to override the detected setting for some reason
(a simple sensor being used outside of libcamera for example).

Cheers.
  Dave
Laurent Pinchart Jan. 5, 2021, 1:30 p.m. UTC | #3
Hi Dave and Sakari,

On Thu, Dec 03, 2020 at 11:42:38AM +0000, Dave Stevenson wrote:
> On Wed, 2 Dec 2020 at 22:07, Sakari Ailus <sakari.ailus@iki.fi> wrote:

> > On Tue, Nov 10, 2020 at 06:40:36PM +0100, Jacopo Mondi wrote:

> > > The bcm2835-unicam driver is currently in staging mainly for

> > > two reasons:

> > > - Handling of CSI-2 embedded data

> > > - Usage of both media controller API and subdev kAPI

> > >

> > > Provide a more detailed description of the currently on-going design

> > > discussions in the associated TODO file.

> > >

> > > Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>

> > > ---

> > >  drivers/staging/media/bcm2835-unicam/TODO | 37 +++++++++++++++++++++++

> > >  1 file changed, 37 insertions(+)

> > >  create mode 100644 drivers/staging/media/bcm2835-unicam/TODO

> > >

> > > diff --git a/drivers/staging/media/bcm2835-unicam/TODO b/drivers/staging/media/bcm2835-unicam/TODO

> > > new file mode 100644

> > > index 0000000000000..c7840872eea4c

> > > --- /dev/null

> > > +++ b/drivers/staging/media/bcm2835-unicam/TODO

> > > @@ -0,0 +1,37 @@

> > > +BCM2835 Unicam driver TODO list

> > > +===============================

> > > +

> > > +The unicam driver could be considered ready to be moved out of the staging

> > > +directory in terms of code quality and expected functionalities.

> > > +

> > > +However there currently are two design issues that suggest the driver is

> > > +better kept in staging for the time being.

> > > +

> > > +CSI-2 Embedded data support:

> > > +----------------------------

> > > +

> > > +The RaspberryPi camera stack and camera applications rely on the availability of

> > > +the sensor produced CSI-2 embedded data, whose support is currently not

> > > +finalized in mainline Linux.

> > > +

> > > +The driver conditionally registers an additional video device node

> > > +'unicam-embedded' with a single sink pad which connects to the sensor

> > > +sub-device source pad #1 to expose ancillary data.

> > > +

> > > +Currently none of the mainline sensor drivers register more than a single pad,

> > > +and consequentially no embedded data from the sensor are exposed to userspace.

> > > +

> > > +The current implementation is then subject to changes depending on how support

> > > +for CSI-2 embedded data gets finalized in Linux.

> >

> > Are you looking to use out-of-tree sensor drivers that have two pads? I'd

> > rather see sensor drivers merged to mainline proper.

> >

> > But as noted in the other e-mail, we need VC / stream support so this needs

> > to be addressed for reasons not related to Unicam.

> 

> There's a downstream patch for imx219 that adds the second pad [1].

> The imx477 driver that is currently only out-of-tree also supports it,

> and should be upstreamed once this first wave of patches have got

> somewhere.

> 

> [1] https://github.com/raspberrypi/linux/commit/fa8131cb1399f2c22de3f29e08ec1658db76552b

> It's on the rpi-5.10.y branch too, but that is still being frequently

> rebased so no stable commit hashes

> 

> > > +

> > > +Media controller support:

> > > +-------------------------

> > > +

> > > +Due to compatibility reasons with the existing RaspberryPi software ecosystem

> > > +the unicam driver implements the media controller interface to allow the

> > > +enumeration of the connected entities but handles the configuration of the

> > > +sensor sub-device using the v4l2-subdev kAPI instead of delegating that to

> > > +user-space.

> > > +

> > > +Discussions are on-going on how this should be better handled (driver option,

> > > +KConfig option etc etc).

> >

> > That's a fair use case. There are two ways to handle it, either in the

> > kernel where the choice affects how the user space looks like. You have an

> > option of module parameter or Kconfig option there, and both are true

> > annoyances.

> >

> > Another option is to work around it in the user space, wrapping the IOCTL

> > calls. This way no kernel build or module load time parameters would be

> > needed to switch between the two sets of user space programs.

> >

> > We probably can't decide it now, but could an MC-only driver + user space

> > compatibility layer be an option here?

> 

> Iff the user-space compatibility layer worked with all standard users

> (eg v4l2-ctl, FFmpeg and Gstreamer), then it's plausible, but is that

> realistic?


We have a compatibility layer in libcamera, implemented with a
best-effort approach (as the gap between a V4L2 video node and a complex
camera is larger to bridge than between a video node and an MC-based
device with a simple linear capture pipeline). It works, but has its
share of issues as LD_PRELOAD'ing a library isn't always a practical
option.

I believe the wrapper that Sakari envisions is feasible to implement as
the problem space is smaller (in a way the code already exists in kernel
space in the unicam driver, it bridges between the video node and the
input subdev). The tricky part will be to make it nice to use.

> The non-MC approach is mainly for things like the TC358743 HDMI->CSI

> bridge and ADV728x-M chips where MC adds nothing, and they do just

> work with the likes of FFmpeg and Gstreamer.


There are of devices that won't benefit much from an MC-based approach,
but note that in the non-camera use cases, you could have chips such as
the ADV748x which has one HDMI input, 8 analog inputs and two CSI-2
outputs with configurable routing in-between.

> Image sensors are generally going to be used under libcamera umbrella,

> so there MC works.

> 

> Kconfig isn't an option for us as one kernel build needs to support

> all potential source devices via DT / runtime changes alone.

>

> I haven't looked in detail at what the previous VC / stream patches

> proposed as the API for passing the configuration. We only need MC for

> the more complex use cases, so if that VC/stream API usage can be

> detected at probe then we can switch to MC. It doesn't seem

> unreasonable to expect any sensor drivers to be upgraded to correctly

> use the new API even if they don't actually produce embedded data.


I'm not sure that would be the case, support for multiplexed streams
would be on top of the V4L2 subdev in-kernel API, and I don't expect
changes in camera sensors that don't support multiple streams.

> We also want MC for ADV748x HDMI&analog->CSI bridges that expose


There we go :-)

> multiple subdevs, but there we can look at the upstream endpoint and

> see if it has any sink pads. Sink pads mean MC is needed. (I now have

> a board with an ADV7482 on, so when time allows I'm intending to have

> an experiment with it).


Note that we will likely, in the future, introduce media entities for
connectors, which means that a device such as the TC358743 would have a
sink pad connected to an HDMI connector entity.

> Use a module parameter as a last resort should the detection fail, or

> I guess if you want to override the detected setting for some reason

> (a simple sensor being used outside of libcamera for example).


-- 
Regards,

Laurent Pinchart
Dave Stevenson Jan. 11, 2021, 3:12 p.m. UTC | #4
Hi Laurent

On Tue, 5 Jan 2021 at 13:30, Laurent Pinchart
<laurent.pinchart@ideasonboard.com> wrote:
>

> Hi Dave and Sakari,

>

> On Thu, Dec 03, 2020 at 11:42:38AM +0000, Dave Stevenson wrote:

> > On Wed, 2 Dec 2020 at 22:07, Sakari Ailus <sakari.ailus@iki.fi> wrote:

> > > On Tue, Nov 10, 2020 at 06:40:36PM +0100, Jacopo Mondi wrote:

> > > > The bcm2835-unicam driver is currently in staging mainly for

> > > > two reasons:

> > > > - Handling of CSI-2 embedded data

> > > > - Usage of both media controller API and subdev kAPI

> > > >

> > > > Provide a more detailed description of the currently on-going design

> > > > discussions in the associated TODO file.

> > > >

> > > > Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>

> > > > ---

> > > >  drivers/staging/media/bcm2835-unicam/TODO | 37 +++++++++++++++++++++++

> > > >  1 file changed, 37 insertions(+)

> > > >  create mode 100644 drivers/staging/media/bcm2835-unicam/TODO

> > > >

> > > > diff --git a/drivers/staging/media/bcm2835-unicam/TODO b/drivers/staging/media/bcm2835-unicam/TODO

> > > > new file mode 100644

> > > > index 0000000000000..c7840872eea4c

> > > > --- /dev/null

> > > > +++ b/drivers/staging/media/bcm2835-unicam/TODO

> > > > @@ -0,0 +1,37 @@

> > > > +BCM2835 Unicam driver TODO list

> > > > +===============================

> > > > +

> > > > +The unicam driver could be considered ready to be moved out of the staging

> > > > +directory in terms of code quality and expected functionalities.

> > > > +

> > > > +However there currently are two design issues that suggest the driver is

> > > > +better kept in staging for the time being.

> > > > +

> > > > +CSI-2 Embedded data support:

> > > > +----------------------------

> > > > +

> > > > +The RaspberryPi camera stack and camera applications rely on the availability of

> > > > +the sensor produced CSI-2 embedded data, whose support is currently not

> > > > +finalized in mainline Linux.

> > > > +

> > > > +The driver conditionally registers an additional video device node

> > > > +'unicam-embedded' with a single sink pad which connects to the sensor

> > > > +sub-device source pad #1 to expose ancillary data.

> > > > +

> > > > +Currently none of the mainline sensor drivers register more than a single pad,

> > > > +and consequentially no embedded data from the sensor are exposed to userspace.

> > > > +

> > > > +The current implementation is then subject to changes depending on how support

> > > > +for CSI-2 embedded data gets finalized in Linux.

> > >

> > > Are you looking to use out-of-tree sensor drivers that have two pads? I'd

> > > rather see sensor drivers merged to mainline proper.

> > >

> > > But as noted in the other e-mail, we need VC / stream support so this needs

> > > to be addressed for reasons not related to Unicam.

> >

> > There's a downstream patch for imx219 that adds the second pad [1].

> > The imx477 driver that is currently only out-of-tree also supports it,

> > and should be upstreamed once this first wave of patches have got

> > somewhere.

> >

> > [1] https://github.com/raspberrypi/linux/commit/fa8131cb1399f2c22de3f29e08ec1658db76552b

> > It's on the rpi-5.10.y branch too, but that is still being frequently

> > rebased so no stable commit hashes

> >

> > > > +

> > > > +Media controller support:

> > > > +-------------------------

> > > > +

> > > > +Due to compatibility reasons with the existing RaspberryPi software ecosystem

> > > > +the unicam driver implements the media controller interface to allow the

> > > > +enumeration of the connected entities but handles the configuration of the

> > > > +sensor sub-device using the v4l2-subdev kAPI instead of delegating that to

> > > > +user-space.

> > > > +

> > > > +Discussions are on-going on how this should be better handled (driver option,

> > > > +KConfig option etc etc).

> > >

> > > That's a fair use case. There are two ways to handle it, either in the

> > > kernel where the choice affects how the user space looks like. You have an

> > > option of module parameter or Kconfig option there, and both are true

> > > annoyances.

> > >

> > > Another option is to work around it in the user space, wrapping the IOCTL

> > > calls. This way no kernel build or module load time parameters would be

> > > needed to switch between the two sets of user space programs.

> > >

> > > We probably can't decide it now, but could an MC-only driver + user space

> > > compatibility layer be an option here?

> >

> > Iff the user-space compatibility layer worked with all standard users

> > (eg v4l2-ctl, FFmpeg and Gstreamer), then it's plausible, but is that

> > realistic?

>

> We have a compatibility layer in libcamera, implemented with a

> best-effort approach (as the gap between a V4L2 video node and a complex

> camera is larger to bridge than between a video node and an MC-based

> device with a simple linear capture pipeline). It works, but has its

> share of issues as LD_PRELOAD'ing a library isn't always a practical

> option.

>

> I believe the wrapper that Sakari envisions is feasible to implement as

> the problem space is smaller (in a way the code already exists in kernel

> space in the unicam driver, it bridges between the video node and the

> input subdev). The tricky part will be to make it nice to use.

>

> > The non-MC approach is mainly for things like the TC358743 HDMI->CSI

> > bridge and ADV728x-M chips where MC adds nothing, and they do just

> > work with the likes of FFmpeg and Gstreamer.

>

> There are of devices that won't benefit much from an MC-based approach,

> but note that in the non-camera use cases, you could have chips such as

> the ADV748x which has one HDMI input, 8 analog inputs and two CSI-2

> outputs with configurable routing in-between.


The main difference there is that no one has ever been able to use
ADV748x without MC.

Running a mono image sensor, ADV728x-M or TC358743 is all perfectly
possible in a non-MC world. I don't want the headache of all the user
complaints should that get removed, even if able to workaround it with
a LD_PRELOAD library.

Should a wrapper appear then that would potentially remove the need
for the kernel to support a non-MC mode, but currently it looks like a
driver supporting both modes is the only answer.

> > Image sensors are generally going to be used under libcamera umbrella,

> > so there MC works.

> >

> > Kconfig isn't an option for us as one kernel build needs to support

> > all potential source devices via DT / runtime changes alone.

> >

> > I haven't looked in detail at what the previous VC / stream patches

> > proposed as the API for passing the configuration. We only need MC for

> > the more complex use cases, so if that VC/stream API usage can be

> > detected at probe then we can switch to MC. It doesn't seem

> > unreasonable to expect any sensor drivers to be upgraded to correctly

> > use the new API even if they don't actually produce embedded data.

>

> I'm not sure that would be the case, support for multiplexed streams

> would be on top of the V4L2 subdev in-kernel API, and I don't expect

> changes in camera sensors that don't support multiple streams.

>

> > We also want MC for ADV748x HDMI&analog->CSI bridges that expose

>

> There we go :-)


New use case, therefore no existing user expectations on how it would work.

> > multiple subdevs, but there we can look at the upstream endpoint and

> > see if it has any sink pads. Sink pads mean MC is needed. (I now have

> > a board with an ADV7482 on, so when time allows I'm intending to have

> > an experiment with it).

>

> Note that we will likely, in the future, introduce media entities for

> connectors, which means that a device such as the TC358743 would have a

> sink pad connected to an HDMI connector entity.


Would that count as an improvement?
I thought the golden rule was not to break userspace, but you'd be
enforcing extra userspace steps in configuring the device if it gains
more MC entities. Not my call though.

I'm tied up with other stuff at present, but will be looking at adding
MC rather than video node based mode of operation when time allows.

  Dave

> > Use a module parameter as a last resort should the detection fail, or

> > I guess if you want to override the detected setting for some reason

> > (a simple sensor being used outside of libcamera for example).

>

> --

> Regards,

>

> Laurent Pinchart
Laurent Pinchart Jan. 11, 2021, 3:33 p.m. UTC | #5
Hi Dave,

On Mon, Jan 11, 2021 at 03:12:10PM +0000, Dave Stevenson wrote:
> On Tue, 5 Jan 2021 at 13:30, Laurent Pinchart wrote:

> > On Thu, Dec 03, 2020 at 11:42:38AM +0000, Dave Stevenson wrote:

> > > On Wed, 2 Dec 2020 at 22:07, Sakari Ailus <sakari.ailus@iki.fi> wrote:

> > > > On Tue, Nov 10, 2020 at 06:40:36PM +0100, Jacopo Mondi wrote:

> > > > > The bcm2835-unicam driver is currently in staging mainly for

> > > > > two reasons:

> > > > > - Handling of CSI-2 embedded data

> > > > > - Usage of both media controller API and subdev kAPI

> > > > >

> > > > > Provide a more detailed description of the currently on-going design

> > > > > discussions in the associated TODO file.

> > > > >

> > > > > Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>

> > > > > ---

> > > > >  drivers/staging/media/bcm2835-unicam/TODO | 37 +++++++++++++++++++++++

> > > > >  1 file changed, 37 insertions(+)

> > > > >  create mode 100644 drivers/staging/media/bcm2835-unicam/TODO

> > > > >

> > > > > diff --git a/drivers/staging/media/bcm2835-unicam/TODO b/drivers/staging/media/bcm2835-unicam/TODO

> > > > > new file mode 100644

> > > > > index 0000000000000..c7840872eea4c

> > > > > --- /dev/null

> > > > > +++ b/drivers/staging/media/bcm2835-unicam/TODO

> > > > > @@ -0,0 +1,37 @@

> > > > > +BCM2835 Unicam driver TODO list

> > > > > +===============================

> > > > > +

> > > > > +The unicam driver could be considered ready to be moved out of the staging

> > > > > +directory in terms of code quality and expected functionalities.

> > > > > +

> > > > > +However there currently are two design issues that suggest the driver is

> > > > > +better kept in staging for the time being.

> > > > > +

> > > > > +CSI-2 Embedded data support:

> > > > > +----------------------------

> > > > > +

> > > > > +The RaspberryPi camera stack and camera applications rely on the availability of

> > > > > +the sensor produced CSI-2 embedded data, whose support is currently not

> > > > > +finalized in mainline Linux.

> > > > > +

> > > > > +The driver conditionally registers an additional video device node

> > > > > +'unicam-embedded' with a single sink pad which connects to the sensor

> > > > > +sub-device source pad #1 to expose ancillary data.

> > > > > +

> > > > > +Currently none of the mainline sensor drivers register more than a single pad,

> > > > > +and consequentially no embedded data from the sensor are exposed to userspace.

> > > > > +

> > > > > +The current implementation is then subject to changes depending on how support

> > > > > +for CSI-2 embedded data gets finalized in Linux.

> > > >

> > > > Are you looking to use out-of-tree sensor drivers that have two pads? I'd

> > > > rather see sensor drivers merged to mainline proper.

> > > >

> > > > But as noted in the other e-mail, we need VC / stream support so this needs

> > > > to be addressed for reasons not related to Unicam.

> > >

> > > There's a downstream patch for imx219 that adds the second pad [1].

> > > The imx477 driver that is currently only out-of-tree also supports it,

> > > and should be upstreamed once this first wave of patches have got

> > > somewhere.

> > >

> > > [1] https://github.com/raspberrypi/linux/commit/fa8131cb1399f2c22de3f29e08ec1658db76552b

> > > It's on the rpi-5.10.y branch too, but that is still being frequently

> > > rebased so no stable commit hashes

> > >

> > > > > +

> > > > > +Media controller support:

> > > > > +-------------------------

> > > > > +

> > > > > +Due to compatibility reasons with the existing RaspberryPi software ecosystem

> > > > > +the unicam driver implements the media controller interface to allow the

> > > > > +enumeration of the connected entities but handles the configuration of the

> > > > > +sensor sub-device using the v4l2-subdev kAPI instead of delegating that to

> > > > > +user-space.

> > > > > +

> > > > > +Discussions are on-going on how this should be better handled (driver option,

> > > > > +KConfig option etc etc).

> > > >

> > > > That's a fair use case. There are two ways to handle it, either in the

> > > > kernel where the choice affects how the user space looks like. You have an

> > > > option of module parameter or Kconfig option there, and both are true

> > > > annoyances.

> > > >

> > > > Another option is to work around it in the user space, wrapping the IOCTL

> > > > calls. This way no kernel build or module load time parameters would be

> > > > needed to switch between the two sets of user space programs.

> > > >

> > > > We probably can't decide it now, but could an MC-only driver + user space

> > > > compatibility layer be an option here?

> > >

> > > Iff the user-space compatibility layer worked with all standard users

> > > (eg v4l2-ctl, FFmpeg and Gstreamer), then it's plausible, but is that

> > > realistic?

> >

> > We have a compatibility layer in libcamera, implemented with a

> > best-effort approach (as the gap between a V4L2 video node and a complex

> > camera is larger to bridge than between a video node and an MC-based

> > device with a simple linear capture pipeline). It works, but has its

> > share of issues as LD_PRELOAD'ing a library isn't always a practical

> > option.

> >

> > I believe the wrapper that Sakari envisions is feasible to implement as

> > the problem space is smaller (in a way the code already exists in kernel

> > space in the unicam driver, it bridges between the video node and the

> > input subdev). The tricky part will be to make it nice to use.

> >

> > > The non-MC approach is mainly for things like the TC358743 HDMI->CSI

> > > bridge and ADV728x-M chips where MC adds nothing, and they do just

> > > work with the likes of FFmpeg and Gstreamer.

> >

> > There are of devices that won't benefit much from an MC-based approach,

> > but note that in the non-camera use cases, you could have chips such as

> > the ADV748x which has one HDMI input, 8 analog inputs and two CSI-2

> > outputs with configurable routing in-between.

> 

> The main difference there is that no one has ever been able to use

> ADV748x without MC.

> 

> Running a mono image sensor, ADV728x-M or TC358743 is all perfectly

> possible in a non-MC world. I don't want the headache of all the user

> complaints should that get removed, even if able to workaround it with

> a LD_PRELOAD library.


I agree, an LD_PRELOAD wrapper doesn't bring a great user experience :-(

> Should a wrapper appear then that would potentially remove the need

> for the kernel to support a non-MC mode, but currently it looks like a

> driver supporting both modes is the only answer.


From a backward compatibility point of view, yes, that's the only
solution we have now that will be 100% transparent and compatible.

> > > Image sensors are generally going to be used under libcamera umbrella,

> > > so there MC works.

> > >

> > > Kconfig isn't an option for us as one kernel build needs to support

> > > all potential source devices via DT / runtime changes alone.

> > >

> > > I haven't looked in detail at what the previous VC / stream patches

> > > proposed as the API for passing the configuration. We only need MC for

> > > the more complex use cases, so if that VC/stream API usage can be

> > > detected at probe then we can switch to MC. It doesn't seem

> > > unreasonable to expect any sensor drivers to be upgraded to correctly

> > > use the new API even if they don't actually produce embedded data.

> >

> > I'm not sure that would be the case, support for multiplexed streams

> > would be on top of the V4L2 subdev in-kernel API, and I don't expect

> > changes in camera sensors that don't support multiple streams.

> >

> > > We also want MC for ADV748x HDMI&analog->CSI bridges that expose

> >

> > There we go :-)

> 

> New use case, therefore no existing user expectations on how it would work.


Sure, that was only outlining that we need MC support, not that we have
to drop everything else.

> > > multiple subdevs, but there we can look at the upstream endpoint and

> > > see if it has any sink pads. Sink pads mean MC is needed. (I now have

> > > a board with an ADV7482 on, so when time allows I'm intending to have

> > > an experiment with it).

> >

> > Note that we will likely, in the future, introduce media entities for

> > connectors, which means that a device such as the TC358743 would have a

> > sink pad connected to an HDMI connector entity.

> 

> Would that count as an improvement?

> I thought the golden rule was not to break userspace, but you'd be

> enforcing extra userspace steps in configuring the device if it gains

> more MC entities. Not my call though.


Just to clarify, this change will not be applied to existing drivers if
it risks breaking userspace. Furthermore, there will likely be no need
for userspace to configure the connector entity. My point was that logic
in the kernel that looks at the source to see if it has more than just
one output port or pad may not be future-proof, but that's a kernel-side
problem, it shouldn't affect userspace. I'm sure we'll be able to find a
good enough heuristic on the kernel side.

> I'm tied up with other stuff at present, but will be looking at adding

> MC rather than video node based mode of operation when time allows.


That's something I can look at too. The question is how to handle
backward compatibility, my preference would be for the driver core to be
MC-based, and for the compatibility layer to be based on top of that,
isolated from the rest of the code as much as possible. I think it's
doable.

> > > Use a module parameter as a last resort should the detection fail, or

> > > I guess if you want to override the detected setting for some reason

> > > (a simple sensor being used outside of libcamera for example).


-- 
Regards,

Laurent Pinchart
diff mbox series

Patch

diff --git a/drivers/staging/media/bcm2835-unicam/TODO b/drivers/staging/media/bcm2835-unicam/TODO
new file mode 100644
index 0000000000000..c7840872eea4c
--- /dev/null
+++ b/drivers/staging/media/bcm2835-unicam/TODO
@@ -0,0 +1,37 @@ 
+BCM2835 Unicam driver TODO list
+===============================
+
+The unicam driver could be considered ready to be moved out of the staging
+directory in terms of code quality and expected functionalities.
+
+However there currently are two design issues that suggest the driver is
+better kept in staging for the time being.
+
+CSI-2 Embedded data support:
+----------------------------
+
+The RaspberryPi camera stack and camera applications rely on the availability of
+the sensor produced CSI-2 embedded data, whose support is currently not
+finalized in mainline Linux.
+
+The driver conditionally registers an additional video device node
+'unicam-embedded' with a single sink pad which connects to the sensor
+sub-device source pad #1 to expose ancillary data.
+
+Currently none of the mainline sensor drivers register more than a single pad,
+and consequentially no embedded data from the sensor are exposed to userspace.
+
+The current implementation is then subject to changes depending on how support
+for CSI-2 embedded data gets finalized in Linux.
+
+Media controller support:
+-------------------------
+
+Due to compatibility reasons with the existing RaspberryPi software ecosystem
+the unicam driver implements the media controller interface to allow the
+enumeration of the connected entities but handles the configuration of the
+sensor sub-device using the v4l2-subdev kAPI instead of delegating that to
+user-space.
+
+Discussions are on-going on how this should be better handled (driver option,
+KConfig option etc etc).