Em Thu, 13 Aug 2015 08:09:13 -0300 Mauro Carvalho Chehab mchehab@osg.samsung.com escreveu:

Em Thu, 13 Aug 2015 00:56:49 +0300 Laurent Pinchart laurent.pinchart@ideasonboard.com escreveu:

...

Hi Mauro,

Thank you for the report. Please see inline for a couple of small comments.

Thanks for the review. It follows the version 2 of the draft. Please check if it is now ok. If not, please propose a better text to cover your issues.

PS.: I'll add in the end a diff, as it could be easier to just look on the changes, instead of reading the entire text again ;)

Regards, Mauro

---

This is the second draft of the Media Controller Workshop report.

It was complex to do this report based on the notes we took, as some notes were incomplete. I did my best, but I'm sure some items need some review, in special the presentations.

Feel free to review and send me your comments for me to add in the final MC workshop report and send to the main mailing list.

Changes from version 1:

- Addressed the points that Laurent pointed on his review.

Sakari,

I'm still waiting for the email of the two guys from Intel that participated on our first day. Could you please send it for me to complete at the report?

Thanks! Mauro

--

Report of the Media Controller workshop in Espoo, Finland – July, 29-31 2015

This is the first workshop dedicated to the Media Controller. We actually did a v4l summit in 2010, also in Finland, that stablished the current foundation for the media controller, and was meant to satisfy the needs of properly reporting the pipelines on the SoC used by smartphones. The focus of this year's workshop is to clarify the kernel→userspace interfaces and extend the Media Controller to be used on other subsystems that need to represent graphs, like DVB, ALSA and IIO.

Main event attendees:

Antti Laakso Hans Verkuilhansverk@cisco.com Lars-Peter Clausen lars@metafoo.de Laurent Pinchart laurent.pinchart@ideasonboard.com Mauro Chehab mchehab@osg.samsung.com Sakari Ailus sakari.ailus@iki.fi Shuah Khan shuahkh@osg.samsung.com Tuukka Toivonen

MC videoconf attendees:

Dong-Joo Kim dj98.kim@samsung.com Geunyoung Kim nenggun.kim@samsung.com In-Ki Dae inki.dae@samsung.com Junghak Sung jh1009.sung@samsung.com Minsong Kim ms17.kim@samsung.com Ohin Kwon rany.kwon@samsung.com Seung-Woo Kim sw0312.kim@samsung.com

EDITOR'S NOTE: Usually, we produce the summit reports using a cronologic approach. This time, I opted to move the content of the second day to the beginning of the report, as they're basically several presentations we had covering the Media Controller needs. I opted to put the presentations first, and then put the discussions we had on July 29 and 31 together.

1) Presentations made on July, 30

1.1. Videobuf2 redesign to allow it to support DVB

Presentation made by Samsung via videoconf about the scheduled changes that are planned in order to split the videobuf2 core from the V4L2 specific part, in order to allow the videobuf2 core to be used also for DVB

1.2. DVB pipelines

Presentation made by Samsung via videoconf about the pipelines. Basically, the pipelines on real usecases for embedded devices would look like:

tuner 1 -> -> demux -> Video tuner 2 -> cam 1 -> demux -> Audio tuner 3 -> cam 2 -> demux -> Data -> V4L2 -> ALSA

1.3. ASoC

http://linuxtv.org/downloads/presentations/mc_ws_2015/sound_media_controller...

Generic DT machine driver can support around half of DT based devices Not all required data available in ACPI, so ACPI based devices typically have their own drivers DAPM does power management in ASoC much like the current omap3isp driver implementation does Walks the graph Supports large numbers of entities and cyclical graphs Contains ASoC dependencies, but the core of the algorithm is generic Stack based, iterative version in works MC has generic graph walking code as well Iterative Less concerned with performance omap3isp driver has PM code, which could be more generic Ideally we should have single implementation for graph walking and for power management

1.4 Updates to ALSA and au0828 to share resources:

1. state->pads[AU8522_PAD_AUDIO_OUT].flags = MEDIA_PAD_FL_SINK; Need to be MEDIA_PAD_FL_SOURCE; 2. ALSA: to use on a non-atomic context: pcm->substream->nonatomic IRQ safe start/stop pipeline isn't necessary. Not a good idea to change graph_mutex to spinlock. I2C drivers will break. This will reduce the work and patch series v6 becomes smaller. 3. enable_source is necessary at media_device level, but find a better name 4. Write helper function to hde decoder and tuner details from ALSA 5. remove link is needed - implement - Shuah can do that as part of ALSA work 6. Managed Media Controller API - devres - change it to get reference and put reference. It isn't safe to delete media_device device resource. media_device_get() and media_device_put() Keep /dev/media device open and unplug the usb device - kernel would crash

1.4 IIO - Industrial I/O

http://linuxtv.org/downloads/presentations/mc_ws_2015/iio_media_controller.p...

- ADC, DAC, accelerometer, gyro, light sensor, pressure, manometer - typically: low speed < 10kbaud, I2C/SPI - changes: up to 5Gbaud, separate control and data bus (LVDS, JESD204b) - can be used by multi-channel SDR

2) Keysign party at the afternoon of July, 30

