8.初始化uvc控制
8.1 重要结构体
struct uvc_control { //uvc控制
struct uvc_entity *entity; //uvc实体
struct uvc_control_info info; //uvc控制信息
__u8 index; //索引值
__u8 dirty:1,
loaded:1,
modified:1,
cached:1,
initialized:1; //初始化标志
__u8 *uvc_data; //uvc控制数据
};
int uvc_ctrl_init_device(struct uvc_device *dev)
{
struct uvc_entity *entity;
unsigned int i;
/* Walk the entities list and instantiate controls */
list_for_each_entry(entity, &dev->entities, list) { //遍历uvc设备实体entities链表
struct uvc_control *ctrl; //uvc控制
unsigned int bControlSize = 0, ncontrols = 0;
__u8 *bmControls = NULL;
if (UVC_ENTITY_TYPE(entity) == UVC_VC_EXTENSION_UNIT) { //扩展Unit
bmControls = entity->extension.bmControls; //控制位图
bControlSize = entity->extension.bControlSize; //控制位域大小
}
else if (UVC_ENTITY_TYPE(entity) == UVC_VC_PROCESSING_UNIT) { //处理Unit
bmControls = entity->processing.bmControls; //控制位图
bControlSize = entity->processing.bControlSize; //控制位域大小
}
else if (UVC_ENTITY_TYPE(entity) == UVC_ITT_CAMERA) { //输入Terminal Camera
bmControls = entity->camera.bmControls; //控制位图
bControlSize = entity->camera.bControlSize; //控制位域大小
}
/* Remove bogus/blacklisted controls 移除假的/黑名单控制组件*/
uvc_ctrl_prune_entity(dev, entity);
/* Count supported controls and allocate the controls array */
for (i = 0; i < bControlSize; ++i)
ncontrols += hweight8(bmControls[i]); //统计控制组件个数
if (ncontrols == 0)
continue;
entity->controls = kzalloc(ncontrols * sizeof(*ctrl),GFP_KERNEL); //分配ncontrols个uvc控制内存
if (entity->controls == NULL)
return -ENOMEM;
entity->ncontrols = ncontrols; //设置uvc控制个数
/* Initialize all supported controls */
ctrl = entity->controls; //指向uvc控制数组
for (i = 0; i < bControlSize * 8; ++i) {
if (uvc_test_bit(bmControls, i) == 0) //跳过控制位域没设置1的
continue;
ctrl->entity = entity; //捆绑uvc实体和uvc控制
ctrl->index = i; //设置控制位域索引
uvc_ctrl_init_ctrl(dev, ctrl); //9初始化uvc控件
ctrl++; //uvc控制 指向下一个uvc控制数组项
}
}
return 0;
}
9初始化uvc控件
9.1 相关结构体
9.1.1 uvc控制信息
struct uvc_control_info { //uvc控制信息
struct list_head mappings; //uvc控制位图链表头
__u8 entity[16];
__u8 index; /* Bit index in bmControls */
__u8 selector;
__u16 size;
__u32 flags;
};
struct uvc_control_mapping { //uvc控制位图
struct list_head list; //链表
struct uvc_control_info *ctrl; //uvc控制信息
__u32 id;
__u8 name[32];
__u8 entity[16];
__u8 selector;
__u8 size;
__u8 offset;
enum v4l2_ctrl_type v4l2_type; //v4l2控制类型
__u32 data_type;
struct uvc_menu_info *menu_info; //uvc菜单信息
__u32 menu_count; //uvc菜单个数
__s32 (*get) (struct uvc_control_mapping *mapping, __u8 query,const __u8 *data);
void (*set) (struct uvc_control_mapping *mapping, __s32 value,__u8 *data);
};
9.2 初始化uvc控制
static void uvc_ctrl_init_ctrl(struct uvc_device *dev, struct uvc_control *ctrl)
{
const struct uvc_control_info *info = uvc_ctrls; //指向全局静态uvc控制信息数组
const struct uvc_control_info *iend = info + ARRAY_SIZE(uvc_ctrls); //指向数组末端
const struct uvc_control_mapping *mapping = uvc_ctrl_mappings; //指向全局静态uvc控制位图数组
const struct uvc_control_mapping *mend = mapping + ARRAY_SIZE(uvc_ctrl_mappings); //指向数组末端
if (UVC_ENTITY_TYPE(ctrl->entity) == UVC_VC_EXTENSION_UNIT) //ctrl->entity->type为扩展Unit(延后扩展Unit的初始化到当它第一次使用)
return;
for (; info < iend; ++info) { //遍历整个uvc控制信息数据
if (uvc_entity_match_guid(ctrl->entity, info->entity) && ctrl->index == info->index) { //匹配条件
uvc_ctrl_add_info(dev, ctrl, info); //添加uvc控制信息
break;
}
}
if (!ctrl->initialized) //已经给初始化
return;
for (; mapping < mend; ++mapping) { //遍历整个uvc