blob: 30c0ab61bef47407717f0354506dabff8c550271 [file] [log] [blame]
/* This is an AUTO-GENERATED file! Update it with the output of `ctrl-gen.py def`. */
#include "libuvc/libuvc.h"
#include "libuvc/libuvc_internal.h"
static const int REQ_TYPE_SET = 0x21;
static const int REQ_TYPE_GET = 0xa1;
/** @ingroup ctrl
* @brief Reads the SCANNING_MODE control.
* @param devh UVC device handle
* @param[out] mode 0: interlaced, 1: progressive
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_scanning_mode(uvc_device_handle_t *devh, uint8_t* mode, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_SCANNING_MODE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*mode = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the SCANNING_MODE control.
* @param devh UVC device handle
* @param mode 0: interlaced, 1: progressive
*/
uvc_error_t uvc_set_scanning_mode(uvc_device_handle_t *devh, uint8_t mode) {
uint8_t data[1];
uvc_error_t ret;
data[0] = mode;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_SCANNING_MODE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads camera's auto-exposure mode.
*
* See uvc_set_ae_mode() for a description of the available modes.
* @param devh UVC device handle
* @param[out] mode 1: manual mode; 2: auto mode; 4: shutter priority mode; 8: aperture priority mode
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_ae_mode(uvc_device_handle_t *devh, uint8_t* mode, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_AE_MODE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*mode = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets camera's auto-exposure mode.
*
* Cameras may support any of the following AE modes:
* * UVC_AUTO_EXPOSURE_MODE_MANUAL (1) - manual exposure time, manual iris
* * UVC_AUTO_EXPOSURE_MODE_AUTO (2) - auto exposure time, auto iris
* * UVC_AUTO_EXPOSURE_MODE_SHUTTER_PRIORITY (4) - manual exposure time, auto iris
* * UVC_AUTO_EXPOSURE_MODE_APERTURE_PRIORITY (8) - auto exposure time, manual iris
*
* Most cameras provide manual mode and aperture priority mode.
* @param devh UVC device handle
* @param mode 1: manual mode; 2: auto mode; 4: shutter priority mode; 8: aperture priority mode
*/
uvc_error_t uvc_set_ae_mode(uvc_device_handle_t *devh, uint8_t mode) {
uint8_t data[1];
uvc_error_t ret;
data[0] = mode;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_AE_MODE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Checks whether the camera may vary the frame rate for exposure control reasons.
* See uvc_set_ae_priority() for a description of the `priority` field.
* @param devh UVC device handle
* @param[out] priority 0: frame rate must remain constant; 1: frame rate may be varied for AE purposes
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_ae_priority(uvc_device_handle_t *devh, uint8_t* priority, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_AE_PRIORITY_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*priority = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Chooses whether the camera may vary the frame rate for exposure control reasons.
* A `priority` value of zero means the camera may not vary its frame rate. A value of 1
* means the frame rate is variable. This setting has no effect outside of the `auto` and
* `shutter_priority` auto-exposure modes.
* @param devh UVC device handle
* @param priority 0: frame rate must remain constant; 1: frame rate may be varied for AE purposes
*/
uvc_error_t uvc_set_ae_priority(uvc_device_handle_t *devh, uint8_t priority) {
uint8_t data[1];
uvc_error_t ret;
data[0] = priority;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_AE_PRIORITY_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Gets the absolute exposure time.
*
* See uvc_set_exposure_abs() for a description of the `time` field.
* @param devh UVC device handle
* @param[out] time
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_exposure_abs(uvc_device_handle_t *devh, uint32_t* time, enum uvc_req_code req_code) {
uint8_t data[4];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_EXPOSURE_TIME_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*time = DW_TO_INT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the absolute exposure time.
*
* The `time` parameter should be provided in units of 0.0001 seconds (e.g., use the value 100
* for a 10ms exposure period). Auto exposure should be set to `manual` or `shutter_priority`
* before attempting to change this setting.
* @param devh UVC device handle
* @param time
*/
uvc_error_t uvc_set_exposure_abs(uvc_device_handle_t *devh, uint32_t time) {
uint8_t data[4];
uvc_error_t ret;
INT_TO_DW(time, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_EXPOSURE_TIME_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the exposure time relative to the current setting.
* @param devh UVC device handle
* @param[out] step number of steps by which to change the exposure time, or zero to set the default exposure time
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_exposure_rel(uvc_device_handle_t *devh, int8_t* step, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_EXPOSURE_TIME_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*step = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the exposure time relative to the current setting.
* @param devh UVC device handle
* @param step number of steps by which to change the exposure time, or zero to set the default exposure time
*/
uvc_error_t uvc_set_exposure_rel(uvc_device_handle_t *devh, int8_t step) {
uint8_t data[1];
uvc_error_t ret;
data[0] = step;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_EXPOSURE_TIME_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the distance at which an object is optimally focused.
* @param devh UVC device handle
* @param[out] focus focal target distance in millimeters
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_focus_abs(uvc_device_handle_t *devh, uint16_t* focus, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_FOCUS_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*focus = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the distance at which an object is optimally focused.
* @param devh UVC device handle
* @param focus focal target distance in millimeters
*/
uvc_error_t uvc_set_focus_abs(uvc_device_handle_t *devh, uint16_t focus) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(focus, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_FOCUS_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the FOCUS_RELATIVE control.
* @param devh UVC device handle
* @param[out] focus_rel TODO
* @param[out] speed TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_focus_rel(uvc_device_handle_t *devh, int8_t* focus_rel, uint8_t* speed, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_FOCUS_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*focus_rel = data[0];
*speed = data[1];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the FOCUS_RELATIVE control.
* @param devh UVC device handle
* @param focus_rel TODO
* @param speed TODO
*/
uvc_error_t uvc_set_focus_rel(uvc_device_handle_t *devh, int8_t focus_rel, uint8_t speed) {
uint8_t data[2];
uvc_error_t ret;
data[0] = focus_rel;
data[1] = speed;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_FOCUS_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the FOCUS_SIMPLE control.
* @param devh UVC device handle
* @param[out] focus TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_focus_simple_range(uvc_device_handle_t *devh, uint8_t* focus, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_FOCUS_SIMPLE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*focus = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the FOCUS_SIMPLE control.
* @param devh UVC device handle
* @param focus TODO
*/
uvc_error_t uvc_set_focus_simple_range(uvc_device_handle_t *devh, uint8_t focus) {
uint8_t data[1];
uvc_error_t ret;
data[0] = focus;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_FOCUS_SIMPLE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the FOCUS_AUTO control.
* @param devh UVC device handle
* @param[out] state TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_focus_auto(uvc_device_handle_t *devh, uint8_t* state, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_FOCUS_AUTO_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*state = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the FOCUS_AUTO control.
* @param devh UVC device handle
* @param state TODO
*/
uvc_error_t uvc_set_focus_auto(uvc_device_handle_t *devh, uint8_t state) {
uint8_t data[1];
uvc_error_t ret;
data[0] = state;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_FOCUS_AUTO_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the IRIS_ABSOLUTE control.
* @param devh UVC device handle
* @param[out] iris TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_iris_abs(uvc_device_handle_t *devh, uint16_t* iris, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_IRIS_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*iris = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the IRIS_ABSOLUTE control.
* @param devh UVC device handle
* @param iris TODO
*/
uvc_error_t uvc_set_iris_abs(uvc_device_handle_t *devh, uint16_t iris) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(iris, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_IRIS_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the IRIS_RELATIVE control.
* @param devh UVC device handle
* @param[out] iris_rel TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_iris_rel(uvc_device_handle_t *devh, uint8_t* iris_rel, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_IRIS_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*iris_rel = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the IRIS_RELATIVE control.
* @param devh UVC device handle
* @param iris_rel TODO
*/
uvc_error_t uvc_set_iris_rel(uvc_device_handle_t *devh, uint8_t iris_rel) {
uint8_t data[1];
uvc_error_t ret;
data[0] = iris_rel;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_IRIS_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the ZOOM_ABSOLUTE control.
* @param devh UVC device handle
* @param[out] focal_length TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_zoom_abs(uvc_device_handle_t *devh, uint16_t* focal_length, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_ZOOM_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*focal_length = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the ZOOM_ABSOLUTE control.
* @param devh UVC device handle
* @param focal_length TODO
*/
uvc_error_t uvc_set_zoom_abs(uvc_device_handle_t *devh, uint16_t focal_length) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(focal_length, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_ZOOM_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the ZOOM_RELATIVE control.
* @param devh UVC device handle
* @param[out] zoom_rel TODO
* @param[out] digital_zoom TODO
* @param[out] speed TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_zoom_rel(uvc_device_handle_t *devh, int8_t* zoom_rel, uint8_t* digital_zoom, uint8_t* speed, enum uvc_req_code req_code) {
uint8_t data[3];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_ZOOM_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*zoom_rel = data[0];
*digital_zoom = data[1];
*speed = data[2];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the ZOOM_RELATIVE control.
* @param devh UVC device handle
* @param zoom_rel TODO
* @param digital_zoom TODO
* @param speed TODO
*/
uvc_error_t uvc_set_zoom_rel(uvc_device_handle_t *devh, int8_t zoom_rel, uint8_t digital_zoom, uint8_t speed) {
uint8_t data[3];
uvc_error_t ret;
data[0] = zoom_rel;
data[1] = digital_zoom;
data[2] = speed;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_ZOOM_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the PANTILT_ABSOLUTE control.
* @param devh UVC device handle
* @param[out] pan TODO
* @param[out] tilt TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_pantilt_abs(uvc_device_handle_t *devh, int32_t* pan, int32_t* tilt, enum uvc_req_code req_code) {
uint8_t data[8];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_PANTILT_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*pan = DW_TO_INT(data + 0);
*tilt = DW_TO_INT(data + 4);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the PANTILT_ABSOLUTE control.
* @param devh UVC device handle
* @param pan TODO
* @param tilt TODO
*/
uvc_error_t uvc_set_pantilt_abs(uvc_device_handle_t *devh, int32_t pan, int32_t tilt) {
uint8_t data[8];
uvc_error_t ret;
INT_TO_DW(pan, data + 0);
INT_TO_DW(tilt, data + 4);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_PANTILT_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the PANTILT_RELATIVE control.
* @param devh UVC device handle
* @param[out] pan_rel TODO
* @param[out] pan_speed TODO
* @param[out] tilt_rel TODO
* @param[out] tilt_speed TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_pantilt_rel(uvc_device_handle_t *devh, int8_t* pan_rel, uint8_t* pan_speed, int8_t* tilt_rel, uint8_t* tilt_speed, enum uvc_req_code req_code) {
uint8_t data[4];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_PANTILT_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*pan_rel = data[0];
*pan_speed = data[1];
*tilt_rel = data[2];
*tilt_speed = data[3];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the PANTILT_RELATIVE control.
* @param devh UVC device handle
* @param pan_rel TODO
* @param pan_speed TODO
* @param tilt_rel TODO
* @param tilt_speed TODO
*/
uvc_error_t uvc_set_pantilt_rel(uvc_device_handle_t *devh, int8_t pan_rel, uint8_t pan_speed, int8_t tilt_rel, uint8_t tilt_speed) {
uint8_t data[4];
uvc_error_t ret;
data[0] = pan_rel;
data[1] = pan_speed;
data[2] = tilt_rel;
data[3] = tilt_speed;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_PANTILT_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the ROLL_ABSOLUTE control.
* @param devh UVC device handle
* @param[out] roll TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_roll_abs(uvc_device_handle_t *devh, int16_t* roll, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_ROLL_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*roll = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the ROLL_ABSOLUTE control.
* @param devh UVC device handle
* @param roll TODO
*/
uvc_error_t uvc_set_roll_abs(uvc_device_handle_t *devh, int16_t roll) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(roll, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_ROLL_ABSOLUTE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the ROLL_RELATIVE control.
* @param devh UVC device handle
* @param[out] roll_rel TODO
* @param[out] speed TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_roll_rel(uvc_device_handle_t *devh, int8_t* roll_rel, uint8_t* speed, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_ROLL_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*roll_rel = data[0];
*speed = data[1];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the ROLL_RELATIVE control.
* @param devh UVC device handle
* @param roll_rel TODO
* @param speed TODO
*/
uvc_error_t uvc_set_roll_rel(uvc_device_handle_t *devh, int8_t roll_rel, uint8_t speed) {
uint8_t data[2];
uvc_error_t ret;
data[0] = roll_rel;
data[1] = speed;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_ROLL_RELATIVE_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the PRIVACY control.
* @param devh UVC device handle
* @param[out] privacy TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_privacy(uvc_device_handle_t *devh, uint8_t* privacy, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_PRIVACY_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*privacy = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the PRIVACY control.
* @param devh UVC device handle
* @param privacy TODO
*/
uvc_error_t uvc_set_privacy(uvc_device_handle_t *devh, uint8_t privacy) {
uint8_t data[1];
uvc_error_t ret;
data[0] = privacy;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_PRIVACY_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the DIGITAL_WINDOW control.
* @param devh UVC device handle
* @param[out] window_top TODO
* @param[out] window_left TODO
* @param[out] window_bottom TODO
* @param[out] window_right TODO
* @param[out] num_steps TODO
* @param[out] num_steps_units TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_digital_window(uvc_device_handle_t *devh, uint16_t* window_top, uint16_t* window_left, uint16_t* window_bottom, uint16_t* window_right, uint16_t* num_steps, uint16_t* num_steps_units, enum uvc_req_code req_code) {
uint8_t data[12];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_DIGITAL_WINDOW_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*window_top = SW_TO_SHORT(data + 0);
*window_left = SW_TO_SHORT(data + 2);
*window_bottom = SW_TO_SHORT(data + 4);
*window_right = SW_TO_SHORT(data + 6);
*num_steps = SW_TO_SHORT(data + 8);
*num_steps_units = SW_TO_SHORT(data + 10);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the DIGITAL_WINDOW control.
* @param devh UVC device handle
* @param window_top TODO
* @param window_left TODO
* @param window_bottom TODO
* @param window_right TODO
* @param num_steps TODO
* @param num_steps_units TODO
*/
uvc_error_t uvc_set_digital_window(uvc_device_handle_t *devh, uint16_t window_top, uint16_t window_left, uint16_t window_bottom, uint16_t window_right, uint16_t num_steps, uint16_t num_steps_units) {
uint8_t data[12];
uvc_error_t ret;
SHORT_TO_SW(window_top, data + 0);
SHORT_TO_SW(window_left, data + 2);
SHORT_TO_SW(window_bottom, data + 4);
SHORT_TO_SW(window_right, data + 6);
SHORT_TO_SW(num_steps, data + 8);
SHORT_TO_SW(num_steps_units, data + 10);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_DIGITAL_WINDOW_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the REGION_OF_INTEREST control.
* @param devh UVC device handle
* @param[out] roi_top TODO
* @param[out] roi_left TODO
* @param[out] roi_bottom TODO
* @param[out] roi_right TODO
* @param[out] auto_controls TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_digital_roi(uvc_device_handle_t *devh, uint16_t* roi_top, uint16_t* roi_left, uint16_t* roi_bottom, uint16_t* roi_right, uint16_t* auto_controls, enum uvc_req_code req_code) {
uint8_t data[10];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_CT_REGION_OF_INTEREST_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*roi_top = SW_TO_SHORT(data + 0);
*roi_left = SW_TO_SHORT(data + 2);
*roi_bottom = SW_TO_SHORT(data + 4);
*roi_right = SW_TO_SHORT(data + 6);
*auto_controls = SW_TO_SHORT(data + 8);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the REGION_OF_INTEREST control.
* @param devh UVC device handle
* @param roi_top TODO
* @param roi_left TODO
* @param roi_bottom TODO
* @param roi_right TODO
* @param auto_controls TODO
*/
uvc_error_t uvc_set_digital_roi(uvc_device_handle_t *devh, uint16_t roi_top, uint16_t roi_left, uint16_t roi_bottom, uint16_t roi_right, uint16_t auto_controls) {
uint8_t data[10];
uvc_error_t ret;
SHORT_TO_SW(roi_top, data + 0);
SHORT_TO_SW(roi_left, data + 2);
SHORT_TO_SW(roi_bottom, data + 4);
SHORT_TO_SW(roi_right, data + 6);
SHORT_TO_SW(auto_controls, data + 8);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_CT_REGION_OF_INTEREST_CONTROL << 8,
uvc_get_camera_terminal(devh)->bTerminalID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the BACKLIGHT_COMPENSATION control.
* @param devh UVC device handle
* @param[out] backlight_compensation device-dependent backlight compensation mode; zero means backlight compensation is disabled
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_backlight_compensation(uvc_device_handle_t *devh, uint16_t* backlight_compensation, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_BACKLIGHT_COMPENSATION_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*backlight_compensation = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the BACKLIGHT_COMPENSATION control.
* @param devh UVC device handle
* @param backlight_compensation device-dependent backlight compensation mode; zero means backlight compensation is disabled
*/
uvc_error_t uvc_set_backlight_compensation(uvc_device_handle_t *devh, uint16_t backlight_compensation) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(backlight_compensation, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_BACKLIGHT_COMPENSATION_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the BRIGHTNESS control.
* @param devh UVC device handle
* @param[out] brightness TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_brightness(uvc_device_handle_t *devh, int16_t* brightness, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_BRIGHTNESS_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*brightness = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the BRIGHTNESS control.
* @param devh UVC device handle
* @param brightness TODO
*/
uvc_error_t uvc_set_brightness(uvc_device_handle_t *devh, int16_t brightness) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(brightness, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_BRIGHTNESS_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the CONTRAST control.
* @param devh UVC device handle
* @param[out] contrast TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_contrast(uvc_device_handle_t *devh, uint16_t* contrast, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_CONTRAST_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*contrast = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the CONTRAST control.
* @param devh UVC device handle
* @param contrast TODO
*/
uvc_error_t uvc_set_contrast(uvc_device_handle_t *devh, uint16_t contrast) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(contrast, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_CONTRAST_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the CONTRAST_AUTO control.
* @param devh UVC device handle
* @param[out] contrast_auto TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_contrast_auto(uvc_device_handle_t *devh, uint8_t* contrast_auto, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_CONTRAST_AUTO_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*contrast_auto = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the CONTRAST_AUTO control.
* @param devh UVC device handle
* @param contrast_auto TODO
*/
uvc_error_t uvc_set_contrast_auto(uvc_device_handle_t *devh, uint8_t contrast_auto) {
uint8_t data[1];
uvc_error_t ret;
data[0] = contrast_auto;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_CONTRAST_AUTO_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the GAIN control.
* @param devh UVC device handle
* @param[out] gain TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_gain(uvc_device_handle_t *devh, uint16_t* gain, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_GAIN_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*gain = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the GAIN control.
* @param devh UVC device handle
* @param gain TODO
*/
uvc_error_t uvc_set_gain(uvc_device_handle_t *devh, uint16_t gain) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(gain, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_GAIN_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the POWER_LINE_FREQUENCY control.
* @param devh UVC device handle
* @param[out] power_line_frequency TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_power_line_frequency(uvc_device_handle_t *devh, uint8_t* power_line_frequency, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_POWER_LINE_FREQUENCY_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*power_line_frequency = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the POWER_LINE_FREQUENCY control.
* @param devh UVC device handle
* @param power_line_frequency TODO
*/
uvc_error_t uvc_set_power_line_frequency(uvc_device_handle_t *devh, uint8_t power_line_frequency) {
uint8_t data[1];
uvc_error_t ret;
data[0] = power_line_frequency;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_POWER_LINE_FREQUENCY_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the HUE control.
* @param devh UVC device handle
* @param[out] hue TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_hue(uvc_device_handle_t *devh, int16_t* hue, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_HUE_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*hue = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the HUE control.
* @param devh UVC device handle
* @param hue TODO
*/
uvc_error_t uvc_set_hue(uvc_device_handle_t *devh, int16_t hue) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(hue, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_HUE_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the HUE_AUTO control.
* @param devh UVC device handle
* @param[out] hue_auto TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_hue_auto(uvc_device_handle_t *devh, uint8_t* hue_auto, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_HUE_AUTO_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*hue_auto = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the HUE_AUTO control.
* @param devh UVC device handle
* @param hue_auto TODO
*/
uvc_error_t uvc_set_hue_auto(uvc_device_handle_t *devh, uint8_t hue_auto) {
uint8_t data[1];
uvc_error_t ret;
data[0] = hue_auto;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_HUE_AUTO_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the SATURATION control.
* @param devh UVC device handle
* @param[out] saturation TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_saturation(uvc_device_handle_t *devh, uint16_t* saturation, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_SATURATION_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*saturation = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the SATURATION control.
* @param devh UVC device handle
* @param saturation TODO
*/
uvc_error_t uvc_set_saturation(uvc_device_handle_t *devh, uint16_t saturation) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(saturation, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_SATURATION_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the SHARPNESS control.
* @param devh UVC device handle
* @param[out] sharpness TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_sharpness(uvc_device_handle_t *devh, uint16_t* sharpness, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_SHARPNESS_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*sharpness = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the SHARPNESS control.
* @param devh UVC device handle
* @param sharpness TODO
*/
uvc_error_t uvc_set_sharpness(uvc_device_handle_t *devh, uint16_t sharpness) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(sharpness, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_SHARPNESS_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the GAMMA control.
* @param devh UVC device handle
* @param[out] gamma TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_gamma(uvc_device_handle_t *devh, uint16_t* gamma, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_GAMMA_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*gamma = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the GAMMA control.
* @param devh UVC device handle
* @param gamma TODO
*/
uvc_error_t uvc_set_gamma(uvc_device_handle_t *devh, uint16_t gamma) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(gamma, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_GAMMA_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the WHITE_BALANCE_TEMPERATURE control.
* @param devh UVC device handle
* @param[out] temperature TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_white_balance_temperature(uvc_device_handle_t *devh, uint16_t* temperature, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_WHITE_BALANCE_TEMPERATURE_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*temperature = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the WHITE_BALANCE_TEMPERATURE control.
* @param devh UVC device handle
* @param temperature TODO
*/
uvc_error_t uvc_set_white_balance_temperature(uvc_device_handle_t *devh, uint16_t temperature) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(temperature, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_WHITE_BALANCE_TEMPERATURE_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the WHITE_BALANCE_TEMPERATURE_AUTO control.
* @param devh UVC device handle
* @param[out] temperature_auto TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_white_balance_temperature_auto(uvc_device_handle_t *devh, uint8_t* temperature_auto, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_WHITE_BALANCE_TEMPERATURE_AUTO_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*temperature_auto = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the WHITE_BALANCE_TEMPERATURE_AUTO control.
* @param devh UVC device handle
* @param temperature_auto TODO
*/
uvc_error_t uvc_set_white_balance_temperature_auto(uvc_device_handle_t *devh, uint8_t temperature_auto) {
uint8_t data[1];
uvc_error_t ret;
data[0] = temperature_auto;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_WHITE_BALANCE_TEMPERATURE_AUTO_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the WHITE_BALANCE_COMPONENT control.
* @param devh UVC device handle
* @param[out] blue TODO
* @param[out] red TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_white_balance_component(uvc_device_handle_t *devh, uint16_t* blue, uint16_t* red, enum uvc_req_code req_code) {
uint8_t data[4];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_WHITE_BALANCE_COMPONENT_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*blue = SW_TO_SHORT(data + 0);
*red = SW_TO_SHORT(data + 2);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the WHITE_BALANCE_COMPONENT control.
* @param devh UVC device handle
* @param blue TODO
* @param red TODO
*/
uvc_error_t uvc_set_white_balance_component(uvc_device_handle_t *devh, uint16_t blue, uint16_t red) {
uint8_t data[4];
uvc_error_t ret;
SHORT_TO_SW(blue, data + 0);
SHORT_TO_SW(red, data + 2);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_WHITE_BALANCE_COMPONENT_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the WHITE_BALANCE_COMPONENT_AUTO control.
* @param devh UVC device handle
* @param[out] white_balance_component_auto TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_white_balance_component_auto(uvc_device_handle_t *devh, uint8_t* white_balance_component_auto, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_WHITE_BALANCE_COMPONENT_AUTO_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*white_balance_component_auto = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the WHITE_BALANCE_COMPONENT_AUTO control.
* @param devh UVC device handle
* @param white_balance_component_auto TODO
*/
uvc_error_t uvc_set_white_balance_component_auto(uvc_device_handle_t *devh, uint8_t white_balance_component_auto) {
uint8_t data[1];
uvc_error_t ret;
data[0] = white_balance_component_auto;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_WHITE_BALANCE_COMPONENT_AUTO_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the DIGITAL_MULTIPLIER control.
* @param devh UVC device handle
* @param[out] multiplier_step TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_digital_multiplier(uvc_device_handle_t *devh, uint16_t* multiplier_step, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_DIGITAL_MULTIPLIER_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*multiplier_step = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the DIGITAL_MULTIPLIER control.
* @param devh UVC device handle
* @param multiplier_step TODO
*/
uvc_error_t uvc_set_digital_multiplier(uvc_device_handle_t *devh, uint16_t multiplier_step) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(multiplier_step, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_DIGITAL_MULTIPLIER_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the DIGITAL_MULTIPLIER_LIMIT control.
* @param devh UVC device handle
* @param[out] multiplier_step TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_digital_multiplier_limit(uvc_device_handle_t *devh, uint16_t* multiplier_step, enum uvc_req_code req_code) {
uint8_t data[2];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_DIGITAL_MULTIPLIER_LIMIT_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*multiplier_step = SW_TO_SHORT(data + 0);
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the DIGITAL_MULTIPLIER_LIMIT control.
* @param devh UVC device handle
* @param multiplier_step TODO
*/
uvc_error_t uvc_set_digital_multiplier_limit(uvc_device_handle_t *devh, uint16_t multiplier_step) {
uint8_t data[2];
uvc_error_t ret;
SHORT_TO_SW(multiplier_step, data + 0);
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_DIGITAL_MULTIPLIER_LIMIT_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the ANALOG_VIDEO_STANDARD control.
* @param devh UVC device handle
* @param[out] video_standard TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_analog_video_standard(uvc_device_handle_t *devh, uint8_t* video_standard, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_ANALOG_VIDEO_STANDARD_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*video_standard = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the ANALOG_VIDEO_STANDARD control.
* @param devh UVC device handle
* @param video_standard TODO
*/
uvc_error_t uvc_set_analog_video_standard(uvc_device_handle_t *devh, uint8_t video_standard) {
uint8_t data[1];
uvc_error_t ret;
data[0] = video_standard;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_ANALOG_VIDEO_STANDARD_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the ANALOG_LOCK_STATUS control.
* @param devh UVC device handle
* @param[out] status TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_analog_video_lock_status(uvc_device_handle_t *devh, uint8_t* status, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_PU_ANALOG_LOCK_STATUS_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*status = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the ANALOG_LOCK_STATUS control.
* @param devh UVC device handle
* @param status TODO
*/
uvc_error_t uvc_set_analog_video_lock_status(uvc_device_handle_t *devh, uint8_t status) {
uint8_t data[1];
uvc_error_t ret;
data[0] = status;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_PU_ANALOG_LOCK_STATUS_CONTROL << 8,
uvc_get_processing_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}
/** @ingroup ctrl
* @brief Reads the INPUT_SELECT control.
* @param devh UVC device handle
* @param[out] selector TODO
* @param req_code UVC_GET_* request to execute
*/
uvc_error_t uvc_get_input_select(uvc_device_handle_t *devh, uint8_t* selector, enum uvc_req_code req_code) {
uint8_t data[1];
uvc_error_t ret;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_GET, req_code,
UVC_SU_INPUT_SELECT_CONTROL << 8,
uvc_get_selector_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data)) {
*selector = data[0];
return UVC_SUCCESS;
} else {
return ret;
}
}
/** @ingroup ctrl
* @brief Sets the INPUT_SELECT control.
* @param devh UVC device handle
* @param selector TODO
*/
uvc_error_t uvc_set_input_select(uvc_device_handle_t *devh, uint8_t selector) {
uint8_t data[1];
uvc_error_t ret;
data[0] = selector;
ret = libusb_control_transfer(
devh->usb_devh,
REQ_TYPE_SET, UVC_SET_CUR,
UVC_SU_INPUT_SELECT_CONTROL << 8,
uvc_get_selector_units(devh)->bUnitID << 8 | devh->info->ctrl_if.bInterfaceNumber,
data,
sizeof(data),
0);
if (ret == sizeof(data))
return UVC_SUCCESS;
else
return ret;
}