Connecting Tuner
================

Installed onto the robot controller (either manually or via a robot program) is the Phoenix Diagnostics Server. This program enables communication between Tuner X and the robot controller for managing and setting up devices.

Connecting to the Server
------------------------

A dropdown/textbox is available in the upper-left flyout menu.

.. image:: images/highlighting-ip-area.png
   :width: 70%
   :alt: Highlights the IP textbox in the left-hand flyout menu

By clicking the arrow, you can change between presets such as:

- :guilabel:`Driver Station` -- Retrieves the robot IP from the FRC Driver Station if launched
- :guilabel:`roboRIO USB` -- Defaults to ``172.22.11.2`` which is the roboRIO IP when connected via USB
- :guilabel:`localhost` -- Use for simulation or hardware-attached CANivore.

Alternatively, the user can manually enter the robot IP into the textbox.

Configuring SSH Credentials (non-FRC)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

When using a non-FRC robot controller (non-roboRIO) with SSH (instead of the default POST), credentials must be configured in :guilabel:`Settings` for general use.

.. image:: images/highlighting-ssh-creds.png
   :width: 70%
   :alt: SSH credential username and password is the 3rd and 4th textbox available to the user in settings

Temporary Diagnostics (FRC)
---------------------------

Devices can be configured without a diagnostic server present. This can be useful if the roboRIO has been freshly imaged. Ensure that you are pointed at the roboRIO IP address (usually ``10.TE.AM.2`` where ``TE.AM`` is the team number) and then click the :guilabel:`Run Temporary Diagnostic Server`.

.. image:: images/tuner-run-temporary.png
   :width: 70%
   :alt: Temporary diagnostic server card present

Changing Diagnostics Server Port (non-FRC)
------------------------------------------

The target server port can be changed in the Tuner X :guilabel:`Settings` page, which is accessed from the flyout menu.

.. important:: The default port for diagnostic server is 1250. FRC users should not change this.

.. image:: images/highlighting-port-field.png
   :width: 70%
   :alt: Port textbox is the second textbox available to the user.