# arshamfn/waveshare-jetson-ros2-rover architecture

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

- Interactive diagram: https://gitdiagram.com/arshamfn/waveshare-jetson-ros2-rover
- Repository: https://github.com/arshamfn/waveshare-jetson-ros2-rover

## Overview

This repository describes and configures a ROS 2 autonomous rover: a handheld operator starts the stack or sends driving and navigation commands; LiDAR-based odometry and SLAM estimate pose and build a map; Nav2 plans and follows goals; and the driver converts velocity commands into motor-board wheel targets. The graph includes documented hardware, remote-control, mapping, and navigation capabilities. Several runtime packages are documented but unsampled, so their internal call relationships are not expanded.

Main entry points: [`src/robot_description/launch/bringup.launch.py`](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/launch/bringup.launch.py) (ROS bringup), [`src/robot_description/config/nav2_params.yaml`](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/nav2_params.yaml) (Nav2 navigation), [`src/robot_description/config/slam_toolbox_params.yaml`](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/slam_toolbox_params.yaml) (SLAM Toolbox), [`src/robot_description/config/twist_mux.yaml`](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/twist_mux.yaml) (Velocity mux)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator_control["Operator control"]
  node_foxglove["Foxglove pendant"]
  node_pendant_control["Pendant control<br/>[control_node.py]"]
  node_rviz["RViz2"]
  node_foxglove_bridge["foxglove_bridge"]
end

subgraph group_stack_runtime["Stack runtime"]
  node_stack_services["Stack services"]
  node_bringup["ROS bringup<br/>[bringup.launch.py]"]
  node_description["Robot description<br/>[rover.urdf]"]
  node_teleop["Joystick teleop<br/>[teleop_joy.yaml]"]
  node_velocity_mux["Velocity mux<br/>[twist_mux.yaml]"]
end

subgraph group_mapping_navigation["Mapping and navigation"]
  node_rf2o["LiDAR odometry<br/>[rf2o_params.yaml]"]
  node_slam["SLAM Toolbox"]
  node_map_store[("Saved maps")]
  node_nav2["Nav2 navigation<br/>[nav2_params.yaml]"]
end

subgraph group_rover_hardware["Rover hardware"]
  node_rover_driver["Motor and telemetry driver"]
  node_motor_board["MFD motor board"]
  node_lidar["RPLidar scan source<br/>[rplidar-ros.md]"]
end

node_operator(("Handheld operator"))

node_operator -->|"operates"| node_foxglove
node_foxglove -->|"connects to"| node_foxglove_bridge
node_foxglove -->|"controls"| node_pendant_control
node_pendant_control -->|"starts and stops"| node_stack_services
node_pendant_control -->|"saves maps"| node_map_store
node_bringup -->|"loads URDF"| node_description
node_bringup -->|"launches"| node_rover_driver
node_bringup -->|"launches"| node_teleop
node_bringup -->|"launches"| node_velocity_mux
node_bringup -->|"launches"| node_lidar
node_bringup -->|"launches"| node_rf2o
node_bringup -->|"launches"| node_slam
node_bringup -.->|"configures"| node_nav2
node_teleop -->|"supplies joystick commands"| node_velocity_mux
node_nav2 -->|"supplies navigation commands"| node_velocity_mux
node_velocity_mux -->|"sends velocity commands"| node_rover_driver
node_rover_driver -->|"sends wheel targets"| node_motor_board
node_lidar -->|"provides scans"| node_rf2o
node_rf2o -->|"provides odometry"| node_slam
node_slam -->|"provides live map"| node_nav2
node_slam -.->|"saves map data"| node_map_store
node_nav2 -->|"presents paths and costmaps"| node_foxglove
node_rviz -->|"sets goal poses"| node_nav2

