Ridgeback Maintenance
Battery Replacement
If Ridgeback's batteries need replacement, they are accessible by removing the top-plate and the insulator cover. Before performing any service or maintenance to the robot, the battery pack must be fully disconnected. The batteries weigh approximately 33 kg (73 lbs) each, so use care and caution when lifting the batteries out of the chassis. Please contact Clearpath Robotics regarding replacement batteries.
It may also be necessary to remove the antenna cables carefully prior to removing the batteries.
Long-term storage
When storing Ridgeback for long periods of time, its important to properly maintain the batteries to fully maximize their life. Consider one of the following two procedures when placing Ridgeback in long-term storage:
- Fully charge Ridgeback, turn it off and put it into storage. Once a week, connect power to the charger and allow the charger to top up the battery for an hour or so.
- Fully charge Ridgeback, turn it off and put it into storage, but leave the charger connected and powered the entire time Ridgeback is in storage via a wall timer that turns off for one hour every 24-hour cycle. The charger will monitor the battery and will automatically charge it up as needed. Note that the wall timer is needed since the charger times out and turns off otherwise.
Please contact Clearpath Robotics for additional information about Ridgeback's batteries.
Software Maintenance
Getting New Packages
If you are upgrading your robot from an older version of ROS, please refer to our upgrade instructions for upgrading to Melodic, Noetic and ROS 2 Humble.
Clearpath Robotics robots are always being improved, both its own software and the many community ROS packages upon which it depends!
You can use the apt
package management system to receive new versions all software running on the platform.
Each robot leaves the factory already configured to pull packages from http://packages.ros.org as well as http://packages.clearpathrobotics.com. To update your package and download new package versions, simply run:
sudo apt-get update
sudo apt-get dist-upgrade
MCU Firmware Update
Before flashing firmware, place your robot up on blocks or disengage the drivetrain. Firmware loading does not usually result in unintended motion, but it is safest when off the ground.
- J100
- W200
- R100
- DX100
- DX150
1. Download the Clearpath Firmware package from the Clearpath package server
On the robot computer, run the following commands:
sudo apt-get update
sudo apt-get install ros-humble-clearpath-firmware
2. Prepare the Robot
The J100 MCU does not have an ethernet interface, and therefore cannot be flashed using the eternet bootloader. You must follow the subsequent steps to flash the J100 MCU over mini-USB.
The J100 MCU is mounted to the rear inside wall of the robot. To access it, open the lid, keeping the computer tray secured to the underside of the lid.
Place the J100 MCU into bootloader mode
Open the lid of the robot to expose the MCU and make sure the mini-USB cable is connected to the robot computer.
Switch the PWR_MODE
switch from NORM
to ALT
. If the robot is on, press the M_RST
button. Otherwise, turn the robot on with the power button.
1. Download the Clearpath Firmware package from the Clearpath package server
On an external computer, run the following commands:
sudo apt-get update
sudo apt-get install ros-humble-clearpath-firmware
2. Prepare the Robot
Platforms with an Ethernet connection to the MCU have the option of flashing over USB or Ethernet. If you are updating to ROS 2 Humble for the first time, you must use USB. If you are updating ROS 2 Humble firmware to a newer version, using Ethernet is recommended. Skip this step if flashing over Ethernet.
The W200 MCU is located on the underside of the metal frame over the top of the computer.
Place the W200 MCU into bootloader mode
While pressing BT0
on the MCU, connect the external computer to Warthog's MCU using a USB cable.
1. Download the Clearpath Firmware package from the Clearpath package server
On the robot computer, run the following commands:
sudo apt-get update
sudo apt-get install ros-humble-clearpath-firmware
2. Prepare the Robot
Platforms with an Ethernet connection to the MCU have the option of flashing over USB or Ethernet. If you are updating to ROS 2 Humble for the first time, you must use USB. If you are updating ROS 2 Humble firmware to a newer version, using Ethernet is recommended. Skip this step if flashing over Ethernet.
Place the R100 Ridgeback up on blocks. Firmware loading does not usually result in unintended motion, but it's safest when off the ground.
Remove the side panels to access the robot computer and MCU.
Connect the MCU to the R100 Ridgeback's onboard computer using a mini-USB cable connected to the port shown below:
In the middle of the MCU, there is a two-position switch labelled PWR_MODE
. Move the switch from the default NORM
position to the AUX
position.
Press the M_RST
to restart the MCU. Now, the MCU is in boot-loader mode, ready to receive new firmware.
The Ridgeback's MCU is normally rotated 90 degrees when it is installed in the robot; the NORM
position is typically towards the top of the robot's chassis and the AUX
position is normally towards the bottom.
1. Download the Clearpath Firmware package from the Clearpath package server
On the robot computer, run the following commands:
sudo apt-get update
sudo apt-get install ros-humble-clearpath-firmware
2. Prepare the Robot
Platforms with an Ethernet connection to the MCU have the option of flashing over USB or Ethernet. If you are updating to ROS 2 Humble for the first time, you must use USB. If you are updating ROS 2 Humble firmware to a newer version, using Ethernet is recommended. Skip this step if flashing over Ethernet.
The DX100 MCU is mounted near the HMI panel towards the rear of the robot. To access it, remove the antennas and the center channel panel.
Connect the MCU to the onboard computer using a mini-USB cable connected to the port as shown below:
As is shown in the image above, set the PWR_MODE
switch to the ALT
position.
Press the M_RST
or restart the robot using the HMI panel. Now, the MCU is in boot-loader mode, ready to receive new firmware.
1. Download the Clearpath Firmware package from the Clearpath package server
On the robot computer, run the following commands:
sudo apt-get update
sudo apt-get install ros-humble-clearpath-firmware
2. Prepare the Robot
Platforms with an Ethernet connection to the MCU have the option of flashing over USB or Ethernet. If you are updating to ROS 2 Humble for the first time, you must use USB. If you are updating ROS 2 Humble firmware to a newer version, using Ethernet is recommended. Skip this step if flashing over Ethernet.
The DX150 MCU is mounted near the HMI panel towards the rear of the robot. To access it, remove the antennas and the center channel panel.
Connect the MCU to the onboard computer using a mini-USB cable connected to the port as shown below:
As is shown in the image above, set the PWR_MODE
switch to the ALT
position.
Press the M_RST
or restart the robot using the HMI panel. Now, the MCU is in boot-loader mode, ready to receive new firmware.
3. Flash the firmware
Run the Clearpath firmware flash tool:
source /opt/ros/humble/setup.bash
ros2 run clearpath_firmware flash
Select your platform, then select which method of flashing you would like to use.
Do not turn the robot off or unplug the cable while flashing firmware. If an error occurs while flashing, you can attempt to flash again over USB.
4. Place the robot back into normal operating mode
If you flashed over Ethernet, skip this step.
- J100
- W200
- R100
- DX100
- DX150
Switch the PWR_MODE
switch from ALT
back to NORM
. The robot will turn off.
Power it back on with the power button.
Press the RST
button. The MCU should enter regular operation.
Switch the PWR_MODE
switch from ALT
back to NORM
. The robot will turn off.
Power it back on with the power button.
Switch the PWR_MODE
switch from ALT
back to NORM
. The robot will turn off.
Power it back on with the power button.
Switch the PWR_MODE
switch from ALT
back to NORM
. The robot will turn off.
Power it back on with the power button.
Support
Clearpath is committed to your success. Please get in touch with us and we will do our best to get you rolling again quickly: support@clearpathrobotics.com.
To get in touch with a salesperson regarding Clearpath Robotics products, please email research-sales@clearpathrobotics.com.
If you have an issue that is specifically about ROS and is something which may be of interest to the broader community, consider asking it on https://robotics.stackexchange.com. If you do not get a satisfactory response, please ping us and include a link to your question as posted there. If appropriate, we will answer in the ROS Answers context for the benefit of the community.