Configuring Your Android Devices - ftctechnh/FtcRobotController GitHub Wiki

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.

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.

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.

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.

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.

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.

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.