SCDS/FtcRobotControllerSDK
7
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updated Configuring Your Android Devices (markdown)

emcclurg
2019-04-30 17:06:30 -04:00
parent 35b7e68303
commit 88d6661f3c
1 changed files with 16 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
Configuring-Your-Android-Devices.md

@ -1,7 +1,7 @@
### What Needs to Be Configured for My Control System? ### What Needs to Be Configured for My Control System?
#### Control Hub Users #### 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, 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). * 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. * Install the Driver Station app onto the Driver Station phone.
* Put your phone into Airplane Mode (with the WiFi radio still on). * Put your phone into Airplane Mode (with the WiFi radio still on).
@ -9,10 +9,11 @@ Teams who are using a Control Hub with the integrated Robot Controller will only
<p align="center"><img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/ControlHubAndPhone.jpg" alt="Control Hub and Android Phone" width="200"><p> <p align="center"><img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/ControlHubAndPhone.jpg" alt="Control Hub and Android Phone" width="200"><p>
Important Note: Eventually the Control Hub will need be renamed so that its name complies with rule \<RS01\>. However, for now, we will IMPORTANT NOTE: Eventually the Control Hub will need be renamed so that its name complies with Game Manual rule
\<RS01\>.
#### Users with Two Android Smartphones #### 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, 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" (where \<TEAM NUMBER\> is replaced by your team number). * Rename one smartphone to "\<TEAM NUMBER\>-RC" (replace \<TEAM NUMBER\> with your team number).
* Install the Robot Controller app onto the Robot Controller phone. * 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). * 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. * Install the Driver Station app onto the Driver Station phone.
@ -26,7 +27,7 @@ The official rules of the FIRST Tech Challenge (see \<RS01\>) require that you c
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. 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 that it will take an estimated 5 minutes per phone to complete this task. NOTE: it will take an estimated 5 minutes per phone to complete this task.
| Step| Image | | Step| Image |
| ----------- | :---: | | ----------- | :---: |
@ -49,15 +50,15 @@ It is also possible to "side-load" the FTC Android Apps onto the Robot Controlle
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. 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 that it will take an estimated 7.5 minutes per phone to complete this task. NOTE: it will take an estimated 7.5 minutes per phone to complete this task.
| Step| Image | | Step| Image |
| ----------- | :---: | | ----------- | :---: |
| 1. From the Android Wi-Fi screen look for the name of <br/>your wireless network (“CE_NET” in this example) and <br/>touch the wireless network name to login to the network. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep1.jpg" width="175"> | | 1. From the Android Wi-Fi screen look for the name of <br/>your wireless network (“CE_NET” in this example) and <br/>touch the wireless network name to log into the network. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep1.jpg" width="175"> |
| 2. Specify the password using the touch keypad and hit <br/>**CONNECT** to connect to this wireless network. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep2.jpg" width="175"> | | 2. Specify the password using the touch keypad and hit <br/>**CONNECT** to connect to this wireless network. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep2.jpg" width="175"> |
| 3. Find the Google Play Store icon on your phone and <br/>click it to launch the Google Play Store app. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep3.jpg" width="175"> | | 3. Find the Google Play Store icon on your phone and <br/>click it to launch the Google Play Store app. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep3.jpg" width="175"> |
| 4. If you haven’t signed into your Google account yet, <br/>follow the onscreen instructions to log into your <br/>Google account. <br/><br/>If you don’t have a Google account, follow the onscreen <br/>instructions create a new account. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep4.jpg" width="175"> | | 4. If you haven’t signed into your Google account yet, <br/>follow the onscreen instructions to log into your <br/>Google account. <br/><br/>If you don’t have a Google account, follow the <br/>onscreen instructions to create a new account. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep4.jpg" width="175"> |
| 5. In the search window of the Google Play app, <br/>type in the words “FTC Robot Controller” to find the <br/>Robot Controller or “FTC Driver Station” to find the <br/>appropriate FTC app for your phone. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep5.jpg" width="175"> | | 5. In the search window of the Google Play app, <br/>type in the words “FTC Robot Controller” to find the <br/>Robot Controller or “FTC Driver Station” to find the <br/>Driver Station. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep5.jpg" width="175"> |
| 6. Tap on the app in the Google Play listing to bring <br/>up the installation screen. Follow the onscreen <br/>instructions to install the appropriate app for your phone.<br/><br/>**Important note:** When you install the FTC apps, **_only install <br/>one FTC app_** (FTC Robot Controller or FTC Driver Station) **_per <br/>phone._**<br/><br/>You should avoid installing both apps onto the same phone. <br/>Doing so can cause Wi-Fi connection problems. You should <br/>only install the FTC Robot Controller app onto the phone <br/>that will be the Robot Controller and the FTC Driver Station <br/>app onto the phone that will be the Driver Station. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep6.jpg" width="175"> | | 6. Tap on the app in the Google Play listing to bring <br/>up the installation screen. Follow the onscreen <br/>instructions to install the appropriate app for your phone.<br/><br/>**Important note:** When you install the FTC apps, **_only install <br/>one FTC app_** (FTC Robot Controller or FTC Driver Station) **_per <br/>phone._**<br/><br/>You should avoid installing both apps onto the same phone. <br/>Doing so can cause Wi-Fi connection problems. You should <br/>only install the FTC Robot Controller app onto the phone <br/>that will be the Robot Controller and the FTC Driver Station <br/>app onto the phone that will be the Driver Station. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep6.jpg" width="175"> |
| 7. After you have successfully installed the app, you should<br/>forget the external wireless network on your phone.<br/><br/>Go to the Android Wi-Fi screen, find the name of the <br/>currently connected network, and tap on the network name <br/>to bring up a pop-up box with info about the network. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep7.jpg" width="175"> | | 7. After you have successfully installed the app, you should<br/>forget the external wireless network on your phone.<br/><br/>Go to the Android Wi-Fi screen, find the name of the <br/>currently connected network, and tap on the network name <br/>to bring up a pop-up box with info about the network. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep7.jpg" width="175"> |
| 8. Click on the **FORGET** button to forget the wireless network. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep8.jpg" width="175"> | | 8. Click on the **FORGET** button to forget the wireless network. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/InstallStep8.jpg" width="175"> |
@ -65,7 +66,7 @@ Note that it will take an estimated 7.5 minutes per phone to complete this task.
### Placing Phones into Airplane Mode with Wi-Fi On ### 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. 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 that 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. 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 | | Step| Image |
| ----------- | :---: | | ----------- | :---: |
@ -74,9 +75,9 @@ Note that it will take an estimated 2.5 minutes per phone to complete this task.
### Pairing the Driver Station to the Robot Controller ### Pairing the Driver Station to the Robot Controller
#### Control Hub Users #### Control Hub Users
The REV Robotics Control Hub should come with the Robot Controller app already 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.” 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 that 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. 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. Also note that it will take an estimated 10 minutes to complete this task.
@ -113,7 +114,7 @@ Note that it will take an estimated 10 minutes to complete this task.
| 6. From the **Settings** screen, look for and select <br/>**Pairing Method** to launch the **Pairing** <br/>**Method** screen. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep6.jpg" width="175"> | | 6. From the **Settings** screen, look for and select <br/>**Pairing Method** to launch the **Pairing** <br/>**Method** screen. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep6.jpg" width="175"> |
| 7. Verify that the **Wifi Direct** mode is selected, which means <br/> that this Driver Station will be pairing with <br/> another Android device. <br/><br/> | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep7.jpg" width="175"> | | 7. Verify that the **Wifi Direct** mode is selected, which means <br/> that this Driver Station will be pairing with <br/> another Android device. <br/><br/> | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep7.jpg" width="175"> |
| 8. From the **Settings** screen, look for and select <br/>**Pair with Robot Controller** to launch the **Pair**<br/>**with Robot Controller** screen. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep8.jpg" width="175"> | | 8. From the **Settings** screen, look for and select <br/>**Pair with Robot Controller** to launch the **Pair**<br/>**with Robot Controller** screen. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep8.jpg" width="175"> |
| 9. Find the name of your Robot Controller from the <br/>list and select it.<br/><br/>After you have made your selection, use the back-arrow <br/>key to return to the Settings screen.<br/><br/>Then press the back-arrow key one more time to return <br/>to the main Driver Station screen. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep9.jpg" width="175"> | | 9. Find the name of your Robot Controller from the <br/>list and select it.<br/><br/>After you have made your selection, use the back-arrow key to return to the Settings <br/>screen.<br/><br/>Then press the back-arrow key one more time to return to the main Driver Station screen. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep9.jpg" width="175"> |
| 10. When the Driver Station returns to its main <br/>screen, the first time you attempt to connect to the <br/>Robot Controller a prompt should appear on the Robot <br/>Controller screen.<br/><br/>Click on the **ACCEPT** button to accept the connection <br/>request from the Driver Station. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep10.jpg" width="175"> | | 10. When the Driver Station returns to its main <br/>screen, the first time you attempt to connect to the <br/>Robot Controller a prompt should appear on the Robot Controller screen.<br/><br/>Click on the **ACCEPT** button to accept the connection <br/>request from the Driver Station. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep10.jpg" width="175"> |
| 11. Verify that the Driver Station screen has <br/>changed and that it now indicates that it is connected <br/>to the Robot Controller.<br/><br/>The name of the Robot Controller’s remote network <br/>(“9999-C-RC” in this example) should be displayed in the <br/>Network field on the Driver Station. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep11.jpg" width="175"> | | 11. Verify that the Driver Station screen has <br/>changed and that it now indicates that it is connected to the Robot Controller.<br/><br/>The name of the Robot Controller’s remote network <br/>(“9999-C-RC” in this example) should be displayed in the <br/>Network field on the Driver Station. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep11.jpg" width="175"> |
| 12. Verify that the Robot Controller screen has <br/>changed and that it now indicates that it is connected <br/>to the Driver Station.<br/><br/>The Network status should read “active, connected” on <br/>the Robot Controller’s main screen. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep12.jpg" width="175"> | | 12. Verify that the Robot Controller screen has <br/>changed and that it now indicates that it is connected to the Driver Station.<br/><br/>The Network status should read “active, connected” on the Robot Controller’s main screen. | <img src="https://github.com/FIRST-Tech-Challenge/WikiSupport/blob/master/ftc_app/images/PairingNewStep12.jpg" width="175"> |