Documentation Guide

Changelog

Version updates and changelog for Wuji Studio

Overview

Wuji Studio positioning, supported devices, and core capabilities

Download and Installation

Check requirements, install Wuji Studio, and keep it updated

• System Requirements
  Check supported operating systems, hardware, and prerequisites
• Installation Steps
  Get the installer and complete Wuji Studio setup
• Updating Studio
  In-app update checks, specific-version installs, restart

Basic Settings

Create a user profile and adjust theme and language preferences

• User Profile
  Create a Studio user profile to isolate calibration data per user
• Personalization
  Adjust theme, language, and display preferences

Device Management

Discover, connect, rename devices, and enter visualization

• Connect View Overview
  Understand the device list, connection status, and common actions
• Discover and Connect Devices
  Scan nearby devices and establish a connection
• Shared Connections and the Read-Only Notice
  Whether Studio can join a device another host holds depends on that host's enable_bridge setting
• Disconnect a Device
  Safely disconnect the current device
• Use the Device Command Palette
  Run common device actions such as reconnect and calibrate
• View Connection History
  Review recent devices and reconnect quickly
• Device Naming
  Set automatic names or manually rename devices

Data visualization

Visualization layout, topic tree, and layout presets

• Layout Presets
  Save, switch, and manage layout presets with import and export
• Panel Types
  Learn what Plot and Tactile Matrix panels show and when to use them
• 3D Hand Visualization
  View hand skeleton, fingertip poses, EMF, and point cloud data in 3D
• Data Recording
  Record all subscribed Topics to MCAP files for offline playback and analysis
• Device Logs
  View real-time device and software logs for troubleshooting

Firmware Upgrade

Select devices and firmware, run upgrades, and review results

• Upgrade Workflow
  Complete device selection, firmware selection, upgrade, and result review in order

Device Calibration

Device calibration flow, 6 poses, and troubleshooting

• Calibration Home
  Select a hand profile, start, and read the live data panel
• Starting Calibration
  Run 6 guided poses with automatic capture
• Calibration Complete
  Recalibrate, view the URDF, or enter visualization
• Troubleshooting
  Common issues like pose mismatch, timeout, and disconnect

Tactile Contact Calibration

Tactile contact calibration flow, 4 no-contact motions, and sensitivity

• Calibration Home
  Select a glove, check status, and start
• Starting Calibration
  Record 4 no-contact motions for the baseline
• Calibration Complete
  Train the model and verify by pressing the glove
• What Contact Detection Means
  Heat map expresses contact presence, judged against a pose baseline with false-positive filtering
• Adjust Contact Sensitivity
  Tune how easily a press registers as contact
• Troubleshooting
  Service not ready, aborted, or connection issues

Troubleshooting

Common issues with startup, data, and firmware upgrades

• Won't start / white screen or crash
• Panels show blank
• Restore the default layout
  Right-click the preset tab and select Reset to Default
• Tactile data is all 0 or -1
  Values of -1 are normal invalid points, with checks when values stay 0 after pressing
• Tactile data is inaccurate or shows abnormal values
• Tactile data flickering or jumping
• Tactile matrix heatmap shows all black
• Tactile matrix heatmap is misaligned or sheared
  Set Matrix panel Columns to 31 to fix the shearing
• EMF positioning is inaccurate or drifting
• EMF confidence is consistently low
• IMU orientation data is drifting
• Firmware upgrade failed
• Encountering errors during upgrade
• Use local firmware for upgrade
  Upload a local firmware .zip and the app parses version and release notes
• Get technical support
  Contact support@wuji.tech with diagnostic details