Back to Extensions
DriversAltnauticaGPL-3.0-or-laterv0.4.0

ADOS SIYI Optical Pod

Native driver for the SIYI optical-pod line (A2 mini, A8 mini, ZR10, ZR30, ZT6, ZT30) with per-model capability negotiation: gimbal, zoom, focus, photo/record, thermal palette and spot temperature, laser rangefinder with subject geolocation, and on-pod AI tracking.

Overview

Speaks the SIYI Gimbal Camera External SDK over UDP, TCP, or a TTL serial port directly, so the agent drives the features a stock autopilot mount cannot: thermal palettes and temperature, the laser rangefinder, subject geolocation, and AI tracking. On start the plugin queries firmware and the hardware id, resolves the exact model's capability profile, and exposes only the controls that model supports. The pod's own tracker box is republished onto the shared detection bus so cockpit click-to-track and follow behaviours work with no on-board accelerator. The laser range plus the gimbal angles and the flight controller pose resolve a subject latitude and longitude that drops a marker on the map. Gimbal attitude and the laser range are mirrored up to the flight controller as standard MAVLink so the built-in gimbal panel lights up too.

What it does

  • Auto-detects A2 mini / A8 mini / ZR10 / ZR30 / ZT6 / ZT30 and negotiates capabilities
  • Gimbal aim, rate, recenter, and lock/follow/FPV modes
  • Optical and absolute zoom, autofocus (zoom models)
  • Thermal palette, gain, and spot temperature (thermal models)
  • Laser rangefinder with subject geolocation on the map (laser models)
  • On-pod AI tracking republished to the cockpit (no accelerator required)

Skills

Flight behaviors this extension adds to the cockpit Skill Bar, each bindable to a hotkey or gamepad button.

Track
cameraToggle
Record
cameraToggle
Point At
camera
Cycle Palette
camera
Fire Rangefinder
cameraConfirms
Center Gimbal
camera
Nadir
camera
Zoom In
camera
Zoom Out
camera
Photo
camera

Capabilities

The capabilities this extension requests. You approve them at install time; the sandbox denies anything not listed here.

Vehicle · agent

network.outboundhardware.uartmavlink.readmavlink.writemavlink.component.gimbalmavlink.component.cameravision.detection.publishvision.track.designatetelemetry.extendvideo.source.setevent.publishevent.subscribemcp.expose

Ground control · Mission Control

ui.slot.node-detail-tabui.slot.cockpit-panelui.slot.video-overlayui.slot.flight-skillui.slot.settings-sectionui.slot.map-overlayui.slot.notification-channeltelemetry.subscribe.siyicommand.sendrecording.writemission.readmission.write

Hardware requirements

Camera
A SIYI optical pod (A2 mini, A8 mini, ZR10, ZR30, ZT6, or ZT30) on the pod network (192.168.144.x) or a TTL serial port
Companion boards
cm4cm5rk3582rk3588s2rk3576rpi5x86

Resource impact

Forecast footprint on the companion computer. The supervisor enforces the hard limits.

12%
CPU peak
96MB
Memory
5Hz
Output rate
4
Processes
3s
Startup

Telemetry

Live channels this extension publishes to Mission Control.

siyi

What it adds to Mission Control

Node tabs

  • SIYI Pod

Cockpit panels

  • Pod

Video and map overlays

  • SIYI pod HUD
  • Laser target

Notifications

  • SIYI pod health

Click-a-target actions

  • Track with pod

Settings

ZoomGimbal ModePaletteGainLaser

AI tools (MCP)

statusreadagent

Report the pod model, capabilities, attitude, zoom, palette, range, and tracker state.

set_zoomsafe_writeagent

Set the absolute optical/hybrid zoom (zoom models). Clamped to the model's maximum.

set_palettesafe_writeagent

Set the thermal colour palette by code (thermal models).

capture_photosafe_writeagent

Take a still on the pod.

recordsafe_writeagent

Start or stop recording on the pod.

point_atsafe_writeagent

Lock the pod's tracker onto a box (pod-frame pixels), or the frame centre when no box is given. Moves the gimbal.

laser_rangeflightagent

Fire the laser rangefinder and report the slant range in metres (laser models). Fires the laser.

geolocate_targetflightagent

Fire the rangefinder and resolve the pointed subject's latitude and longitude from the gimbal angles and vehicle pose (laser models). Fires the laser.

Install

Open Mission Control, then use the Extensions tab on a compatible node to browse the registry and install this extension. Mission Control installs the signed archive on the node you select; it activates after the signature is confirmed and the requested capabilities are approved.

Supported boards

cm4cm5rk3582rk3588s2rk3576rpi5x86

Version history

v0.4.0

LatestJul 19, 2026

Full skill set with glyphs (gimbal aim, zoom, thermal palette, laser range, photo, record, and subject tracking), each gated to the connected model's real capabilities so unsupported controls render disabled. Photo and record fire their real one-shot paths, and the pod's camera streams bind through the shared multi-stream video roster. Multiple simultaneous streams (zoom EO, wide EO, IR) with picture-in-picture.

Agent min
0.99.179
GCS min
0.56.0

v0.1.0

Jul 18, 2026

Initial release.

Agent min
0.99.168
GCS min
0.56.0
Get Early Access