include/media/v4l2-async.h

1 /* SPDX-License-Identifier: GPL-2.0-only */
5  * Copyright (C) 2012-2013, Guennadi Liakhovetski <g.liakhovetski@gmx.de>
22  * enum v4l2_async_match_type - type of asynchronous subdevice logic to be used
28  * This enum is used by the asynchronous connection logic to define the
31 enum v4l2_async_match_type {
37  * struct v4l2_async_match_desc - async connection match information
54 	enum v4l2_async_match_type type;
65  * struct v4l2_async_connection - sub-device connection descriptor, as known to
68  * @match:	struct of match type and per-bus type matching data sets
69  * @notifier:	the async notifier the connection is related to
73  * @sd:		the related sub-device
88  * struct v4l2_async_notifier_operations - Asynchronous V4L2 notifier operations
89  * @bound:	a sub-device has been bound by the given connection
107  * struct v4l2_async_notifier - v4l2_device notifier data
111  * @sd:		sub-device that registered the notifier, NULL otherwise
129  * struct v4l2_async_subdev_endpoint - Entry in sub-device's fwnode list
133  * @endpoint: Endpoint fwnode agains which to match the sub-device
141  * v4l2_async_debug_init - Initialize debugging tools.
148  * v4l2_async_nf_init - Initialize a notifier.
163  * v4l2_async_subdev_nf_init - Initialize a sub-device notifier.
181  * v4l2_async_nf_add_fwnode - Allocate and add a fwnode async
185  * @fwnode: fwnode handle of the sub-device to be matched, pointer to
187  * @type: Type of the driver's async sub-device or connection struct. The
189  *	  driver's async struct, i.e. both begin at the same memory address.
191  * Allocate a fwnode-matched asc of size asc_struct_size, and add it to the
203  * v4l2_async_nf_add_fwnode_remote - Allocate and add a fwnode
204  *						  remote async subdev to the
210  * @type: Type of the driver's async connection struct. The &struct
211  *	  v4l2_async_connection shall be the first member of the driver's async
215  * matching and adds the async connection to the notifier's @asc_list. The
230  * v4l2_async_nf_add_i2c - Allocate and add an i2c async
236  * @type: Type of the driver's async connection struct. The &struct
237  *	  v4l2_async_connection shall be the first member of the driver's async
248  * v4l2_async_subdev_endpoint_add - Add an endpoint fwnode to async sub-device
251  * @sd: the sub-device
254  * Add a fwnode to the async sub-device's matching list. This allows registering
255  * multiple async sub-devices from a single device.
257  * Note that calling v4l2_subdev_cleanup() as part of the sub-device's cleanup
258  * if endpoints have been added to the sub-device's fwnode matching list.
266  * v4l2_async_connection_unique - return a unique &struct v4l2_async_connection
267  *				  for a sub-device
268  * @sd: the sub-device
270  * Return an async connection for a sub-device, when there is a single
277  * v4l2_async_nf_register - registers a subdevice asynchronous notifier
284  * v4l2_async_nf_unregister - unregisters a subdevice
292  * v4l2_async_nf_cleanup - clean up notifier resources
295  * Release memory resources related to a notifier, including the async
308  * v4l2_async_register_subdev - registers a sub-device to the asynchronous
318  * v4l2_async_register_subdev_sensor - registers a sensor sub-device to the
319  *				       asynchronous sub-device framework and
328  * async sub-devices. The sub-device is similarly unregistered by calling
331  * While registered, the subdev module is marked as in-use.
340  * v4l2_async_unregister_subdev - unregisters a sub-device to the asynchronous