How attu0/spartan works
This repository implements an operator-teleoperated tracked rover with a 4-DOF arm, stereo camera, and local Streamlit dashboard. The operator selects arm, camera, or rover controls; the dashboard dispatches arm commands through the UNO Q bridge, sends rover commands over serial to the Mega, and displays camera and locally computed depth imagery. The README documents hardware-level relationships; the Mega firmware directory is present but its source was not sampled, and GPS is currently stubbed rather than an active capability.
Main entry points: ui.py Control Dashboard · vision.py Camera Capture · main.py App Entry · arm_control.py Arm Interface
Components 13
Operator Dashboard
- App Entry
python/main.py - Control Dashboard
python/ui.py
Arm Control
- Arm Interface
python/arm_control.py - UNO Q Firmware
sketch/sketch.ino - Arm Motors
Rover Locomotion
- Rover Interface
python/rover_control.py - Mega Firmware
mega_code/ros_arduino_bridge - Track Motors
- GPS Status Stub
python/rover_control.py
Stereo Vision
- Stereo Camera
- Camera Capture
python/vision.py - Depth Processing
python/vision.py
Other components
- Operator
Connections 13
- Operator → App Entry: opens dashboard
README.md - App Entry → Control Dashboard: loads pages
python/main.py - Control Dashboard → Arm Interface: dispatches arm
python/ui.py - Arm Interface → UNO Q Firmware: calls bridge
README.md - UNO Q Firmware → Arm Motors: drives directly
README.md - Control Dashboard → Rover Interface: dispatches drive
python/ui.py - Rover Interface → Mega Firmware: sends serial commands
python/rover_control.py - Mega Firmware → Track Motors: controls locomotion
README.md - Stereo Camera → Camera Capture: streams frames
README.md - Camera Capture → Depth Processing: provides stereo frames
python/vision.py - Control Dashboard → Camera Capture: starts and reads capture
python/ui.py - Control Dashboard → Depth Processing: starts and reads depth
python/ui.py - Control Dashboard → GPS Status Stub: reads status
python/ui.py