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

add image

WestsideRobotics
2022-10-14 22:03:58 -07:00
parent ddeeaddf24 e190f8cccc
commit 82ec7928bd
8 changed files with 717 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

178
1.-Updating-the-DS-App.md Normal file

@ -0,0 +1,178 @@
## Introduction - Updating the DS App
This page shows how to update the FTC Driver Station (DS) app on these devices:
- Android DS phone
- REV Driver Hub
For other FTC updates, click sidebar links at the right side of this page.
## Driver Station (DS) app on Android phone
Here are 2 methods to update the DS app on a DS phone:
1. REV Hardware Client (RHC)
2. "Side loading" with APK
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/1.-Updating-the-DS-App]]</i><p>
### Method 1 - REV Hardware Client (RHC)
Plug the DS phone directly into the computer with RHC installed and open. Use a USB data cable, not a charge-only cable. Make sure the "Hardware" tab is active, at top left. The DS app on the phone does **not** need to be open.
<i>Here the computer does not need to be connected to the internet, since the required DS file was previously downloaded.</i>
The RHC app will recognize the phone, as shown here:
<p align="center">[[/images/Updating-FTC-Software/030-RHC-recognize-phone.png|030-RHC-recognize-phone]]
Click on that phone's large icon/rectangle. The RHC app now displays the update status of the DS app, if any.
<p align="center">[[/images/Updating-FTC-Software/040-RHC-update-DS-phone.png|040-RHC-update-DS-phone]]
Simply click the blue Update rectangle (green arrow) -- done!
The update was fast, because you had already downloaded the DS app to the RHC. That was noted with '(Already Downloaded)", to the left of the blue Update rectangle.
<i>You could have selected an **older** version of the DS app, in the drop-down list just above the blue Update rectangle.</i>
After install, drag the DS app icon from the app menu to the phone's home screen.
You may now unplug the DS phone from the computer, and close the RHC app. The updated DS app is ready to use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/1.-Updating-the-DS-App]]</i><p>
### Method 2 - Side-load
Here you will work directly with the Android Package or **APK file** to install the DS app on the Android phone. Any computer can be used, PC or Mac, old or new. This method is sometimes called "side-loading".
1. Connect your computer to the internet, open a web browser, and navigate to the [**FTC github repository**](https://github.com/FIRST-Tech-Challenge/FtcRobotController).
<p align="center">[[/images/Updating-FTC-Software/050-FTC-repo.png|050-FTC-repo]]
At the right side under "Releases", click the "Latest" icon (yellow oval, above).
In the next page, scroll down slightly in the "Latest" section, to the short list of "Assets". Click on the file "FtcDriverStation-release.apk", to download it to your computer.
<p align="center">[[/images/Updating-FTC-Software/060-github-assets DS.png|060-github-assets DS]]
At this time, you could rename the file to reflect its current version number. For example, `FtcDriverStation-release-8.0.apk` or simply `DS-8.0-release.apk`. This distinguishes the file from other versions that might be stored later on that DS phone.
2. Transfer the APK file from the computer to the DS phone's Downloads (or Download) folder. Use a USB data cable (not a charge-only cable). When complete, you may unplug the DS phone from the computer.
3. Uninstall the existing (obsolete) DS app, by dragging its icon to a Trash/Uninstall icon. Or, touch and hold the DS icon for "App info", then choose Uninstall.
4. On the DS phone, navigate to the Downloads folder. This can be done in several ways:
- at the main app menu (swipe up), touch the Files icon or the Downloads icon (if present)
- use the basic file manager in Settings/Storage, then Explore or Files
- use a third-party app such as FX File Explorer (from the Google Play Store)
Touch the APK filename that you transferred. Respond to the prompts, to install the updated FTC DS app.
After install, drag the DS app icon from the menu to the phone's home screen.
Done! The updated DS app is now ready to use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/1.-Updating-the-DS-App]]</i><p>
## Driver Station (DS) app on REV Driver Hub
Here are 3 methods to update the DS app on a REV Driver Hub:
1. REV Hardware Client (RHC)
2. "Side loading" with APK
3. Software Manager on REV Driver Hub
The first two methods are the same as above, for updating on a DS phone.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/1.-Updating-the-DS-App]]</i><p>
### Method 1 - REV Hardware Client (RHC)
Plug the REV Driver Hub directly into the Windows computer with RHC installed and open. Use a USB-C data cable. Make sure the "Hardware" tab is active, at top left. The DS app on the Driver Hub does **not** need to be open.
<i>Here the computer does not need to be connected to the internet, since the required DS file was previously downloaded.</i>
The RHC app will recognize the Driver Hub, as shown here:
<p align="center">[[/images/Updating-FTC-Software/070-RHC-recognize-DH.png|070-RHC-recognize-DH]]
Click on the Driver Hub's large icon/rectangle. The RHC app now displays the update status of the DS app, if any.
<p align="center">[[/images/Updating-FTC-Software/075-RHC-update-DH.png|075-RHC-update-DH]]
Simply click the blue Update rectangle (green arrow) -- done!
The update was fast, because you had already downloaded the DS app to the RHC. That was noted with '(Already Downloaded)", to the left of the blue Update rectangle.
<i>You could have selected an **older** version of the DS app, in the drop-down list just above the blue Update rectangle.</i>
After install, drag the DS app icon from the app menu to the Driver Hub's home screen, if needed.
You may now unplug the Driver Hub from the computer, and close the RHC app. The updated DS app is ready to use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/1.-Updating-the-DS-App]]</i><p>
### Method 2 - Side-load
Here you will work directly with the Android Package or **APK file** to install the DS app on the Driver Hub. Any computer can be used, PC or Mac, old or new. This method is sometimes called "side-loading".
1. Connect your computer to the internet, open a web browser, and navigate to the [**FTC github repository**](https://github.com/FIRST-Tech-Challenge/FtcRobotController).
<p align="center">[[/images/Updating-FTC-Software/050-FTC-repo.png|050-FTC-repo]]
At the right side under "Releases", click the "Latest" icon (yellow oval, above).
In the next page, scroll down slightly in the "Latest" section, to the short list of "Assets". Click on the file "FtcDriverStation-release.apk", to download it to your computer.
<p align="center">[[/images/Updating-FTC-Software/060-github-assets DS.png|060-github-assets DS]]
At this time, you could rename the file to reflect its current version number. For example, `FtcDriverStation-release-8.0.apk` or simply `DS-8.0-release.apk`. This distinguishes the file from other versions that might be stored later on that Driver Hub.
2. Transfer the APK file from the computer to the Driver Hub's Downloads folder. Use a USB-C data cable. When complete, you may unplug the Driver Hub from the computer.
3. Uninstall the existing (obsolete) DS app, by dragging its icon to the Trash/Uninstall icon. Or, touch and hold the DS icon for "App info", then choose Uninstall.
4. On the Driver Hub, navigate to the Downloads folder. This can be done in several ways:
- at the main app menu (swipe up), touch the Files icon, then three bars at top left
- use the basic file manager in Settings/Storage, then touch Files
- use a third-party app such as FX File Explorer (from the Google Play Store)
Touch the APK filename that you transferred. Respond to the prompts, to install the updated FTC DS app.
After install, drag the DS app icon from the menu to the Driver Hub's home screen, if needed.
Done! The updated DS app is now ready to use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/1.-Updating-the-DS-App]]</i><p>
### Method 3 - Software Manager
The REV Driver Hub has a built-in app called the Software Manager, which can automatically update the DS app (and other FTC-related software). It requires only an internet connection.
1. Close all apps, and open the Driver Hub's Wi-Fi menu (in Settings, or swipe down twice from top of home screen). Temporarily connect the Driver Hub to the internet via Wi-Fi.
2. Open the Software Manager app at the Driver Hub home screen (left image, below).
<p align="center">[[/images/Updating-FTC-Software/910-DH-double.png|910-DH-double]]
3. The Software Manager will automatically check for any updates needed, and display the results (right image, above). Click the grey box to update the Driver Station (DS) app, if needed.
4. When all is complete, "Forget" the Wi-Fi network used for internet access. Now the Driver Hub is ready for regular FTC use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/1.-Updating-the-DS-App]]</i><p>
<i>Questions, comments and corrections to westsiderobotics@verizon.net</i>
.
<!--
This text does not appear at the published wiki.
-->

