New Features and Major Improvements
- LingBot Enhanced Depth Filter: Now available for Gemini 330 series devices. The filter combines Color and Depth information to reduce depth noise, fill depth holes, and refine object edges. It currently supports NVIDIA Jetson/Linux ARM64; before use, activate the device license and deploy the
model.sm4file provided with this release. See the LingBot Enhanced Depth Filter Guide for details. - Timestamp enhancements:
- Improved global timestamp fitting by using the system monotonic clock as the fitting reference, preventing NTP synchronization or system wall-clock adjustments from causing timestamp jumps and providing more continuous and stable timestamps.
- Device timestamps can now use either the system monotonic clock or the system wall clock as their clock source.
- Added hardware PPS time synchronization for DaBai series devices in multi-device synchronization scenarios.
- Expanded preset import and export for Gemini 330 series devices. Presets can now include both device parameters and Application Config, such as stream profiles, alignment mode, point cloud, and HDR Merge state.
- Added public Color Preset APIs for querying and switching presets by name.
- Added
FalsePositiveFiltersupport for Gemini 330 series devices, the general-purposeUnDistortionFilter, andDispOutliersFiltersupport for DaBai Max series devices. - Gemini 335Le and Gemini 435Le now support network-device CCP state queries.
- Improved third-party open-source compliance by including the applicable open-source license files for third-party libraries in SDK release packages.
Key New APIs
- Application Config for Gemini 330 series devices:
- C++:
ob::ApplicationConfig - C:
ob_device_get_application_config,ob_device_is_application_config_supported
- C++:
- Color Preset:
- C++:
ob::Device::isColorPresetSupported,ob::Device::getCurrentColorPresetName,ob::Device::switchColorPreset,ob::Device::getColorPresetList - C:
ob_device_is_color_preset_supported,ob_device_get_current_color_preset_name,ob_device_switch_color_preset,ob_device_get_color_preset_list - Applications should use these APIs to query and switch Color Presets. Direct access to
OB_PROP_COLOR_PRESET_PRIORITY_INT(ID 255) is not recommended because the property will become internal in a future release.
- C++:
- Timestamp clock source and hardware PPS time synchronization for DaBai series devices:
- C++:
ob::Context::setTimestampClockType,ob::Context::syncDeviceHardwarePPSTime,ob::Device::syncDeviceHardwarePPSTime - C:
ob_context_set_timestamp_clock_type,ob_sync_device_hardware_pps_time,ob_device_sync_hardware_pps_time
- C++:
- Network-device CCP state queries for Gemini 335Le and Gemini 435Le:
- C++:
ob::DeviceList::queryDeviceAccessState,ob::DeviceList::queryDeviceAccessStateBySN - C:
ob_device_list_query_device_access_state,ob_device_list_query_device_access_state_by_serial_number
- C++:
- Firmware-log state queries:
- C++:
ob::Device::isFirmwareLogEnabled - C:
ob_device_is_firmware_log_enabled
- C++:
Improvements and Fixes
- Improved Linux build compatibility by supporting SDK sample compilation with GCC 15 and later.
- Improved Pipeline health monitoring to avoid false status errors during normal stream shutdown, with better handling for software-trigger and hardware-trigger modes and fewer unnecessary device-status queries.
- Improved HDR Merge frame matching by using timestamp matching when frame-number matching is unavailable, allowing IR frames to participate more reliably when stream startup is delayed.
- Improved activity detection for Femto Mega and Femto Mega I network devices to prevent GVCP scanning errors from incorrectly marking devices as offline.
- Fixed stream startup failures and hardware D2C state conflicts in multi-Pipeline scenarios on Gemini 330 and Gemini 305 series devices.
- Improved stream startup, shutdown, and long-running stability for Linux V4L2 USB, GMSL, and GigE network devices.
- Fixed LiDAR devices failing to stop streaming when only the ACCEL or GYRO stream was enabled.
- Fixed repeated
MJPG metadata update skipped:logs when streaming from Femto Mega and Femto Mega I network devices. - Corrected D2C alignment, Color intrinsic, and distortion parameter issues affecting DaBai A, DaBai, Gemini 340, and Gemini 305 series devices.
- Fixed Optional Depth Preset updates potentially reporting success after a failed update.
- Improved thread safety and communication reliability during device property access and firmware or preset updates.
Document
OrbbecSDKv2 API User Guide, This document provides an overview of key features in the OrbbecSDK and demonstrates how to use its most commonly used APIs. For more detailed APIs, please refer to the document below:
API Reference: OrbbecSDKv2_API_Reference.html
Supported Devices and Recommended Firmware Version
| Products List | Recommended FW Version | Note |
|---|---|---|
| Gemini 305g | 1.0.70 | |
| Gemini 305 | 1.0.70 | |
| Astra Mini Pro | 2.0.03 | Version of v2.x.x (major version 2) indicates firmware using the UVC protocol, which is only supported by Orbbec SDK v2. |
| Astra Mini S Pro | 2.0.03 | Version of v2.x.x (major version 2) indicates firmware using the UVC protocol, which is only supported by Orbbec SDK v2. |
| Gemini 435Le | 1.3.19 | |
| Gemini 330 series | 1.8.10 | Gemini 330/330L/335/335L/336/336L/335Lg/335Le |
| Gemini 338Le/338Lg | 1.8.17 | Gemini 338Le/338Lg |
| Gemini 215 | 1.0.9 | |
| Gemini 210 | 1.0.9 | |
| Gemini 2 | 1.4.98 | |
| Gemini 2 L | 1.5.2 | |
| Femto Bolt | 1.1.3 | unsupport macOS |
| Femto Mega | 1.3.1 | |
| Femto Mega I | 2.0.5 | |
| Astra 2 | 2.8.20 | |
| Gemini 345 | 1.9.03 | |
| Gemini 345Lg | 1.9.03 | |
| Pulsar SL450 | 2.2.4.5 | |
| Pulsar ME450 | 1.0.0.6 |
Supported platforms
- Windows 10 or later: x64 architectures
- Linux x64: tested on Ubuntu 20.04, 22.04 and 24.04
- Linux ARM64: tested on NVIDIA Jetson AGX Orin , NVIDIA Jetson Orin NX , NVIDIA Jetson Orin Nano , NVIDIA Jetson AGX Xavier , NVIDIA Jetson Xavier NX , NVIDIA Jetson Thor
- macOS: tested on M2 chip, OS version 26.0