Configuring your Android Devices

What Needs to Be Configured for My Control System?

Control Hub Configuration

Note

References to the DRIVER STATION smartphone may instead apply to the REV Driver Hub, which is preloaded with the Driver Station (DS) app.

Teams who are using a Control Hub (which has an integrated Android Device) 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 (DS) app onto the DRIVER STATION device. (The DS app is pre-installed on the REV Driver Hub.)

  • Put your phone into Airplane Mode (with the WiFi radio still on).

  • Pair (i.e., wirelessly connect) the DRIVER STATION to the Control Hub.

../../../_images/ControlHubAndPhone.jpg

Important

Eventually the Control Hub will need be renamed so that its name complies with the Competition Manual, 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.

Two Android Smartphone Configuration

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 an 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 device. (The DS app is pre-installed on the REV Driver Hub.)

  • Put your phones into Airplane Mode (with the WiFi radios still on).

  • Pair (i.e., wirelessly connect) the DRIVER STATION to the Robot Controller.

../../../_images/twoAndroidPhones1.jpg

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.

The name of a Robot Controller phone can be changed in the RC app, using instructions found here. It can also be changed at the Manage page from the RC app, a paired DS app, or a connected laptop; click Apply Wi-Fi Settings when done.

The name of a DRIVER STATION device can be changed in the DS app, using instructions found here.

As an alternate, the device names can be changed at the Android system level, as described below.

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.

rename1

  1. Click on Wi-Fi to launch the Wi-Fi screen.

rename2

  1. Touch the three vertical dots to display a pop-up menu.

rename3

  1. Select Advanced from the pop-up menu.

rename4

  1. Select Wi-Fi Direct from the Advanced Wi-Fi screen.

rename5

  1. Touch the three vertical dots to display a pop-up menu.

rename6

  1. Select Configure Device from the pop-up menu.

rename7

  1. 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.

rename8

  1. After renaming phone, power cycle thedevice.

Installing the FIRST Tech Challenge Apps

As of 2021, the SDK apps (v 6.1 and higher) are no longer available on Google Play.

The REV Hardware Client software will allow you to download the apps to devices: REV Control Hub, REV Expansion Hub, REV Driver Hub, and other approved Android devices (see section below, called Updating Apps on Android Phones). Here are some of the benefits:

  • Connect to a REV Control Hub via WiFi.

  • One Click update of all software on connected devices.

  • Pre-download software updates without a connected device.

  • Back up and restore user data from Control Hub.

  • Install and switch between DS and RC applications on Android Devices.

  • Access the Robot Control Console on the Control Hub.

The app releases are also available on the FTCRobotController Github repository. It is possible to “side-load” the apps onto the Robot Controller (RC) and Driver Station (DS) phones. However, this section of the document does not include such instructions; other document pages describe side-loading the RC app and the DS app.

Updating Apps and Firmware on REV Devices (REV Expansion Hub, REV Control Hub, REV Driver Hub)

The REV Hardware Client software is used to install and update apps, firmware and/or operating systems on devices from REV Robotics. Simply connect the device via USB to your PC with the REV Hardware Client installed and running, and the software will detect connected hardware. After detection, the REV Hardware Client can then update the Robot Controller (RC) app on a REV Control Hub, update the Driver Station (DS) app on a REV Driver Hub, or update firmware.

Updating Apps on Android Phones

The REV Hardware Client software is used to install, uninstall, and update apps on Android phones. However, the phones must have Developer Options enabled in order for the phone to be properly recognized and updated by the REV Hardware Client software. The process for enabling Developer Options is as follows:

Step

Image

  1. Go to “Settings”, then tap “About device” or “About phone”.

devop1

  1. Scroll down, then tap Build number seven times. Depending on your device and operating system, you may need to tap Software information, then tap Build number seven times.

devop2a devop2b

  1. Enter your pattern, PIN or password to enable the Developer options menu.

  1. The “Developer options” menu will now appear in your Settings menu. Depending on your device, it may appear under Settings >General > Developer options.

devop4

  1. To disable the Developer options at anytime, tap the switch.

devop5

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 devices 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 document.

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 ofthe 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.

airplane1

  1. 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.

airplane2

Pairing the DRIVER STATION to the Robot Controller

Control Hub Pairing

The REV Robotics Control Hub should come with the Robot Controller app pre-installed. Once you have successfully installed the 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 device 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.

pairing1

  1. 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.

pairing2

  1. 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.

pairing3

  1. Touch the three vertical dots on the upper right hand corner of the main screen of the Driver Station app. This will launch a pop-up menu.

pairing4

  1. Select Settings from the pop-up menu.

pairing5

  1. From the Settings screen, look for and select Pairing Method to launch the Pairing Method screen.

pairing6

  1. Touch the words Control Hub to indicate that this DRIVER STATION will be pairing with a Control Hub.

pairing7

  1. From the Settings screen, look for and select Pair with Robot Controller to launch the Pair with Robot Controller screen.

pairing8

  1. From Pair with Robot Controller screen,look for and press the Wifi Settings button to launch the device’s Android WifiSettings screen.

pairing9

  1. 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.

pairing10

  1. 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.

pairing11

  1. After you successfully connected to the Hub, use the back arrow to navigate to theprevious 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.

pairing12

  1. 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.

pairing13

Two Android Smartphone Pairing

Important

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 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 device 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 device 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.

pairingns1 pairingns1b

  1. Verify that the Robot Controller app is running. The Robot Status field should read running if it is working properly.

pairingns2

  1. 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.

pairingns3 pairingns3b

  1. Touch the three vertical dots on the upper right hand corner of the main screen of the Driver Station app. This will launch a pop-up menu.

pairingns4

  1. Select Settings from the pop-up menu.

pairingns5

  1. From the Settings screen, look for and select Pairing Method to launch the Pairing Method screen.

pairingns6

  1. Verify that the Wifi Direct mode is selected, which means that this DRIVER STATION will be pairing with another Android device.

pairingns7

  1. From the Settings screen, look for and select Pair with Robot Controller to launch the Pair with Robot Controller screen.

pairingns8

  1. 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.

pairingns9

  1. 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.

pairingns10

  1. Verify that the DRIVER STATION screen has changed and that it now indicates that it is connected to the Robot Controller. The name ofthe Robot Controller’s remote network (9999-C-RC in this example) should be displayed in the Network field on the DRIVER STATION.

pairingns11

  1. 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.

pairingns12