Managing a Smartphone Robot Controller - FIRST-Tech-Challenge/SkyStone GitHub Wiki

In order to comply with game manual rule <RS01>, the name of the Robot Controller's smartphone should be changed.

This tutorial demonstrates how to rename a smartphone using the Android Settings activity of the phone.

You can also use the FTC app to change the Robot Controller phone's name.

Important Note: Once the name of your Robot Controller is changed, you might need to reconnect your devices (Driver Station and programming laptop/Chromebook) to the newly changed network.

Changing the Name of a Robot Controller
1. On the Robot Controller phone, touch the three dots in the upper right hand corner to display a pop-up menu.
2. Select the Settings menu item from the pop-up menu.
3. Click on Robot Controller Name on the ROBOT CONTROLLER SETTINGS page.
4.Specify the new Robot Controller Name and press OK to accept the changes.

By default the smartphone Robot Controller automatically picks its own operating WiFi channel. However, it is sometimes necessary to specify the operating channel for the device.

For example, at a large competition an FTA might ask that you switch to a designated channel to avoid wireless interference that is present in the venue. Similarly, an FTA might ask you to switch to a specific channel because the FTA is monitoring that designated channel for interference or other wireless disruptions.

You can change the operating channel using the Advanced Settings menu on the Robot Controller or Driver Station.

Important Note: Not every Android phone supports channel changing through the FTC software. Refer to rule <RE06> in the game manual for a list of FIRST-approved phones that support channel changing through the FTC software.

Changing the WiFi Channel
1. Verify that the Driver Station is connected to your Robot Controller.
2. Tap the three dots in the upper right hand corner of the Driver Station's main screen to display the pop-up menu and select Settings from the menu.
3. Scroll down to the ROBOT CONTROLLER SETTINGS section of the Settings screen and click on the words Advanced Settings to display the ADVANCED ROBOT CONTROLLER SETTINGS activity.
4. Click on the Change Wifi Channel link to display a list of available channels.
5. Select the desired operating channel. The phone should display a toast message if the channel change was successful.
6. Use the Android back arrow to return to the main Driver Station screen. The new operating channel should be displayed in the "Network:" section under the Robot Controller's name

It's often helpful when troubleshooting problems with the Control System to download the log file from the Robot Controller. This can be done from the Manage page. Note that the log file name is robotControllerLog.txt by default.

Downloading the Log File
1. Verify that your laptop or Chromebook is connected to the Program & Manage wireless network of the smartphone Robot Controller. If you are connected to the network, you should be able to see the Robot Controller Connection Info page when you navigate to address "192.168.49.1:8080": If your laptop or Chromebook is not connected and you are unable to access the Robot Controller Connection Info page, then read the instructions in the following tutorial to learn how to connect to the Program & Manage network. Connecting a Laptop to the Program & Manage Network
2. Click on the Manage link towards the top of the Robot Controller Connection Info page to navigate to the Manage page.
3. Click the Download Logs button to download the Robot Controller log file.
2. Verify that the Robot Controller log file was downloaded to the Downloads directory of your computer.
3. Use a text editor such as Notepad++ or Microsoft's WordPad to open and view the contents of the log file. Note that the Windows app, Notepad, will not properly display the contents of the log file.

The Robot Controller connects to a REV Robotics Expansion Hub using a USB connection. The purpose of the Expansion Hub is to facilitate communication between the Robot Controller and the motors, servos, and sensors of the robot. Periodically, REV Robotics will release new versions of the firmware which contains fixes and improvements for the Expansion Hub. The firmware releases are in the form of a binary (".bin") file.

You can use the Manage interface to upload the firmware file to the Robot Controller. You can then use a Driver Station that is connected to the Robot Controller to initiate the firmware update. New firmware images can be obtained from the REV Robotics website.

Updating the Expansion Hub Firmware
1. On the Manage page of the Robot Controller user interface, press the Select Firmware button to to select the firmware file that you would like to upload. An Upload button should appear after you successfully selected a file.
2. Press the Upload button to upload the firmware file from your computer to the Robot Controller. The words "Firmware upload complete" should appear once the file has been uploaded successfully.
3. Make sure that your Expansion Hub is turned on and powered by a freshly charged 12V battery and that the Robot Controller phone is connected to the Expansion Hub through a USB connection. Note that the Robot Controller does not need to have the Expansion Hub included in an active configuration file in order for the update to work.
4. On the Driver Station, touch the three dots in the upper right hand corner to display a pop-up menu.
5. Select Settings from the pop-up menu to display the Settings activity.
6. On the Driver Station, scroll down and select the Advanced Settings item (under the ROBOT CONTROLLER SETTINGS category).
7. Select the Expansion Hub Firmware Update item on the ADVANCED ROBOT CONTROLLER SETTINGS activity.
8. If a firmware file that is different from the version currently installed on the Expansion Hub was successfully uploaded, the Driver Station should display some information about the current firmware version and the new firmware version. Press the Update Expansion Hub Firmware button to start the update process.
9. A progress bar will display while the firmware is being updated. Do not power off the Robot Controller/Expansion Hub during this process. The Driver Station will display a message when the update process is complete.

It is important to know how to update the Robot Controller app that is installed on your smartphone. FIRST periodically releases new versions of this app, which contain improvements and fixes, as well as season-specific data and features.

Note that you can see the Robot Controller app version number through the Robot Controller or Driver Station user interface. Select the About menu option on the Robot Controller or Driver Station and note the App Version number under the ABOUT ROBOT CONTROLLER section.

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:

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.

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.

Updating the Robot Controller App (Using Google Play)
1. Connect your Android phone to the wireless network that has access to the Internet.
2. Launch the Google Play Store app on the Android device.
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.
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.
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.
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.

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.

A commented example of what the contents of a calibration file should look like can be found in a file called teamwebcamcalibrations.xml, which is included with the FTC Android Studio project folder. For the Skystone season, this example calibration file can be found here.

Uploading a Custom Webcam Calibration File
1. On the Manage page, click on the Select Webcam Calibration File... button to select the calibration file. An Upload button should appear if a file was successfully selected.
2. Click on the Upload button to upload the selected file. If the upload was successful, then the Manage page will display a message indicating that the upload has completed.