Skip to content Link Search Menu Expand Document

VOXL Command Index

Every user-facing voxl-* command that ships on target with the VOXL SDK, grouped by task. All commands support --help. Commands listed here reflect SDK 1.7 on VOXL 2.

Long-running background services (voxl-camera-server, voxl-imu-server, voxl-vision-hub, …) are managed with systemctl rather than run by hand — see voxl-inspect-services for the full service list and Core Services for their documentation. This index covers the commands you type.

Table of contents

  1. System & Device Info
  2. Monitoring & Hardware I/O
  3. Pipe Utilities
  4. Sensors & Telemetry
  5. VIO
  6. Calibration
  7. Configuration
  8. Flight, RC & ESC
  9. Logging & Replay
  10. Connectivity & Video Links
  11. Host PC Tools

System & Device Info

CommandWhat it doesDocs
voxl-versionPrint system image, kernel, SDK version, and hardware SKUvoxl-version
voxl-platformPrint the board part number (e.g. M0054) 
voxl-chipPrint the SoC (e.g. QRB5165) 
voxl-variantPrint the kernel variant currently running 
voxl-serialPrint the device serial number 
voxl-my-ipPrint the current IP address and interfaceWiFi Setup
voxl-wifiConfigure WiFi (station / SoftAP wizard)WiFi Setup
voxl-static-ipAssign a static IP address 
voxl-inspect-skuPrint the parsed hardware SKU fieldsSKU
voxl-inspect-servicesTable of all VOXL services: enabled, running, CPU usagevoxl-inspect-services
voxl-health-checkPrint a health report of the target 
voxl-time-syncSync the system clock (no RTC on VOXL 2) 

Monitoring & Hardware I/O

CommandWhat it doesDocs
voxl-inspect-cpuLive CPU/GPU/memory/temperature monitorvoxl-inspect-cpu
voxl-inspect-thermal-zonesPrint all thermal zone temperatures 
voxl-set-cpu-modeSet CPU governor (perf / auto) 
voxl-ledControl the on-board status LED 
voxl-gpioRead/write GPIO pins from the command line 
voxl-serialPrint device serial number 

Pipe Utilities

MPA pipe plumbing — full reference on the Pipe Utilities page.

CommandWhat it does
voxl-list-pipesList all active MPA pipes, optionally filtered by type
voxl-inspect-pipe-infoPrint a pipe’s info JSON (type, server, size, available commands)
voxl-send-commandSend a control command to a pipe’s server
voxl-kill-pipeAsk a pipe’s server to exit
voxl-record-videoRecord an encoded camera pipe to a file
voxl-record-raw-imageSave raw frames from a camera pipe

Sensors & Telemetry

CommandWhat it doesDocs
voxl-inspect-imuLive IMU data (accel, gyro, temperature)voxl-inspect-imu
voxl-inspect-camCamera pipe stats: resolution, exposure, frame rate, latencyvoxl-inspect-cam
voxl-inspect-cam-asciiRender a camera stream as ASCII art in the terminal 
voxl-inspect-baroLive barometer datavoxl-inspect-baro
voxl-inspect-batteryBattery voltage, charge, current from the autopilotvoxl-inspect-battery
voxl-inspect-gpsGPS fix type, satellite count, positionvoxl-inspect-gps
voxl-inspect-tofTime-of-flight sensor datavoxl-inspect-tof
voxl-inspect-pointsPoint cloud metadata from any pointcloud pipevoxl-inspect-points
voxl-inspect-rangefindersRangefinder distance readingsRangefinders
voxl-inspect-vibrationIMU vibration RMS measurementvoxl-inspect-vibration
voxl-inspect-featuresData on the feature tracker pipe 
voxl-inspect-detectionsObject detections from voxl-tflite-servervoxl-inspect-detections
voxl-inspect-tagsAprilTag detectionsvoxl-inspect-tags
voxl-inspect-extrinsicsPrint the extrinsics configurationvoxl-inspect-extrinsics
voxl-inspect-pose6-DOF pose from any pose pipevoxl-inspect-pose
voxl-inspect-mavlinkRaw MAVLink traffic on the mavlink pipesvoxl-inspect-mavlink
voxl-inspect-gcs-ipShow connected ground station IPsvoxl-mavlink-server

VIO

