Troubleshooting¶

Use this appendix when the app opens correctly but the current workflow is blocked by missing data, module state, or a disconnected asset.

Connection Issues¶

Active Asset stays empty after connecting: Check the saved IP and Port in Manage Comm Links. Confirm the aircraft or simulator is sending MAVLink heartbeats.
The comm-link connects, then drops: Wait a few seconds for the first heartbeat. If the drop repeats, verify the remote endpoint and restart the connection.
The wrong aircraft becomes active: Use the top Active Asset selector and confirm only the intended comm-link is connected.

Telemetry values do not update in Monitor: Return to Comm Links and reconnect the asset. Then reopen Monitor the Active Asset.
The stream panel reports an error: Review the asset’s Stream Source in Comm Links and then inspect GCS Settings > Stream for codec or MediaMTX status details.
Expected overlays are missing: Check GCS Settings > General and re-enable the required view toggles.

Mission list is empty: This is expected until a mission is created or imported.
Push or Start does nothing: Confirm an active asset is connected and that the mission contains the required items before using live mission actions.

Pre-Flight, Safety, or Parameters look incomplete: Keep the aircraft connected and wait for parameters to load.
Logs page will not load: Turn on the aircraft hotspot, connect the station to the correct Wi-Fi network, and reload the page.
Flight Records table is empty: Refresh the page and confirm the aircraft has generated records in previous sessions.

A module tab is unavailable: Open Optional Modules and verify that the module is enabled in Overview.
A module page needs credentials or certificates: Collect the correct deployment values before enabling the connection.

Do not use Push, Start, or safety-related edits unless the aircraft is in a safe operational state.
Treat radio management and controller parameter changes as live operational actions, not preview-only actions.