How longh-do/teleop_openarm_system works
This repository is a Raspberry Pi–hosted teleoperation system for driving two OpenArm arms from a Meta Quest browser. The primary workflow is controller input in the headset, pose and control processing in the teleoperation server, inverse kinematics, then joint targets over localhost UDP to the motor loop and CAN-connected motors. Supporting branches cover calibration and gain tuning, plus simulation and model inspection. The graph uses README statements and shown source/index references; unsampled page and subsystem details are represented only where documented, so some internal links are omitted.
Main entry points: motor_loop.py Motor Loop · kinematics.py Kinematics · teleop_server.py Teleop Server · damiao.py DAMIAO Protocol
Components 20
Headset Interface
- Quest Page
quest/index.html
Teleoperation
- Teleop Server
pi/teleop_server.py - Arm Brain
pi/teleop_server.py - Kinematics
pi/kinematics.py
Motor Control
- Motor Loop
pi/motor_loop.py - DAMIAO Protocol
pi/damiao.py - CAN Buses
- Gain Settings
pi/gains.json
Calibration Tools
- Calibration Data
pi/calib.json - Find Joint Stops
tools/find_stops.py - Find Grip Stops
tools/grip_stops.py - Straighten Joints
tools/straighten.py - Untwist Readout
tools/untwist.py - IK Move Check
tools/ik_move.py - Tune Gains
tools/tune_gains.py - Model Inspection
tools/fk_plot.py
Simulation
- Fake Motors
tools/fake_motors.py - Fake Quest
tools/fake_quest.py
Other components
- Operator
- OpenArm Arms
Connections 24
- Operator → Quest Page: uses controls
README.md - Quest Page → Teleop Server: sends controls
pi/teleop_server.py - Teleop Server → Arm Brain: dispatches input
pi/teleop_server.py - Arm Brain → Kinematics: solves IK
pi/teleop_server.py - Teleop Server → Motor Loop: sends UDP targets
README.md - Motor Loop → DAMIAO Protocol: uses protocol
pi/motor_loop.py - Motor Loop → CAN Buses: transmits frames
README.md - CAN Buses → OpenArm Arms: drives motors
README.md - Motor Loop → Gain Settings: loads gains
README.md - Kinematics → Calibration Data: loads calibration
pi/kinematics.py - Find Joint Stops → Kinematics: uses limits
tools/find_stops.py - Find Joint Stops → Calibration Data: writes stops
README.md - Find Grip Stops → DAMIAO Protocol: commands gripper
tools/grip_stops.py - Find Grip Stops → Calibration Data: records stops
README.md - Straighten Joints → Kinematics: uses calibration
tools/straighten.py - Straighten Joints → Motor Loop: sends targets
README.md - Untwist Readout → Kinematics: converts angles
tools/untwist.py - IK Move Check → Kinematics: plans motion
tools/ik_move.py - IK Move Check → Motor Loop: sends targets
tools/ik_move.py - Tune Gains → Motor Loop: starts and tests
tools/tune_gains.py - Tune Gains → Gain Settings: reads settings
README.md - Model Inspection → Kinematics: uses model
tools/fk_plot.py - Fake Motors → DAMIAO Protocol: emulates protocol
tools/fake_motors.py - Fake Motors → Motor Loop: simulates bus
README.md