GUI Control Panel Guide

The Revo 3 SDK includes a graphical Qt debugging tool (gui/main.py) for connection setup, 21-motor telemetry, waveform plotting, MIT impedance parameters, and local firmware upgrades (OTA).

🚀 GUI Debugging & Control Tool Guide

Depending on your scenario and technical background, two different startup options are available:

Option 1: Download the Desktop Tool

This tool is used for device setup, status monitoring, motion control, parameter calibration, and firmware upgrade.

• Windows: 📥 Revo 3 Desktop Tool (Windows x64) (Supports Win 10 / 11)
• Linux: Coming soon

Option 2: Run the SDK GUI Tool from Source

This lightweight GUI debugging tool is used for SDK integration and functional verification. It supports --mock mode.

Execute the Python initialization script inside the SDK root directory to spin up the interface:

cd python
pip install -r requirements.txt

# Start the Qt GUI debugger (supports --mock mode for testing)
python gui/main.py

💡 UI & Scope of Description

• The functional descriptions in this guide (such as UI layout, finger control parameters, and calibration flows) are based on the Revo 3 Desktop Tool (Option 1).
• The SDK Source-based GUI (Option 2) is a lightweight GUI debugging tool for SDK integration and functional verification, and its layout differs from Option 1.

---

2. Core Functional Modules

2.1 Port Connection Setup

• Default Settings: The default serial baud rate is 5M (5000000 bps). The Slave address defaults to 127 for the right hand and 126 for the left hand.
• Latency Settings: On Linux, verify that the serial port low_latency flag is enabled when shorter query cycles are required.

2.2 21-Motor Coordinated Control & Telemetry

• Joint Sliders: Interactive 21-motor flexion, extension, and abduction slides mapped to precise encoders (0.1° unit).
• Live Plotter: Telemetry charts updating up to 200Hz showing current, position, and velocity dynamic tracking signals.

2.3 MIT Impedance Control Panel

• Fine-tune compliance metrics for robotic environments:
  • Slide target coefficients for Kp (Stiffness) and Kd (Damping).
  • Trajectory Generation: Dispatch profile wave schedules (e.g. sine wave) to review physical tracking response.

2.4 Secure Firmware Flash (OTA DFU)

• Click Tools ➡️ OTA on the menu bar.
• Import the target .bin firmware file. The tool writes the firmware to onboard Flash in chunks. Reboot the device once complete.

---

⚠️ Firmware Compatibility & Power Limits

• SKU Safety: Firmware images are tailored to specific motor models. Double-check hardware markings before upgrading to prevent hardware lockout.
• Power Quality: During 21-motor motions or DFU upgrades, use a stable 24V power supply and keep the power connector fixed. Never disconnect power during the upgrade.

---

📞 Technical Inquiries

For troubleshooting connectivity faults or impedance parameters matching, reach out to the BrainCo Support Team or click the Help entry to submit a ticket.