167
2.-Updating-the-RC-App.md Normal file

@ -0,0 +1,167 @@
## Introduction - Updating the RC App
This page shows how to update the FTC Robot Controller (RC) app on these devices:
- Android RC phone
- REV Control Hub
For other FTC updates, click sidebar links at the right side of this page.
**Android Studio** teams should **not** use these steps to update the RC app. Instead, the RC app is built and deployed from Android Studio -- a process not covered in this tutorial.
## Robot Controller (RC) app on Android phone
Here are 2 methods to update the RC app on a Robot Controller (RC) phone:
1. REV Hardware Client (RHC)
2. "Side loading" with APK
<i>The Manage page, under Program and Manage, on a computer or Driver Station device, **does not** offer updating an RC app on a connected Robot Controller phone.</i>
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/2.-Updating-the-RC-App]]</i><p>
### Method 1 - REV Hardware Client
This method is the same as for updating the DS app on a DS phone.
Plug the RC phone directly into the Windows computer with the REV Hardware Client (RHC) installed and open. Use a USB data cable, not a charge-only cable. Make sure the "Hardware" tab is active, at top left. The RC app on the phone does **not** need to be open.
<i>Here the computer does not need to be connected to the internet, since the required RC file was previously downloaded.</i>
The RHC app will recognize the phone, as shown here:
<p align="center">[[/images/Updating-FTC-Software/080-RHC-recognize-RC-phone.png|080-RHC-recognize-RC-phone]]
Click on that phone's large icon/rectangle. The RHC app now displays the update status of the RC app, if any.
<p align="center">[[/images/Updating-FTC-Software/082-RHC-update-RC-phone.png|082-RHC-update-RC-phone]]
Simply click the blue Update rectangle (green arrow) -- done!
The update was fast, because you had already downloaded the RC app to the RHC. That was noted with '(Already Downloaded)", to the left of the blue Update rectangle.
<i>You could have selected an **older** version of the RC app, in the drop-down list just above the blue Update rectangle.</i>
After install, drag the RC app icon from the menu to the phone's home screen.
You may now unplug the RC phone from the computer, and close the RHC app. The updated RC app is ready to use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/2.-Updating-the-RC-App]]</i><p>
### Method 2 - Side-load
Here you will work directly with the Android Package or **APK file** to install the RC app on the Android phone. Any computer can be used, PC or Mac, old or new. This method is sometimes called "side-loading".
1. Connect your computer to the internet, open a web browser, and navigate to the [**FTC github repository**](https://github.com/FIRST-Tech-Challenge/FtcRobotController).
<p align="center">[[/images/Updating-FTC-Software/050-FTC-repo.png|050-FTC-repo]]
At the right side under "Releases", click the "Latest" icon (yellow oval, above).
In the next page, scroll down slightly in the "Latest" section, to the short list of "Assets". Click on the file "FtcRobotController-release.apk", to download it to your computer.
<p align="center">[[/images/Updating-FTC-Software/090-github-assets-RC.png|090-github-assets-RC]]
At this time, you could rename the file to reflect its current version number. For example, `FtcRobotController-release-8.0.apk` or simply `RC-8.0-release.apk`. This distinguishes the file from other versions that might be stored later on that RC phone.
2. Transfer the APK file from the computer to the RC phone's Downloads (or Download) folder. Use a USB data cable (not a charge-only cable). When complete, you may unplug the RC phone from the computer.
3. Uninstall the existing (obsolete) RC app, by dragging its icon to a Trash/Uninstall icon. Or, touch and hold the RC icon for "App info", then choose Uninstall.
4. On the RC phone, navigate to the Downloads folder. This can be done in several ways:
- at the main app menu (swipe up), touch the Files icon or the Downloads icon (if present)
- use the basic file manager in Settings/Storage: touch Explore or Files
- use a third-party app such as FX File Explorer (from the Google Play Store)
Touch the APK filename that you transferred. Respond to the prompts, to install the updated FTC RC app.
After install, drag the RC app icon from the app menu to the RC phone's home screen.
Done! The updated RC app is now ready to use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/2.-Updating-the-RC-App]]</i><p>
## Robot Controller (RC) app on REV Control Hub
Here are 3 methods to update the RC app on a REV Control Hub:
1. REV Hardware Client (RHC)
2. Manage page on computer
3. Manage page on DS phone or Driver Hub
"Side loading" is not described here for the Control Hub, which requires a cumbersome procedure with extra equipment.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/2.-Updating-the-RC-App]]</i><p>
### Method 1 - REV Hardware Client
To update the RC app on a REV Control Hub using the REV Hardware Client (RHC), follow the [**same steps as above**](https://github.com/WestsideRobotics/Updating-FTC-Software/wiki/2.-Updating-the-RC-App#Method-1---REV-Hardware-Client) for updating the RC app on an RC phone. Use a USB data cable to connect the REV Control Hub's USB-C port to the Windows computer.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/2.-Updating-the-RC-App]]</i><p>
### Method 2 - Manage page on computer
This method assumes you have already downloaded the RC APK file from the FTC github repo to the laptop. See those instructions above.
1. Turn on the Control Hub (apply robot power), wait for green LED.
2. Connect a laptop via Wi-Fi to the Control Hub. Open the Chrome browser, enter the usual address http://192.168.43.1:8080
Click the Manage tab, then scroll down to "Update Robot Controller App".
<p align="center">[[/images/Updating-FTC-Software/300-manage-RC-app.png|300-manage-RC-app]]
Click "Select App...". Navigate to the laptop folder where the RC APK file is stored, and select that file.
Now click the "Update" button (green arrow, above).
The software will replace the existing RC app with your new updated RC app. The connection between laptop and Control Hub will temporarily be lost, then automatically restored.
When the completion message appears, the updated RC app is ready to use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/2.-Updating-the-RC-App]]</i><p>
### Method 3 - Manage page on DS phone or Driver Hub
This method can be used if your computer is unavailable or unable to connect via Wi-Fi to the Control Hub. For example, your desktop computer might have only a wired (Ethernet) network port, lacking Wi-Fi.
But this method does require the RC APK file to be stored in the Download (or Downloads) folder on the DS phone or Driver Hub. That's correct: **Robot Controller APK** stored on the **Driver Station** device.
First download the RC APK file from the FTC github repo to the computer, as shown above. Then transfer that APK file from the computer to the DS device's Download folder, using a USB data cable. When complete, you may unplug the DS device from the computer.
Connect the DS app to the Control Hub, from the DS app's Settings menu (never with the Android device Wi-Fi settings).
From the DS app's menu, select "Program and Manage". Then touch the 3 bars at top right, and select "Manage".
<i>This is the same Manage page that appears in a laptop browser. So the following instructions are the same as Method 2 above.</i>
Scroll down to "Update Robot Controller App".
<p align="center">[[/images/Updating-FTC-Software/330-manage-RC-app-CH-DS.png|330-manage-RC-app-CH-DS]]
Touch "Select App...". Navigate to the DS device's Download folder, and select the latest RC APK file.
Now touch the "Update" button (green arrow, above).
The software will replace the existing RC app with your new updated RC app. The connection between Driver Station and Control Hub will temporarily be lost, then automatically restored.
When the completion message appears, the updated RC app is ready to use.
<i>Other descriptions of updating the RC app are [here](https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-robot-controller-application) at REV Robotics' excellent documentation site.</i>
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/2.-Updating-the-RC-App]]</i><p>
<i>Questions, comments and corrections to westsiderobotics@verizon.net</i>
.
<!--
This text does not appear at the published wiki.
-->

