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

Replace Google Play Store process with text from Sec. 3.3 of Blocks Programming Manual provided 2-24-2022. Describe alternate side-loading.

Westside Robotics
2022-02-25 09:52:47 -08:00
parent fba41385c8
commit 4ab9a8f5c4
1 changed files with 12 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
Managing-a-Smartphone-Robot-Controller.md

@ -73,26 +73,21 @@ Note that you can see the Robot Controller app version number through the Robot
<p align="center">[[/images/Managing-a-Control-Hub/aboutRobotController.jpg]]</p> <p align="center">[[/images/Managing-a-Control-Hub/aboutRobotController.jpg]]</p>
If you use the FTC Blocks Development Tool or the FTC OnBot Java Tool to write your op modes, then the easiest way to update the Robot Controller App is using the Google Play store. To be able to use the Google Play Store to update your software, you will first need the following items: As of 2021, the FTC apps (v 6.1 and higher) are not available on Google Play.
1. A Google e-mail account (available for free from Google).
2. Access to a wireless network that can connect to the Internet.
3. Your Android smartphone.
**Important Note:** If you update your Robot Controller, then you should also update your Driver Station software to the same version number. For FTC teams using Blocks or OnBot Java for programming, the [REV Hardware Client software](https://docs.revrobotics.com/rev-control-system/managing-the-control-system/rev-hardware-client) will allow you to download the apps to FTC devices: REV Control Hub, REV Expansion Hub, REV Driver Hub, and FTC-approved Android devices. Here are some of the benefits:
- Connect 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.
**Important Note:** if you are an Android Studio user, then you cannot use the Google Play Store to update your Robot Controller app. Instead, by updating to the newest version of the FTC Android Studio project folder, you will update the Robot Controller app when you build the project and install it on your smartphone. For the Skystone season, you can download the newest version of the project folder [here](https://github.com/FIRST-Tech-Challenge/SkyStone). As an alternate, the FTC app releases are available on the [FTCRobotController Github](https://github.com/FIRST-Tech-Challenge/FtcRobotController/releases). Download the Robot Controller APK file to a computer, transfer it to the RC phone's Downloads folder, then open that file to install the RC app. This process is called "side-loading".
| Updating the Robot Controller App (Using Google Play)| **Important Note:** If you update the Robot Controller (RC) app, you should also update the Driver Station (DS) app to the same version number.
| ---- |
| 1. Connect your Android phone to the wireless network that has access to the Internet.| **Important Note:** Teams using Android Studio should not update the RC app with the REV Hardware Client or by side-loading. Instead, by updating to the newest version of the FTC Android Studio project folder, you will update the Robot Controller app when you build the project and install it on your RC device. You can download the newest version of the project folder [here](https://github.com/FIRST-Tech-Challenge/FtcRobotController).
| 2. Launch the Google Play Store app on the Android device.<br/><br/><p align="center">[[/images/Managing-a-Smartphone-Robot-Controller/launchGooglePlayStore.jpg]]</p>|
| 3. In the Google Play Store, if you haven’t signed into your Google account yet, follow the onscreen instructions to log into your Google account.|
| 4. In the search window of the Google Play Store type in the words “FTC Robot Controller” to find the app in the Play Store.<br/><br/><p align="center">[[/images/Managing-a-Smartphone-Robot-Controller/findFTCRobotController.jpg]]</p>|
| 5. Select the app (“FTC Robot Controller”) that you want to update on your Android phone from the search result list.|
| 6. If you do not have the most current version of the Robot Controller app, then the Google Play Store listing should have a button that reads “UPDATE”. Press the “UPDATE” button and follow the onscreen instructions to update your app.<br/><br/><p align="center">[[/images/Managing-a-Smartphone-Robot-Controller/updateFTCRobotController.jpg]]</p>|
| 7. The update process might prompt you to accept request for permissions that are needed in order to run the app on your Android phone. If prompted, hit the “ACCEPT” button to accept the request and to continue with the update process.|
| 8. Once the update process is complete, the “UPDATE” button on the screen should change to an “OPEN” button. You can press the “OPEN” button to launch the new app.<br/><br/><p align="center">[[/images/Managing-a-Smartphone-Robot-Controller/openFTCRobotController.jpg]]</p>|
| 9. After you have updated the software, you must forget the wireless network that you used to connect to the internet to access the Google Play store. You do not want to have your Android devices configured to connect to anything other than each other during a competition.<br/><br/><p align="center">[[/images/Managing-a-Smartphone-Robot-Controller/forgetWifiNetwork.jpg]]</p>|
### Uploading a Custom Webcam Calibration File ### Uploading a Custom Webcam Calibration File
The Robot Controller app has built-in calibration information for a variety of commonly available webcams. Users can also create their own custom calibration files and then upload these files to a Control Hub. The Robot Controller app has built-in calibration information for a variety of commonly available webcams. Users can also create their own custom calibration files and then upload these files to a Control Hub.