xref: /OK3568_Linux_fs/kernel/drivers/media/usb/uvc/uvc_entity.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-or-later
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  *      uvc_entity.c  --  USB Video Class driver
4*4882a593Smuzhiyun  *
5*4882a593Smuzhiyun  *      Copyright (C) 2005-2011
6*4882a593Smuzhiyun  *          Laurent Pinchart (laurent.pinchart@ideasonboard.com)
7*4882a593Smuzhiyun  */
8*4882a593Smuzhiyun 
9*4882a593Smuzhiyun #include <linux/kernel.h>
10*4882a593Smuzhiyun #include <linux/list.h>
11*4882a593Smuzhiyun #include <linux/videodev2.h>
12*4882a593Smuzhiyun 
13*4882a593Smuzhiyun #include <media/v4l2-common.h>
14*4882a593Smuzhiyun 
15*4882a593Smuzhiyun #include "uvcvideo.h"
16*4882a593Smuzhiyun 
uvc_mc_create_links(struct uvc_video_chain * chain,struct uvc_entity * entity)17*4882a593Smuzhiyun static int uvc_mc_create_links(struct uvc_video_chain *chain,
18*4882a593Smuzhiyun 				    struct uvc_entity *entity)
19*4882a593Smuzhiyun {
20*4882a593Smuzhiyun 	const u32 flags = MEDIA_LNK_FL_ENABLED | MEDIA_LNK_FL_IMMUTABLE;
21*4882a593Smuzhiyun 	struct media_entity *sink;
22*4882a593Smuzhiyun 	unsigned int i;
23*4882a593Smuzhiyun 	int ret;
24*4882a593Smuzhiyun 
25*4882a593Smuzhiyun 	sink = (UVC_ENTITY_TYPE(entity) == UVC_TT_STREAMING)
26*4882a593Smuzhiyun 	     ? (entity->vdev ? &entity->vdev->entity : NULL)
27*4882a593Smuzhiyun 	     : &entity->subdev.entity;
28*4882a593Smuzhiyun 	if (sink == NULL)
29*4882a593Smuzhiyun 		return 0;
30*4882a593Smuzhiyun 
31*4882a593Smuzhiyun 	for (i = 0; i < entity->num_pads; ++i) {
32*4882a593Smuzhiyun 		struct media_entity *source;
33*4882a593Smuzhiyun 		struct uvc_entity *remote;
34*4882a593Smuzhiyun 		u8 remote_pad;
35*4882a593Smuzhiyun 
36*4882a593Smuzhiyun 		if (!(entity->pads[i].flags & MEDIA_PAD_FL_SINK))
37*4882a593Smuzhiyun 			continue;
38*4882a593Smuzhiyun 
39*4882a593Smuzhiyun 		remote = uvc_entity_by_id(chain->dev, entity->baSourceID[i]);
40*4882a593Smuzhiyun 		if (remote == NULL)
41*4882a593Smuzhiyun 			return -EINVAL;
42*4882a593Smuzhiyun 
43*4882a593Smuzhiyun 		source = (UVC_ENTITY_TYPE(remote) == UVC_TT_STREAMING)
44*4882a593Smuzhiyun 		       ? (remote->vdev ? &remote->vdev->entity : NULL)
45*4882a593Smuzhiyun 		       : &remote->subdev.entity;
46*4882a593Smuzhiyun 		if (source == NULL)
47*4882a593Smuzhiyun 			continue;
48*4882a593Smuzhiyun 
49*4882a593Smuzhiyun 		remote_pad = remote->num_pads - 1;
50*4882a593Smuzhiyun 		ret = media_create_pad_link(source, remote_pad,
51*4882a593Smuzhiyun 					       sink, i, flags);
52*4882a593Smuzhiyun 		if (ret < 0)
53*4882a593Smuzhiyun 			return ret;
54*4882a593Smuzhiyun 	}
55*4882a593Smuzhiyun 
56*4882a593Smuzhiyun 	return 0;
57*4882a593Smuzhiyun }
58*4882a593Smuzhiyun 
59*4882a593Smuzhiyun static const struct v4l2_subdev_ops uvc_subdev_ops = {
60*4882a593Smuzhiyun };
61*4882a593Smuzhiyun 
uvc_mc_cleanup_entity(struct uvc_entity * entity)62*4882a593Smuzhiyun void uvc_mc_cleanup_entity(struct uvc_entity *entity)
63*4882a593Smuzhiyun {
64*4882a593Smuzhiyun 	if (UVC_ENTITY_TYPE(entity) != UVC_TT_STREAMING)
65*4882a593Smuzhiyun 		media_entity_cleanup(&entity->subdev.entity);
66*4882a593Smuzhiyun 	else if (entity->vdev != NULL)
67*4882a593Smuzhiyun 		media_entity_cleanup(&entity->vdev->entity);
68*4882a593Smuzhiyun }
69*4882a593Smuzhiyun 
uvc_mc_init_entity(struct uvc_video_chain * chain,struct uvc_entity * entity)70*4882a593Smuzhiyun static int uvc_mc_init_entity(struct uvc_video_chain *chain,
71*4882a593Smuzhiyun 			      struct uvc_entity *entity)
72*4882a593Smuzhiyun {
73*4882a593Smuzhiyun 	int ret;
74*4882a593Smuzhiyun 
75*4882a593Smuzhiyun 	if (UVC_ENTITY_TYPE(entity) != UVC_TT_STREAMING) {
76*4882a593Smuzhiyun 		u32 function;
77*4882a593Smuzhiyun 
78*4882a593Smuzhiyun 		v4l2_subdev_init(&entity->subdev, &uvc_subdev_ops);
79*4882a593Smuzhiyun 		strscpy(entity->subdev.name, entity->name,
80*4882a593Smuzhiyun 			sizeof(entity->subdev.name));
81*4882a593Smuzhiyun 
82*4882a593Smuzhiyun 		switch (UVC_ENTITY_TYPE(entity)) {
83*4882a593Smuzhiyun 		case UVC_VC_SELECTOR_UNIT:
84*4882a593Smuzhiyun 			function = MEDIA_ENT_F_VID_MUX;
85*4882a593Smuzhiyun 			break;
86*4882a593Smuzhiyun 		case UVC_VC_PROCESSING_UNIT:
87*4882a593Smuzhiyun 		case UVC_VC_EXTENSION_UNIT:
88*4882a593Smuzhiyun 			/* For lack of a better option. */
89*4882a593Smuzhiyun 			function = MEDIA_ENT_F_PROC_VIDEO_PIXEL_FORMATTER;
90*4882a593Smuzhiyun 			break;
91*4882a593Smuzhiyun 		case UVC_COMPOSITE_CONNECTOR:
92*4882a593Smuzhiyun 		case UVC_COMPONENT_CONNECTOR:
93*4882a593Smuzhiyun 			function = MEDIA_ENT_F_CONN_COMPOSITE;
94*4882a593Smuzhiyun 			break;
95*4882a593Smuzhiyun 		case UVC_SVIDEO_CONNECTOR:
96*4882a593Smuzhiyun 			function = MEDIA_ENT_F_CONN_SVIDEO;
97*4882a593Smuzhiyun 			break;
98*4882a593Smuzhiyun 		case UVC_ITT_CAMERA:
99*4882a593Smuzhiyun 			function = MEDIA_ENT_F_CAM_SENSOR;
100*4882a593Smuzhiyun 			break;
101*4882a593Smuzhiyun 		case UVC_TT_VENDOR_SPECIFIC:
102*4882a593Smuzhiyun 		case UVC_ITT_VENDOR_SPECIFIC:
103*4882a593Smuzhiyun 		case UVC_ITT_MEDIA_TRANSPORT_INPUT:
104*4882a593Smuzhiyun 		case UVC_OTT_VENDOR_SPECIFIC:
105*4882a593Smuzhiyun 		case UVC_OTT_DISPLAY:
106*4882a593Smuzhiyun 		case UVC_OTT_MEDIA_TRANSPORT_OUTPUT:
107*4882a593Smuzhiyun 		case UVC_EXTERNAL_VENDOR_SPECIFIC:
108*4882a593Smuzhiyun 		default:
109*4882a593Smuzhiyun 			function = MEDIA_ENT_F_V4L2_SUBDEV_UNKNOWN;
110*4882a593Smuzhiyun 			break;
111*4882a593Smuzhiyun 		}
112*4882a593Smuzhiyun 
113*4882a593Smuzhiyun 		entity->subdev.entity.function = function;
114*4882a593Smuzhiyun 
115*4882a593Smuzhiyun 		ret = media_entity_pads_init(&entity->subdev.entity,
116*4882a593Smuzhiyun 					entity->num_pads, entity->pads);
117*4882a593Smuzhiyun 
118*4882a593Smuzhiyun 		if (ret < 0)
119*4882a593Smuzhiyun 			return ret;
120*4882a593Smuzhiyun 
121*4882a593Smuzhiyun 		ret = v4l2_device_register_subdev(&chain->dev->vdev,
122*4882a593Smuzhiyun 						  &entity->subdev);
123*4882a593Smuzhiyun 	} else if (entity->vdev != NULL) {
124*4882a593Smuzhiyun 		ret = media_entity_pads_init(&entity->vdev->entity,
125*4882a593Smuzhiyun 					entity->num_pads, entity->pads);
126*4882a593Smuzhiyun 		if (entity->flags & UVC_ENTITY_FLAG_DEFAULT)
127*4882a593Smuzhiyun 			entity->vdev->entity.flags |= MEDIA_ENT_FL_DEFAULT;
128*4882a593Smuzhiyun 	} else
129*4882a593Smuzhiyun 		ret = 0;
130*4882a593Smuzhiyun 
131*4882a593Smuzhiyun 	return ret;
132*4882a593Smuzhiyun }
133*4882a593Smuzhiyun 
uvc_mc_register_entities(struct uvc_video_chain * chain)134*4882a593Smuzhiyun int uvc_mc_register_entities(struct uvc_video_chain *chain)
135*4882a593Smuzhiyun {
136*4882a593Smuzhiyun 	struct uvc_entity *entity;
137*4882a593Smuzhiyun 	int ret;
138*4882a593Smuzhiyun 
139*4882a593Smuzhiyun 	list_for_each_entry(entity, &chain->entities, chain) {
140*4882a593Smuzhiyun 		ret = uvc_mc_init_entity(chain, entity);
141*4882a593Smuzhiyun 		if (ret < 0) {
142*4882a593Smuzhiyun 			uvc_printk(KERN_INFO, "Failed to initialize entity for "
143*4882a593Smuzhiyun 				   "entity %u\n", entity->id);
144*4882a593Smuzhiyun 			return ret;
145*4882a593Smuzhiyun 		}
146*4882a593Smuzhiyun 	}
147*4882a593Smuzhiyun 
148*4882a593Smuzhiyun 	list_for_each_entry(entity, &chain->entities, chain) {
149*4882a593Smuzhiyun 		ret = uvc_mc_create_links(chain, entity);
150*4882a593Smuzhiyun 		if (ret < 0) {
151*4882a593Smuzhiyun 			uvc_printk(KERN_INFO, "Failed to create links for "
152*4882a593Smuzhiyun 				   "entity %u\n", entity->id);
153*4882a593Smuzhiyun 			return ret;
154*4882a593Smuzhiyun 		}
155*4882a593Smuzhiyun 	}
156*4882a593Smuzhiyun 
157*4882a593Smuzhiyun 	return 0;
158*4882a593Smuzhiyun }
159