How robstride/edulite_a3 works
EL-A3 is a seven-axis robotic-arm project with two independent control surfaces: a direct-CAN Python SDK with MotorStudio, and a ROS 2 stack for hardware control, teleoperation, and MoveIt planning. The GUI workflow runs from operator commands through its worker and SDK to motor communication, with feedback returned for monitoring and visualization. ROS provides a separate hardware/description/planning workflow. The README documents the principal ROS capabilities; some ROS launch and GUI widget internals were not sampled, so those links are cited only where documentation or the source index supports them.
Main entry points: main_window.py Main window · interface.py Arm interface · el_a3_hardware.cpp ROS hardware · arm_worker.py Arm worker
Components 29
Python SDK
- Arm interface
el_a3_sdk/el_a3_sdk/interface.py - Arm manager
el_a3_sdk/el_a3_sdk/arm_manager.py - CAN driver
el_a3_sdk/el_a3_sdk/can_driver.py - SLCAN driver
el_a3_sdk/el_a3_sdk/slcan_can_driver.py - Motor protocol
el_a3_sdk/el_a3_sdk/protocol.py - Arm data types
el_a3_sdk/el_a3_sdk/data_types.py
MotorStudio GUI
- Studio entry
el_a3_sdk/MotorStudio/main.py - Main window
el_a3_sdk/MotorStudio/main_window.py - Arm worker
el_a3_sdk/MotorStudio/backend/arm_worker.py - Control panels
el_a3_sdk/MotorStudio/widgets/joint_control_panel.py - Diagnostics
el_a3_sdk/MotorStudio/widgets/diagnostics_panel.py - Gamepad panel
el_a3_sdk/MotorStudio/widgets/gamepad_panel.py - Trajectory panel
el_a3_sdk/MotorStudio/widgets/trajectory_panel.py - 3D viewer
el_a3_sdk/MotorStudio/widgets/viewer_3d.py - URDF loader
el_a3_sdk/MotorStudio/utils/urdf_loader.py - Drag controls
el_a3_sdk/MotorStudio/utils/joint_drag_controls.py
ROS2 Control
- Control launch
el_a3_ros/el_a3_description/launch/el_a3_control.launch.py - Robot description
el_a3_ros/el_a3_description - ROS hardware
el_a3_ros/el_a3_hardware/src/el_a3_hardware.cpp - Robstride CAN
el_a3_ros/el_a3_hardware/src/robstride_can_driver.cpp - Gravity controller
el_a3_ros/el_a3_hardware/src/zero_torque_controller.cpp - MoveIt planning
el_a3_ros/el_a3_moveit_config/launch/demo.launch.py
Motion Tools
- Kinematics
el_a3_sdk/el_a3_sdk/kinematics.py - Trajectory tools
el_a3_sdk/el_a3_sdk/trajectory.py - Controller profiles
el_a3_sdk/el_a3_sdk/controller_profiles.py - Xbox teleoperation
el_a3_ros/el_a3_teleop/el_a3_teleop/xbox_teleop_node.py
Other components
- Operator
- Arm motors
- Gamepad
Connections 33
- Operator → Studio entry: launches
el_a3_sdk/MotorStudio/main.py - Studio entry → Main window: opens
el_a3_sdk/MotorStudio/main.py - Main window → Arm worker: commands
el_a3_sdk/MotorStudio/main_window.py - Main window → Control panels: connects controls
el_a3_sdk/MotorStudio/main_window.py - Main window → Diagnostics: routes scan results
el_a3_sdk/MotorStudio/main_window.py - Main window → Gamepad panel: connects arm
el_a3_sdk/MotorStudio/main_window.py - Main window → Trajectory panel: hosts
el_a3_sdk/MotorStudio/main_window.py - Main window → 3D viewer: connects viewer
el_a3_sdk/MotorStudio/main_window.py - 3D viewer → URDF loader: loads model
el_a3_sdk/MotorStudio/widgets/viewer_3d.py - 3D viewer → Drag controls: uses
el_a3_sdk/MotorStudio/widgets/viewer_3d.py - Arm worker → Arm interface: controls arm
el_a3_sdk/MotorStudio/backend/arm_worker.py - Arm interface → CAN driver: sends motor commands
el_a3_sdk/el_a3_sdk/interface.py - Arm interface → SLCAN driver: supports backend
el_a3_sdk/el_a3_sdk/interface.py - CAN driver → Motor protocol: encodes frames
el_a3_sdk/el_a3_sdk/can_driver.py - SLCAN driver → Motor protocol: encodes frames
el_a3_sdk/el_a3_sdk/slcan_can_driver.py - Arm interface → Arm data types: uses messages
el_a3_sdk/el_a3_sdk/interface.py - Arm worker → Arm data types: collects feedback
el_a3_sdk/MotorStudio/backend/arm_worker.py - Arm manager → Arm interface: creates instances
el_a3_sdk/el_a3_sdk/arm_manager.py - Operator → Arm manager: manages arms
- Kinematics → Arm data types: returns pose
el_a3_sdk/el_a3_sdk/kinematics.py - Trajectory panel → Trajectory tools: uses trajectories
- Gamepad panel → Controller profiles: maps inputs
- Arm interface → Arm motors: communicates over CAN
- Operator → Control launch: starts control
el_a3_ros/el_a3_description/launch/el_a3_control.launch.py - Control launch → ROS hardware: starts interface
- Control launch → Robot description: loads model
- ROS hardware → Robstride CAN: uses CAN driver
el_a3_ros/el_a3_hardware/src/el_a3_hardware.cpp - Gravity controller → ROS hardware: writes effort
- MoveIt planning → ROS hardware: plans through control
- Robot description → MoveIt planning: defines robot model
- Gamepad → Xbox teleoperation: provides input
el_a3_ros/el_a3_teleop/el_a3_teleop/xbox_teleop_node.py - Xbox teleoperation → ROS hardware: commands joints
- Robstride CAN → Arm motors: communicates over CAN