1.0 Martin Rubli, Logitech http://www.quickcamteam.net/ 0.17 Copyright (c) 2006-2008 Logitech 0.17, 2008-10-17: - Mark the GET_CUR request as supported for the XU_MOTORCONTROL_FOCUS control. 0.16, 2008-03-07: - Updated the values of V4L2_CID_PAN_RELATIVE and V4L2_CID_PAN_RELATIVE to work with the latest UVC driver (those values will be part of kernels >= 2.6.26). - Support for two new controls defined by V4L2 starting from 2.6.26:V4L2_CID_PAN_RESET ('Pan Reset') and V4L2_CID_TILT_RESET ('Tilt reset'). 0.15, 2007-12-13: - Added a control to change the LED blink frequency. - Added the two controls required for enabling Bayer mode (Disable video processing and Raw bits per pixel). 0.14, 2007-11-19: - Fixed the bitmap indices which were off by one. 0.13, 2007-11-16: - Added focus motor control for cameras that support it (QuickCam Pro 9000, QuickCam Pro for Notebooks, QuickCam Orbit/Sphere AF). - Added the pan/tilt reset control for the QuickCam Orbit/Sphere series. - Added a control to change the LED mode. 0.12, 2007-11-02: - Initial release to the public UVC_GUID_LOGITECH_USER_HW_CONTROL 63610682-5070-49ab-b8cc-b3855e8d221f UVC_GUID_LOGITECH_VIDEO_PIPE 63610682-5070-49ab-b8cc-b3855e8d2250 UVC_GUID_LOGITECH_MOTOR_CONTROL 63610682-5070-49ab-b8cc-b3855e8d2256 XU_HW_CONTROL_LED1 1 XU_COLOR_PROCESSING_DISABLE 5 XU_RAW_DATA_BITS_PER_PIXEL 8 XU_MOTORCONTROL_PANTILT_RELATIVE 1 XU_MOTORCONTROL_PANTILT_RESET 2 XU_MOTORCONTROL_FOCUS 3 V4L2_CID_PAN_RELATIVE 0x009A0904 V4L2_CID_TILT_RELATIVE 0x009A0905 V4L2_CID_PANTILT_RESET 0x0A046D03 V4L2_CID_PAN_RESET 0x009A0906 V4L2_CID_TILT_RESET 0x009A0907 V4L2_CID_FOCUS 0x0A046D04 V4L2_CID_LED1_MODE 0x0A046D05 V4L2_CID_LED1_FREQUENCY 0x0A046D06 V4L2_CID_DISABLE_PROCESSING 0x0A046D71 V4L2_CID_RAW_BITS_PER_PIXEL 0x0A046D72 0x046d UVC_GUID_LOGITECH_VIDEO_PIPE XU_COLOR_PROCESSING_DISABLE 1 Enable or disable the color processing pipeline within the camera. 0 = color processing enabled (default) 1 = color processing disabled UVC_GUID_LOGITECH_VIDEO_PIPE XU_RAW_DATA_BITS_PER_PIXEL 1 Specify the number of bits per pixel for raw data. This value is only relevant if XU_COLOR_PROCESSING_DISABLE is set to 0. 0 = 8 bits per pixel (default) 1 = 10 bits per pixel UVC_GUID_LOGITECH_USER_HW_CONTROL XU_HW_CONTROL_LED1 3 Allows control over the state of the first LED. Bits 0 to 7 represent the LED mode. Currently, the following modes are available: - 0: Off. The LED is never illuminated, whether or not the device is streaming video. - 1: On. The LED is always illuminated, whether or not the device is streaming video. - 2: Blinking. The LED blinks, whether or not the device is streaming video. - 3: Auto. The LED is in control of the device. Typically this means that means that is is illuminated when streaming video and off when not streaming video. Bits 16 to 23 represent the LED frequency. The frequency value only influences the 'Blinking' mode. It is expressed in units of 0.05 Hz and sets the blink frequency f. The blink interval T = 1/f is defined as the time between two adjoining rising edges (or two adjoining falling edges). The following table illustrates the relation between the LED frequency value used in bits 16 to 23, the physical blink frequency, and the physical blink interval. +-------------------------------+------------------------+----------------------+ | Frequency value 20f [0.05 Hz] | Blink frequency f [Hz] | Blink interval T [s] | +-------------------------------+------------------------+----------------------+ | 1 | 0.05 | 20 | | 2 | 0.1 | 10 | | 10 | 0.5 | 2 | | 20 | 1 | 1 | | 50 | 2.5 | 0.4 | | 100 | 5 | 0.2 | +-------------------------------+------------------------+----------------------+ 0x046d 0x0990 0x0991 0x0994 UVC_GUID_LOGITECH_MOTOR_CONTROL XU_MOTORCONTROL_FOCUS 6 Allows the control of focus motor movements for camera models that support mechanical focus. Bits 0 to 7 allow selection of the desired lens position. There are no physical units, instead, the focus range is spread over 256 logical units with 0 representing infinity focus and 255 being macro focus. 0x046d 0x08c2 0x08cc 0x0994 UVC_GUID_LOGITECH_MOTOR_CONTROL XU_MOTORCONTROL_PANTILT_RELATIVE 4 Allows the control of pan/tilt motor movements for camera models that support mechanical pan/tilt. Bits 0 to 15 control pan, bits 16 to 31 control tilt. The unit of the pan/tilt values is 1/64th of a degree and the resolution is 1 degree. UVC_GUID_LOGITECH_MOTOR_CONTROL XU_MOTORCONTROL_PANTILT_RESET 1 Reset the pan/tilt motors to their original position for camera models that support mechanical pan/tilt. Setting bit 0 resets the pan position. Setting bit 1 resets the tilt position. Both bits can be set at the same time to reset both, pan and tilt, at the same time. Pan (relative) 16 0 UVC_CTRL_DATA_TYPE_SIGNED V4L2_CID_PAN_RELATIVE V4L2_CTRL_TYPE_INTEGER Tilt (relative) 16 16 UVC_CTRL_DATA_TYPE_SIGNED V4L2_CID_TILT_RELATIVE V4L2_CTRL_TYPE_INTEGER Pan Reset 1 0 UVC_CTRL_DATA_TYPE_UNSIGNED V4L2_CID_PAN_RESET V4L2_CTRL_TYPE_INTEGER Tilt Reset 1 1 UVC_CTRL_DATA_TYPE_UNSIGNED V4L2_CID_TILT_RESET V4L2_CTRL_TYPE_INTEGER Pan/tilt Reset 8 0 UVC_CTRL_DATA_TYPE_UNSIGNED V4L2_CID_PANTILT_RESET V4L2_CTRL_TYPE_INTEGER Focus 8 0 UVC_CTRL_DATA_TYPE_UNSIGNED V4L2_CID_FOCUS V4L2_CTRL_TYPE_INTEGER LED1 Mode 8 0 UVC_CTRL_DATA_TYPE_UNSIGNED V4L2_CID_LED1_MODE V4L2_CTRL_TYPE_INTEGER LED1 Frequency 8 16 UVC_CTRL_DATA_TYPE_UNSIGNED V4L2_CID_LED1_FREQUENCY V4L2_CTRL_TYPE_INTEGER Disable video processing 8 0 UVC_CTRL_DATA_TYPE_BOOLEAN V4L2_CID_DISABLE_PROCESSING V4L2_CTRL_TYPE_BOOLEAN Raw bits per pixel 8 0 UVC_CTRL_DATA_TYPE_UNSIGNED V4L2_CID_RAW_BITS_PER_PIXEL V4L2_CTRL_TYPE_INTEGER