1. 先看APP以确定需要实现哪些接口

xawtv.c:
      grabber_scan
            ng_vid_open//根据链表的设置和读取可以在xawtv中找到是调用v4l2_driver.open
                  v4l2_driver.open // v4l2_open
                        get_device_capabilities(h);
                              // 调用VIDIOC_QUERYCTRL ioctl确定是否支持某个属性
                              /* controls */
                              for (i = 0; i < MAX_CTRL; i++) {
                	            h->ctl[i].id = V4L2_CID_BASE+i;
                	            if (-1 == xioctl(h->fd, VIDIOC_QUERYCTRL, &h->ctl[i], EINVAL) ||
                	                (h->ctl[i].flags & V4L2_CTRL_FLAG_DISABLED))
                	                h->ctl[i].id = -1;//不支持会在这赋值-1,以后看到这个-1就表示不支持了
                              }


怎么去获得/设置属性?
看drv0-v4l2.c
可见这2个函数:
v4l2_read_attr : VIDIOC_G_CTRL
v4l2_write_attr : VIDIOC_S_CTRL

所以: 视频驱动里要实现3个ioctl:
VIDIOC_QUERYCTRL
VIDIOC_G_CTRL
VIDIOC_S_CTRL

2. 硬件上怎么设置属性?
2.1 UVC规范里定义了哪些属性 : uvc_ctrl.c里数组: static struct uvc_control_info uvc_ctrls[]

{
		.entity		= UVC_GUID_UVC_PROCESSING, // 属于哪了个entity(比如PU)
		.selector	= PU_BRIGHTNESS_CONTROL,   // 用于亮度
		.index		= 0,                       // 对应Processing Unit Descriptor的bmControls[0]
		.size		= 2,                       // 发给硬件的数据长度为2字节
		.flags		= UVC_CONTROL_SET_CUR | UVC_CONTROL_GET_RANGE
				| UVC_CONTROL_RESTORE,
	},

里面的每一项都对应一个属性,entity表示那个单元,这里是表示PU,selector 用于区分PU里面的那个功能属性,index是这个功能属性的位置

2.2 我们的设备支持哪些属性
这需要去看描述符, 比如 Processing Unit Descriptor的bmControls的值为7f 14
可知BIT0为1,表示支持BRIGHTNESS

在代码里:

uvc_drvier.c
uvc_ctrl_init_device    
      // 对于每一个entity(IT,PU,SU,OT等)
	    list_for_each_entry(entity, &dev->entities, list) {
	          // 取出bmControls
	          bmControls = ....

	          // 计算bmControls里位值为1的个数,就是支持的属性个数
	          ncontrols += hweight8(bmControls[i]);    

	          // 为每一个属性分配一个struct uvc_control,这些ctrl都在controls指向的buf中
	          entity->controls = kzalloc(ncontrols *sizeof(*ctrl))

	          // 设置这些struct uvc_control
	          ctrl = entity->controls;
	          for (...)
	          {
    		        ctrl->entity = entity;
    		        ctrl->index = i;
		      }              // 把uvc_control和uvc_control_info挂构
              uvc_ctrl_add_ctrl(dev, info);
                    ctrl->info = 某个uvc_control_info数组项(同属于一个entity, index相同)

2.3 怎么去操作这些属性
  参考 uvc_query_v4l2_ctrl(应用程序会传下来一个id值,程序根据这个id值找到mapping结构体)

uvc_find_control
            找到一个uvc_control_mapping结构体: uvc_ctrl.c里有static struct uvc_control_mapping uvc_ctrl_mappings[] 
        	      {
        		        .id		= V4L2_CID_BRIGHTNESS,  // APP根据ID来找到对应的属性
        		        .name		= "Brightness",
        		        .entity		= UVC_GUID_UVC_PROCESSING,  // 属于哪了个entity(比如PU)
        		        .selector	= PU_BRIGHTNESS_CONTROL,    // 用于亮度
        		        .size		= 16,                       // 数据占多少位
        		        .offset		= 0,                        // 从哪位开始
        		        .v4l2_type	= V4L2_CTRL_TYPE_INTEGER,   // 属性类别,用于应用图形显示怎么控制属性,是下拉还是滑动图标等
        		        .data_type	= UVC_CTRL_DATA_TYPE_SIGNED,// 数据类型,用于用户下发控制属性的数据类型
        	       },             uvc_control_mapping结构体 用来更加细致地描述属性
      uvc_query_ctrl
            usb_control_msg

举例说明: 要设置亮度,怎么操作?
a. 根据PU的描述符的bmControls, 从它的bit0等于1知道它支持调节亮度
b. 在uvc_ctrls数组中根据entity和index找到这一项:

{
		    .entity		= UVC_GUID_UVC_PROCESSING,
		    .selector	= PU_BRIGHTNESS_CONTROL,
		    .index		= 0,
		    .size		= 2,
		    .flags		= UVC_CONTROL_SET_CUR | UVC_CONTROL_GET_RANGE
				        | UVC_CONTROL_RESTORE,
	  },

知道了:这个设备支持SET_CUR, GET_CUR, GET_MIN等
要设置时,可以向PU的selector发数据, 发的数据是2字节

c. 在uvc_ctrl_mappings数组中根据ID找到对应的数组项
从而知道了更加细致的信息,
然后使用usb_control_msg读写数据

3. 怎么写代码?
实现3个ioctl: vidioc_queryctrl/vidioc_g_ctrl/vidioc_s_ctrl
vidioc_queryctrl : 发起USB控制传输获得亮度的最小值、最大值、默认值、步进值
vidioc_s_ctrl : 把APP传入的亮度值通过USB传输发给硬件
vidioc_g_ctrl : 发起USB传输获得当前亮度值

要点:数据发给谁?发给usb_device的
            VideoControl Interface
              里面的Processing Unit
                里面的PU_BRIGHTNESS_CONTROL