CommandWhat it doesDocs
voxl-inspect-vioVIO output from any VIO pipe (position, features, quality, state)voxl-inspect-vio
voxl-inspect-vio-camsShow which cameras are configured for VIOvoxl-inspect-vio-cams
voxl-inspect-vinsLive output of voxl-open-vins-serverOpen-VINS server
voxl-reset-vinsSend a soft/hard reset to voxl-open-vins-serverOpen-VINS server
voxl-evaluate-vinsEvaluate open-vins accuracy against a recorded logvoxl-benchmark-vio
voxl-inspect-qvioLive output of voxl-qvio-servervoxl-inspect-qvio
voxl-reset-qvioReset voxl-qvio-servervoxl-inspect-qvio

Calibration

CommandWhat it doesDocs
voxl-calibrate-cameraIntrinsic camera calibrationCalibrate Cameras
voxl-calibrate-imuStatic IMU calibrationCalibrate IMU
voxl-calibrate-imu-tempIMU temperature calibrationCalibrate IMU
voxl-calibrate-px4-horizonLevel-horizon calibration for PX4Calibrate Horizon
voxl-check-calibrationReport which calibration files are present/missingCheck Calibration
voxl-convert-calPrint a calibration file as JSON (cal/yml/csv) 
voxl-focus-cameraFocus assist for manual-focus camera modules 

Configuration

Every SDK service ships a voxl-configure-<service> script; voxl-configure-mpa parses the SKU and calls the right ones automatically during SDK install. The ones you’re most likely to run by hand:

CommandConfiguresDocs
voxl-configure-mpaEverything — full service configuration from the SKUvoxl-configure-mpa
voxl-configure-skuThe hardware SKU in /data/modalai/sku.txtSKU
voxl-configure-camerasCamera server config by camera-config IDConfigure Cameras
voxl-configure-extrinsicsSensor-to-body geometric relationshipsConfigure Extrinsics
voxl-configure-vio-camsWhich cameras feed VIOFlying with VIO
voxl-configure-open-vinsvoxl-open-vins-server camera rigsOpen-VINS server
voxl-configure-qvioEnable/disable voxl-qvio-serverFlying with VIO
voxl-configure-px4voxl-px4 autopilot servicePX4 on VOXL 2
voxl-configure-px4-paramsPX4 parameter set by vehicle SKUPX4 on VOXL 2
voxl-configure-modemCellular / Doodle / Microhard datalinksvoxl-modem
voxl-configure-tflitevoxl-tflite-server model selectionvoxl-tflite-server
voxl-configure-pkg-managerModalAI apt package repositoryConfigure Package Manager
voxl-configure-docker-supportDocker support on targetDocker on VOXL

Flight, RC & ESC

CommandWhat it doesDocs
voxl-px4The PX4 autopilot binary (normally run as a service)PX4 on VOXL 2
voxl-escESC tools: scan, firmware update, spin test, paramsVOXL ESC Manual
voxl-elrsELRS radio management: bind, flash, configure by SKUvoxl-elrs
voxl-2-ioVOXL 2 IO expansion board toolsVOXL 2 IO
voxl-send-esc-pwm-cmdDrive the ESC’s auxiliary PWM outputs through PX4FPV ESC Datasheet
voxl-send-esc-tone-cmdPlay tones on the motors through PX4FPV ESC Datasheet
voxl-send-esc-gpio-cmdToggle ESC GPIO outputs (e.g. VTX power) through PX4FPV ESC Datasheet
voxl-send-neopixel-cmdDrive a Neopixel LED array on the ESC through PX4FPV ESC Datasheet
voxl-enable-px4-logsEnable PX4 ulog logging (requires reboot) 
voxl-reset-slpiReset the sensors DSP without rebooting 

Logging & Replay

CommandWhat it doesDocs
voxl-loggerRecord MPA pipes (IMU, cameras, VIO, …) to /data/voxl-logger/voxl-logger
voxl-replayReplay a recorded log back onto MPA pipesvoxl-replay
voxl-clear-logsDelete recorded logs to free disk spacevoxl-logger
CommandWhat it doesDocs
voxl-modemConfigure and manage cellular / Doodle / Microhard datalinksvoxl-modem
voxl-inspect-modem-5g5G modem signal and statusvoxl-modem
voxl-inspect-modem-doodleDoodle Labs radio link statusvoxl-modem
voxl-streamerRTSP video streaming from any camera pipevoxl-streamer
voxl-vtxModalAI VTX air unit managementVTX Software Guide
voxl-inspect-vtxVTX link statusVTX Software Guide

Host PC Tools

These run on your development machine, not on VOXL:

CommandWhat it doesDocs
voxl-dockerLaunch the voxl-cross build containerDocker & Cross Installation
adb shellShell onto VOXL over USBSetting up ADB