Skip to content

Drone settings drawer

The drone settings drawer slides in from the right of the drone-stream tile when you click the settings gear. It’s the configuration surface for the currently-bound drone — nine tabs, each targeting a specific area.

Open the drawer either from the drone-stream tile header or by pressing the gear icon while hovering the video.

The nine tabs

1. Telemetry

A read-only real-time dashboard — the fullest display of every telemetry field the drone publishes:

  • Position — lat / lng / alt / heading.
  • Velocity — x / y / z (body-relative) + horizontal / vertical (world).
  • Battery — %, voltage, current, temperature, cell counts.
  • GPS — satellite count, fix type, RTK status.
  • Wind — speed, direction, warning level.
  • Camera — recording state, lens mode, thermal palette (if IR), exposure lock, white-balance mode.
  • Payload — connected PSDK accessories, firmware versions, battery states (e.g. for spotlights).
  • Obstacle perception — raw distances in each direction.

No controls here — it’s a reference panel. Values update on every telemetry packet (~150 ms).

2. Settings

The main aircraft-configuration tab. Six sub-tabs:

Control

  • Go Home Height — RTH altitude (default 30 m).
  • Height Limit — max AGL the aircraft will climb to (default 120 m).
  • Distance Limit — enabled toggle + max distance from home.
  • Multi-Flight Mode — enable/disable.
  • Coordinated Turn — enable/disable (locks yaw with roll during turns).
  • Failsafe Behavior — GO_HOME / HOVER / LANDING.

Assist

  • RTH Obstacle Avoidance — enable/disable.
  • Landing Protection — enable/disable.

Battery

  • Low Battery Threshold — triggers yellow warning (default 25 %).
  • Serious Low — triggers red critical (default 10 %).
  • Discharge Days — auto-discharge interval (default 3 days).

Gimbal

  • Pitch Range Extension — unlocks extended pitch angles.
  • Gimbal Mode — YAW_FOLLOW, FREE, FPV.
  • Pitch / Yaw Smoothness — damping coefficients.
  • Pitch / Yaw Max Speed % — upper limit for gimbal slew rate.

Image Transmission

  • TX Frequency Band — 2.4 GHz / 5.8 GHz / auto.
  • Video Output Type / Display Mode / Scale Mode — encoder-side video options.
  • Show Flight Params — overlay flight parameters on the downlink.

Storage

  • Recording destination (SD / internal).
  • Photo format (JPEG / RAW / both).
  • Video codec (H.264 / H.265).
  • Resolution + framerate presets.

All fields sync bidirectionally — the form reads the current value from hud.droneSettings; changing it sends the corresponding DroneCommandType.SET_* command. A 3.5-second cooldown prevents spamming commands if you scrub a slider.

3. Perception

Configures the aircraft’s obstacle-avoidance system:

  • Avoidance type — CLOSE (report-only, no action), BRAKE (auto-brake in front of obstacles), BYPASS (DJI APAS — fly around them).
  • Direction toggles — forward / backward / left / right / up / down. Each can be individually enabled/disabled, and for some directions you can pick radar vs vision-only sensing.
  • Vision Positioning — enable/disable visual position-hold (useful indoors where GPS is unreliable).
  • Precision Landing — enable/disable visual-precision landing on the dock or a landing pad.
  • Warning / braking distance sliders — per direction, threshold where warnings fire or the brake triggers.

A live SVG obstacle radar on the tab shows current distances as coloured sectors, matching the HUD’s obstacle readout.

4. Intelligent

DJI Dock 2/3 intelligent flight modes. All UI in this tab is for initiating autonomous flight behaviours, not for configuring sensors.

  • Auto-Sensing — START / STOP buttons control the continuous perception pipeline that powers Smart Track.
  • Tracking Modes:
    • NONE — idle.
    • SPOTLIGHT — gimbal tracks a fixed target while the drone flies free.
    • SMART TRACK — drone + gimbal both track a detected object, keeping it framed.
    • POI — orbit a point at a fixed radius + speed.
    • FLY TO — autonomous flight to a specific coordinate.
  • Running model — M0 / M1 / M2 buttons pick which detection model drives auto-sensing.
  • POI orbit form — lat / lng / alt / speed (m/s) / gimbal-lock toggle.
  • Fly-to form — target waypoint entry.

Commands dispatch via the DJI Cloud command bus; only DJI dock aircraft (not handhelds) see these modes populated.

5. Pilot

A read-only profile card for the operator currently bound to the tile — name, callsign, email, assigned asset colour. No controls.

6. Mission

Shows any waypoint / POI / similar mission currently bound to the drone:

  • Mission mode — NONE / WAYPOINT / POI / etc.
  • Mission state — LOADING / ACTIVE / PAUSED / FINISHED.
  • Pause / Resume / Stop action buttons when a mission is running.

Dispatches PAUSE_WAYPOINT_MISSION, RESUME_WAYPOINT_MISSION, STOP_WAYPOINT_MISSION commands.

7. AI

Controls the AI-detection overlay rendering:

  • Detection count badge — current number of active detections in frame.
  • Confidence threshold slider — 0 to 1.0, default 0.3. Boxes below this threshold are filtered out of the overlay.
  • Box colour mode — AUTO (per-class colours) or SINGLE (one operator- picked colour for all boxes, with a picker).
  • Show Label Chips — toggle the class-label text on each box.
  • Show Scan Animation — toggle the animated scanning-radar effect on the detection area.

Output signals: minConfidenceChange, colorModeChange, singleColorChange, showLabelsToggle, showScanToggle. The drone-stream tile listens and re-renders overlays accordingly.

8. Dock

DJI-dock-specific read-only dashboard — cover state, aircraft-in-dock indicator, storage usage, environmental telemetry (temperature, humidity, rainfall, wind at dock), and any active HMS alerts.

This is a placeholder in the current build — the full dock configuration surface lives in Admin → DJI management.

9. RAW (debug mode only)

Only visible when debug mode is on. Shows the unformatted protobuf / JSON dump of the drone’s latest telemetry packet. Engineering surface — not user-facing.

Persistence

  • Settings tab field values are aircraft-side — they persist on the drone itself, not per-user.
  • Perception + Intelligent fields are aircraft-side too.
  • AI tab overlay preferences are per user, per session — not persisted to the drone.
  • Mission + Dock tabs are state reflections of aircraft-side data; editable fields dispatch commands to mutate that state.

Per-drone scoping

The drawer is always bound to whichever drone the drone-stream tile currently shows. Switching drones in the fleet tile swaps the drawer content.