We did a Keysign party, where the gpg keys got cross-signed among the participants.

3) Discussions about the Media Controller API and the needs to extend it to support the requirements for DVB, ALSA and IIO

3.1) Discussions took at July, 29

Basic requirements: - Properly represent kernel→userspace API interfaces; - Allow dynamic pipeline changes; - Define the namespace for interfaces and entities; - Support additional properties; - Better represent entities that belong to more than one type

It was proposed to use the concept of planes, as defined by ITU and IEEE to represent different layers of a data or media network (ITU-T G.800). So, we would have control and data planes.

http://linuxtv.org/downloads/presentations/mc_ws_2015/media_controller_summi...

This is a concept largely used on networks, as show at: http://etherealmind.com/controller-based-networks-for-data-centres/

Multiple options to express association between device nodes and entities: - Same IOCTL API as for data links, difference made between data and control links - Different IOCTL API to enumerate interfaces, with associated entities - Properties

The decision was, instead, to add a new graph element type (Interface) to represent the elements that controls the entities.

It was agreed with the following terminology: - Entity: Functional unit, typically a hardware component or subunit in a hardware component - Pad: Data Input/Output of an entity - Interface: Control point implementing a userspace API - Link: Connection between a source pad and a sink pad

It was also proposed to use the name “association” for the links between interface and entity, but there was no consensus about that idea.

EDITOR'S NOTE: It was decided on July, 31 to use the name “links” also for the connection between an entity and an interface. We used the term “interface links” for such links when we need to distinguish them from “data links” (e. g. pad to pad links).

Mauro's concern is that there will be lots of code duplication in the Kernel if we use a different graph type for the interface links.

The relationship between Interfaces and entities are n-n: - One interface can control multiple entities - One entity can be controlled by multiple interfaces

Media interfaces - A concept of user space facing interfaces - An object of its own right (such as media entities) - At the same level than entities, e. g. they'll be at the same graph, and not on separate planes

Working proposal (as proposed on July, 29)

- Introduce struct media_interface as an object type alongside with entities in the Kernel and in the user space - See how the patches will look like; start with V4L2 and proceed with DVB - How much will there be code duplication? - Target 4.3 at earliest, more likely 4.4

The current API does a crap job on properly defining entities that are coupled to interfaces, and prevented the enablement of the MC DVB support, submitted in December, 2014. That needs to be fixed as soon as possible, as it is causing bad impact on using MC even for other V4L2 device types, like radio. So, Mauro stated that, as the MC API is currently on a broken state, no patches, drivers or framework changes related to the Media Controller will be merged upstream until this is fixed. Fixup patches may be merged, though.

- Hans would try to do the work (of proposing the userspace API) at the week after the MC workshop.

Userspace API Requirements: - Enumerate Entities + pads/links (exists today) - Enumerate Interfaces + entity associations (and define which interface is the default one) - For entities: enumerate associated interfaces - Should support two application models: Entity-centric and Interface-centric

Additional API requirements that should be addressed in the future: - MC: 'versioning number' so apps are informed if the topology has changed. - MC: Notification events for topology changes

Points to solve: - entity.type - should be renamed to reflect what's there; - How to represent DVB entities/interfaces? - How to represent DVB network interfaces? - How to represent ALSA entities? - What fields are needed for media interfaces at the public API? - Changes at media-ctl userspace application

Some notes to help with network interface definitions: - man 7 netdevice - man 7 rtnetlink - Network interface index is constant for a network device - Network interface index can be converted to name etc. by an IOCTL

DRM subsystem uses u64 instead of pointers at the public API: - IOCTL design: http://blog.ffwll.ch/2013/11/botching-up-ioctls.html - Not widely used outside DRM - Most sub-systems have their own conventions

TODO: - Add graph topology version to the enumeration (and possibly other) ioctls

Question: should we redesign everything in order to support topology changes?

3.2) Discussions took at the afternoon of July30 and on July, 31st

It was discussed if we should add a generic graph framework in the kernel. This would require review on linux-kernel and such review may take a long time, as different requirements could pop up. So, perhaps not this time.

It was presented some topology for simple hybrid TV hardware (PC-customer hardware), at: http://linuxtv.org/downloads/presentations/mc_ws_2015/media_controller_summi...

An agreement was arrived for the UAPI interface.

What was agreed: media interfaces will be a separate graph element; links will be used to connect both entities (pads to pads) and media interfaces; PADs will use unique IDs preliminary header changes: http://linuxtv.org/downloads/presentations/mc_ws_2015/media.h

V4L2 applications need to know if they can capture from an input/tuner. To make that easy for them, it was proposed to add a new flag to VIDIOC_ENUMINPUT and whether the tuner is in use (and/or the tuner state) through VIDIOC_G_TUNER. This can't be done at the DVB side, however, as there are no reserved fields there. It should be noticed that, on DVB API, userspace doesn't query anything before setting the frontend. The first thing it does after open() is to set the frontend. So, there's no way to add it and being backward compatible. Also, hybrid TV devices typically have other bottlenecks that prevent both analog and digital part of the chipset to be used at the same time. So, it is not physically possible to stream from an S-Video connector while DVB is tuned. So, adding a flag at V4L2 saying tha the tuner is in usage or not won't help. Such bottleneck could be at DMA transfers or at the USB bridge or can simply be the lack of support on the internal firmware of the device. As a general rule, we don't know exactly where the constraint is, as vendors don't document the exact hardware architecture on their datasheets. So, the only alternative left is to decouple the interface links on the digital side when analog is in usage and vice-versa.

