Driver Station Components
=========================

Android Device
--------------

.. grid:: 1 2 2 3
   :gutter: 2

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      REV Driver Hub

      ^^^

      .. figure:: images/REV-31-1596.png
         :align: center
         :alt: REV-31-1596
         :width: 75 %

      +++

      REV Driver Hub (REV-31-1596)

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      Android Smartphone

      ^^^

      .. figure:: images/motoe5.png
         :align: center
         :alt: MotoE5
         :width: 50 %

      +++

      Moto E5

The heart of the Driver Station is the Android Device that runs the
Driver Station App. This Android Device requirement can be fulfilled
either through the use of a 
`REV Driver Hub <https://www.revrobotics.com/rev-31-1596/>`_ 
or one of the approved Android Smartphones listed in
:doc:`Game Manual 1 <../../../manuals/game_manuals/game_manuals>`. It is of
vital importance that the Driver Station App be updated to a version
that meets or exceeds the minimum Driver Station App version as
defined in :doc:`Game Manual 1 <../../../manuals/game_manuals/game_manuals>`.

USB-OTG Adapter / Hubs
----------------------

.. grid:: 1 2 2 3
   :gutter: 2

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      USB OTG Cable

      ^^^

      .. figure:: images/usbotg.png
         :align: center
         :alt: USB OTG Cable
         :width: 50 %

      +++

      USB OTG Adapter Cable

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      USB Hub

      ^^^

      .. figure:: images/usbhub.png
         :align: center
         :alt: USBHub
         :width: 100 %

      +++

      Anker USB Hub

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      USB OTG Hub

      ^^^

      .. figure:: images/REV-31-1592.png
         :align: center
         :alt: REV-31-1592
         :width: 50 %

      +++

      REV UltraUSB (REV-31-1592)

If the Android Device being used is an Android Smartphone, the smartphone only
provides a single USB-Micro-B port on the bottom of the phone. In order to use
USB devices with the Android Smartphone, like a gamepad, a USB-OTG Adapter
Cable must be used. This cable provides a USB Type A port for the Gamepad or peripherals
(like a USB Hub, to allow more than one Gamepad to be used). If available, it
is instead recommended to use a USB Hub with OTG cable built in, like the 
`REV UltraUSB (REV-31-1592) <https://www.revrobotics.com/rev-31-1592/>`_ - 
this reduces the number of connections and failure points in the system.

When using a REV Driver Hub, no OTG adapters are necessary - gamepads may 
connect directly to one of the three USB-A ports on the device. 

Comercial USB Battery Pack
---------------------------

.. grid:: 1 2 2 3
   :gutter: 2

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      USB Battery Pack

      ^^^

      .. figure:: images/ankerbattery.png
         :align: center
         :alt: REV-31-1387
         :width: 50 %

      +++

      Anker Battery Pack

A commercial USB battery pack is an auxiliary power source that can be used in
specific situations in accordance with the
:ref:`Game Manuals<manuals/game_manuals/game_manuals:game manuals>`. A USB 
battery pack is permitted to be used to charge your Android Device. Only the
REV Driver Hub can be charged while in use, through its USB-C port.

Gamepads
--------

.. grid:: 1 2 2 3
   :gutter: 2

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      Logitech F310

      ^^^

      .. figure:: images/f310.png
         :align: center
         :alt: LogitechF310
         :width: 75 %

      +++

      Logitech F310 Gamepad

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      Sony DualSense

      ^^^

      .. figure:: images/dualsense.png
         :align: center
         :alt: Sony DualSense PS5
         :width: 70 %

      +++

      Sony DualSense Gamepad

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      Sony Dualshock 4

      ^^^

      .. figure:: images/dualshock.png
         :align: center
         :alt: DualShock4
         :width: 75 %

      +++

      Sony DualShock 4 Gamepad

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      Etpark PS4 Wired

      ^^^

      .. figure:: images/etpark.png
         :align: center
         :alt: Etpark PS4
         :width: 50 %

      +++

      Etpark PS4 Wired Gamepad

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      Xbox 360

      ^^^

      .. figure:: images/xbox360.png
         :align: center
         :alt: Xbox 360
         :width: 50 %

      +++

      Xbox 360 Gamepad

   .. grid-item-card::
      :class-header: sd-bg-dark font-weight-bold sd-text-white
      :class-body: sd-text-left body

      Quadstick

      ^^^

      .. figure:: images/quadstick.png
         :align: center
         :alt: quadstick
         :width: 75 %

      +++

      Quadstick FPS

:ref:`Game Manual 1 <manuals/game_manuals/game_manuals:game manuals>` defines
the gamepads that are allowed in competition play. Up to two gamepads, in any
combination, of the allowed types of gamepads may be used. All gamepads MUST be
used in wired mode only, no wireless of any kind is allowed. Special features of
some gamepads (Rumble, Lighting) may be programmed and used by teams for
notifications and signaling to the drivers of the robot.