3  *      uvc_ctrl.c  --  USB Video Class driver - Controls
34  * Controls
851  * UVC Controls
866 		ctrl = &entity->controls[i];  in __uvc_find_control()
953 			 * GET_RES is mandatory for XU controls, but some  in uvc_ctrl_populate_cache()
1260  * Mapping V4L2 controls to UVC controls can be straightforward if done well.
1261  * Most of the UVC controls exist in V4L2, and can be mapped directly. Some
1263  * Balance V4L2 controls use the White Balance Component UVC control) or
1265  * table for the controls that can be mapped directly, and handle the others
1355  * @handle can be NULL for asynchronous events related to auto-update controls,
1603  * To make extended set operations as atomic as the hardware allows, controls
1615  * After processing all controls in the transaction, uvc_ctrl_commit or
1617  * hardware or revert them. When applying changes, all controls marked as
1619  * cleared. When reverting controls, the control data field
1621  * (UVC_CTRL_DATA_BACKUP) for all dirty controls. Both functions release the
1640 		ctrl = &entity->controls[i];  in uvc_ctrl_commit_entity()
1645 		 * Reset the loaded flag for auto-update controls that were  in uvc_ctrl_commit_entity()
1648 		 * controls to prevent uvc_ctrl_set from setting bits not  in uvc_ctrl_commit_entity()
1695 		__uvc_find_control(entity, ctrls->controls[i].id, &mapping,  in uvc_ctrl_find_ctrl_idx()
1721 		uvc_ctrl_send_events(handle, ctrls->controls, ctrls->count);  in __uvc_ctrl_commit()
1806 		 * UVC controls that support it.  in uvc_ctrl_set()
1859  * Dynamic controls
1936  * Query control information (size and flags) for XU controls.
2046 		ctrl = &entity->controls[i];  in uvc_xu_ctrl_query()
2143  * Restore control values after resume, skipping controls that haven't been
2147  * - Don't restore modified controls that are back to their default value.
2158 	/* Walk the entities list and restore controls when possible. */  in uvc_ctrl_restore_values()
2162 			ctrl = &entity->controls[i];  in uvc_ctrl_restore_values()
2295 			ctrl = &entity->controls[i];  in uvc_ctrl_add_mapping()
2311 	/* Perform delayed initialization of XU controls */  in uvc_ctrl_add_mapping()
2355  * Prune an entity of its bogus controls using a blacklist. Bogus controls
2380 	u8 *controls;  in uvc_ctrl_prune_entity()  local
2386 		controls = entity->processing.bmControls;  in uvc_ctrl_prune_entity()
2393 		controls = entity->camera.bmControls;  in uvc_ctrl_prune_entity()
2406 		    !uvc_test_bit(controls, blacklist[i].index))  in uvc_ctrl_prune_entity()
2413 		uvc_clear_bit(controls, blacklist[i].index);  in uvc_ctrl_prune_entity()
2429 	 * XU controls initialization requires querying the device for control  in uvc_ctrl_init_ctrl()
2431 	 * repeatedly in a tight loop, delay XU controls initialization until  in uvc_ctrl_init_ctrl()
2447 			 * GET_INFO on standard controls.  in uvc_ctrl_init_ctrl()
2510  * Initialize device controls.
2517 	/* Walk the entities list and instantiate controls */  in uvc_ctrl_init_chain()
2537 		/* Remove bogus/blacklisted controls */  in uvc_ctrl_init_chain()
2540 		/* Count supported controls and allocate the controls array */  in uvc_ctrl_init_chain()
2545 		entity->controls = kcalloc(ncontrols, sizeof(*ctrl),  in uvc_ctrl_init_chain()
2547 		if (entity->controls == NULL)  in uvc_ctrl_init_chain()
2551 		/* Initialize all supported controls */  in uvc_ctrl_init_chain()
2552 		ctrl = entity->controls;  in uvc_ctrl_init_chain()
2585  * Cleanup device controls.
2609 	/* Free controls and control mappings for all entities. */  in uvc_ctrl_cleanup_device()
2612 			struct uvc_control *ctrl = &entity->controls[i];  in uvc_ctrl_cleanup_device()
2621 		kfree(entity->controls);  in uvc_ctrl_cleanup_device()