It was discussed about the need to allow bidirectional pads (needed for connectors like a coax that are bidirectional using time or frequency multiplexing)

TODO: Connector entities

It was proposed the following possible types of entities: Connector, DMA engine, processing block and controller block

Whather an entity is a connector needs to be told, as this can't be discovered

All others can be derived from other information already in the graph?

Entity functional properties

Most of the properties at entity level would be used to signal capabilities that can be figured out using sub-system specific interfaces the application already uses

Interfaces

Agreement: interfaces do have a type Types include V4L2, ALSA, DVB etc. Sub-types are used to tell between different interface types inside the sub-system

An interface can be a device node, network interface or a sysfs directory

It was proposed two new ioctls: G_TOPOLOGY IOCTL should not be used to convey arbitrary sysfs paths. It was agreed, instead, that sysfs paths will be passed via MC properties. G_INTERFACE to pass information on single interface; there, a single pointer set by the user would be feasible. The struct can be the same.

Finding entities - current situation Especially device specific applications often need to find an exact entity the application requires This may be a certain scaler in the graph, for instance Configuration may involve e.g. private IOCTLs only a certain sub-device implements Name is only 32 bytes at the moment In practice, external entities have used i2c bus number and i2c address as part of the name This does not scale for DT based devices where the device is uniquely identified by a string that can be very long Blocks that are a part of an ISP there's been just a name of the block without any device specific information This causes that if one has multiple such devices in the system, the name is no longer unique The entity name is not enough to uniquely find an entity in a general case In a general case it is not possible to recognise an entity Hot pluggable buses and entities that have no serial numbers or something equivalent In order to best help the user space, all the information that matters should be provided to the user

So, it ended by having device names such as "omap3isp resizer"

Other data could be used to enhance the device name, like: Bus Serial number Sysfs name - Unfortunately, in practice, this is not as stable as it would be expected, despite sysfs being documented at Documentation/ABI/. Yet, it may still be better than bus in some cases

This should enable most of the use cases where entities need to be found

Properties

Array of properties as an IOCTL argument has the problem that the user would have to allocate enough memory for each key-value pair in the array. This is unfeasible.

The original proposal used a text-based format for the purpose of discussing what properties should be, and left the question of the binary format for the ABI open. So, one question remains if the API should use either a text-based onr a binary-based format. Using a text based format requires parsing by the user, albeit the kernel interface would remain simple

