# inf2004-esp-rover-ii/integrated-rover-ii architecture

> Architecture diagram of the GitHub repository inf2004-esp-rover-ii/integrated-rover-ii, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/inf2004-esp-rover-ii/integrated-rover-ii
- Repository: https://github.com/inf2004-esp-rover-ii/integrated-rover-ii

## Overview

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: [`firmware/robo_pico/src/main.c`](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/main.c) (Rover controller), [`rover_mapping/mapping/controller.py`](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/controller.py) (Mapping controller), [`dashboard/robot_dashboard.py`](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/robot_dashboard.py) (Robot dashboard), [`dashboard/laptop_navigation.py`](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/laptop_navigation.py) (Laptop navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator["Operator tools"]
  node_dashboard["Robot dashboard<br/>[robot_dashboard.py]"]
  node_laptop_nav["Laptop navigation"]
  node_mission_ui["Mission display<br/>[mission_display.py]"]
  node_camera_ui["Rover camera<br/>[rover_camera.py]"]
end

subgraph group_mapping["Mapping and navigation"]
  node_map_ctrl["Mapping controller<br/>[controller.py]"]
  node_marker_graph["Marker graph<br/>[graph.py]"]
  node_route_planner["Route planner<br/>[planner.py]"]
  node_mapping_events["Mapping events<br/>[events.py]"]
  node_route_exec["Route execution<br/>[route_exec.py]"]
  node_grid_localizer["Grid localization"]
  node_dfs_explorer["DFS explorer<br/>[dfs_explorer.py]"]
end

subgraph group_rover["Rover firmware"]
  node_rover_main["Rover controller<br/>[main.c]"]
  node_onboard_dfs["Onboard exploration<br/>[onboard_dfs.c]"]
  node_onboard_drive["Onboard driving<br/>[onboard_drive.c]"]
  node_motor["Motor control<br/>[motor_driver.c]"]
  node_rover_link["Rover communications<br/>[wifi_mqtt.c]"]
end

subgraph group_sensing["Sensing and vision"]
  node_sensor_main["Sensor controller<br/>[main.c]"]
  node_sensor_modules["Sensor acquisition<br/>[obstacle.c]"]
  node_camera_fw["Camera streamer<br/>[app_main.c]"]
  node_vision_pub["Vision publisher"]
  node_marker_pose["Marker pose<br/>[marker_pose.py]"]
end

subgraph group_simulation["Simulation"]
  node_sim_rover["Simulated rover<br/>[sim_rover.py]"]
  node_maze["Maze world<br/>[maze.py]"]
end

node_operator(("Operator"))

node_operator -->|"operates"| node_dashboard
node_dashboard -->|"uses navigation"| node_laptop_nav
node_dashboard -->|"shows mission"| node_mission_ui
node_dashboard -->|"shows camera"| node_camera_ui
node_laptop_nav -->|"localizes with"| node_grid_localizer
node_laptop_nav -->|"explores with"| node_dfs_explorer
node_map_ctrl -->|"emits and handles"| node_mapping_events
node_map_ctrl -->|"updates"| node_marker_graph
node_map_ctrl -->|"plans through"| node_route_planner
node_route_exec -->|"drives state machine"| node_map_ctrl
node_route_exec -->|"handles events"| node_mapping_events
node_rover_main -->|"initializes and uses"| node_onboard_dfs
node_rover_main -->|"initializes and uses"| node_onboard_drive
node_rover_main -.->|"controls motion"| node_motor
node_rover_main -->|"publishes telemetry"| node_rover_link
node_sensor_main -->|"acquires readings"| node_sensor_modules
node_sensor_main -.->|"sends sensor data"| node_rover_main
node_camera_fw -.->|"streams video to"| node_vision_pub
node_vision_pub -->|"estimates markers with"| node_marker_pose
node_sim_rover -->|"traverses"| node_maze
node_sim_rover -->|"exchanges events with"| node_map_ctrl

click node_dashboard "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/robot_dashboard.py"
click node_laptop_nav "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/laptop_navigation.py"
click node_mission_ui "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/mission_display.py"
click node_camera_ui "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/rover_camera.py"
click node_map_ctrl "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/controller.py"
click node_marker_graph "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/graph.py"
click node_route_planner "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/planner.py"
click node_mapping_events "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/events.py"
click node_route_exec "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/route_exec.py"
click node_grid_localizer "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/grid_localization.py"
click node_dfs_explorer "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/dfs_explorer.py"
click node_rover_main "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/main.c"
click node_onboard_dfs "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/onboard_dfs.c"
click node_onboard_drive "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/onboard_drive.c"
click node_motor "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/motor_driver.c"
click node_rover_link "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/wifi_mqtt.c"
click node_sensor_main "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/sensor_pico/src/main.c"
click node_sensor_modules "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/sensor_pico/src/obstacle.c"
click node_camera_fw "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/esp32_s3_vision/main/app_main.c"
click node_vision_pub "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/vision/vision_publisher.py"
click node_marker_pose "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/vision/marker_pose.py"
click node_sim_rover "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/sim/sim_rover.py"
click node_maze "https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/sim/maze.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_dashboard,node_laptop_nav,node_mission_ui,node_camera_ui toneBlue
class node_map_ctrl,node_marker_graph,node_route_planner,node_mapping_events,node_route_exec,node_grid_localizer,node_dfs_explorer toneAmber
class node_rover_main,node_onboard_dfs,node_onboard_drive,node_motor,node_rover_link toneMint
class node_sensor_main,node_sensor_modules,node_camera_fw,node_vision_pub,node_marker_pose toneRose
class node_sim_rover,node_maze,node_operator toneIndigo
```

## Components

### Operator tools

- [Robot dashboard](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/robot_dashboard.py): `dashboard/robot_dashboard.py`
- [Laptop navigation](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/laptop_navigation.py): `dashboard/laptop_navigation.py`
- [Mission display](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/mission_display.py): `dashboard/mission_display.py`
- [Rover camera](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/rover_camera.py): `dashboard/rover_camera.py`

### Mapping and navigation

- [Mapping controller](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/controller.py): `rover_mapping/mapping/controller.py`
- [Marker graph](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/graph.py): `rover_mapping/mapping/graph.py`
- [Route planner](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/planner.py): `rover_mapping/mapping/planner.py`
- [Mapping events](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/events.py): `rover_mapping/mapping/events.py`
- [Route execution](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/mapping/route_exec.py): `rover_mapping/mapping/route_exec.py`
- [Grid localization](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/grid_localization.py): `dashboard/grid_localization.py`
- [DFS explorer](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/dashboard/dfs_explorer.py): `dashboard/dfs_explorer.py`

### Rover firmware

- [Rover controller](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/main.c): `firmware/robo_pico/src/main.c`
- [Onboard exploration](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/onboard_dfs.c): `firmware/robo_pico/src/onboard_dfs.c`
- [Onboard driving](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/onboard_drive.c): `firmware/robo_pico/src/onboard_drive.c`
- [Motor control](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/motor_driver.c): `firmware/robo_pico/src/motor_driver.c`
- [Rover communications](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/robo_pico/src/wifi_mqtt.c): `firmware/robo_pico/src/wifi_mqtt.c`

### Sensing and vision

- [Sensor controller](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/sensor_pico/src/main.c): `firmware/sensor_pico/src/main.c`
- [Sensor acquisition](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/sensor_pico/src/obstacle.c): `firmware/sensor_pico/src/obstacle.c`
- [Camera streamer](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/firmware/esp32_s3_vision/main/app_main.c): `firmware/esp32_s3_vision/main/app_main.c`
- [Vision publisher](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/vision/vision_publisher.py): `vision/vision_publisher.py`
- [Marker pose](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/vision/marker_pose.py): `vision/marker_pose.py`

### Simulation

- [Simulated rover](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/sim/sim_rover.py): `rover_mapping/sim/sim_rover.py`
- [Maze world](https://github.com/inf2004-esp-rover-ii/integrated-rover-ii/blob/main/rover_mapping/sim/maze.py): `rover_mapping/sim/maze.py`

### Other components

- **Operator**

## Connections

- Operator → Robot dashboard: operates (evidence: `dashboard/robot_dashboard.py`)
- Robot dashboard → Laptop navigation: uses navigation (evidence: `dashboard/robot_dashboard.py`)
- Robot dashboard → Mission display: shows mission (evidence: `dashboard/robot_dashboard.py`)
- Robot dashboard → Rover camera: shows camera (evidence: `dashboard/robot_dashboard.py`)
- Laptop navigation → Grid localization: localizes with (evidence: `dashboard/laptop_navigation.py`)
- Laptop navigation → DFS explorer: explores with (evidence: `dashboard/laptop_navigation.py`)
- Mapping controller → Mapping events: emits and handles (evidence: `rover_mapping/mapping/controller.py`)
- Mapping controller → Marker graph: updates (evidence: `rover_mapping/mapping/controller.py`)
- Mapping controller → Route planner: plans through (evidence: `rover_mapping/mapping/controller.py`)
- Route execution → Mapping controller: drives state machine (evidence: `rover_mapping/mapping/route_exec.py`)
- Route execution → Mapping events: handles events (evidence: `rover_mapping/mapping/route_exec.py`)
- Rover controller → Onboard exploration: initializes and uses (evidence: `firmware/robo_pico/src/main.c`)
- Rover controller → Onboard driving: initializes and uses (evidence: `firmware/robo_pico/src/main.c`)
- Rover controller → Motor control: controls motion
- Rover controller → Rover communications: publishes telemetry (evidence: `firmware/robo_pico/src/main.c`)
- Sensor controller → Sensor acquisition: acquires readings (evidence: `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 (evidence: `vision/vision_publisher.py`)
- Simulated rover → Maze world: traverses (evidence: `rover_mapping/sim/sim_rover.py`)
- Simulated rover → Mapping controller: exchanges events with (evidence: `rover_mapping/sim/sim_rover.py`)
