3  *      uvc_ctrl.c  --  USB Video Class driver - Controls
36  * Controls
377  * For controls of type UVC_CTRL_DATA_TYPE_BITMASK, the UVC control value is
381  * control, which includes all controls whose type isn't UVC_CTRL_DATA_TYPE_ENUM
898  * UVC Controls
913 		ctrl = &entity->controls[i];  in __uvc_find_control()
1000 			 * GET_RES is mandatory for XU controls, but some  in uvc_ctrl_populate_cache()
1145  * For set operations on slave controls, check if the master's value is set to
1146  * manual, either in the others controls set in the same ioctl call, or from
1185 		if (ctrls->controls[i].id == mapping->master_id)  in uvc_ctrl_is_accessible()
1186 			return ctrls->controls[i].value ==  in uvc_ctrl_is_accessible()
1221 	 * Some controls, like CT_AE_MODE_CONTROL, use GET_RES to represent  in uvc_get_ctrl_bitmap()
1222 	 * the number of bits supported. Those controls do not list GET_MAX  in uvc_get_ctrl_bitmap()
1383  * Mapping V4L2 controls to UVC controls can be straightforward if done well.
1384  * Most of the UVC controls exist in V4L2, and can be mapped directly. Some
1386  * Balance V4L2 controls use the White Balance Component UVC control) or
1388  * table for the controls that can be mapped directly, and handle the others
1488  * @handle can be NULL for asynchronous events related to auto-update controls,
1740  * To make extended set operations as atomic as the hardware allows, controls
1752  * After processing all controls in the transaction, uvc_ctrl_commit or
1754  * hardware or revert them. When applying changes, all controls marked as
1756  * cleared. When reverting controls, the control data field
1758  * (UVC_CTRL_DATA_BACKUP) for all dirty controls. Both functions release the
1777 		ctrl = &entity->controls[i];  in uvc_ctrl_commit_entity()
1782 		 * Reset the loaded flag for auto-update controls that were  in uvc_ctrl_commit_entity()
1785 		 * controls to prevent uvc_ctrl_set from setting bits not  in uvc_ctrl_commit_entity()
1832 		__uvc_find_control(entity, ctrls->controls[i].id, &mapping,  in uvc_ctrl_find_ctrl_idx()
1858 		uvc_ctrl_send_events(handle, ctrls->controls, ctrls->count);  in __uvc_ctrl_commit()
1959 		 * UVC controls that support it.  in uvc_ctrl_set()
2009  * Dynamic controls
2093  * Query control information (size and flags) for XU controls.
2203 		ctrl = &entity->controls[i];  in uvc_xu_ctrl_query()
2300  * Restore control values after resume, skipping controls that haven't been
2304  * - Don't restore modified controls that are back to their default value.
2315 	/* Walk the entities list and restore controls when possible. */  in uvc_ctrl_restore_values()
2319 			ctrl = &entity->controls[i];  in uvc_ctrl_restore_values()
2470 			ctrl = &entity->controls[i];  in uvc_ctrl_add_mapping()
2486 	/* Perform delayed initialization of XU controls */  in uvc_ctrl_add_mapping()
2530  * Prune an entity of its bogus controls using a blacklist. Bogus controls
2555 	u8 *controls;  in uvc_ctrl_prune_entity()  local
2561 		controls = entity->processing.bmControls;  in uvc_ctrl_prune_entity()
2568 		controls = entity->camera.bmControls;  in uvc_ctrl_prune_entity()
2581 		    !uvc_test_bit(controls, blacklist[i].index))  in uvc_ctrl_prune_entity()
2588 		uvc_clear_bit(controls, blacklist[i].index);  in uvc_ctrl_prune_entity()
2603 	 * XU controls initialization requires querying the device for control  in uvc_ctrl_init_ctrl()
2605 	 * repeatedly in a tight loop, delay XU controls initialization until  in uvc_ctrl_init_ctrl()
2621 			 * GET_INFO on standard controls.  in uvc_ctrl_init_ctrl()
2679  * Initialize device controls.
2686 	/* Walk the entities list and instantiate controls */  in uvc_ctrl_init_chain()
2706 		/* Remove bogus/blacklisted controls */  in uvc_ctrl_init_chain()
2709 		/* Count supported controls and allocate the controls array */  in uvc_ctrl_init_chain()
2714 		entity->controls = kcalloc(ncontrols, sizeof(*ctrl),  in uvc_ctrl_init_chain()
2716 		if (entity->controls == NULL)  in uvc_ctrl_init_chain()
2720 		/* Initialize all supported controls */  in uvc_ctrl_init_chain()
2721 		ctrl = entity->controls;  in uvc_ctrl_init_chain()
2754  * Cleanup device controls.
2779 	/* Free controls and control mappings for all entities. */  in uvc_ctrl_cleanup_device()
2782 			struct uvc_control *ctrl = &entity->controls[i];  in uvc_ctrl_cleanup_device()
2791 		kfree(entity->controls);  in uvc_ctrl_cleanup_device()