Lines Matching +full:stream +full:- +full:mode +full:- +full:support
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 * V4L2 sub-device support header.
12 #include <linux/v4l2-subdev.h>
13 #include <media/media-entity.h>
14 #include <media/v4l2-async.h>
15 #include <media/v4l2-common.h>
16 #include <media/v4l2-dev.h>
17 #include <media/v4l2-fh.h>
18 #include <media/v4l2-mediabus.h>
44 * struct v4l2_decode_vbi_line - used to decode_vbi_line
50 * @line: Line number of the sliced VBI data (1-23)
61 * Sub-devices are devices that are connected somehow to the main bridge
69 * generic manner. Most operations that these sub-devices support fall in
96 * This provides basic debugging support.
98 * The ioctl ops is meant for generic ioctl-like commands. Depending on
99 * the use-case it might be better to use subdev-specific ops (currently
100 * not yet implemented) since ops provide proper type-checking.
104 * enum v4l2_subdev_io_pin_bits - Subdevice external IO pin configuration
111 * &struct v4l2_subdev_io_pin_config->value.
124 * struct v4l2_subdev_io_pin_config - Subdevice external IO pin configuration
130 * @value: Initial value for pin - e.g. GPIO output value
142 * struct v4l2_subdev_core_ops - Define core ops callbacks for subdevs
160 * drivers without discussing this first on the linux-media mailinglist.
166 * @command: called by in-kernel drivers in order to call functions internal
170 * used to provide support for private ioctls used on the driver.
179 * @s_power: puts subdevice in power saving mode (on == 0) or normal operation
180 * mode (on == 1). DEPRECATED. See
181 * Documentation/driver-api/media/camera-sensor.rst . pre_streamon and
182 * post_streamoff callbacks can be used for e.g. setting the bus to LP-11
183 * mode before s_stream is called.
223 * struct v4l2_subdev_tuner_ops - Callbacks used when v4l device was opened
224 * in radio mode.
226 * @standby: puts the tuner in standby mode. It will be woken up
229 * @s_radio: callback that switches the tuner to radio mode.
231 * operate on radio mode, before being able to handle it.
237 * freq->type must be filled in. Normally done by video_ioctl2()
244 * @s_tuner: callback for VIDIOC_S_TUNER() ioctl handler code. @vt->type must be
260 * radio mode, before handling other &struct v4l2_subdev_tuner_ops
287 * struct v4l2_subdev_audio_ops - Callbacks used for audio-related settings
293 * -EINVAL is returned.
298 * If the frequency is not supported, then %-EINVAL is returned.
302 * Never attempt to use user-level input IDs (e.g. Composite, S-Video,
306 * The calling driver is responsible for mapping a user-level input to
309 * @s_stream: used to notify the audio code that stream will start or has
322 * @vc: CSI-2 virtual channel
323 * @dt: CSI-2 data type ID
331 * enum v4l2_mbus_frame_desc_flags - media bus frame description flags
334 * Indicates that &struct v4l2_mbus_frame_desc_entry->length field
346 * struct v4l2_mbus_frame_desc_entry - media bus frame description structure
349 * @stream: stream in routing configuration
354 * @bus: Bus-specific frame descriptor parameters
355 * @bus.csi2: CSI-2-specific bus configuration
359 u32 stream; member
374 * enum v4l2_mbus_frame_desc_type - media bus frame description type
382 * CSI-2 media bus. Frame desc parameters must be set in
383 * &struct v4l2_mbus_frame_desc_entry->csi2.
392 * struct v4l2_mbus_frame_desc - media bus data frame description
404 * enum v4l2_subdev_pre_streamon_flags - Flags for pre_streamon subdev core op
406 * @V4L2_SUBDEV_PRE_STREAMON_FL_MANUAL_LP: Set the transmitter to either LP-11
407 * or LP-111 mode before call to s_stream().
414 * struct v4l2_subdev_video_ops - Callbacks used when v4l device was opened
415 * in video mode.
423 * to 0. If the frequency is not supported, then -EINVAL is returned.
447 * sub-device. Failure on stop will remove any resources acquired in
451 * v4l2-subdev.c.
456 * operation to support legacy users.
469 * initialising the bus. Current usage is to set a CSI-2 transmitter to
470 * LP-11 or LP-111 mode before streaming. See &enum
474 * indicated by the flags argument. In particular, -EACCES indicates lack
475 * of support for the operation. The caller shall call post_streamoff for
501 * struct v4l2_subdev_vbi_ops - Callbacks used when v4l device was opened
502 * in video mode via the vbi device node.
504 * @decode_vbi_line: video decoders that support sliced VBI need to implement
520 * Not all video decoders support this. If no data is available because
521 * the readback register contains invalid or erroneous data %-EIO is
546 * struct v4l2_subdev_sensor_ops - v4l2-subdev sensor operations
551 * @g_skip_frames: number of frames to skip at stream start. This is needed for
561 * enum v4l2_subdev_ir_mode- describes the type of IR supported
570 * struct v4l2_subdev_ir_parameters - Parameters for IR TX or TX
574 * @mode: IR mode as defined by &enum v4l2_subdev_ir_mode.
577 * @shutdown: if true: set hardware to low/no power, false: normal mode
596 enum v4l2_subdev_ir_mode mode; member
619 * struct v4l2_subdev_ir_ops - operations for IR subdevices
622 * The semantics are similar to a non-blocking read() call.
631 * settings - e.g. an actual carrier setting of 35,904 Hz when 36,000 Hz
638 * The semantics are similar to a non-blocking write() call.
647 * settings - e.g. an actual carrier setting of 35,904 Hz when 36,000 Hz
674 * struct v4l2_subdev_pad_config - Used for storing subdev pad information.
689 * struct v4l2_subdev_stream_config - Used for storing stream configuration.
692 * @stream: stream number
693 * @enabled: has the stream been enabled with v4l2_subdev_enable_streams()
699 * This structure stores configuration for a stream.
703 u32 stream; member
713 * struct v4l2_subdev_stream_configs - A collection of stream configs.
724 * struct v4l2_subdev_krouting - subdev routing table
739 * struct v4l2_subdev_state - Used for storing subdev state information.
743 * @sd: the sub-device which the state is related to
746 * @stream_configs: stream configurations (only for V4L2_SUBDEV_FL_STREAMS)
763 * struct v4l2_subdev_pad_ops - v4l2-subdev pad level operations
806 * that belongs to a pipeline can be used for stream.
813 * @get_mbus_config: get the media bus configuration of a remote sub-device.
815 * firmware interface at sub-device probe time, immediately
817 * driver. Remote sub-devices (usually video receivers) shall
820 * Callers should make sure they get the most up-to-date as
822 * this operation as close as possible to stream on time. The
906 * struct v4l2_subdev_ops - Subdev operations
929 * struct v4l2_subdev_internal_ops - V4L2 subdev internal ops
946 * filehandle to the v4l-subdevX device node was closed. If no device
947 * node was created for this sub-device, then the @release callback
951 * sub-device that sets the V4L2_SUBDEV_FL_HAS_DEVNODE flag.
981 * that the driver supports routing and handles the stream parameter in its
984 * - Centrally managed subdev active state is enabled
985 * - Legacy pad config is _not_ supported (state->pads is NULL)
986 * - Routing ioctls are available
987 * - Multiple streams per pad are supported
994 * struct v4l2_subdev_platform_data - regulators config struct
998 * @host_priv: Per-subdevice data, specific for a certain video host device
1008 * struct v4l2_subdev - describes a V4L2 sub-device
1011 * @list: List of sub-devices
1013 * @owner_v4l2_dev: true if the &sd->owner matches the owner of @v4l2_dev->dev
1016 * %V4L2_SUBDEV_FL_IS_I2C - Set this flag if this subdev is a i2c device;
1017 * %V4L2_SUBDEV_FL_IS_SPI - Set this flag if this subdev is a spi device;
1018 * %V4L2_SUBDEV_FL_HAS_DEVNODE - Set this flag if this subdev needs a
1020 * %V4L2_SUBDEV_FL_HAS_EVENTS - Set this flag if this subdev generates
1028 * @name: Name of the sub-device. Please notice that the name must be unique.
1029 * @grp_id: can be used to group similar subdevs. Value is driver-specific
1036 * either dev->of_node->fwnode or dev->fwnode (whichever is non-NULL).
1038 * @notifier->done_list list.
1041 * @subdev_notifier: A sub-device notifier implicitly registered for the sub-
1060 * stand-alone or embedded in a larger struct.
1102 * doesn't support it.
1111 * media_entity_to_v4l2_subdev - Returns a &struct v4l2_subdev from
1126 * vdev_to_v4l2_subdev - Returns a &struct v4l2_subdev from
1135 * struct v4l2_subdev_fh - Used for storing subdev information per file handle
1152 * to_v4l2_subdev_fh - Returns a &struct v4l2_subdev_fh from
1163 * v4l2_set_subdevdata - Sets V4L2 dev private device data
1170 sd->dev_priv = p; in v4l2_set_subdevdata()
1174 * v4l2_get_subdevdata - Gets V4L2 dev private device data
1182 return sd->dev_priv; in v4l2_get_subdevdata()
1186 * v4l2_set_subdev_hostdata - Sets V4L2 dev private host data
1193 sd->host_priv = p; in v4l2_set_subdev_hostdata()
1197 * v4l2_get_subdev_hostdata - Gets V4L2 dev private data
1205 return sd->host_priv; in v4l2_get_subdev_hostdata()
1211 * v4l2_subdev_get_fwnode_pad_1_to_1 - Get pad number from a subdev fwnode
1228 * v4l2_subdev_link_validate_default - validates a media link
1244 * v4l2_subdev_link_validate - validates a media link
1254 * The function can be used as a drop-in &media_entity_ops.link_validate
1263 * v4l2_subdev_has_pad_interdep - MC has_pad_interdep implementation for subdevs
1281 * __v4l2_subdev_state_alloc - allocate v4l2_subdev_state
1296 * __v4l2_subdev_state_free - free a v4l2_subdev_state
1305 * v4l2_subdev_init_finalize() - Finalizes the initialization of the subdevice
1322 ":" __stringify(__LINE__) ":sd->active_state->lock"; \
1330 * v4l2_subdev_cleanup() - Releases the resources allocated by the subdevice
1333 * Clean up a V4L2 async sub-device. Must be called for a sub-device as part of
1340 * A macro to generate the macro or function name for sub-devices state access
1357 * v4l2_subdev_state_get_format() - Get pointer to a stream format
1360 * @...: stream id (optional argument)
1363 * stream in the subdev state.
1365 * For stream-unaware drivers the format for the corresponding pad is returned.
1376 * const-correctness in all cases.
1389 unsigned int pad, u32 stream);
1392 * v4l2_subdev_state_get_crop() - Get pointer to a stream crop rectangle
1395 * @...: stream id (optional argument)
1397 * This returns a pointer to crop rectangle for the given pad + stream in the
1400 * For stream-unaware drivers the crop rectangle for the corresponding pad is
1411 u32 stream);
1414 * v4l2_subdev_state_get_compose() - Get pointer to a stream compose rectangle
1417 * @...: stream id (optional argument)
1419 * This returns a pointer to compose rectangle for the given pad + stream in the
1422 * For stream-unaware drivers the compose rectangle for the corresponding pad is
1433 unsigned int pad, u32 stream);
1436 * v4l2_subdev_state_get_interval() - Get pointer to a stream frame interval
1439 * @...: stream id (optional argument)
1441 * This returns a pointer to the frame interval for the given pad + stream in
1444 * For stream-unaware drivers the frame interval for the corresponding pad is
1455 unsigned int pad, u32 stream);
1460 * v4l2_subdev_get_fmt() - Fill format based on state
1465 * Fill @format->format field based on the information in the @format struct.
1467 * This function can be used by the subdev drivers which support active state to
1477 * v4l2_subdev_get_frame_interval() - Fill frame interval based on state
1482 * Fill @fi->interval field based on the information in the @fi struct.
1484 * This function can be used by the subdev drivers which support active state to
1495 * v4l2_subdev_set_routing() - Set given routing to subdev state
1515 * for_each_active_route - iterate on all active routes of a routing table
1524 * v4l2_subdev_set_routing_with_fmt() - Set given routing and format to subdev
1540 * v4l2_subdev_routing_find_opposite_end() - Find the opposite stream
1543 * @stream: stream id
1545 * @other_stream: pointer used to return the opposite stream
1547 * This function uses the routing table to find the pad + stream which is
1548 * opposite the given pad + stream.
1553 * Returns 0 on success, or -EINVAL if no matching route is found.
1556 u32 pad, u32 stream, u32 *other_pad,
1560 * v4l2_subdev_state_get_opposite_stream_format() - Get pointer to opposite
1561 * stream format
1564 * @stream: stream id
1566 * This returns a pointer to &struct v4l2_mbus_framefmt for the pad + stream
1567 * that is opposite the given pad + stream in the subdev state.
1569 * If the state does not contain the given pad + stream, NULL is returned.
1573 u32 pad, u32 stream);
1576 * v4l2_subdev_state_xlate_streams() - Translate streams from one pad to another
1584 * the subdev state routing table. Stream numbers don't necessarily match on
1585 * the sink and source side of a route. This function translates stream numbers
1587 * on @pad1 using the routing table from the @state. It returns the stream mask
1599 * enum v4l2_subdev_routing_restriction - Subdevice internal routing restrictions
1602 * an input stream shall not be routed to multiple output streams (stream
1605 * multiple input streams shall not be routed to the same output stream
1606 * (stream merging)
1616 * only non-overlapping 1-to-1 stream routing is allowed (a combination of
1645 * v4l2_subdev_routing_validate() - Verify that routes comply with driver
1660 * v4l2_subdev_enable_streams() - Enable streams on a pad
1670 * Enabling a stream that is already enabled isn't allowed. If @streams_mask
1671 * contains an already enabled stream, this function returns -EALREADY without
1674 * Per-stream enable is only available for subdevs that implement the
1676 * function implements a best-effort compatibility by calling the .s_stream()
1681 * * -EALREADY: One of the streams in streams_mask is already enabled
1682 * * -EINVAL: The pad index is invalid, or doesn't correspond to a source pad
1683 * * -EOPNOTSUPP: Falling back to the legacy .s_stream() operation is
1690 * v4l2_subdev_disable_streams() - Disable streams on a pad
1701 * contains a disabled stream, this function returns -EALREADY without
1704 * Per-stream disable is only available for subdevs that implement the
1706 * function implements a best-effort compatibility by calling the .s_stream()
1711 * * -EALREADY: One of the streams in streams_mask is not enabled
1712 * * -EINVAL: The pad index is invalid, or doesn't correspond to a source pad
1713 * * -EOPNOTSUPP: Falling back to the legacy .s_stream() operation is
1720 * v4l2_subdev_s_stream_helper() - Helper to implement the subdev s_stream
1725 * Subdevice drivers that implement the streams-aware
1741 * v4l2_subdev_lock_state() - Locks the subdev state
1750 mutex_lock(state->lock); in v4l2_subdev_lock_state()
1754 * v4l2_subdev_unlock_state() - Unlocks the subdev state
1761 mutex_unlock(state->lock); in v4l2_subdev_unlock_state()
1765 * v4l2_subdev_lock_states - Lock two sub-device states
1769 * Locks the state of two sub-devices.
1781 mutex_lock(state1->lock); in v4l2_subdev_lock_states()
1782 if (state1->lock != state2->lock) in v4l2_subdev_lock_states()
1783 mutex_lock(state2->lock); in v4l2_subdev_lock_states()
1787 * v4l2_subdev_unlock_states() - Unlock two sub-device states
1791 * Unlocks the state of two sub-devices.
1799 mutex_unlock(state1->lock); in v4l2_subdev_unlock_states()
1800 if (state1->lock != state2->lock) in v4l2_subdev_unlock_states()
1801 mutex_unlock(state2->lock); in v4l2_subdev_unlock_states()
1805 * v4l2_subdev_get_unlocked_active_state() - Checks that the active subdev state
1810 * support active state. If the state is not NULL, calls
1819 if (sd->active_state) in v4l2_subdev_get_unlocked_active_state()
1820 lockdep_assert_not_held(sd->active_state->lock); in v4l2_subdev_get_unlocked_active_state()
1821 return sd->active_state; in v4l2_subdev_get_unlocked_active_state()
1825 * v4l2_subdev_get_locked_active_state() - Checks that the active subdev state
1831 * support active state. If the state is not NULL, calls lockdep_assert_held()
1840 if (sd->active_state) in v4l2_subdev_get_locked_active_state()
1841 lockdep_assert_held(sd->active_state->lock); in v4l2_subdev_get_locked_active_state()
1842 return sd->active_state; in v4l2_subdev_get_locked_active_state()
1846 * v4l2_subdev_lock_and_get_active_state() - Locks and returns the active subdev
1851 * does not support active state.
1858 if (sd->active_state) in v4l2_subdev_lock_and_get_active_state()
1859 v4l2_subdev_lock_state(sd->active_state); in v4l2_subdev_lock_and_get_active_state()
1860 return sd->active_state; in v4l2_subdev_lock_and_get_active_state()
1864 * v4l2_subdev_init - initializes the sub-device struct
1875 * v4l2_subdev_call - call an operation of a v4l2_subdev.
1892 __result = -ENODEV; \
1893 else if (!(__sd->ops->o && __sd->ops->o->f)) \
1894 __result = -ENOIOCTLCMD; \
1896 v4l2_subdev_call_wrappers.o->f) \
1897 __result = v4l2_subdev_call_wrappers.o->f( \
1900 __result = __sd->ops->o->f(__sd, ##args); \
1905 * v4l2_subdev_call_state_active - call an operation of a v4l2_subdev which
1935 * v4l2_subdev_call_state_try - call an operation of a v4l2_subdev which
1951 * Note: only legacy non-MC drivers may need this macro.
1958 ":" __stringify(__LINE__) ":state->lock"; \
1969 * v4l2_subdev_has_op - Checks if a subdev defines a certain operation.
1977 ((sd)->ops->o && (sd)->ops->o->f)
1980 * v4l2_subdev_notify_event() - Delivers event notification for subdevice
1993 * v4l2_subdev_is_streaming() - Returns if the subdevice is streaming