How beatriz-diniz/uavjamsim works
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: GZBridge.cpp Gazebo sensor bridge · spoofer.cc Spoofer CLI · GstCameraSystem.cpp Camera stream system · GZMixingInterfaceESC.cpp ESC mixing interface
Components 25
Command and monitoring
- Spoofer CLI
spoofer/spoofer.cc - Mitigator CLI
spoofer/attack_mitigator.cc
Attack models
- GPS attacks
attacks - IMU attack
attacks/ImuAttack.cpp - Barometer attack
attacks/BarometerAttack.cpp - LiDAR attack
attacks/LidarAttack.cpp - Magnetometer attack
attacks/MagnetometerAttack.cpp - Stream attack
attacks/StreamAttack.cpp - Motor attack
attacks/MotorAttack.cpp
Simulation integration
- Gazebo sensor bridge
px4/gz_bridge/GZBridge.cpp - ESC mixing interface
px4/gz_bridge/GZMixingInterfaceESC.cpp - Camera stream system
px4/gstreamer/GstCameraSystem.cpp - Simulator MAVLink
px4/SimulatorMavlink.cpp - MAVLink receiver
px4/mavlink_receiver.cpp
Mitigation models
- GPS mitigation
mitigations/GpsMitigation.cpp - IMU mitigation
mitigations/ImuMitigation.cpp - Barometer mitigation
mitigations/BarometerMitigation.cpp - LiDAR mitigation
mitigations/LidarMitigation.cpp - Magnetometer mitigation
mitigations/MagnetometerMitigation.cpp - Stream mitigation
mitigations/StreamMitigation.cpp - Motor mitigation
mitigations/MotorMitigation.cpp - GPS mitigation support
mitigations/GpsMitigation.cpp
Other components
- Operator
- PX4 SITL / Gazebo
- QGroundControl
Connections 32
- Operator → Spoofer CLI: issues attack commands
README.md - Operator → Mitigator CLI: toggles mitigation
- Operator → PX4 SITL / Gazebo: starts simulation
README.md - Operator → QGroundControl: monitors telemetry
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
px4/gz_bridge/GZBridge.cpp - Gazebo sensor bridge → Magnetometer attack: applies axis swap
px4/gz_bridge/GZBridge.cpp - Gazebo sensor bridge → Barometer attack: applies pressure offset
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
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
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
README.md - Gazebo sensor bridge → PX4 SITL / Gazebo: publishes sensor data