The new proposal at the new media.h file (http://linuxtv.org/downloads/presentations/mc_ws_2015/media.h) combines the best of both: a single memory area amended with an array of properties that refer to the memory area

For the media properties, using strings the key type has benefits, as hierarchy is possible, with is not possible using an u32 integer for instance.

Should values be always strings or should other types be accepted? Probably having other types is a good idea.

Different options for arrays. For example: As part of the key: entity.0/name As part of the property: add a length field. This is convenient except for strings, where it works as well --- just count the nul characters.

The better representation for arrays should be discussed on a RFC for the properties.

Properties could be seen as re-implementing sysfs on the discussions with linux-api people. However they're much more light-weight. Also, there's no atomic access of all sysfs properties and sysfs is limited to page size Properties can be queried by media object, in which case the media object id would be provided The entire tree of properties can be obtained using object id 0

Another option for the kernel interface: key/length/value E.g. type (u32) | length (u32) | value (string) | key (string)

Media objects Media objects have an unique ID in the system Objects can be entities, pads or interfaces, for instance A few bits can be reserved for object types, e.g. entity == 0; interface == 1, pad == 2

Action Items:

- media_interface/media_topology: RFC for userspace API: Hans - RFC patch series: internal implementation for interface/topology: Mauro - Migration: add v4l-subdev media_interface: Laurent - Migration: add explicit DMA Engine entity: Laurent - media_properties: RFC userspace API: Sakari - MC core support for dynamically adding/removing from the media graph: Samsung - Clarify/implement DVB network interface: Mauro - MC support for Alsa: Lars: Need RFC before Alsa summit during ELCE - MC support for DVB: Mauro - MC default core support for interface-centric V4L2: Hans (?) - MC support for IIO: Lars - VIDIOC_ENUMINPUTS/G_TUNER: tell if the tuner/input is busy: RFC Hans, Shuah has a backend for this. - Fix media_device broken alloc/remove (devres): Shuah

---

Diff from version 1:

diff --git a/report.txt b/report.txt index 7505f2f84e96..f94c6a1314d7 100644 --- a/report.txt +++ b/report.txt @@ -1,4 +1,4 @@ -This is the first draft of the Media Controller Workshop report. +This is the second draft of the Media Controller Workshop report.

It was complex to do this report based on the notes we took, as some notes were incomplete. I did my best, but I'm sure some items need some review, @@ -7,10 +7,14 @@ in special the presentations. Feel free to review and send me your comments for me to add in the final MC workshop report and send to the main mailing list.

+Changes from version 1: + +- Addressed the points that Laurent pointed on his review. + Sakari,

-I don't have the email of the two guys from Intel that participated on -our first day. Could you please send it for me to complete at the report? +I'm still waiting for the email of the two guys from Intel that participated +on our first day. Could you please send it for me to complete at the report?

Thanks! Mauro @@ -134,7 +138,7 @@ The decision was, instead, to add a new graph element type (Interface) to repres It was agreed with the following terminology: - Entity: Functional unit, typically a hardware component or subunit in a hardware component - Pad: Data Input/Output of an entity - - Interface: Software control access to a entity (e.g. v4l2-subdev) + - Interface: Control point implementing a userspace API - Link: Connection between a source pad and a sink pad

It was also proposed to use the name “association” for the links between interface and entity, but there was no consensus about that idea. @@ -150,7 +154,7 @@ The relationship between Interfaces and entities are n-n: Media interfaces - A concept of user space facing interfaces - An object of its own right (such as media entities) - - At the same level than entities + - At the same level than entities, e. g. they'll be at the same graph, and not on separate planes

Working proposal (as proposed on July, 29)

@@ -214,6 +218,9 @@ What was agreed:

V4L2 applications need to know if they can capture from an input/tuner. To make that easy for them, it was proposed to add a new flag to VIDIOC_ENUMINPUT and whether the tuner is in use (and/or the tuner state) through VIDIOC_G_TUNER. This can't be done at the DVB side, however, as there are no reserved fields there. +It should be noticed that, on DVB API, userspace doesn't query anything before setting the frontend. The first thing it does after open() is to set the frontend. So, there's no way to add it and being backward compatible. +Also, hybrid TV devices typically have other bottlenecks that prevent both analog and digital part of the chipset to be used at the same time. So, it is not physically possible to stream from an S-Video connector while DVB is tuned. So, adding a flag at V4L2 saying tha the tuner is in usage or not won't help. +Such bottleneck could be at DMA transfers or at the USB bridge or can simply be the lack of support on the internal firmware of the device. As a general rule, we don't know exactly where the constraint is, as vendors don't document the exact hardware architecture on their datasheets. So, the only alternative left is to decouple the interface links on the digital side when analog is in usage and vice-versa.

It was discussed about the need to allow bidirectional pads (needed for connectors like a coax that are bidirectional using time or frequency multiplexing)

@@ -240,10 +247,11 @@ Interfaces An interface can be a device node, network interface or a sysfs directory

It was proposed two new ioctls: - G_TOPOLOGY IOCTL should not be used to convey arbitrary sysfs paths + G_TOPOLOGY IOCTL should not be used to convey arbitrary sysfs paths. It was agreed, instead, that sysfs paths will be passed via MC properties. G_INTERFACE to pass information on single interface; there, a single pointer set by the user would be feasible. The struct can be the same.

-Finding entities + +Finding entities - current situation Especially device specific applications often need to find an exact entity the application requires This may be a certain scaler in the graph, for instance Configuration may involve e.g. private IOCTLs only a certain sub-device implements @@ -262,7 +270,7 @@ So, it ended by having device names such as "omap3isp resizer" Other data could be used to enhance the device name, like: Bus Serial number - Sysfs name (this may not be stable as sysfs has no official API stability, but may be still better than bus in some cases) + Sysfs name - Unfortunately, in practice, this is not as stable as it would be expected, despite sysfs being documented at Documentation/ABI/. Yet, it may still be better than bus in some cases

This should enable most of the use cases where entities need to be found

@@ -271,7 +279,7 @@ Properties

Array of properties as an IOCTL argument has the problem that the user would have to allocate enough memory for each key-value pair in the array. This is unfeasible.

-The original proposal of using a text based format requires parsing by the user, albeit the kernel interface would remain simple +The original proposal used a text-based format for the purpose of discussing what properties should be, and left the question of the binary format for the ABI open. So, one question remains if the API should use either a text-based onr a binary-based format. Using a text based format requires parsing by the user, albeit the kernel interface would remain simple

The new proposal at the new media.h file (http://linuxtv.org/downloads/presentations/mc_ws_2015/media.h) combines the best of both: a single memory area amended with an array of properties that refer to the memory area

@@ -279,10 +287,12 @@ For the media properties, using strings the key type has benefits, as hierarchy

Should values be always strings or should other types be accepted? Probably having other types is a good idea.

-Different options for arrays: +Different options for arrays. For example: As part of the key: entity.0/name As part of the property: add a length field. This is convenient except for strings, where it works as well --- just count the nul characters.

+The better representation for arrays should be discussed on a RFC for the properties. + Properties could be seen as re-implementing sysfs on the discussions with linux-api people. However they're much more light-weight. Also, there's no atomic access of all sysfs properties and sysfs is limited to page size Properties can be queried by media object, in which case the media object id would be provided The entire tree of properties can be obtained using object id 0

This is the third draft of the Media Controller Workshop report.

Shuah:

Please review the notes taken from your presentation. They're not looking too nice, IMHO, and, as you didn't prepare any slides, I guess it is very hard for others to understand what's there.

Lars,

Also, please review the notes took from your presentation. As you sent the slides, people can always dig into them if they need more info, but it would be good if the summary would reflect the main points from your presentation.

Please do the review ASAP, as I'll be publishing it on Monday afternoon.

Thanks! Mauro

---

It was complex to do this report based on the notes we took, as some notes were incomplete. I did my best, but I'm sure some items need some review, in special the presentations.

Feel free to review and send me your comments for me to add in the final MC workshop report and send to the main mailing list.

Changes from version 2:

- Some English grammar reviews and language improvements that I got in private; - Added missing e-mails from two participants - I changed the EDITOR's NOTE that talks about using links for connections between interfaces/entities, as the word "decided" sounds a little strong, as some developers keep calling them as "associations" (with quotes) on some emails after the MC Workshop. Maybe we would still need to work on getting a nomenclature that everybody would agree.

Changes from version 1:

- Addressed the points that Laurent pointed on his review.

I added the diff against the previous version at the end of this email.

Thanks! Mauro

--

Report of the Media Controller workshop in Espoo, Finland – July, 29-31 2015

This is the first workshop dedicated to the Linux Media Controller. We had a v4l summit back in 2010, also in Finland, that established the current foundation for the media controller, andto properly satisfy the needs of properly reporting the pipelines on the smartphone System on a Chip (SoC). The focus of this year's workshop was to clarify the kernel→userspace interfaces and extend the Media Controller to be used on other subsystems that need to represent graphs, like Digital Video Broadcasting (DVB), Advanced Linux Sound Architecture (ALSA), and Industrial I/O (IIO).

Main event attendees:

Antti Laakso antti.laakso@intel.com Hans Verkuilhansverk@cisco.com Lars-Peter Clausen lars@metafoo.de Laurent Pinchart laurent.pinchart@ideasonboard.com Mauro Chehab mchehab@osg.samsung.com Sakari Ailus sakari.ailus@iki.fi Shuah Khan shuahkh@osg.samsung.com Tuukka Toivonen tuukka.toivonen@intel.com

MC videoconf attendees:

Dong-Joo Kim dj98.kim@samsung.com Geunyoung Kim nenggun.kim@samsung.com In-Ki Dae inki.dae@samsung.com Junghak Sung jh1009.sung@samsung.com Minsong Kim ms17.kim@samsung.com Ohin Kwon rany.kwon@samsung.com Seung-Woo Kim sw0312.kim@samsung.com

EDITOR'S NOTE: Usually, we produce the summit reports using a cronologic approach. This time, I opted to move the content of the second day to the beginning of the report, as they're basically several presentations we had covering the Media Controller needs. I opted to put the presentations first, and then put the discussions we had on July 29 and 31 together.

1) Presentations made on July, 30

1.1. Videobuf2 redesign to allow it to support DVB

Representatives from Samsung offered a presentation via video conference about the scheduled changes that are planned in order to split the videobuf2 core from the V4L2 specific part. This will allow the videobuf2 core to also be for DVB.

1.2. DVB pipelines

Samsung representatives via video conference presented about the pipelines. Essencially, the pipelines on real use-cases for embedded devices would look like:

tuner 1 -> -> demux -> Video tuner 2 -> cam 1 -> demux -> Audio tuner 3 -> cam 2 -> demux -> Data -> V4L2 -> ALSA

1.3. ASoC

http://linuxtv.org/downloads/presentations/mc_ws_2015/sound_media_controller...

This presentation covered the following topics: Generic DT machine driver can support around half of DT based devices Not all required is data available in ACPI, meaning ACPI based devices typically have their own drivers. DAPM handles power management in ASoC much like the current omap3isp driver implementation does. Walks the graph ALSA supports large numbers of entities and cyclical graphs ALSA contains ASoC dependencies, but the core of the algorithm is generic A stack based, iterative version is in the works MC has generic graph walking code as well Iterative Less concerned with performance omap3isp driver has PM code, which could be more generic Ideally we should have single implementation for graph walking and for power management

1.4 Updates to ALSA and au0828 to share resources:

1. state->pads[AU8522_PAD_AUDIO_OUT].flags = MEDIA_PAD_FL_SINK; Need to be MEDIA_PAD_FL_SOURCE; 2. ALSA: to use on a non-atomic context: pcm->substream->nonatomic IRQ safe start/stop pipeline isn't necessary. Not a good idea to change graph_mutex to spinlock. I2C drivers will break. This will reduce the work and patch series v6 becomes smaller. 3. enable_source is necessary at media_device level, but find a better name 4. Write helper function to hde decoder and tuner details from ALSA 5. remove link is needed - implement - Shuah can do that as part of ALSA work 6. Managed Media Controller API - devres - change it to get reference and put reference. It isn't safe to delete media_device device resource. media_device_get() and media_device_put() Keep /dev/media device open and unplug the usb device - kernel would crash

1.4 IIO - Industrial I/O

http://linuxtv.org/downloads/presentations/mc_ws_2015/iio_media_controller.p...

- ADC, DAC, accelerometer, gyro, light sensor, pressure, manometer - typically: low speed < 10kbaud, I2C/SPI - changes: up to 5Gbaud, separate control and data bus (LVDS, JESD204b) - can be used by multi-channel SDR

2) Keysign party at the afternoon of July, 30