click node_pendant_control "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/pendant_bridge/pendant_bridge/control_node.py"
click node_stack_services "https://github.com/arshamfn/waveshare-jetson-ros2-rover/tree/main/tools/systemd"
click node_bringup "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/launch/bringup.launch.py"
click node_description "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/urdf/rover.urdf"
click node_teleop "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/teleop_joy.yaml"
click node_velocity_mux "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/twist_mux.yaml"
click node_rover_driver "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/rover_driver/rover_driver/rover_driver_node.py"
click node_lidar "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/docs/software/rplidar-ros.md"
click node_rf2o "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/rf2o_params.yaml"
click node_slam "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/slam_toolbox_params.yaml"
click node_map_store "https://github.com/arshamfn/waveshare-jetson-ros2-rover/tree/main/maps"
click node_nav2 "https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/nav2_params.yaml"

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_foxglove,node_pendant_control,node_rviz,node_foxglove_bridge toneBlue
class node_stack_services,node_bringup,node_description,node_teleop,node_velocity_mux toneAmber
class node_rf2o,node_slam,node_map_store,node_nav2 toneMint
class node_rover_driver,node_motor_board,node_lidar toneRose
class node_operator toneIndigo
```

## Components

### Operator control

- **Foxglove pendant**
- [Pendant control](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/pendant_bridge/pendant_bridge/control_node.py): `src/pendant_bridge/pendant_bridge/control_node.py`
- **RViz2**
- **foxglove_bridge**

### Stack runtime

- [Stack services](https://github.com/arshamfn/waveshare-jetson-ros2-rover/tree/main/tools/systemd): `tools/systemd`
- [ROS bringup](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/launch/bringup.launch.py): `src/robot_description/launch/bringup.launch.py`
- [Robot description](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/urdf/rover.urdf): `src/robot_description/urdf/rover.urdf`
- [Joystick teleop](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/teleop_joy.yaml): `src/robot_description/config/teleop_joy.yaml`
- [Velocity mux](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/twist_mux.yaml): `src/robot_description/config/twist_mux.yaml`

### Mapping and navigation

- [LiDAR odometry](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/rf2o_params.yaml): `src/robot_description/config/rf2o_params.yaml`
- [SLAM Toolbox](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/slam_toolbox_params.yaml): `src/robot_description/config/slam_toolbox_params.yaml`
- [Saved maps](https://github.com/arshamfn/waveshare-jetson-ros2-rover/tree/main/maps): `maps`
- [Nav2 navigation](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/robot_description/config/nav2_params.yaml): `src/robot_description/config/nav2_params.yaml`

### Rover hardware

- [Motor and telemetry driver](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/src/rover_driver/rover_driver/rover_driver_node.py): `src/rover_driver/rover_driver/rover_driver_node.py`
- **MFD motor board**
- [RPLidar scan source](https://github.com/arshamfn/waveshare-jetson-ros2-rover/blob/main/docs/software/rplidar-ros.md): `docs/software/rplidar-ros.md`

### Other components

- **Handheld operator**

## Connections

- Handheld operator → Foxglove pendant: operates (evidence: `README.md`)
- Foxglove pendant → foxglove_bridge: connects to (evidence: `README.md`)
- Foxglove pendant → Pendant control: controls (evidence: `README.md`)
- Pendant control → Stack services: starts and stops (evidence: `src/pendant_bridge/pendant_bridge/control_node.py`)
- Pendant control → Saved maps: saves maps (evidence: `src/pendant_bridge/pendant_bridge/control_node.py`)
- ROS bringup → Robot description: loads URDF (evidence: `src/robot_description/launch/bringup.launch.py`)
- ROS bringup → Motor and telemetry driver: launches (evidence: `src/robot_description/launch/bringup.launch.py`)
- ROS bringup → Joystick teleop: launches (evidence: `src/robot_description/launch/bringup.launch.py`)
- ROS bringup → Velocity mux: launches (evidence: `src/robot_description/launch/bringup.launch.py`)
- ROS bringup → RPLidar scan source: launches (evidence: `src/robot_description/launch/bringup.launch.py`)
- ROS bringup → LiDAR odometry: launches (evidence: `src/robot_description/launch/bringup.launch.py`)
- ROS bringup → SLAM Toolbox: launches (evidence: `src/robot_description/launch/bringup.launch.py`)
- ROS bringup → Nav2 navigation: configures
- Joystick teleop → Velocity mux: supplies joystick commands
- Nav2 navigation → Velocity mux: supplies navigation commands
- Velocity mux → Motor and telemetry driver: sends velocity commands
- Motor and telemetry driver → MFD motor board: sends wheel targets (evidence: `README.md`)
- RPLidar scan source → LiDAR odometry: provides scans
- LiDAR odometry → SLAM Toolbox: provides odometry
- SLAM Toolbox → Nav2 navigation: provides live map (evidence: `README.md`)
- SLAM Toolbox → Saved maps: saves map data
- Nav2 navigation → Foxglove pendant: presents paths and costmaps (evidence: `README.md`)
- RViz2 → Nav2 navigation: sets goal poses (evidence: `README.md`)
