How sarreola07/venator works
Venator is an off-grid drone command-and-control system. Its principal workflow is a laptop operator using the ground client to send mission and waypoint commands over LoRa; the Jetson C2 server validates commands, runs flight behavior through the Pixhawk, and returns status and results over the link. The repository also includes interactive bench missions, camera telemetry, preflight checks, link authentication, and a separate phone-to-phone relay. Edges reflect README statements and shown source references; unsampled subsystems are represented without speculative internal connections.
Main entry points: serial_link.py LoRa serial link · c2_server.py C2 server · missions.py Bench missions · gcs_client.py Ground client
Components 17
Ground operation
- Ground client
ground/gcs_client.py
Aircraft control
- C2 server
drone/c2_server.py - Bench missions
drone/missions.py
Radio link
- C2 protocol
radio/protocol.py - LoRa serial link
radio/serial_link.py - Message authentication
radio/auth.py - Phone relay
radio/phone_relay.py
Camera and checks
- Camera publisher
drone/camera_publisher.py - Pixhawk check
drone/checks/check_pixhawk.py - RC check
drone/checks/check_rc.py - Preflight audit
drone/checks/preflight_audit.py
Other components
- Laptop operator
- Pixhawk flight controller
- LoRa radios
- Phone user
- OAK-D camera
- Laptop browser
Connections 20
- Laptop operator → Ground client: operates
README.md - Ground client → C2 protocol: encodes commands
ground/gcs_client.py - Ground client → LoRa serial link: sends messages
ground/gcs_client.py - LoRa serial link → C2 protocol: encodes lines
radio/serial_link.py - LoRa serial link → Message authentication: signs messages
radio/serial_link.py - LoRa radios → LoRa serial link: carries packets
- C2 server → LoRa serial link: receives commands
drone/c2_server.py - C2 server → C2 protocol: dispatches messages
drone/c2_server.py - C2 server → Bench missions: runs missions
drone/c2_server.py - Bench missions → Pixhawk flight controller: controls flight
README.md - C2 server → Pixhawk flight controller: reads telemetry
drone/c2_server.py - OAK-D camera → Camera publisher: provides images
README.md - Camera publisher → Bench missions: streams coordinates
README.md - Camera publisher → Laptop browser: serves video
README.md - Bench missions → Pixhawk flight controller: checks flight state
drone/missions.py - Phone user → Phone relay: sends text
radio/phone_relay.py - Phone relay → LoRa serial link: uses radio link
- Pixhawk check → Pixhawk flight controller: checks controller
- RC check → Pixhawk flight controller: reads RC state
drone/checks/check_rc.py - Preflight audit → Pixhawk flight controller: audits readiness