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 :doc:`Manage Comm Links <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.

Monitor and Stream Issues
-------------------------

- **Telemetry values do not update in Monitor**: Return to **Comm Links** and
  reconnect the asset. Then reopen :doc:`Monitor the Active Asset <monitor>`.
- **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 Issues
--------------

- **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.

UAV Settings Issues
-------------------

- **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.

Module Issues
-------------

- **A module tab is unavailable**: Open :doc:`Optional Modules <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.

Safe Operating Reminders
------------------------

- 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.