Known issues

This page tracks current limitations and temporary requirements of the Rokoko Device SDK that are expected to change in future releases. Several are constraints you need to work around today rather than bugs to be fixed.

This list is not exhaustive. For specific CLI error messages and how to resolve them, see the CLI Troubleshooting table instead. If you hit something not covered here or there, contact Rokoko support.

USB connections require the -ef 4 driver flag

To connect a device over a USB cable, the SDK driver currently has to be started with the -ef 4 argument. If you also want to stream data over USB, use -ef 516 instead. See the Quick Start guide for the full driver invocation.

Status: This flag is required today but is expected to change as USB support stabilizes.

RGMP v2 must be enabled explicitly

The RGMP v2 pipeline formatter is not yet the default. To run the examples — and to stream data with the RGMP v2 protocol — the driver must be started with --pipeline_formatter rgmp_v2.

Status: Required today. RGMP v2 is expected to become the default formatter in a future release, at which point this flag will no longer be needed.

Firmware updates are limited to specific devices

The CLI rokoko device update command can only flash Smartsuit Pro II and Smartgloves devices. Other device types report that firmware update is not supported.

Workaround: Update unsupported devices through the Rokoko Studio application.