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
945  * UVC Controls
960 		ctrl = &entity->controls[i];  in __uvc_find_control()
1047 			 * GET_RES is mandatory for XU controls, but some  in uvc_ctrl_populate_cache()
1192  * For set operations on slave controls, check if the master's value is set to
1193  * manual, either in the others controls set in the same ioctl call, or from
1232 		if (ctrls->controls[i].id == mapping->master_id)  in uvc_ctrl_is_accessible()
1233 			return ctrls->controls[i].value ==  in uvc_ctrl_is_accessible()
1268 	 * Some controls, like CT_AE_MODE_CONTROL, use GET_RES to represent  in uvc_get_ctrl_bitmap()
1269 	 * the number of bits supported. Those controls do not list GET_MAX  in uvc_get_ctrl_bitmap()
1430  * Mapping V4L2 controls to UVC controls can be straightforward if done well.
1431  * Most of the UVC controls exist in V4L2, and can be mapped directly. Some
1433  * Balance V4L2 controls use the White Balance Component UVC control) or
1435  * table for the controls that can be mapped directly, and handle the others
1535  * @handle can be NULL for asynchronous events related to auto-update controls,
1787  * To make extended set operations as atomic as the hardware allows, controls
1799  * After processing all controls in the transaction, uvc_ctrl_commit or
1801  * hardware or revert them. When applying changes, all controls marked as
1803  * cleared. When reverting controls, the control data field
1805  * (UVC_CTRL_DATA_BACKUP) for all dirty controls. Both functions release the
1824 		ctrl = &entity->controls[i];  in uvc_ctrl_commit_entity()
1829 		 * Reset the loaded flag for auto-update controls that were  in uvc_ctrl_commit_entity()
1832 		 * controls to prevent uvc_ctrl_set from setting bits not  in uvc_ctrl_commit_entity()
1879 		__uvc_find_control(entity, ctrls->controls[i].id, &mapping,  in uvc_ctrl_find_ctrl_idx()
1910 		uvc_ctrl_send_events(handle, ctrls->controls, ctrls->count);  in __uvc_ctrl_commit()
2008 		 * UVC controls that support it.  in uvc_ctrl_set()
2058  * Dynamic controls
2142  * Query control information (size and flags) for XU controls.
2252 		ctrl = &entity->controls[i];  in uvc_xu_ctrl_query()
2349  * Restore control values after resume, skipping controls that haven't been
2353  * - Don't restore modified controls that are back to their default value.
2364 	/* Walk the entities list and restore controls when possible. */  in uvc_ctrl_restore_values()
2368 			ctrl = &entity->controls[i];  in uvc_ctrl_restore_values()
2519 			ctrl = &entity->controls[i];  in uvc_ctrl_add_mapping()
2535 	/* Perform delayed initialization of XU controls */  in uvc_ctrl_add_mapping()
2579  * Prune an entity of its bogus controls using a blacklist. Bogus controls
2604 	u8 *controls;  in uvc_ctrl_prune_entity()  local
2610 		controls = entity->processing.bmControls;  in uvc_ctrl_prune_entity()
2617 		controls = entity->camera.bmControls;  in uvc_ctrl_prune_entity()
2630 		    !uvc_test_bit(controls, blacklist[i].index))  in uvc_ctrl_prune_entity()
2637 		uvc_clear_bit(controls, blacklist[i].index);  in uvc_ctrl_prune_entity()
2651 	 * XU controls initialization requires querying the device for control  in uvc_ctrl_init_ctrl()
2653 	 * repeatedly in a tight loop, delay XU controls initialization until  in uvc_ctrl_init_ctrl()
2669 			 * GET_INFO on standard controls.  in uvc_ctrl_init_ctrl()
2699  * Initialize device controls.
2706 	/* Walk the entities list and instantiate controls */  in uvc_ctrl_init_chain()
2726 		/* Remove bogus/blacklisted controls */  in uvc_ctrl_init_chain()
2729 		/* Count supported controls and allocate the controls array */  in uvc_ctrl_init_chain()
2734 		entity->controls = kcalloc(ncontrols, sizeof(*ctrl),  in uvc_ctrl_init_chain()
2736 		if (entity->controls == NULL)  in uvc_ctrl_init_chain()
2740 		/* Initialize all supported controls */  in uvc_ctrl_init_chain()
2741 		ctrl = entity->controls;  in uvc_ctrl_init_chain()
2774  * Cleanup device controls.
2799 	/* Free controls and control mappings for all entities. */  in uvc_ctrl_cleanup_device()
2802 			struct uvc_control *ctrl = &entity->controls[i];  in uvc_ctrl_cleanup_device()
2811 		kfree(entity->controls);  in uvc_ctrl_cleanup_device()