OrbbecSDK_v2

C++ Sample：2.device.firmware_update

Overview

This sample demonstrates how to use the SDK to update the optional depth presets of a connected device. It includes functions to list connected devices, select a device, and update its depth presets.

Note: This sample is only applicable to devices that support presets, such as G330 serials of devices

Knowledge

Context is the environment context, the first object created during initialization, which can be used to perform some settings, including but not limited to device status change callbacks, log level settings, etc. Context can access multiple Devices.

Device is the device object, which can be used to obtain the device information, such as the model, serial number, and various sensors.One actual hardware device corresponds to one Device object.

code overview

Initialize the SDK Context: This is necessary to access the connected devices.

     std::shared_ptr<ob::Context> context = std::make_shared<ob::Context>();

List Connected Devices.

     std::shared_ptr<ob::DeviceList> deviceList = context->queryDeviceList();
     for(uint32_t i = 0; i < deviceList->getCount(); ++i) {
         devices.push_back(deviceList->getDevice(i));
     }

Define a Callback Function for Firmware Update Progress.

You can define a callback function to get the progress of the firmware update. The callback function will be called every time the device updates its progress.
```
     void presetUpdateCallback(OBFwUpdateState state, const char *message, uint8_t percent) {
         // show update state and message here
     }
```
Update the optional depth presets.

After selecting a device, update its presets by calling the updateOptionalDepthPresets function with the specified callback.
```
     device->updateOptionalDepthPresets(filePaths, count, presetUpdateCallback);
```
Note: The api supports upgrading multiple presets at once. For G300 series devices, a maximum of 3 presets can be written at a time. The first preset written will be set as the default preset.

Attention

After the optional depth presets update completes, you don’t need to restart the device.
Don’t plug out the device during the presets update process.
For linux users, it is recommended to use the LibUVC as the backend as the V4L2 backend may cause some issues on some systems. Switch backend before create device like this:
```
     context->setUvcBackendType(OB_UVC_BACKEND_TYPE_LIBUVC);
```

Run Sample

Select the device for presets update and input the path of the presets file. The SDK will start updating the presets, and the progress will be displayed on the console.

Result

This site is open source. Improve this page.