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

10-11-22 upload to wiki, for conversion to RTD

Westside Robotics
2022-10-11 21:56:26 -07:00
parent 0f3075846e
commit 3adbeaed65
1 changed files with 143 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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.
-->