Skip to content
ROKOKO Device SDK ROKOKO Device SDK
Get SDK Access

Wi-Fi setup for your Rokoko device

This guide will show you how to set up networking for your Rokoko device. This is normally only done once, when you connect the device to a different Wi-Fi network.

Normally this is done through the Rokoko Studio application, but in certain scenarios you may want to do this simply by running RCSP commands.

Wi-Fi network setup for your device

Section titled “Wi-Fi network setup for your device”
  1. Connect the device to your computer with a USB cable.
  2. Start the SDK driver, as described here.
  3. In another terminal, navigate to the $ROKOKO_SDK_HOME/examples/python folder and run the following command:
    Terminal window
    python3 network_configuration.py set --ssid <YOUR WIFI NAME> --receiver-address auto --receiver-port 14041

This script will connect to the driver, and set the network configuration on the device. If no device is connected, it will print an error message and terminate. The script accepts various arguments on the command line, run it with the --help argument to see available options.

The --ssid argument is the name of the Wi-Fi network you want the device to connect to, when starting. If your Wi-Fi name contains non-alphanumeric characters, enclose it in quotes.

By default, the Wi-Fi security is WPA2, but you can select WPA3_Personal instead, if needed, by using the --security argument. Use a value of Open if the Wi-Fi is open. If you don't specify --security Open, the script will ask for your Wi-Fi password when run.

The --receiver-address auto argument will try to select the correct IP address to connect to the computer you are running the script on. If this fails (on a multi-Wi-Fi computer for example), you should put in the explicit IP address you want the device to connect to.

The --receiver-port 14041 argument is the port number that devices will try to connect to in the driver process. If, for some reason, port 14041 is used for something else on the machine, you can put in another port number here. If you do that, you should also add the same port number to your driver invocation later.

For example: Say you want to use the port 43871 instead of 14041. You would run

Terminal window
python3 network_configuration.py set --receiver-address auto --receiver-port 43871 --ssid <YOUR WIFI NAME>

and then restart the driver with an added -dup argument, like this:

Terminal window
rkk_sdk_driver -dup 43871 -ef 4 --pipeline_formatter rgmp_v2

Verify Wi-Fi setup

Section titled “Verify Wi-Fi setup”

After setting the network configuration, you can verify that it has taken effect by running

Terminal window
python3 network_configuration.py get

This should print out a summary of the network configuration.

Now you can disconnect from USB and restart the device and let it connect to Wi-Fi by itself.