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