Lines Matching +full:part +full:- +full:number
1 /* SPDX-License-Identifier: GPL-2.0-only */
26 * enum media_gobj_type - type of a graph object
42 #define MEDIA_BITS_PER_ID (32 - MEDIA_BITS_PER_TYPE)
43 #define MEDIA_ID_MASK GENMASK_ULL(MEDIA_BITS_PER_ID - 1, 0)
48 * struct media_gobj - Define a graph object.
51 * @id: Non-zero object ID identifier. The ID should be unique
55 * @list: List entry stored in one of the per-type mdev object lists
68 * struct media_entity_enum - An enumeration of media entities.
71 * media_entity->internal_idx.
72 * @idx_max: Number of bits in bmap
80 * struct media_graph - Media graph traversal state
101 * struct media_pipeline - Media pipeline related information
104 * @mdev: The media device the pipeline is part of
106 * @start_count: Media pipeline start - stop count
116 * struct media_pipeline_pad - A pad part of a media pipeline
119 * @pipe: The media_pipeline that the pad is part of
134 * struct media_pipeline_pad_iter - Iterator for media_pipeline_for_each_pad
143 * struct media_pipeline_entity_iter - Iterator for media_pipeline_for_each_entity
154 * struct media_link - A link object part of a media graph.
159 * @gobj0: Part of a union. Used to get the pointer for the first
161 * @source: Part of a union. Used only if the first object (gobj0) is
163 * @intf: Part of a union. Used only if the first object (gobj0) is
165 * @gobj1: Part of a union. Used to get the pointer for the second
167 * @sink: Part of a union. Used only if the second object (gobj1) is
169 * @entity: Part of a union. Used only if the second object (gobj1) is
195 * enum media_pad_signal_type - type of the signal inside a media pad
199 * uniquely identified by the pad number.
202 * Intermediate Frequency, a baseband signal or sub-carriers.
203 * Tuner inputs, IF-PLL demodulators, composite and s-video signals
211 * sub-carrier or an audio bitstream. IF signals are provided by tuners
223 * struct media_pad - A media pad graph object.
228 * @num_links: Number of links connected to this pad
252 * struct media_entity_operations - Media entity operations
253 * @get_fwnode_pad: Return the pad number based on a fwnode endpoint or
255 * to map a fwnode to a media pad number. Optional.
264 * part of the same pipeline and enabling one of the pads
290 * enum media_entity_type - Media entity type
300 * entity structure is inherited by (through embedding) other subsystem-specific
317 * struct media_entity - A media entity graph object.
328 * @num_pads: Number of sink and source pads.
329 * @num_links: Total number of links, forward and back, enabled and disabled.
330 * @num_backlinks: Number of backlinks
331 * @internal_idx: An unique internal entity specific number. The numbers are
332 * re-used if entities are unregistered or registered again.
342 * @major: Devnode major number (zero if not applicable). Kept just
344 * @minor: Devnode minor number (zero if not applicable). Kept just
381 * media_entity_for_each_pad - Iterate on all pads in an entity
388 for (iter = (entity)->pads; \
389 iter < &(entity)->pads[(entity)->num_pads]; \
393 * struct media_interface - A media interface graph object.
416 * struct media_intf_devnode - A media interface via a device node.
419 * @major: Major number of a device node
420 * @minor: Minor number of a device node
431 * media_entity_id() - return the media entity graph object id
437 return entity->graph_obj.id; in media_entity_id()
441 * media_type() - return the media object type
447 return gobj->id >> MEDIA_BITS_PER_ID; in media_type()
451 * media_id() - return the media object ID
457 return gobj->id & MEDIA_ID_MASK; in media_id()
461 * media_gobj_gen_id() - encapsulates type and ID on at the object ID
477 * is_media_entity_v4l2_video_device() - Check if the entity is a video_device
486 return entity && entity->obj_type == MEDIA_ENTITY_TYPE_VIDEO_DEVICE; in is_media_entity_v4l2_video_device()
490 * is_media_entity_v4l2_subdev() - Check if the entity is a v4l2_subdev
499 return entity && entity->obj_type == MEDIA_ENTITY_TYPE_V4L2_SUBDEV; in is_media_entity_v4l2_subdev()
503 * media_entity_enum_init - Initialise an entity enumeration
514 * media_entity_enum_cleanup - Release resources of an entity enumeration
521 * media_entity_enum_zero - Clear the entire enum
527 bitmap_zero(ent_enum->bmap, ent_enum->idx_max); in media_entity_enum_zero()
531 * media_entity_enum_set - Mark a single entity in the enum
539 if (WARN_ON(entity->internal_idx >= ent_enum->idx_max)) in media_entity_enum_set()
542 __set_bit(entity->internal_idx, ent_enum->bmap); in media_entity_enum_set()
546 * media_entity_enum_clear - Unmark a single entity in the enum
554 if (WARN_ON(entity->internal_idx >= ent_enum->idx_max)) in media_entity_enum_clear()
557 __clear_bit(entity->internal_idx, ent_enum->bmap); in media_entity_enum_clear()
561 * media_entity_enum_test - Test whether the entity is marked
571 if (WARN_ON(entity->internal_idx >= ent_enum->idx_max)) in media_entity_enum_test()
574 return test_bit(entity->internal_idx, ent_enum->bmap); in media_entity_enum_test()
578 * media_entity_enum_test_and_set - Test whether the entity is marked,
590 if (WARN_ON(entity->internal_idx >= ent_enum->idx_max)) in media_entity_enum_test_and_set()
593 return __test_and_set_bit(entity->internal_idx, ent_enum->bmap); in media_entity_enum_test_and_set()
597 * media_entity_enum_empty - Test whether the entire enum is empty
605 return bitmap_empty(ent_enum->bmap, ent_enum->idx_max); in media_entity_enum_empty()
609 * media_entity_enum_intersects - Test whether two enums intersect
621 WARN_ON(ent_enum1->idx_max != ent_enum2->idx_max); in media_entity_enum_intersects()
623 return bitmap_intersects(ent_enum1->bmap, ent_enum2->bmap, in media_entity_enum_intersects()
624 min(ent_enum1->idx_max, ent_enum2->idx_max)); in media_entity_enum_intersects()
628 * gobj_to_entity - returns the struct &media_entity pointer from the
637 * gobj_to_pad - returns the struct &media_pad pointer from the
646 * gobj_to_link - returns the struct &media_link pointer from the
655 * gobj_to_intf - returns the struct &media_interface pointer from the
664 * intf_to_devnode - returns the struct media_intf_devnode pointer from the
673 * media_gobj_create - Initialize a graph object
690 * media_gobj_destroy - Stop using a graph object on a media device
700 * media_entity_pads_init() - Initialize the entity pads
703 * @num_pads: total number of sink and source pads
711 * &media_entity->num_pads with 0 and &media_entity->pads with %NULL or call
714 * As the number of pads is known in advance, the pads array is not allocated
716 * pads array in a driver-specific structure, avoiding dynamic allocation.
725 * media_entity_cleanup() - free resources associated with an entity
734 * valid and is a no-op.
743 * media_get_pad_index() - retrieves a pad index from an entity
754 * On success, return the pad number. If the pad was not found or the media
755 * entity is a NULL pointer, return -EINVAL.
761 * media_create_pad_link() - creates a link between two entities.
764 * @source_pad: number of the source pad in the pads array
766 * @sink_pad: number of the sink pad in the pads array.
793 * media_create_pad_links() - creates a link between two entities.
800 * @source_pad: number of the source pad in the pads array
804 * @sink_pad: number of the sink pad in the pads array.
827 * cross-bar (n:n) links.
848 * media_entity_remove_links() - remove all links associated with an entity
860 * __media_entity_setup_link - Configure a media link without locking
870 * The user is expected to hold link->source->parent->mutex. If not,
876 * media_entity_setup_link() - changes the link flags properties in runtime
897 * is non-immutable. The operation must either configure the hardware or store
902 * being enabled, the link_setup operation must return %-EBUSY and can't
914 * media_entity_find_link - Find a link between two pads
925 * media_pad_remote_pad_first - Find the first pad at the remote end of a link
937 * media_pad_remote_pad_unique - Find a remote pad connected to a pad
949 * * -ENOTUNIQ - Multiple links are enabled
950 * * -ENOLINK - No connected pad found
955 * media_entity_remote_pad_unique - Find a remote pad connected to an entity
969 * * -ENOTUNIQ - Multiple links are enabled
970 * * -ENOLINK - No connected pad found
977 * media_entity_remote_source_pad_unique - Find a remote source pad connected to
991 * * -ENOTUNIQ - Multiple links are enabled
992 * * -ENOLINK - No connected pad found
1001 * media_pad_is_streaming - Test if a pad is part of a streaming pipeline
1004 * Return: True if the pad is part of a pipeline started with the
1009 return pad->pipe; in media_pad_is_streaming()
1013 * media_entity_is_streaming - Test if an entity is part of a streaming pipeline
1016 * Return: True if the entity is part of a pipeline started with the
1032 * media_entity_pipeline - Get the media pipeline an entity is part of
1041 * In general, entities can be part of multiple pipelines, when carrying
1046 * Return: The media_pipeline the entity is part of, or NULL if the entity is
1047 * not part of any pipeline.
1052 * media_pad_pipeline - Get the media pipeline a pad is part of
1059 * Return: The media_pipeline the pad is part of, or NULL if the pad is
1060 * not part of any pipeline.
1065 * media_entity_get_fwnode_pad - Get pad number from fwnode
1073 * This function can be used to resolve the media pad number from
1081 * Return: returns the pad number on success or a negative error code.
1088 * media_graph_walk_init - Allocate resources used by graph walk.
1104 * media_graph_walk_cleanup - Release resources used by graph walk.
1113 * media_graph_walk_start - Start walking the media graph at a
1133 * media_graph_walk_next - Get the next entity in the graph
1138 * Perform a depth-first traversal of the given media entities graph.
1149 * media_pipeline_start - Mark a pipeline as streaming
1157 * Calls to this function can be nested, in which case the same number of
1165 * __media_pipeline_start - Mark a pipeline as streaming
1170 * ..note:: This is the non-locking version of media_pipeline_start()
1176 * media_pipeline_stop - Mark a pipeline as not streaming
1184 * number of calls to this function are required to mark the pipeline as not
1190 * __media_pipeline_stop - Mark a pipeline as not streaming
1194 * .. note:: This is the non-locking version of media_pipeline_stop()
1204 * media_pipeline_for_each_pad - Iterate on all pads in a media pipeline
1219 * media_pipeline_entity_iter_init - Initialize a pipeline entity iterator
1237 * media_pipeline_entity_iter_cleanup - Destroy a pipeline entity iterator
1251 * media_pipeline_for_each_entity - Iterate on all entities in a media pipeline
1269 * media_pipeline_alloc_start - Mark a pipeline as streaming
1274 * the pad is already part of a pipeline, or allocate a new pipeline.
1282 * media_devnode_create() - creates and initializes a device node interface
1291 * @major: Device node major number.
1292 * @minor: Device node minor number.
1306 * media_devnode_remove() - removes a device node interface
1316 * media_create_intf_link() - creates a link between an entity and an interface
1342 * interface that will be part of the link.
1349 * __media_remove_intf_link() - remove a single interface link
1358 * media_remove_intf_link() - remove a single interface link
1367 * __media_remove_intf_links() - remove all links associated with an interface
1376 * media_remove_intf_links() - remove all links associated with an interface
1390 * media_entity_call - Calls a struct media_entity_operations operation on
1402 (((entity)->ops && (entity)->ops->operation) ? \
1403 (entity)->ops->operation((entity) , ##args) : -ENOIOCTLCMD)
1406 * media_create_ancillary_link() - create an ancillary link between two
1425 * __media_entity_next_link() - Iterate through a &media_entity's links
1440 * for_each_media_entity_data_link() - Iterate through an entity's data links