143
3.-Updating-Hub-Firmware.md Normal file

@ -0,0 +1,143 @@
## Introduction - Updating Hub Firmware
Firmware is low-level software that controls a device's circuit boards, or electronic **hardware**. This must sometimes be updated on the REV Expansion Hub, including the one contained inside a REV Control Hub.
Here are 5 methods:
1. REV Hardware Client (RHC)
2. Driver Station app
3. Robot Controller (RC) app - on RC phone
4. Manage page on computer
5. Manage page on Driver Station device (DS phone or Driver Hub)
For other FTC updates, click sidebar links at the right side of this page.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/3.-Updating-Hub-Firmware]]</i><p>
## Method 1 - REV Hardware Client (RHC) - Windows computers only
1. For REV Control Hub, apply 12V robot power. For REV Expansion Hub, 12V power is optional.
2. Plug the REV Hub directly into a computer running the REV Hardware Client, with a USB data cable (not charge-only). The Expansion Hub's port is Mini USB (not micro). On the Control Hub, use only the USB-C port, not its Mini USB port.
<i>As of October 2022, RHC version 1.4.3 has a known bug with some aspects of firmware updating. A fix is planned for the next version.</i>
3. Click the hub's large icon/rectangle. Under "Expansion/Control Hub Firmware", see the current/latest mismatch, if any (yellow oval, below).
<p align="center">[[/images/Updating-FTC-Software/350 RHC-EH-firmware.png|350 RHC-EH-firmware]]
Here's an example with Control Hub:
<p align="center">[[/images/Updating-FTC-Software/400-RHC-EH-CH-firmware.png|400-RHC-EH-CH-firmware]]
Confirm the Latest Version in the drop-down menu, then click the blue "Re-install" rectangle (green arrow, above). This is done quickly, since you already downloaded the firmware file at the start of this tutorial.
Done! The Hub's firmware is now updated.
<i>More info about using the RHC to update Hub firmware is [here](https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-firmware) at REV Robotics' excellent documentation site.</i>
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/3.-Updating-Hub-Firmware]]</i><p>
## Method 2 - Driver Station app
This method applies to any DS app, running on a DS phone or a Driver Hub.
1. For REV Control Hub, apply 12V robot power. For REV Expansion Hub, connect directly to Robot Controller (RC) phone, open RC app, **and** apply 12V power. The Expansion Hub being updated must be **plugged directly** into the RC phone, with no intermediate Control Hub or other (primary) Expansion Hub. After updating you can return that Hub to its secondary position, if needed.
2. Connect/pair the DS app to the RC device, from a DS phone or Driver Hub. Select DS Settings, Advanced (Robot Controller) Settings, REV Hub Firmware Update.
<p align="center">[[/images/Updating-FTC-Software/150-DS-firmware-double.png|150-DS-firmware-double]]
Review the list of available Hub firmware, whether stored on the RC device and/or "bundled" in the app.
3. If the latest does **not** appear on the list, you can transfer the firmware file from a computer to the Robot Controller. Use a USB data cable (not a charge-only cable) to store the firmware file in the RC device's subfolder called FIRST/updates/Expansion Hub Firmware.
<i>Current and older firmware files can be found at the REV Robotics website [**here**](https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-firmware/firmware-changelog).</i>
Then return to this list of available firmware.
4. Now select the latest firmware version and touch "Update Hub Firmware" (green arrow, above). Wait for the process to finish; do not unplug the Hub or restart the robot.
That's it! The Hub's firmware is now updated.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/3.-Updating-Hub-Firmware]]</i><p>
## Method 3 - Robot Controller (RC) app - on RC phone
This method is **exactly the same** as Method #2 immediately above, since the DS app was simply providing a portal or window to the RC app.
<i>It's listed separately here, because it applies only to **Expansion Hub**, not Control Hub -- which doesn't use an RC phone. In other words, users do not normally interface directly with the RC app on a Control Hub.</i>
Again, the Expansion Hub must be plugged **directly** into an RC phone, with no intermediate (primary) Expansion Hub. After updating you can return that Hub to its secondary position, if needed.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/3.-Updating-Hub-Firmware]]</i><p>
## Method 4 - Manage page on computer
1. Connect the computer via Wi-Fi to the Control Hub or RC phone. In the Chrome browser, open the FTC interface.
2. Click on the Manage tab, scroll down to Update REV Hub Firmware.
<p align="center">[[/images/Updating-FTC-Software/250-manage-firmware.png|250-manage-firmware]]
See if the grey box (see green arrow, above) offers the latest firmware version, included or bundled with the RC app.
3. If not, click the "Select Firmware..." box. Navigate to the desired firmware file stored on the computer, and select it.
<i>As part of the update process, that selected firmware file will be stored on the Control Hub or RC phone, in a subfolder called FIRST/updates/Expansion Hub Firmware.</i>
<i>Current and older firmware files can be found at the REV Robotics website [**here**](https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-firmware/firmware-changelog).</i>
4. Now click the box called "Update to..." or "Update using..." (see green arrow, above).
<p align="center">[[/images/Updating-FTC-Software/255-manage-firmware-confirm.png|255-manage-firmware-confirm]]
5. At the confirmation prompt, click the blue box "Update Hub Firmware". Wait for the process to finish; do not unplug the Hub or restart the robot.
That's it! The Hub's firmware is now updated.
<i>Note: as of October 2022, the REV Robotics [documentation site](https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-firmware#using-the-robot-controller-console) describes an **outdated two-step process** for using the Manage page to upload Hub firmware.</i>
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/3.-Updating-Hub-Firmware]]</i><p>
## Method 5 - Manage page on Driver Station device - DS phone or Driver Hub
1. Connect the DS app to the Control Hub or RC phone, from the DS app's Settings menu (never with the Android device Wi-Fi settings).
2. From the DS app's menu, select "Program and Manage". Then touch the 3 bars at top right, and select "Manage".
This is the same Manage page that appears in a laptop browser. So the following instructions are similar to Method 4 above.
3. Scroll down to Update REV Hub Firmware.
<p align="center">[[/images/Updating-FTC-Software/270-manage-firmware-DS-CH-landscape.png|270-manage-firmware-DS-CH-landscape]]
See if the grey box "Update to..." offers the latest firmware version, included or bundled with the DS app.
3. If not, you can transfer the desired firmware file to the **Driver Station device**.
<i>Yes, that's correct: transfer to the DS device, not to the RC device. This Method 5 uses a local file on the DS device, while Methods 2 and 3 (above) use a local file on the RC device.</i>
Use a USB data cable (not a charge-only cable) to store the firmware file in the DS device's Downloads folder.
<i>Current and older firmware files can be found at the REV Robotics website [**here**](https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-firmware/firmware-changelog).</i>
Then click the "Select Firmware..." box. Navigate to the DS device's Downloads folder, and select the desired firmware file.
4. Now click the box called "Update to..." or "Update using..." (second green arrow, above).
<p align="center">[[/images/Updating-FTC-Software/257-manage-firmware-confirm-DS.png|257-manage-firmware-confirm-DS]]
5. At the confirmation prompt, scroll down and click the blue box "Update Hub Firmware". Wait for the process to finish; do not unplug the Hub or restart the robot.
That's it! The Hub's firmware is now updated.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/3.-Updating-Hub-Firmware]]</i><p>
<i>Questions, comments and corrections to westsiderobotics@verizon.net</i>
.
<!--
This text does not appear at the published wiki.
-->

