GUI Control Panel Guide
The Revo 3 provides developers with a high-frequency, real-time graphical Qt debugging control panel (gui/main.py), supporting 21-motor telemetry sliders, live wave plotting, MIT impedance telemetry, and secure 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 Precompiled Visualized Client (Out-of-the-box, for general & non-R&D use)
This version provides richer feature sets and premium visualized tools, tailored for product evaluation, routine operation, and general demonstration.
- Windows: 📥 Graphical PC Client (Windows x64) (Supports Win 10 / 11)
- Linux: 📥 Graphical PC Client (Ubuntu x64) (Supports Ubuntu 20.04 / 22.04)
Option 2: Run via SDK Source Code (For developer & R&D debugging)
Relatively lightweight and low-level focused, designed for developer verification and debugging alongside the Stark SDK. 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 advanced calibrations) are strictly based on the Graphical PC Client (Option 1).
- The SDK Source-based GUI (Option 2) is a lightweight utility designed for developer-level quick API verification, and its layout/focus differ accordingly.
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 Optimization: On Linux, strongly ensure
low_latencyflags are initialized to secure tight control query cycles.
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
.binfirmware file. The client secure chunk dispatcher will program the onboard Flash. 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 intensive 21-motor motions or DFU upgrading processes, assure the stable 24V supply is safely bolted. Never disconnect mid-way.
📞 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.