How inf2004-esp-rover-ii/integrated-rover-ii works
This repository implements a camera-equipped rover system: sensors and vision provide observations, rover firmware handles motion and telemetry, and laptop software supports navigation, mapping, and operator monitoring. The mapping package models exploration and route planning, with a simulator for exercising those behaviors. The graph preserves the documented dashboard, onboard mapping/DFS, camera streaming, and sensor capabilities. Some firmware and dashboard modules were not excerpted; their links are limited to SOURCE INDEX references rather than claims about detailed runtime behavior.
Main entry points: main.c Rover controller · controller.py Mapping controller · robot_dashboard.py Robot dashboard · laptop_navigation.py Laptop navigation
Components 24
Operator tools
- Robot dashboard
dashboard/robot_dashboard.py - Laptop navigation
dashboard/laptop_navigation.py - Mission display
dashboard/mission_display.py - Rover camera
dashboard/rover_camera.py
Mapping and navigation
- Mapping controller
rover_mapping/mapping/controller.py - Marker graph
rover_mapping/mapping/graph.py - Route planner
rover_mapping/mapping/planner.py - Mapping events
rover_mapping/mapping/events.py - Route execution
rover_mapping/mapping/route_exec.py - Grid localization
dashboard/grid_localization.py - DFS explorer
dashboard/dfs_explorer.py
Rover firmware
- Rover controller
firmware/robo_pico/src/main.c - Onboard exploration
firmware/robo_pico/src/onboard_dfs.c - Onboard driving
firmware/robo_pico/src/onboard_drive.c - Motor control
firmware/robo_pico/src/motor_driver.c - Rover communications
firmware/robo_pico/src/wifi_mqtt.c
Sensing and vision
- Sensor controller
firmware/sensor_pico/src/main.c - Sensor acquisition
firmware/sensor_pico/src/obstacle.c - Camera streamer
firmware/esp32_s3_vision/main/app_main.c - Vision publisher
vision/vision_publisher.py - Marker pose
vision/marker_pose.py
Simulation
- Simulated rover
rover_mapping/sim/sim_rover.py - Maze world
rover_mapping/sim/maze.py
Other components
- Operator
Connections 21
- Operator → Robot dashboard: operates
dashboard/robot_dashboard.py - Robot dashboard → Laptop navigation: uses navigation
dashboard/robot_dashboard.py - Robot dashboard → Mission display: shows mission
dashboard/robot_dashboard.py - Robot dashboard → Rover camera: shows camera
dashboard/robot_dashboard.py - Laptop navigation → Grid localization: localizes with
dashboard/laptop_navigation.py - Laptop navigation → DFS explorer: explores with
dashboard/laptop_navigation.py - Mapping controller → Mapping events: emits and handles
rover_mapping/mapping/controller.py - Mapping controller → Marker graph: updates
rover_mapping/mapping/controller.py - Mapping controller → Route planner: plans through
rover_mapping/mapping/controller.py - Route execution → Mapping controller: drives state machine
rover_mapping/mapping/route_exec.py - Route execution → Mapping events: handles events
rover_mapping/mapping/route_exec.py - Rover controller → Onboard exploration: initializes and uses
firmware/robo_pico/src/main.c - Rover controller → Onboard driving: initializes and uses
firmware/robo_pico/src/main.c - Rover controller → Motor control: controls motion
- Rover controller → Rover communications: publishes telemetry
firmware/robo_pico/src/main.c - Sensor controller → Sensor acquisition: acquires readings
firmware/sensor_pico/src/main.c - Sensor controller → Rover controller: sends sensor data
- Camera streamer → Vision publisher: streams video to
- Vision publisher → Marker pose: estimates markers with
vision/vision_publisher.py - Simulated rover → Maze world: traverses
rover_mapping/sim/sim_rover.py - Simulated rover → Mapping controller: exchanges events with
rover_mapping/sim/sim_rover.py