Configuring Your Android Devices - FIRST-Tech-Challenge/SkyStone GitHub Wiki

What Needs to Be Configured for My Control System?

Control Hub Users

Teams who are using a Control Hub with the integrated Robot Controller will only need to configure a single smartphone for use as a Driver Station. The process is as follows:

  • Rename the smartphone to "<TEAM NUMBER>-DS" (where <TEAM NUMBER> is replaced by your team number).
  • Install the Driver Station app onto the Driver Station phone.
  • Put your phone into Airplane Mode (with the WiFi radio still on).
  • Pair (i.e., wirelessly connect) the Driver Station to the Control Hub.

IMPORTANT NOTE: Eventually the Control Hub will need be renamed so that its name complies with Game Manual rule <RS01>, but for now we will use the Control Hub with its default name. You can learn how to manage a Control Hub (and modify its name, password, etc.) in this tutorial.

Users with Two Android Smartphones

Teams who have two smartphones and are not using a Control Hub will need to configure one smartphone for use as a Robot Controller and a second smartphone for use as a Driver Station. The process is as follows,

  • Rename one smartphone to "<TEAM NUMBER>-RC" (replace <TEAM NUMBER> with your team number).
  • Install the Robot Controller app onto the Robot Controller phone.
  • Rename a second smartphone to "<TEAM NUMBER>-DS" (where <TEAM NUMBER> is replaced by your team number).
  • Install the Driver Station app onto the Driver Station phone.
  • Put your phones into Airplane Mode (with the WiFi radios still on).
  • Pair (i.e., wirelessly connect) the Driver Station to the Robot Controller.

Renaming Your Smartphones

The official rules of the FIRST Tech Challenge (see <RS01>) require that you change the Wi-Fi name of your smartphones to include your team number and “-RC” if the phone is a Robot Controller or “-DS” if it is a Driver Station. A team can insert an additional dash and a letter (“A”, “B”, “C”, etc.) if the team has more than one set of Android phones.

If, for example, a team has a team number of 9999 and the team has multiple sets of phones, the team might decide to name one phone “9999-C-RC” for the Robot Controller and the other phone “9999-C-DS” for the Driver Station. The “-C” indicates that these devices belong to the third set of phones for this team.

NOTE: it will take an estimated 5 minutes per phone to complete this task.

Step Image
1. Browse the list of available apps on the smartphone and locate
the Settings icon. Click on Settings icon to display the Settings screen.
2. Click on Wi-Fi to launch the Wi-Fi screen.
3. Touch the three vertical dots to display a pop-up menu.
4. Select Advanced from the pop-up menu.
5. Select Wi-Fi Direct from the Advanced Wi-Fi screen.
6. Touch the three vertical dots to display a pop-up menu.
7. Select Configure Device from the pop-up menu.
8. Use touch pad to enter new name of device.
If the device will be a Robot Controller, specify
your team number and "-RC". If the device will be
a Driver Station, specify your team number and "-DS".

You can also set the Wi-Fi Direct inactivity
timeout to "Never disconnect" and then hit the
SAVE button to save your changes.

Note that in the screenshot shown to the right,
the team number is “9999”. The “-C” indicates
that this is from the third pair of smartphones for
this team. The “-RC” indicates that this phone
will be a Robot Controller.
9. After renaming phone, power cycle the device.

Installing the FTC Apps

The FTC apps are available to download for free from the Google Play store. You will need to have your Android phones connected to a Wi-Fi network that has Internet access before you can access the Google Play store. You will also need a Google account to be able to download the apps from the Google Play store.

It is also possible to "side-load" the FTC Android Apps onto the Robot Controller and Driver Station phones. The GitHub repository contains the release versions of the Android apps:

      https://github.com/ftctechnh/ftc_app/tree/master/doc/apk

However, this section of the wiki does not include instructions on how to side-load the apps. It only explains how to use Google Play to install the FTC apps.

NOTE: it will take an estimated 7.5 minutes per phone to complete this task.

Step Image
1. From the Android Wi-Fi screen look for the name of
your wireless network (“CE_NET” in this example) and
touch the wireless network name to log into the network.
2. Specify the password using the touch keypad and hit
CONNECT to connect to this wireless network.
3. Find the Google Play Store icon on your phone and
click it to launch the Google Play Store app.
4. If you haven’t signed into your Google account yet,
follow the onscreen instructions to log into your
Google account.

