Stinger Vision FPV Software Guide
Table of contents
- VOXL SDK Support
- What Runs on Stinger
- RC (ELRS)
- Flight Modes
- Video, OSD, and Encryption
- AI Detection
- ADB Access
- Reconfiguring
VOXL SDK Support
Stinger runs the standard VOXL SDK on its VOXL 2 Mini — supported in SDK 1.4.5+. Flash the most recent release flight-tested on Stinger per the Which SDK Should I Flash? table, using the flash instructions.
What Runs on Stinger
Which services boot is decided per-SKU by voxl-configure-mpa. On Stinger the flight stack looks like this:
| Service | Role on Stinger |
|---|---|
| voxl-camera-server | Publishes the tracking cameras, hires EO camera, and thermal sensor |
| voxl-imu-server | IMU samples for state estimation |
| voxl-open-vins-server | Visual-inertial odometry (FPV profile, front + down tracking cameras) — powers Position mode |
| voxl-state-estimator | Backup state estimation from IMU + optical flow — powers Thermal Flow mode in low light |
| voxl-lepton-tracker | Thermal optical flow from the FLIR Lepton |
| voxl-vision-hub | VFC assisted-flight modes (Altitude, Position, Thermal Flow), Backtrack, and position backup |
| voxl-mavlink-server | Telemetry routing between PX4, onboard services, and the ground |
| voxl-px4 | PX4 flight controller (FPV build) with Stinger parameters |
| voxl-vtx | Digital video transmission — see the VTX Air Unit Software Guide |
| voxl-osd | On-screen display composited into the FPV video |
| voxl-portal | Browser UI for inspection and configuration |
voxl-streamer and voxl-mavcam-manager are intentionally disabled — video leaves through the VTX, not RTSP.
RC (ELRS)
The onboard ELRS receiver speaks CRSF directly to PX4 — RC does not pass through an intermediate service. Binding is done with the physical bind button (Stinger Binding Details); receiver flashing and configuration uses voxl-elrs.
Flight Modes
The Zorro Blue switch positions map to VFC assisted-flight modes provided by voxl-vision-hub (configured in /etc/modalai/vfc.conf):
- Altitude — most responsive; altitude hold only.
- Position — VIO position hold from voxl-open-vins-server; best in well-lit areas. Watch the VIO indicator in the OSD.
- Thermal Flow — position hold backed by thermal optical flow from the Lepton; for dark environments.
- Backtrack — retraces recent motion, e.g. to recover a lost video link (flip the recovery switch in flight).
See the Quick Start Guide for the stick-and-switch walkthrough.
Video, OSD, and Encryption
The integrated VTX is the same software as the stand-alone VTX Air Unit — frequencies, video profiles, TX power, encryption keys, and the OSD are all covered in the VTX Air Unit Software Guide. Highlights:
- Change channel, video profile, or PIT mode from the OSD menu (sticks: yaw up + throttle down + roll down + pitch down while disarmed).
- Config files on target:
/etc/modalai/voxl-vtx.confand/etc/modalai/voxl-osd.conf. - New encryption keys are installed by inserting a provisioned USB drive into the utility port and power cycling.
AI Detection
Stinger supports the VTX/VRX AI overlay — deep-learning object detection via voxl-tflite-server (display-only), or single-target tracking via voxl-nano-tracker (note the flight-control warnings in the guide). See the AI Detection Setup Guide.
ADB Access
Connect USB-C at the utility port for standard adb shell access to the VOXL 2 Mini. From there all the usual SDK tooling applies — voxl-inspect-services, voxl-portal over WiFi, and the Command Index.
Reconfiguring
The vehicle’s SKU determines its factory configuration:
voxl-inspect-sku # show this vehicle's SKU breakdown
voxl-configure-mpa # re-apply the factory service configuration
voxl-configure-mparesets service configuration files to the factory state for the SKU — back up any custom tuning first.