How voightxyz/mavlink-bridge works
MAVLink Bridge runs an ArduPilot inspection mission: the bridge starts or connects to SITL, the mission executive commands flight over MAVLink, and the agent evaluates telemetry and applies safety rules at each decision. GNSS/EKF integrity handling can switch navigation and trigger return-to-base. Mission events stream to Voight, while a local server exposes live state to the 3D ground-station view. README documents several runtime capabilities whose internal implementation is only partly sampled; those links are cited to the README.
Main entry points: main.ts Mission orchestrator · mav.ts MAVLink transport · vehicle.ts Mission executive · server.ts State and web server
Components 14
Mission control
- Mission orchestrator
src/main.ts - SITL launcher
src/sitl.ts - Site and mission data
src/site.ts
Flight and integrity
- Mission executive
src/vehicle.ts - Agent and safety rules
src/agent.ts - GNSS spoof staging
src/spoof.ts - MAVLink transport
src/mav.ts
Monitoring and trace
- Voight event client
src/voight.ts - State and web server
src/server.ts - 3D ground station
public/app.js
External systems
- ArduPilot SITL
- OpenAI-compatible model
Other components
- Mission operator
- Ground-station user
Connections 19
- Mission operator → Mission orchestrator: starts mission
README.md - Mission orchestrator → SITL launcher: starts SITL
README.md - Mission orchestrator → Mission executive: runs mission
src/main.ts - Mission orchestrator → Agent and safety rules: requests decisions
src/main.ts - Mission orchestrator → GNSS spoof staging: stages fault
README.md - Mission executive → Site and mission data: uses site geometry
src/vehicle.ts - Mission executive → MAVLink transport: sends flight commands
src/vehicle.ts - Agent and safety rules → Mission executive: reads telemetry
src/agent.ts - Agent and safety rules → OpenAI-compatible model: requests tool choice
README.md - Mission orchestrator → MAVLink transport: configures telemetry
src/main.ts - GNSS spoof staging → MAVLink transport: sets simulated GNSS fault
README.md - SITL launcher → ArduPilot SITL: launches
src/sitl.ts - MAVLink transport → ArduPilot SITL: sends MAVLink
README.md - ArduPilot SITL → MAVLink transport: returns telemetry and acknowledgements
README.md - Mission orchestrator → Voight event client: emits mission events
src/main.ts - Mission orchestrator → State and web server: provides state and restart
src/main.ts - State and web server → 3D ground station: serves dashboard assets
src/server.ts - Ground-station user → State and web server: opens ground station
README.md - State and web server → 3D ground station: streams vehicle state
README.md