Manage Comm Links
=================

Use **Comm Links** to select an existing asset, review connection details,
create new link entries, and back up the comm-link list.

**Navigation:** Menu > ``Comm Links``

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

- Confirm you are editing the correct asset entry before connecting or
  changing its values.
- Keep aircraft-side changes separate from comm-link management. This page
  configures how GCS-beXStream reaches the asset.

Steps
-----

1. Click the asset card you want to manage so the editor panel loads its saved
   values.

.. figure:: ../_static/images/gcsbexstream/02-comm-links/01-select-link.png
   :alt: Select an existing comm-link
   :align: center

   Step 1: Select an existing comm-link

2. Review the saved **Name**, **IP**, **Port**, and **Stream Source** in the
   editor before making changes.

.. figure:: ../_static/images/gcsbexstream/02-comm-links/02-review-link-details.png
   :alt: Review saved comm-link details
   :align: center

   Step 2: Review saved comm-link details

3. Use the card toggle to connect or disconnect that asset entry. The
   **Active Asset** selector updates when the connection succeeds.

.. figure:: ../_static/images/gcsbexstream/02-comm-links/03-connected-link.png
   :alt: Connected comm-link state
   :align: center

   Step 3: Connected comm-link state

4. Click **Add Asset** to open a blank editor when you need to register a new
   aircraft or simulator entry.

.. figure:: ../_static/images/gcsbexstream/02-comm-links/04-add-asset.png
   :alt: Open the Add Asset workflow
   :align: center

   Step 4: Open the Add Asset workflow

5. Choose the icon and enter the new asset's **Name**, **IP**, **Port**, and
   **Stream Source** values.

.. figure:: ../_static/images/gcsbexstream/02-comm-links/05-fill-asset-fields.png
   :alt: Fill the new asset fields
   :align: center

   Step 5: Fill the new asset fields

6. Use the add/save action in the editor header to store the entry. Use the
   trash action only for saved entries you intentionally want to remove.

.. figure:: ../_static/images/gcsbexstream/02-comm-links/06-save-icons.png
   :alt: Editor action buttons
   :align: center

   Step 6: Editor action buttons

7. Use **Save to File** and **Load from File** to export or restore the
   comm-link list.

.. figure:: ../_static/images/gcsbexstream/02-comm-links/07-file-actions.png
   :alt: File actions in Comm Links
   :align: center

   Step 7: File actions in Comm Links

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

The correct asset entry is available in the comm-link list, the connection
toggle reflects its current state, and saved values remain ready for future
sessions.

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

- If an entry will not connect, confirm the **IP** and **Port** values match
  the remote system.
- If stream video is missing later in **Monitor**, review **Stream Source** in
  this page first.
- If a new entry cannot be saved, check for duplicate names or invalid port
  values.

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

- :doc:`Get Started <get_started>`
- :doc:`Monitor the Active Asset <monitor>`
- :doc:`Configure GCS Settings <gcs_settings>`