6.4. firmware_update_tool Device Maintenance Tool
firmware_update_tool updates device firmware or burns preset files from the ROS1 command line. Before updating, make sure the device connection is stable. When multiple devices are connected, specify serial numbers to avoid updating the wrong device.
Show help:
rosrun orbbec_camera firmware_update_tool --help
Update firmware for one device:
rosrun orbbec_camera firmware_update_tool \
--serial_number <SN> \
--firmware_path /path/to/firmware.bin
Burn a preset file:
rosrun orbbec_camera firmware_update_tool \
--serial_number <SN> \
--preset_path /path/to/preset.bin
For batch updates, --serial_number accepts comma-separated serial numbers. Add --continue_on_error if later devices should still be processed after one device fails.
rosrun orbbec_camera firmware_update_tool \
--serial_number SN1,SN2 \
--firmware_path /path/to/firmware.bin \
--continue_on_error
To enable SDK file logs and also attempt to enable firmware logs, add --sdk_log_level. Optional values are debug, info, warn, error, fatal, and off; the default is off.
rosrun orbbec_camera firmware_update_tool \
--serial_number <SN> \
--preset_path /path/to/preset.bin \
--sdk_log_level debug
The old launch arguments upgrade_firmware and preset_firmware_path are still parsed for compatibility, but --firmware_path and --preset_path are recommended.