If you don’t have a Google account, follow the
onscreen instructions to create a new account.
5. In the search window of the Google Play app,
type in the words “FTC Robot Controller” to find the
Robot Controller or “FTC Driver Station” to find the
Driver Station.
6. Tap on the app in the Google Play listing to bring
up the installation screen. Follow the onscreen
instructions to install the appropriate app for your phone.

Important note: When you install the FTC apps, only install
one FTC app
(FTC Robot Controller or FTC Driver Station) per
phone.


You should avoid installing both apps onto the same phone.
Doing so can cause Wi-Fi connection problems. You should
only install the FTC Robot Controller app onto the phone
that will be the Robot Controller and the FTC Driver Station
app onto the phone that will be the Driver Station.
7. After you have successfully installed the app, you should
forget the external wireless network on your phone.

Go to the Android Wi-Fi screen, find the name of the
currently connected network, and tap on the network name
to bring up a pop-up box with info about the network.
8. Click on the FORGET button to forget the wireless network.

Placing Phones into Airplane Mode with Wi-Fi On

For the FIRST Tech Challenge competitions, it is important that you place your Robot Controller and Driver Station phones into Airplane mode but keep their Wi-Fi radios turned on. This is important because you do not want any of the cellular telephone functions to be enabled during a match. The cellular telephone functions could disrupt the function of the robot during a match.

NOTE: it will take an estimated 2.5 minutes per phone to complete this task. Also note that the screens displayed on your Android devices might differ slightly from the images contained in this wiki.

Step Image
1. On the main Android screen of each smartphone, use
your finger to slide from the top of the screen down
towards the bottom of the screen to display the quick
configuration screen.

Note that for some smartphones you might have to swipe
down more than once to display the quick configuration
screen, particularly if there are messages or notifications
displayed at the top of your screen.

Look for the Airplane mode icon (which is shaped like an
airplane) and if the icon is not activated, touch the icon
to put the phone into airplane mode.
2. Placing the phone into airplane mode will turn off
the Wi-Fi radio. If the Wi-Fi icon has a diagonal line
through it (see Step 1 above), then the Wi-Fi radio is
disabled. You will need to touch the Wi-Fi icon on the
quick configuration screen to turn the Wi-Fi radio back
on.

Pairing the Driver Station to the Robot Controller

Control Hub Users

The REV Robotics Control Hub should come with the Robot Controller app pre-installed. Once you have successfully installed the FTC Driver Station on an Android phone, you will want to establish a secure wireless connection between the Control Hub and the Driver Station. This connection will allow your Driver Station phone to select op modes on your Robot Controller and send gamepad input to these programs. Likewise, it will allow your op modes running on your Robot Controller to send telemetry data to your Driver Station phone where it can be displayed for your drivers. The process to connect the two devices is known as “pairing.”

NOTE: the Control Hub does not have its own internal battery. Before you can connect a Driver Station to the Control Hub, you must connect the Control Hub to a 12V battery.

Also note that it will take an estimated 10 minutes to complete this task.

Step Image
1. Connect an approved 12V battery to the power
switch (REV-31-1387) and make sure the switch
is in the off position. Connect the switch to an XT30
port on the Control Hub and turn the switch on.

The LED should initially be blue on the Control Hub.
2. It takes approximately 18 seconds for the
Control Hub to power on. The Control Hub is
ready to pair with the Driver Station when
the LED turns green.

Note: the light blinks blue every ~5 seconds
to indicate that the Control Hub is healthy.
3. On the Driver Station device, browse the
available apps and locate the FTC Driver Station
icon. Tap on the icon to launch the Driver Station
app.

Note that the first time you launch the app
your Android device might prompt you for
permissions that the app will need to run properly.
Whenever prompted, press Allow to grant
the requested permission.
4. Touch the three vertical dots on the upper right
hand corner of the main screen of the FTC Driver
Station app. This will launch a pop-up menu.
5. Select Settings from the pop-up menu.
6. From the Settings screen, look for and select
Pairing Method to launch the Pairing
Method screen.
7. Touch the words Control Hub to indicate
that this Driver Station will be pairing with
a Control Hub.
8. From the Settings screen, look for and select
Pair with Robot Controller to launch the Pair
with Robot Controller screen.
9. From Pair with Robot Controller screen,
look for and press the Wifi Settings button to
launch the device's Android Wifi Settings screen.
10. Find the name of your Control Hub's wireless
network from the list of available WiFi networks.
Click on the network name to select the network.

