Configure GCS Settings
======================

Use **GCS Settings** to change operator-station behavior, view layout, stream
handling, joystick configuration, and map preferences.

**Navigation:** Menu > ``GCS Settings``

Before You Start
----------------

- These settings affect the ground station, not the aircraft controller.
- Some sections, such as **Stream**, are more useful when an active asset is
  connected.
- Joystick sections depend on a detected input device.

Steps
-----

1. Open **General** to manage measurement units, **Mavlink System ID**, and
   monitor view toggles such as **Primary Flight Display**, **Video Stream**,
   and **Flight Path**.

.. figure:: ../_static/images/gcsbexstream/05-gcs-settings/01-general.png
   :alt: General settings
   :align: center

   Step 1: General settings

2. Open **Radio** to set **Radio IP**, **Station IP**, and the connection
   toggles for the radio management webview.

.. figure:: ../_static/images/gcsbexstream/05-gcs-settings/02-radio.png
   :alt: Radio settings
   :align: center

   Step 2: Radio settings

3. Open **Stream** to review the active drone stream endpoint, MediaMTX
   status, codec details, and hardware acceleration controls.

.. figure:: ../_static/images/gcsbexstream/05-gcs-settings/03-stream.png
   :alt: Stream settings
   :align: center

   Step 3: Stream settings

4. Open **UAV Joystick** to choose the active joystick, inspect live inputs,
   manage bindings, and review calibration tools.

.. figure:: ../_static/images/gcsbexstream/05-gcs-settings/04-uav-joystick.png
   :alt: UAV joystick settings
   :align: center

   Step 4: UAV joystick settings

5. Open **Camera Joystick** to map camera pan/tilt axes and camera-related
   button actions.

.. figure:: ../_static/images/gcsbexstream/05-gcs-settings/05-camera-joystick.png
   :alt: Camera joystick settings
   :align: center

   Step 5: Camera joystick settings

6. Open **Map** to switch between **Offline Map** and **Nautical Charts**
   configuration tabs.

.. figure:: ../_static/images/gcsbexstream/05-gcs-settings/06-map.png
   :alt: Map settings
   :align: center

   Step 6: Map settings

.. caution::

   The **Radio** section warns that radio API access should only be used when
   all UAVs are landed and disarmed.

Expected Result
---------------

The GCS-side configuration pages are available, and each section exposes the
controls needed for station-wide preferences and operator workflows.

Troubleshooting
---------------

- If joystick pages show **Not Detected**, reconnect the joystick and reopen
  the section.
- If the stream page reports missing source data, review the asset entry in
  **Comm Links** and reconnect the asset.
- If a view element is missing in **Monitor**, confirm its toggle is enabled
  in **General**.

Related Tasks
-------------

- :doc:`Monitor the Active Asset <monitor>`
- :doc:`Manage Comm Links <comm_links>`
- :doc:`Review UAV Settings <uav_settings>`