# robstride/edulite_a3 architecture

> Architecture diagram of the GitHub repository robstride/edulite_a3, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/robstride/edulite_a3
- Repository: https://github.com/robstride/edulite_a3

## Overview

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: [`el_a3_sdk/MotorStudio/main_window.py`](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/main_window.py) (Main window), [`el_a3_sdk/el_a3_sdk/interface.py`](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/interface.py) (Arm interface), [`el_a3_ros/el_a3_hardware/src/el_a3_hardware.cpp`](https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_hardware/src/el_a3_hardware.cpp) (ROS hardware), [`el_a3_sdk/MotorStudio/backend/arm_worker.py`](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/backend/arm_worker.py) (Arm worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sdk["Python SDK"]
  node_sdk_interface["Arm interface<br/>[interface.py]"]
  node_arm_manager["Arm manager<br/>[arm_manager.py]"]
  node_can_driver["CAN driver<br/>[can_driver.py]"]
  node_slcan_driver["SLCAN driver"]
  node_protocol["Motor protocol<br/>[protocol.py]"]
  node_data_types["Arm data types<br/>[data_types.py]"]
end

subgraph group_studio["MotorStudio GUI"]
  node_studio_entry["Studio entry<br/>[main.py]"]
  node_main_window["Main window<br/>[main_window.py]"]
  node_arm_worker["Arm worker<br/>[arm_worker.py]"]
  node_studio_panels["Control panels"]
  node_diagnostics["Diagnostics"]
  node_gamepad["Gamepad panel<br/>[gamepad_panel.py]"]
  node_trajectory_panel["Trajectory panel"]
  node_viewer["3D viewer<br/>[viewer_3d.py]"]
  node_urdf_loader["URDF loader<br/>[urdf_loader.py]"]
  node_drag_controls["Drag controls"]
end

subgraph group_ros["ROS2 Control"]
  node_ros_launch["Control launch"]
  node_description["Robot description"]
  node_ros_hardware["ROS hardware<br/>[el_a3_hardware.cpp]"]
  node_robstride["Robstride CAN"]
  node_zero_torque["Gravity controller"]
  node_moveit["MoveIt planning<br/>[demo.launch.py]"]
end

subgraph group_motion["Motion Tools"]
  node_kinematics["Kinematics<br/>[kinematics.py]"]
  node_trajectory["Trajectory tools<br/>[trajectory.py]"]
  node_controller_profiles["Controller profiles"]
  node_ros_teleop["Xbox teleoperation"]
end

node_operator(("Operator"))
node_motor(("Arm motors"))
node_ros_gamepad(("Gamepad"))

node_operator -->|"launches"| node_studio_entry
node_studio_entry -->|"opens"| node_main_window
node_main_window -->|"commands"| node_arm_worker
node_main_window -->|"connects controls"| node_studio_panels
node_main_window -->|"routes scan results"| node_diagnostics
node_main_window -->|"connects arm"| node_gamepad
node_main_window -->|"hosts"| node_trajectory_panel
node_main_window -->|"connects viewer"| node_viewer
node_viewer -->|"loads model"| node_urdf_loader
node_viewer -->|"uses"| node_drag_controls
node_arm_worker -->|"controls arm"| node_sdk_interface
node_sdk_interface -->|"sends motor commands"| node_can_driver
node_sdk_interface -->|"supports backend"| node_slcan_driver
node_can_driver -->|"encodes frames"| node_protocol
node_slcan_driver -->|"encodes frames"| node_protocol
node_sdk_interface -->|"uses messages"| node_data_types
node_arm_worker -->|"collects feedback"| node_data_types
node_arm_manager -->|"creates instances"| node_sdk_interface
node_operator -.->|"manages arms"| node_arm_manager
node_kinematics -->|"returns pose"| node_data_types
node_trajectory_panel -.->|"uses trajectories"| node_trajectory
node_gamepad -.->|"maps inputs"| node_controller_profiles
node_sdk_interface -.->|"communicates over CAN"| node_motor
node_operator -->|"starts control"| node_ros_launch
node_ros_launch -.->|"starts interface"| node_ros_hardware
node_ros_launch -.->|"loads model"| node_description
node_ros_hardware -->|"uses CAN driver"| node_robstride
node_zero_torque -.->|"writes effort"| node_ros_hardware
node_moveit -.->|"plans through control"| node_ros_hardware
node_description -.->|"defines robot model"| node_moveit
node_ros_gamepad -->|"provides input"| node_ros_teleop
node_ros_teleop -.->|"commands joints"| node_ros_hardware
node_robstride -.->|"communicates over CAN"| node_motor

click node_studio_entry "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/main.py"
click node_main_window "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/main_window.py"
click node_arm_worker "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/backend/arm_worker.py"
click node_studio_panels "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/joint_control_panel.py"
click node_diagnostics "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/diagnostics_panel.py"
click node_gamepad "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/gamepad_panel.py"
click node_trajectory_panel "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/trajectory_panel.py"
click node_viewer "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/viewer_3d.py"
click node_urdf_loader "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/utils/urdf_loader.py"
click node_drag_controls "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/utils/joint_drag_controls.py"
click node_sdk_interface "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/interface.py"
click node_arm_manager "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/arm_manager.py"
click node_can_driver "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/can_driver.py"
click node_slcan_driver "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/slcan_can_driver.py"
click node_protocol "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/protocol.py"
click node_data_types "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/data_types.py"
click node_kinematics "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/kinematics.py"
click node_trajectory "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/trajectory.py"
click node_controller_profiles "https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/controller_profiles.py"
click node_ros_launch "https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_description/launch/el_a3_control.launch.py"
click node_description "https://github.com/robstride/edulite_a3/tree/main/el_a3_ros/el_a3_description"
click node_ros_hardware "https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_hardware/src/el_a3_hardware.cpp"
click node_robstride "https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_hardware/src/robstride_can_driver.cpp"
click node_zero_torque "https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_hardware/src/zero_torque_controller.cpp"
click node_moveit "https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_moveit_config/launch/demo.launch.py"
click node_ros_teleop "https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_teleop/el_a3_teleop/xbox_teleop_node.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sdk_interface,node_arm_manager,node_can_driver,node_slcan_driver,node_protocol,node_data_types toneBlue
class node_studio_entry,node_main_window,node_arm_worker,node_studio_panels,node_diagnostics,node_gamepad,node_trajectory_panel,node_viewer,node_urdf_loader,node_drag_controls toneAmber
class node_ros_launch,node_description,node_ros_hardware,node_robstride,node_zero_torque,node_moveit toneMint
class node_kinematics,node_trajectory,node_controller_profiles,node_ros_teleop toneRose
class node_operator,node_motor,node_ros_gamepad toneIndigo
```

## Components

### Python SDK

- [Arm interface](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/interface.py): `el_a3_sdk/el_a3_sdk/interface.py`
- [Arm manager](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/arm_manager.py): `el_a3_sdk/el_a3_sdk/arm_manager.py`
- [CAN driver](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/can_driver.py): `el_a3_sdk/el_a3_sdk/can_driver.py`
- [SLCAN driver](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/slcan_can_driver.py): `el_a3_sdk/el_a3_sdk/slcan_can_driver.py`
- [Motor protocol](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/protocol.py): `el_a3_sdk/el_a3_sdk/protocol.py`
- [Arm data types](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/data_types.py): `el_a3_sdk/el_a3_sdk/data_types.py`

### MotorStudio GUI

- [Studio entry](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/main.py): `el_a3_sdk/MotorStudio/main.py`
- [Main window](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/main_window.py): `el_a3_sdk/MotorStudio/main_window.py`
- [Arm worker](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/backend/arm_worker.py): `el_a3_sdk/MotorStudio/backend/arm_worker.py`
- [Control panels](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/joint_control_panel.py): `el_a3_sdk/MotorStudio/widgets/joint_control_panel.py`
- [Diagnostics](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/diagnostics_panel.py): `el_a3_sdk/MotorStudio/widgets/diagnostics_panel.py`
- [Gamepad panel](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/gamepad_panel.py): `el_a3_sdk/MotorStudio/widgets/gamepad_panel.py`
- [Trajectory panel](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/trajectory_panel.py): `el_a3_sdk/MotorStudio/widgets/trajectory_panel.py`
- [3D viewer](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/widgets/viewer_3d.py): `el_a3_sdk/MotorStudio/widgets/viewer_3d.py`
- [URDF loader](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/utils/urdf_loader.py): `el_a3_sdk/MotorStudio/utils/urdf_loader.py`
- [Drag controls](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/MotorStudio/utils/joint_drag_controls.py): `el_a3_sdk/MotorStudio/utils/joint_drag_controls.py`

### ROS2 Control

- [Control launch](https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_description/launch/el_a3_control.launch.py): `el_a3_ros/el_a3_description/launch/el_a3_control.launch.py`
- [Robot description](https://github.com/robstride/edulite_a3/tree/main/el_a3_ros/el_a3_description): `el_a3_ros/el_a3_description`
- [ROS hardware](https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_hardware/src/el_a3_hardware.cpp): `el_a3_ros/el_a3_hardware/src/el_a3_hardware.cpp`
- [Robstride CAN](https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_hardware/src/robstride_can_driver.cpp): `el_a3_ros/el_a3_hardware/src/robstride_can_driver.cpp`
- [Gravity controller](https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_hardware/src/zero_torque_controller.cpp): `el_a3_ros/el_a3_hardware/src/zero_torque_controller.cpp`
- [MoveIt planning](https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_moveit_config/launch/demo.launch.py): `el_a3_ros/el_a3_moveit_config/launch/demo.launch.py`

### Motion Tools

- [Kinematics](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/kinematics.py): `el_a3_sdk/el_a3_sdk/kinematics.py`
- [Trajectory tools](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/trajectory.py): `el_a3_sdk/el_a3_sdk/trajectory.py`
- [Controller profiles](https://github.com/robstride/edulite_a3/blob/main/el_a3_sdk/el_a3_sdk/controller_profiles.py): `el_a3_sdk/el_a3_sdk/controller_profiles.py`
- [Xbox teleoperation](https://github.com/robstride/edulite_a3/blob/main/el_a3_ros/el_a3_teleop/el_a3_teleop/xbox_teleop_node.py): `el_a3_ros/el_a3_teleop/el_a3_teleop/xbox_teleop_node.py`

### Other components

- **Operator**
- **Arm motors**
- **Gamepad**

## Connections

- Operator → Studio entry: launches (evidence: `el_a3_sdk/MotorStudio/main.py`)
- Studio entry → Main window: opens (evidence: `el_a3_sdk/MotorStudio/main.py`)
- Main window → Arm worker: commands (evidence: `el_a3_sdk/MotorStudio/main_window.py`)
- Main window → Control panels: connects controls (evidence: `el_a3_sdk/MotorStudio/main_window.py`)
- Main window → Diagnostics: routes scan results (evidence: `el_a3_sdk/MotorStudio/main_window.py`)
- Main window → Gamepad panel: connects arm (evidence: `el_a3_sdk/MotorStudio/main_window.py`)
- Main window → Trajectory panel: hosts (evidence: `el_a3_sdk/MotorStudio/main_window.py`)
- Main window → 3D viewer: connects viewer (evidence: `el_a3_sdk/MotorStudio/main_window.py`)
- 3D viewer → URDF loader: loads model (evidence: `el_a3_sdk/MotorStudio/widgets/viewer_3d.py`)
- 3D viewer → Drag controls: uses (evidence: `el_a3_sdk/MotorStudio/widgets/viewer_3d.py`)
- Arm worker → Arm interface: controls arm (evidence: `el_a3_sdk/MotorStudio/backend/arm_worker.py`)
- Arm interface → CAN driver: sends motor commands (evidence: `el_a3_sdk/el_a3_sdk/interface.py`)
- Arm interface → SLCAN driver: supports backend (evidence: `el_a3_sdk/el_a3_sdk/interface.py`)
- CAN driver → Motor protocol: encodes frames (evidence: `el_a3_sdk/el_a3_sdk/can_driver.py`)
- SLCAN driver → Motor protocol: encodes frames (evidence: `el_a3_sdk/el_a3_sdk/slcan_can_driver.py`)
- Arm interface → Arm data types: uses messages (evidence: `el_a3_sdk/el_a3_sdk/interface.py`)
- Arm worker → Arm data types: collects feedback (evidence: `el_a3_sdk/MotorStudio/backend/arm_worker.py`)
- Arm manager → Arm interface: creates instances (evidence: `el_a3_sdk/el_a3_sdk/arm_manager.py`)
- Operator → Arm manager: manages arms
- Kinematics → Arm data types: returns pose (evidence: `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 (evidence: `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 (evidence: `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 (evidence: `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
