3  * Media entity
15 #include <media/media-entity.h>
99 			"%s id %u: entity '%s'\n",  in dev_dbg_obj()
123 			pad->entity->name, pad->index);  in dev_dbg_obj()
194 int media_entity_pads_init(struct media_entity *entity, u16 num_pads,  in media_entity_pads_init()  argument
197 	struct media_device *mdev = entity->graph_obj.mdev;  in media_entity_pads_init()
204 	entity->num_pads = num_pads;  in media_entity_pads_init()
205 	entity->pads = pads;  in media_entity_pads_init()
210 	media_entity_for_each_pad(entity, iter) {  in media_entity_pads_init()
211 		iter->entity = entity;  in media_entity_pads_init()
232  * @entity: The entity
236  * This function checks the interdependency inside the entity between @pad0
242  * to check the dependency inside the entity between @pad0 and @pad1. If the
243  * has_pad_interdep operation is not implemented, all pads of the entity are
249  * The caller must hold entity->graph_obj.mdev->mutex.
253 static bool media_entity_has_pad_interdep(struct media_entity *entity,  in media_entity_has_pad_interdep()  argument
256 	if (pad0 >= entity->num_pads || pad1 >= entity->num_pads)  in media_entity_has_pad_interdep()
259 	if (entity->pads[pad0].flags & entity->pads[pad1].flags &  in media_entity_has_pad_interdep()
263 	if (!entity->ops || !entity->ops->has_pad_interdep)  in media_entity_has_pad_interdep()
266 	return entity->ops->has_pad_interdep(entity, pad0, pad1);  in media_entity_has_pad_interdep()
270 media_entity_other(struct media_entity *entity, struct media_link *link)  in media_entity_other()  argument
272 	if (link->source->entity == entity)  in media_entity_other()
273 		return link->sink->entity;  in media_entity_other()
275 		return link->source->entity;  in media_entity_other()
278 /* push an entity to traversal stack */
280 		       struct media_entity *entity)  in stack_push()  argument
287 	graph->stack[graph->top].link = entity->links.next;  in stack_push()
288 	graph->stack[graph->top].entity = entity;  in stack_push()
293 	struct media_entity *entity;  in stack_pop()  local
295 	entity = graph->stack[graph->top].entity;  in stack_pop()
298 	return entity;  in stack_pop()
302 #define stack_top(en)	((en)->stack[(en)->top].entity)
333 			    struct media_entity *entity)  in media_graph_walk_start()  argument
336 	media_entity_enum_set(&graph->ent_enum, entity);  in media_graph_walk_start()
339 	graph->stack[graph->top].entity = NULL;  in media_graph_walk_start()
340 	stack_push(graph, entity);  in media_graph_walk_start()
341 	dev_dbg(entity->graph_obj.mdev->dev,  in media_graph_walk_start()
342 		"begin graph walk at '%s'\n", entity->name);  in media_graph_walk_start()
348 	struct media_entity *entity = stack_top(graph);  in media_graph_walk_iter()  local
363 		dev_dbg(entity->graph_obj.mdev->dev,  in media_graph_walk_iter()
365 			link->source->entity->name, link->source->index,  in media_graph_walk_iter()
366 			link->sink->entity->name, link->sink->index);  in media_graph_walk_iter()
370 	/* Get the entity at the other end of the link. */  in media_graph_walk_iter()
371 	next = media_entity_other(entity, link);  in media_graph_walk_iter()
373 	/* Has the entity already been visited? */  in media_graph_walk_iter()
376 		dev_dbg(entity->graph_obj.mdev->dev,  in media_graph_walk_iter()
377 			"walk: skipping entity '%s' (already seen)\n",  in media_graph_walk_iter()
382 	/* Push the new entity to stack and start over. */  in media_graph_walk_iter()
385 	dev_dbg(entity->graph_obj.mdev->dev, "walk: pushing '%s' on stack\n",  in media_graph_walk_iter()
387 	lockdep_assert_held(&entity->graph_obj.mdev->graph_mutex);  in media_graph_walk_iter()
392 	struct media_entity *entity;  in media_graph_walk_next()  local
398 	 * Depth first search. Push entity to stack and continue from  in media_graph_walk_next()
405 	entity = stack_pop(graph);  in media_graph_walk_next()
406 	dev_dbg(entity->graph_obj.mdev->dev,  in media_graph_walk_next()
407 		"walk: returning entity '%s'\n", entity->name);  in media_graph_walk_next()
409 	return entity;  in media_graph_walk_next()
421  * points to the incoming pad and the first link of the entity.
424  * internal pad dependencies in the entity, and then links in the graph. It
425  * does so by iterating over all links of the entity, and following enabled
514 	entry->links = pad->entity->links.next;  in media_pipeline_walk_push()
518 		walk->stack.top, pad->entity->name, pad->index);  in media_pipeline_walk_push()
537 	if (entry->links->next == &entry->pad->entity->links) {  in media_pipeline_walk_pop()
572 				pad->entity->name, pad->index);  in media_pipeline_add_pad()
588 		pad->entity->name, pad->index);  in media_pipeline_add_pad()
593 /* Explore the next link of the entity at the top of the stack. */
617 		link->source->entity->name, link->source->index,  in media_pipeline_explore_next_link()
618 		link->sink->entity->name, link->sink->index);  in media_pipeline_explore_next_link()
621 	if (link->source->entity == origin->entity) {  in media_pipeline_explore_next_link()
631 	 * that is not connected internally in the entity to the incoming pad.  in media_pipeline_explore_next_link()
634 	    !media_entity_has_pad_interdep(origin->entity, origin->index,  in media_pipeline_explore_next_link()
662 	 * If we're done iterating over links, iterate over pads of the entity.  in media_pipeline_explore_next_link()
673 		local->entity->name);  in media_pipeline_explore_next_link()
675 	media_entity_for_each_pad(origin->entity, local) {  in media_pipeline_explore_next_link()
682 		    !media_entity_has_pad_interdep(origin->entity, origin->index,  in media_pipeline_explore_next_link()
743 			ppad->pad->entity->name, ppad->pad->index);  in media_pipeline_populate()
800 		struct media_entity *entity = pad->entity;  in __media_pipeline_start()  local
804 		dev_dbg(mdev->dev, "Validating pad '%s':%u\n", pad->entity->name,  in __media_pipeline_start()
813 				pad->entity->name, pad->index);  in __media_pipeline_start()
823 		for_each_media_entity_data_link(entity, link) {  in __media_pipeline_start()
842 			if (!entity->ops || !entity->ops->link_validate)  in __media_pipeline_start()
845 			ret = entity->ops->link_validate(link);  in __media_pipeline_start()
849 					link->source->entity->name,  in __media_pipeline_start()
851 					link->sink->entity->name,  in __media_pipeline_start()
858 				link->source->entity->name,  in __media_pipeline_start()
860 				link->sink->entity->name,  in __media_pipeline_start()
872 				pad->entity->name, pad->index);  in __media_pipeline_start()
1022 				  struct media_entity *entity)  in __media_pipeline_entity_iter_next()  argument
1024 	if (!entity)  in __media_pipeline_entity_iter_next()
1029 		struct media_entity *entity;  in __media_pipeline_entity_iter_next()  local
1032 		entity = ppad->pad->entity;  in __media_pipeline_entity_iter_next()
1035 		if (!media_entity_enum_test_and_set(&iter->ent_enum, entity))  in __media_pipeline_entity_iter_next()
1036 			return entity;  in __media_pipeline_entity_iter_next()
1060 static void __media_entity_remove_link(struct media_entity *entity,  in __media_entity_remove_link()  argument
1071 		if (link->source->entity == entity)  in __media_entity_remove_link()
1072 			remote = link->sink->entity;  in __media_entity_remove_link()
1074 			remote = link->source->entity;  in __media_entity_remove_link()
1080 			if (link->source->entity == entity)  in __media_entity_remove_link()
1098 int media_get_pad_index(struct media_entity *entity, u32 pad_type,  in media_get_pad_index()  argument
1103 	if (!entity)  in media_get_pad_index()
1106 	for (i = 0; i < entity->num_pads; i++) {  in media_get_pad_index()
1107 		if ((entity->pads[i].flags &  in media_get_pad_index()
1111 		if (entity->pads[i].sig_type == sig_type)  in media_get_pad_index()
1193 	struct media_entity *entity;  in media_create_pad_links()  local
1230 	media_device_for_each_entity(entity, mdev) {  in media_create_pad_links()
1231 		if (entity->function != function)  in media_create_pad_links()
1236 						    entity, sink_pad, flags);  in media_create_pad_links()
1238 			ret = media_create_pad_link(entity, source_pad,  in media_create_pad_links()
1248 void __media_entity_remove_links(struct media_entity *entity)  in __media_entity_remove_links()  argument
1252 	list_for_each_entry_safe(link, tmp, &entity->links, list)  in __media_entity_remove_links()
1253 		__media_entity_remove_link(entity, link);  in __media_entity_remove_links()
1255 	entity->num_links = 0;  in __media_entity_remove_links()
1256 	entity->num_backlinks = 0;  in __media_entity_remove_links()
1260 void media_entity_remove_links(struct media_entity *entity)  in media_entity_remove_links()  argument
1262 	struct media_device *mdev = entity->graph_obj.mdev;  in media_entity_remove_links()
1264 	/* Do nothing if the entity is not registered. */  in media_entity_remove_links()
1269 	__media_entity_remove_links(entity);  in media_entity_remove_links()
1279 	ret = media_entity_call(link->source->entity, link_setup,  in __media_entity_setup_link_notify()
1284 	ret = media_entity_call(link->sink->entity, link_setup,  in __media_entity_setup_link_notify()
1287 		media_entity_call(link->source->entity, link_setup,  in __media_entity_setup_link_notify()
1361 	for_each_media_entity_data_link(source->entity, link) {  in media_entity_find_link()
1362 		if (link->source->entity == source->entity &&  in media_entity_find_link()
1364 		    link->sink->entity == sink->entity &&  in media_entity_find_link()
1377 	for_each_media_entity_data_link(pad->entity, link) {  in media_pad_remote_pad_first()
1394 media_entity_remote_pad_unique(const struct media_entity *entity,  in media_entity_remote_pad_unique()  argument
1400 	list_for_each_entry(link, &entity->links, list) {  in media_entity_remote_pad_unique()
1417 		if (local_pad->entity == entity) {  in media_entity_remote_pad_unique()
1437 	list_for_each_entry(link, &pad->entity->links, list) {  in media_pad_remote_pad_unique()
1463 int media_entity_get_fwnode_pad(struct media_entity *entity,  in media_entity_get_fwnode_pad()  argument
1471 	if (!entity->ops || !entity->ops->get_fwnode_pad) {  in media_entity_get_fwnode_pad()
1472 		for (i = 0; i < entity->num_pads; i++) {  in media_entity_get_fwnode_pad()
1473 			if (entity->pads[i].flags & direction_flags)  in media_entity_get_fwnode_pad()
1484 	ret = entity->ops->get_fwnode_pad(entity, &endpoint);  in media_entity_get_fwnode_pad()
1488 	if (ret >= entity->num_pads)  in media_entity_get_fwnode_pad()
1491 	if (!(entity->pads[ret].flags & direction_flags))  in media_entity_get_fwnode_pad()
1498 struct media_pipeline *media_entity_pipeline(struct media_entity *entity)  in media_entity_pipeline()  argument
1502 	media_entity_for_each_pad(entity, pad) {  in media_entity_pipeline()
1559 struct media_link *media_create_intf_link(struct media_entity *entity,  in media_create_intf_link()  argument
1570 	link->entity = entity;  in media_create_intf_link()
1649 struct media_link *__media_entity_next_link(struct media_entity *entity,  in __media_entity_next_link()  argument
1654 		    : list_first_entry(&entity->links, typeof(*link), list);  in __media_entity_next_link()
1656 	list_for_each_entry_from(link, &entity->links, list)  in __media_entity_next_link()