If this is the first time you are connecting
to the Control Hub, then the default network
name should begin with the prefix "FTC-"
("FTC-1Ybr" in this example).

The default network name should be listed on a sticker
attached to the bottom side of the Control Hub.
11. When prompted, specify the password
for the Control Hub's WiFi network and press
Connect to connect to the Hub. Note that the
default password for the Control Hub network
is "password".

Also note that when you connect to the
Control Hub's WiFi network successfully, the
Driver Station will not have access to
the Internet.
12. After you successfully connected to
the Hub, use the back arrow to navigate to
the previous screen. You should see the
name of the WiFi network listed under "Current
Robot Controller:". Use the back-arrow
key to return to the Settings screen.
Then press the back-arrow key one more time
to return to the main Driver Station screen.
13. Verify that the Driver Station screen has
changed and that it now indicates that it is connected
to the Control Hub.

The name of the Control Hub's WiFi network
(“FTC-1Ybr” in this example) should be displayed in the
Network field on the Driver Station.

Users with Two Android Smartphones

Important Note: If your Driver Station was previously paired to a Control Hub, and you currently would like to connect to an Android smartphone Robot Controller, then before attempting to pair to the Robot Controller, you should forget the Wi-Fi network for the previous Control Hub (using the Android Wifi Settings screen on the Driver Station) and then power cycle the Driver Station phone. If the previous Control Hub is powered on and if you haven't forgotten this network, then the Driver Station might try and connect to the Control Hub and might be unable to connect to the Robot Controller smartphone.

Once you have successfully installed the FTC apps onto your Android phones, you will want to establish a secure wireless connection between the two devices. This connection will allow your Driver Station phone to select op modes on your Robot Controller phone and send gamepad input to these programs. Likewise, it will allow your op modes running on your Robot Controller phone to send telemetry data to your Driver Station phone where it can be displayed for your drivers. The process to connect the two phones is known as “pairing.”

Note that it will take an estimated 10 minutes to complete this task.

Step Image
1. On the Robot Controller device, browse the
available apps and locate the FTC Robot Controller
icon. Tap on the icon to launch the Robot Controller
app.

Note that the first time you launch the app
your Android device might prompt you for
permissions that the app will need to run properly.
Whenever prompted, press Allow to grant
the requested permission.
2. Verify that the Robot Controller app is running.
The Robot Status field should read “running” if it
is working properly.
3. On the Driver Station device, browse the
available apps and locate the FTC Driver Station
icon. Tap on the icon to launch the Driver Station
app.

Note that the first time you launch the app
your Android device might prompt you for
permissions that the app will need to run properly.
Whenever prompted, press Allow to grant
the requested permission.

4. Touch the three vertical dots on the upper right
hand corner of the main screen of the FTC Driver Station
app. This will launch a pop-up menu.
5. Select Settings from the pop-up menu.
6. From the Settings screen, look for and select
Pairing Method to launch the Pairing
Method screen.
7. Verify that the Wifi Direct mode is selected, which means
that this Driver Station will be pairing with
another Android device.

8. From the Settings screen, look for and select
Pair with Robot Controller to launch the Pair
with Robot Controller screen.
9. Find the name of your Robot Controller from the
list and select it.

After you have made your selection, use the back-arrow key to return to the Settings
screen.

Then press the back-arrow key one more time to return to the main Driver Station screen.
10. When the Driver Station returns to its main
screen, the first time you attempt to connect to the
Robot Controller a prompt should appear on the Robot Controller screen.

Click on the ACCEPT button to accept the connection
request from the Driver Station.
11. Verify that the Driver Station screen has
changed and that it now indicates that it is connected to the Robot Controller.

The name of the Robot Controller’s remote network
(“9999-C-RC” in this example) should be displayed in the
Network field on the Driver Station.
12. Verify that the Robot Controller screen has
changed and that it now indicates that it is connected to the Driver Station.

The Network status should read “active, connected” on the Robot Controller’s main screen.
⚠️ **GitHub.com Fallback** ⚠️