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.
Related
- HUD overlay — the always-visible telemetry overlay.
- Telemetry tile — the list-view equivalent.
- DRC controls — the actual flight control bindings.