Health Diagnostics

When a device won't connect or its data looks wrong, run wuji doctor first. It connects to the device, samples real-time data (about 100 frames, done in seconds), and prints a tree-shaped report that turns "why doesn't it work" from guesswork into a conclusion.

What It Checks

Supported devices and fault types:

• Wuji Glove
  • EMF disconnection check: locates the affected finger and distinguishes RX (receiver) from TX (transmitter) faults
  • Tactile sensor dead-pixel, bad-row, and bad-column check

Usage

wuji doctor                # diagnose all devices
wuji doctor --sn <SN>      # diagnose a specific device only
wuji doctor -v             # show all checks (passing ones are hidden by default)
wuji doctor --json         # the same information as the tree report, as structured JSON

Read the Report

$ wuji doctor

══════ Wuji Glove: WG1KXXXXXXXXXXX ══════
├─ ✔ EMF disconnect check: all 5 fingers normal
└─ ! tactile dead-pixel check: 0 dead pixels, 2 bad rows, 2 bad cols
   ├─ ! Bad rows: 2 bad row(s)
   └─ ! Bad cols: 2 bad col(s)
   Tip: Tactile check result is for reference only; verify via tactile heatmap in Wuji Studio

• Status marks: ✔ pass, ! warn (advisory anomaly), ✘ fail (confirmed fault), and ~ skip (check couldn't run, such as invalid sample data)
• Tip: lines are fix suggestions
• Exit code: 0 means no failures (warnings don't count as failures), and 1 means a failure exists or the diagnosis couldn't complete — ready for script assertions
• Tactile check results are advisory (capped at warn) — verify with the tactile matrix heatmap in Wuji Studio

Expand All Checks

By default only anomalies show. Use -v to expand every check, including passing ones, to see exactly what was checked:

$ wuji doctor -v

══════ Wuji Glove: WG1KXXXXXXXXXXX ══════
├─ ✔ EMF disconnect check: all 5 fingers normal
│  ├─ ✔ Thumb
│  ├─ ✔ Index
│  ├─ ✔ Middle
│  ├─ ✔ Ring
│  └─ ✔ Pinky
└─ ! tactile dead-pixel check: 0 dead pixels, 0 bad rows, 1 bad cols
   ├─ ✔ Thumb
   ├─ ✔ Index
   ├─ ✔ Middle
   ├─ ✔ Ring
   ├─ ✔ Pinky
   ├─ ✔ Palm
   └─ ! Bad cols: 1 bad col(s)
   Tip: Tactile check result is for reference only; verify via tactile heatmap in Wuji Studio

Structured Output

--json prints the same information as the tree report in machine-readable form (one node per check item, nested via children), for saving and scripting:

wuji doctor --json > doctor-report.json