55
4.-Updating-the-Control-Hub-OS.md Normal file

@ -0,0 +1,55 @@
## Introduction - Updating the Control Hub OS
An Operating System (OS) is software that supports a computer's basic functions, such as scheduling tasks, executing applications, and controlling peripherals. This must sometimes be updated on the REV Control Hub.
Here are two methods for updating the Control Hub OS:
1. REV Hardware Client (RHC)
2. Manage page on computer
For other FTC updates, click sidebar links at the right side of this page.
<i>More info about updating the Control Hub OS is [here](https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-operating-system) at REV Robotics' excellent documentation site.</i>
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/4.-Updating-the-Control-Hub-OS]]</i><p>
## Method 1 - REV Hardware Client (RHC) - Windows computers only
1. Apply 12V robot power to the REV Control Hub.
2. Plug the Control Hub directly into a computer running the REV Hardware Client, with a USB-C data cable.
3. Click the hub's large icon/rectangle. Under "Control Hub Operating System", see the current/latest mismatch, if any (yellow oval, below).
<p align="center">[[/images/Updating-FTC-Software/650-RHC-OS.png|650-RHC-OS]]
Confirm the Latest Version in the drop-down menu, then click the blue "Update" rectangle (green arrow, above). The speed of this update is improved, since you already downloaded the OS file at the start of this tutorial.
Done! The Control Hub's OS is now updated.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/4.-Updating-the-Control-Hub-OS]]</i><p>
## Method 2 - Manage page on computer
1. Connect the computer via Wi-Fi to the Control Hub. In the Chrome browser, open the FTC interface.
2. Click on the Manage tab, scroll down to Update Control Hub Operating System.
<p align="center">[[/images/Updating-FTC-Software/700-manage-OS.png|700-manage-OS]]
3. If needed, download the latest OS file from the REV Robotics [**Control Hub OS web page**](https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-operating-system/operating-system-changelog). Do not extract or "un-zip" this file.
4. At the Manage page, click "Select Update File..." and navigate to the computer's folder where you downloaded the OS file.
5. Select that file, and click "Update & Reboot" (green arrow, above).
That's it! The Control Hub's OS is now updated.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/4.-Updating-the-Control-Hub-OS]]</i><p>
<i>Questions, comments and corrections to westsiderobotics@verizon.net</i>
.
<!--
This text does not appear at the published wiki.
-->

