3  *      uvc_ctrl.c  --  USB Video Class driver - Controls
33  * Controls
857  * UVC Controls
872 		ctrl = &entity->controls[i];  in __uvc_find_control()
958 			/* GET_RES is mandatory for XU controls, but some  in uvc_ctrl_populate_cache()
1136  * Mapping V4L2 controls to UVC controls can be straightforward if done well.
1137  * Most of the UVC controls exist in V4L2, and can be mapped directly. Some
1139  * Balance V4L2 controls use the White Balance Component UVC control) or
1141  * table for the controls that can be mapped directly, and handle the others
1231  * @handle can be NULL for asynchronous events related to auto-update controls,
1464  * To make extended set operations as atomic as the hardware allows, controls
1476  * After processing all controls in the transaction, uvc_ctrl_commit or
1478  * hardware or revert them. When applying changes, all controls marked as
1480  * cleared. When reverting controls, the control data field
1482  * (UVC_CTRL_DATA_BACKUP) for all dirty controls. Both functions release the
1501 		ctrl = &entity->controls[i];  in uvc_ctrl_commit_entity()
1505 		/* Reset the loaded flag for auto-update controls that were  in uvc_ctrl_commit_entity()
1508 		 * controls to prevent uvc_ctrl_set from setting bits not  in uvc_ctrl_commit_entity()
1631 		 * UVC controls that support it.  in uvc_ctrl_set()
1694  * Dynamic controls
1767  * Query control information (size and flags) for XU controls.
1877 		ctrl = &entity->controls[i];  in uvc_xu_ctrl_query()
1974  * Restore control values after resume, skipping controls that haven't been
1978  * - Don't restore modified controls that are back to their default value.
1989 	/* Walk the entities list and restore controls when possible. */  in uvc_ctrl_restore_values()
1993 			ctrl = &entity->controls[i];  in uvc_ctrl_restore_values()
2106 			ctrl = &entity->controls[i];  in uvc_ctrl_add_mapping()
2122 	/* Perform delayed initialization of XU controls */  in uvc_ctrl_add_mapping()
2166  * Prune an entity of its bogus controls using a blacklist. Bogus controls
2191 	u8 *controls;  in uvc_ctrl_prune_entity()  local
2197 		controls = entity->processing.bmControls;  in uvc_ctrl_prune_entity()
2204 		controls = entity->camera.bmControls;  in uvc_ctrl_prune_entity()
2217 		    !uvc_test_bit(controls, blacklist[i].index))  in uvc_ctrl_prune_entity()
2223 		uvc_clear_bit(controls, blacklist[i].index);  in uvc_ctrl_prune_entity()
2239 	/* XU controls initialization requires querying the device for control  in uvc_ctrl_init_ctrl()
2241 	 * repeatedly in a tight loop, delay XU controls initialization until  in uvc_ctrl_init_ctrl()
2255 			 * GET_INFO on standard controls.  in uvc_ctrl_init_ctrl()
2273  * Initialize device controls.
2282 	/* Walk the entities list and instantiate controls */  in uvc_ctrl_init_device()
2299 		/* Remove bogus/blacklisted controls */  in uvc_ctrl_init_device()
2302 		/* Count supported controls and allocate the controls array */  in uvc_ctrl_init_device()
2307 		entity->controls = kcalloc(ncontrols, sizeof(*ctrl),  in uvc_ctrl_init_device()
2309 		if (entity->controls == NULL)  in uvc_ctrl_init_device()
2313 		/* Initialize all supported controls */  in uvc_ctrl_init_device()
2314 		ctrl = entity->controls;  in uvc_ctrl_init_device()
2331  * Cleanup device controls.
2354 	/* Free controls and control mappings for all entities. */  in uvc_ctrl_cleanup_device()
2357 			struct uvc_control *ctrl = &entity->controls[i];  in uvc_ctrl_cleanup_device()
2366 		kfree(entity->controls);  in uvc_ctrl_cleanup_device()