How juxi-technology/amazinghand works
AmazingHand is a collection of robotic-hand designs and control tools for SCS0009 bus servos and an ESP32-S3 PWM variant. Users issue poses or live tracking input through desktop or browser controls; those controls translate commands into servo motion. Separate tools support direct servo debugging and calibration, while the PWM firmware receives serial commands, dispatches gestures, and drives eight PWM channels. The graph preserves documented capabilities even where implementation files were not sampled; those unsampled subsystem links are omitted or marked unverified.
Main entry points: ft_debugger.py Servo debugger · server.py Web service · main.c Firmware tasks · hand_servo.c PWM servo driver
Components 28
Browser control
- Web service
Amazinghand-web/server.py - Browser interface
Amazinghand-web-io/app.js - Camera tracking
Amazinghand-web-io/tracking.js - Web transport
Amazinghand-web-io/ws.js - Servo I/O
Amazinghand-web-io/io.js - PWM transport
Amazinghand-web-io/pwm.js
Desktop control
- Control GUI
AmazingHandControl/amazing_hand_gui.py - Pose and servo logic
AmazingHandControl/hand_logic.py - Control CLI
AmazingHandControl/amazing_hand_cmd.py
PWM firmware
- PWM desktop GUI
AmazingHand-PWM/tools/hand_gui.py - PWM hand tracking
AmazingHand-PWM/tools/hand_tracking.py - Firmware tasks
AmazingHand-PWM/firmware/AmazingHand_Serial/main/main.c - Serial protocol
AmazingHand-PWM/firmware/AmazingHand_Serial/components/hand_protocol/hand_protocol.c - Gesture dispatch
AmazingHand-PWM/firmware/AmazingHand_Serial/components/hand_gestures/hand_gestures.c - PWM servo driver
AmazingHand-PWM/firmware/AmazingHand_Serial/components/hand_servo/hand_servo.c
Servo tooling
- Servo debugger
SCS0009_ServoController/src/gui/ft_debugger.py - Factory calibration
SCS0009_ServoController/src/gui/factory_calibration_tool.py - Servo protocol SDK
SCS0009_ServoController/scservo_sdk/protocol_packet_handler.py - Serial port handler
SCS0009_ServoController/scservo_sdk/port_handler.py - Servo command layer
SCS0009_ServoController/scservo_sdk/scscl.py - Register definitions
SCS0009_ServoController/scservo_sdk/scservo_def.py - XDAT parameters
SCS0009_ServoController/src/xdat_utils.py - Port utilities
SCS0009_ServoController/src/port_utils.py - Translations
SCS0009_ServoController/src/i18n.py - Translation tables
SCS0009_ServoController/src/i18n_translations/factory.py
Examples and demos
- Python hand examples
AmazingHand-main/PythonExample
Other components
- Hand operator
- Robotic hand
Connections 35
- Hand operator → Browser interface: controls
README.md - Browser interface → Web service: sends commands
Amazinghand-web/server.py - Web service → Servo I/O: serves interface
Amazinghand-web/server.py - Web service → Web transport: receives WebSocket
Amazinghand-web/server.py - Camera tracking → Browser interface: provides tracking
- Web service → Robotic hand: drives servos
Amazinghand-web/server.py - Hand operator → Control GUI: controls
README.md - Control GUI → Pose and servo logic: uses logic
AmazingHandControl/amazing_hand_gui.py - Control CLI → Pose and servo logic: uses logic
AmazingHandControl/amazing_hand_cmd.py - Control GUI → Robotic hand: controls servos
- Control CLI → Robotic hand: controls servos
- Hand operator → PWM desktop GUI: controls
README.md - PWM desktop GUI → PWM hand tracking: uses tracking
AmazingHand-PWM/tools/hand_gui.py - PWM desktop GUI → Firmware tasks: sends serial commands
- PWM hand tracking → Robotic hand: guides motion
- Firmware tasks → Serial protocol: parses bytes
AmazingHand-PWM/firmware/AmazingHand_Serial/main/main.c - Firmware tasks → PWM servo driver: initializes driver
AmazingHand-PWM/firmware/AmazingHand_Serial/main/main.c - Firmware tasks → Gesture dispatch: dispatches commands
AmazingHand-PWM/firmware/AmazingHand_Serial/main/main.c - Serial protocol → Gesture dispatch: dispatches gestures
- Serial protocol → PWM servo driver: sets servo state
AmazingHand-PWM/firmware/AmazingHand_Serial/components/hand_protocol/hand_protocol.c - Gesture dispatch → PWM servo driver: moves fingers
AmazingHand-PWM/firmware/AmazingHand_Serial/components/hand_gestures/hand_gestures.c - PWM servo driver → Robotic hand: drives PWM channels
README.md - Hand operator → Servo debugger: debugs servos
README.md - Servo debugger → Servo command layer: issues servo commands
SCS0009_ServoController/src/gui/ft_debugger.py - Servo debugger → Serial port handler: opens serial port
SCS0009_ServoController/src/gui/ft_debugger.py - Servo debugger → XDAT parameters: loads parameters
SCS0009_ServoController/src/gui/ft_debugger.py - Servo debugger → Port utilities: uses port utilities
SCS0009_ServoController/src/gui/ft_debugger.py - Servo debugger → Translations: translates labels
SCS0009_ServoController/src/gui/ft_debugger.py - Factory calibration → Servo debugger: reuses debugger
SCS0009_ServoController/src/gui/factory_calibration_tool.py - Servo protocol SDK → Serial port handler: reads and writes
- Servo command layer → Servo protocol SDK: uses packet protocol
SCS0009_ServoController/scservo_sdk/scscl.py - Servo protocol SDK → Register definitions: uses definitions
SCS0009_ServoController/scservo_sdk/protocol_packet_handler.py - Servo command layer → Register definitions: uses definitions
SCS0009_ServoController/scservo_sdk/scscl.py - Translations → Translation tables: loads translations
- Hand operator → Python hand examples: runs demos
README.md