53
5.-Updating-the-Driver-Hub-OS.md Normal file

@ -0,0 +1,53 @@
## Introduction - Updating the Driver Hub OS
An Operating System (OS) is software that supports a computer's basic functions, such as scheduling tasks, executing applications, and controlling peripherals. This must sometimes be updated on the **REV Driver Hub**.
Here are two methods for updating the Driver Hub OS:
1. REV Hardware Client (RHC)
2. Software Manager on Driver Hub
For other FTC updates, click sidebar links at the right side of this page.
<i>More info about updating the Driver Hub OS is [here](https://docs.revrobotics.com/duo-control/managing-the-control-system/updating-the-driver-hub) at REV Robotics' excellent documentation site.</i>
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/5.-Updating-the-Driver-Hub-OS]]</i><p>
## Method 1 - REV Hardware Client (RHC) - Windows computers only
1. Turn on the Driver Hub. Plug it directly into a computer running the REV Hardware Client, with a USB-C data cable.
2. Click the Driver Hub's large icon/rectangle. Under "Driver Hub Operating System", see the current/latest mismatch, if any (yellow oval, below).
<p align="center">[[/images/Updating-FTC-Software/600-THC-DH-OS.png|600-THC-DH-OS]]
Confirm the Latest Version in the drop-down menu, if any. Then click the blue rectangle, labeled "Update" when applicable. The speed of this update is improved, since you already downloaded the OS file at the start of this tutorial.
Done! The Driver Hub's OS is now updated.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/5.-Updating-the-Driver-Hub-OS]]</i><p>
## Method 2 - Software Manager
The REV Driver Hub has a built-in app called the Software Manager, which can automatically update the Driver Hub OS (and other FTC-related software). It requires only an internet connection.
1. Close all apps, and open the Driver Hub's Wi-Fi menu (in Settings, or swipe down twice from top of home screen). Temporarily connect the Driver Hub to the internet via Wi-Fi.
2. Open the Software Manager app at the Driver Hub home screen (left image, below).
<p align="center">[[/images/Updating-FTC-Software/910-DH-double.png|910-DH-double]]
3. The Software Manager will automatically check for any updates needed, and display the results (right image, above). Touch the grey button to perform the updates, including the Driver Hub Operating System (OS) if needed.
<i>The REV Robotics website does not provide a downloadable OS file for the Driver Hub, as it does for the Control Hub.</i>
4. When all is complete, "Forget" the Wi-Fi network used for internet access. Now the Driver Hub is ready for regular FTC use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/5.-Updating-the-Driver-Hub-OS]]</i><p>
<i>Questions, comments and corrections to westsiderobotics@verizon.net</i>
.
<!--
This text does not appear at the published wiki.
-->

