diff --git a/docs/source/programming_resources/index.rst b/docs/source/programming_resources/index.rst index eb184d61..f1a3badd 100644 --- a/docs/source/programming_resources/index.rst +++ b/docs/source/programming_resources/index.rst @@ -47,7 +47,7 @@ Control System Supporting Documentation - :doc:`Connecting a Laptop to a Program & Manage Wi-Fi Network ` - :doc:`Installing a Javascript Enabled Browser ` - :doc:`Managing a Control Hub ` -- :doc:`Managing a Smartphone Driver Station (DS) ` +- :doc:`Managing a Driver Hub ` - :doc:`Managing a Smartphone Robot Controller (RC) ` .. toctree:: diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/Managing-a-Smartphone-Driver-Station.rst b/docs/source/programming_resources/shared/managing_smartphone_ds/Managing-a-Smartphone-Driver-Station.rst index 1a2302a6..19061b10 100644 --- a/docs/source/programming_resources/shared/managing_smartphone_ds/Managing-a-Smartphone-Driver-Station.rst +++ b/docs/source/programming_resources/shared/managing_smartphone_ds/Managing-a-Smartphone-Driver-Station.rst @@ -1,56 +1,84 @@ -Managing a Smartphone Driver Station -==================================== +Managing a Driver Hub +===================== REV Driver Hub ~~~~~~~~~~~~~~ The `REV Driver Hub `__ is preloaded with the Driver Station (DS) app. The procedures -described below for a DS phone, also apply to a REV Driver Hub. +described below for a REV Driver Hub, also apply to a using an Android phone as a DS. Changing the Name ~~~~~~~~~~~~~~~~~ In order to comply with the Competition Manual, the name of the Driver -Station (DS) smartphone should be changed. +Station (DS) should be changed. +Configure devices for your team number. The ROBOT CONTROLLER, DRIVER STATION, and any spares used must be configured/named to correspond to the correct team number as follows: -This can be done in the DS app, as described below. +A. ROBOT CONTROLLER should be named -RC (e.g., 12345-RC), -As an alternate, :ref:`found here ` -show how to rename a smartphone using the Android Settings activity of -the phone. +B. DRIVER STATION should be named -DS (e.g., 12345-DS), and + +C. If a spare ROBOT CONTROLLER or DRIVER STATION is configured, a letter designator may be added --RC/DS (e.g., 12345-A-DS, 12345-B-DS) + +Check the current Competition Manual for the rules related to *Control, Command & Signals System*. + +The Driver Hub name can be changed in the DS app, as described below. + +.. note:: The steps below are mostly the same if you use an Android phone for your driver station. + + If you are using phones for your control system :ref:`this link ` + shows how to rename a smartphone using the Android Settings activity of + the phone. + +.. tip:: Troubleshooting + + If you see a yellow circled exclamation icon on your DS screen and touch it, a message will pop up + temporarily and say "*DS* does not match *DS*, see the FTC Competition Manual". + Note: *DS* is the current name of the Driver Station, and *RC* is the current Robot Controller name. + + This is because the DS and RC names do not match. You should change both names to include your team + number as indicated above, as required by the Competition Manual. + + .. image:: images/ds-mismatch-screen.png + :align: center + :alt: Driver Station screen showing the yellow icon mismatch, and the name mismatch pop up message. Changing the Name of a Driver Station Instructions -------------------------------------------------- -1. On the Driver Station phone, touch the three dots in the upper +1. In the Driver Station app, touch the three dots in the upper right hand corner to display a pop-up menu. -.. image:: images/touchThreeDots.jpg +.. image:: images/touchThreeDots1.png :align: center + :alt: Driver Station main screen showing the 3 dots highlighted with an orange circle. | 2. Select the *Settings* menu item from the pop-up menu. -.. image:: images/selectSettings.jpg +.. image:: images/selectSettings.png :align: center + :alt: Driver Station main pop-up menu showing the Settings option highlighted with an orange circle. | 3. Click on *Driver Station Name* on the *DRIVER STATION SETTINGS* page. -.. image:: images/clickDriverStationName.jpg +.. image:: images/clickDriverStationName.png :align: center + :alt: Driver Station settings screen showing the Driver Station Name highlighted with an orange circle. | 4. Specify the new Driver Station Name and press *OK* to accept the changes. -.. image:: images/specifyNewDriverStationName.jpg +.. image:: images/specifyNewDriverStationName.png :align: center + :alt: Driver Station Name pop-up screen that allows you to enter or change the name. | @@ -59,7 +87,7 @@ Updating the Driver Station App ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ It is important to know how to update the Driver Station app that is -installed on your smartphone. FIRST periodically releases new versions +installed on your device. *FIRST* periodically releases new versions of this app, which contain improvements and fixes, as well as season-specific data and features. @@ -68,8 +96,9 @@ Driver Station user interface. Select the *About* menu option on the Driver Station and note the App Version number under the *ABOUT DRIVER STATION* section. -.. image:: images/aboutDriverStation.jpg +.. image:: images/aboutDriverStation.png :align: center + :alt: Driver Station About screen showing the App Version highlighted with an orange circle. | diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/aboutDriverStation.jpg b/docs/source/programming_resources/shared/managing_smartphone_ds/images/aboutDriverStation.jpg deleted file mode 100644 index af98993b..00000000 Binary files a/docs/source/programming_resources/shared/managing_smartphone_ds/images/aboutDriverStation.jpg and /dev/null differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/aboutDriverStation.png b/docs/source/programming_resources/shared/managing_smartphone_ds/images/aboutDriverStation.png new file mode 100644 index 00000000..8678f9fe Binary files /dev/null and b/docs/source/programming_resources/shared/managing_smartphone_ds/images/aboutDriverStation.png differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/clickDriverStationName.jpg b/docs/source/programming_resources/shared/managing_smartphone_ds/images/clickDriverStationName.jpg deleted file mode 100644 index 1ee7666a..00000000 Binary files a/docs/source/programming_resources/shared/managing_smartphone_ds/images/clickDriverStationName.jpg and /dev/null differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/clickDriverStationName.png b/docs/source/programming_resources/shared/managing_smartphone_ds/images/clickDriverStationName.png new file mode 100644 index 00000000..5318d859 Binary files /dev/null and b/docs/source/programming_resources/shared/managing_smartphone_ds/images/clickDriverStationName.png differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/ds-mismatch-screen.png b/docs/source/programming_resources/shared/managing_smartphone_ds/images/ds-mismatch-screen.png new file mode 100644 index 00000000..9eb6bb61 Binary files /dev/null and b/docs/source/programming_resources/shared/managing_smartphone_ds/images/ds-mismatch-screen.png differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/selectSettings.jpg b/docs/source/programming_resources/shared/managing_smartphone_ds/images/selectSettings.jpg deleted file mode 100644 index 465e62a1..00000000 Binary files a/docs/source/programming_resources/shared/managing_smartphone_ds/images/selectSettings.jpg and /dev/null differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/selectSettings.png b/docs/source/programming_resources/shared/managing_smartphone_ds/images/selectSettings.png new file mode 100644 index 00000000..1c0dc847 Binary files /dev/null and b/docs/source/programming_resources/shared/managing_smartphone_ds/images/selectSettings.png differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/specifyNewDriverStationName.jpg b/docs/source/programming_resources/shared/managing_smartphone_ds/images/specifyNewDriverStationName.jpg deleted file mode 100644 index 54511650..00000000 Binary files a/docs/source/programming_resources/shared/managing_smartphone_ds/images/specifyNewDriverStationName.jpg and /dev/null differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/specifyNewDriverStationName.png b/docs/source/programming_resources/shared/managing_smartphone_ds/images/specifyNewDriverStationName.png new file mode 100644 index 00000000..13bf9f9d Binary files /dev/null and b/docs/source/programming_resources/shared/managing_smartphone_ds/images/specifyNewDriverStationName.png differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/touchThreeDots.jpg b/docs/source/programming_resources/shared/managing_smartphone_ds/images/touchThreeDots.jpg deleted file mode 100644 index d0d4c6ca..00000000 Binary files a/docs/source/programming_resources/shared/managing_smartphone_ds/images/touchThreeDots.jpg and /dev/null differ diff --git a/docs/source/programming_resources/shared/managing_smartphone_ds/images/touchThreeDots1.png b/docs/source/programming_resources/shared/managing_smartphone_ds/images/touchThreeDots1.png new file mode 100644 index 00000000..5e73d755 Binary files /dev/null and b/docs/source/programming_resources/shared/managing_smartphone_ds/images/touchThreeDots1.png differ