# beatriz-diniz/uavjamsim architecture

> Architecture diagram of the GitHub repository beatriz-diniz/uavjamsim, 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/beatriz-diniz/uavjamsim
- Repository: https://github.com/beatriz-diniz/uavjamsim

## Overview

UAVJamSim is a PX4/Gazebo UAV simulation framework for injecting sensor, camera, and motor attacks and exercising corresponding mitigations. The principal workflow is to start a PX4 SITL model, issue attack commands through the spoofer, and observe altered simulator data; PX4’s Gazebo bridge translates simulator sensors and applies attack/mitigation logic before publishing flight data. The README also documents sensor-specific simulation models and camera-stream monitoring. Several mitigation implementations are only partially excerpted, so their unverified runtime links are omitted or marked dashed.

Main entry points: [`px4/gz_bridge/GZBridge.cpp`](https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/gz_bridge/GZBridge.cpp) (Gazebo sensor bridge), [`spoofer/spoofer.cc`](https://github.com/beatriz-diniz/uavjamsim/blob/main/spoofer/spoofer.cc) (Spoofer CLI), [`px4/gstreamer/GstCameraSystem.cpp`](https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/gstreamer/GstCameraSystem.cpp) (Camera stream system), [`px4/gz_bridge/GZMixingInterfaceESC.cpp`](https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/gz_bridge/GZMixingInterfaceESC.cpp) (ESC mixing interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Command and monitoring"]
  node_spoofer_cli["Spoofer CLI<br/>[spoofer.cc]"]
  node_mitigator_cli["Mitigator CLI"]
end

subgraph group_attacks["Attack models"]
  node_gps_attacks["GPS attacks"]
  node_imu_attack["IMU attack<br/>[ImuAttack.cpp]"]
  node_baro_attack["Barometer attack"]
  node_lidar_attack["LiDAR attack<br/>[LidarAttack.cpp]"]
  node_mag_attack["Magnetometer attack"]
  node_stream_attack["Stream attack<br/>[StreamAttack.cpp]"]
  node_motor_attack["Motor attack<br/>[MotorAttack.cpp]"]
end

subgraph group_bridge["Simulation integration"]
  node_gz_bridge["Gazebo sensor bridge<br/>[GZBridge.cpp]"]
  node_esc_interface["ESC mixing interface"]
  node_camera_system["Camera stream system"]
  node_sim_mavlink["Simulator MAVLink"]
  node_mavlink_receiver["MAVLink receiver"]
end

subgraph group_mitigation["Mitigation models"]
  node_gps_mitigation["GPS mitigation<br/>[GpsMitigation.cpp]"]
  node_imu_mitigation["IMU mitigation<br/>[ImuMitigation.cpp]"]
  node_baro_mitigation["Barometer mitigation"]
  node_lidar_mitigation["LiDAR mitigation"]
  node_mag_mitigation["Magnetometer mitigation"]
  node_stream_mitigation["Stream mitigation"]
  node_motor_mitigation["Motor mitigation"]
  node_gps_mitig_sensor["GPS mitigation support<br/>[GpsMitigation.cpp]"]
end

node_operator(("Operator"))
node_px4_gz["PX4 SITL / Gazebo"]
node_qgc["QGroundControl"]

node_operator -->|"issues attack commands"| node_spoofer_cli
node_operator -->|"toggles mitigation"| node_mitigator_cli
node_operator -->|"starts simulation"| node_px4_gz
node_operator -->|"monitors telemetry"| node_qgc
node_spoofer_cli -.->|"configures attacks"| node_gps_attacks
node_spoofer_cli -.->|"configures attack"| node_imu_attack
node_spoofer_cli -.->|"configures attack"| node_baro_attack
node_spoofer_cli -.->|"configures attack"| node_lidar_attack
node_spoofer_cli -.->|"configures attack"| node_mag_attack
node_spoofer_cli -.->|"configures attack"| node_stream_attack
node_spoofer_cli -.->|"configures attack"| node_motor_attack
node_px4_gz -->|"runs sensor bridge"| node_gz_bridge
node_gz_bridge -->|"applies axis swap"| node_mag_attack
node_gz_bridge -->|"applies pressure offset"| node_baro_attack
node_gz_bridge -.->|"dispatches GPS attacks"| node_gps_attacks
node_gz_bridge -.->|"dispatches IMU attack"| node_imu_attack
node_gz_bridge -.->|"dispatches LiDAR attack"| node_lidar_attack
node_gz_bridge -->|"calls GPS mitigation"| node_gps_mitigation
node_gz_bridge -.->|"uses mitigation"| node_imu_mitigation
node_gz_bridge -.->|"uses mitigation"| node_baro_mitigation
node_gz_bridge -.->|"uses mitigation"| node_lidar_mitigation
node_gz_bridge -.->|"uses mitigation"| node_mag_mitigation
node_gz_bridge -.->|"checks anomaly"| node_motor_mitigation
node_gz_bridge -->|"publishes mitigated GPS"| node_gps_mitig_sensor
node_px4_gz -.->|"provides actuator outputs"| node_esc_interface
node_esc_interface -->|"uses motor attack"| node_motor_attack
node_esc_interface -.->|"detects motor anomaly"| node_motor_mitigation
node_px4_gz -->|"provides camera frames"| node_camera_system
node_camera_system -->|"applies stream attack"| node_stream_attack
node_camera_system -.->|"checks frame anomalies"| node_stream_mitigation
node_camera_system -->|"streams video"| node_operator
node_gz_bridge -.->|"publishes sensor data"| node_px4_gz

click node_spoofer_cli "https://github.com/beatriz-diniz/uavjamsim/blob/main/spoofer/spoofer.cc"
click node_mitigator_cli "https://github.com/beatriz-diniz/uavjamsim/blob/main/spoofer/attack_mitigator.cc"
click node_gps_attacks "https://github.com/beatriz-diniz/uavjamsim/tree/main/attacks"
click node_imu_attack "https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/ImuAttack.cpp"
click node_baro_attack "https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/BarometerAttack.cpp"
click node_lidar_attack "https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/LidarAttack.cpp"
click node_mag_attack "https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/MagnetometerAttack.cpp"
click node_stream_attack "https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/StreamAttack.cpp"
click node_motor_attack "https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/MotorAttack.cpp"
click node_gz_bridge "https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/gz_bridge/GZBridge.cpp"
click node_esc_interface "https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/gz_bridge/GZMixingInterfaceESC.cpp"
click node_camera_system "https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/gstreamer/GstCameraSystem.cpp"
click node_sim_mavlink "https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/SimulatorMavlink.cpp"
click node_mavlink_receiver "https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/mavlink_receiver.cpp"
click node_gps_mitigation "https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/GpsMitigation.cpp"
click node_imu_mitigation "https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/ImuMitigation.cpp"
click node_baro_mitigation "https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/BarometerMitigation.cpp"
click node_lidar_mitigation "https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/LidarMitigation.cpp"
click node_mag_mitigation "https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/MagnetometerMitigation.cpp"
click node_stream_mitigation "https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/StreamMitigation.cpp"
click node_motor_mitigation "https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/MotorMitigation.cpp"
click node_gps_mitig_sensor "https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/GpsMitigation.cpp"

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_spoofer_cli,node_mitigator_cli toneBlue
class node_gps_attacks,node_imu_attack,node_baro_attack,node_lidar_attack,node_mag_attack,node_stream_attack,node_motor_attack toneAmber
class node_gz_bridge,node_esc_interface,node_camera_system,node_sim_mavlink,node_mavlink_receiver toneMint
class node_gps_mitigation,node_imu_mitigation,node_baro_mitigation,node_lidar_mitigation,node_mag_mitigation,node_stream_mitigation,node_motor_mitigation,node_gps_mitig_sensor toneRose
class node_operator,node_px4_gz,node_qgc toneIndigo
```

## Components

### Command and monitoring

- [Spoofer CLI](https://github.com/beatriz-diniz/uavjamsim/blob/main/spoofer/spoofer.cc): `spoofer/spoofer.cc`
- [Mitigator CLI](https://github.com/beatriz-diniz/uavjamsim/blob/main/spoofer/attack_mitigator.cc): `spoofer/attack_mitigator.cc`

### Attack models

- [GPS attacks](https://github.com/beatriz-diniz/uavjamsim/tree/main/attacks): `attacks`
- [IMU attack](https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/ImuAttack.cpp): `attacks/ImuAttack.cpp`
- [Barometer attack](https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/BarometerAttack.cpp): `attacks/BarometerAttack.cpp`
- [LiDAR attack](https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/LidarAttack.cpp): `attacks/LidarAttack.cpp`
- [Magnetometer attack](https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/MagnetometerAttack.cpp): `attacks/MagnetometerAttack.cpp`
- [Stream attack](https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/StreamAttack.cpp): `attacks/StreamAttack.cpp`
- [Motor attack](https://github.com/beatriz-diniz/uavjamsim/blob/main/attacks/MotorAttack.cpp): `attacks/MotorAttack.cpp`

### Simulation integration

- [Gazebo sensor bridge](https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/gz_bridge/GZBridge.cpp): `px4/gz_bridge/GZBridge.cpp`
- [ESC mixing interface](https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/gz_bridge/GZMixingInterfaceESC.cpp): `px4/gz_bridge/GZMixingInterfaceESC.cpp`
- [Camera stream system](https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/gstreamer/GstCameraSystem.cpp): `px4/gstreamer/GstCameraSystem.cpp`
- [Simulator MAVLink](https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/SimulatorMavlink.cpp): `px4/SimulatorMavlink.cpp`
- [MAVLink receiver](https://github.com/beatriz-diniz/uavjamsim/blob/main/px4/mavlink_receiver.cpp): `px4/mavlink_receiver.cpp`

### Mitigation models

- [GPS mitigation](https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/GpsMitigation.cpp): `mitigations/GpsMitigation.cpp`
- [IMU mitigation](https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/ImuMitigation.cpp): `mitigations/ImuMitigation.cpp`
- [Barometer mitigation](https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/BarometerMitigation.cpp): `mitigations/BarometerMitigation.cpp`
- [LiDAR mitigation](https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/LidarMitigation.cpp): `mitigations/LidarMitigation.cpp`
- [Magnetometer mitigation](https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/MagnetometerMitigation.cpp): `mitigations/MagnetometerMitigation.cpp`
- [Stream mitigation](https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/StreamMitigation.cpp): `mitigations/StreamMitigation.cpp`
- [Motor mitigation](https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/MotorMitigation.cpp): `mitigations/MotorMitigation.cpp`
- [GPS mitigation support](https://github.com/beatriz-diniz/uavjamsim/blob/main/mitigations/GpsMitigation.cpp): `mitigations/GpsMitigation.cpp`

### Other components

- **Operator**
- **PX4 SITL / Gazebo**
- **QGroundControl**

## Connections

- Operator → Spoofer CLI: issues attack commands (evidence: `README.md`)
- Operator → Mitigator CLI: toggles mitigation
- Operator → PX4 SITL / Gazebo: starts simulation (evidence: `README.md`)
- Operator → QGroundControl: monitors telemetry (evidence: `README.md`)
- Spoofer CLI → GPS attacks: configures attacks
- Spoofer CLI → IMU attack: configures attack
- Spoofer CLI → Barometer attack: configures attack
- Spoofer CLI → LiDAR attack: configures attack
- Spoofer CLI → Magnetometer attack: configures attack
- Spoofer CLI → Stream attack: configures attack
- Spoofer CLI → Motor attack: configures attack
- PX4 SITL / Gazebo → Gazebo sensor bridge: runs sensor bridge (evidence: `px4/gz_bridge/GZBridge.cpp`)
- Gazebo sensor bridge → Magnetometer attack: applies axis swap (evidence: `px4/gz_bridge/GZBridge.cpp`)
- Gazebo sensor bridge → Barometer attack: applies pressure offset (evidence: `px4/gz_bridge/GZBridge.cpp`)
- Gazebo sensor bridge → GPS attacks: dispatches GPS attacks
- Gazebo sensor bridge → IMU attack: dispatches IMU attack
- Gazebo sensor bridge → LiDAR attack: dispatches LiDAR attack
- Gazebo sensor bridge → GPS mitigation: calls GPS mitigation
- Gazebo sensor bridge → IMU mitigation: uses mitigation
- Gazebo sensor bridge → Barometer mitigation: uses mitigation
- Gazebo sensor bridge → LiDAR mitigation: uses mitigation
- Gazebo sensor bridge → Magnetometer mitigation: uses mitigation
- Gazebo sensor bridge → Motor mitigation: checks anomaly
- Gazebo sensor bridge → GPS mitigation support: publishes mitigated GPS (evidence: `px4/gz_bridge/GZBridge.cpp`)
- PX4 SITL / Gazebo → ESC mixing interface: provides actuator outputs
- ESC mixing interface → Motor attack: uses motor attack
- ESC mixing interface → Motor mitigation: detects motor anomaly
- PX4 SITL / Gazebo → Camera stream system: provides camera frames (evidence: `px4/gstreamer/GstCameraSystem.cpp`)
- Camera stream system → Stream attack: applies stream attack
- Camera stream system → Stream mitigation: checks frame anomalies
- Camera stream system → Operator: streams video (evidence: `README.md`)
- Gazebo sensor bridge → PX4 SITL / Gazebo: publishes sensor data
