Unified fwnode endpoint parser, async sub-device notifier support, N9 flash DTS
Subsystems (20)
v12 cover Unified fwnode endpoint parser, async sub-device notifier support, N9 flash DTS
Hi folks,
We have a large influx of new, unmerged, drivers that are now parsing fwnode endpoints and each one of them is doing this a little bit differently. The needs are still exactly the same for the graph data structure is device independent. This is still a non-trivial task and the majority of the driver implementations are buggy, just buggy in different ways.
Facilitate parsing endpoints by adding a convenience function for parsing the endpoints, and make the omap3isp and rcar-vin drivers use them as an example.
To show where we're getting with this, I've added support for async sub-device notifier support that is notifiers that can be registered by sub-device drivers as well as V4L2 fwnode improvements to make use of them and the DTS changes for the Nokia N9. Some of these patches I've posted previously in this set here:
<URL:http://www.spinics.net/lists/linux-media/msg118764.html>
Since that, the complete callback of the master notifier registering the V4L2 device is only called once all sub-notifiers have been completed as well. This way the device node creation can be postponed until all devices have been successfully initialised.
With this, the as3645a driver successfully registers a sub-device to the media device created by the omap3isp driver. The kernel also has the information it's related to the sensor driven by the smiapp driver but we don't have a way to expose that information yet.
since v11:
- Add patch "et8ek8: Add support for flash and lens devices".
- Add patch "v4l: fwnode: Support generic parsing of graph endpoints, per port". The use case for this is to parse only upstream ports in a device with sources and sinks. The downstream ports have already been parsed by other drivers.
- Rename v4l2_fwnode_reference_parse_sensor_common as v4l2_async_notifier_parse_fwnode_sensor_common. This is in line with other functions that parse information using fwnode API and set up async sub-devices in the notifier.
since v10:
- Rename v4l2_async_get_subdev_notifier as v4l2_async_find_subdev_notifier, as this is what it effectively does:
finds a notifier for a sub-device. Same for v4l2_async_notifier_get_v4l2_dev / v4l2_async_notifier_get_v4l2_dev.
- Initialise lists before calling v4l2_async_notifier_call_complete() if there are no sub-devices in a notifier.
- Warn on missing sub-device or existing v4l2_device on sub-device notifier register, and conversely missing v4l2_device or existing sub-device for a master notifier.
- Set notifier's sd and v4l2_dev fields NULL when the sub-device is unregistered.
- Document the newly added helper functions for parsing external references in v4l2-fwnode.c better.
- Return -ENOENT in v4l2_fwnode_reference_parse if no entries are found, and other errors as they occur.
- Turn the loop in v4l2_fwnode_reference_get_int_prop a while loop (was for).
- Don't put fwnodes in v4l2_fwnode_reference_parse_int_props.
- Fix description of parent field in struct v4l2_async_notifier.
- In the documentation of v4l2_async_notifier_release, document that this function must be called also after v4l2_fwnode_reference_parse_sensor_common, not just v4l2_async_notifier_parse_fwnode_endpoints. The same goes for v4l2_async_notifier_parse_fwnode_endpoints as well as v4l2_fwnode_reference_parse_sensor_common.
since v9:
- Drop "as3645a: Switch to fwnode property API" and "ACPI: Document how to refer to LEDs from remote nodes" patches. They're better off separately from this set.
- Address property documentation redundancy in smiapp DT binding documentation.
- Add patches "ov5670: Add support for flash and lens devices" and "ov13858: Add support for flash and lens devices".
since v8:
- Improve terminology for notifiers. Instead of master / subdev, we have root, parent and subdev notifiers.
- Renamed "flash" property as "flash-leds". There are many, and currently we make assumptions in a lot of places (e.g. LED bindings) that these are LEDs. While we don't have any other types of flashes supported right now (e.g. Xenon), it's safer to assume we might have them in the future.
- Use ENOTCONN instead of EPERM to tell from driver's callback function that an endpoint is to be skipped but not handled as an error.
- Avoid accessing notifier's subdevs array as well as num_subdevs field from rcar-vin driver.
- Add a patch "v4l: async: Allow async notifier register call succeed with no subdevs", which allows, well, what the subject says.
- Move checks for subdev / v4l2_dev from __v4l2_async_notifier_register() to v4l2_async_notifier_register() and v4l2_async_subdev_notifier_register().
- Don't initialise notifier->list. There was no need to do so, as this is the entry added to the list and not used otherwise. I.e. regarding this, the state before this patchset is restored.
- Clean up error handling in v4l2_async_notifier_fwnode_parse_endpoint().
- WARN_ON() in v4l2_async_notifier_parse_fwnode_endpoints() if the asd_struct_size is smaller than size of struct v4l2_async_subdev.
- Make v4l2_fwnode_reference_parse() static as there should be no need to use it outside the V4L2 fwnode framework. Also, remove the callback function as well as other arguments that always have the same value in current usage. (This can be changed later on if needed without affecting drivers.)
- Add the patch "v4l: fwnode: Add a helper function to obtain device / interger references", which allows similar use than v4l2_fwnode_reference_parse() but is more useful on ACPI based systems --- on ACPI, you can only refer to device nodes (corresponding struct deice in Linux), not to data extension nodes under the devices.
- Improve v4l2_fwnode_reference_parse_sensor_common() to work on ACPI based systems.
- Add patch "ACPI: Document how to refer to LEDs from remote nodes" to document using and referring to LEDs on ACPI.
- Rebase the set on AS3645A fixes I just sent ("AS3645A fixes")
- In v4l2_fwnode_reference_parse_sensor_common(), tell if parsing a property failed.
- Improved documentation for v4l2_async_notifier_parse_fwnode_endpoints().
- Fix v4l2_async_notifier_try_all_subdevs(); it is allowed that the list entry being iterated over is deleted but no other changes to the list are allowed. This could be the case if a sub-device driver's notifier binds a sub-device. Restart the loop whenever a match is found.
- Add patch "as3645a: Switch to fwnode property API" which also adds ACPI support.
since v7:
- Added three more patches:
v4l: async: Remove re-probing support
v4l: async: Use more intuitive names for internal functions
dt: bindings: smiapp: Document lens-focus and flash properties
The last one was already sent previously after the rest of the patchset.
- Removed re-probing support. This is hard to support and only useful in special cases. It can be reintroduced later on if there's really a need --- note that in e.g. omap3isp this was always broken and no-one ever complained.
- Remove smiapp driver's async complete callback (and ops). It is
redundant: the sub-device nodes are created through the master notifier.
- Improve flash property documentation in video-interfaces.txt.
- Introduce helper functions to call notifier operations, one for each operation.
- Rename v4l2_async_test_notify as v4l2_async_match_notify and v4l2_async_belongs to v4l2_async_find_match.
- v4l2_async_notifier_test_all_subdevs() renamed as v4l2_async_notifier_try_all_subdevs().
- Made notifier_v4l2_dev a function (it was a macro).
- Registering subdev notifiers from sub-device drivers that control sub-devices created through sub-notifiers is now supported. In other words, subdev notifiers may be registered through other subdev notifiers. This is the source of the bulk of the changes between v7 and v8.
- Add explanatory comments to helper functions used by V4L2 async framework. This should help understanding the internal workings of the framework.
- Removed the "notifiers" list in struct v4l2_async_notifier. The information can be found from existing data structures.
- Explicitly check that registering a non-subdev notifier has v4l2_dev and a subdev notifier has a sub-device pointer.
- Unified several code paths between subdev notifiers and non-subdev notifiers.
- Fixed v4l2_async_notifier_release() --- calling it on a notifier for which the driver had allocated the subdevs array would lead calling kvfree() on that array. Now notifier->max_subdevs is checked before proceeding.
- Fixed a use-after-free issue in
v4l2_async_notifier_fwnode_parse_endpoints().
- Small fixes to KernelDoc documentation for
v4l2_async_notifier_parse_fwnode_endpoints().
since v6:
- Drop the last patch that added variant for parsing endpoints given specific port and endpoints numbers.
- Separate driver changes from the fwnode endpoint parser patch into two patches. rcar-vin driver is now using the name function.
- Use -ENOTCONN to tell the parser that and endpoint (or a reference) is to be ignored.
- parse_endpoint and parse_single callback functions are now optional and documented as such.
- Added Laurent's patch adding notifier operations struct which I rebase on the fwnode parser patchset. I wrote another patch to call the notifier operations through macros.
- Add DT bindings for flash and lens devices.
- V4L2 fwnode parser for references (such as flash and lens).
- Added smiapp driver support for async sub-devices (lens and flash).
- Added a few fixes for omap3isp.
since v5:
- Use v4l2_async_ prefix for static functions as well (4th patch)
- Use memcpy() to copy array rather than a loop
- Document that the v4l2_async_subdev pointer in driver specific struct must be the first member
- Improve documentation of the added functions (4th and 5th patches)
- Arguments
- More thorough explation of the purpose, usage and object lifetime
- Added acks
since v4:
- Prepend the set with three documentation fixes.
- The driver's async struct must begin with struct v4l2_async_subdev. Fix this for omap3isp and document it.
- Improve documentation for new functions.
- Don't use devm_ family of functions for allocating memory. Introduce v4l2_async_notifier_release() to release memory resources.
- Rework both v4l2_async_notifier_fwnode_parse_endpoints() and v4l2_async_notifier_fwnode_parse_endpoint() and the local functions they call. This should make the code cleaner. Despite the name, for linking and typical usage reasons the functions remain in v4l2-fwnode.c.
- Convert rcar-vin to use v4l2_async_notifier_fwnode_parse_endpoint().
- Use kvmalloc() for allocating the notifier's subdevs array.
- max_subdevs argument for notifier_realloc is now the total maximum number of subdevs, not the number of available subdevs.
- Use fwnode_device_is_available() to make sure the device actually exists.
- Move the note telling v4l2_async_notifier_fwnode_parse_endpoints() should not be used by new drivers to the last patch adding v4l2_async_notifier_fwnode_parse_endpoint().
since v3:
- Rebase on current mediatree master.
since v2:
- Rebase on CCP2 support patches.
- Prepend a patch cleaning up omap3isp driver a little.
since v1:
- The first patch has been merged (it was a bugfix).
- In anticipation that the parsing can take place over several iterations, take the existing number of async sub-devices into account when re-allocating an array of async sub-devices.
- Rework the first patch to better anticipate parsing single endpoint at a time by a driver.
- Add a second patch that adds a function for parsing endpoints one at a time based on port and endpoint numbers.
Laurent Pinchart (1):
v4l: async: Move async subdev notifier operations to a separate
structure
Pavel Machek (1):
et8ek8: Add support for flash and lens devices
Sakari Ailus (24):
v4l: fwnode: Move KernelDoc documentation to the header
v4l: async: Remove re-probing support
v4l: async: Use more intuitive names for internal functions
v4l: async: Add V4L2 async documentation to the documentation build
v4l: fwnode: Support generic parsing of graph endpoints in a device
v4l: fwnode: Support generic parsing of graph endpoints, per port
omap3isp: Use generic parser for parsing fwnode endpoints
rcar-vin: Use generic parser for parsing fwnode endpoints
omap3isp: Fix check for our own sub-devices
omap3isp: Print the name of the entity where no source pads could be
found
v4l: async: Introduce helpers for calling async ops callbacks
v4l: async: Register sub-devices before calling bound callback
v4l: async: Allow async notifier register call succeed with no subdevs
v4l: async: Allow binding notifiers to sub-devices
dt: bindings: Add a binding for flash LED devices associated to a
sensor
dt: bindings: Add lens-focus binding for image sensors
v4l: fwnode: Add a helper function for parsing generic references
v4l: fwnode: Add a helper function to obtain device / interger
references
v4l: fwnode: Add convenience function for parsing common external refs
dt: bindings: smiapp: Document lens-focus and flash-leds properties
smiapp: Add support for flash and lens devices
ov5670: Add support for flash and lens devices
ov13858: Add support for flash and lens devices
arm: dts: omap3: N9/N950: Add flash references to the camera
.../devicetree/bindings/media/i2c/nokia,smia.txt | 2 + .../devicetree/bindings/media/video-interfaces.txt | 10 + Documentation/media/kapi/v4l2-async.rst | 3 + Documentation/media/kapi/v4l2-core.rst | 1 + arch/arm/boot/dts/omap3-n9.dts | 1 + arch/arm/boot/dts/omap3-n950-n9.dtsi | 4 +- arch/arm/boot/dts/omap3-n950.dts | 1 + drivers/media/i2c/et8ek8/et8ek8_driver.c | 21 +- drivers/media/i2c/ov13858.c | 26 +- drivers/media/i2c/ov5670.c | 33 +- drivers/media/i2c/smiapp/smiapp-core.c | 38 +- drivers/media/i2c/smiapp/smiapp.h | 4 +- drivers/media/platform/am437x/am437x-vpfe.c | 8 +- drivers/media/platform/atmel/atmel-isc.c | 10 +- drivers/media/platform/atmel/atmel-isi.c | 10 +- drivers/media/platform/davinci/vpif_capture.c | 8 +- drivers/media/platform/davinci/vpif_display.c | 8 +- drivers/media/platform/exynos4-is/media-dev.c | 8 +- drivers/media/platform/omap3isp/isp.c | 127 ++--- drivers/media/platform/omap3isp/isp.h | 5 +- drivers/media/platform/pxa_camera.c | 8 +- drivers/media/platform/qcom/camss-8x16/camss.c | 8 +- drivers/media/platform/rcar-vin/rcar-core.c | 122 ++--- drivers/media/platform/rcar-vin/rcar-dma.c | 10 +- drivers/media/platform/rcar-vin/rcar-v4l2.c | 14 +- drivers/media/platform/rcar-vin/rcar-vin.h | 4 +- drivers/media/platform/rcar_drif.c | 10 +- drivers/media/platform/soc_camera/soc_camera.c | 14 +- drivers/media/platform/stm32/stm32-dcmi.c | 10 +- drivers/media/platform/ti-vpe/cal.c | 8 +- drivers/media/platform/xilinx/xilinx-vipp.c | 8 +- drivers/media/v4l2-core/v4l2-async.c | 347 ++++++++++---- drivers/media/v4l2-core/v4l2-fwnode.c | 509 ++++++++++++++++++--- drivers/staging/media/imx/imx-media-dev.c | 8 +- include/media/v4l2-async.h | 69 ++- include/media/v4l2-fwnode.h | 217 ++++++++- 36 files changed, 1272 insertions(+), 422 deletions(-) create mode 100644 Documentation/media/kapi/v4l2-async.rst
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): 20170912134200.19556-1-sakari.ailus-VuQAYsv1563Yd54FQh9/[email protected]
PATCH v12 1/26 v4l: fwnode: Move KernelDoc documentation to the header
In V4L2 the practice is to have the KernelDoc documentation in the header and not in .c source code files. This consequently makes the V4L2 fwnode function documentation part of the Media documentation build.
Also correct the link related function and argument naming in documentation.
--- drivers/media/v4l2-core/v4l2-fwnode.c | 75 -------------------------------- include/media/v4l2-fwnode.h | 81 ++++++++++++++++++++++++++++++++++- 2 files changed, 80 insertions(+), 76 deletions(-)
drivers/media/v4l2-core/v4l2-fwnode.c +0 -75
@@ -181,25 +181,6 @@ v4l2_fwnode_endpoint_parse_csi1_bus(struct fwnode_handle *fwnode, vep->bus_type =V4L2_MBUS_CSI1 ; } -/** -* v4l2_fwnode_endpoint_parse() - parse all fwnode node properties -* @fwnode: pointer to the endpoint's fwnode handle -* @vep: pointer to the V4L2 fwnode data structure -* -* All properties are optional. If none are found, we don't set any flags. This -* means the port has a static configuration and no properties have to be -* specified explicitly. If any properties that identify the bus as parallel -* are found and slave-mode isn't set, we set V4L2_MBUS_MASTER. Similarly, if -* we recognise the bus as serial CSI-2 and clock-noncontinuous isn't set, we -* set the V4L2_MBUS_CSI2_CONTINUOUS_CLOCK flag. The caller should hold a -* reference to @fwnode. -* -* NOTE: This function does not parse properties the size of which is variable -* without a low fixed limit. Please use v4l2_fwnode_endpoint_alloc_parse() in -* new drivers instead. -* -* Return: 0 on success or a negative error code on failure. -*/ int v4l2_fwnode_endpoint_parse (struct fwnode_handle *fwnode,struct v4l2_fwnode_endpoint *vep) {
@@ -239,14 +220,6 @@ int v4l2_fwnode_endpoint_parse(struct fwnode_handle *fwnode, }EXPORT_SYMBOL_GPL (v4l2_fwnode_endpoint_parse); -/* -* v4l2_fwnode_endpoint_free() - free the V4L2 fwnode acquired by -* v4l2_fwnode_endpoint_alloc_parse() -* @vep - the V4L2 fwnode the resources of which are to be released -* -* It is safe to call this function with NULL argument or on a V4L2 fwnode the -* parsing of which failed. -*/ void v4l2_fwnode_endpoint_free (struct v4l2_fwnode_endpoint *vep) {if (IS_ERR_OR_NULL (vep))
@@ -257,29 +230,6 @@ void v4l2_fwnode_endpoint_free(struct v4l2_fwnode_endpoint *vep) }EXPORT_SYMBOL_GPL (v4l2_fwnode_endpoint_free); -/** -* v4l2_fwnode_endpoint_alloc_parse() - parse all fwnode node properties -* @fwnode: pointer to the endpoint's fwnode handle -* -* All properties are optional. If none are found, we don't set any flags. This -* means the port has a static configuration and no properties have to be -* specified explicitly. If any properties that identify the bus as parallel -* are found and slave-mode isn't set, we set V4L2_MBUS_MASTER. Similarly, if -* we recognise the bus as serial CSI-2 and clock-noncontinuous isn't set, we -* set the V4L2_MBUS_CSI2_CONTINUOUS_CLOCK flag. The caller should hold a -* reference to @fwnode. -* -* v4l2_fwnode_endpoint_alloc_parse() has two important differences to -* v4l2_fwnode_endpoint_parse(): -* -* 1. It also parses variable size data. -* -* 2. The memory it has allocated to store the variable size data must be freed -* using v4l2_fwnode_endpoint_free() when no longer needed. -* -* Return: Pointer to v4l2_fwnode_endpoint if successful, on an error pointer -* on error. -*/ struct v4l2_fwnode_endpoint *v4l2_fwnode_endpoint_alloc_parse (struct fwnode_handle *fwnode) {
@@ -322,24 +272,6 @@ struct v4l2_fwnode_endpoint *v4l2_fwnode_endpoint_alloc_parse( }EXPORT_SYMBOL_GPL (v4l2_fwnode_endpoint_alloc_parse); -/** -* v4l2_fwnode_endpoint_parse_link() - parse a link between two endpoints -* @__fwnode: pointer to the endpoint's fwnode at the local end of the link -* @link: pointer to the V4L2 fwnode link data structure -* -* Fill the link structure with the local and remote nodes and port numbers. -* The local_node and remote_node fields are set to point to the local and -* remote port's parent nodes respectively (the port parent node being the -* parent node of the port node if that node isn't a 'ports' node, or the -* grand-parent node of the port node otherwise). -* -* A reference is taken to both the local and remote nodes, the caller must use -* v4l2_fwnode_endpoint_put_link() to drop the references when done with the -* link. -* -* Return: 0 on success, or -ENOLINK if the remote endpoint fwnode can't be -* found. -*/ int v4l2_fwnode_parse_link (struct fwnode_handle *__fwnode,struct v4l2_fwnode_link *link) {
@@ -374,13 +306,6 @@ int v4l2_fwnode_parse_link(struct fwnode_handle *__fwnode, }EXPORT_SYMBOL_GPL (v4l2_fwnode_parse_link); -/** -* v4l2_fwnode_put_link() - drop references to nodes in a link -* @link: pointer to the V4L2 fwnode link data structure -* -* Drop references to the local and remote nodes in the link. This function -* must be called on every link parsed with v4l2_fwnode_parse_link(). -*/ void v4l2_fwnode_put_link (struct v4l2_fwnode_link *link) {fwnode_handle_put (link->local_node);
include/media/v4l2-fwnode.h +80 -1
93 lines not on this page · raw message
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 2/26 v4l: async: Remove re-probing support
In reply to a message not in the archiveRemove V4L2 async re-probing support. The re-probing support has been there to support cases where the sub-devices require resources provided by the main driver's hardware to function, such as clocks.
Reprobing has allowed unbinding and again binding the main driver without explicilty unbinding the sub-device drivers. This is certainly not a common need, and the responsibility will be the user's going forward.
An alternative could have been to introduce notifier specific locks. Considering the complexity of the re-probing and that it isn't really a solution to a problem but a workaround, remove re-probing instead.
--- drivers/media/v4l2-core/v4l2-async.c | 54 ------------------------------------ 1 file changed, 54 deletions(-)
drivers/media/v4l2-core/v4l2-async.c +0 -54
@@ -198,78 +198,24 @@ EXPORT_SYMBOL(v4l2_async_notifier_register);void v4l2_async_notifier_unregister (struct v4l2_async_notifier *notifier) {struct v4l2_subdev *sd, *tmp; -unsigned int notif_n_subdev = notifier->num_subdevs; -unsigned int n_subdev =min (notif_n_subdev,V4L2_MAX_SUBDEVS ); -struct device **dev; -int i =0 ;if (!notifier->v4l2_dev)return ; - dev =kvmalloc_array (n_subdev,sizeof (*dev),GFP_KERNEL ); -if (!dev) { -dev_err (notifier->v4l2_dev->dev, -"Failed to allocate device cache!\n" ); - } -mutex_lock (&list_lock);list_del (¬ifier->list);list_for_each_entry_safe (sd, tmp, ¬ifier->done, async_list) { -struct device *d; - - d =get_device (sd->dev); -v4l2_async_cleanup (sd); -/* If we handled USB devices, we'd have to lock the parent too */ -device_release_driver (d); -if (notifier->unbind) notifier->unbind (notifier, sd, sd->asd); - -/* -* Store device at the device cache, in order to call -* put_device() on the final step -*/ -if (dev) - dev[i++] = d; -else -put_device (d); }mutex_unlock (&list_lock); -/* -* Call device_attach() to reprobe devices -* -* NOTE: If dev allocation fails, i is 0, and the whole loop won't be -* executed. -*/ -while (i--) { -struct device *d = dev[i]; - -if (d &&device_attach (d) <0 ) { -const char *name ="(none)" ; -int lock =device_trylock (d); - -if (lock && d->driver) - name = d->driver->name; -dev_err (d,"Failed to re-probe to %s\n" , name); -if (lock) -device_unlock (d); - } -put_device (d); - } -kvfree (dev); - notifier->v4l2_dev =NULL ; - -/* -* Don't care about the waiting list, it is initialised and populated -* upon notifier registration. -*/ }EXPORT_SYMBOL (v4l2_async_notifier_unregister);
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 7/26 omap3isp: Use generic parser for parsing fwnode endpoints
In reply to a message not in the archiveInstead of using driver implementation, use v4l2_async_notifier_parse_fwnode_endpoints() to parse the fwnode endpoints of the device.
--- drivers/media/platform/omap3isp/isp.c | 115 +++++++++++----------------------- drivers/media/platform/omap3isp/isp.h | 5 +- 2 files changed, 37 insertions(+), 83 deletions(-)
drivers/media/platform/omap3isp/isp.c +36 -79
@@ -2001,6 +2001,7 @@ static int isp_remove(struct platform_device *pdev)__omap3isp_put (isp, false);media_entity_enum_cleanup (&isp->crashed); +v4l2_async_notifier_release (&isp->notifier);return 0 ; }
@@ -2011,44 +2012,41 @@ enum isp_of_phy { ISP_OF_PHY_CSIPHY2, }; -static int isp_fwnode_parse (struct device *dev,struct fwnode_handle *fwnode, -struct isp_async_subdev *isd) +static int isp_fwnode_parse (struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd) { +struct isp_async_subdev *isd = + container_of(asd, struct isp_async_subdev, asd);struct isp_bus_cfg *buscfg = &isd->bus; -struct v4l2_fwnode_endpoint vep; -unsigned int i; -int ret;bool csi1 = false; - - ret =v4l2_fwnode_endpoint_parse (fwnode, &vep); -if (ret) -return ret; +unsigned int i;dev_dbg (dev,"parsing endpoint %pOF, interface %u\n" , -to_of_node (fwnode), vep.base.port); +to_of_node (vep->base.local_fwnode), vep->base.port); -switch (vep.base.port) { +switch (vep->base.port) {case ISP_OF_PHY_PARALLEL : buscfg->interface =ISP_INTERFACE_PARALLEL ; buscfg->bus.parallel.data_lane_shift = - vep.bus.parallel.data_shift; + vep->bus.parallel.data_shift; buscfg->bus.parallel.clk_pol = - !!(vep.bus.parallel.flags + !!(vep->bus.parallel.flags &V4L2_MBUS_PCLK_SAMPLE_FALLING ); buscfg->bus.parallel.hs_pol = - !!(vep.bus.parallel.flags &V4L2_MBUS_VSYNC_ACTIVE_LOW ); + !!(vep->bus.parallel.flags &V4L2_MBUS_VSYNC_ACTIVE_LOW ); buscfg->bus.parallel.vs_pol = - !!(vep.bus.parallel.flags &V4L2_MBUS_HSYNC_ACTIVE_LOW ); + !!(vep->bus.parallel.flags &V4L2_MBUS_HSYNC_ACTIVE_LOW ); buscfg->bus.parallel.fld_pol = - !!(vep.bus.parallel.flags &V4L2_MBUS_FIELD_EVEN_LOW ); + !!(vep->bus.parallel.flags &V4L2_MBUS_FIELD_EVEN_LOW ); buscfg->bus.parallel.data_pol = - !!(vep.bus.parallel.flags &V4L2_MBUS_DATA_ACTIVE_LOW ); - buscfg->bus.parallel.bt656 = vep.bus_type ==V4L2_MBUS_BT656 ; + !!(vep->bus.parallel.flags &V4L2_MBUS_DATA_ACTIVE_LOW ); + buscfg->bus.parallel.bt656 = vep->bus_type ==V4L2_MBUS_BT656 ;break ;case ISP_OF_PHY_CSIPHY1 :case ISP_OF_PHY_CSIPHY2 : -switch (vep.bus_type) { +switch (vep->bus_type) {case V4L2_MBUS_CCP2 :case V4L2_MBUS_CSI1 :dev_dbg (dev,"CSI-1/CCP-2 configuration\n" );
@@ -2060,11 +2058,11 @@ static int isp_fwnode_parse(struct device *dev, struct fwnode_handle *fwnode,break ;default :dev_err (dev,"unsupported bus type %u\n" , - vep.bus_type); + vep->bus_type);return -EINVAL ; } -switch (vep.base.port) { +switch (vep->base.port) {case ISP_OF_PHY_CSIPHY1 :if (csi1) buscfg->interface =ISP_INTERFACE_CCP2B_PHY1 ;
@@ -2080,47 +2078,47 @@ static int isp_fwnode_parse(struct device *dev, struct fwnode_handle *fwnode, }if (csi1) { buscfg->bus.ccp2.lanecfg.clk.pos = - vep.bus.mipi_csi1.clock_lane; + vep->bus.mipi_csi1.clock_lane; buscfg->bus.ccp2.lanecfg.clk.pol = - vep.bus.mipi_csi1.lane_polarity[0 ]; + vep->bus.mipi_csi1.lane_polarity[0 ];dev_dbg (dev,"clock lane polarity %u, pos %u\n" , buscfg->bus.ccp2.lanecfg.clk.pol, buscfg->bus.ccp2.lanecfg.clk.pos); buscfg->bus.ccp2.lanecfg.data[0 ].pos = - vep.bus.mipi_csi1.data_lane; + vep->bus.mipi_csi1.data_lane; buscfg->bus.ccp2.lanecfg.data[0 ].pol = - vep.bus.mipi_csi1.lane_polarity[1 ]; + vep->bus.mipi_csi1.lane_polarity[1 ];dev_dbg (dev,"data lane polarity %u, pos %u\n" , buscfg->bus.ccp2.lanecfg.data[0 ].pol, buscfg->bus.ccp2.lanecfg.data[0 ].pos); buscfg->bus.ccp2.strobe_clk_pol = - vep.bus.mipi_csi1.clock_inv; - buscfg->bus.ccp2.phy_layer = vep.bus.mipi_csi1.strobe; + vep->bus.mipi_csi1.clock_inv; + buscfg->bus.ccp2.phy_layer = vep->bus.mipi_csi1.strobe; buscfg->bus.ccp2.ccp2_mode = - vep.bus_type ==V4L2_MBUS_CCP2 ; + vep->bus_type ==V4L2_MBUS_CCP2 ; buscfg->bus.ccp2.vp_clk_pol =1 ; buscfg->bus.ccp2.crc =1 ; }else { buscfg->bus.csi2.lanecfg.clk.pos = - vep.bus.mipi_csi2.clock_lane; + vep->bus.mipi_csi2.clock_lane; buscfg->bus.csi2.lanecfg.clk.pol = - vep.bus.mipi_csi2.lane_polarities[0 ]; + vep->bus.mipi_csi2.lane_polarities[0 ];dev_dbg (dev,"clock lane polarity %u, pos %u\n" , buscfg->bus.csi2.lanecfg.clk.pol, buscfg->bus.csi2.lanecfg.clk.pos); buscfg->bus.csi2.num_data_lanes = - vep.bus.mipi_csi2.num_data_lanes; + vep->bus.mipi_csi2.num_data_lanes;for (i =0 ; i < buscfg->bus.csi2.num_data_lanes; i++) { buscfg->bus.csi2.lanecfg.data[i].pos = - vep.bus.mipi_csi2.data_lanes[i]; + vep->bus.mipi_csi2.data_lanes[i]; buscfg->bus.csi2.lanecfg.data[i].pol = - vep.bus.mipi_csi2.lane_polarities[i +1 ]; + vep->bus.mipi_csi2.lane_polarities[i +1 ]; dev_dbg(dev, "data lane %u polarity %u, pos %u\n", i, buscfg->bus.csi2.lanecfg.data[i].pol,
@@ -2137,57 +2135,13 @@ static int isp_fwnode_parse(struct device *dev, struct fwnode_handle *fwnode,default :dev_warn (dev,"%pOF: invalid interface %u\n" , -to_of_node (fwnode), vep.base.port); +to_of_node (vep->base.local_fwnode), vep->base.port);return -EINVAL ; }return 0 ; } -static int isp_fwnodes_parse (struct device *dev, -struct v4l2_async_notifier *notifier) -{ -struct fwnode_handle *fwnode =NULL ; - - notifier->subdevs =devm_kcalloc ( - dev,ISP_MAX_SUBDEVS ,sizeof (*notifier->subdevs),GFP_KERNEL ); -if (!notifier->subdevs) -return -ENOMEM ; - -while (notifier->num_subdevs <ISP_MAX_SUBDEVS && - (fwnode =fwnode_graph_get_next_endpoint ( -of_fwnode_handle (dev->of_node), fwnode))) { -struct isp_async_subdev *isd; - - isd =devm_kzalloc (dev,sizeof (*isd),GFP_KERNEL ); -if (!isd) - goto error; - -if (isp_fwnode_parse (dev, fwnode, isd)) { -devm_kfree (dev, isd); -continue ; - } - - notifier->subdevs[notifier->num_subdevs] = &isd->asd; - - isd->asd.match.fwnode.fwnode = -fwnode_graph_get_remote_port_parent (fwnode); -if (!isd->asd.match.fwnode.fwnode) { -dev_warn (dev,"bad remote port parent\n" ); - goto error; - } - - isd->asd.match_type =V4L2_ASYNC_MATCH_FWNODE ; - notifier->num_subdevs++; - } - -return notifier->num_subdevs; - -error: -fwnode_handle_put (fwnode); -return -EINVAL ; -} -static int isp_subdev_notifier_complete (struct v4l2_async_notifier *async) { struct isp_device *isp = container_of(async, struct isp_device,
@@ -2256,7 +2210,9 @@ static int isp_probe(struct platform_device *pdev)if (ret)return ret; - ret =isp_fwnodes_parse (&pdev->dev, &isp->notifier); + ret =v4l2_async_notifier_parse_fwnode_endpoints ( + &pdev->dev, &isp->notifier,sizeof (struct isp_async_subdev ), + isp_fwnode_parse);if (ret <0 )return ret;
@@ -2407,6 +2363,7 @@ static int isp_probe(struct platform_device *pdev)__omap3isp_put (isp, false); error:mutex_destroy (&isp->isp_mutex); +v4l2_async_notifier_release (&isp->notifier);return ret; }
drivers/media/platform/omap3isp/isp.h +1 -4
@@ -220,14 +220,11 @@ struct isp_device {unsigned int sbl_resources;unsigned int subclk_resources; - -#define ISP_MAX_SUBDEVS 8 -struct v4l2_subdev *subdevs[ISP_MAX_SUBDEVS ]; };struct isp_async_subdev { -struct isp_bus_cfg bus;struct v4l2_async_subdev asd; +struct isp_bus_cfg bus; };#define v4l2_subdev_to_bus_cfg (sd) \
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 11/26 v4l: async: Move async subdev notifier operations to a separate structure
In reply to a message not in the archiveFrom: Laurent Pinchart <laurent.pinchart-ryLnwIuWjnjg/[email protected]>
The async subdev notifier .bound(), .unbind() and .complete() operations are function pointers stored directly in the v4l2_async_subdev structure. As the structure isn't immutable, this creates a potential security risk as the function pointers are mutable.
To fix this, move the function pointers to a new v4l2_async_subdev_operations structure that can be made const in drivers.
--- drivers/media/platform/am437x/am437x-vpfe.c | 8 +++++-- drivers/media/platform/atmel/atmel-isc.c | 10 ++++++--- drivers/media/platform/atmel/atmel-isi.c | 10 ++++++--- drivers/media/platform/davinci/vpif_capture.c | 8 +++++-- drivers/media/platform/davinci/vpif_display.c | 8 +++++-- drivers/media/platform/exynos4-is/media-dev.c | 8 +++++-- drivers/media/platform/omap3isp/isp.c | 6 +++++- drivers/media/platform/pxa_camera.c | 8 +++++-- drivers/media/platform/qcom/camss-8x16/camss.c | 8 +++++-- drivers/media/platform/rcar-vin/rcar-core.c | 10 ++++++--- drivers/media/platform/rcar_drif.c | 10 ++++++--- drivers/media/platform/soc_camera/soc_camera.c | 14 +++++++------ drivers/media/platform/stm32/stm32-dcmi.c | 10 ++++++--- drivers/media/platform/ti-vpe/cal.c | 8 +++++-- drivers/media/platform/xilinx/xilinx-vipp.c | 8 +++++-- drivers/media/v4l2-core/v4l2-async.c | 20 +++++++++--------- drivers/staging/media/imx/imx-media-dev.c | 8 +++++-- include/media/v4l2-async.h | 29 +++++++++++++++++--------- 18 files changed, 131 insertions(+), 60 deletions(-)
drivers/media/platform/am437x/am437x-vpfe.c +6 -2
@@ -2417,6 +2417,11 @@ static int vpfe_async_complete(struct v4l2_async_notifier *notifier)return vpfe_probe_complete (vpfe); } +static const struct v4l2_async_notifier_operations vpfe_async_ops = { + .bound = vpfe_async_bound, + .complete = vpfe_async_complete, +}; +static struct vpfe_config *vpfe_get_pdata (struct platform_device *pdev) {
@@ -2590,8 +2595,7 @@ static int vpfe_probe(struct platform_device *pdev) vpfe->notifier.subdevs = vpfe->cfg->asd; vpfe->notifier.num_subdevs =ARRAY_SIZE (vpfe->cfg->asd); - vpfe->notifier.bound = vpfe_async_bound; - vpfe->notifier.complete = vpfe_async_complete; + vpfe->notifier.ops = &vpfe_async_ops; ret =v4l2_async_notifier_register (&vpfe->v4l2_dev, &vpfe->notifier);if (ret) {
drivers/media/platform/atmel/atmel-isc.c +7 -3
@@ -1639,6 +1639,12 @@ static int isc_async_complete(struct v4l2_async_notifier *notifier)return 0 ; } +static const struct v4l2_async_notifier_operations isc_async_ops = { + .bound = isc_async_bound, + .unbind = isc_async_unbind, + .complete = isc_async_complete, +}; +static void isc_subdev_cleanup (struct isc_device *isc) {struct isc_subdev_entity *subdev_entity;
@@ -1851,9 +1857,7 @@ static int atmel_isc_probe(struct platform_device *pdev)list_for_each_entry (subdev_entity, &isc->subdev_entities, list) { subdev_entity->notifier.subdevs = &subdev_entity->asd; subdev_entity->notifier.num_subdevs =1 ; - subdev_entity->notifier.bound = isc_async_bound; - subdev_entity->notifier.unbind = isc_async_unbind; - subdev_entity->notifier.complete = isc_async_complete; + subdev_entity->notifier.ops = &isc_async_ops; ret =v4l2_async_notifier_register (&isc->v4l2_dev, &subdev_entity->notifier);
drivers/media/platform/atmel/atmel-isi.c +7 -3
@@ -1105,6 +1105,12 @@ static int isi_graph_notify_bound(struct v4l2_async_notifier *notifier,return 0 ; } +static const struct v4l2_async_notifier_operations isi_graph_notify_ops = { + .bound = isi_graph_notify_bound, + .unbind = isi_graph_notify_unbind, + .complete = isi_graph_notify_complete, +}; +static int isi_graph_parse (struct atmel_isi *isi,struct device_node *node) {struct device_node *ep =NULL ;
@@ -1152,9 +1158,7 @@ static int isi_graph_init(struct atmel_isi *isi) isi->notifier.subdevs = subdevs; isi->notifier.num_subdevs =1 ; - isi->notifier.bound = isi_graph_notify_bound; - isi->notifier.unbind = isi_graph_notify_unbind; - isi->notifier.complete = isi_graph_notify_complete; + isi->notifier.ops = &isi_graph_notify_ops; ret =v4l2_async_notifier_register (&isi->v4l2_dev, &isi->notifier);if (ret <0 ) {
drivers/media/platform/davinci/vpif_capture.c +6 -2
@@ -1500,6 +1500,11 @@ static int vpif_async_complete(struct v4l2_async_notifier *notifier)return vpif_probe_complete (); } +static const struct v4l2_async_notifier_operations vpif_async_ops = { + .bound = vpif_async_bound, + .complete = vpif_async_complete, +}; +static struct vpif_capture_config *vpif_capture_get_pdata (struct platform_device *pdev) {
@@ -1691,8 +1696,7 @@ static __init int vpif_probe(struct platform_device *pdev) }else { vpif_obj.notifier.subdevs = vpif_obj.config->asd; vpif_obj.notifier.num_subdevs = vpif_obj.config->asd_sizes[0 ]; - vpif_obj.notifier.bound = vpif_async_bound; - vpif_obj.notifier.complete = vpif_async_complete; + vpif_obj.notifier.ops = &vpif_async_ops; err =v4l2_async_notifier_register (&vpif_obj.v4l2_dev, &vpif_obj.notifier);if (err) {
drivers/media/platform/davinci/vpif_display.c +6 -2
@@ -1232,6 +1232,11 @@ static int vpif_async_complete(struct v4l2_async_notifier *notifier)return vpif_probe_complete (); } +static const struct v4l2_async_notifier_operations vpif_async_ops = { + .bound = vpif_async_bound, + .complete = vpif_async_complete, +}; +/* * vpif_probe: This function creates device entries by register itself to the * V4L2 driver and initializes fields of each channel objects
@@ -1313,8 +1318,7 @@ static __init int vpif_probe(struct platform_device *pdev) }else { vpif_obj.notifier.subdevs = vpif_obj.config->asd; vpif_obj.notifier.num_subdevs = vpif_obj.config->asd_sizes[0 ]; - vpif_obj.notifier.bound = vpif_async_bound; - vpif_obj.notifier.complete = vpif_async_complete; + vpif_obj.notifier.ops = &vpif_async_ops; err =v4l2_async_notifier_register (&vpif_obj.v4l2_dev, &vpif_obj.notifier);if (err) {
drivers/media/platform/exynos4-is/media-dev.c +6 -2
@@ -1405,6 +1405,11 @@ static int subdev_notifier_complete(struct v4l2_async_notifier *notifier)return media_device_register (&fmd->media_dev); } +static const struct v4l2_async_notifier_operations subdev_notifier_ops = { + .bound = subdev_notifier_bound, + .complete = subdev_notifier_complete, +}; +static int fimc_md_probe (struct platform_device *pdev) {struct device *dev = &pdev->dev;
@@ -1479,8 +1484,7 @@ static int fimc_md_probe(struct platform_device *pdev)if (fmd->num_sensors >0 ) { fmd->subdev_notifier.subdevs = fmd->async_subdevs; fmd->subdev_notifier.num_subdevs = fmd->num_sensors; - fmd->subdev_notifier.bound = subdev_notifier_bound; - fmd->subdev_notifier.complete = subdev_notifier_complete; + fmd->subdev_notifier.ops = &subdev_notifier_ops; fmd->num_sensors =0 ; ret = v4l2_async_notifier_register(&fmd->v4l2_dev,
drivers/media/platform/omap3isp/isp.c +5 -1
@@ -2171,6 +2171,10 @@ static int isp_subdev_notifier_complete(struct v4l2_async_notifier *async)return media_device_register (&isp->media_dev); } +static const struct v4l2_async_notifier_operations isp_subdev_notifier_ops = { + .complete = isp_subdev_notifier_complete, +}; +/* * isp_probe - Probe ISP platform device * @pdev: Pointer to ISP platform device
@@ -2341,7 +2345,7 @@ static int isp_probe(struct platform_device *pdev)if (ret <0 ) goto error_register_entities; - isp->notifier.complete = isp_subdev_notifier_complete; + isp->notifier.ops = &isp_subdev_notifier_ops; ret =v4l2_async_notifier_register (&isp->v4l2_dev, &isp->notifier);if (ret)
drivers/media/platform/pxa_camera.c +6 -2
@@ -2221,6 +2221,11 @@ static void pxa_camera_sensor_unbind(struct v4l2_async_notifier *notifier,mutex_unlock (&pcdev->mlock); } +static const struct v4l2_async_notifier_operations pxa_camera_sensor_ops = { + .bound = pxa_camera_sensor_bound, + .unbind = pxa_camera_sensor_unbind, +}; +/* * Driver probe, remove, suspend and resume operations */
@@ -2489,8 +2494,7 @@ static int pxa_camera_probe(struct platform_device *pdev) pcdev->asds[0 ] = &pcdev->asd; pcdev->notifier.subdevs = pcdev->asds; pcdev->notifier.num_subdevs =1 ; - pcdev->notifier.bound = pxa_camera_sensor_bound; - pcdev->notifier.unbind = pxa_camera_sensor_unbind; + pcdev->notifier.ops = &pxa_camera_sensor_ops;if (!of_have_populated_dt ()) pcdev->asd.match_type =V4L2_ASYNC_MATCH_I2C ;
drivers/media/platform/qcom/camss-8x16/camss.c +6 -2
@@ -601,6 +601,11 @@ static int camss_subdev_notifier_complete(struct v4l2_async_notifier *async)return media_device_register (&camss->media_dev); } +static const struct v4l2_async_notifier_operations camss_subdev_notifier_ops = { + .bound = camss_subdev_notifier_bound, + .complete = camss_subdev_notifier_complete, +}; +static const struct media_device_ops camss_media_ops = { .link_notify = v4l2_pipeline_link_notify, };
@@ -655,8 +660,7 @@ static int camss_probe(struct platform_device *pdev) goto err_register_entities;if (camss->notifier.num_subdevs) { - camss->notifier.bound = camss_subdev_notifier_bound; - camss->notifier.complete = camss_subdev_notifier_complete; + camss->notifier.ops = &camss_subdev_notifier_ops; ret =v4l2_async_notifier_register (&camss->v4l2_dev, &camss->notifier);
drivers/media/platform/rcar-vin/rcar-core.c +7 -3
@@ -134,6 +134,12 @@ static int rvin_digital_notify_bound(struct v4l2_async_notifier *notifier,return 0 ; } +static const struct v4l2_async_notifier_operations rvin_digital_notify_ops = { + .bound = rvin_digital_notify_bound, + .unbind = rvin_digital_notify_unbind, + .complete = rvin_digital_notify_complete, +}; + static int rvin_digital_parse_v4l2(struct device *dev, struct v4l2_fwnode_endpoint *vep,
@@ -182,9 +188,7 @@ static int rvin_digital_graph_init(struct rvin_dev *vin)to_of_node ( vin->digital->asd.match.fwnode.fwnode)); - vin->notifier.bound = rvin_digital_notify_bound; - vin->notifier.unbind = rvin_digital_notify_unbind; - vin->notifier.complete = rvin_digital_notify_complete; + vin->notifier.ops = &rvin_digital_notify_ops; ret =v4l2_async_notifier_register (&vin->v4l2_dev, &vin->notifier);if (ret <0 ) {vin_err (vin,"Notifier registration failed\n" );
drivers/media/platform/rcar_drif.c +7 -3
@@ -1185,6 +1185,12 @@ static int rcar_drif_notify_complete(struct v4l2_async_notifier *notifier)return ret; } +static const struct v4l2_async_notifier_operations rcar_drif_notify_ops = { + .bound = rcar_drif_notify_bound, + .unbind = rcar_drif_notify_unbind, + .complete = rcar_drif_notify_complete, +}; +/* Read endpoint properties */ static void rcar_drif_get_ep_properties (struct rcar_drif_sdr *sdr,struct fwnode_handle *fwnode)
@@ -1347,9 +1353,7 @@ static int rcar_drif_sdr_probe(struct rcar_drif_sdr *sdr)if (ret) goto error; - sdr->notifier.bound = rcar_drif_notify_bound; - sdr->notifier.unbind = rcar_drif_notify_unbind; - sdr->notifier.complete = rcar_drif_notify_complete; + sdr->notifier.ops = &rcar_drif_notify_ops;/* Register notifier */ ret =v4l2_async_notifier_register (&sdr->v4l2_dev, &sdr->notifier);
drivers/media/platform/soc_camera/soc_camera.c +8 -6
@@ -1391,6 +1391,12 @@ static int soc_camera_async_complete(struct v4l2_async_notifier *notifier)return 0 ; } +static const struct v4l2_async_notifier_operations soc_camera_async_ops = { + .bound = soc_camera_async_bound, + .unbind = soc_camera_async_unbind, + .complete = soc_camera_async_complete, +}; +static int scan_async_group (struct soc_camera_host *ici,struct v4l2_async_subdev **asd,unsigned int size) {
@@ -1437,9 +1443,7 @@ static int scan_async_group(struct soc_camera_host *ici, sasc->notifier.subdevs = asd; sasc->notifier.num_subdevs = size; - sasc->notifier.bound = soc_camera_async_bound; - sasc->notifier.unbind = soc_camera_async_unbind; - sasc->notifier.complete = soc_camera_async_complete; + sasc->notifier.ops = &soc_camera_async_ops; icd->sasc = sasc; icd->parent = ici->v4l2_dev.dev;
@@ -1537,9 +1541,7 @@ static int soc_of_bind(struct soc_camera_host *ici, sasc->notifier.subdevs = &info->subdev; sasc->notifier.num_subdevs =1 ; - sasc->notifier.bound = soc_camera_async_bound; - sasc->notifier.unbind = soc_camera_async_unbind; - sasc->notifier.complete = soc_camera_async_complete; + sasc->notifier.ops = &soc_camera_async_ops; icd->sasc = sasc; icd->parent = ici->v4l2_dev.dev;
drivers/media/platform/stm32/stm32-dcmi.c +7 -3
@@ -1495,6 +1495,12 @@ static int dcmi_graph_notify_bound(struct v4l2_async_notifier *notifier,return 0 ; } +static const struct v4l2_async_notifier_operations dcmi_graph_notify_ops = { + .bound = dcmi_graph_notify_bound, + .unbind = dcmi_graph_notify_unbind, + .complete = dcmi_graph_notify_complete, +}; +static int dcmi_graph_parse (struct stm32_dcmi *dcmi,struct device_node *node) {struct device_node *ep =NULL ;
@@ -1542,9 +1548,7 @@ static int dcmi_graph_init(struct stm32_dcmi *dcmi) dcmi->notifier.subdevs = subdevs; dcmi->notifier.num_subdevs =1 ; - dcmi->notifier.bound = dcmi_graph_notify_bound; - dcmi->notifier.unbind = dcmi_graph_notify_unbind; - dcmi->notifier.complete = dcmi_graph_notify_complete; + dcmi->notifier.ops = &dcmi_graph_notify_ops; ret =v4l2_async_notifier_register (&dcmi->v4l2_dev, &dcmi->notifier);if (ret <0 ) {
drivers/media/platform/ti-vpe/cal.c +6 -2
@@ -1522,6 +1522,11 @@ static int cal_async_complete(struct v4l2_async_notifier *notifier)return 0 ; } +static const struct v4l2_async_notifier_operations cal_async_ops = { + .bound = cal_async_bound, + .complete = cal_async_complete, +}; +static int cal_complete_ctx (struct cal_ctx *ctx) {struct video_device *vfd;
@@ -1736,8 +1741,7 @@ static int of_cal_create_instance(struct cal_ctx *ctx, int inst) ctx->asd_list[0 ] = asd; ctx->notifier.subdevs = ctx->asd_list; ctx->notifier.num_subdevs =1 ; - ctx->notifier.bound = cal_async_bound; - ctx->notifier.complete = cal_async_complete; + ctx->notifier.ops = &cal_async_ops; ret =v4l2_async_notifier_register (&ctx->v4l2_dev, &ctx->notifier);if (ret) {
drivers/media/platform/xilinx/xilinx-vipp.c +6 -2
@@ -351,6 +351,11 @@ static int xvip_graph_notify_bound(struct v4l2_async_notifier *notifier,return -EINVAL ; } +static const struct v4l2_async_notifier_operations xvip_graph_notify_ops = { + .bound = xvip_graph_notify_bound, + .complete = xvip_graph_notify_complete, +}; +static int xvip_graph_parse_one (struct xvip_composite_device *xdev,struct device_node *node) {
@@ -548,8 +553,7 @@ static int xvip_graph_init(struct xvip_composite_device *xdev) xdev->notifier.subdevs = subdevs; xdev->notifier.num_subdevs = num_subdevs; - xdev->notifier.bound = xvip_graph_notify_bound; - xdev->notifier.complete = xvip_graph_notify_complete; + xdev->notifier.ops = &xvip_graph_notify_ops; ret =v4l2_async_notifier_register (&xdev->v4l2_dev, &xdev->notifier);if (ret <0 ) {
drivers/media/v4l2-core/v4l2-async.c +10 -10
@@ -102,16 +102,16 @@ static int v4l2_async_match_notify(struct v4l2_async_notifier *notifier, {int ret; -if (notifier->bound) { - ret = notifier->bound (notifier, sd, asd); +if (notifier->ops->bound) { + ret = notifier->ops->bound (notifier, sd, asd);if (ret <0 )return ret; } ret =v4l2_device_register_subdev (notifier->v4l2_dev, sd);if (ret <0 ) { -if (notifier->unbind) - notifier->unbind (notifier, sd, asd); +if (notifier->ops->unbind) + notifier->ops->unbind (notifier, sd, asd);return ret; }
@@ -123,8 +123,8 @@ static int v4l2_async_match_notify(struct v4l2_async_notifier *notifier,/* Move from the global subdevice list to notifier's done */ list_move (&sd->async_list, ¬ifier->done); -if (list_empty (¬ifier->waiting) && notifier->complete) -return notifier->complete (notifier); +if (list_empty (¬ifier->waiting) && notifier->ops->complete) +return notifier->ops->complete (notifier);return 0 ; }
@@ -210,8 +210,8 @@ void v4l2_async_notifier_unregister(struct v4l2_async_notifier *notifier)list_for_each_entry_safe (sd, tmp, ¬ifier->done, async_list) {v4l2_async_cleanup (sd); -if (notifier->unbind) - notifier->unbind (notifier, sd, sd->asd); +if (notifier->ops->unbind) + notifier->ops->unbind (notifier, sd, sd->asd); }mutex_unlock (&list_lock);
@@ -300,8 +300,8 @@ void v4l2_async_unregister_subdev(struct v4l2_subdev *sd)v4l2_async_cleanup (sd); -if (notifier->unbind) - notifier->unbind (notifier, sd, sd->asd); +if (notifier->ops->unbind) + notifier->ops->unbind (notifier, sd, sd->asd);mutex_unlock (&list_lock); }
drivers/staging/media/imx/imx-media-dev.c +6 -2
@@ -440,6 +440,11 @@ static int imx_media_probe_complete(struct v4l2_async_notifier *notifier)return media_device_register (&imxmd->md); } +static const struct v4l2_async_notifier_operations imx_media_subdev_ops = { + .bound = imx_media_subdev_bound, + .complete = imx_media_probe_complete, +}; +/* * adds controls to a video device from an entity subdevice. * Continues upstream from the entity's sink pads.
@@ -608,8 +613,7 @@ static int imx_media_probe(struct platform_device *pdev)/* prepare the async subdev notifier and register it */ imxmd->subdev_notifier.subdevs = imxmd->async_ptrs; - imxmd->subdev_notifier.bound = imx_media_subdev_bound; - imxmd->subdev_notifier.complete = imx_media_probe_complete; + imxmd->subdev_notifier.ops = &imx_media_subdev_ops; ret =v4l2_async_notifier_register (&imxmd->v4l2_dev, &imxmd->subdev_notifier);if (ret) {
include/media/v4l2-async.h +19 -10
@@ -18,6 +18,7 @@ struct device;struct device_node ;struct v4l2_device ;struct v4l2_subdev ; +struct v4l2_async_notifier ;/* A random max subdevice number, used to allocate an array on stack */ #define V4L2_MAX_SUBDEVS 128U
@@ -79,8 +80,25 @@ struct v4l2_async_subdev { };/** +* struct v4l2_async_notifier_operations - Asynchronous V4L2 notifier operations +* @bound: a subdevice driver has successfully probed one of the subdevices +* @complete: all subdevices have been probed successfully +* @unbind: a subdevice is leaving +*/ +struct v4l2_async_notifier_operations { +int (*bound)(struct v4l2_async_notifier *notifier, +struct v4l2_subdev *subdev, +struct v4l2_async_subdev *asd); +int (*complete)(struct v4l2_async_notifier *notifier); +void (*unbind)(struct v4l2_async_notifier *notifier, +struct v4l2_subdev *subdev, +struct v4l2_async_subdev *asd); +}; + +/** * struct v4l2_async_notifier - v4l2_device notifier data * +* @ops: notifier operations * @num_subdevs: number of subdevices used in the subdevs array * @max_subdevs: number of subdevices allocated in the subdevs array * @subdevs: array of pointers to subdevice descriptors
@@ -88,11 +106,9 @@ struct v4l2_async_subdev {* @waiting: list of struct v4l2_async_subdev, waiting for their drivers * @done: list of struct v4l2_subdev, already probed * @list: member in a global list of notifiers -* @bound: a subdevice driver has successfully probed one of subdevices -* @complete: all subdevices have been probed successfully -* @unbind: a subdevice is leaving */ struct v4l2_async_notifier { +const struct v4l2_async_notifier_operations *ops;unsigned int num_subdevs;unsigned int max_subdevs;struct v4l2_async_subdev **subdevs;
@@ -100,13 +116,6 @@ struct v4l2_async_notifier {struct list_head waiting;struct list_head done;struct list_head list; -int (*bound)(struct v4l2_async_notifier *notifier, -struct v4l2_subdev *subdev, -struct v4l2_async_subdev *asd); -int (*complete)(struct v4l2_async_notifier *notifier); -void (*unbind)(struct v4l2_async_notifier *notifier, -struct v4l2_subdev *subdev, -struct v4l2_async_subdev *asd); };/**
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 13/26 v4l: async: Register sub-devices before calling bound callback
In reply to a message not in the archiveRegister the sub-device before calling the notifier's bound callback. Doing this the other way around is problematic as the struct v4l2_device has not assigned for the sub-device yet and may be required by the bound callback.
--- drivers/media/v4l2-core/v4l2-async.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)
drivers/media/v4l2-core/v4l2-async.c +3 -3
@@ -130,13 +130,13 @@ static int v4l2_async_match_notify(struct v4l2_async_notifier *notifier, {int ret; - ret =v4l2_async_notifier_call_bound (notifier, sd, asd); + ret =v4l2_device_register_subdev (notifier->v4l2_dev, sd);if (ret <0 )return ret; - ret =v4l2_device_register_subdev (notifier->v4l2_dev, sd); + ret =v4l2_async_notifier_call_bound (notifier, sd, asd);if (ret <0 ) { -v4l2_async_notifier_call_unbind (notifier, sd, asd); +v4l2_device_unregister_subdev (sd);return ret; }
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 16/26 dt: bindings: Add a binding for flash LED devices associated to a sensor
In reply to a message not in the archiveCamera flash drivers (and LEDs) are separate from the sensor devices in DT. In order to make an association between the two, provide the association information to the software.
--- Documentation/devicetree/bindings/media/video-interfaces.txt | 8 ++++++++ 1 file changed, 8 insertions(+)
Documentation/devicetree/bindings/media/video-interfaces.txt +8 -0
@@ -67,6 +67,14 @@ are required in a relevant parent node: identifier, should be 1. - #size-cells : should be zero. + +Optional properties +------------------- + +- flash-leds: An array of phandles, each referring to a flash LED, a sub-node + of the LED driver device node. + + Optional endpoint properties ----------------------------
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 17/26 dt: bindings: Add lens-focus binding for image sensors
In reply to a message not in the archiveThe lens-focus property contains a phandle to the lens voice coil driver that is associated to the sensor; typically both are contained in the same camera module.
--- Documentation/devicetree/bindings/media/video-interfaces.txt | 2 ++ 1 file changed, 2 insertions(+)
Documentation/devicetree/bindings/media/video-interfaces.txt +2 -0
@@ -74,6 +74,8 @@ Optional properties - flash-leds: An array of phandles, each referring to a flash LED, a sub-node of the LED driver device node. +- lens-focus: A phandle to the node of the focus lens controller. + Optional endpoint properties ----------------------------
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 18/26 v4l: fwnode: Add a helper function for parsing generic references
In reply to a message not in the archiveAdd function v4l2_fwnode_reference_count() for counting external references and v4l2_fwnode_reference_parse() for parsing them as async sub-devices.
This can be done on e.g. flash or lens async sub-devices that are not part of but are associated with a sensor.
struct v4l2_async_notifier.max_subdevs field is added to contain the maximum number of sub-devices in a notifier to reflect the memory allocated for the subdevs array.
--- drivers/media/v4l2-core/v4l2-fwnode.c | 69 +++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+)
drivers/media/v4l2-core/v4l2-fwnode.c +69 -0
@@ -498,6 +498,75 @@ int v4l2_async_notifier_parse_fwnode_endpoints_by_port( }EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +/* +* v4l2_fwnode_reference_parse - parse references for async sub-devices +* @dev: the device node the properties of which are parsed for references +* @notifier: the async notifier where the async subdevs will be added +* @prop: the name of the property +* +* Return: 0 on success +* -ENOENT if no entries were found +* -ENOMEM if memory allocation failed +* -EINVAL if property parsing failed +*/ +static int v4l2_fwnode_reference_parse ( +struct device *dev,struct v4l2_async_notifier *notifier, +const char *prop) +{ +struct fwnode_reference_args args; +unsigned int index; +int ret; + +for (index =0 ; + !(ret =fwnode_property_get_reference_args ( +dev_fwnode (dev), prop,NULL ,0 , index, &args)); + index++) +fwnode_handle_put (args.fwnode); + +if (!index) +return -ENOENT ; + +/* +* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ +if (ret != -ENOENT && ret != -ENODATA ) +return ret; + + ret =v4l2_async_notifier_realloc (notifier, + notifier->num_subdevs + index); +if (ret) +return ret; + +for (index =0 ; !fwnode_property_get_reference_args ( +dev_fwnode (dev), prop,NULL ,0 , index, &args); + index++) { +struct v4l2_async_subdev *asd; + +if (WARN_ON (notifier->num_subdevs >= notifier->max_subdevs)) { + ret = -EINVAL ; + goto error; + } + + asd =kzalloc (sizeof (*asd),GFP_KERNEL ); +if (!asd) { + ret = -ENOMEM ; + goto error; + } + + notifier->subdevs[notifier->num_subdevs] = asd; + asd->match.fwnode.fwnode = args.fwnode; + asd->match_type =V4L2_ASYNC_MATCH_FWNODE ; + notifier->num_subdevs++; + } + +return 0 ; + +error: +fwnode_handle_put (args.fwnode); +return ret; +} +MODULE_LICENSE ("GPL" );MODULE_AUTHOR ("Sakari Ailus <sakari.ailus-VuQAYsv1563Yd54FQh9/[email protected]>" );MODULE_AUTHOR ("Sylwester Nawrocki <[email protected]>" );
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): 20170912134200.19556-19-sakari.ailus-VuQAYsv1563Yd54FQh9/[email protected]
Re: [PATCH v12 18/26] v4l: fwnode: Add a helper function for parsing generic references
Quoted 1 line · Sakari Ailus
Add function
v4l2_fwnode_reference_count()for counting external
???? There is no function v4l2_fwnode_reference_count()?!
Quoted 9 lines
references and
v4l2_fwnode_reference_parse()for parsing them as async sub-devices.This can be done on e.g. flash or lens async sub-devices that are not part of but are associated with a sensor.
struct v4l2_async_notifier.max_subdevs field is added to contain the maximum number of sub-devices in a notifier to reflect the memory allocated for the subdevs array.
You forgot to remove this outdated paragraph.
Quoted 37 lines
--- drivers/media/v4l2-core/v4l2-fwnode.c | 69 +++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+)drivers/media/v4l2-core/v4l2-fwnode.c +23
-0@@ -498,6 +498,75 @@ int v4l2_async_notifier_parse_fwnode_endpoints_by_port( }EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +/* +* v4l2_fwnode_reference_parse - parse references for async sub-devices +* @dev: the device node the properties of which are parsed for references +* @notifier: the async notifier where the async subdevs will be added +* @prop: the name of the property +* +* Return: 0 on success +* -ENOENT if no entries were found +* -ENOMEM if memory allocation failed +* -EINVAL if property parsing failed +*/ +static int v4l2_fwnode_reference_parse ( +struct device *dev,struct v4l2_async_notifier *notifier, +const char *prop) +{ +struct fwnode_reference_args args; +unsigned int index; +int ret; + +for (index =0 ; + !(ret =fwnode_property_get_reference_args ( +dev_fwnode (dev), prop,NULL ,0 , index, &args)); + index++)
drivers/media/v4l2-core/v4l2-fwnode.c int v4l2_async_notifier_parse_fwnode_endpoints_by_port( · line 533
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +10
-0+fwnode_handle_put (args.fwnode); + +if (!index) +return -ENOENT ; + +/* +* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ +if (ret != -ENOENT && ret != -ENODATA )
So while that patch referenced in the To-do above is not merged yet, what does fwnode_property_get_reference_args return? ENOENT or ENODATA? Or ENOENT now and ENODATA later? Or vice versa?
I can't tell based on that information whether this code is correct or not.
The comment needs to explain this a bit better.
Quoted 30 lines
drivers/media/v4l2-core/v4l2-fwnode.c +29
-0+return ret; + + ret =v4l2_async_notifier_realloc (notifier, + notifier->num_subdevs + index); +if (ret) +return ret; + +for (index =0 ; !fwnode_property_get_reference_args ( +dev_fwnode (dev), prop,NULL ,0 , index, &args); + index++) { +struct v4l2_async_subdev *asd; + +if (WARN_ON (notifier->num_subdevs >= notifier->max_subdevs)) { + ret = -EINVAL ; + goto error; + } + + asd =kzalloc (sizeof (*asd),GFP_KERNEL ); +if (!asd) { + ret = -ENOMEM ; + goto error; + } + + notifier->subdevs[notifier->num_subdevs] = asd; + asd->match.fwnode.fwnode = args.fwnode; + asd->match_type =V4L2_ASYNC_MATCH_FWNODE ; + notifier->num_subdevs++; + } +
drivers/media/v4l2-core/v4l2-fwnode.c int v4l2_async_notifier_parse_fwnode_endpoints_by_port( · line 572
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +7
-0+return 0 ; + +error: +fwnode_handle_put (args.fwnode); +return ret; +} +MODULE_LICENSE ("GPL" );MODULE_AUTHOR ("Sakari Ailus <sakari.ailus-VuQAYsv1563Yd54FQh9/[email protected]>" );MODULE_AUTHOR ("Sylwester Nawrocki <[email protected]>" );
Regards,
Hans
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): 020b9c86-dd73-3516-4a0e-827db9680b55-qWit8jRvyhVmR6Xm/[email protected]
Re: [PATCH v12 18/26] v4l: fwnode: Add a helper function for parsing generic references
Hi Hans,
Thanks for the review!
Quoted 4 lines · Hans Verkuil
Quoted 1 line · Sakari Ailus
Add function
v4l2_fwnode_reference_count()for counting external???? There is no function
v4l2_fwnode_reference_count()?!
It got removed during the revisions but the commit message was not changed accordingly, I do that now.
Quoted 4 lines
Quoted 4 lines
references and
v4l2_fwnode_reference_parse()for parsing them as async sub-devices.
Quoted 8 lines
Quoted 6 lines
This can be done on e.g. flash or lens async sub-devices that are not part of but are associated with a sensor.
struct v4l2_async_notifier.max_subdevs field is added to contain the maximum number of sub-devices in a notifier to reflect the memory allocated for the subdevs array.
You forgot to remove this outdated paragraph.
Oops. Removed it now.
Quoted 53 lines
Quoted 38 lines
--- drivers/media/v4l2-core/v4l2-fwnode.c | 69 +++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+)drivers/media/v4l2-core/v4l2-fwnode.c +23
-0@@ -498,6 +498,75 @@ int v4l2_async_notifier_parse_fwnode_endpoints_by_port( }EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +/* +* v4l2_fwnode_reference_parse - parse references for async sub-devices +* @dev: the device node the properties of which are parsed for references +* @notifier: the async notifier where the async subdevs will be added +* @prop: the name of the property +* +* Return: 0 on success +* -ENOENT if no entries were found +* -ENOMEM if memory allocation failed +* -EINVAL if property parsing failed +*/ +static int v4l2_fwnode_reference_parse ( +struct device *dev,struct v4l2_async_notifier *notifier, +const char *prop) +{ +struct fwnode_reference_args args; +unsigned int index; +int ret; + +for (index =0 ; + !(ret =fwnode_property_get_reference_args ( +dev_fwnode (dev), prop,NULL ,0 , index, &args)); + index++)drivers/media/v4l2-core/v4l2-fwnode.c int v4l2_async_notifier_parse_fwnode_endpoints_by_port( · line 533
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +10
-0+fwnode_handle_put (args.fwnode); + +if (!index) +return -ENOENT ; + +/* +* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ +if (ret != -ENOENT && ret != -ENODATA )So while that patch referenced in the To-do above is not merged yet, what does
fwnode_property_get_reference_argsreturn? ENOENT or ENODATA? Or ENOENT now and ENODATA later? Or vice versa?
Quoted 3 lines
I can't tell based on that information whether this code is correct or not.
The comment needs to explain this a bit better.
I'll add this:
drivers/media/v4l2-core/v4l2-fwnode.c +3 -0
@@ -529,6 +529,9 @@ static int v4l2_fwnode_reference_parse(/* * To-do: handle -ENODATA when "device property: Align return * codes of acpi_fwnode_get_reference_with_args" is merged. +* Right now, both -ENODATA and -ENOENT signal the end of +* references where only a single error code should be used +* for the purpose. */ if (ret != -ENOENT && ret != -ENODATA )return ret;
Signature · 8 lines
Regards, Sakari Ailus e-mail: [email protected] -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): 20170913092430.cbdgerkhiuxakbxv-S+BSfZ9RZZmRSg0ZkenSGLdO1Tsj/[email protected]
Re: [PATCH v12 18/26] v4l: fwnode: Add a helper function for parsing generic references
Quoted 92 lines · Sakari Ailus
Hi Hans,
Thanks for the review!
Quoted 4 lines · Hans Verkuil
Quoted 1 line · Sakari Ailus
Add function
v4l2_fwnode_reference_count()for counting external???? There is no function
v4l2_fwnode_reference_count()?!It got removed during the revisions but the commit message was not changed accordingly, I do that now.
Quoted 4 lines
Quoted 4 lines
references and
v4l2_fwnode_reference_parse()for parsing them as async sub-devices.Quoted 8 lines
Quoted 6 lines
This can be done on e.g. flash or lens async sub-devices that are not part of but are associated with a sensor.
struct v4l2_async_notifier.max_subdevs field is added to contain the maximum number of sub-devices in a notifier to reflect the memory allocated for the subdevs array.
You forgot to remove this outdated paragraph.
Oops. Removed it now.
Quoted 53 lines
Quoted 38 lines
--- drivers/media/v4l2-core/v4l2-fwnode.c | 69 +++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+)drivers/media/v4l2-core/v4l2-fwnode.c +23
-0@@ -498,6 +498,75 @@ int v4l2_async_notifier_parse_fwnode_endpoints_by_port( }EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +/* +* v4l2_fwnode_reference_parse - parse references for async sub-devices +* @dev: the device node the properties of which are parsed for references +* @notifier: the async notifier where the async subdevs will be added +* @prop: the name of the property +* +* Return: 0 on success +* -ENOENT if no entries were found +* -ENOMEM if memory allocation failed +* -EINVAL if property parsing failed +*/ +static int v4l2_fwnode_reference_parse ( +struct device *dev,struct v4l2_async_notifier *notifier, +const char *prop) +{ +struct fwnode_reference_args args; +unsigned int index; +int ret; + +for (index =0 ; + !(ret =fwnode_property_get_reference_args ( +dev_fwnode (dev), prop,NULL ,0 , index, &args)); + index++)drivers/media/v4l2-core/v4l2-fwnode.c int v4l2_async_notifier_parse_fwnode_endpoints_by_port( · line 533
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +10
-0+fwnode_handle_put (args.fwnode); + +if (!index) +return -ENOENT ; + +/* +* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ +if (ret != -ENOENT && ret != -ENODATA )So while that patch referenced in the To-do above is not merged yet, what does
fwnode_property_get_reference_argsreturn? ENOENT or ENODATA? Or ENOENT now and ENODATA later? Or vice versa?Quoted 3 lines
I can't tell based on that information whether this code is correct or not.
The comment needs to explain this a bit better.
I'll add this:
drivers/media/v4l2-core/v4l2-fwnode.c +0
-0
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 531
Quoted 3 lines
drivers/media/v4l2-core/v4l2-fwnode.c +0
-0@@ -529,6 +529,9 @@ static int v4l2_fwnode_reference_parse(/* * To-do: handle -ENODATA when "device property: Align return * codes of acpi_fwnode_get_reference_with_args" is merged.
So after this patch referred to in the To-do is applied it will only return ENODATA?
In that case, change 'handle' to 'handle only'.
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 537
Quoted 7 lines
drivers/media/v4l2-core/v4l2-fwnode.c +3
-0+* Right now, both -ENODATA and -ENOENT signal the end of +* references where only a single error code should be used +* for the purpose. */ if (ret != -ENOENT && ret != -ENODATA )return ret;
Regards,
Hans
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
Sakari Ailus
maintainerRe: [PATCH v12 18/26] v4l: fwnode: Add a helper function for parsing generic references
Hi Hans,
Quoted 100 lines · Hans Verkuil
Quoted 92 lines · Sakari Ailus
Hi Hans,
Thanks for the review!
Quoted 4 lines · Hans Verkuil
Quoted 1 line · Sakari Ailus
Add function
v4l2_fwnode_reference_count()for counting external???? There is no function
v4l2_fwnode_reference_count()?!It got removed during the revisions but the commit message was not changed accordingly, I do that now.
Quoted 4 lines
Quoted 4 lines
references and
v4l2_fwnode_reference_parse()for parsing them as async sub-devices.Quoted 8 lines
Quoted 6 lines
This can be done on e.g. flash or lens async sub-devices that are not part of but are associated with a sensor.
struct v4l2_async_notifier.max_subdevs field is added to contain the maximum number of sub-devices in a notifier to reflect the memory allocated for the subdevs array.
You forgot to remove this outdated paragraph.
Oops. Removed it now.
Quoted 53 lines
Quoted 38 lines
Signed-off-by Sakari Ailus <[email protected]>--- drivers/media/v4l2-core/v4l2-fwnode.c | 69 +++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+)drivers/media/v4l2-core/v4l2-fwnode.c +23
-0@@ -498,6 +498,75 @@ int v4l2_async_notifier_parse_fwnode_endpoints_by_port( }EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +/* +* v4l2_fwnode_reference_parse - parse references for async sub-devices +* @dev: the device node the properties of which are parsed for references +* @notifier: the async notifier where the async subdevs will be added +* @prop: the name of the property +* +* Return: 0 on success +* -ENOENT if no entries were found +* -ENOMEM if memory allocation failed +* -EINVAL if property parsing failed +*/ +static int v4l2_fwnode_reference_parse ( +struct device *dev,struct v4l2_async_notifier *notifier, +const char *prop) +{ +struct fwnode_reference_args args; +unsigned int index; +int ret; + +for (index =0 ; + !(ret =fwnode_property_get_reference_args ( +dev_fwnode (dev), prop,NULL ,0 , index, &args)); + index++)drivers/media/v4l2-core/v4l2-fwnode.c int v4l2_async_notifier_parse_fwnode_endpoints_by_port( · line 533
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +10
-0+fwnode_handle_put (args.fwnode); + +if (!index) +return -ENOENT ; + +/* +* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ +if (ret != -ENOENT && ret != -ENODATA )So while that patch referenced in the To-do above is not merged yet, what does
fwnode_property_get_reference_argsreturn? ENOENT or ENODATA? Or ENOENT now and ENODATA later? Or vice versa?Quoted 3 lines
I can't tell based on that information whether this code is correct or not.
The comment needs to explain this a bit better.
I'll add this:
drivers/media/v4l2-core/v4l2-fwnode.c +0
-0drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 531
Quoted 3 lines
drivers/media/v4l2-core/v4l2-fwnode.c +0
-0@@ -529,6 +529,9 @@ static int v4l2_fwnode_reference_parse(/* * To-do: handle -ENODATA when "device property: Align return * codes of acpi_fwnode_get_reference_with_args" is merged. So after this patch referred to in the To-do is applied it will only return ENODATA?
Quoted 1 line
In that case, change 'handle' to 'handle only'.
That depends a bit in which form the patch will be eventually accepted. The underlying issue there is that different error codes are used to signal conditions for out-of-bounds access and missing entry. After aligning them the code here can be updated.
Quoted 8 lines
Quoted 8 lines
drivers/media/v4l2-core/v4l2-fwnode.c +3
-0+* Right now, both -ENODATA and -ENOENT signal the end of +* references where only a single error code should be used +* for the purpose. */ if (ret != -ENOENT && ret != -ENODATA )return ret;
Signature · 2 lines
Sakari Ailus e-mail: [email protected]
Re: [PATCH v12 18/26] v4l: fwnode: Add a helper function for parsing generic references
Quoted 103 lines · Sakari Ailus
Hi Hans,
Quoted 100 lines · Hans Verkuil
Quoted 92 lines · Sakari Ailus
Hi Hans,
Thanks for the review!
Quoted 4 lines · Hans Verkuil
Quoted 1 line · Sakari Ailus
Add function
v4l2_fwnode_reference_count()for counting external???? There is no function
v4l2_fwnode_reference_count()?!It got removed during the revisions but the commit message was not changed accordingly, I do that now.
Quoted 4 lines
Quoted 4 lines
references and
v4l2_fwnode_reference_parse()for parsing them as async sub-devices.Quoted 8 lines
Quoted 6 lines
This can be done on e.g. flash or lens async sub-devices that are not part of but are associated with a sensor.
struct v4l2_async_notifier.max_subdevs field is added to contain the maximum number of sub-devices in a notifier to reflect the memory allocated for the subdevs array.
You forgot to remove this outdated paragraph.
Oops. Removed it now.
Quoted 53 lines
Quoted 38 lines
Signed-off-by Sakari Ailus <[email protected]>--- drivers/media/v4l2-core/v4l2-fwnode.c | 69 +++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+)drivers/media/v4l2-core/v4l2-fwnode.c +23
-0@@ -498,6 +498,75 @@ int v4l2_async_notifier_parse_fwnode_endpoints_by_port( }EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +/* +* v4l2_fwnode_reference_parse - parse references for async sub-devices +* @dev: the device node the properties of which are parsed for references +* @notifier: the async notifier where the async subdevs will be added +* @prop: the name of the property +* +* Return: 0 on success +* -ENOENT if no entries were found +* -ENOMEM if memory allocation failed +* -EINVAL if property parsing failed +*/ +static int v4l2_fwnode_reference_parse ( +struct device *dev,struct v4l2_async_notifier *notifier, +const char *prop) +{ +struct fwnode_reference_args args; +unsigned int index; +int ret; + +for (index =0 ; + !(ret =fwnode_property_get_reference_args ( +dev_fwnode (dev), prop,NULL ,0 , index, &args)); + index++)drivers/media/v4l2-core/v4l2-fwnode.c int v4l2_async_notifier_parse_fwnode_endpoints_by_port( · line 533
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +10
-0+fwnode_handle_put (args.fwnode); + +if (!index) +return -ENOENT ; + +/* +* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ +if (ret != -ENOENT && ret != -ENODATA )So while that patch referenced in the To-do above is not merged yet, what does
fwnode_property_get_reference_argsreturn? ENOENT or ENODATA? Or ENOENT now and ENODATA later? Or vice versa?Quoted 3 lines
I can't tell based on that information whether this code is correct or not.
The comment needs to explain this a bit better.
I'll add this:
drivers/media/v4l2-core/v4l2-fwnode.c +0
-0drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 531
Quoted 3 lines
drivers/media/v4l2-core/v4l2-fwnode.c +0
-0@@ -529,6 +529,9 @@ static int v4l2_fwnode_reference_parse(/* * To-do: handle -ENODATA when "device property: Align return * codes of acpi_fwnode_get_reference_with_args" is merged. So after this patch referred to in the To-do is applied it will only return ENODATA?
Quoted 6 lines
Quoted 1 line
In that case, change 'handle' to 'handle only'.
That depends a bit in which form the patch will be eventually accepted. The underlying issue there is that different error codes are used to signal conditions for out-of-bounds access and missing entry. After aligning them the code here can be updated.
Ah. In that case I'd drop the 'To-do' sentence.
Quoted 5 lines
Quoted 5 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 534
Quoted 5 lines
drivers/media/v4l2-core/v4l2-fwnode.c +3
-0+* Right now, both -ENODATA and -ENOENT signal the end of +* references where only a single error code should be used +* for the purpose.
And add something like: "This might change in the future, in which case this code should be updated."
Quoted 5 lines
Quoted 4 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 537
Quoted 4 lines
drivers/media/v4l2-core/v4l2-fwnode.c +0
-0*/ if (ret != -ENOENT && ret != -ENODATA )return ret;
Regards,
Hans
Sakari Ailus
maintainerRe: [PATCH v12 18/26] v4l: fwnode: Add a helper function for parsing generic references
Hi Hans,
Quoted 115 lines · Hans Verkuil
Quoted 103 lines · Sakari Ailus
Hi Hans,
Quoted 100 lines · Hans Verkuil
Quoted 92 lines · Sakari Ailus
Hi Hans,
Thanks for the review!
Quoted 4 lines · Hans Verkuil
Quoted 1 line · Sakari Ailus
Add function
v4l2_fwnode_reference_count()for counting external???? There is no function
v4l2_fwnode_reference_count()?!It got removed during the revisions but the commit message was not changed accordingly, I do that now.
Quoted 4 lines
Quoted 4 lines
references and
v4l2_fwnode_reference_parse()for parsing them as async sub-devices.Quoted 8 lines
Quoted 6 lines
This can be done on e.g. flash or lens async sub-devices that are not part of but are associated with a sensor.
struct v4l2_async_notifier.max_subdevs field is added to contain the maximum number of sub-devices in a notifier to reflect the memory allocated for the subdevs array.
You forgot to remove this outdated paragraph.
Oops. Removed it now.
Quoted 53 lines
Quoted 38 lines
Signed-off-by Sakari Ailus <[email protected]>--- drivers/media/v4l2-core/v4l2-fwnode.c | 69 +++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+)drivers/media/v4l2-core/v4l2-fwnode.c +23
-0@@ -498,6 +498,75 @@ int v4l2_async_notifier_parse_fwnode_endpoints_by_port( }EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +/* +* v4l2_fwnode_reference_parse - parse references for async sub-devices +* @dev: the device node the properties of which are parsed for references +* @notifier: the async notifier where the async subdevs will be added +* @prop: the name of the property +* +* Return: 0 on success +* -ENOENT if no entries were found +* -ENOMEM if memory allocation failed +* -EINVAL if property parsing failed +*/ +static int v4l2_fwnode_reference_parse ( +struct device *dev,struct v4l2_async_notifier *notifier, +const char *prop) +{ +struct fwnode_reference_args args; +unsigned int index; +int ret; + +for (index =0 ; + !(ret =fwnode_property_get_reference_args ( +dev_fwnode (dev), prop,NULL ,0 , index, &args)); + index++)drivers/media/v4l2-core/v4l2-fwnode.c int v4l2_async_notifier_parse_fwnode_endpoints_by_port( · line 533
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +10
-0+fwnode_handle_put (args.fwnode); + +if (!index) +return -ENOENT ; + +/* +* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ +if (ret != -ENOENT && ret != -ENODATA )So while that patch referenced in the To-do above is not merged yet, what does
fwnode_property_get_reference_argsreturn? ENOENT or ENODATA? Or ENOENT now and ENODATA later? Or vice versa?Quoted 3 lines
I can't tell based on that information whether this code is correct or not.
The comment needs to explain this a bit better.
I'll add this:
drivers/media/v4l2-core/v4l2-fwnode.c +0
-0drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 531
Quoted 3 lines
drivers/media/v4l2-core/v4l2-fwnode.c +0
-0@@ -529,6 +529,9 @@ static int v4l2_fwnode_reference_parse(/* * To-do: handle -ENODATA when "device property: Align return * codes of acpi_fwnode_get_reference_with_args" is merged. So after this patch referred to in the To-do is applied it will only return ENODATA?
Quoted 6 lines
Quoted 1 line
In that case, change 'handle' to 'handle only'.
That depends a bit in which form the patch will be eventually accepted. The underlying issue there is that different error codes are used to signal conditions for out-of-bounds access and missing entry. After aligning them the code here can be updated.
Ah. In that case I'd drop the 'To-do' sentence.
Quoted 2 lines
Quoted 2 lines
Quoted 6 lines
Quoted 3 lines
Quoted 3 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 534
Quoted 3 lines
drivers/media/v4l2-core/v4l2-fwnode.c +3
-0+* Right now, both -ENODATA and -ENOENT signal the end of +* references where only a single error code should be used +* for the purpose. And add something like: "This might change in the future, in which case this code should be updated."
I'll use:
/* * Note that right now both -ENODATA and -ENOENT may signal * out-of-bounds access. Return the error in cases other than that. */
Signature · 2 lines
Sakari Ailus e-mail: [email protected]
PATCH v12 19/26 v4l: fwnode: Add a helper function to obtain device / interger references
In reply to a message not in the archivev4l2_fwnode_reference_parse_int_prop() will find an fwnode such that under the device's own fwnode, it will follow child fwnodes with the given property -- value pair and return the resulting fwnode.
--- drivers/media/v4l2-core/v4l2-fwnode.c | 145 ++++++++++++++++++++++++++++++++++ 1 file changed, 145 insertions(+)
drivers/media/v4l2-core/v4l2-fwnode.c +145 -0
@@ -567,6 +567,151 @@ static int v4l2_fwnode_reference_parse(return ret; } +/* +* v4l2_fwnode_reference_get_int_prop - parse a reference with integer +* arguments +* @dev: struct device pointer +* @notifier: notifier for @dev +* @prop: the name of the property +* @props: the array of integer property names +* @nprops: the number of integer properties +* +* Find fwnodes referred to by a property @prop, then under that iteratively +* follow each child node which has a property the value matches the integer +* argument at an index. +* +* Return: 0 on success +* -ENOENT if no entries (or the property itself) were found +* -EINVAL if property parsing otherwisefailed +* -ENOMEM if memory allocation failed +*/ +static struct fwnode_handle *v4l2_fwnode_reference_get_int_prop ( +struct fwnode_handle *fwnode,const char *prop,unsigned int index, +const char **props,unsigned int nprops) +{ +struct fwnode_reference_args fwnode_args; +unsigned int *args = fwnode_args.args; +struct fwnode_handle *child; +int ret; + +/* +* Obtain remote fwnode as well as the integer arguments. +* +* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ + ret =fwnode_property_get_reference_args (fwnode, prop,NULL , nprops, + index, &fwnode_args); +if (ret) +return ERR_PTR (ret == -ENODATA ? -ENOENT : ret); + +/* +* Find a node in the tree under the referred fwnode corresponding the +* integer arguments. +*/ + fwnode = fwnode_args.fwnode; +while (nprops) { +u32 val; + +/* Loop over all child nodes under fwnode. */ +fwnode_for_each_child_node (fwnode, child) { +if (fwnode_property_read_u32 (child, *props, &val)) +continue ; + +/* Found property, see if its value matches. */ +if (val == *args) +break ; + } + +fwnode_handle_put (fwnode); + +/* No property found; return an error here. */ +if (!child) { + fwnode =ERR_PTR (-ENOENT ); +break ; + } + + props++; + args++; + fwnode = child; + nprops--; + } + +return fwnode; +} + +/* +* v4l2_fwnode_reference_parse_int_props - parse references for async sub-devices +* @dev: struct device pointer +* @notifier: notifier for @dev +* @prop: the name of the property +* @props: the array of integer property names +* @nprops: the number of integer properties +* +* Use v4l2_fwnode_reference_get_int_prop to find fwnodes through reference in +* property @prop with integer arguments with child nodes matching in properties +* @props. Then, set up V4L2 async sub-devices for those fwnodes in the notifier +* accordingly. +* +* While it is technically possible to use this function on DT, it is only +* meaningful on ACPI. On Device tree you can refer to any node in the tree but +* on ACPI the references are limited to devices. +* +* Return: 0 on success +* -ENOENT if no entries (or the property itself) were found +* -EINVAL if property parsing otherwisefailed +* -ENOMEM if memory allocation failed +*/ +static int v4l2_fwnode_reference_parse_int_props ( +struct device *dev,struct v4l2_async_notifier *notifier, +const char *prop,const char **props,unsigned int nprops) +{ +struct fwnode_handle *fwnode; +unsigned int index; +int ret; + +for (index =0 ; !IS_ERR ((fwnode =v4l2_fwnode_reference_get_int_prop ( +dev_fwnode (dev), prop, index, props, + nprops))); index++) +fwnode_handle_put (fwnode); + +if (PTR_ERR (fwnode) != -ENOENT ) +return PTR_ERR (fwnode); + + ret =v4l2_async_notifier_realloc (notifier, + notifier->num_subdevs + index); +if (ret) +return -ENOMEM ; + +for (index =0 ; !IS_ERR ((fwnode =v4l2_fwnode_reference_get_int_prop ( +dev_fwnode (dev), prop, index, props, + nprops))); index++) { +struct v4l2_async_subdev *asd; + +if (WARN_ON (notifier->num_subdevs >= notifier->max_subdevs)) { + ret = -EINVAL ; + goto error; + } + + asd =kzalloc (sizeof (struct v4l2_async_subdev ),GFP_KERNEL ); +if (!asd) { + ret = -ENOMEM ; + goto error; + } + + notifier->subdevs[notifier->num_subdevs] = asd; + asd->match.fwnode.fwnode = fwnode; + asd->match_type =V4L2_ASYNC_MATCH_FWNODE ; + notifier->num_subdevs++; + } + +return PTR_ERR (fwnode) == -ENOENT ?0 :PTR_ERR (fwnode); + +error: +fwnode_handle_put (fwnode); +return ret; +} +MODULE_LICENSE ("GPL" );MODULE_AUTHOR ("Sakari Ailus <sakari.ailus-VuQAYsv1563Yd54FQh9/[email protected]>" );MODULE_AUTHOR ("Sylwester Nawrocki <[email protected]>" );
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): 20170912134200.19556-20-sakari.ailus-VuQAYsv1563Yd54FQh9/[email protected]
Re: [PATCH v12 19/26] v4l: fwnode: Add a helper function to obtain device / interger references
The subject still has the 'interger' typo.
Quoted 3 lines · Sakari Ailus
v4l2_fwnode_reference_parse_int_prop()will find an fwnode such that under the device's own fwnode, it will follow child fwnodes with the given property -- value pair and return the resulting fwnode.
As suggested before: 'property-value' is easier to read than ' -- '.
Quoted 11 lines
--- drivers/media/v4l2-core/v4l2-fwnode.c | 145 ++++++++++++++++++++++++++++++++++ 1 file changed, 145 insertions(+)drivers/media/v4l2-core/v4l2-fwnode.c +0
-0
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 575
Quoted 9 lines
drivers/media/v4l2-core/v4l2-fwnode.c +6
-0@@ -567,6 +567,151 @@ static int v4l2_fwnode_reference_parse(return ret; } +/* +* v4l2_fwnode_reference_get_int_prop - parse a reference with integer +* arguments +* @dev: struct device pointer +* @notifier: notifier for @dev +* @prop: the name of the property
@index is not documented.
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 577
Quoted 2 lines
drivers/media/v4l2-core/v4l2-fwnode.c +2
-0+* @props: the array of integer property names +* @nprops: the number of integer properties
properties -> property names in @props
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 580
Quoted 3 lines
drivers/media/v4l2-core/v4l2-fwnode.c +3
-0+* +* Find fwnodes referred to by a property @prop, then under that iteratively +* follow each child node which has a property the value matches the integer
"the value" -> "whose value" or "with a value that"
At least, I think that's what you mean here.
How is @props/@nprops used?
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 581
Quoted 1 line
drivers/media/v4l2-core/v4l2-fwnode.c +1
-0+* argument at an index.
I assume this should be "the @index"?
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 585
Quoted 4 lines
drivers/media/v4l2-core/v4l2-fwnode.c +4
-0+* +* Return: 0 on success +* -ENOENT if no entries (or the property itself) were found +* -EINVAL if property parsing otherwisefailed
Missing space before "failed"
Quoted 14 lines
drivers/media/v4l2-core/v4l2-fwnode.c +14
-0+* -ENOMEM if memory allocation failed +*/ +static struct fwnode_handle *v4l2_fwnode_reference_get_int_prop ( +struct fwnode_handle *fwnode,const char *prop,unsigned int index, +const char **props,unsigned int nprops) +{ +struct fwnode_reference_args fwnode_args; +unsigned int *args = fwnode_args.args; +struct fwnode_handle *child; +int ret; + +/* +* Obtain remote fwnode as well as the integer arguments. +*
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 609
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +10
-0+* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ + ret =fwnode_property_get_reference_args (fwnode, prop,NULL , nprops, + index, &fwnode_args); +if (ret) +return ERR_PTR (ret == -ENODATA ? -ENOENT : ret); + +/* +* Find a node in the tree under the referred fwnode corresponding the
the -> to the
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 613
Quoted 4 lines
drivers/media/v4l2-core/v4l2-fwnode.c +4
-0+* integer arguments. +*/ + fwnode = fwnode_args.fwnode; +while (nprops) {
This can be 'while (nprops--) {'.
Quoted 18 lines
drivers/media/v4l2-core/v4l2-fwnode.c +18
-0+u32 val; + +/* Loop over all child nodes under fwnode. */ +fwnode_for_each_child_node (fwnode, child) { +if (fwnode_property_read_u32 (child, *props, &val)) +continue ; + +/* Found property, see if its value matches. */ +if (val == *args) +break ; + } + +fwnode_handle_put (fwnode); + +/* No property found; return an error here. */ +if (!child) { + fwnode =ERR_PTR (-ENOENT ); +break ;
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 641
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +10
-0+ } + + props++; + args++; + fwnode = child; + nprops--; + } + +return fwnode; +}
You really need to add an ACPI example as comment for this source code.
I still don't understand the code. I know you pointed me to an example, but I can't remember/find what it was. Either copy the example here or point to the file containing the example (copying is best IMHO).
Regards,
Hans
Quoted 67 lines
drivers/media/v4l2-core/v4l2-fwnode.c +66
-0+ +/* +* v4l2_fwnode_reference_parse_int_props - parse references for async sub-devices +* @dev: struct device pointer +* @notifier: notifier for @dev +* @prop: the name of the property +* @props: the array of integer property names +* @nprops: the number of integer properties +* +* Use v4l2_fwnode_reference_get_int_prop to find fwnodes through reference in +* property @prop with integer arguments with child nodes matching in properties +* @props. Then, set up V4L2 async sub-devices for those fwnodes in the notifier +* accordingly. +* +* While it is technically possible to use this function on DT, it is only +* meaningful on ACPI. On Device tree you can refer to any node in the tree but +* on ACPI the references are limited to devices. +* +* Return: 0 on success +* -ENOENT if no entries (or the property itself) were found +* -EINVAL if property parsing otherwisefailed +* -ENOMEM if memory allocation failed +*/ +static int v4l2_fwnode_reference_parse_int_props ( +struct device *dev,struct v4l2_async_notifier *notifier, +const char *prop,const char **props,unsigned int nprops) +{ +struct fwnode_handle *fwnode; +unsigned int index; +int ret; + +for (index =0 ; !IS_ERR ((fwnode =v4l2_fwnode_reference_get_int_prop ( +dev_fwnode (dev), prop, index, props, + nprops))); index++) +fwnode_handle_put (fwnode); + +if (PTR_ERR (fwnode) != -ENOENT ) +return PTR_ERR (fwnode); + + ret =v4l2_async_notifier_realloc (notifier, + notifier->num_subdevs + index); +if (ret) +return -ENOMEM ; + +for (index =0 ; !IS_ERR ((fwnode =v4l2_fwnode_reference_get_int_prop ( +dev_fwnode (dev), prop, index, props, + nprops))); index++) { +struct v4l2_async_subdev *asd; + +if (WARN_ON (notifier->num_subdevs >= notifier->max_subdevs)) { + ret = -EINVAL ; + goto error; + } + + asd =kzalloc (sizeof (struct v4l2_async_subdev ),GFP_KERNEL ); +if (!asd) { + ret = -ENOMEM ; + goto error; + } + + notifier->subdevs[notifier->num_subdevs] = asd; + asd->match.fwnode.fwnode = fwnode; + asd->match_type =V4L2_ASYNC_MATCH_FWNODE ; + notifier->num_subdevs++; + } +
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 717
Quoted 10 lines
drivers/media/v4l2-core/v4l2-fwnode.c +7
-0+return PTR_ERR (fwnode) == -ENOENT ?0 :PTR_ERR (fwnode); + +error: +fwnode_handle_put (fwnode); +return ret; +} +MODULE_LICENSE ("GPL" );MODULE_AUTHOR ("Sakari Ailus <sakari.ailus-VuQAYsv1563Yd54FQh9/[email protected]>" );MODULE_AUTHOR ("Sylwester Nawrocki <[email protected]>" );
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
Sakari Ailus
maintainerRe: [PATCH v12 19/26] v4l: fwnode: Add a helper function to obtain device / interger references
Hi Hans,
Quoted 8 lines · Hans Verkuil
The subject still has the 'interger' typo.
Quoted 3 lines · Sakari Ailus
v4l2_fwnode_reference_parse_int_prop()will find an fwnode such that under the device's own fwnode, it will follow child fwnodes with the given property -- value pair and return the resulting fwnode.As suggested before: 'property-value' is easier to read than ' -- '.
Oops. I must have missed some of your comments while making changes. Apologies for that.
Quoted 15 lines
Quoted 15 lines
Signed-off-by Sakari Ailus <[email protected]>--- drivers/media/v4l2-core/v4l2-fwnode.c | 145 ++++++++++++++++++++++++++++++++++ 1 file changed, 145 insertions(+)drivers/media/v4l2-core/v4l2-fwnode.c +0
-0@@ -567,6 +567,151 @@ static int v4l2_fwnode_reference_parse(return ret; }
Quoted 8 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 575
Quoted 6 lines
drivers/media/v4l2-core/v4l2-fwnode.c +6
-0+/* +* v4l2_fwnode_reference_get_int_prop - parse a reference with integer +* arguments +* @dev: struct device pointer +* @notifier: notifier for @dev +* @prop: the name of the property @index is not documented.
Fixed.
Quoted 5 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 577
Quoted 3 lines
drivers/media/v4l2-core/v4l2-fwnode.c +2
-0+* @props: the array of integer property names +* @nprops: the number of integer properties properties -> property names in @props
Fixed.
Quoted 7 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 580
Quoted 4 lines
drivers/media/v4l2-core/v4l2-fwnode.c +3
-0+* +* Find fwnodes referred to by a property @prop, then under that iteratively +* follow each child node which has a property the value matches the integer "the value" -> "whose value" or "with a value that"
Quoted 7 lines
At least, I think that's what you mean here.
How is @props/@nprops used?
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 581
Quoted 1 line
drivers/media/v4l2-core/v4l2-fwnode.c +1
-0+* argument at an index. I assume this should be "the @index"?
Um, no. This is the index to the @props array. I'll clarify the documentation for this function.
Quoted 7 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 585
Quoted 5 lines
drivers/media/v4l2-core/v4l2-fwnode.c +4
-0+* +* Return: 0 on success +* -ENOENT if no entries (or the property itself) were found +* -EINVAL if property parsing otherwisefailed Missing space before "failed"
Fixed.
Quoted 19 lines
Quoted 19 lines
drivers/media/v4l2-core/v4l2-fwnode.c +18
-0+* -ENOMEM if memory allocation failed +*/ +static struct fwnode_handle *v4l2_fwnode_reference_get_int_prop ( +struct fwnode_handle *fwnode,const char *prop,unsigned int index, +const char **props,unsigned int nprops) +{ +struct fwnode_reference_args fwnode_args; +unsigned int *args = fwnode_args.args; +struct fwnode_handle *child; +int ret; + +/* +* Obtain remote fwnode as well as the integer arguments. +* +* To-do: handle -ENODATA when "device property: Align return +* codes of acpi_fwnode_get_reference_with_args" is merged. +*/ + ret = fwnode_property_get_reference_args(fwnode, prop, NULL, nprops,
Quoted 8 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 609
Quoted 6 lines
drivers/media/v4l2-core/v4l2-fwnode.c +6
-0+ index, &fwnode_args); +if (ret) +return ERR_PTR (ret == -ENODATA ? -ENOENT : ret); + +/* +* Find a node in the tree under the referred fwnode corresponding the the -> to the
Fixed.
Quoted 7 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 613
Quoted 5 lines
drivers/media/v4l2-core/v4l2-fwnode.c +4
-0+* integer arguments. +*/ + fwnode = fwnode_args.fwnode; +while (nprops) {This can be 'while (nprops--) {'.
Changed.
Quoted 23 lines
Quoted 23 lines
drivers/media/v4l2-core/v4l2-fwnode.c +22
-0+u32 val; + +/* Loop over all child nodes under fwnode. */ +fwnode_for_each_child_node (fwnode, child) { +if (fwnode_property_read_u32 (child, *props, &val)) +continue ; + +/* Found property, see if its value matches. */ +if (val == *args) +break ; + } + +fwnode_handle_put (fwnode); + +/* No property found; return an error here. */ +if (!child) { + fwnode =ERR_PTR (-ENOENT ); +break ; + } + + props++; + args++;
Quoted 8 lines
drivers/media/v4l2-core/v4l2-fwnode.c static int v4l2_fwnode_reference_parse( · line 641
Quoted 6 lines
drivers/media/v4l2-core/v4l2-fwnode.c +6
-0+ fwnode = child; + nprops--; + } + +return fwnode; +}You really need to add an ACPI example as comment for this source code.
I can copy the relevant portions of the LED flash example, and remove them once the example is merged to mainline. That example really doesn't belong here though.
Quoted 4 lines
I still don't understand the code. I know you pointed me to an example, but I can't remember/find what it was. Either copy the example here or point to the file containing the example (copying is best IMHO).
:-)
Signature · 2 lines
Sakari Ailus e-mail: [email protected]
PATCH v12 22/26 smiapp: Add support for flash and lens devices
In reply to a message not in the archiveParse async sub-devices by using v4l2_subdev_fwnode_reference_parse_sensor_common().
These types devices aren't directly related to the sensor, but are nevertheless handled by the smiapp driver due to the relationship of these component to the main part of the camera module --- the sensor.
This does not yet address providing the user space with information on how to associate the sensor or lens devices but the kernel now has the necessary information to do that.
--- drivers/media/i2c/smiapp/smiapp-core.c | 38 +++++++++++++++++++++++++++------- drivers/media/i2c/smiapp/smiapp.h | 4 +++- 2 files changed, 33 insertions(+), 9 deletions(-)
drivers/media/i2c/smiapp/smiapp-core.c +30 -8
@@ -31,7 +31,7 @@#include <linux/regulator/consumer.h> #include <linux/slab.h> #include <linux/smiapp.h> -#include <linux/v4l2-mediabus.h> +#include <media/v4l2-async.h> #include <media/v4l2-fwnode.h> #include <media/v4l2-device.h>
@@ -2887,17 +2887,24 @@ static int smiapp_probe(struct i2c_client *client,v4l2_i2c_subdev_init (&sensor->src->sd, client, &smiapp_ops); sensor->src->sd.internal_ops = &smiapp_internal_src_ops; + rval =v4l2_async_notifier_parse_fwnode_sensor_common ( + &client->dev, &sensor->notifier); +if (rval <0 ) +return rval; + sensor->vana =devm_regulator_get (&client->dev,"vana" );if (IS_ERR (sensor->vana)) {dev_err (&client->dev,"could not get regulator for vana\n" ); -return PTR_ERR (sensor->vana); + rval =PTR_ERR (sensor->vana); + goto out_release_async_notifier; } sensor->ext_clk =devm_clk_get (&client->dev,NULL );if (IS_ERR (sensor->ext_clk)) {dev_err (&client->dev,"could not get clock (%ld)\n" ,PTR_ERR (sensor->ext_clk)); -return -EPROBE_DEFER ; + rval = -EPROBE_DEFER ; + goto out_release_async_notifier; } rval =clk_set_rate (sensor->ext_clk, sensor->hwcfg->ext_clk);
@@ -2905,17 +2912,19 @@ static int smiapp_probe(struct i2c_client *client,dev_err (&client->dev,"unable to set clock freq to %u\n" , sensor->hwcfg->ext_clk); -return rval; + goto out_release_async_notifier; } sensor->xshutdown =devm_gpiod_get_optional (&client->dev,"xshutdown" ,GPIOD_OUT_LOW ); -if (IS_ERR (sensor->xshutdown)) -return PTR_ERR (sensor->xshutdown); +if (IS_ERR (sensor->xshutdown)) { + rval =PTR_ERR (sensor->xshutdown); + goto out_release_async_notifier; + } rval =smiapp_power_on (&client->dev);if (rval <0 ) -return rval; + goto out_release_async_notifier; rval =smiapp_identify_module (sensor);if (rval) {
@@ -3092,9 +3101,14 @@ static int smiapp_probe(struct i2c_client *client,if (rval <0 ) goto out_media_entity_cleanup; + rval =v4l2_async_subdev_notifier_register (&sensor->src->sd, + &sensor->notifier); +if (rval) + goto out_media_entity_cleanup; + rval =v4l2_async_register_subdev (&sensor->src->sd);if (rval <0 ) - goto out_media_entity_cleanup; + goto out_unregister_async_notifier;pm_runtime_set_active (&client->dev);pm_runtime_get_noresume (&client->dev);
@@ -3105,6 +3119,9 @@ static int smiapp_probe(struct i2c_client *client,return 0 ; +out_unregister_async_notifier: +v4l2_async_notifier_unregister (&sensor->notifier); + out_media_entity_cleanup:media_entity_cleanup (&sensor->src->sd.entity);
@@ -3114,6 +3131,9 @@ static int smiapp_probe(struct i2c_client *client, out_power_off:smiapp_power_off (&client->dev); +out_release_async_notifier: +v4l2_async_notifier_release (&sensor->notifier); +return rval; }
@@ -3124,6 +3144,8 @@ static int smiapp_remove(struct i2c_client *client)unsigned int i;v4l2_async_unregister_subdev (subdev); +v4l2_async_notifier_unregister (&sensor->notifier); +v4l2_async_notifier_release (&sensor->notifier);pm_runtime_disable (&client->dev);if (!pm_runtime_status_suspended (&client->dev))
drivers/media/i2c/smiapp/smiapp.h +3 -1
@@ -20,9 +20,10 @@#define __SMIAPP_PRIV_H_#include <linux/mutex.h> +#include <media/i2c/smiapp.h> +#include <media/v4l2-async.h> #include <media/v4l2-ctrls.h> #include <media/v4l2-subdev.h> -#include <media/i2c/smiapp.h> #include "smiapp-pll.h" #include "smiapp-reg.h"
@@ -172,6 +173,7 @@ struct smiapp_subdev {* struct smiapp_sensor - Main device structure */ struct smiapp_sensor { +struct v4l2_async_notifier notifier;/* * "mutex" is used to serialise access to all fields here * except v4l2_ctrls at the end of the struct. "mutex" is also
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 24/26 ov5670: Add support for flash and lens devices
In reply to a message not in the archiveParse async sub-devices by using v4l2_subdev_fwnode_reference_parse_sensor_common().
--- drivers/media/i2c/ov5670.c | 33 +++++++++++++++++++++++++-------- 1 file changed, 25 insertions(+), 8 deletions(-)
drivers/media/i2c/ov5670.c +25 -8
@@ -18,6 +18,7 @@#include <linux/pm_runtime.h> #include <media/v4l2-ctrls.h> #include <media/v4l2-device.h> +#include <media/v4l2-fwnode.h> #define OV5670_REG_CHIP_ID 0x300a#define OV5670_CHIP_ID 0x005670
@@ -1807,6 +1808,7 @@ static const struct ov5670_mode supported_modes[] = {struct ov5670 {struct v4l2_subdev sd;struct media_pad pad; +struct v4l2_async_notifier notifier;struct v4l2_ctrl_handler ctrl_handler;/* V4L2 Controls */
@@ -2473,11 +2475,13 @@ static int ov5670_probe(struct i2c_client *client)return -EINVAL ; ov5670 =devm_kzalloc (&client->dev,sizeof (*ov5670),GFP_KERNEL ); -if (!ov5670) { - ret = -ENOMEM ; - err_msg ="devm_kzalloc() error" ; - goto error_print; - } +if (!ov5670) +return -ENOMEM ; + + ret =v4l2_async_notifier_parse_fwnode_sensor_common ( + &client->dev, &ov5670->notifier); +if (ret <0 ) +return ret;/* Initialize subdev */ v4l2_i2c_subdev_init (&ov5670->sd, client, &ov5670_subdev_ops);
@@ -2486,7 +2490,7 @@ static int ov5670_probe(struct i2c_client *client) ret =ov5670_identify_module (ov5670);if (ret) { err_msg ="ov5670_identify_module() error" ; - goto error_print; + goto error_release_notifier; }mutex_init (&ov5670->mutex);
@@ -2513,11 +2517,18 @@ static int ov5670_probe(struct i2c_client *client) goto error_handler_free; } + ret =v4l2_async_subdev_notifier_register (&ov5670->sd, + &ov5670->notifier); +if (ret) { + err_msg ="can't register async notifier" ; + goto error_entity_cleanup; + } +/* Async register for subdev */ ret =v4l2_async_register_subdev (&ov5670->sd);if (ret <0 ) { err_msg ="v4l2_async_register_subdev() error" ; - goto error_entity_cleanup; + goto error_unregister_notifier; } ov5670->streaming = false;
@@ -2533,6 +2544,9 @@ static int ov5670_probe(struct i2c_client *client)return 0 ; +error_unregister_notifier: +v4l2_async_notifier_unregister (&ov5670->notifier); + error_entity_cleanup:media_entity_cleanup (&ov5670->sd.entity);
@@ -2542,7 +2556,8 @@ static int ov5670_probe(struct i2c_client *client) error_mutex_destroy:mutex_destroy (&ov5670->mutex); -error_print: +error_release_notifier: +v4l2_async_notifier_release (&ov5670->notifier);dev_err (&client->dev,"%s: %s %d\n" , __func__, err_msg, ret);return ret;
@@ -2554,6 +2569,8 @@ static int ov5670_remove(struct i2c_client *client)struct ov5670 *ov5670 =to_ov5670 (sd);v4l2_async_unregister_subdev (sd); +v4l2_async_notifier_unregister (&ov5670->notifier); +v4l2_async_notifier_release (&ov5670->notifier);media_entity_cleanup (&sd->entity);v4l2_ctrl_handler_free (sd->ctrl_handler);mutex_destroy (&ov5670->mutex);
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 25/26 ov13858: Add support for flash and lens devices
In reply to a message not in the archiveParse async sub-devices by using v4l2_subdev_fwnode_reference_parse_sensor_common().
--- drivers/media/i2c/ov13858.c | 26 +++++++++++++++++++++++--- 1 file changed, 23 insertions(+), 3 deletions(-)
drivers/media/i2c/ov13858.c +23 -3
@@ -18,6 +18,7 @@#include <linux/pm_runtime.h> #include <media/v4l2-ctrls.h> #include <media/v4l2-device.h> +#include <media/v4l2-fwnode.h> #define OV13858_REG_VALUE_08BIT 1#define OV13858_REG_VALUE_16BIT 2
@@ -1028,6 +1029,7 @@ static const struct ov13858_mode supported_modes[] = {struct ov13858 {struct v4l2_subdev sd;struct media_pad pad; +struct v4l2_async_notifier notifier;struct v4l2_ctrl_handler ctrl_handler;/* V4L2 Controls */
@@ -1715,6 +1717,11 @@ static int ov13858_probe(struct i2c_client *client,if (!ov13858)return -ENOMEM ; + ret =v4l2_async_notifier_parse_fwnode_sensor_common ( + &client->dev, &ov13858->notifier); +if (ret <0 ) +return ret; +/* Initialize subdev */ v4l2_i2c_subdev_init (&ov13858->sd, client, &ov13858_subdev_ops);
@@ -1722,7 +1729,7 @@ static int ov13858_probe(struct i2c_client *client, ret =ov13858_identify_module (ov13858);if (ret) {dev_err (&client->dev,"failed to find sensor: %d\n" , ret); -return ret; + goto error_notifier_release; }/* Set default mode to max resolution */
@@ -1730,7 +1737,7 @@ static int ov13858_probe(struct i2c_client *client, ret =ov13858_init_controls (ov13858);if (ret) -return ret; + goto error_notifier_release;/* Initialize subdev */ ov13858->sd.internal_ops = &ov13858_internal_ops;
@@ -1746,9 +1753,14 @@ static int ov13858_probe(struct i2c_client *client, goto error_handler_free; } + ret =v4l2_async_subdev_notifier_register (&ov13858->sd, + &ov13858->notifier); +if (ret) + goto error_media_entity; + ret =v4l2_async_register_subdev (&ov13858->sd);if (ret <0 ) - goto error_media_entity; + goto error_notifier_unregister;/* * Device is already turned on by i2c-core with ACPI domain PM.
@@ -1761,11 +1773,17 @@ static int ov13858_probe(struct i2c_client *client,return 0 ; +error_notifier_unregister: +v4l2_async_notifier_unregister (&ov13858->notifier); + error_media_entity:media_entity_cleanup (&ov13858->sd.entity); error_handler_free:ov13858_free_controls (ov13858); + +error_notifier_release: +v4l2_async_notifier_release (&ov13858->notifier);dev_err (&client->dev,"%s failed:%d\n" , __func__, ret);return ret;
@@ -1777,6 +1795,8 @@ static int ov13858_remove(struct i2c_client *client)struct ov13858 *ov13858 =to_ov13858 (sd);v4l2_async_unregister_subdev (sd); +v4l2_async_notifier_unregister (&ov13858->notifier); +v4l2_async_notifier_release (&ov13858->notifier);media_entity_cleanup (&sd->entity);ov13858_free_controls (ov13858);
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
PATCH v12 26/26 arm: dts: omap3: N9/N950: Add flash references to the camera
In reply to a message not in the archiveAdd flash and indicator LED phandles to the sensor node.
--- arch/arm/boot/dts/omap3-n9.dts | 1 + arch/arm/boot/dts/omap3-n950-n9.dtsi | 4 ++-- arch/arm/boot/dts/omap3-n950.dts | 1 + 3 files changed, 4 insertions(+), 2 deletions(-)
arch/arm/boot/dts/omap3-n9.dts +1 -0
@@ -26,6 +26,7 @@ clocks = <&isp 0>; clock-frequency = <9600000>; nokia,nvm-size = <(16 * 64)>; + flash-leds = <&as3645a_flash &as3645a_indicator>; port { smia_1_1: endpoint { link-frequencies = /bits/ 64 <199200000 210000000 499200000>;
arch/arm/boot/dts/omap3-n950-n9.dtsi +2 -2
@@ -271,14 +271,14 @@ #size-cells = <0>; reg = <0x30>; compatible = "ams,as3645a"; - flash@0 { + as3645a_flash: flash@0 { reg = <0x0>; flash-timeout-us = <150000>; flash-max-microamp = <320000>; led-max-microamp = <60000>; ams,input-max-microamp = <1750000>; }; - indicator@1 { + as3645a_indicator: indicator@1 { reg = <0x1>; led-max-microamp = <10000>; };
arch/arm/boot/dts/omap3-n950.dts +1 -0
@@ -60,6 +60,7 @@ clocks = <&isp 0>; clock-frequency = <9600000>; nokia,nvm-size = <(16 * 64)>; + flash-leds = <&as3645a_flash &as3645a_indicator>; port { smia_1_1: endpoint { link-frequencies = /bits/ 64 <210000000 333600000 398400000>;
Signature · 6 lines
2.11.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
Sakari Ailus
maintainerPATCH v12 3/26 v4l: async: Use more intuitive names for internal functions
In reply to Sakari AilusRename internal functions to make the names of the functions better describe what they do.
Old name New name
v4l2_async_test_notify v4l2_async_match_notify
v4l2_async_belongs v4l2_async_find_match
--- drivers/media/v4l2-core/v4l2-async.c | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-)
drivers/media/v4l2-core/v4l2-async.c +10 -9
@@ -60,8 +60,8 @@ static LIST_HEAD(subdev_list);static LIST_HEAD (notifier_list);static DEFINE_MUTEX (list_lock); -static struct v4l2_async_subdev *v4l2_async_belongs (struct v4l2_async_notifier *notifier, -struct v4l2_subdev *sd) +static struct v4l2_async_subdev *v4l2_async_find_match ( +struct v4l2_async_notifier *notifier,struct v4l2_subdev *sd) {bool (*match)(struct v4l2_subdev *,struct v4l2_async_subdev *);struct v4l2_async_subdev *asd;
@@ -95,9 +95,9 @@ static struct v4l2_async_subdev *v4l2_async_belongs(struct v4l2_async_notifier *return NULL ; } -static int v4l2_async_test_notify (struct v4l2_async_notifier *notifier, -struct v4l2_subdev *sd, -struct v4l2_async_subdev *asd) +static int v4l2_async_match_notify (struct v4l2_async_notifier *notifier, +struct v4l2_subdev *sd, +struct v4l2_async_subdev *asd) {int ret;
@@ -175,11 +175,11 @@ int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev,list_for_each_entry_safe (sd, tmp, &subdev_list, async_list) {int ret; - asd =v4l2_async_belongs (notifier, sd); + asd =v4l2_async_find_match (notifier, sd);if (!asd)continue ; - ret =v4l2_async_test_notify (notifier, sd, asd); + ret =v4l2_async_match_notify (notifier, sd, asd);if (ret <0 ) {mutex_unlock (&list_lock);return ret;
@@ -236,9 +236,10 @@ int v4l2_async_register_subdev(struct v4l2_subdev *sd)INIT_LIST_HEAD (&sd->async_list);list_for_each_entry (notifier, ¬ifier_list, list) { -struct v4l2_async_subdev *asd =v4l2_async_belongs (notifier, sd); +struct v4l2_async_subdev *asd =v4l2_async_find_match (notifier, + sd);if (asd) { -int ret =v4l2_async_test_notify (notifier, sd, asd); +int ret =v4l2_async_match_notify (notifier, sd, asd);mutex_unlock (&list_lock);return ret; }
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 4/26 v4l: async: Add V4L2 async documentation to the documentation build
In reply to Sakari AilusThe V4L2 async wasn't part of the documentation build. Fix this.
--- Documentation/media/kapi/v4l2-async.rst | 3 +++ Documentation/media/kapi/v4l2-core.rst | 1 + 2 files changed, 4 insertions(+) create mode 100644 Documentation/media/kapi/v4l2-async.rst
Documentation/media/kapi/v4l2-async.rst new file +3 -0
@@ -0,0 +1,3 @@ +V4L2 async kAPI +^^^^^^^^^^^^^^^ +.. kernel-doc:: include/media/v4l2-async.h
Documentation/media/kapi/v4l2-core.rst +1 -0
@@ -19,6 +19,7 @@ Video4Linux devices v4l2-mc v4l2-mediabus v4l2-mem2mem + v4l2-async v4l2-fwnode v4l2-rect v4l2-tuner
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 5/26 v4l: fwnode: Support generic parsing of graph endpoints in a device
In reply to Sakari AilusThe current practice is that drivers iterate over their endpoints and parse each endpoint separately. This is very similar in a number of drivers, implement a generic function for the job. Driver specific matters can be taken into account in the driver specific callback.
--- drivers/media/v4l2-core/v4l2-async.c | 30 ++++++++ drivers/media/v4l2-core/v4l2-fwnode.c | 136 ++++++++++++++++++++++++++++++++++ include/media/v4l2-async.h | 24 +++++- include/media/v4l2-fwnode.h | 56 ++++++++++++++ 4 files changed, 244 insertions(+), 2 deletions(-)
drivers/media/v4l2-core/v4l2-async.c +30 -0
@@ -22,6 +22,7 @@#include <media/v4l2-async.h> #include <media/v4l2-device.h> +#include <media/v4l2-fwnode.h> #include <media/v4l2-subdev.h> static bool match_i2c (struct v4l2_subdev *sd,struct v4l2_async_subdev *asd)
@@ -219,6 +220,35 @@ void v4l2_async_notifier_unregister(struct v4l2_async_notifier *notifier) }EXPORT_SYMBOL (v4l2_async_notifier_unregister); +void v4l2_async_notifier_release (struct v4l2_async_notifier *notifier) +{ +unsigned int i; + +if (!notifier->max_subdevs) +return ; + +for (i =0 ; i < notifier->num_subdevs; i++) { +struct v4l2_async_subdev *asd = notifier->subdevs[i]; + +switch (asd->match_type) { +case V4L2_ASYNC_MATCH_FWNODE : +fwnode_handle_put (asd->match.fwnode.fwnode); +break ; +default : +WARN_ON_ONCE (1 ); + } + +kfree (asd); + } + + notifier->max_subdevs =0 ; + notifier->num_subdevs =0 ; + +kvfree (notifier->subdevs); + notifier->subdevs =NULL ; +} +EXPORT_SYMBOL_GPL (v4l2_async_notifier_release); +int v4l2_async_register_subdev (struct v4l2_subdev *sd) {struct v4l2_async_notifier *notifier;
drivers/media/v4l2-core/v4l2-fwnode.c +136 -0
154 lines not on this page · raw message
include/media/v4l2-async.h +22 -2
@@ -18,7 +18,6 @@ struct device;struct device_node ;struct v4l2_device ;struct v4l2_subdev ; -struct v4l2_async_notifier ;/* A random max subdevice number, used to allocate an array on stack */ #define V4L2_MAX_SUBDEVS 128U
@@ -50,6 +49,10 @@ enum v4l2_async_match_type {* @match: union of per-bus type matching data sets * @list: used to link struct v4l2_async_subdev objects, waiting to be * probed, to a notifier->waiting list +* +* When this struct is used as a member in a driver specific struct, +* the driver specific struct shall contain the @struct +* v4l2_async_subdev as its first member. */ struct v4l2_async_subdev {enum v4l2_async_match_type match_type;
@@ -78,7 +81,8 @@ struct v4l2_async_subdev {/** * struct v4l2_async_notifier - v4l2_device notifier data * -* @num_subdevs: number of subdevices +* @num_subdevs: number of subdevices used in the subdevs array +* @max_subdevs: number of subdevices allocated in the subdevs array * @subdevs: array of pointers to subdevice descriptors * @v4l2_dev: pointer to struct v4l2_device * @waiting: list of struct v4l2_async_subdev, waiting for their drivers
@@ -90,6 +94,7 @@ struct v4l2_async_subdev {*/ struct v4l2_async_notifier {unsigned int num_subdevs; +unsigned int max_subdevs;struct v4l2_async_subdev **subdevs;struct v4l2_device *v4l2_dev;struct list_head waiting;
@@ -121,6 +126,21 @@ int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev,void v4l2_async_notifier_unregister (struct v4l2_async_notifier *notifier);/** +* v4l2_async_notifier_release - release notifier resources +* @notifier: the notifier the resources of which are to be released +* +* Release memory resources related to a notifier, including the async +* sub-devices allocated for the purposes of the notifier. The user is +* responsible for releasing the notifier's resources after calling +* @v4l2_async_notifier_parse_fwnode_endpoints. +* +* There is no harm from calling v4l2_async_notifier_release in other +* cases as long as its memory has been zeroed after it has been +* allocated. +*/ +void v4l2_async_notifier_release (struct v4l2_async_notifier *notifier); + +/** * v4l2_async_register_subdev - registers a sub-device to the asynchronous * subdevice framework *
include/media/v4l2-fwnode.h +56 -0
66 lines not on this page · raw message
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 6/26 v4l: fwnode: Support generic parsing of graph endpoints, per port
In reply to Sakari AilusThis is just like like v4l2_async_notifier_parse_fwnode_endpoints but it only parses endpoints on a single port. The behaviour is useful on devices that have both sinks and sources, in other words only some of these should be parsed.
--- drivers/media/v4l2-core/v4l2-fwnode.c | 59 ++++++++++++++++++++++++++++++++--- include/media/v4l2-fwnode.h | 59 +++++++++++++++++++++++++++++++++++ 2 files changed, 113 insertions(+), 5 deletions(-)
drivers/media/v4l2-core/v4l2-fwnode.c +54 -5
@@ -398,9 +398,9 @@ static int v4l2_async_notifier_fwnode_parse_endpoint(return ret == -ENOTCONN ?0 : ret; } -int v4l2_async_notifier_parse_fwnode_endpoints ( +static int __v4l2_async_notifier_parse_fwnode_endpoints (struct device *dev,struct v4l2_async_notifier *notifier, -size_t asd_struct_size, +size_t asd_struct_size,unsigned int port,bool has_port,int (*parse_endpoint)(struct device *dev,struct v4l2_fwnode_endpoint *vep,struct v4l2_async_subdev *asd))
@@ -413,10 +413,25 @@ int v4l2_async_notifier_parse_fwnode_endpoints(return -EINVAL ;for (fwnode =NULL ; (fwnode =fwnode_graph_get_next_endpoint ( -dev_fwnode (dev), fwnode)); ) -if (fwnode_device_is_available ( +dev_fwnode (dev), fwnode)); ) { +if (!fwnode_device_is_available (fwnode_graph_get_port_parent (fwnode))) - max_subdevs++; +continue ; + +if (has_port) { +struct fwnode_endpoint ep; + + ret =fwnode_graph_parse_endpoint (fwnode, &ep); +if (ret) { +fwnode_handle_put (fwnode); +return ret; + } + +if (ep.port != port) +continue ; + } + max_subdevs++; + }/* No subdevs to add? Return here. */ if (max_subdevs == notifier->max_subdevs)
@@ -437,6 +452,17 @@ int v4l2_async_notifier_parse_fwnode_endpoints(break ; } +if (has_port) { +struct fwnode_endpoint ep; + + ret =fwnode_graph_parse_endpoint (fwnode, &ep); +if (ret) +break ; + +if (ep.port != port) +continue ; + } + ret =v4l2_async_notifier_fwnode_parse_endpoint ( dev, notifier, fwnode, asd_struct_size, parse_endpoint);if (ret <0 )
@@ -447,8 +473,31 @@ int v4l2_async_notifier_parse_fwnode_endpoints(return ret; } + +int v4l2_async_notifier_parse_fwnode_endpoints ( +struct device *dev,struct v4l2_async_notifier *notifier, +size_t asd_struct_size, +int (*parse_endpoint)(struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd)) +{ +return __v4l2_async_notifier_parse_fwnode_endpoints ( + dev, notifier, asd_struct_size,0 , false, parse_endpoint); +}EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints); +int v4l2_async_notifier_parse_fwnode_endpoints_by_port ( +struct device *dev,struct v4l2_async_notifier *notifier, +size_t asd_struct_size,unsigned int port, +int (*parse_endpoint)(struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd)) +{ +return __v4l2_async_notifier_parse_fwnode_endpoints ( + dev, notifier, asd_struct_size, port, true, parse_endpoint); +} +EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +MODULE_LICENSE ("GPL" );MODULE_AUTHOR ("Sakari Ailus <[email protected]>" );MODULE_AUTHOR ("Sylwester Nawrocki <[email protected]>" );
include/media/v4l2-fwnode.h +59 -0
63 lines not on this page · raw message
Signature · 1 line
2.11.0
Re: [PATCH v12 06/26] v4l: fwnode: Support generic parsing of graph endpoints, per port
Quoted 4 lines · Sakari Ailus
This is just like like
v4l2_async_notifier_parse_fwnode_endpointsbut it only parses endpoints on a single port. The behaviour is useful on devices that have both sinks and sources, in other words only some of these should be parsed.
I think it would be better to merge this patch with the preceding patch. It does not make a lot of sense to have this separate IMHO.
That said:
Regards,
Hans
Quoted 171 lines
Signed-off-by Sakari Ailus <[email protected]>--- drivers/media/v4l2-core/v4l2-fwnode.c | 59 ++++++++++++++++++++++++++++++++--- include/media/v4l2-fwnode.h | 59 +++++++++++++++++++++++++++++++++++ 2 files changed, 113 insertions(+), 5 deletions(-)drivers/media/v4l2-core/v4l2-fwnode.c +54
-5@@ -398,9 +398,9 @@ static int v4l2_async_notifier_fwnode_parse_endpoint(return ret == -ENOTCONN ?0 : ret; } -int v4l2_async_notifier_parse_fwnode_endpoints ( +static int __v4l2_async_notifier_parse_fwnode_endpoints (struct device *dev,struct v4l2_async_notifier *notifier, -size_t asd_struct_size, +size_t asd_struct_size,unsigned int port,bool has_port,int (*parse_endpoint)(struct device *dev,struct v4l2_fwnode_endpoint *vep,struct v4l2_async_subdev *asd))@@ -413,10 +413,25 @@ int v4l2_async_notifier_parse_fwnode_endpoints(return -EINVAL ;for (fwnode =NULL ; (fwnode =fwnode_graph_get_next_endpoint ( -dev_fwnode (dev), fwnode)); ) -if (fwnode_device_is_available ( +dev_fwnode (dev), fwnode)); ) { +if (!fwnode_device_is_available (fwnode_graph_get_port_parent (fwnode))) - max_subdevs++; +continue ; + +if (has_port) { +struct fwnode_endpoint ep; + + ret =fwnode_graph_parse_endpoint (fwnode, &ep); +if (ret) { +fwnode_handle_put (fwnode); +return ret; + } + +if (ep.port != port) +continue ; + } + max_subdevs++; + }/* No subdevs to add? Return here. */ if (max_subdevs == notifier->max_subdevs)@@ -437,6 +452,17 @@ int v4l2_async_notifier_parse_fwnode_endpoints(break ; } +if (has_port) { +struct fwnode_endpoint ep; + + ret =fwnode_graph_parse_endpoint (fwnode, &ep); +if (ret) +break ; + +if (ep.port != port) +continue ; + } + ret =v4l2_async_notifier_fwnode_parse_endpoint ( dev, notifier, fwnode, asd_struct_size, parse_endpoint);if (ret <0 )@@ -447,8 +473,31 @@ int v4l2_async_notifier_parse_fwnode_endpoints(return ret; } + +int v4l2_async_notifier_parse_fwnode_endpoints ( +struct device *dev,struct v4l2_async_notifier *notifier, +size_t asd_struct_size, +int (*parse_endpoint)(struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd)) +{ +return __v4l2_async_notifier_parse_fwnode_endpoints ( + dev, notifier, asd_struct_size,0 , false, parse_endpoint); +}EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints); +int v4l2_async_notifier_parse_fwnode_endpoints_by_port ( +struct device *dev,struct v4l2_async_notifier *notifier, +size_t asd_struct_size,unsigned int port, +int (*parse_endpoint)(struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd)) +{ +return __v4l2_async_notifier_parse_fwnode_endpoints ( + dev, notifier, asd_struct_size, port, true, parse_endpoint); +} +EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +MODULE_LICENSE ("GPL" );MODULE_AUTHOR ("Sakari Ailus <[email protected]>" );MODULE_AUTHOR ("Sylwester Nawrocki <[email protected]>" );include/media/v4l2-fwnode.h +59
-0@@ -257,4 +257,63 @@ int v4l2_async_notifier_parse_fwnode_endpoints(struct v4l2_fwnode_endpoint *vep, struct v4l2_async_subdev *asd)); +/** +* v4l2_async_notifier_parse_fwnode_endpoints_by_port - Parse V4L2 fwnode +* endpoints of a port in a +* device node +* @dev: the device the endpoints of which are to be parsed +* @notifier: notifier for @dev +* @asd_struct_size: size of the driver's async sub-device struct, including +* sizeof(struct v4l2_async_subdev). The &struct +* v4l2_async_subdev shall be the first member of +* the driver's async sub-device struct, i.e. both +* begin at the same memory address. +* @port: port number where endpoints are to be parsed +* @parse_endpoint: Driver's callback function called on each V4L2 fwnode +* endpoint. Optional. +* Return: %0 on success +* %-ENOTCONN if the endpoint is to be skipped but this +* should not be considered as an error +* %-EINVAL if the endpoint configuration is invalid +* +* This function is just like @v4l2_async_notifier_parse_fwnode_endpoints with +* the exception that it only parses endpoints in a given port. +* +* Parse the fwnode endpoints of the @dev device on a given @port and populate +* the async sub-devices array of the notifier. The @parse_endpoint callback +* function is called for each endpoint with the corresponding async sub-device +* pointer to let the caller initialize the driver-specific part of the async +* sub-device structure. +* +* The notifier memory shall be zeroed before this function is called on the +* notifier. +* +* This function may not be called on a registered notifier and may be called on +* a notifier only once, per port. +* +* Do not change the notifier's subdevs array, take references to the subdevs +* array itself or change the notifier's num_subdevs field. This is because this +* function allocates and reallocates the subdevs array based on parsing +* endpoints. +* +* The @struct v4l2_fwnode_endpoint passed to the callback function +* @parse_endpoint is released once the function is finished. If there is a need +* to retain that configuration, the user needs to allocate memory for it. +* +* Any notifier populated using this function must be released with a call to +* v4l2_async_notifier_release() after it has been unregistered and the async +* sub-devices are no longer in use, even if the function returned an error. +* +* Return: %0 on success, including when no async sub-devices are found +* %-ENOMEM if memory allocation failed +* %-EINVAL if graph or endpoint parsing failed +* Other error codes as returned by @parse_endpoint +*/ +int v4l2_async_notifier_parse_fwnode_endpoints_by_port ( +struct device *dev,struct v4l2_async_notifier *notifier, +size_t asd_struct_size,unsigned int port, +int (*parse_endpoint)(struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd)); +#endif /* _V4L2_FWNODE_H */
Re: [PATCH v12 06/26] v4l: fwnode: Support generic parsing of graph endpoints, per port
Quoted 5 lines · Hans Verkuil
Quoted 4 lines · Sakari Ailus
This is just like like
v4l2_async_notifier_parse_fwnode_endpointsbut it only parses endpoints on a single port. The behaviour is useful on devices that have both sinks and sources, in other words only some of these should be parsed.
I forgot to mention that I think the log message can be improved: it is not clear why you would only parse some of the ports for devices that have both sinks and sources. That should be explained better. And probably also in the header documentation.
Quoted 7 lines
I think it would be better to merge this patch with the preceding patch. It does not make a lot of sense to have this separate IMHO.
That said:
Acked-by Hans Verkuil <[email protected]>
Sorry, I'm retracting this. It needs a bit more work w.r.t. commit log and header comments.
Regards,
Hans
Quoted 177 lines
Regards,
Hans
Quoted 171 lines
Signed-off-by Sakari Ailus <[email protected]>--- drivers/media/v4l2-core/v4l2-fwnode.c | 59 ++++++++++++++++++++++++++++++++--- include/media/v4l2-fwnode.h | 59 +++++++++++++++++++++++++++++++++++ 2 files changed, 113 insertions(+), 5 deletions(-)drivers/media/v4l2-core/v4l2-fwnode.c +54
-5@@ -398,9 +398,9 @@ static int v4l2_async_notifier_fwnode_parse_endpoint(return ret == -ENOTCONN ?0 : ret; } -int v4l2_async_notifier_parse_fwnode_endpoints ( +static int __v4l2_async_notifier_parse_fwnode_endpoints (struct device *dev,struct v4l2_async_notifier *notifier, -size_t asd_struct_size, +size_t asd_struct_size,unsigned int port,bool has_port,int (*parse_endpoint)(struct device *dev,struct v4l2_fwnode_endpoint *vep,struct v4l2_async_subdev *asd))@@ -413,10 +413,25 @@ int v4l2_async_notifier_parse_fwnode_endpoints(return -EINVAL ;for (fwnode =NULL ; (fwnode =fwnode_graph_get_next_endpoint ( -dev_fwnode (dev), fwnode)); ) -if (fwnode_device_is_available ( +dev_fwnode (dev), fwnode)); ) { +if (!fwnode_device_is_available (fwnode_graph_get_port_parent (fwnode))) - max_subdevs++; +continue ; + +if (has_port) { +struct fwnode_endpoint ep; + + ret =fwnode_graph_parse_endpoint (fwnode, &ep); +if (ret) { +fwnode_handle_put (fwnode); +return ret; + } + +if (ep.port != port) +continue ; + } + max_subdevs++; + }/* No subdevs to add? Return here. */ if (max_subdevs == notifier->max_subdevs)@@ -437,6 +452,17 @@ int v4l2_async_notifier_parse_fwnode_endpoints(break ; } +if (has_port) { +struct fwnode_endpoint ep; + + ret =fwnode_graph_parse_endpoint (fwnode, &ep); +if (ret) +break ; + +if (ep.port != port) +continue ; + } + ret =v4l2_async_notifier_fwnode_parse_endpoint ( dev, notifier, fwnode, asd_struct_size, parse_endpoint);if (ret <0 )@@ -447,8 +473,31 @@ int v4l2_async_notifier_parse_fwnode_endpoints(return ret; } + +int v4l2_async_notifier_parse_fwnode_endpoints ( +struct device *dev,struct v4l2_async_notifier *notifier, +size_t asd_struct_size, +int (*parse_endpoint)(struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd)) +{ +return __v4l2_async_notifier_parse_fwnode_endpoints ( + dev, notifier, asd_struct_size,0 , false, parse_endpoint); +}EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints); +int v4l2_async_notifier_parse_fwnode_endpoints_by_port ( +struct device *dev,struct v4l2_async_notifier *notifier, +size_t asd_struct_size,unsigned int port, +int (*parse_endpoint)(struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd)) +{ +return __v4l2_async_notifier_parse_fwnode_endpoints ( + dev, notifier, asd_struct_size, port, true, parse_endpoint); +} +EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_endpoints_by_port); +MODULE_LICENSE ("GPL" );MODULE_AUTHOR ("Sakari Ailus <[email protected]>" );MODULE_AUTHOR ("Sylwester Nawrocki <[email protected]>" );include/media/v4l2-fwnode.h +59
-0@@ -257,4 +257,63 @@ int v4l2_async_notifier_parse_fwnode_endpoints(struct v4l2_fwnode_endpoint *vep, struct v4l2_async_subdev *asd)); +/** +* v4l2_async_notifier_parse_fwnode_endpoints_by_port - Parse V4L2 fwnode +* endpoints of a port in a +* device node +* @dev: the device the endpoints of which are to be parsed +* @notifier: notifier for @dev +* @asd_struct_size: size of the driver's async sub-device struct, including +* sizeof(struct v4l2_async_subdev). The &struct +* v4l2_async_subdev shall be the first member of +* the driver's async sub-device struct, i.e. both +* begin at the same memory address. +* @port: port number where endpoints are to be parsed +* @parse_endpoint: Driver's callback function called on each V4L2 fwnode +* endpoint. Optional. +* Return: %0 on success +* %-ENOTCONN if the endpoint is to be skipped but this +* should not be considered as an error +* %-EINVAL if the endpoint configuration is invalid +* +* This function is just like @v4l2_async_notifier_parse_fwnode_endpoints with +* the exception that it only parses endpoints in a given port. +* +* Parse the fwnode endpoints of the @dev device on a given @port and populate +* the async sub-devices array of the notifier. The @parse_endpoint callback +* function is called for each endpoint with the corresponding async sub-device +* pointer to let the caller initialize the driver-specific part of the async +* sub-device structure. +* +* The notifier memory shall be zeroed before this function is called on the +* notifier. +* +* This function may not be called on a registered notifier and may be called on +* a notifier only once, per port. +* +* Do not change the notifier's subdevs array, take references to the subdevs +* array itself or change the notifier's num_subdevs field. This is because this +* function allocates and reallocates the subdevs array based on parsing +* endpoints. +* +* The @struct v4l2_fwnode_endpoint passed to the callback function +* @parse_endpoint is released once the function is finished. If there is a need +* to retain that configuration, the user needs to allocate memory for it. +* +* Any notifier populated using this function must be released with a call to +* v4l2_async_notifier_release() after it has been unregistered and the async +* sub-devices are no longer in use, even if the function returned an error. +* +* Return: %0 on success, including when no async sub-devices are found +* %-ENOMEM if memory allocation failed +* %-EINVAL if graph or endpoint parsing failed +* Other error codes as returned by @parse_endpoint +*/ +int v4l2_async_notifier_parse_fwnode_endpoints_by_port ( +struct device *dev,struct v4l2_async_notifier *notifier, +size_t asd_struct_size,unsigned int port, +int (*parse_endpoint)(struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd)); +#endif /* _V4L2_FWNODE_H */
A message that is not in the archive (sent off-list or not yet received): a6cdf6cb-6abc-ac3b-274d-e8b43e2ac2c6-qWit8jRvyhVmR6Xm/[email protected]
Re: [PATCH v12 06/26] v4l: fwnode: Support generic parsing of graph endpoints, per port
Hi Hans,
Thanks for the review.
Quoted 11 lines · Hans Verkuil
Quoted 5 lines · Hans Verkuil
Quoted 4 lines · Sakari Ailus
This is just like like
v4l2_async_notifier_parse_fwnode_endpointsbut it only parses endpoints on a single port. The behaviour is useful on devices that have both sinks and sources, in other words only some of these should be parsed.I forgot to mention that I think the log message can be improved: it is not clear why you would only parse some of the ports for devices that have both sinks and sources. That should be explained better. And probably also in the header documentation.
I'll add both.
Signature · 6 lines
Sakari Ailus e-mail: [email protected] -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
Sakari Ailus
maintainerPATCH v12 8/26 rcar-vin: Use generic parser for parsing fwnode endpoints
In reply to Sakari AilusInstead of using driver implementation, use v4l2_async_notifier_parse_fwnode_endpoints() to parse the fwnode endpoints of the device.
--- drivers/media/platform/rcar-vin/rcar-core.c | 112 +++++++++------------------- drivers/media/platform/rcar-vin/rcar-dma.c | 10 +-- drivers/media/platform/rcar-vin/rcar-v4l2.c | 14 ++-- drivers/media/platform/rcar-vin/rcar-vin.h | 4 +- 4 files changed, 48 insertions(+), 92 deletions(-)
drivers/media/platform/rcar-vin/rcar-core.c +34 -78
@@ -21,6 +21,7 @@#include <linux/platform_device.h> #include <linux/pm_runtime.h> +#include <media/v4l2-async.h> #include <media/v4l2-fwnode.h> #include "rcar-vin.h"
@@ -77,14 +78,14 @@ static int rvin_digital_notify_complete(struct v4l2_async_notifier *notifier)int ret;/* Verify subdevices mbus format */ -if (!rvin_mbus_supported (&vin->digital)) { +if (!rvin_mbus_supported (vin->digital)) {vin_err (vin,"Unsupported media bus format for %s\n" , - vin->digital.subdev->name); + vin->digital->subdev->name);return -EINVAL ; }vin_dbg (vin,"Found media bus format for %s: %d\n" , - vin->digital.subdev->name, vin->digital.code); + vin->digital->subdev->name, vin->digital->code); ret =v4l2_device_register_subdev_nodes (&vin->v4l2_dev);if (ret <0 ) {
@@ -103,7 +104,7 @@ static void rvin_digital_notify_unbind(struct v4l2_async_notifier *notifier,vin_dbg (vin,"unbind digital subdev %s\n" , subdev->name);rvin_v4l2_remove (vin); - vin->digital.subdev =NULL ; + vin->digital->subdev =NULL ; } static int rvin_digital_notify_bound(struct v4l2_async_notifier *notifier,
@@ -120,117 +121,70 @@ static int rvin_digital_notify_bound(struct v4l2_async_notifier *notifier, ret =rvin_find_pad (subdev,MEDIA_PAD_FL_SOURCE );if (ret <0 )return ret; - vin->digital.source_pad = ret; + vin->digital->source_pad = ret; ret =rvin_find_pad (subdev,MEDIA_PAD_FL_SINK ); - vin->digital.sink_pad = ret <0 ?0 : ret; + vin->digital->sink_pad = ret <0 ?0 : ret; - vin->digital.subdev = subdev; + vin->digital->subdev = subdev;vin_dbg (vin,"bound subdev %s source pad: %u sink pad: %u\n" , - subdev->name, vin->digital.source_pad, - vin->digital.sink_pad); + subdev->name, vin->digital->source_pad, + vin->digital->sink_pad);return 0 ; } -static int rvin_digitial_parse_v4l2 (struct rvin_dev *vin, -struct device_node *ep, -struct v4l2_mbus_config *mbus_cfg) +static int rvin_digital_parse_v4l2 (struct device *dev, +struct v4l2_fwnode_endpoint *vep, +struct v4l2_async_subdev *asd) { -struct v4l2_fwnode_endpoint v4l2_ep; -int ret; +struct rvin_dev *vin =dev_get_drvdata (dev); +struct rvin_graph_entity *rvge = + container_of(asd, struct rvin_graph_entity, asd); - ret =v4l2_fwnode_endpoint_parse (of_fwnode_handle (ep), &v4l2_ep); -if (ret) { -vin_err (vin,"Could not parse v4l2 endpoint\n" ); -return -EINVAL ; - } +if (vep->base.port || vep->base.id) +return -ENOTCONN ; - mbus_cfg->type = v4l2_ep.bus_type; + rvge->mbus_cfg.type = vep->bus_type; -switch (mbus_cfg->type) { +switch (rvge->mbus_cfg.type) {case V4L2_MBUS_PARALLEL :vin_dbg (vin,"Found PARALLEL media bus\n" ); - mbus_cfg->flags = v4l2_ep.bus.parallel.flags; + rvge->mbus_cfg.flags = vep->bus.parallel.flags;break ;case V4L2_MBUS_BT656 :vin_dbg (vin,"Found BT656 media bus\n" ); - mbus_cfg->flags =0 ; + rvge->mbus_cfg.flags =0 ;break ;default :vin_err (vin,"Unknown media bus type\n" );return -EINVAL ; } -return 0 ; -} - -static int rvin_digital_graph_parse (struct rvin_dev *vin) -{ -struct device_node *ep, *np; -int ret; - - vin->digital.asd.match.fwnode.fwnode =NULL ; - vin->digital.subdev =NULL ; - -/* -* Port 0 id 0 is local digital input, try to get it. -* Not all instances can or will have this, that is OK -*/ - ep =of_graph_get_endpoint_by_regs (vin->dev->of_node,0 ,0 ); -if (!ep) -return 0 ; - - np =of_graph_get_remote_port_parent (ep); -if (!np) { -vin_err (vin,"No remote parent for digital input\n" ); -of_node_put (ep); -return -EINVAL ; - } -of_node_put (np); - - ret =rvin_digitial_parse_v4l2 (vin, ep, &vin->digital.mbus_cfg); -of_node_put (ep); -if (ret) -return ret; - - vin->digital.asd.match.fwnode.fwnode =of_fwnode_handle (np); - vin->digital.asd.match_type =V4L2_ASYNC_MATCH_FWNODE ; + vin->digital = rvge;return 0 ; }static int rvin_digital_graph_init (struct rvin_dev *vin) { -struct v4l2_async_subdev **subdevs =NULL ;int ret; - ret =rvin_digital_graph_parse (vin); + ret =v4l2_async_notifier_parse_fwnode_endpoints ( + vin->dev, &vin->notifier, +sizeof (struct rvin_graph_entity ), rvin_digital_parse_v4l2);if (ret)return ret; -if (!vin->digital.asd.match.fwnode.fwnode) { -vin_dbg (vin,"No digital subdevice found\n" ); -return -ENODEV ; - } - -/* Register the subdevices notifier. */ - subdevs =devm_kzalloc (vin->dev,sizeof (*subdevs),GFP_KERNEL ); -if (subdevs ==NULL ) -return -ENOMEM ; - - subdevs[0 ] = &vin->digital.asd; - -vin_dbg (vin,"Found digital subdevice %pOF\n" , -to_of_node (subdevs[0 ]->match.fwnode.fwnode)); +if (vin->digital) +vin_dbg (vin,"Found digital subdevice %pOF\n" , +to_of_node ( + vin->digital->asd.match.fwnode.fwnode)); - vin->notifier.num_subdevs =1 ; - vin->notifier.subdevs = subdevs; vin->notifier.bound = rvin_digital_notify_bound; vin->notifier.unbind = rvin_digital_notify_unbind; vin->notifier.complete = rvin_digital_notify_complete; - ret =v4l2_async_notifier_register (&vin->v4l2_dev, &vin->notifier);if (ret <0 ) {vin_err (vin,"Notifier registration failed\n" );
@@ -290,6 +244,8 @@ static int rcar_vin_probe(struct platform_device *pdev)if (ret)return ret; +platform_set_drvdata (pdev, vin); + ret =rvin_digital_graph_init (vin);if (ret <0 ) goto error;
@@ -297,11 +253,10 @@ static int rcar_vin_probe(struct platform_device *pdev)pm_suspend_ignore_children (&pdev->dev, true);pm_runtime_enable (&pdev->dev); -platform_set_drvdata (pdev, vin); -return 0 ; error:rvin_dma_remove (vin); +v4l2_async_notifier_release (&vin->notifier);return ret; }
@@ -313,6 +268,7 @@ static int rcar_vin_remove(struct platform_device *pdev)pm_runtime_disable (&pdev->dev);v4l2_async_notifier_unregister (&vin->notifier); +v4l2_async_notifier_release (&vin->notifier);rvin_dma_remove (vin);
drivers/media/platform/rcar-vin/rcar-dma.c +5 -5
@@ -183,7 +183,7 @@ static int rvin_setup(struct rvin_dev *vin)/* * Input interface */ -switch (vin->digital.code) { +switch (vin->digital->code) {case MEDIA_BUS_FMT_YUYV8_1X16 :/* BT.601/BT.1358 16bit YCbCr422 */ vnmc |=VNMC_INF_YUV16 ;
@@ -191,7 +191,7 @@ static int rvin_setup(struct rvin_dev *vin)break ;case MEDIA_BUS_FMT_UYVY8_2X8 :/* BT.656 8bit YCbCr422 or BT.601 8bit YCbCr422 */ - vnmc |= vin->digital.mbus_cfg.type ==V4L2_MBUS_BT656 ? + vnmc |= vin->digital->mbus_cfg.type ==V4L2_MBUS_BT656 ?VNMC_INF_YUV8_BT656 :VNMC_INF_YUV8_BT601 ; input_is_yuv = true;break ;
@@ -200,7 +200,7 @@ static int rvin_setup(struct rvin_dev *vin)break ;case MEDIA_BUS_FMT_UYVY10_2X10 :/* BT.656 10bit YCbCr422 or BT.601 10bit YCbCr422 */ - vnmc |= vin->digital.mbus_cfg.type ==V4L2_MBUS_BT656 ? + vnmc |= vin->digital->mbus_cfg.type ==V4L2_MBUS_BT656 ?VNMC_INF_YUV10_BT656 :VNMC_INF_YUV10_BT601 ; input_is_yuv = true;break ;
@@ -212,11 +212,11 @@ static int rvin_setup(struct rvin_dev *vin) dmr2 =VNDMR2_FTEV |VNDMR2_VLV (1 );/* Hsync Signal Polarity Select */ -if (!(vin->digital.mbus_cfg.flags &V4L2_MBUS_HSYNC_ACTIVE_LOW )) +if (!(vin->digital->mbus_cfg.flags &V4L2_MBUS_HSYNC_ACTIVE_LOW )) dmr2 |=VNDMR2_HPS ;/* Vsync Signal Polarity Select */ -if (!(vin->digital.mbus_cfg.flags &V4L2_MBUS_VSYNC_ACTIVE_LOW )) +if (!(vin->digital->mbus_cfg.flags &V4L2_MBUS_VSYNC_ACTIVE_LOW )) dmr2 |=VNDMR2_VPS ;/*
drivers/media/platform/rcar-vin/rcar-v4l2.c +7 -7
@@ -111,7 +111,7 @@ static int rvin_reset_format(struct rvin_dev *vin)struct v4l2_mbus_framefmt *mf = &fmt.format;int ret; - fmt.pad = vin->digital.source_pad; + fmt.pad = vin->digital->source_pad; ret =v4l2_subdev_call (vin_to_source (vin), pad, get_fmt,NULL , &fmt);if (ret)
@@ -172,13 +172,13 @@ static int __rvin_try_format_source(struct rvin_dev *vin, sd =vin_to_source (vin); -v4l2_fill_mbus_format (&format.format, pix, vin->digital.code); +v4l2_fill_mbus_format (&format.format, pix, vin->digital->code); pad_cfg =v4l2_subdev_alloc_pad_config (sd);if (pad_cfg ==NULL )return -ENOMEM ; - format.pad = vin->digital.source_pad; + format.pad = vin->digital->source_pad; field = pix->field;
@@ -555,7 +555,7 @@ static int rvin_enum_dv_timings(struct file *file, void *priv_fh,if (timings->pad)return -EINVAL ; - timings->pad = vin->digital.sink_pad; + timings->pad = vin->digital->sink_pad; ret =v4l2_subdev_call (sd, pad, enum_dv_timings, timings);
@@ -607,7 +607,7 @@ static int rvin_dv_timings_cap(struct file *file, void *priv_fh,if (cap->pad)return -EINVAL ; - cap->pad = vin->digital.sink_pad; + cap->pad = vin->digital->sink_pad; ret =v4l2_subdev_call (sd, pad, dv_timings_cap, cap);
@@ -625,7 +625,7 @@ static int rvin_g_edid(struct file *file, void *fh, struct v4l2_edid *edid)if (edid->pad)return -EINVAL ; - edid->pad = vin->digital.sink_pad; + edid->pad = vin->digital->sink_pad; ret =v4l2_subdev_call (sd, pad, get_edid, edid);
@@ -643,7 +643,7 @@ static int rvin_s_edid(struct file *file, void *fh, struct v4l2_edid *edid)if (edid->pad)return -EINVAL ; - edid->pad = vin->digital.sink_pad; + edid->pad = vin->digital->sink_pad; ret =v4l2_subdev_call (sd, pad, set_edid, edid);
drivers/media/platform/rcar-vin/rcar-vin.h +2 -2
@@ -126,7 +126,7 @@ struct rvin_dev {struct v4l2_device v4l2_dev;struct v4l2_ctrl_handler ctrl_handler;struct v4l2_async_notifier notifier; -struct rvin_graph_entity digital; +struct rvin_graph_entity *digital;struct mutex lock;struct vb2_queue queue;
@@ -145,7 +145,7 @@ struct rvin_dev {struct v4l2_rect compose; }; -#define vin_to_source (vin) vin->digital.subdev +#define vin_to_source (vin) ((vin)->digital->subdev)/* Debug */ #define vin_dbg(d, fmt, arg...) dev_dbg(d->dev, fmt, ##arg)
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 9/26 omap3isp: Fix check for our own sub-devices
In reply to Sakari AilusWe only want to link sub-devices that were bound to the async notifier the isp driver registered but there may be other sub-devices in the v4l2_device as well. Check for the correct async notifier.
--- drivers/media/platform/omap3isp/isp.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/media/platform/omap3isp/isp.c +1 -1
@@ -2155,7 +2155,7 @@ static int isp_subdev_notifier_complete(struct v4l2_async_notifier *async)return ret;list_for_each_entry (sd, &v4l2_dev->subdevs, list) { -if (!sd->asd) +if (sd->notifier != &isp->notifier)continue ; ret = isp_link_entity(isp, &sd->entity,
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 10/26 omap3isp: Print the name of the entity where no source pads could be found
In reply to Sakari AilusIf no source pads are found in an entity, print the name of the entity.
--- drivers/media/platform/omap3isp/isp.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
drivers/media/platform/omap3isp/isp.c +2 -2
@@ -1669,8 +1669,8 @@ static int isp_link_entity(break ; }if (i == entity->num_pads) { -dev_err (isp->dev,"%s: no source pad in external entity\n" , - __func__); +dev_err (isp->dev,"%s: no source pad in external entity %s\n" , + __func__, entity->name);return -EINVAL ; }
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 12/26 v4l: async: Introduce helpers for calling async ops callbacks
In reply to Sakari AilusAdd three helper functions to call async operations callbacks. Besides simplifying callbacks, this allows async notifiers to have no ops set, i.e. it can be left NULL.
--- drivers/media/v4l2-core/v4l2-async.c | 49 ++++++++++++++++++++++++++---------- include/media/v4l2-async.h | 1 + 2 files changed, 37 insertions(+), 13 deletions(-)
drivers/media/v4l2-core/v4l2-async.c +36 -13
@@ -25,6 +25,34 @@#include <media/v4l2-fwnode.h> #include <media/v4l2-subdev.h> +static int v4l2_async_notifier_call_bound (struct v4l2_async_notifier *n, +struct v4l2_subdev *subdev, +struct v4l2_async_subdev *asd) +{ +if (!n->ops || !n->ops->bound) +return 0 ; + +return n->ops->bound (n, subdev, asd); +} + +static void v4l2_async_notifier_call_unbind (struct v4l2_async_notifier *n, +struct v4l2_subdev *subdev, +struct v4l2_async_subdev *asd) +{ +if (!n->ops || !n->ops->unbind) +return ; + + n->ops->unbind (n, subdev, asd); +} + +static int v4l2_async_notifier_call_complete (struct v4l2_async_notifier *n) +{ +if (!n->ops || !n->ops->complete) +return 0 ; + +return n->ops->complete (n); +} +static bool match_i2c (struct v4l2_subdev *sd,struct v4l2_async_subdev *asd) {#if IS_ENABLED (CONFIG_I2C )
@@ -102,16 +130,13 @@ static int v4l2_async_match_notify(struct v4l2_async_notifier *notifier, {int ret; -if (notifier->ops->bound) { - ret = notifier->ops->bound (notifier, sd, asd); -if (ret <0 ) -return ret; - } + ret =v4l2_async_notifier_call_bound (notifier, sd, asd); +if (ret <0 ) +return ret; ret =v4l2_device_register_subdev (notifier->v4l2_dev, sd);if (ret <0 ) { -if (notifier->ops->unbind) - notifier->ops->unbind (notifier, sd, asd); +v4l2_async_notifier_call_unbind (notifier, sd, asd);return ret; }
@@ -123,8 +148,8 @@ static int v4l2_async_match_notify(struct v4l2_async_notifier *notifier,/* Move from the global subdevice list to notifier's done */ list_move (&sd->async_list, ¬ifier->done); -if (list_empty (¬ifier->waiting) && notifier->ops->complete) -return notifier->ops->complete (notifier); +if (list_empty (¬ifier->waiting)) +return v4l2_async_notifier_call_complete (notifier);return 0 ; }
@@ -210,8 +235,7 @@ void v4l2_async_notifier_unregister(struct v4l2_async_notifier *notifier)list_for_each_entry_safe (sd, tmp, ¬ifier->done, async_list) {v4l2_async_cleanup (sd); -if (notifier->ops->unbind) - notifier->ops->unbind (notifier, sd, sd->asd); +v4l2_async_notifier_call_unbind (notifier, sd, sd->asd); }mutex_unlock (&list_lock);
@@ -300,8 +324,7 @@ void v4l2_async_unregister_subdev(struct v4l2_subdev *sd)v4l2_async_cleanup (sd); -if (notifier->ops->unbind) - notifier->ops->unbind (notifier, sd, sd->asd); +v4l2_async_notifier_call_unbind (notifier, sd, sd->asd);mutex_unlock (&list_lock); }
include/media/v4l2-async.h +1 -0
@@ -164,4 +164,5 @@ int v4l2_async_register_subdev(struct v4l2_subdev *sd);* @sd: pointer to &struct v4l2_subdev */ void v4l2_async_unregister_subdev (struct v4l2_subdev *sd); +#endif
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 14/26 v4l: async: Allow async notifier register call succeed with no subdevs
In reply to Sakari AilusThe information on how many async sub-devices would be bindable to a notifier is typically dependent on information from platform firmware and it's not driver's business to be aware of that.
Many V4L2 main drivers are perfectly usable (and useful) without async sub-devices and so if there aren't any around, just proceed call the notifier's complete callback immediately without registering the notifier itself.
If a driver needs to check whether there are async sub-devices available, it can be done by inspecting the notifier's num_subdevs field which tells the number of async sub-devices.
--- drivers/media/v4l2-core/v4l2-async.c | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-)
drivers/media/v4l2-core/v4l2-async.c +4 -2
@@ -170,14 +170,16 @@ int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev,struct v4l2_async_subdev *asd;int i; -if (!v4l2_dev || !notifier->num_subdevs || - notifier->num_subdevs >V4L2_MAX_SUBDEVS ) +if (!v4l2_dev || notifier->num_subdevs >V4L2_MAX_SUBDEVS )return -EINVAL ; notifier->v4l2_dev = v4l2_dev;INIT_LIST_HEAD (¬ifier->waiting);INIT_LIST_HEAD (¬ifier->done); +if (!notifier->num_subdevs) +return v4l2_async_notifier_call_complete (notifier); +for (i =0 ; i < notifier->num_subdevs; i++) { asd = notifier->subdevs[i];
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 15/26 v4l: async: Allow binding notifiers to sub-devices
In reply to Sakari AilusRegistering a notifier has required the knowledge of struct v4l2_device for the reason that sub-devices generally are registered to the v4l2_device (as well as the media device, also available through v4l2_device).
This information is not available for sub-device drivers at probe time.
What this patch does is that it allows registering notifiers without having v4l2_device around. Instead the sub-device pointer is stored in the notifier. Once the sub-device of the driver that registered the notifier is registered, the notifier will gain the knowledge of the v4l2_device, and the binding of async sub-devices from the sub-device driver's notifier may proceed.
The root notifier's complete callback is only called when all sub-device notifiers are completed.
--- drivers/media/v4l2-core/v4l2-async.c | 219 ++++++++++++++++++++++++++++++----- include/media/v4l2-async.h | 16 ++- 2 files changed, 204 insertions(+), 31 deletions(-)
drivers/media/v4l2-core/v4l2-async.c +189 -30
@@ -53,6 +53,10 @@ static int v4l2_async_notifier_call_complete(struct v4l2_async_notifier *n)return n->ops->complete (n); } +static int v4l2_async_match_notify (struct v4l2_async_notifier *notifier, +struct v4l2_subdev *sd, +struct v4l2_async_subdev *asd); +static bool match_i2c (struct v4l2_subdev *sd,struct v4l2_async_subdev *asd) {#if IS_ENABLED (CONFIG_I2C )
@@ -124,14 +128,128 @@ static struct v4l2_async_subdev *v4l2_async_find_match(return NULL ; } +/* Find the sub-device notifier registered by a sub-device driver. */ +static struct v4l2_async_notifier *v4l2_async_find_subdev_notifier ( +struct v4l2_subdev *sd) +{ +struct v4l2_async_notifier *n; + +list_for_each_entry (n, ¬ifier_list, list) +if (n->sd == sd) +return n; + +return NULL ; +} + +/* Return true if all sub-device notifiers are complete, false otherwise. */ +static bool v4l2_async_subdev_notifiers_complete ( +struct v4l2_async_notifier *notifier) +{ +struct v4l2_subdev *sd; + +if (!list_empty (¬ifier->waiting)) +return false; + +list_for_each_entry (sd, ¬ifier->done, async_list) { +struct v4l2_async_notifier *subdev_notifier = +v4l2_async_find_subdev_notifier (sd); + +if (!subdev_notifier) +continue ; + +if (!v4l2_async_subdev_notifiers_complete (subdev_notifier)) +return false; + } + +return true; +} + +/* Get v4l2_device related to the notifier if one can be found. */ +static struct v4l2_device *v4l2_async_notifier_find_v4l2_dev ( +struct v4l2_async_notifier *notifier) +{ +while (notifier->parent) + notifier = notifier->parent; + +return notifier->v4l2_dev; +} + +/* Test all async sub-devices in a notifier for a match. */ +static int v4l2_async_notifier_try_all_subdevs ( +struct v4l2_async_notifier *notifier) +{ +struct v4l2_subdev *sd; + +if (!v4l2_async_notifier_find_v4l2_dev (notifier)) +return 0 ; + +again: +list_for_each_entry (sd, &subdev_list, async_list) { +struct v4l2_async_subdev *asd; +int ret; + + asd =v4l2_async_find_match (notifier, sd); +if (!asd) +continue ; + + ret =v4l2_async_match_notify (notifier, sd, asd); +if (ret <0 ) +return ret; + +/* +* v4l2_async_match_notify() may lead to registering a +* new notifier and thus changing the async subdevs +* list. In order to proceed safely from here, restart +* parsing the list from the beginning. +*/ + goto again; + } + +return 0 ; +} + +/* Try completing a notifier. */ +static int v4l2_async_notifier_try_complete ( +struct v4l2_async_notifier *notifier) +{ +do { +int ret; + +/* Any local async sub-devices left? */ +if (!list_empty (¬ifier->waiting)) +return 0 ; + +/* +* Any sub-device notifiers waiting for async subdevs +* to be bound? +*/ +if (!v4l2_async_subdev_notifiers_complete (notifier)) +return 0 ; + +/* Proceed completing the notifier */ + ret =v4l2_async_notifier_call_complete (notifier); +if (ret <0 ) +return ret; + +/* +* Obtain notifier's parent. If there is one, repeat +* the process, otherwise we're done here. +*/ + }while ((notifier = notifier->parent)); + +return 0 ; +} +static int v4l2_async_match_notify (struct v4l2_async_notifier *notifier,struct v4l2_subdev *sd,struct v4l2_async_subdev *asd) { +struct v4l2_async_notifier *subdev_notifier;int ret; - ret =v4l2_device_register_subdev (notifier->v4l2_dev, sd); -if (ret <0 ) + ret =v4l2_device_register_subdev ( +v4l2_async_notifier_find_v4l2_dev (notifier), sd); +if (ret)return ret; ret =v4l2_async_notifier_call_bound (notifier, sd, asd);
@@ -148,10 +266,20 @@ static int v4l2_async_match_notify(struct v4l2_async_notifier *notifier,/* Move from the global subdevice list to notifier's done */ list_move (&sd->async_list, ¬ifier->done); -if (list_empty (¬ifier->waiting)) -return v4l2_async_notifier_call_complete (notifier); +/* +* See if the sub-device has a notifier. If it does, proceed +* with checking for its async sub-devices. +*/ + subdev_notifier =v4l2_async_find_subdev_notifier (sd); +if (subdev_notifier && !subdev_notifier->parent) { + subdev_notifier->parent = notifier; + ret =v4l2_async_notifier_try_all_subdevs (subdev_notifier); +if (ret) +return ret; + } -return 0 ; +/* Try completing the notifier and its parent(s). */ +return v4l2_async_notifier_try_complete (notifier); }static void v4l2_async_cleanup (struct v4l2_subdev *sd)
@@ -163,17 +291,15 @@ static void v4l2_async_cleanup(struct v4l2_subdev *sd) sd->dev =NULL ; } -int v4l2_async_notifier_register (struct v4l2_device *v4l2_dev, -struct v4l2_async_notifier *notifier) +static int __v4l2_async_notifier_register (struct v4l2_async_notifier *notifier) { -struct v4l2_subdev *sd, *tmp;struct v4l2_async_subdev *asd; +int ret;int i; -if (!v4l2_dev || notifier->num_subdevs >V4L2_MAX_SUBDEVS ) +if (notifier->num_subdevs >V4L2_MAX_SUBDEVS )return -EINVAL ; - notifier->v4l2_dev = v4l2_dev;INIT_LIST_HEAD (¬ifier->waiting);INIT_LIST_HEAD (¬ifier->done);
@@ -200,18 +326,10 @@ int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev,mutex_lock (&list_lock); -list_for_each_entry_safe (sd, tmp, &subdev_list, async_list) { -int ret; - - asd =v4l2_async_find_match (notifier, sd); -if (!asd) -continue ; - - ret =v4l2_async_match_notify (notifier, sd, asd); -if (ret <0 ) { -mutex_unlock (&list_lock); -return ret; - } + ret =v4l2_async_notifier_try_all_subdevs (notifier); +if (ret) { +mutex_unlock (&list_lock); +return ret; }/* Keep also completed notifiers on the list */
@@ -221,29 +339,70 @@ int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev,return 0 ; } + +int v4l2_async_notifier_register (struct v4l2_device *v4l2_dev, +struct v4l2_async_notifier *notifier) +{ +if (WARN_ON (!v4l2_dev || notifier->sd)) +return -EINVAL ; + + notifier->v4l2_dev = v4l2_dev; + +return __v4l2_async_notifier_register (notifier); +}EXPORT_SYMBOL (v4l2_async_notifier_register); -void v4l2_async_notifier_unregister (struct v4l2_async_notifier *notifier) +int v4l2_async_subdev_notifier_register (struct v4l2_subdev *sd, +struct v4l2_async_notifier *notifier) { -struct v4l2_subdev *sd, *tmp; +if (WARN_ON (!sd || notifier->v4l2_dev)) +return -EINVAL ; -if (!notifier->v4l2_dev) -return ; + notifier->sd = sd; -mutex_lock (&list_lock); +return __v4l2_async_notifier_register (notifier); +} +EXPORT_SYMBOL (v4l2_async_subdev_notifier_register); -list_del (¬ifier->list); +/* Unbind all sub-devices in the notifier tree. */ +static void v4l2_async_notifier_unbind_all_subdevs ( +struct v4l2_async_notifier *notifier) +{ +struct v4l2_subdev *sd, *tmp;list_for_each_entry_safe (sd, tmp, ¬ifier->done, async_list) { +struct v4l2_async_notifier *subdev_notifier = +v4l2_async_find_subdev_notifier (sd); + +if (subdev_notifier) +v4l2_async_notifier_unbind_all_subdevs (subdev_notifier); +v4l2_async_cleanup (sd);v4l2_async_notifier_call_unbind (notifier, sd, sd->asd); - } -mutex_unlock (&list_lock); +list_del (&sd->async_list); +list_add (&sd->async_list, &subdev_list); + } + notifier->parent =NULL ; + notifier->sd =NULL ; notifier->v4l2_dev =NULL ; } + +void v4l2_async_notifier_unregister (struct v4l2_async_notifier *notifier) +{ +if (!notifier->v4l2_dev && !notifier->sd) +return ; + +mutex_lock (&list_lock); + +v4l2_async_notifier_unbind_all_subdevs (notifier); + +list_del (¬ifier->list); + +mutex_unlock (&list_lock); +}EXPORT_SYMBOL (v4l2_async_notifier_unregister);void v4l2_async_notifier_release (struct v4l2_async_notifier *notifier)
include/media/v4l2-async.h +15 -1
@@ -102,7 +102,9 @@ struct v4l2_async_notifier_operations {* @num_subdevs: number of subdevices used in the subdevs array * @max_subdevs: number of subdevices allocated in the subdevs array * @subdevs: array of pointers to subdevice descriptors -* @v4l2_dev: pointer to struct v4l2_device +* @v4l2_dev: v4l2_device of the root notifier, NULL otherwise +* @sd: sub-device that registered the notifier, NULL otherwise +* @parent: parent notifier * @waiting: list of struct v4l2_async_subdev, waiting for their drivers * @done: list of struct v4l2_subdev, already probed * @list: member in a global list of notifiers
@@ -113,6 +115,8 @@ struct v4l2_async_notifier {unsigned int max_subdevs;struct v4l2_async_subdev **subdevs;struct v4l2_device *v4l2_dev; +struct v4l2_subdev *sd; +struct v4l2_async_notifier *parent;struct list_head waiting;struct list_head done;struct list_head list;
@@ -128,6 +132,16 @@ int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev, struct v4l2_async_notifier *notifier);/** +* v4l2_async_subdev_notifier_register - registers a subdevice asynchronous +* notifier for a sub-device +* +* @sd: pointer to &struct v4l2_subdev +* @notifier: pointer to &struct v4l2_async_notifier +*/ +int v4l2_async_subdev_notifier_register (struct v4l2_subdev *sd, +struct v4l2_async_notifier *notifier); + +/** * v4l2_async_notifier_unregister - unregisters a subdevice asynchronous notifier * * @notifier: pointer to &struct v4l2_async_notifier
Signature · 1 line
2.11.0
A message that is not in the archive (sent off-list or not yet received): 20170912134200.19556-16-sakari.ailus-VuQAYsv1563Yd54FQh9/[email protected]
Hans Verkuil
Acked-byRe: [PATCH v12 15/26] v4l: async: Allow binding notifiers to sub-devices
Quoted 14 lines · Sakari Ailus
Registering a notifier has required the knowledge of struct
v4l2_devicefor the reason that sub-devices generally are registered to thev4l2_device(as well as the media device, also available throughv4l2_device).This information is not available for sub-device drivers at probe time.
What this patch does is that it allows registering notifiers without having
v4l2_devicearound. Instead the sub-device pointer is stored in the notifier. Once the sub-device of the driver that registered the notifier is registered, the notifier will gain the knowledge of thev4l2_device, and the binding of async sub-devices from the sub-device driver's notifier may proceed.
Quoted 4 lines
The root notifier's complete callback is only called when all sub-device notifiers are completed.
Just two small comments (see below).
After changing those (the first is up to you) you can add my:
Regards,
Hans
Quoted 44 lines
--- drivers/media/v4l2-core/v4l2-async.c | 219 ++++++++++++++++++++++++++++++----- include/media/v4l2-async.h | 16 ++- 2 files changed, 204 insertions(+), 31 deletions(-)drivers/media/v4l2-core/v4l2-async.c +24
-0@@ -53,6 +53,10 @@ static int v4l2_async_notifier_call_complete(struct v4l2_async_notifier *n)return n->ops->complete (n); } +static int v4l2_async_match_notify (struct v4l2_async_notifier *notifier, +struct v4l2_subdev *sd, +struct v4l2_async_subdev *asd); +static bool match_i2c (struct v4l2_subdev *sd,struct v4l2_async_subdev *asd) {#if IS_ENABLED (CONFIG_I2C )@@ -124,14 +128,128 @@ static struct v4l2_async_subdev *v4l2_async_find_match(return NULL ; } +/* Find the sub-device notifier registered by a sub-device driver. */ +static struct v4l2_async_notifier *v4l2_async_find_subdev_notifier ( +struct v4l2_subdev *sd) +{ +struct v4l2_async_notifier *n; + +list_for_each_entry (n, ¬ifier_list, list) +if (n->sd == sd) +return n; + +return NULL ; +} + +/* Return true if all sub-device notifiers are complete, false otherwise. */ +static bool v4l2_async_subdev_notifiers_complete ( +struct v4l2_async_notifier *notifier) +{ +struct v4l2_subdev *sd; + +if (!list_empty (¬ifier->waiting))
drivers/media/v4l2-core/v4l2-async.c static struct v4l2_async_subdev *v4l2_async_find_match( · line 160
Quoted 10 lines
drivers/media/v4l2-core/v4l2-async.c +10
-0+return false; + +list_for_each_entry (sd, ¬ifier->done, async_list) { +struct v4l2_async_notifier *subdev_notifier = +v4l2_async_find_subdev_notifier (sd); + +if (!subdev_notifier) +continue ; + +if (!v4l2_async_subdev_notifiers_complete (subdev_notifier))
I think it is better to change this to:
if (subdev_notifier && !v4l2_async_subdev_notifiers_complete(subdev_notifier))
and drop this if..continue above. That's a bit overkill in this simple case.
It's up to you, though.
Quoted 68 lines
drivers/media/v4l2-core/v4l2-async.c +68
-0+return false; + } + +return true; +} + +/* Get v4l2_device related to the notifier if one can be found. */ +static struct v4l2_device *v4l2_async_notifier_find_v4l2_dev ( +struct v4l2_async_notifier *notifier) +{ +while (notifier->parent) + notifier = notifier->parent; + +return notifier->v4l2_dev; +} + +/* Test all async sub-devices in a notifier for a match. */ +static int v4l2_async_notifier_try_all_subdevs ( +struct v4l2_async_notifier *notifier) +{ +struct v4l2_subdev *sd; + +if (!v4l2_async_notifier_find_v4l2_dev (notifier)) +return 0 ; + +again: +list_for_each_entry (sd, &subdev_list, async_list) { +struct v4l2_async_subdev *asd; +int ret; + + asd =v4l2_async_find_match (notifier, sd); +if (!asd) +continue ; + + ret =v4l2_async_match_notify (notifier, sd, asd); +if (ret <0 ) +return ret; + +/* +* v4l2_async_match_notify() may lead to registering a +* new notifier and thus changing the async subdevs +* list. In order to proceed safely from here, restart +* parsing the list from the beginning. +*/ + goto again; + } + +return 0 ; +} + +/* Try completing a notifier. */ +static int v4l2_async_notifier_try_complete ( +struct v4l2_async_notifier *notifier) +{ + do { + int ret; + + /* Any local async sub-devices left? */ + if (!list_empty(¬ifier->waiting)) + return 0; + + /* + * Any sub-device notifiers waiting for async subdevs + * to be bound? + */ + if (!v4l2_async_subdev_notifiers_complete(notifier)) + return 0; +
drivers/media/v4l2-core/v4l2-async.c static struct v4l2_async_subdev *v4l2_async_find_match( · line 238
Quoted 10 lines
drivers/media/v4l2-core/v4l2-async.c +10
-0+/* Proceed completing the notifier */ + ret =v4l2_async_notifier_call_complete (notifier); +if (ret <0 ) +return ret; + +/* +* Obtain notifier's parent. If there is one, repeat +* the process, otherwise we're done here. +*/ + }while ((notifier = notifier->parent));
I'd change this to:
notifier = notifier->parent; } while (notifier);
Assignment in a condition is frowned upon, and there is no need to do that here.
Quoted 198 lines
drivers/media/v4l2-core/v4l2-async.c +77
-30+ +return 0 ; +} +static int v4l2_async_match_notify (struct v4l2_async_notifier *notifier,struct v4l2_subdev *sd,struct v4l2_async_subdev *asd) { +struct v4l2_async_notifier *subdev_notifier;int ret; - ret =v4l2_device_register_subdev (notifier->v4l2_dev, sd); -if (ret <0 ) + ret =v4l2_device_register_subdev ( +v4l2_async_notifier_find_v4l2_dev (notifier), sd); +if (ret)return ret; ret =v4l2_async_notifier_call_bound (notifier, sd, asd);@@ -148,10 +266,20 @@ static int v4l2_async_match_notify(struct v4l2_async_notifier *notifier,/* Move from the global subdevice list to notifier's done */ list_move (&sd->async_list, ¬ifier->done); -if (list_empty (¬ifier->waiting)) -return v4l2_async_notifier_call_complete (notifier); +/* +* See if the sub-device has a notifier. If it does, proceed +* with checking for its async sub-devices. +*/ + subdev_notifier =v4l2_async_find_subdev_notifier (sd); +if (subdev_notifier && !subdev_notifier->parent) { + subdev_notifier->parent = notifier; + ret =v4l2_async_notifier_try_all_subdevs (subdev_notifier); +if (ret) +return ret; + } -return 0 ; +/* Try completing the notifier and its parent(s). */ +return v4l2_async_notifier_try_complete (notifier); }static void v4l2_async_cleanup (struct v4l2_subdev *sd)@@ -163,17 +291,15 @@ static void v4l2_async_cleanup(struct v4l2_subdev *sd) sd->dev =NULL ; } -int v4l2_async_notifier_register (struct v4l2_device *v4l2_dev, -struct v4l2_async_notifier *notifier) +static int __v4l2_async_notifier_register (struct v4l2_async_notifier *notifier) { -struct v4l2_subdev *sd, *tmp;struct v4l2_async_subdev *asd; +int ret;int i; -if (!v4l2_dev || notifier->num_subdevs >V4L2_MAX_SUBDEVS ) +if (notifier->num_subdevs >V4L2_MAX_SUBDEVS )return -EINVAL ; - notifier->v4l2_dev = v4l2_dev;INIT_LIST_HEAD (¬ifier->waiting);INIT_LIST_HEAD (¬ifier->done);@@ -200,18 +326,10 @@ int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev,mutex_lock (&list_lock); -list_for_each_entry_safe (sd, tmp, &subdev_list, async_list) { -int ret; - - asd =v4l2_async_find_match (notifier, sd); -if (!asd) -continue ; - - ret =v4l2_async_match_notify (notifier, sd, asd); -if (ret <0 ) { -mutex_unlock (&list_lock); -return ret; - } + ret =v4l2_async_notifier_try_all_subdevs (notifier); +if (ret) { +mutex_unlock (&list_lock); +return ret; }/* Keep also completed notifiers on the list */ @@ -221,29 +339,70 @@ int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev,return 0 ; } + +int v4l2_async_notifier_register (struct v4l2_device *v4l2_dev, +struct v4l2_async_notifier *notifier) +{ +if (WARN_ON (!v4l2_dev || notifier->sd)) +return -EINVAL ; + + notifier->v4l2_dev = v4l2_dev; + +return __v4l2_async_notifier_register (notifier); +}EXPORT_SYMBOL (v4l2_async_notifier_register); -void v4l2_async_notifier_unregister (struct v4l2_async_notifier *notifier) +int v4l2_async_subdev_notifier_register (struct v4l2_subdev *sd, +struct v4l2_async_notifier *notifier) { -struct v4l2_subdev *sd, *tmp; +if (WARN_ON (!sd || notifier->v4l2_dev)) +return -EINVAL ; -if (!notifier->v4l2_dev) -return ; + notifier->sd = sd; -mutex_lock (&list_lock); +return __v4l2_async_notifier_register (notifier); +} +EXPORT_SYMBOL (v4l2_async_subdev_notifier_register); -list_del (¬ifier->list); +/* Unbind all sub-devices in the notifier tree. */ +static void v4l2_async_notifier_unbind_all_subdevs ( +struct v4l2_async_notifier *notifier) +{ +struct v4l2_subdev *sd, *tmp;list_for_each_entry_safe (sd, tmp, ¬ifier->done, async_list) { +struct v4l2_async_notifier *subdev_notifier = +v4l2_async_find_subdev_notifier (sd); + +if (subdev_notifier) +v4l2_async_notifier_unbind_all_subdevs (subdev_notifier); +v4l2_async_cleanup (sd);v4l2_async_notifier_call_unbind (notifier, sd, sd->asd); - } -mutex_unlock (&list_lock); +list_del (&sd->async_list); +list_add (&sd->async_list, &subdev_list); + } + notifier->parent =NULL ; + notifier->sd =NULL ; notifier->v4l2_dev =NULL ; } + +void v4l2_async_notifier_unregister (struct v4l2_async_notifier *notifier) +{ +if (!notifier->v4l2_dev && !notifier->sd) +return ; + +mutex_lock (&list_lock); + +v4l2_async_notifier_unbind_all_subdevs (notifier); + +list_del (¬ifier->list); + +mutex_unlock (&list_lock); +}EXPORT_SYMBOL (v4l2_async_notifier_unregister);void v4l2_async_notifier_release (struct v4l2_async_notifier *notifier)include/media/v4l2-async.h +8
-1@@ -102,7 +102,9 @@ struct v4l2_async_notifier_operations {* @num_subdevs: number of subdevices used in the subdevs array * @max_subdevs: number of subdevices allocated in the subdevs array * @subdevs: array of pointers to subdevice descriptors -* @v4l2_dev: pointer to struct v4l2_device +* @v4l2_dev: v4l2_device of the root notifier, NULL otherwise +* @sd: sub-device that registered the notifier, NULL otherwise +* @parent: parent notifier * @waiting: list of struct v4l2_async_subdev, waiting for their drivers * @done: list of struct v4l2_subdev, already probed * @list: member in a global list of notifiers @@ -113,6 +115,8 @@ struct v4l2_async_notifier {unsigned int max_subdevs;struct v4l2_async_subdev **subdevs;struct v4l2_device *v4l2_dev; +struct v4l2_subdev *sd; +struct v4l2_async_notifier *parent;struct list_head waiting;struct list_head done;struct list_head list;@@ -128,6 +132,16 @@ int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev, struct v4l2_async_notifier *notifier);/** +* v4l2_async_subdev_notifier_register - registers a subdevice asynchronous +* notifier for a sub-device +*
include/media/v4l2-async.h int v4l2_async_notifier_register(struct v4l2_device *v4l2_dev, · line 147
Quoted 10 lines
include/media/v4l2-async.h +7
-0+* @sd: pointer to &struct v4l2_subdev +* @notifier: pointer to &struct v4l2_async_notifier +*/ +int v4l2_async_subdev_notifier_register (struct v4l2_subdev *sd, +struct v4l2_async_notifier *notifier); + +/** * v4l2_async_notifier_unregister - unregisters a subdevice asynchronous notifier * * @notifier: pointer to &struct v4l2_async_notifier
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): 575bf15b-62d2-3a51-d550-d462578471f7-qWit8jRvyhVmR6Xm/[email protected]
Re: [PATCH v12 15/26] v4l: async: Allow binding notifiers to sub-devices
Hi Hans,
Quoted 18 lines · Hans Verkuil
Quoted 17 lines · Sakari Ailus
Registering a notifier has required the knowledge of struct
v4l2_devicefor the reason that sub-devices generally are registered to thev4l2_device(as well as the media device, also available throughv4l2_device).This information is not available for sub-device drivers at probe time.
What this patch does is that it allows registering notifiers without having
v4l2_devicearound. Instead the sub-device pointer is stored in the notifier. Once the sub-device of the driver that registered the notifier is registered, the notifier will gain the knowledge of thev4l2_device, and the binding of async sub-devices from the sub-device driver's notifier may proceed.The root notifier's complete callback is only called when all sub-device notifiers are completed.
Quoted 7 lines
Quoted 1 line
Just two small comments (see below).
After changing those (the first is up to you) you can add my:
Acked-by Hans Verkuil <[email protected]>
Thanks; please see my comments below.
...
Quoted 20 lines
Quoted 7 lines
drivers/media/v4l2-core/v4l2-async.c +7
-0+/* Return true if all sub-device notifiers are complete, false otherwise. */ +static bool v4l2_async_subdev_notifiers_complete ( +struct v4l2_async_notifier *notifier) +{ +struct v4l2_subdev *sd; + +if (!list_empty (¬ifier->waiting))drivers/media/v4l2-core/v4l2-async.c static struct v4l2_async_subdev *v4l2_async_find_match( · line 160
Quoted 10 lines
drivers/media/v4l2-core/v4l2-async.c +10
-0+return false; + +list_for_each_entry (sd, ¬ifier->done, async_list) { +struct v4l2_async_notifier *subdev_notifier = +v4l2_async_find_subdev_notifier (sd); + +if (!subdev_notifier) +continue ; + +if (!v4l2_async_subdev_notifiers_complete (subdev_notifier))I think it is better to change this to:
Quoted 6 lines
if (subdev_notifier && !v4l2_async_subdev_notifiers_complete(subdev_notifier))and drop this if..continue above. That's a bit overkill in this simple case.
It's up to you, though.
Yes, makes sense.
...
Quoted 31 lines
Quoted 18 lines
drivers/media/v4l2-core/v4l2-async.c +18
-0+/* Try completing a notifier. */ +static int v4l2_async_notifier_try_complete ( +struct v4l2_async_notifier *notifier) +{ + do { + int ret; + + /* Any local async sub-devices left? */ + if (!list_empty(¬ifier->waiting)) + return 0; + + /* + * Any sub-device notifiers waiting for async subdevs + * to be bound? + */ + if (!v4l2_async_subdev_notifiers_complete(notifier)) + return 0; +drivers/media/v4l2-core/v4l2-async.c static struct v4l2_async_subdev *v4l2_async_find_match( · line 238
Quoted 10 lines
drivers/media/v4l2-core/v4l2-async.c +10
-0+/* Proceed completing the notifier */ + ret =v4l2_async_notifier_call_complete (notifier); +if (ret <0 ) +return ret; + +/* +* Obtain notifier's parent. If there is one, repeat +* the process, otherwise we're done here. +*/ + }while ((notifier = notifier->parent));I'd change this to:
Quoted 5 lines
notifier = notifier->parent; } while (notifier);Assignment in a condition is frowned upon, and there is no need to do that here.
Wouldn't that equally apply to any statement with side effects? In other words, what you're suggesting for patch 19? :-)
Signature · 8 lines
Regards, Sakari Ailus e-mail: [email protected] -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): 20170913082901.fbxxphn7s3ljn3mc-S+BSfZ9RZZmRSg0ZkenSGLdO1Tsj/[email protected]
Re: [PATCH v12 15/26] v4l: async: Allow binding notifiers to sub-devices
Quoted 95 lines · Sakari Ailus
Hi Hans,
Quoted 18 lines · Hans Verkuil
Quoted 17 lines · Sakari Ailus
Registering a notifier has required the knowledge of struct
v4l2_devicefor the reason that sub-devices generally are registered to thev4l2_device(as well as the media device, also available throughv4l2_device).This information is not available for sub-device drivers at probe time.
What this patch does is that it allows registering notifiers without having
v4l2_devicearound. Instead the sub-device pointer is stored in the notifier. Once the sub-device of the driver that registered the notifier is registered, the notifier will gain the knowledge of thev4l2_device, and the binding of async sub-devices from the sub-device driver's notifier may proceed.The root notifier's complete callback is only called when all sub-device notifiers are completed.
Quoted 7 lines
Quoted 1 line
Just two small comments (see below).
After changing those (the first is up to you) you can add my:
Acked-by Hans Verkuil <[email protected]>Thanks; please see my comments below.
...
Quoted 20 lines
Quoted 7 lines
drivers/media/v4l2-core/v4l2-async.c +7
-0+/* Return true if all sub-device notifiers are complete, false otherwise. */ +static bool v4l2_async_subdev_notifiers_complete ( +struct v4l2_async_notifier *notifier) +{ +struct v4l2_subdev *sd; + +if (!list_empty (¬ifier->waiting))drivers/media/v4l2-core/v4l2-async.c static struct v4l2_async_subdev *v4l2_async_find_match( · line 160
Quoted 10 lines
drivers/media/v4l2-core/v4l2-async.c +10
-0+return false; + +list_for_each_entry (sd, ¬ifier->done, async_list) { +struct v4l2_async_notifier *subdev_notifier = +v4l2_async_find_subdev_notifier (sd); + +if (!subdev_notifier) +continue ; + +if (!v4l2_async_subdev_notifiers_complete (subdev_notifier))I think it is better to change this to:
Quoted 6 lines
if (subdev_notifier && !v4l2_async_subdev_notifiers_complete(subdev_notifier))and drop this if..continue above. That's a bit overkill in this simple case.
It's up to you, though.
Yes, makes sense.
...
Quoted 31 lines
Quoted 18 lines
drivers/media/v4l2-core/v4l2-async.c +18
-0+/* Try completing a notifier. */ +static int v4l2_async_notifier_try_complete ( +struct v4l2_async_notifier *notifier) +{ + do { + int ret; + + /* Any local async sub-devices left? */ + if (!list_empty(¬ifier->waiting)) + return 0; + + /* + * Any sub-device notifiers waiting for async subdevs + * to be bound? + */ + if (!v4l2_async_subdev_notifiers_complete(notifier)) + return 0; +drivers/media/v4l2-core/v4l2-async.c static struct v4l2_async_subdev *v4l2_async_find_match( · line 238
Quoted 10 lines
drivers/media/v4l2-core/v4l2-async.c +10
-0+/* Proceed completing the notifier */ + ret =v4l2_async_notifier_call_complete (notifier); +if (ret <0 ) +return ret; + +/* +* Obtain notifier's parent. If there is one, repeat +* the process, otherwise we're done here. +*/ + }while ((notifier = notifier->parent));I'd change this to:
Quoted 8 lines
Quoted 5 lines
notifier = notifier->parent; } while (notifier);Assignment in a condition is frowned upon, and there is no need to do that here.
Wouldn't that equally apply to any statement with side effects? In other words, what you're suggesting for patch 19? :-)
I don't like it there either, but rewriting that would make the code quite a bit longer and you enter a gray area between 'no side-effects' and 'readability'. In cases like that I tend to accept the preference of the author of the code.
In the case of this do...while the 'no side-effects' version is just as readable if not more so than the 'side-effect' version.
At least, that's my reasoning.
Regards,
Hans
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
Sakari Ailus
maintainerPATCH v12 20/26 v4l: fwnode: Add convenience function for parsing common external refs
In reply to Sakari AilusAdd v4l2_fwnode_parse_reference_sensor_common for parsing common sensor properties that refer to adjacent devices such as flash or lens driver chips.
As this is an association only, there's little a regular driver needs to know about these devices as such.
--- drivers/media/v4l2-core/v4l2-fwnode.c | 35 +++++++++++++++++++++++++++++++++++ include/media/v4l2-async.h | 3 ++- include/media/v4l2-fwnode.h | 21 +++++++++++++++++++++ 3 files changed, 58 insertions(+), 1 deletion(-)
drivers/media/v4l2-core/v4l2-fwnode.c +35 -0
@@ -712,6 +712,41 @@ static int v4l2_fwnode_reference_parse_int_props(return ret; } +int v4l2_async_notifier_parse_fwnode_sensor_common ( +struct device *dev,struct v4l2_async_notifier *notifier) +{ +static const char *led_props[] = {"led" }; +static const struct { +const char *name; +const char **props; +unsigned int nprops; + } props[] = { + {"flash-leds" , led_props,ARRAY_SIZE (led_props) }, + {"lens-focus" ,NULL ,0 }, + }; +unsigned int i; + +for (i =0 ; i <ARRAY_SIZE (props); i++) { +int ret; + +if (props[i].props &&is_acpi_node (dev_fwnode (dev))) + ret =v4l2_fwnode_reference_parse_int_props ( + dev, notifier, props[i].name, + props[i].props, props[i].nprops); +else + ret =v4l2_fwnode_reference_parse ( + dev, notifier, props[i].name); +if (ret && ret != -ENOENT ) { +dev_warn (dev,"parsing property \"%s\" failed (%d)\n" , + props[i].name, ret); +return ret; + } + } + +return 0 ; +} +EXPORT_SYMBOL_GPL (v4l2_async_notifier_parse_fwnode_sensor_common); +MODULE_LICENSE ("GPL" );MODULE_AUTHOR ("Sakari Ailus <[email protected]>" );MODULE_AUTHOR ("Sylwester Nawrocki <[email protected]>" );
include/media/v4l2-async.h +2 -1
@@ -155,7 +155,8 @@ void v4l2_async_notifier_unregister(struct v4l2_async_notifier *notifier);* Release memory resources related to a notifier, including the async * sub-devices allocated for the purposes of the notifier. The user is * responsible for releasing the notifier's resources after calling -* @v4l2_async_notifier_parse_fwnode_endpoints. +* @v4l2_async_notifier_parse_fwnode_endpoints or +* @v4l2_fwnode_reference_parse_sensor_common. * * There is no harm from calling v4l2_async_notifier_release in other * cases as long as its memory has been zeroed after it has been
include/media/v4l2-fwnode.h +21 -0
@@ -316,4 +316,25 @@ int v4l2_async_notifier_parse_fwnode_endpoints_by_port(struct v4l2_fwnode_endpoint *vep, struct v4l2_async_subdev *asd)); +/** +* v4l2_fwnode_reference_parse_sensor_common - parse common references on +* sensors for async sub-devices +* @dev: the device node the properties of which are parsed for references +* @notifier: the async notifier where the async subdevs will be added +* +* Parse common sensor properties for remote devices related to the +* sensor and set up async sub-devices for them. +* +* Any notifier populated using this function must be released with a call to +* v4l2_async_notifier_release() after it has been unregistered and the async +* sub-devices are no longer in use, even in the case the function returned an +* error. +* +* Return: 0 on success +* -ENOMEM if memory allocation failed +* -EINVAL if property parsing failed +*/ +int v4l2_async_notifier_parse_fwnode_sensor_common ( +struct device *dev,struct v4l2_async_notifier *notifier); +#endif /* _V4L2_FWNODE_H */
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 21/26 dt: bindings: smiapp: Document lens-focus and flash-leds properties
In reply to Sakari AilusDocument optional lens-focus and flash-leds properties for the smiapp driver.
--- Documentation/devicetree/bindings/media/i2c/nokia,smia.txt | 2 ++ 1 file changed, 2 insertions(+)
Documentation/devicetree/bindings/media/i2c/nokia,smia.txt +2 -0
@@ -27,6 +27,8 @@ Optional properties - nokia,nvm-size: The size of the NVM, in bytes. If the size is not given, the NVM contents will not be read. - reset-gpios: XSHUTDOWN GPIO +- flash-leds: See ../video-interfaces.txt +- lens-focus: See ../video-interfaces.txt Endpoint node mandatory properties
Signature · 1 line
2.11.0
Sakari Ailus
maintainerPATCH v12 23/26 et8ek8: Add support for flash and lens devices
In reply to Sakari AilusFrom: Pavel Machek <[email protected]>
Parse async sub-devices by using v4l2_subdev_fwnode_reference_parse_sensor_common().
These types devices aren't directly related to the sensor, but are nevertheless handled by the et8ek8 driver due to the relationship of these component to the main part of the camera module --- the sensor.
--- drivers/media/i2c/et8ek8/et8ek8_driver.c | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-)
drivers/media/i2c/et8ek8/et8ek8_driver.c +20 -1
@@ -34,10 +34,12 @@#include <linux/sort.h> #include <linux/v4l2-mediabus.h> +#include <media/v4l2-async.h> #include <media/media-entity.h> #include <media/v4l2-ctrls.h> #include <media/v4l2-device.h> #include <media/v4l2-subdev.h> +#include <media/v4l2-fwnode.h> #include "et8ek8_reg.h"
@@ -46,6 +48,7 @@#define ET8EK8_MAX_MSG 8struct et8ek8_sensor { +struct v4l2_async_notifier notifier;struct v4l2_subdev subdev;struct media_pad pad;struct v4l2_mbus_framefmt format;
@@ -1446,6 +1449,11 @@ static int et8ek8_probe(struct i2c_client *client, sensor->subdev.flags |=V4L2_SUBDEV_FL_HAS_DEVNODE ; sensor->subdev.internal_ops = &et8ek8_internal_ops; + ret =v4l2_async_notifier_parse_fwnode_sensor_common ( + &client->dev, &sensor->notifier); +if (ret <0 ) + goto err_release; + sensor->pad.flags =MEDIA_PAD_FL_SOURCE ; ret =media_entity_pads_init (&sensor->subdev.entity,1 , &sensor->pad);if (ret <0 ) {
@@ -1453,18 +1461,27 @@ static int et8ek8_probe(struct i2c_client *client, goto err_mutex; } + ret =v4l2_async_subdev_notifier_register (&sensor->subdev, + &sensor->notifier); +if (ret) + goto err_entity; + ret =v4l2_async_register_subdev (&sensor->subdev);if (ret <0 ) - goto err_entity; + goto err_async;dev_dbg (dev,"initialized!\n" );return 0 ; +err_async: +v4l2_async_notifier_unregister (&sensor->notifier); err_entity:media_entity_cleanup (&sensor->subdev.entity); err_mutex:mutex_destroy (&sensor->power_lock); +err_release: +v4l2_async_notifier_release (&sensor->notifier);return ret; }
@@ -1480,6 +1497,8 @@ static int __exit et8ek8_remove(struct i2c_client *client) }v4l2_device_unregister_subdev (&sensor->subdev); +v4l2_async_notifier_unregister (&sensor->notifier); +v4l2_async_notifier_release (&sensor->notifier);device_remove_file (&client->dev, &dev_attr_priv_mem);v4l2_ctrl_handler_free (&sensor->ctrl_handler);v4l2_async_unregister_subdev (&sensor->subdev);
Signature · 1 line
2.11.0
A message that is not in the archive (sent off-list or not yet received): 20170912134200.19556-24-sakari.ailus-VuQAYsv1563Yd54FQh9/[email protected]
Hans Verkuil
Acked-byRe: [PATCH v12 23/26] et8ek8: Add support for flash and lens devices
Quoted 5 lines · Sakari Ailus
From: Pavel Machek <[email protected]>
Parse async sub-devices by using
v4l2_subdev_fwnode_reference_parse_sensor_common().
Quoted 7 lines
These types devices aren't directly related to the sensor, but are nevertheless handled by the et8ek8 driver due to the relationship of these component to the main part of the camera module --- the sensor.
[Sakari Ailus: Rename fwnode function, check for ret < 0 only.]Signed-off-by Pavel Machek <[email protected]>
Regards,
Hans
Quoted 72 lines
--- drivers/media/i2c/et8ek8/et8ek8_driver.c | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-)drivers/media/i2c/et8ek8/et8ek8_driver.c +18
-1@@ -34,10 +34,12 @@#include <linux/sort.h> #include <linux/v4l2-mediabus.h> +#include <media/v4l2-async.h> #include <media/media-entity.h> #include <media/v4l2-ctrls.h> #include <media/v4l2-device.h> #include <media/v4l2-subdev.h> +#include <media/v4l2-fwnode.h> #include "et8ek8_reg.h" @@ -46,6 +48,7 @@#define ET8EK8_MAX_MSG 8struct et8ek8_sensor { +struct v4l2_async_notifier notifier;struct v4l2_subdev subdev;struct media_pad pad;struct v4l2_mbus_framefmt format;@@ -1446,6 +1449,11 @@ static int et8ek8_probe(struct i2c_client *client, sensor->subdev.flags |=V4L2_SUBDEV_FL_HAS_DEVNODE ; sensor->subdev.internal_ops = &et8ek8_internal_ops; + ret =v4l2_async_notifier_parse_fwnode_sensor_common ( + &client->dev, &sensor->notifier); +if (ret <0 ) + goto err_release; + sensor->pad.flags =MEDIA_PAD_FL_SOURCE ; ret =media_entity_pads_init (&sensor->subdev.entity,1 , &sensor->pad);if (ret <0 ) {@@ -1453,18 +1461,27 @@ static int et8ek8_probe(struct i2c_client *client, goto err_mutex; } + ret =v4l2_async_subdev_notifier_register (&sensor->subdev, + &sensor->notifier); +if (ret) + goto err_entity; + ret =v4l2_async_register_subdev (&sensor->subdev);if (ret <0 ) - goto err_entity; + goto err_async;dev_dbg (dev,"initialized!\n" );return 0 ; +err_async: +v4l2_async_notifier_unregister (&sensor->notifier); err_entity:media_entity_cleanup (&sensor->subdev.entity); err_mutex:mutex_destroy (&sensor->power_lock); +err_release: +v4l2_async_notifier_release (&sensor->notifier);return ret; }
drivers/media/i2c/et8ek8/et8ek8_driver.c static int __exit et8ek8_remove(struct i2c_client *client) · line 1504
Quoted 8 lines
drivers/media/i2c/et8ek8/et8ek8_driver.c +2
-0@@ -1480,6 +1497,8 @@ static int __exit et8ek8_remove(struct i2c_client *client) }v4l2_device_unregister_subdev (&sensor->subdev); +v4l2_async_notifier_unregister (&sensor->notifier); +v4l2_async_notifier_release (&sensor->notifier);device_remove_file (&client->dev, &dev_attr_priv_mem);v4l2_ctrl_handler_free (&sensor->ctrl_handler);v4l2_async_unregister_subdev (&sensor->subdev);
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html