We did a Keysign party, where the gpg keys got cross-signed among the participants.

3) Discussions about the Media Controller API and the needs to extend it to support the requirements for DVB, ALSA and IIO

3.1) Discussions took at July, 29

Basic requirements: - Properly represent kernel→userspace API interfaces; - Allow dynamic pipeline changes; - Define the namespace for interfaces and entities; - Support additional properties; - Better represent entities that belong to more than one type

It was proposed to use the concept of planes, as defined by ITU and IEEE to represent different layers of a data or media network (ITU-T G.800). So, we would have control and data planes.

http://linuxtv.org/downloads/presentations/mc_ws_2015/media_controller_summi...

This is a concept largely used on networks, as show at: http://etherealmind.com/controller-based-networks-for-data-centres/

Multiple options to express association between device nodes and entities: - Same IOCTL API as for data links, difference made between data and control links - Different IOCTL API to enumerate interfaces, with associated entities - Properties

The decision was, instead, to add a new graph element type (Interface) to represent the elements that controls the entities.

It was agreed with the following terminology: - Entity: Functional unit, typically a hardware component or subunit in a hardware component - Pad: Data Input/Output of an entity - Interface: Control point implementing a userspace API - Link: Connection between a source pad and a sink pad

It was also proposed to use the name “association” for the links between interface and entity, but there was no consensus about that idea.

