We're Updating our Documentation! For the most up-to-date information about the SPARK MAX and other ION Motor Controllers please check out the following new documentation pages:
The REV Hardware Client is software designed to make managing REV devices easier for the end user. This Client automatically detects connected device(s), downloads the latest software for those device(s), allows for seamless updating of the device(s), and allows for device configuration and management.
For more information on the REV Hardware Client, including a full list of supported devices, see the User's Manual.
You can also download the REV Hardware Client using an offline installer, bundled with software from March 21st, 2023: - Offline Installer bundled with FRC software
The REV Hardware Client will not work with SPARK MAX beta units distributed by REV to the SPARK MAX beta testers. It is only compatible with units received after 12/21/2018.
Operating System: Windows 10 (64-bit) or newer
Processor: 64-bit
Download the REV Hardware Client Installer above.
Run the Installer
Run the REV Hardware Client from the Windows Start Menu or a desktop shortcut
Latest REV Hardware Client - Version 1.5.3 |
---|
We're Updating our Documentation! For the most up-to-date information about the SPARK MAX and other ION Motor Controllers please check out the following new documentation pages:
The REV Hardware Client has three tabs to manage different features of the Client. The Hardware Tab is where supported hardware devices are managed. The Downloads Tab allows for the downloading of supported device software for updating when offline. The About Tab has information on what devices are supported, updating the REV Hardware Client, and having issue reporting.
Individual devices, like the SPARK MAX, have additional tabs available when the device is selected. For a full overview of the default navigation features of the REV Hardware Client see the User's Manual. Below is more information on using the specific features for the SPARK MAX.
The Hardware Tab is used to select devices connected via USB or the USB to CAN bridge for configuration, updates, and more.
Once a SPARK MAX is selected from the Hardware tab a number of device specific tabs will show.
The Basic Tab is used to set the most common parameters for the SPARK MAX.
Device Identify: Blink the selected SPARK MAX's LED for identification.
CAN ID: This assigns a SPARK MAX a CAN ID for identification over the CAN BUS. Any configured SPARK MAX must have a CAN ID.
Configurations: This drop down allows you to select pre-existing configurations store on the Windows machine running the SPARK MAX Client or to pull the existing parameters stored on in RAM on the SPARK MAX. This is helpful when configuring multiple motor controllers to the same settings.
Configured Parameters: Change the motor type, sensor type, idle mode behavior, and more.
The Advanced Tab allows for changing all configurable parameters of the SPARK MAX without needing to set them in code.
Search Parameters: Allows for easy look up of a specific parameter for editing.
Parameter Table: Select the arrow to show all configurable parameters within a specific group. For more information on each parameter type see Configuration Parameters.
Remember to burn the parameters to flash memory before disconnecting the SPARK MAX
The Run Tab allows for the SPARK MAX to operate over USB or a USB to CAN Bridge without the need for a full control system. This is helpful for testing mechanisms and tuning their control loops.
Run: Choose setpoints to run a motor connected to a SPARK MAX using various modes, including position, velocity, and duty cycle.
PIDF: Update PIDF parameters on the fly to tune control loops on the SPARK MAX.
View Graph: Moves the Client over to the Telemetry Tab to show any added signals in graph form when running a SPARK MAX. This is helpful when tuning control loops.
The API tab shows what the current version and latest version of the SPARK MAX APIs are. There are links to installing the current version of WPILib and for installing the SPARK MAX APIs properly.
Select Year: Selects the WPILib release year that is installed for API compatibility.
API Selection: Ability to choose which language API to download.
The Update tab shows what version of firmware is on the selected device, if that device is up to date, and update the firmware of the selected device.
Download Latest Firmware: Downloads latest firmware onto the local machine running the Client.
Update Firmware: Updates the selected device with the latest firmware.
Out-of-date Firmware Warning: Warning to alert the user there is new firmware available for any connected device.
For more information on the firmware updating process see Updating Device Firmware
We're Updating our Documentation! For the most up-to-date information about the SPARK MAX and other ION Motor Controllers please check out the following new documentation pages:
Connect your SPARK MAX Motor Controller to your computer with a USB-C cable.
Open the REV SPARK MAX Client application.
The Client should automatically scan and connect to your SPARK MAX.
Once the SPARK MAX is connected via USB-C select it within the Connected Hardware.
If the SPARK MAX connected via USB-C is running firmware version 1.5.0 or later allows the SPARK MAX to work as a USB to CAN Bridge. Other CAN connected SPARK MAXs running version 1.4.0 can be selected for firmware updates over CAN.
Within the Hardware Client, for the SPARK MAX, there are 5 tabs. The Hardware Client will open up on the Basic tab. To update firmware select the Update tab.
Under SPARK MAX Firmware, select download to download the latest version of the firmware.
Once the firmware has downloaded select update.
The update process will flash the firmware image onto the SPARK MAX. The status bar will show the progress of the process.
Once the firmware update is done your SPARK MAX will show a new status of Up-to-Date.
If your SPARK MAX is running firmware older than 1.4.0, you may need to unplug and replug the USB-C cable into the SPARK MAX for it to reconnect to the Client.
SPARK MAX Firmware Version 1.5.0 includes a USB-to-CAN Bridge feature that allows a single USB-connected SPARK MAX to act as a bridge to the entire CAN bus it is connected to. This allows for configuration and simultaneous updating of multiple SPARK MAX controllers without having to connect to each one individually. Using this feature requires the following:
A USB-connected SPARK MAX that is updated to firmware version 1.5.0 or newer to act as the Bridge.
Other SPARK MAXs connected on the CAN bus must be individually updated to firmware version 1.4.0 before they are able to receive mass-updates from the Bridging SPARK MAX.
Once these requirements are satisfied, navigate to the Hardware tab, select the Update All button.
Each device with the Out-of-Date warning will update with the latest version of the firmware.