Message ID | be0270ec89e6b9b49de7e533dd1f3a89ad34d205.1452523228.git.mchehab@osg.samsung.com (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
Hi Mauro, I see that this patch got applied to the media_tree master, but then reverted a few days ago. Do you think the G_TOPOLOGY IOCTL and the associated user space structs are ready for being included in a release? I have a few concerns over the current interface, in decreasing order of importance: - G_TOPOLOGY IOCTL is intended to enable dynamic updates, but do we have a driver actually supporting this? For instance, supposing that the users's knowledge of the graph state isn't what the user expected it to be (assuming the graph state changed between G_TOPOLOGY and SETUP_LINK), does the user still want to perform the SETUP_LINK IOCTL or would the user prefer that the kernel returned an error instead to tell the user has no knowledge of the current graph state? I'd like to see how that works in practice. For instance, a virtual driver such as vivi, but with MC, V4L2 sub-device and V4L2 support which adds and removes a random entity every, say, five minutes, would be wonderful. If this has not been tried out in a real use case, the chances of getting it right may remain rather slim. - struct media_v2_pad contains fields called "id" and "entity_id". The "id" field, as far as I understand, is the graph object id, not the pad index. In order to configure a link using MEDIA_IOC_SETUP_LINK, one does need to know the entity id and the pad index. This information you'll only get using MEDIA_IOC_ENUM_LINKS, which right now refutes the very purpose of the G_TOPOLOGY IOCTL. Knowing the pad indices is also essential for the V4L2 sub-device user space API. (I remember whether or not the pad index should be there but I don't remember the details, except that it was intentionally left out. Considering this again, I think adding it is unavoidable.) This together with the above point suggest there are no real applications using G_TOPOLOGY yet. - Some more thought should be given to the state of the reserved fields, in e.g. struct media_v2_pad there are __u32 fields only, except a reserved field which is a __u16 array of 9. While this isn't exactly wrong it makes no sense either. - KernelDoc documentation would be nice for the G_TOPOLOGY argument structs. DocBook documentation for G_TOPOLOGY as itself is fine, but I think it reflects an older version of the structs than what's now defined in include/uapi/linux/media.h. Please give some thought on this. There are some obvious gaps that need to be filled, and when doing so, I don't think we want to start guessing whether there might be an application that depends on the current API/ABI. If you'd like the G_TOPOLOGY IOCTL and its argument structs to be available for developers without kernel changes, I propose to add a new Kconfig option for G_TOPOLOGY and make it depend on BROKEN. What do you think? On Mon, Jan 11, 2016 at 12:41:02PM -0200, Mauro Carvalho Chehab wrote: > There are a few discussions left with regards to this ioctl: > > 1) the name of the new structs will contain _v2_ on it? > 2) what's the best alternative to avoid compat32 issues? > > Due to that, let's postpone the addition of this new ioctl to > the next Kernel version, to give people more time to discuss it. > > Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com> > --- > > v2: Fix a compilation breakage > > Documentation/DocBook/media/v4l/media-ioc-g-topology.xml | 3 +++ > drivers/media/media-device.c | 7 ++++++- > include/uapi/linux/media.h | 6 +++++- > 3 files changed, 14 insertions(+), 2 deletions(-) > > diff --git a/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml b/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml > index e0d49fa329f0..63152ab9efba 100644 > --- a/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml > +++ b/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml > @@ -48,6 +48,9 @@ > > <refsect1> > <title>Description</title> > + > + <para><emphasis role="bold">NOTE:</emphasis> This new ioctl is programmed to be added on Kernel 4.6. Its definition/arguments may change until its final version.</para> > + > <para>The typical usage of this ioctl is to call it twice. > On the first call, the structure defined at &media-v2-topology; should > be zeroed. At return, if no errors happen, this ioctl will return the > diff --git a/drivers/media/media-device.c b/drivers/media/media-device.c > index 4d1c13de494b..7dae0ac0f3ae 100644 > --- a/drivers/media/media-device.c > +++ b/drivers/media/media-device.c > @@ -234,6 +234,7 @@ static long media_device_setup_link(struct media_device *mdev, > return ret; > } > > +#if 0 /* Let's postpone it to Kernel 4.6 */ > static long __media_device_get_topology(struct media_device *mdev, > struct media_v2_topology *topo) > { > @@ -389,6 +390,7 @@ static long media_device_get_topology(struct media_device *mdev, > > return 0; > } > +#endif > > static long media_device_ioctl(struct file *filp, unsigned int cmd, > unsigned long arg) > @@ -422,13 +424,14 @@ static long media_device_ioctl(struct file *filp, unsigned int cmd, > mutex_unlock(&dev->graph_mutex); > break; > > +#if 0 /* Let's postpone it to Kernel 4.6 */ > case MEDIA_IOC_G_TOPOLOGY: > mutex_lock(&dev->graph_mutex); > ret = media_device_get_topology(dev, > (struct media_v2_topology __user *)arg); > mutex_unlock(&dev->graph_mutex); > break; > - > +#endif > default: > ret = -ENOIOCTLCMD; > } > @@ -477,7 +480,9 @@ static long media_device_compat_ioctl(struct file *filp, unsigned int cmd, > case MEDIA_IOC_DEVICE_INFO: > case MEDIA_IOC_ENUM_ENTITIES: > case MEDIA_IOC_SETUP_LINK: > +#if 0 /* Let's postpone it to Kernel 4.6 */ > case MEDIA_IOC_G_TOPOLOGY: > +#endif > return media_device_ioctl(filp, cmd, arg); > > case MEDIA_IOC_ENUM_LINKS32: > diff --git a/include/uapi/linux/media.h b/include/uapi/linux/media.h > index 5dbb208e5451..1e3c8cb43bd7 100644 > --- a/include/uapi/linux/media.h > +++ b/include/uapi/linux/media.h > @@ -286,7 +286,7 @@ struct media_links_enum { > * later, before the adding this API upstream. > */ > > - > +#if 0 /* Let's postpone it to Kernel 4.6 */ > struct media_v2_entity { > __u32 id; > char name[64]; /* FIXME: move to a property? (RFC says so) */ > @@ -351,6 +351,7 @@ static inline void __user *media_get_uptr(__u64 arg) > { > return (void __user *)(uintptr_t)arg; > } > +#endif > > /* ioctls */ > > @@ -358,6 +359,9 @@ static inline void __user *media_get_uptr(__u64 arg) > #define MEDIA_IOC_ENUM_ENTITIES _IOWR('|', 0x01, struct media_entity_desc) > #define MEDIA_IOC_ENUM_LINKS _IOWR('|', 0x02, struct media_links_enum) > #define MEDIA_IOC_SETUP_LINK _IOWR('|', 0x03, struct media_link_desc) > + > +#if 0 /* Let's postpone it to Kernel 4.6 */ > #define MEDIA_IOC_G_TOPOLOGY _IOWR('|', 0x04, struct media_v2_topology) > +#endif > > #endif /* __LINUX_MEDIA_H */
Em Wed, 27 Jan 2016 13:44:44 +0200 Sakari Ailus <sakari.ailus@iki.fi> escreveu: > Hi Mauro, > > I see that this patch got applied to the media_tree master, but then > reverted a few days ago. For Kernel 4.5, the new ioctl is disabled. It was reverted after pulling back from Linus tree, in order to allow the developers to be able to test it and improve it if needed. So, the revert patch is meant to reach upstream only in Kernel 4.6, as proposed in this patch. It means that we have about 2 months to polite it before the next merge window. > Do you think the G_TOPOLOGY IOCTL and the > associated user space structs are ready for being included in a release? Well, the only doubt we had so far is about how to make it compatible with 64 bits kernelspace and 32 bits userspace. 2 months seems more than enough for us to properly address that. > > I have a few concerns over the current interface, in decreasing order of > importance: Ok, that's the first time you come with that. I still think that those could be addressed in the next 2 months, but, if not, we may eventually postpone enabling G_TOPOLOGY ioctl further. > > - G_TOPOLOGY IOCTL is intended to enable dynamic updates, but do we have a > driver actually supporting this? Laurent requested to postpone dynamic updates at the early stages of the MC patchset review. The initial patchset were using krefs to handle it. We can work on adding support for it for 4.6. I'm actually working today to add MC support on em28xx USB hardware. On such driver, there is a master driver (em28xx) and several sub-drivers (em28xx-video, em28xx-dvb, em28xx-alsa and em28xx-input). The sub-drivers are loaded asynchronously. meaning that the topology will be dynamically updated during driver load. The alsa module (or snd-usb-audio - depending on the hardware) can be unbind/rebind dynamically. So, while the hardware itself is not dynamic, dynamic support is needed, in order to avoid race conditions. > For instance, supposing that the users's > knowledge of the graph state isn't what the user expected it to be > (assuming the graph state changed between G_TOPOLOGY and SETUP_LINK), does > the user still want to perform the SETUP_LINK IOCTL or would the user > prefer that the kernel returned an error instead to tell the user has no > knowledge of the current graph state? I'd like to see how that works in > practice. For instance, a virtual driver such as vivi, but with MC, V4L2 > sub-device and V4L2 support which adds and removes a random entity every, > say, five minutes, would be wonderful. If this has not been tried out in a > real use case, the chances of getting it right may remain rather slim. It can be simulated by removing/adding or binding/unbinding snd-usb-audio module. We may also apply the virtual MC driver, if it is ready. Not sure about its current review stage of the virtual driver. > - struct media_v2_pad contains fields called "id" and "entity_id". The "id" > field, as far as I understand, is the graph object id, not the pad index. > In order to configure a link using MEDIA_IOC_SETUP_LINK, one does need to > know the entity id and the pad index. This information you'll only get > using MEDIA_IOC_ENUM_LINKS, which right now refutes the very purpose of > the G_TOPOLOGY IOCTL. Knowing the pad indices is also essential for the > V4L2 sub-device user space API. (I remember whether or not the pad index > should be there but I don't remember the details, except that it was > intentionally left out. Considering this again, I think adding it is > unavoidable.) A new ioctl to setup links is required, as we want to be able to change the status of multiple links at once. The thing with the PAD index is that it should be replaced by something more generic, via the properties API. On some cases, just an index is enough (when the pads are, for example, the output pins of a demux). But, in general, what an application would want is to specify the "audio out pin" or the "video out pin" of a device. As the index number may vary depending on the specific device, Such application should not have the index numbers hardcoded on it, but, instead, they should discover it via the userspace API. What we've agreed is that such information would be coded as a property via the properties API. > This together with the above point suggest there are no > real applications using G_TOPOLOGY yet. MEDIA_IOC_SETUP_LINK is a must only for subdev-centric hardware, like OMAP3. For device-node-centric hardware (like em28xx, au0828, etc), G_TOPOLOGY itself is useful to allow describing the hardware interfaces and their connections, e. g. to reimplement libmedia_dev at v4l-utils to use MC instead of sysfs. > - Some more thought should be given to the state of the reserved fields, in > e.g. struct media_v2_pad there are __u32 fields only, except a reserved > field which is a __u16 array of 9. While this isn't exactly wrong it makes > no sense either. Well, 2 months is enough for us to address the reserved fields ;) > - KernelDoc documentation would be nice for the G_TOPOLOGY argument structs. > DocBook documentation for G_TOPOLOGY as itself is fine, but I think it > reflects an older version of the structs than what's now defined in > include/uapi/linux/media.h. See: https://linuxtv.org/downloads/v4l-dvb-apis/media-g-topology.html Indeed, there is one missing struct there (media_v2_link). Not sure what happened here. I guess I lost one hunk when I wrote the KernelDoc patch. Anyway, adding it is easy. I'll prepare a patch for it soon. The description of media_v2_topology actually matches our last discussion (where we decided to not use any _reserved field there). Yet, this difference is actually the reason why we've delayed it in the first place, as my guts tell that we need more discussions about it. > Please give some thought on this. There are some obvious gaps that need to > be filled, and when doing so, I don't think we want to start guessing > whether there might be an application that depends on the current API/ABI. > > If you'd like the G_TOPOLOGY IOCTL and its argument structs to be available > for developers without kernel changes, I propose to add a new Kconfig option > for G_TOPOLOGY and make it depend on BROKEN. > > What do you think? Making it depending on BROKEN at our development tree is not a good thing, as BROKEN is not an option that can be changed with make menuconfig/xconfig. It needs to be easy to do tests on our development tree, in order for it to be tested by a broader audience. Ok, if we end by needing to postpone it even further, we could do something different, but it sounds to early to do that, as we can postpone such decision to happen closer to the next merge window (or even to happen just before releasing Kernel 4.6, if we discover too late some real issue there). > > On Mon, Jan 11, 2016 at 12:41:02PM -0200, Mauro Carvalho Chehab wrote: > > There are a few discussions left with regards to this ioctl: > > > > 1) the name of the new structs will contain _v2_ on it? > > 2) what's the best alternative to avoid compat32 issues? > > > > Due to that, let's postpone the addition of this new ioctl to > > the next Kernel version, to give people more time to discuss it. > > > > Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com> > > --- > > > > v2: Fix a compilation breakage > > > > Documentation/DocBook/media/v4l/media-ioc-g-topology.xml | 3 +++ > > drivers/media/media-device.c | 7 ++++++- > > include/uapi/linux/media.h | 6 +++++- > > 3 files changed, 14 insertions(+), 2 deletions(-) > > > > diff --git a/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml b/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml > > index e0d49fa329f0..63152ab9efba 100644 > > --- a/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml > > +++ b/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml > > @@ -48,6 +48,9 @@ > > > > <refsect1> > > <title>Description</title> > > + > > + <para><emphasis role="bold">NOTE:</emphasis> This new ioctl is programmed to be added on Kernel 4.6. Its definition/arguments may change until its final version.</para> > > + > > <para>The typical usage of this ioctl is to call it twice. > > On the first call, the structure defined at &media-v2-topology; should > > be zeroed. At return, if no errors happen, this ioctl will return the > > diff --git a/drivers/media/media-device.c b/drivers/media/media-device.c > > index 4d1c13de494b..7dae0ac0f3ae 100644 > > --- a/drivers/media/media-device.c > > +++ b/drivers/media/media-device.c > > @@ -234,6 +234,7 @@ static long media_device_setup_link(struct media_device *mdev, > > return ret; > > } > > > > +#if 0 /* Let's postpone it to Kernel 4.6 */ > > static long __media_device_get_topology(struct media_device *mdev, > > struct media_v2_topology *topo) > > { > > @@ -389,6 +390,7 @@ static long media_device_get_topology(struct media_device *mdev, > > > > return 0; > > } > > +#endif > > > > static long media_device_ioctl(struct file *filp, unsigned int cmd, > > unsigned long arg) > > @@ -422,13 +424,14 @@ static long media_device_ioctl(struct file *filp, unsigned int cmd, > > mutex_unlock(&dev->graph_mutex); > > break; > > > > +#if 0 /* Let's postpone it to Kernel 4.6 */ > > case MEDIA_IOC_G_TOPOLOGY: > > mutex_lock(&dev->graph_mutex); > > ret = media_device_get_topology(dev, > > (struct media_v2_topology __user *)arg); > > mutex_unlock(&dev->graph_mutex); > > break; > > - > > +#endif > > default: > > ret = -ENOIOCTLCMD; > > } > > @@ -477,7 +480,9 @@ static long media_device_compat_ioctl(struct file *filp, unsigned int cmd, > > case MEDIA_IOC_DEVICE_INFO: > > case MEDIA_IOC_ENUM_ENTITIES: > > case MEDIA_IOC_SETUP_LINK: > > +#if 0 /* Let's postpone it to Kernel 4.6 */ > > case MEDIA_IOC_G_TOPOLOGY: > > +#endif > > return media_device_ioctl(filp, cmd, arg); > > > > case MEDIA_IOC_ENUM_LINKS32: > > diff --git a/include/uapi/linux/media.h b/include/uapi/linux/media.h > > index 5dbb208e5451..1e3c8cb43bd7 100644 > > --- a/include/uapi/linux/media.h > > +++ b/include/uapi/linux/media.h > > @@ -286,7 +286,7 @@ struct media_links_enum { > > * later, before the adding this API upstream. > > */ > > > > - > > +#if 0 /* Let's postpone it to Kernel 4.6 */ > > struct media_v2_entity { > > __u32 id; > > char name[64]; /* FIXME: move to a property? (RFC says so) */ > > @@ -351,6 +351,7 @@ static inline void __user *media_get_uptr(__u64 arg) > > { > > return (void __user *)(uintptr_t)arg; > > } > > +#endif > > > > /* ioctls */ > > > > @@ -358,6 +359,9 @@ static inline void __user *media_get_uptr(__u64 arg) > > #define MEDIA_IOC_ENUM_ENTITIES _IOWR('|', 0x01, struct media_entity_desc) > > #define MEDIA_IOC_ENUM_LINKS _IOWR('|', 0x02, struct media_links_enum) > > #define MEDIA_IOC_SETUP_LINK _IOWR('|', 0x03, struct media_link_desc) > > + > > +#if 0 /* Let's postpone it to Kernel 4.6 */ > > #define MEDIA_IOC_G_TOPOLOGY _IOWR('|', 0x04, struct media_v2_topology) > > +#endif > > > > #endif /* __LINUX_MEDIA_H */ > -- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
Hi Mauro, On Wed, Jan 27, 2016 at 11:08:40AM -0200, Mauro Carvalho Chehab wrote: > Em Wed, 27 Jan 2016 13:44:44 +0200 > Sakari Ailus <sakari.ailus@iki.fi> escreveu: > > > Hi Mauro, > > > > I see that this patch got applied to the media_tree master, but then > > reverted a few days ago. > > For Kernel 4.5, the new ioctl is disabled. It was reverted after > pulling back from Linus tree, in order to allow the developers to > be able to test it and improve it if needed. So, the revert patch is > meant to reach upstream only in Kernel 4.6, as proposed in this patch. > > It means that we have about 2 months to polite it before the next merge > window. My point is that I would prefer that an informed decision is made before the pull request is sent rather than letting two months to pass before it happens. The passage of time itself usually does not improve software. > > Do you think the G_TOPOLOGY IOCTL and the > > associated user space structs are ready for being included in a release? > > Well, the only doubt we had so far is about how to make it compatible > with 64 bits kernelspace and 32 bits userspace. 2 months seems more than > enough for us to properly address that. > > > > > I have a few concerns over the current interface, in decreasing order of > > importance: > > Ok, that's the first time you come with that. I still think that those > could be addressed in the next 2 months, but, if not, we may eventually > postpone enabling G_TOPOLOGY ioctl further. Agreed. > > > > > - G_TOPOLOGY IOCTL is intended to enable dynamic updates, but do we have a > > driver actually supporting this? > > Laurent requested to postpone dynamic updates at the early stages of the MC > patchset review. The initial patchset were using krefs to handle it. We can > work on adding support for it for 4.6. > > I'm actually working today to add MC support on em28xx USB hardware. > On such driver, there is a master driver (em28xx) and several sub-drivers > (em28xx-video, em28xx-dvb, em28xx-alsa and em28xx-input). The sub-drivers > are loaded asynchronously. meaning that the topology will be dynamically > updated during driver load. The alsa module (or snd-usb-audio - depending > on the hardware) can be unbind/rebind dynamically. > > So, while the hardware itself is not dynamic, dynamic support is > needed, in order to avoid race conditions. Ack. > > For instance, supposing that the users's > > knowledge of the graph state isn't what the user expected it to be > > (assuming the graph state changed between G_TOPOLOGY and SETUP_LINK), does > > the user still want to perform the SETUP_LINK IOCTL or would the user > > prefer that the kernel returned an error instead to tell the user has no > > knowledge of the current graph state? I'd like to see how that works in > > practice. For instance, a virtual driver such as vivi, but with MC, V4L2 > > sub-device and V4L2 support which adds and removes a random entity every, > > say, five minutes, would be wonderful. If this has not been tried out in a > > real use case, the chances of getting it right may remain rather slim. > > It can be simulated by removing/adding or binding/unbinding snd-usb-audio > module. We may also apply the virtual MC driver, if it is ready. Not > sure about its current review stage of the virtual driver. Ah. I have to admit I haven't had enough time to follow up everything that's going on on linux-media, and this one had completely escaped me. I'll try to review it in the near future. > > - struct media_v2_pad contains fields called "id" and "entity_id". The "id" > > field, as far as I understand, is the graph object id, not the pad index. > > In order to configure a link using MEDIA_IOC_SETUP_LINK, one does need to > > know the entity id and the pad index. This information you'll only get > > using MEDIA_IOC_ENUM_LINKS, which right now refutes the very purpose of > > the G_TOPOLOGY IOCTL. Knowing the pad indices is also essential for the > > V4L2 sub-device user space API. (I remember whether or not the pad index > > should be there but I don't remember the details, except that it was > > intentionally left out. Considering this again, I think adding it is > > unavoidable.) > > A new ioctl to setup links is required, as we want to be able to change > the status of multiple links at once. Indeed, that's needed. But do we technically need a new IOCTL for that purpose? The request API should cover that already, and much more. Link configuration alone is often not enough, you very likely need to configure V4L2 sub-device formats as well --- if you have sub-devices. The new IOCTL could cover setting up multiple links at once, but for formats you'd still need request API. This will get complex, I can promise you. > > The thing with the PAD index is that it should be replaced by something > more generic, via the properties API. On some cases, just an index is > enough (when the pads are, for example, the output pins of a demux). The pad index could be passed through the property API, I agree. But until we have the property API, we need something else. > > But, in general, what an application would want is to specify the > "audio out pin" or the "video out pin" of a device. As the index > number may vary depending on the specific device, Such application > should not have the index numbers hardcoded on it, but, instead, > they should discover it via the userspace API. What we've agreed > is that such information would be coded as a property via the > properties API. I fully agree with that. The applications using the MC interface so far have mostly been test programs and hardware-specific applications which are fine as such, but with this level of detail it's not easy to write generic applications. The applications do need more information on the device, and that's where the property API indeed will help. > > > This together with the above point suggest there are no > > real applications using G_TOPOLOGY yet. > > MEDIA_IOC_SETUP_LINK is a must only for subdev-centric hardware, like > OMAP3. For device-node-centric hardware (like em28xx, au0828, etc), > G_TOPOLOGY itself is useful to allow describing the hardware interfaces > and their connections, e. g. to reimplement libmedia_dev at v4l-utils > to use MC instead of sysfs. Do you mean you only have a single pad on each entity? Or that you do not do link specific configuration for non-zero pads? I may have missed something... do you have the media graph of the em28xx somewhere? Pads are an integral part of the graph and it'd be important to provide the user with complete information on them. There are reserved field though so it can always be added later on. > > > - Some more thought should be given to the state of the reserved fields, in > > e.g. struct media_v2_pad there are __u32 fields only, except a reserved > > field which is a __u16 array of 9. While this isn't exactly wrong it makes > > no sense either. > > Well, 2 months is enough for us to address the reserved fields ;) I think we need patches rather than time. :-) I may try to submit some, but time is a limited resource for me as well. :-I > > > - KernelDoc documentation would be nice for the G_TOPOLOGY argument structs. > > DocBook documentation for G_TOPOLOGY as itself is fine, but I think it > > reflects an older version of the structs than what's now defined in > > include/uapi/linux/media.h. > > See: > https://linuxtv.org/downloads/v4l-dvb-apis/media-g-topology.html > > Indeed, there is one missing struct there (media_v2_link). Not sure what > happened here. I guess I lost one hunk when I wrote the KernelDoc > patch. Anyway, adding it is easy. I'll prepare a patch for it soon. > > The description of media_v2_topology actually matches our last > discussion (where we decided to not use any _reserved field there). > > Yet, this difference is actually the reason why we've delayed it in the > first place, as my guts tell that we need more discussions about it. Right. Let's find out the intended layout for the structs in the header and then update the documentation. > > > Please give some thought on this. There are some obvious gaps that need to > > be filled, and when doing so, I don't think we want to start guessing > > whether there might be an application that depends on the current API/ABI. > > > > If you'd like the G_TOPOLOGY IOCTL and its argument structs to be available > > for developers without kernel changes, I propose to add a new Kconfig option > > for G_TOPOLOGY and make it depend on BROKEN. > > > > What do you think? > > Making it depending on BROKEN at our development tree is not a good > thing, as BROKEN is not an option that can be changed with make > menuconfig/xconfig. It needs to be easy to do tests on our > development tree, in order for it to be tested by a broader audience. > > Ok, if we end by needing to postpone it even further, we could do > something different, but it sounds to early to do that, as we can postpone > such decision to happen closer to the next merge window (or even to > happen just before releasing Kernel 4.6, if we discover too late some > real issue there). An additional Kconfig option marked EXPERIMENTAL defaulting to no might still be a good idea. Let's see how things are before the pull request time, ok? In its current state I would suggest that at least, if not depend on BROKEN.
Em Thu, 28 Jan 2016 18:10:05 +0200 Sakari Ailus <sakari.ailus@iki.fi> escreveu: > Hi Mauro, > > On Wed, Jan 27, 2016 at 11:08:40AM -0200, Mauro Carvalho Chehab wrote: > > Em Wed, 27 Jan 2016 13:44:44 +0200 > > Sakari Ailus <sakari.ailus@iki.fi> escreveu: > > > > > Hi Mauro, > > > > > > I see that this patch got applied to the media_tree master, but then > > > reverted a few days ago. > > > > For Kernel 4.5, the new ioctl is disabled. It was reverted after > > pulling back from Linus tree, in order to allow the developers to > > be able to test it and improve it if needed. So, the revert patch is > > meant to reach upstream only in Kernel 4.6, as proposed in this patch. > > > > It means that we have about 2 months to polite it before the next merge > > window. > > My point is that I would prefer that an informed decision is made before the > pull request is sent rather than letting two months to pass before it > happens. The passage of time itself usually does not improve software. Sure, but I hope we'll all working on fixing the issues in time, as we can't postpone it forever ;) > > > > Do you think the G_TOPOLOGY IOCTL and the > > > associated user space structs are ready for being included in a release? > > > > Well, the only doubt we had so far is about how to make it compatible > > with 64 bits kernelspace and 32 bits userspace. 2 months seems more than > > enough for us to properly address that. > > > > > > > > I have a few concerns over the current interface, in decreasing order of > > > importance: > > > > Ok, that's the first time you come with that. I still think that those > > could be addressed in the next 2 months, but, if not, we may eventually > > postpone enabling G_TOPOLOGY ioctl further. > > Agreed. > > > > > > > > > - G_TOPOLOGY IOCTL is intended to enable dynamic updates, but do we have a > > > driver actually supporting this? > > > > Laurent requested to postpone dynamic updates at the early stages of the MC > > patchset review. The initial patchset were using krefs to handle it. We can > > work on adding support for it for 4.6. > > > > I'm actually working today to add MC support on em28xx USB hardware. > > On such driver, there is a master driver (em28xx) and several sub-drivers > > (em28xx-video, em28xx-dvb, em28xx-alsa and em28xx-input). The sub-drivers > > are loaded asynchronously. meaning that the topology will be dynamically > > updated during driver load. The alsa module (or snd-usb-audio - depending > > on the hardware) can be unbind/rebind dynamically. > > > > So, while the hardware itself is not dynamic, dynamic support is > > needed, in order to avoid race conditions. > > Ack. > > > > For instance, supposing that the users's > > > knowledge of the graph state isn't what the user expected it to be > > > (assuming the graph state changed between G_TOPOLOGY and SETUP_LINK), does > > > the user still want to perform the SETUP_LINK IOCTL or would the user > > > prefer that the kernel returned an error instead to tell the user has no > > > knowledge of the current graph state? I'd like to see how that works in > > > practice. For instance, a virtual driver such as vivi, but with MC, V4L2 > > > sub-device and V4L2 support which adds and removes a random entity every, > > > say, five minutes, would be wonderful. If this has not been tried out in a > > > real use case, the chances of getting it right may remain rather slim. > > > > It can be simulated by removing/adding or binding/unbinding snd-usb-audio > > module. We may also apply the virtual MC driver, if it is ready. Not > > sure about its current review stage of the virtual driver. > > Ah. I have to admit I haven't had enough time to follow up everything that's > going on on linux-media, and this one had completely escaped me. I'll try to > review it in the near future. Ok, thanks. > > > - struct media_v2_pad contains fields called "id" and "entity_id". The "id" > > > field, as far as I understand, is the graph object id, not the pad index. > > > In order to configure a link using MEDIA_IOC_SETUP_LINK, one does need to > > > know the entity id and the pad index. This information you'll only get > > > using MEDIA_IOC_ENUM_LINKS, which right now refutes the very purpose of > > > the G_TOPOLOGY IOCTL. Knowing the pad indices is also essential for the > > > V4L2 sub-device user space API. (I remember whether or not the pad index > > > should be there but I don't remember the details, except that it was > > > intentionally left out. Considering this again, I think adding it is > > > unavoidable.) > > > > A new ioctl to setup links is required, as we want to be able to change > > the status of multiple links at once. > > Indeed, that's needed. But do we technically need a new IOCTL for that > purpose? The request API should cover that already, and much more. I didn't review the request API, but this is added to the V4L2 API, right? The media controller stuff should be generic enough to be used by other drivers that don't belong to V4L2 and/or to create a pipeline that is set to work on multiple subsystems (like V4L2, DVB, ALSA and DRM, at the same time). > Link configuration alone is often not enough, you very likely need to > configure V4L2 sub-device formats as well --- if you have sub-devices. The > new IOCTL could cover setting up multiple links at once, but for formats > you'd still need request API. This will get complex, I can promise you. Yes, configuring properties on the links are needed (I'm using a generic term "properties" here, as V4L2 sub-device formats are specific to V4L2 API). For sure this requires more discussions. > > > > > The thing with the PAD index is that it should be replaced by something > > more generic, via the properties API. On some cases, just an index is > > enough (when the pads are, for example, the output pins of a demux). > > The pad index could be passed through the property API, I agree. But until > we have the property API, we need something else. Well, pads are provided in the order they're created, meaning that they're ordered (at least while we don't have dynamic pad addition/removal). Yet, IMHO, instead of relying on it or adding something transitory at the API, the best is to merge the properties API ASAP. Do you have already some testing patchsets with it? > > > > > But, in general, what an application would want is to specify the > > "audio out pin" or the "video out pin" of a device. As the index > > number may vary depending on the specific device, Such application > > should not have the index numbers hardcoded on it, but, instead, > > they should discover it via the userspace API. What we've agreed > > is that such information would be coded as a property via the > > properties API. > > I fully agree with that. > > The applications using the MC interface so far have mostly been test > programs and hardware-specific applications which are fine as such, but with > this level of detail it's not easy to write generic applications. The > applications do need more information on the device, and that's where the > property API indeed will help. Yes. Btw, there's a proposal of a plugin for v4l-utils to work with an Exynos hardware. It could help us to better define the needs to extend it into a generic plugin for applications to use libv4l to setup pipelines via MC. > > > This together with the above point suggest there are no > > > real applications using G_TOPOLOGY yet. > > > > MEDIA_IOC_SETUP_LINK is a must only for subdev-centric hardware, like > > OMAP3. For device-node-centric hardware (like em28xx, au0828, etc), > > G_TOPOLOGY itself is useful to allow describing the hardware interfaces > > and their connections, e. g. to reimplement libmedia_dev at v4l-utils > > to use MC instead of sysfs. > > Do you mean you only have a single pad on each entity? Or that you do not do > link specific configuration for non-zero pads? I may have missed > something... I guess you miss-understood me. The libmedia_dev is a library that uses sysfs to discover all interfaces associated with a certain hardware. This is, for example, what it shows on an em28xx-based HVR-950 device: $ ./v4l2-sysfs-path Video device: video0 vbi: vbi0 dvb frontend: dvb0.frontend0 dvb demux: dvb0.demux0 dvb dvr: dvb0.dvr0 dvb net: dvb0.net0 sound card: hw:2 pcm capture: hw:2,0 mixer: hw:2 Alsa playback device(s): hw:0,3 hw:0,7 hw:0,8 hw:1,0 Currently, the devices are seeing using sysfs nodes, with is not 100%. Also, depending on the root device, the sysfs graph changes and may not work fine. The logic is also complex, as it needs to read lots of sysfs nodes to discover it. All of the above info could be retrieved using G_TOPOLOGY. See: https://mchehab.fedorapeople.org/mc-next-gen/hvr_950.png (ALSA nodes are not there, as I didn't add ALSA support yet for em28xx). > do you have the media graph of the em28xx somewhere? Yes, I'm adding the graphs generated by G_TOPOLOGY ioctl at: https://mchehab.fedorapeople.org/mc-next-gen/ Among them, we have several TV devices. The ones with em28xx are: - HVR950: hybrid analog/digital TV + capture + alsa output + VBI capture (ALSA not implemented yet on MC) https://mchehab.fedorapeople.org/mc-next-gen/hvr_950.png - WinTV USB 2: Pure analog TV device + capture, no VBI (ALSA not implemented yet on MC) https://mchehab.fedorapeople.org/mc-next-gen/wintv_usb2.png I have more em28xx devices here, but tested only with the two above, as I need to patch also the saa711x driver (with is a replacement for the tvp5150 Analog TV decoder) for it to properly report the 3 PADs on it. > Pads are an integral part of the graph and it'd be important to provide the > user with complete information on them. There are reserved field though so > it can always be added later on. True. > > > > > > - Some more thought should be given to the state of the reserved fields, in > > > e.g. struct media_v2_pad there are __u32 fields only, except a reserved > > > field which is a __u16 array of 9. While this isn't exactly wrong it makes > > > no sense either. > > > > Well, 2 months is enough for us to address the reserved fields ;) > > I think we need patches rather than time. :-) > > I may try to submit some, but time is a limited resource for me as well. :-I > > > > > > - KernelDoc documentation would be nice for the G_TOPOLOGY argument structs. > > > DocBook documentation for G_TOPOLOGY as itself is fine, but I think it > > > reflects an older version of the structs than what's now defined in > > > include/uapi/linux/media.h. > > > > See: > > https://linuxtv.org/downloads/v4l-dvb-apis/media-g-topology.html > > > > Indeed, there is one missing struct there (media_v2_link). Not sure what > > happened here. I guess I lost one hunk when I wrote the KernelDoc > > patch. Anyway, adding it is easy. I'll prepare a patch for it soon. > > > > The description of media_v2_topology actually matches our last > > discussion (where we decided to not use any _reserved field there). > > > > Yet, this difference is actually the reason why we've delayed it in the > > first place, as my guts tell that we need more discussions about it. > > Right. Let's find out the intended layout for the structs in the header and > then update the documentation. > > > > > > Please give some thought on this. There are some obvious gaps that need to > > > be filled, and when doing so, I don't think we want to start guessing > > > whether there might be an application that depends on the current API/ABI. > > > > > > If you'd like the G_TOPOLOGY IOCTL and its argument structs to be available > > > for developers without kernel changes, I propose to add a new Kconfig option > > > for G_TOPOLOGY and make it depend on BROKEN. > > > > > > What do you think? > > > > Making it depending on BROKEN at our development tree is not a good > > thing, as BROKEN is not an option that can be changed with make > > menuconfig/xconfig. It needs to be easy to do tests on our > > development tree, in order for it to be tested by a broader audience. > > > > Ok, if we end by needing to postpone it even further, we could do > > something different, but it sounds to early to do that, as we can postpone > > such decision to happen closer to the next merge window (or even to > > happen just before releasing Kernel 4.6, if we discover too late some > > real issue there). > > An additional Kconfig option marked EXPERIMENTAL defaulting to no might > still be a good idea. Let's see how things are before the pull request time, > ok? > > In its current state I would suggest that at least, if not depend on BROKEN. > As I said, let's see how well we'll handle the development, and take the decision of changing it later on. Regards, Mauro -- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
diff --git a/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml b/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml index e0d49fa329f0..63152ab9efba 100644 --- a/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml +++ b/Documentation/DocBook/media/v4l/media-ioc-g-topology.xml @@ -48,6 +48,9 @@ <refsect1> <title>Description</title> + + <para><emphasis role="bold">NOTE:</emphasis> This new ioctl is programmed to be added on Kernel 4.6. Its definition/arguments may change until its final version.</para> + <para>The typical usage of this ioctl is to call it twice. On the first call, the structure defined at &media-v2-topology; should be zeroed. At return, if no errors happen, this ioctl will return the diff --git a/drivers/media/media-device.c b/drivers/media/media-device.c index 4d1c13de494b..7dae0ac0f3ae 100644 --- a/drivers/media/media-device.c +++ b/drivers/media/media-device.c @@ -234,6 +234,7 @@ static long media_device_setup_link(struct media_device *mdev, return ret; } +#if 0 /* Let's postpone it to Kernel 4.6 */ static long __media_device_get_topology(struct media_device *mdev, struct media_v2_topology *topo) { @@ -389,6 +390,7 @@ static long media_device_get_topology(struct media_device *mdev, return 0; } +#endif static long media_device_ioctl(struct file *filp, unsigned int cmd, unsigned long arg) @@ -422,13 +424,14 @@ static long media_device_ioctl(struct file *filp, unsigned int cmd, mutex_unlock(&dev->graph_mutex); break; +#if 0 /* Let's postpone it to Kernel 4.6 */ case MEDIA_IOC_G_TOPOLOGY: mutex_lock(&dev->graph_mutex); ret = media_device_get_topology(dev, (struct media_v2_topology __user *)arg); mutex_unlock(&dev->graph_mutex); break; - +#endif default: ret = -ENOIOCTLCMD; } @@ -477,7 +480,9 @@ static long media_device_compat_ioctl(struct file *filp, unsigned int cmd, case MEDIA_IOC_DEVICE_INFO: case MEDIA_IOC_ENUM_ENTITIES: case MEDIA_IOC_SETUP_LINK: +#if 0 /* Let's postpone it to Kernel 4.6 */ case MEDIA_IOC_G_TOPOLOGY: +#endif return media_device_ioctl(filp, cmd, arg); case MEDIA_IOC_ENUM_LINKS32: diff --git a/include/uapi/linux/media.h b/include/uapi/linux/media.h index 5dbb208e5451..1e3c8cb43bd7 100644 --- a/include/uapi/linux/media.h +++ b/include/uapi/linux/media.h @@ -286,7 +286,7 @@ struct media_links_enum { * later, before the adding this API upstream. */ - +#if 0 /* Let's postpone it to Kernel 4.6 */ struct media_v2_entity { __u32 id; char name[64]; /* FIXME: move to a property? (RFC says so) */ @@ -351,6 +351,7 @@ static inline void __user *media_get_uptr(__u64 arg) { return (void __user *)(uintptr_t)arg; } +#endif /* ioctls */ @@ -358,6 +359,9 @@ static inline void __user *media_get_uptr(__u64 arg) #define MEDIA_IOC_ENUM_ENTITIES _IOWR('|', 0x01, struct media_entity_desc) #define MEDIA_IOC_ENUM_LINKS _IOWR('|', 0x02, struct media_links_enum) #define MEDIA_IOC_SETUP_LINK _IOWR('|', 0x03, struct media_link_desc) + +#if 0 /* Let's postpone it to Kernel 4.6 */ #define MEDIA_IOC_G_TOPOLOGY _IOWR('|', 0x04, struct media_v2_topology) +#endif #endif /* __LINUX_MEDIA_H */
There are a few discussions left with regards to this ioctl: 1) the name of the new structs will contain _v2_ on it? 2) what's the best alternative to avoid compat32 issues? Due to that, let's postpone the addition of this new ioctl to the next Kernel version, to give people more time to discuss it. Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com> --- v2: Fix a compilation breakage Documentation/DocBook/media/v4l/media-ioc-g-topology.xml | 3 +++ drivers/media/media-device.c | 7 ++++++- include/uapi/linux/media.h | 6 +++++- 3 files changed, 14 insertions(+), 2 deletions(-)