EDITOR'S NOTE: On July, 31 we started using the name “links” also for the connection between an entity and an interface. We used the term “interface links” for such links when we need to distinguish them from “data links” (e. g. pad to pad links).

Mauro's concern is that there will be lots of code duplication in the Kernel if we use a different graph type for the interface links.

The relationship between Interfaces and entities are n-n: - One interface can control multiple entities - One entity can be controlled by multiple interfaces

Media interfaces - A concept of user space facing interfaces - An object of its own right (such as media entities) - At the same level than entities, e. g. they'll be at the same graph, and not on separate planes

Working proposal (as proposed on July, 29)

- Introduce struct media_interface as an object type alongside with entities in the Kernel and in the user space - See how the patches will look like; start with V4L2 and proceed with DVB - How much will there be code duplication? - Target 4.3 at earliest, more likely 4.4

The current API does a crap job on properly defining entities that are coupled to interfaces, and prevented the enablement of the MC DVB support, submitted in December, 2014. That needs to be fixed as soon as possible, as it is causing bad impact on using MC even for other V4L2 device types, like radio. So, Mauro stated that, as the MC API is currently on a broken state, no patches, drivers or framework changes related to the Media Controller will be merged upstream until this is fixed. Fixup patches may be merged, though.

- Hans would try to do the work (of proposing the userspace API) at the week after the MC workshop.

Userspace API Requirements: - Enumerate Entities + pads/links (exists today) - Enumerate Interfaces + entity associations (and define which interface is the default one) - For entities: enumerate associated interfaces - Should support two application models: Entity-centric and Interface-centric

Additional API requirements that should be addressed in the future: - MC: 'versioning number' so apps are informed if the topology has changed. - MC: Notification events for topology changes

Points to solve: - entity.type - should be renamed to reflect what's there; - How to represent DVB entities/interfaces? - How to represent DVB network interfaces? - How to represent ALSA entities? - What fields are needed for media interfaces at the public API? - Changes at media-ctl userspace application

Some notes to help with network interface definitions: - man 7 netdevice - man 7 rtnetlink - Network interface index is constant for a network device - Network interface index can be converted to name etc. by an IOCTL

DRM subsystem uses u64 instead of pointers at the public API: - IOCTL design: http://blog.ffwll.ch/2013/11/botching-up-ioctls.html - Not widely used outside DRM - Most sub-systems have their own conventions

TODO: - Add graph topology version to the enumeration (and possibly other) ioctls

Question: should we redesign everything in order to support topology changes?

3.2) Discussions took at the afternoon of July30 and on July, 31st

It was discussed if we should add a generic graph framework in the kernel. This would require review on linux-kernel and such review may take a long time, as different requirements could pop up. So, perhaps not this time.

It was presented some topology for simple hybrid TV hardware (PC-customer hardware), at: http://linuxtv.org/downloads/presentations/mc_ws_2015/media_controller_summi...

An agreement was arrived for the UAPI interface.

What was agreed: media interfaces will be a separate graph element; links will be used to connect both entities (pads to pads) and media interfaces; PADs will use unique IDs preliminary header changes: http://linuxtv.org/downloads/presentations/mc_ws_2015/media.h

V4L2 applications need to know if they can capture from an input/tuner. To make that easy for them, it was proposed to add a new flag to VIDIOC_ENUMINPUT and whether the tuner is in use (and/or the tuner state) through VIDIOC_G_TUNER. This can't be done at the DVB side, however, as there are no reserved fields there. It should be noticed that, on DVB API, userspace doesn't query anything before setting the frontend. The first thing it does after open() is to set the frontend. So, there's no way to add it and being backward compatible. Also, hybrid TV devices typically have other bottlenecks that prevent both analog and digital part of the chipset to be used at the same time. So, it is not physically possible to stream from an S-Video connector while DVB is tuned. So, adding a flag at V4L2 saying tha the tuner is in usage or not won't help. Such bottleneck could be at DMA transfers or at the USB bridge or can simply be the lack of support on the internal firmware of the device. As a general rule, we don't know exactly where the constraint is, as vendors don't document the exact hardware architecture on their datasheets. So, the only alternative left is to decouple the interface links on the digital side when analog is in usage and vice-versa.

