OrbbecSDK 1.10.18
OrbbecSDK: Software-Development-Kit for Orbbec 3D Cameras
|
Device-related functions, including operations such as obtaining and creating a device, setting and obtaining device property, and obtaining sensors. More...
Go to the source code of this file.
Functions | |
uint32_t | ob_device_list_device_count (ob_device_list *list, ob_error **error) |
Get the number of devices. | |
const char * | ob_device_list_get_device_name (ob_device_list *list, uint32_t index, ob_error **error) |
Get device name (DEPRECATED) | |
int | ob_device_list_get_device_pid (ob_device_list *list, uint32_t index, ob_error **error) |
Get the pid of the specified device. | |
int | ob_device_list_get_device_vid (ob_device_list *list, uint32_t index, ob_error **error) |
Get the vid of the specified device. | |
const char * | ob_device_list_get_device_uid (ob_device_list *list, uint32_t index, ob_error **error) |
Get the uid of the specified device. | |
const char * | ob_device_list_get_device_serial_number (ob_device_list *list, uint32_t index, ob_error **error) |
Get the serial number of the specified device. | |
const char * | ob_device_list_get_device_connection_type (ob_device_list *list, uint32_t index, ob_error **error) |
Get device connection type. | |
const char * | ob_device_list_get_device_ip_address (ob_device_list *list, uint32_t index, ob_error **error) |
Get device ip address. | |
const char * | ob_device_list_get_extension_info (ob_device_list *list, uint32_t index, ob_error **error) |
Get the device extension information. | |
ob_device * | ob_device_list_get_device (ob_device_list *list, uint32_t index, ob_error **error) |
Create a device. | |
ob_device * | ob_device_list_get_device_by_serial_number (ob_device_list *list, const char *serial_number, ob_error **error) |
Create a device. | |
ob_device * | ob_device_list_get_device_by_uid (ob_device_list *list, const char *uid, ob_error **error) |
Create device by uid. | |
void | ob_delete_device (ob_device *device, ob_error **error) |
Delete a device. | |
void | ob_delete_device_info (ob_device_info *info, ob_error **error) |
Delete device information. | |
void | ob_delete_device_list (ob_device_list *list, ob_error **error) |
Delete a device list. | |
ob_device_info * | ob_device_get_device_info (ob_device *device, ob_error **error) |
Get device information. | |
ob_sensor_list * | ob_device_get_sensor_list (ob_device *device, ob_error **error) |
List all sensors. | |
ob_sensor * | ob_device_get_sensor (ob_device *device, ob_sensor_type type, ob_error **error) |
Get a device's sensor. | |
void | ob_device_set_int_property (ob_device *device, ob_property_id property_id, int32_t property, ob_error **error) |
Set an integer type of device property. | |
int32_t | ob_device_get_int_property (ob_device *device, ob_property_id property_id, ob_error **error) |
Get an integer type of device property. | |
void | ob_device_set_float_property (ob_device *device, ob_property_id property_id, float property, ob_error **error) |
Set a float type of device property. | |
float | ob_device_get_float_property (ob_device *device, ob_property_id property_id, ob_error **error) |
Get a float type of device property. | |
void | ob_device_set_bool_property (ob_device *device, ob_property_id property_id, bool property, ob_error **error) |
Set a boolean type of device property. | |
bool | ob_device_get_bool_property (ob_device *device, ob_property_id property_id, ob_error **error) |
Get a boolean type of device property. | |
void | ob_device_set_structured_data (ob_device *device, ob_property_id property_id, const void *data, uint32_t data_size, ob_error **error) |
Set structured data. | |
void | ob_device_get_structured_data (ob_device *device, ob_property_id property_id, void *data, uint32_t *data_size, ob_error **error) |
Get structured data of a device property. | |
void | ob_device_set_structured_data_ext (ob_device *device, ob_property_id property_id, ob_data_bundle *data_bundle, ob_set_data_callback cb, void *user_data, ob_error **error) |
Set structured data of a device property. | |
ob_data_bundle * | ob_device_get_structured_data_ext (ob_device *device, ob_property_id property_id, ob_error **error) |
Get structured data of a device property. | |
void | ob_device_set_raw_data (ob_device *device, ob_property_id property_id, void *data, uint32_t data_size, ob_set_data_callback cb, bool async, void *user_data, ob_error **error) |
Set raw data of a device property. | |
void | ob_device_get_raw_data (ob_device *device, ob_property_id property_id, ob_get_data_callback cb, bool async, void *user_data, ob_error **error) |
Get raw data of a device property. | |
ob_protocol_version | ob_device_get_protocol_version (ob_device *device, ob_error **error) |
Get the protocol version of the device. | |
ob_cmd_version | ob_device_get_cmd_version (ob_device *device, ob_property_id property_id, ob_error **error) |
Get the cmdVersion of a property. | |
uint32_t | ob_device_get_supported_property_count (ob_device *device, ob_error **error) |
Get the number of properties supported by the device. | |
ob_property_item | ob_device_get_supported_property (ob_device *device, uint32_t index, ob_error **error) |
Get the type of property supported by the device. | |
bool | ob_device_is_property_supported (ob_device *device, ob_property_id property_id, ob_permission_type permission, ob_error **error) |
Check if a device property permission is supported. | |
ob_int_property_range | ob_device_get_int_property_range (ob_device *device, ob_property_id property_id, ob_error **error) |
Get the integer type of device property range. | |
ob_float_property_range | ob_device_get_float_property_range (ob_device *device, ob_property_id property_id, ob_error **error) |
Get the float type of device property range. | |
ob_bool_property_range | ob_device_get_bool_property_range (ob_device *device, ob_property_id property_id, ob_error **error) |
Get the boolean type of device property range. | |
void | ob_device_write_ahb (ob_device *device, uint32_t reg, uint32_t mask, uint32_t value, ob_error **error) |
Write to an AHB register. | |
void | ob_device_read_ahb (ob_device *device, uint32_t reg, uint32_t mask, uint32_t *value, ob_error **error) |
Read an AHB register. | |
void | ob_device_write_i2c (ob_device *device, uint32_t module_id, uint32_t reg, uint32_t mask, uint32_t value, ob_error **error) |
Write to an I2C register. | |
void | ob_device_read_i2c (ob_device *device, uint32_t module_id, uint32_t reg, uint32_t mask, uint32_t *value, ob_error **error) |
Read an I2C register. | |
void | ob_device_write_flash (ob_device *device, uint32_t offset, const void *data, uint32_t data_size, ob_set_data_callback cb, bool async, void *user_data, ob_error **error) |
Set the properties of writing to Flash [Asynchronous Callback]. | |
void | ob_device_read_flash (ob_device *device, uint32_t offset, uint32_t data_size, ob_get_data_callback cb, bool async, void *user_data, ob_error **error) |
Read Flash properties [asynchronous callback]. | |
void | ob_device_write_customer_data (ob_device *device, const void *data, uint32_t data_size, ob_error **error) |
Set customer data. | |
void | ob_device_read_customer_data (ob_device *device, void *data, uint32_t *data_size, ob_error **error) |
Get customer data of a device property. | |
void | ob_device_upgrade (ob_device *device, const char *path, ob_device_upgrade_callback callback, bool async, void *user_data, ob_error **error) |
Upgrade the device firmware. | |
void | ob_device_upgrade_from_data (ob_device *device, const char *file_data, uint32_t file_size, ob_device_upgrade_callback callback, bool async, void *user_data, ob_error **error) |
Upgrade the device firmware. | |
ob_device_state | ob_device_get_device_state (ob_device *device, ob_error **error) |
Get the current device status. | |
void | ob_device_state_changed (ob_device *device, ob_device_state_callback callback, void *user_data, ob_error **error) |
Monitor device state changes. | |
void | ob_device_send_file_to_destination (ob_device *device, const char *file_path, const char *dst_path, ob_file_send_callback callback, bool async, void *user_data, ob_error **error) |
Send files to the specified path on the device. | |
bool | ob_device_activate_authorization (ob_device *device, const char *auth_code, ob_error **error) |
Verify the device authorization code. | |
void | ob_device_write_authorization_code (ob_device *device, const char *auth_code, ob_error **error) |
Write the device authorization code. | |
ob_camera_param_list * | ob_device_get_calibration_camera_param_list (ob_device *device, ob_error **error) |
Get the original parameter list of camera calibration saved on the device. | |
ob_depth_work_mode | ob_device_get_current_depth_work_mode (ob_device *device, ob_error **error) |
Get the current depth work mode. | |
ob_status | ob_device_switch_depth_work_mode (ob_device *device, const ob_depth_work_mode *work_mode, ob_error **error) |
Switch the depth work mode by ob_depth_work_mode. Prefer to use ob_device_switch_depth_work_mode_by_name to switch depth mode when the complete name of the depth work mode is known. | |
ob_status | ob_device_switch_depth_work_mode_by_name (ob_device *device, const char *mode_name, ob_error **error) |
Switch the depth work mode by work mode name. | |
ob_depth_work_mode_list * | ob_device_get_depth_work_mode_list (ob_device *device, ob_error **error) |
Request the list of supported depth work modes. | |
void | ob_device_reboot (ob_device *device, ob_error **error) |
Device reboot. | |
ob_device_sync_config | ob_device_get_sync_config (ob_device *device, ob_error **error) |
Get the current device synchronization configuration. | |
void | ob_device_set_sync_config (ob_device *device, ob_device_sync_config device_sync_config, ob_error **error) |
Set the device synchronization configuration. | |
const char * | ob_device_info_name (ob_device_info *info, ob_error **error) |
Get device name. | |
int | ob_device_info_pid (ob_device_info *info, ob_error **error) |
Get device pid. | |
int | ob_device_info_vid (ob_device_info *info, ob_error **error) |
Get device vid. | |
const char * | ob_device_info_uid (ob_device_info *info, ob_error **error) |
Get device uid. | |
const char * | ob_device_info_serial_number (ob_device_info *info, ob_error **error) |
Get device serial number. | |
const char * | ob_device_info_firmware_version (ob_device_info *info, ob_error **error) |
Get the firmware version number. | |
const char * | ob_device_info_usb_type (ob_device_info *info, ob_error **error) |
Get the USB connection type (DEPRECATED) | |
const char * | ob_device_info_connection_type (ob_device_info *info, ob_error **error) |
Get the device connection type. | |
const char * | ob_device_info_ip_address (ob_device_info *info, ob_error **error) |
Get the device IP address. | |
const char * | ob_device_info_hardware_version (ob_device_info *info, ob_error **error) |
Get the hardware version number. | |
const char * | ob_device_info_get_extension_info (ob_device_info *info, ob_error **error) |
Get the device extension information. | |
const char * | ob_device_info_supported_min_sdk_version (ob_device_info *info, ob_error **error) |
Get the minimum SDK version number supported by the device. | |
const char * | ob_device_info_asicName (ob_device_info *info, ob_error **error) |
Get the chip name. | |
ob_device_type | ob_device_info_device_type (ob_device_info *info, ob_error **error) |
Get the device type. | |
uint32_t | ob_camera_param_list_count (ob_camera_param_list *param_list, ob_error **error) |
Get the number of camera parameter lists. | |
ob_camera_param | ob_camera_param_list_get_param (ob_camera_param_list *param_list, uint32_t index, ob_error **error) |
Get camera parameters from the camera parameter list. | |
void | ob_delete_camera_param_list (ob_camera_param_list *param_list, ob_error **error) |
Delete the camera parameter list. | |
uint32_t | ob_depth_work_mode_list_count (ob_depth_work_mode_list *work_mode_list, ob_error **error) |
ob_depth_work_mode | ob_depth_work_mode_list_get_item (ob_depth_work_mode_list *work_mode_list, uint32_t index, ob_error **error) |
Get the index target of ob_depth_work_mode from work_mode_list. | |
void | ob_delete_depth_work_mode_list (ob_depth_work_mode_list *work_mode_list, ob_error **error) |
Free the resources of ob_depth_work_mode_list. | |
void | ob_delete_data_bundle (ob_data_bundle *data_bundle, ob_error **error) |
Free the resources of data_bundle which come from OrbbecSDK's API. | |
bool | ob_device_is_global_timestamp_supported (ob_device *device, ob_error **error) |
Check if the device supports global timestamp. | |
void | ob_device_load_depth_filter_config (ob_device *device, const char *file_path, ob_error **error) |
Load depth filter config from file. | |
void | ob_device_reset_default_depth_filter_config (ob_device *device, ob_error **error) |
Reset depth filter config to device default define. | |
const char * | ob_device_get_current_preset_name (ob_device *device, ob_error **error) |
The preset mean a set of parameters or configurations that can be applied to the device to achieve a specific effect or function. | |
void | ob_device_load_preset (ob_device *device, const char *preset_name, ob_error **error) |
Get the available preset list. | |
void | ob_device_load_preset_from_json_file (ob_device *device, const char *json_file_path, ob_error **error) |
Load preset from json string. | |
void | ob_device_export_current_settings_as_preset_json_file (ob_device *device, const char *json_file_path, ob_error **error) |
Export current settings as a preset json file. | |
ob_device_preset_list * | ob_device_get_available_preset_list (ob_device *device, ob_error **error) |
Get the available preset list. | |
void | ob_delete_preset_list (ob_device_preset_list *preset_list, ob_error **error) |
Delete the available preset list. | |
uint32_t | ob_device_preset_list_count (ob_device_preset_list *preset_list, ob_error **error) |
Get the number of preset in the preset list. | |
const char * | ob_device_preset_list_get_name (ob_device_preset_list *preset_list, uint32_t index, ob_error **error) |
Get the name of the preset in the preset list. | |
bool | ob_device_preset_list_has_preset (ob_device_preset_list *preset_list, const char *preset_name, ob_error **error) |
Check if the preset list has the preset. | |
Device-related functions, including operations such as obtaining and creating a device, setting and obtaining device property, and obtaining sensors.
Definition in file Device.h.
uint32_t ob_device_list_device_count | ( | ob_device_list * | list, |
ob_error ** | error | ||
) |
Get the number of devices.
[in] | list | Device list object |
[out] | error | Log error messages |
const char * ob_device_list_get_device_name | ( | ob_device_list * | list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get device name (DEPRECATED)
[in] | list | Device list object |
[in] | index | Device index |
[out] | error | Log error messages |
int ob_device_list_get_device_pid | ( | ob_device_list * | list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get the pid of the specified device.
[in] | list | Device list object |
[in] | index | Device index |
[out] | error | Log error messages |
int ob_device_list_get_device_vid | ( | ob_device_list * | list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get the vid of the specified device.
[in] | list | Device list object |
[in] | index | Device index |
[out] | error | Log error messages |
const char * ob_device_list_get_device_uid | ( | ob_device_list * | list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get the uid of the specified device.
[in] | list | Device list object |
[in] | index | Device index |
[out] | error | Log error messages |
const char * ob_device_list_get_device_serial_number | ( | ob_device_list * | list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get the serial number of the specified device.
[in] | list | Device list object. |
[in] | index | Device index. |
[out] | error | Log error messages. |
const char * ob_device_list_get_device_connection_type | ( | ob_device_list * | list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get device connection type.
[in] | list | Device list object |
[in] | index | Device index |
[out] | error | Log error messages |
const char * ob_device_list_get_device_ip_address | ( | ob_device_list * | list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get device ip address.
list | Device list object |
index | Device index |
error | Log error messages |
const char * ob_device_list_get_extension_info | ( | ob_device_list * | list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get the device extension information.
[in] | list | Device list object |
[in] | index | Device index |
[out] | error | Log error messages |
ob_device * ob_device_list_get_device | ( | ob_device_list * | list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Create a device.
[in] | list | Device list object. |
[in] | index | The index of the device to create. |
[out] | error | Log error messages. |
ob_device * ob_device_list_get_device_by_serial_number | ( | ob_device_list * | list, |
const char * | serial_number, | ||
ob_error ** | error | ||
) |
Create a device.
[in] | list | Device list object. |
[in] | serial_number | The serial number of the device to create. |
[out] | error | Log error messages. |
ob_device * ob_device_list_get_device_by_uid | ( | ob_device_list * | list, |
const char * | uid, | ||
ob_error ** | error | ||
) |
Create device by uid.
On Linux platform, the uid of the device is composed of bus-port-dev, for example 1-1.2-1. But the SDK will remove the dev number and only keep the bus-port as the uid to create the device, for example 1-1.2, so that we can create a device connected to the specified USB port. Similarly, users can also directly pass in bus-port as uid to create device.
[in] | list | Device list object. |
[in] | uid | The UID of the device to create. |
[out] | error | Log error messages. |
Delete a device.
[in] | device | The device to be deleted. |
[out] | error | Log error messages. |
void ob_delete_device_info | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Delete device information.
[in] | info | The device information to be deleted. |
[out] | error | Log error messages. |
void ob_delete_device_list | ( | ob_device_list * | list, |
ob_error ** | error | ||
) |
Delete a device list.
[in] | list | The device list object to be deleted. |
[out] | error | Log error messages. |
ob_device_info * ob_device_get_device_info | ( | ob_device * | device, |
ob_error ** | error | ||
) |
Get device information.
[in] | device | The device to obtain information from. |
[out] | error | Log error messages. |
ob_sensor_list * ob_device_get_sensor_list | ( | ob_device * | device, |
ob_error ** | error | ||
) |
List all sensors.
[in] | device | The device object. |
[out] | error | Log error messages. |
ob_sensor * ob_device_get_sensor | ( | ob_device * | device, |
ob_sensor_type | type, | ||
ob_error ** | error | ||
) |
Get a device's sensor.
[in] | device | The device object. |
[in] | type | The type of sensor to get. |
[out] | error | Log error messages. |
void ob_device_set_int_property | ( | ob_device * | device, |
ob_property_id | property_id, | ||
int32_t | property, | ||
ob_error ** | error | ||
) |
Set an integer type of device property.
[in] | device | The device object. |
[in] | property_id | The ID of the property to be set. |
[in] | property | The property value to be set. |
[out] | error | Log error messages. |
int32_t ob_device_get_int_property | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_error ** | error | ||
) |
Get an integer type of device property.
[in] | device | The device object. |
[in] | property_id | The property ID. |
[out] | error | Log error messages. |
void ob_device_set_float_property | ( | ob_device * | device, |
ob_property_id | property_id, | ||
float | property, | ||
ob_error ** | error | ||
) |
Set a float type of device property.
[in] | device | The device object. |
[in] | property_id | The ID of the property to be set. |
[in] | property | The property value to be set. |
[out] | error | Log error messages. |
float ob_device_get_float_property | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_error ** | error | ||
) |
Get a float type of device property.
[in] | device | The device object. |
[in] | property_id | The property ID. |
[out] | error | Log error messages. |
void ob_device_set_bool_property | ( | ob_device * | device, |
ob_property_id | property_id, | ||
bool | property, | ||
ob_error ** | error | ||
) |
Set a boolean type of device property.
[in] | device | The device object. |
[in] | property_id | The ID of the property to be set. |
[in] | property | The property value to be set. |
[out] | error | Log error messages. |
bool ob_device_get_bool_property | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_error ** | error | ||
) |
Get a boolean type of device property.
[in] | device | The device object. |
[in] | property_id | The property ID. |
[out] | error | Log error messages. |
void ob_device_set_structured_data | ( | ob_device * | device, |
ob_property_id | property_id, | ||
const void * | data, | ||
uint32_t | data_size, | ||
ob_error ** | error | ||
) |
Set structured data.
[in] | device | The device object. |
[in] | property_id | The ID of the property to be set. |
[in] | data | The property data to be set. |
[in] | data_size | The size of the property to be set. |
[out] | error | Log error messages. |
void ob_device_get_structured_data | ( | ob_device * | device, |
ob_property_id | property_id, | ||
void * | data, | ||
uint32_t * | data_size, | ||
ob_error ** | error | ||
) |
Get structured data of a device property.
[in] | device | The device object. |
[in] | property_id | The ID of the property. |
[out] | data | The obtained property data. |
[out] | data_size | The size of the obtained property data. |
[out] | error | Log error messages. |
void ob_device_set_structured_data_ext | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_data_bundle * | data_bundle, | ||
ob_set_data_callback | cb, | ||
void * | user_data, | ||
ob_error ** | error | ||
) |
Set structured data of a device property.
[in] | device | The device object. |
[in] | property_id | The ID of the property. |
[in] | data_bundle | The target data to set. |
[in] | cb | The data callback. |
[in] | user_data | User-defined data that will be returned in the callback. |
[out] | error | Log error messages. |
ob_data_bundle * ob_device_get_structured_data_ext | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_error ** | error | ||
) |
Get structured data of a device property.
[in] | device | The device object. |
[in] | property_id | The ID of the property. |
[out] | error | Log error messages. |
void ob_device_set_raw_data | ( | ob_device * | device, |
ob_property_id | property_id, | ||
void * | data, | ||
uint32_t | data_size, | ||
ob_set_data_callback | cb, | ||
bool | async, | ||
void * | user_data, | ||
ob_error ** | error | ||
) |
Set raw data of a device property.
[in] | device | The device object. |
[in] | property_id | The ID of the property to be set. |
[in] | data | The property data to be set. |
[in] | data_size | The size of the property data to be set. |
[in] | cb | The set data callback. |
[in] | async | Whether to execute asynchronously. |
[in] | user_data | User-defined data that will be returned in the callback. |
[out] | error | Log error messages. |
void ob_device_get_raw_data | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_get_data_callback | cb, | ||
bool | async, | ||
void * | user_data, | ||
ob_error ** | error | ||
) |
Get raw data of a device property.
[in] | device | The device object. |
[in] | property_id | The ID of the property. |
[in] | cb | The get data callback. |
[in] | async | Whether to execute asynchronously. |
[in] | user_data | User-defined data that will be returned in the callback. |
[out] | error | Log error messages. |
ob_protocol_version ob_device_get_protocol_version | ( | ob_device * | device, |
ob_error ** | error | ||
) |
Get the protocol version of the device.
[in] | device | The device object. |
[out] | error | Log error messages. |
ob_cmd_version ob_device_get_cmd_version | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_error ** | error | ||
) |
Get the cmdVersion of a property.
[in] | device | The device object. |
[in] | property_id | The property id. |
[out] | error | Log error messages. |
Get the number of properties supported by the device.
[in] | device | The device object. |
[out] | error | Log error messages. |
ob_property_item ob_device_get_supported_property | ( | ob_device * | device, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get the type of property supported by the device.
[in] | device | The device object. |
[in] | index | The property index. |
[out] | error | Log error messages. |
bool ob_device_is_property_supported | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_permission_type | permission, | ||
ob_error ** | error | ||
) |
Check if a device property permission is supported.
[in] | device | The device object. |
[in] | property_id | The property id. |
[in] | permission | The type of permission that needs to be interpreted. |
[out] | error | Log error messages. |
ob_int_property_range ob_device_get_int_property_range | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_error ** | error | ||
) |
Get the integer type of device property range.
[in] | device | The device object. |
[in] | property_id | The property id. |
[out] | error | Log error messages. |
ob_float_property_range ob_device_get_float_property_range | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_error ** | error | ||
) |
Get the float type of device property range.
[in] | device | The device object. |
[in] | property_id | The property id. |
[out] | error | Log error messages. |
ob_bool_property_range ob_device_get_bool_property_range | ( | ob_device * | device, |
ob_property_id | property_id, | ||
ob_error ** | error | ||
) |
Get the boolean type of device property range.
[in] | device | The device object. |
[in] | property_id | The property id. |
[out] | error | Log error messages. |
void ob_device_write_ahb | ( | ob_device * | device, |
uint32_t | reg, | ||
uint32_t | mask, | ||
uint32_t | value, | ||
ob_error ** | error | ||
) |
Write to an AHB register.
[in] | device | The device object. |
reg | The register to be written. | |
mask | The mask. | |
value | The value to be written. | |
[out] | error | Log error messages. |
void ob_device_read_ahb | ( | ob_device * | device, |
uint32_t | reg, | ||
uint32_t | mask, | ||
uint32_t * | value, | ||
ob_error ** | error | ||
) |
Read an AHB register.
[in] | device | The device object. |
reg | The register to be read. | |
mask | The mask. | |
value | The value to be read. | |
[out] | error | Log error messages. |
void ob_device_write_i2c | ( | ob_device * | device, |
uint32_t | module_id, | ||
uint32_t | reg, | ||
uint32_t | mask, | ||
uint32_t | value, | ||
ob_error ** | error | ||
) |
Write to an I2C register.
[in] | device | The device object. |
module_id | The I2C module id to be written. | |
reg | The register to be written. | |
mask | The mask. | |
value | The value to be written. | |
[out] | error | Log error messages. |
void ob_device_read_i2c | ( | ob_device * | device, |
uint32_t | module_id, | ||
uint32_t | reg, | ||
uint32_t | mask, | ||
uint32_t * | value, | ||
ob_error ** | error | ||
) |
Read an I2C register.
[in] | device | The device object. |
module_id | The id of the I2C module to be read. | |
reg | The register to be read. | |
mask | The mask. | |
value | The value to be read. | |
[out] | error | Log error messages. |
void ob_device_write_flash | ( | ob_device * | device, |
uint32_t | offset, | ||
const void * | data, | ||
uint32_t | data_size, | ||
ob_set_data_callback | cb, | ||
bool | async, | ||
void * | user_data, | ||
ob_error ** | error | ||
) |
Set the properties of writing to Flash [Asynchronous Callback].
[in] | device | The device object. |
offset | The flash offset address. | |
data | The property data to be written. | |
data_size | The size of the property to be written. | |
cb | The set data callback. | |
[in] | async | Whether to execute asynchronously. |
[in] | user_data | User-defined data that will be returned in the callback. |
[out] | error | Log error messages. |
void ob_device_read_flash | ( | ob_device * | device, |
uint32_t | offset, | ||
uint32_t | data_size, | ||
ob_get_data_callback | cb, | ||
bool | async, | ||
void * | user_data, | ||
ob_error ** | error | ||
) |
Read Flash properties [asynchronous callback].
[in] | device | The device object. |
offset | The flash offset address. | |
data_size | The size of the data to be read. | |
cb | The read flash data and progress callback. | |
[in] | async | Whether to execute asynchronously. |
[in] | user_data | User-defined data that will be returned in the callback. |
[out] | error | Log error messages. |
void ob_device_write_customer_data | ( | ob_device * | device, |
const void * | data, | ||
uint32_t | data_size, | ||
ob_error ** | error | ||
) |
Set customer data.
[in] | device | The device object. |
[in] | data | The property data to be set. |
[in] | data_size | The size of the property to be set,the maximum length cannot exceed 65532 bytes. |
[out] | error | Log error messages. |
void ob_device_read_customer_data | ( | ob_device * | device, |
void * | data, | ||
uint32_t * | data_size, | ||
ob_error ** | error | ||
) |
Get customer data of a device property.
[in] | device | The device object. |
[out] | data | The obtained property data. |
[out] | data_size | The size of the obtained property data. |
[out] | error | Log error messages. |
void ob_device_upgrade | ( | ob_device * | device, |
const char * | path, | ||
ob_device_upgrade_callback | callback, | ||
bool | async, | ||
void * | user_data, | ||
ob_error ** | error | ||
) |
Upgrade the device firmware.
[in] | device | The device object. |
[in] | path | The firmware path. |
[in] | callback | The firmware upgrade progress callback. |
[in] | async | Whether to execute asynchronously. |
[in] | user_data | User-defined data that will be returned in the callback. |
[out] | error | Log error messages. |
void ob_device_upgrade_from_data | ( | ob_device * | device, |
const char * | file_data, | ||
uint32_t | file_size, | ||
ob_device_upgrade_callback | callback, | ||
bool | async, | ||
void * | user_data, | ||
ob_error ** | error | ||
) |
Upgrade the device firmware.
[in] | device | The device object. |
[in] | file_data | The firmware file data. |
[in] | file_size | The firmware file size. |
[in] | callback | The firmware upgrade progress callback. |
[in] | async | Whether to execute asynchronously. |
[in] | user_data | User-defined data that will be returned in the callback. |
[out] | error | Log error messages. |
ob_device_state ob_device_get_device_state | ( | ob_device * | device, |
ob_error ** | error | ||
) |
Get the current device status.
[in] | device | The device object. |
[out] | error | Log error messages. |
void ob_device_state_changed | ( | ob_device * | device, |
ob_device_state_callback | callback, | ||
void * | user_data, | ||
ob_error ** | error | ||
) |
Monitor device state changes.
[in] | device | The device object. |
[in] | callback | The callback function to be called when the device status changes. |
[in] | user_data | User-defined data that will be returned in the callback. |
[out] | error | Log error messages. |
void ob_device_send_file_to_destination | ( | ob_device * | device, |
const char * | file_path, | ||
const char * | dst_path, | ||
ob_file_send_callback | callback, | ||
bool | async, | ||
void * | user_data, | ||
ob_error ** | error | ||
) |
Send files to the specified path on the device.
[in] | device | The device object. |
[in] | file_path | The source file path. |
[in] | dst_path | The destination path on the device. |
[in] | callback | The file sending progress callback. |
[in] | async | Whether to execute asynchronously. |
[in] | user_data | User-defined data that will be returned in the callback. |
[out] | error | Log error messages. |
bool ob_device_activate_authorization | ( | ob_device * | device, |
const char * | auth_code, | ||
ob_error ** | error | ||
) |
Verify the device authorization code.
[in] | device | The device object. |
[in] | auth_code | The authorization code. |
[out] | error | Log error messages. |
void ob_device_write_authorization_code | ( | ob_device * | device, |
const char * | auth_code, | ||
ob_error ** | error | ||
) |
Write the device authorization code.
[in] | device | The device object. |
[in] | auth_code | The authorization code. |
[out] | error | Log error messages. |
ob_camera_param_list * ob_device_get_calibration_camera_param_list | ( | ob_device * | device, |
ob_error ** | error | ||
) |
Get the original parameter list of camera calibration saved on the device.
[in] | device | The device object. |
[out] | error | Log error messages. |
ob_depth_work_mode ob_device_get_current_depth_work_mode | ( | ob_device * | device, |
ob_error ** | error | ||
) |
Get the current depth work mode.
[in] | device | The device object. |
[out] | error | Log error messages. |
ob_status ob_device_switch_depth_work_mode | ( | ob_device * | device, |
const ob_depth_work_mode * | work_mode, | ||
ob_error ** | error | ||
) |
Switch the depth work mode by ob_depth_work_mode. Prefer to use ob_device_switch_depth_work_mode_by_name to switch depth mode when the complete name of the depth work mode is known.
[in] | device | The device object. |
[in] | work_mode | The depth work mode from ob_depth_work_mode_list which is returned by ob_device_get_depth_work_mode_list. |
[out] | error | Log error messages. |
ob_status ob_device_switch_depth_work_mode_by_name | ( | ob_device * | device, |
const char * | mode_name, | ||
ob_error ** | error | ||
) |
Switch the depth work mode by work mode name.
[in] | device | The device object. |
[in] | mode_name | The depth work mode name which is equal to ob_depth_work_mode.name. |
[out] | error | Log error messages. |
ob_depth_work_mode_list * ob_device_get_depth_work_mode_list | ( | ob_device * | device, |
ob_error ** | error | ||
) |
Request the list of supported depth work modes.
[in] | device | The device object. |
[out] | error | Log error messages. |
Device reboot.
[in] | device | Device object |
[out] | error | Log error messages |
ob_device_sync_config ob_device_get_sync_config | ( | ob_device * | device, |
ob_error ** | error | ||
) |
Get the current device synchronization configuration.
Device synchronization: including exposure synchronization function and multi-camera synchronization function of different sensors within a single machine
[in] | device | Device object |
[out] | error | Log error messages |
void ob_device_set_sync_config | ( | ob_device * | device, |
ob_device_sync_config | device_sync_config, | ||
ob_error ** | error | ||
) |
Set the device synchronization configuration.
Used to configure the exposure synchronization function and multi-camera synchronization function of different sensors in a single machine
[in] | device | Device object |
[out] | device_sync_config | Device synchronization configuration |
[out] | error | Log error messages |
const char * ob_device_info_name | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get device name.
[in] | info | Device Information |
[out] | error | Log error messages |
int ob_device_info_pid | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get device pid.
[in] | info | Device Information |
[out] | error | Log error messages |
int ob_device_info_vid | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get device vid.
[in] | info | Device Information |
[out] | error | Log error messages |
const char * ob_device_info_uid | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get device uid.
[in] | info | Device Information |
[out] | error | Log error messages |
const char * ob_device_info_serial_number | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get device serial number.
[in] | info | Device Information |
[out] | error | Log error messages |
const char * ob_device_info_firmware_version | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get the firmware version number.
[in] | info | Device Information |
[out] | error | Log error messages |
const char * ob_device_info_usb_type | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get the USB connection type (DEPRECATED)
[in] | info | Device Information |
[out] | error | Log error messages |
const char * ob_device_info_connection_type | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get the device connection type.
[in] | info | Device Information |
[out] | error | Log error messages |
const char * ob_device_info_ip_address | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get the device IP address.
info | Device Information |
error | Log error messages |
const char * ob_device_info_hardware_version | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get the hardware version number.
[in] | info | Device Information |
[out] | error | Log error messages |
const char * ob_device_info_get_extension_info | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get the device extension information.
[in] | info | Device Information |
[out] | error | Log error messages |
const char * ob_device_info_supported_min_sdk_version | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get the minimum SDK version number supported by the device.
[in] | info | Device Information |
[out] | error | Log error messages |
const char * ob_device_info_asicName | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get the chip name.
[in] | info | Device Information |
[out] | error | Log error messages |
ob_device_type ob_device_info_device_type | ( | ob_device_info * | info, |
ob_error ** | error | ||
) |
Get the device type.
[in] | info | Device Information |
[out] | error | Log error messages |
uint32_t ob_camera_param_list_count | ( | ob_camera_param_list * | param_list, |
ob_error ** | error | ||
) |
Get the number of camera parameter lists.
param_list | Camera parameter list |
error | Log error messages |
ob_camera_param ob_camera_param_list_get_param | ( | ob_camera_param_list * | param_list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get camera parameters from the camera parameter list.
param_list | Camera parameter list |
index | Parameter index |
error | Log error messages |
void ob_delete_camera_param_list | ( | ob_camera_param_list * | param_list, |
ob_error ** | error | ||
) |
Delete the camera parameter list.
param_list | Camera parameter list |
error | Log error messages |
uint32_t ob_depth_work_mode_list_count | ( | ob_depth_work_mode_list * | work_mode_list, |
ob_error ** | error | ||
) |
ob_depth_work_mode ob_depth_work_mode_list_get_item | ( | ob_depth_work_mode_list * | work_mode_list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get the index target of ob_depth_work_mode from work_mode_list.
[in] | work_mode_list | Data structure containing a list of ob_depth_work_mode |
[in] | index | Index of the target ob_depth_work_mode |
[out] | error | Log error messages |
void ob_delete_depth_work_mode_list | ( | ob_depth_work_mode_list * | work_mode_list, |
ob_error ** | error | ||
) |
Free the resources of ob_depth_work_mode_list.
[in] | work_mode_list | Data structure containing a list of ob_depth_work_mode |
[out] | error | Log error messages |
void ob_delete_data_bundle | ( | ob_data_bundle * | data_bundle, |
ob_error ** | error | ||
) |
Free the resources of data_bundle which come from OrbbecSDK's API.
data_bundle | Data bundle | |
[out] | error | Log error messages |
Check if the device supports global timestamp.
[in] | device | The device object. |
[out] | error | Log error messages. |
void ob_device_load_depth_filter_config | ( | ob_device * | device, |
const char * | file_path, | ||
ob_error ** | error | ||
) |
Load depth filter config from file.
[in] | device | The device object. |
[in] | file_path | Path of the config file. |
[out] | error | Log error messages. |
Reset depth filter config to device default define.
[in] | device | The device object. |
[out] | error | Log error messages. |
The preset mean a set of parameters or configurations that can be applied to the device to achieve a specific effect or function.
@breif Get the current preset name.
device | The device object. |
error | Log error messages. |
Get the available preset list.
device | The device object. |
preset_name | Log error messages. The name should be one of the preset names returned by ob_device_get_available_preset_list. |
error | Log error messages. |
void ob_device_load_preset_from_json_file | ( | ob_device * | device, |
const char * | json_file_path, | ||
ob_error ** | error | ||
) |
Load preset from json string.
After loading the custom preset, the settings in the custom preset will set to the device immediately.
After loading the custom preset, the available preset list will be appended with the custom preset and named as the file name.
device | The device object. |
json_file_path | The json file path. |
error | Log error messages. |
void ob_device_export_current_settings_as_preset_json_file | ( | ob_device * | device, |
const char * | json_file_path, | ||
ob_error ** | error | ||
) |
Export current settings as a preset json file.
After exporting the custom preset, the available preset list will be appended with the custom preset and named as the file name.
device | The device object. |
json_file_path | The json file path. |
error | Log error messages. |
ob_device_preset_list * ob_device_get_available_preset_list | ( | ob_device * | device, |
ob_error ** | error | ||
) |
Get the available preset list.
device | The device object. |
error | Log error messages. |
void ob_delete_preset_list | ( | ob_device_preset_list * | preset_list, |
ob_error ** | error | ||
) |
Delete the available preset list.
preset_list | The available preset list. |
error | Log error messages. |
uint32_t ob_device_preset_list_count | ( | ob_device_preset_list * | preset_list, |
ob_error ** | error | ||
) |
Get the number of preset in the preset list.
preset_list | The available preset list. |
error | Log error messages. |
const char * ob_device_preset_list_get_name | ( | ob_device_preset_list * | preset_list, |
uint32_t | index, | ||
ob_error ** | error | ||
) |
Get the name of the preset in the preset list.
preset_list | The available preset list. |
index | The index of the preset in the preset list. |
error | Log error messages. |
bool ob_device_preset_list_has_preset | ( | ob_device_preset_list * | preset_list, |
const char * | preset_name, | ||
ob_error ** | error | ||
) |
Check if the preset list has the preset.
preset_list | The available preset list. |
preset_name | The name of the preset. |
error | Log error messages. |