40
6.-Updating-FTC-Software-Tools.md Normal file

@ -0,0 +1,40 @@
## Introduction - Updating FTC Software Tools
Sometimes the FTC software management tools **themselves** need updating. This includes the REV Hardware Client and the Software Manager (on the REV Driver Hub).
For other FTC updates, click sidebar links at the right side of this page.
## Updating the REV Hardware Client
1. On a Windows computer connected to the internet, open the REV Hardware Client.
<p align="center">[[/images/Updating-FTC-Software/800-update-RHC.png|800-update-RHC]]
2. Click the "About" tab, then click "Check for Updates" (green arrow, above). If a new version is available, click to update.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/6.-Updating-FTC-Software-Tools]]</i><p>
## Updating the Software Manager, on the REV Driver Hub
The REV Driver Hub has a built-in app called the Software Manager, which can automatically update itself (and other FTC-related software). It requires only an internet connection.
1. Close all apps, and open the Driver Hub's Wi-Fi menu (in Settings, or swipe down twice from top of home screen). Temporarily connect the Driver Hub to the internet via Wi-Fi.
2. Open the Software Manager app at the Driver Hub home screen (left image, below).
<p align="center">[[/images/Updating-FTC-Software/910-DH-double.png|910-DH-double]]
3. The Software Manager will automatically check for any updates needed, and display the results (right image, above). This may include an update of the Software Manager itself, along with other software.
4. Touch "Update All" (green arrow, above).
5. When all is complete, "Forget" the Wi-Fi network used for internet access. Now the Driver Hub is ready for regular FTC use.
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/6.-Updating-FTC-Software-Tools]]</i><p>
<i>Questions, comments and corrections to westsiderobotics@verizon.net</i>
.
<!--
This text does not appear at the published wiki.
-->