It was discussed about the need to allow bidirectional pads (needed for connectors like a coax that are bidirectional using time or frequency multiplexing)

TODO: Connector entities

It was proposed the following possible types of entities: Connector, DMA engine, processing block and controller block

Whather an entity is a connector needs to be told, as this can't be discovered

All others can be derived from other information already in the graph?

Entity functional properties

Most of the properties at entity level would be used to signal capabilities that can be figured out using sub-system specific interfaces the application already uses

Interfaces

Agreement: interfaces do have a type Types include V4L2, ALSA, DVB etc. Sub-types are used to tell between different interface types inside the sub-system

An interface can be a device node, network interface or a sysfs directory

It was proposed two new ioctls: G_TOPOLOGY IOCTL should not be used to convey arbitrary sysfs paths. It was agreed, instead, that sysfs paths will be passed via MC properties. G_INTERFACE to pass information on single interface; there, a single pointer set by the user would be feasible. The struct can be the same.

Finding entities - current situation Especially device specific applications often need to find an exact entity the application requires This may be a certain scaler in the graph, for instance Configuration may involve e.g. private IOCTLs only a certain sub-device implements Name is only 32 bytes at the moment In practice, external entities have used i2c bus number and i2c address as part of the name This does not scale for DT based devices where the device is uniquely identified by a string that can be very long Blocks that are a part of an ISP there's been just a name of the block without any device specific information This causes that if one has multiple such devices in the system, the name is no longer unique The entity name is not enough to uniquely find an entity in a general case In a general case it is not possible to recognise an entity Hot pluggable buses and entities that have no serial numbers or something equivalent In order to best help the user space, all the information that matters should be provided to the user

So, it ended by having device names such as "omap3isp resizer"

Other data could be used to enhance the device name, like: Bus Serial number Sysfs name - Unfortunately, in practice, this is not as stable as it would be expected, despite sysfs being documented at Documentation/ABI/. Yet, it may still be better than bus in some cases

This should enable most of the use cases where entities need to be found

Properties

Array of properties as an IOCTL argument has the problem that the user would have to allocate enough memory for each key-value pair in the array. This is unfeasible.

The original proposal used a text-based format for the purpose of discussing what properties should be, and left the question of the binary format for the ABI open. So, one question remains if the API should use either a text-based onr a binary-based format. Using a text based format requires parsing by the user, albeit the kernel interface would remain simple

