Skip to main content

Connect View Overview

When you launch Wuji Studio, the Connect View appears as the main interface for managing devices. Connect View The Connect View consists of the following areas:

Discover and Connect Devices

The app automatically scans for Wuji devices on the local network (refreshing every 5 seconds) and displays discovered devices as cards in the device list. Click the Connect button on a device card to establish a connection. During connection, the app automatically detects left- or right-hand information from the device SN and generates a default name—no manual naming required. On startup, Wuji Studio automatically restores devices connected in the previous session, with the status bar showing progress while restore is running.
Wuji Studio supports up to 2 simultaneously connected devices. When the limit is reached, attempting to connect another device shows a prompt asking you to disconnect an existing device first.

Shared Connections and the Read-Only Notice

When another host already holds the device through Wuji SDK, whether Studio can connect is decided by the Wuji SDK enable_bridge option (on by default). When the sharing host turns it off, Studio can’t connect to that device—see Wuji SDK Device Connection. Access after connecting through a shared device depends on the product:
  • Wuji Hand 2: No read-only notice appears, and both read and write work. When multiple parties send control commands or change device parameters at the same time, the writes overwrite each other—coordinate who writes.
  • Wuji Glove: The later party is read-only—a warning appears in the bottom-right corner saying the device is connected via Zenoh (read-only mode). You can subscribe to every data stream, but the sharing host rejects control commands and device parameter writes. To get write access, disconnect the device on the host that shares it, then reconnect in Studio.

Disconnect a Device

Disconnect a device in the following ways:
  • Click the Disconnect button on the device card
  • Click the device name in the center of the App bar → select Disconnect from the command palette
  • Click Disconnect All in the Panel area header to disconnect all devices at once

Use the Device Command Palette

Click the device name in the center of the App bar to open the command palette. When multiple devices are connected, a device selection list appears first. Commands available for connected devices: Clicking a disconnected device opens a name input dialog, and the device connects automatically after entering a name.

View Connection History

The left sidebar stores up to 5 recent connection records. Click Reconnect All to restore connections at once—this button becomes available when previously connected devices are discovered on the current network and are offline. Delete individual records or clear all history.

Device Naming

Automatic Naming

When connecting a device for the first time, Wuji Studio detects left- or right-hand information from the device serial number and generates a default name automatically:

Rename a Device

Rename Device
  1. Click the device name in the App bar to open the command palette.
  2. Select Rename Device.
  3. Enter a new name and confirm.
After renaming a connected device, the app automatically disconnects and reconnects with the new name. Topic paths update to reflect the new device name (for example, /left_glove/sensor/tactile becomes /my_device/sensor/tactile).

Naming Rules

Device names follow ROS naming conventions:
  • Must start with a letter (a–z, A–Z)
  • Only letters, digits (0–9), and underscores (_) are allowed
  • Maximum 50 characters