74
Updating-FTC-Software.md Normal file

@ -0,0 +1,74 @@
## Introduction - Updating FTC Software
This tutorial shows how to update FTC software:
- Driver Station (DS) and Robot Controller (RC) **apps**
- **Firmware** for REV Control Hub and REV Expansion Hub
- **Operating Systems** for REV Control Hub and REV Driver Hub
- **Software tools** (REV Hardware Client, Software Manager)
Links are provided at the sidebar (right side of this page) and further below, but **first**, Windows users should install the **REV Hardware Client** (RHC).
If your desktop or laptop computer is **not running Windows**, see the sidebar or scroll down to the [**update links**](https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/Updating-FTC-Software#Links-to-Updating-Instructions).
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/Updating-FTC-Software]]</i><p>
## REV Hardware Client (RHC)
This is a desktop app, or software tool, that simplifies the updates listed above. Prepare here, and save time at the update links below.
To install, use the following steps on a **64-bit** PC or laptop running Windows 7 or newer. Apple/Mac users should skip this step.
<i>Not sure about 64-bit? In Windows Explorer, right-click "Computer" (Win 7) or "This PC" (Win 10), choose Properties, see "System type".</i>
1. Connect the computer to the internet, and download RHC [**here**](https://docs.revrobotics.com/rev-hardware-client/). Just click the orange Download button and choose your computer's Downloads folder to store the file.
<p align="center">[[/images/Updating-FTC-Software/010-download.png|010-download]]
2. See the downloaded file shown at lower left (green arrow). Click that filename to begin installing the RHC app; then follow the prompts. When that's complete, the RHC icon will appear on your computer's desktop.
<i>If the computer is **not** 64-bit, RHC installation will fail with an appropriate error message.</i>
3. Open the RHC app. This is a good time to **pre-download** various pieces of FTC software you might need soon.
<i>Why download now? Later, this computer might be connected via Wi-Fi to a Robot Controller, not to the internet. Or a good internet connection might not be available when urgently needed (Murphy's Law).</i>
Click on the Downloads tab (top left). Under "Available Files" is a list of software for FTC and other software for a different program called FRC.
<p align="center">[[/images/Updating-FTC-Software/020-RHC-available-files.png|020-RHC-available-files]]
Click the orange Download button, only for the 5 FTC items (yellow rectangles). This may take a few minutes; the OS files are large.
<i>You don't need to track where these files are stored; they will be available to the RHC app when needed for device update.</i>
When complete, these 5 items will appear under the heading "Downloaded Files".
That's all for now! You will use these files later, when updating various FTC devices as described below.
<i>More info about the RHC is [here](https://docs.revrobotics.com/rev-hardware-client/) at REV Robotics' excellent documentation site.</i>
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/Updating-FTC-Software]]</i><p>
## Links to Updating Instructions
- Driver Station: [**DS app**](https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/1.-Updating-the-DS-App)
- Robot Controller: [**RC app**](https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/2.-Updating-the-RC-App)
- REV Control Hub and REV Expansion Hub [**firmware**](https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/3.-Updating-Hub-Firmware)
- Operating System: [**REV Control Hub OS**](https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/4.-Updating-the-Control-Hub-OS)
- Operating System: [**REV Driver Hub OS**](https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/5.-Updating-the-Driver-Hub-OS)
- [**Software tools**](https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/6.-Updating-FTC-Software-Tools): REV Hardware Client, Software Manager
<p align="right"><i>[[Return to Top|https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/Updating-FTC-Software]]</i><p>
<i>Questions, comments and corrections to westsiderobotics@verizon.net</i>
.
<!--
This text does not appear at the published wiki.
-->

7
_Sidebar.md

@ -13,6 +13,13 @@
* [Robot Controller (RC)](Managing-a-Smartphone-Robot-Controller) * [Robot Controller (RC)](Managing-a-Smartphone-Robot-Controller)
* [Driver Station (DS)](Managing-a-Smartphone-Driver-Station) * [Driver Station (DS)](Managing-a-Smartphone-Driver-Station)
* [Two Expansion Hubs](Using-Two-Expansion-Hubs) * [Two Expansion Hubs](Using-Two-Expansion-Hubs)
* [Updating FTC Software - **<i>new!</i>**](Updating-FTC-Software)
* [DS App](1.-Updating-the-DS-App)
* [RC App](2.-Updating-the-RC-App)
* [Hub Firmware](3.-Updating-Hub-Firmware)
* [Control Hub OS](4.-Updating-the-Control-Hub-OS)
* [Driver Hub OS](5.-Updating-the-Driver-Hub-OS)
* [Software Tools](6.-Updating-FTC-Software-Tools)
### [Advanced Topics](Advanced-Topics) ### [Advanced Topics](Advanced-Topics)
* [Control Hub Webcam](Using-an-External-Webcam-with-Control-Hub) * [Control Hub Webcam](Using-an-External-Webcam-with-Control-Hub)