The new proposal at the new media.h file (http://linuxtv.org/downloads/presentations/mc_ws_2015/media.h) combines the best of both: a single memory area amended with an array of properties that refer to the memory area

For the media properties, using strings the key type has benefits, as hierarchy is possible, with is not possible using an u32 integer for instance.

Should values be always strings or should other types be accepted? Probably having other types is a good idea.

Different options for arrays. For example: As part of the key: entity.0/name As part of the property: add a length field. This is convenient except for strings, where it works as well --- just count the nul characters.

The better representation for arrays should be discussed on a RFC for the properties.

Properties could be seen as re-implementing sysfs on the discussions with linux-api people. However they're much more light-weight. Also, there's no atomic access of all sysfs properties and sysfs is limited to page size Properties can be queried by media object, in which case the media object id would be provided The entire tree of properties can be obtained using object id 0

Another option for the kernel interface: key/length/value E.g. type (u32) | length (u32) | value (string) | key (string)

Media objects Media objects have an unique ID in the system Objects can be entities, pads or interfaces, for instance A few bits can be reserved for object types, e.g. entity == 0; interface == 1, pad == 2

Action Items:

- media_interface/media_topology: RFC for userspace API: Hans - RFC patch series: internal implementation for interface/topology: Mauro - Migration: add v4l-subdev media_interface: Laurent - Migration: add explicit DMA Engine entity: Laurent - media_properties: RFC userspace API: Sakari - MC core support for dynamically adding/removing from the media graph: Samsung - Clarify/implement DVB network interface: Mauro - MC support for Alsa: Lars: Need RFC before Alsa summit during ELCE - MC support for DVB: Mauro - MC default core support for interface-centric V4L2: Hans (?) - MC support for IIO: Lars - VIDIOC_ENUMINPUTS/G_TUNER: tell if the tuner/input is busy: RFC Hans, Shuah has a backend for this. - Fix media_device broken alloc/remove (devres): Shuah

===================================================

Diff from the previous version:

diff --git a/report.txt b/report.txt index f94c6a1314d7..59b1f4fc6881 100644 --- a/report.txt +++ b/report.txt @@ -1,4 +1,4 @@ -This is the second draft of the Media Controller Workshop report. +This is the third draft of the Media Controller Workshop report.

It was complex to do this report based on the notes we took, as some notes were incomplete. I did my best, but I'm sure some items need some review, @@ -7,14 +7,21 @@ in special the presentations. Feel free to review and send me your comments for me to add in the final MC workshop report and send to the main mailing list.

-Changes from version 1: +Changes from version 2:

-- Addressed the points that Laurent pointed on his review. +- Some English grammar reviews and language improvements that I got in + private; +- Added missing e-mails from two participants +- I changed the EDITOR's NOTE that talks about using links for + connections between interfaces/entities, as the word "decided" + sounds a little strong, as some developers keep calling them as + "associations" (with quotes) on some emails after the MC Workshop. + Maybe we would still need to work on getting a nomenclature that + everybody would agree.

-Sakari, +Changes from version 1:

-I'm still waiting for the email of the two guys from Intel that participated -on our first day. Could you please send it for me to complete at the report? +- Addressed the points that Laurent pointed on his review.

Thanks! Mauro @@ -23,18 +30,18 @@ Mauro

Report of the Media Controller workshop in Espoo, Finland – July, 29-31 2015

-This is the first workshop dedicated to the Media Controller. We actually did a v4l summit in 2010, also in Finland, that stablished the current foundation for the media controller, and was meant to satisfy the needs of properly reporting the pipelines on the SoC used by smartphones. The focus of this year's workshop is to clarify the kernel→userspace interfaces and extend the Media Controller to be used on other subsystems that need to represent graphs, like DVB, ALSA and IIO. +This is the first workshop dedicated to the Linux Media Controller. We had a v4l summit back in 2010, also in Finland, that established the current foundation for the media controller, andto properly satisfy the needs of properly reporting the pipelines on the smartphone System on a Chip (SoC). The focus of this year's workshop was to clarify the kernel→userspace interfaces and extend the Media Controller to be used on other subsystems that need to represent graphs, like Digital Video Broadcasting (DVB), Advanced Linux Sound Architecture (ALSA), and Industrial I/O (IIO).

Main event attendees:

-Antti Laakso +Antti Laakso antti.laakso@intel.com Hans Verkuilhansverk@cisco.com Lars-Peter Clausen lars@metafoo.de Laurent Pinchart laurent.pinchart@ideasonboard.com Mauro Chehab mchehab@osg.samsung.com Sakari Ailus sakari.ailus@iki.fi Shuah Khan shuahkh@osg.samsung.com -Tuukka Toivonen +Tuukka Toivonen tuukka.toivonen@intel.com

MC videoconf attendees:

@@ -52,11 +59,11 @@ EDITOR'S NOTE: Usually, we produce the summit reports using a cronologic approac

1.1. Videobuf2 redesign to allow it to support DVB

-Presentation made by Samsung via videoconf about the scheduled changes that are planned in order to split the videobuf2 core from the V4L2 specific part, in order to allow the videobuf2 core to be used also for DVB +Representatives from Samsung offered a presentation via video conference about the scheduled changes that are planned in order to split the videobuf2 core from the V4L2 specific part. This will allow the videobuf2 core to also be for DVB.

1.2. DVB pipelines

-Presentation made by Samsung via videoconf about the pipelines. Basically, the pipelines on real usecases for embedded devices would look like: +Samsung representatives via video conference presented about the pipelines. Essencially, the pipelines on real use-cases for embedded devices would look like:

tuner 1 -> -> demux -> Video tuner 2 -> cam 1 -> demux -> Audio @@ -68,13 +75,14 @@ Presentation made by Samsung via videoconf about the pipelines. Basically, the p

http://linuxtv.org/downloads/presentations/mc_ws_2015/sound_media_controller...

+This presentation covered the following topics: Generic DT machine driver can support around half of DT based devices - Not all required data available in ACPI, so ACPI based devices typically have their own drivers - DAPM does power management in ASoC much like the current omap3isp driver implementation does + Not all required is data available in ACPI, meaning ACPI based devices typically have their own drivers. + DAPM handles power management in ASoC much like the current omap3isp driver implementation does. Walks the graph - Supports large numbers of entities and cyclical graphs - Contains ASoC dependencies, but the core of the algorithm is generic - Stack based, iterative version in works + ALSA supports large numbers of entities and cyclical graphs + ALSA contains ASoC dependencies, but the core of the algorithm is generic + A stack based, iterative version is in the works MC has generic graph walking code as well Iterative Less concerned with performance @@ -133,7 +141,7 @@ Multiple options to express association between device nodes and entities: - Different IOCTL API to enumerate interfaces, with associated entities - Properties

-The decision was, instead, to add a new graph element type (Interface) to represent the elements that controls the entities. +The decision was, instead, to add a new graph element type (Interface) to represent the elements that controls the entities.

It was agreed with the following terminology: - Entity: Functional unit, typically a hardware component or subunit in a hardware component @@ -143,7 +151,7 @@ It was agreed with the following terminology:

It was also proposed to use the name “association” for the links between interface and entity, but there was no consensus about that idea.

-EDITOR'S NOTE: It was decided on July, 31 to use the name “links” also for the connection between an entity and an interface. We used the term “interface links” for such links when we need to distinguish them from “data links” (e. g. pad to pad links). +EDITOR'S NOTE: On July, 31 we started using the name “links” also for the connection between an entity and an interface. We used the term “interface links” for such links when we need to distinguish them from “data links” (e. g. pad to pad links).

Mauro's concern is that there will be lots of code duplication in the Kernel if we use a different graph type for the interface links.