Software Update#
The robot software is delivered by MAB as Debian packages, one for each device:
Package |
Device |
|---|---|
|
Robot (LPC) |
|
Steam Deck |
|
APC, only with the camera and lidar payload, see Camera & Lidar |
The software is installed in /opt/<package name>. The robot and the Steam Deck must run the same version; otherwise the status console shows the warning Robot runs v<version>, remote v<version>: update both to the same version.
Note
This chapter covers the robot’s ROS 2 software stack running on the LPC and the HB50 Remote application on the Steam Deck. It is not related to the mainboard firmware update mode described in Button & Connectors.
Note
Robots and Steam Decks running v1.2.0 or older have to be prepared once before installing the package, see Moving from v1.2.0 or older.
Updating the robot#
Warning
Installing the package restarts the robot software. Lay the robot down in a stable position, select IDLE and make sure the robot stays powered on during the installation (connect the charger if the battery is low).
Connect a laptop or the Steam Deck to the robot’s network (see Network) and copy the package to the robot:
scp hb50-robot_<version>_amd64.deb hb@10.11.0.10:
Connect to the robot over SSH and install the package:
ssh hb@10.11.0.10 sudo apt install ./hb50-robot_<version>_amd64.deb
The package restarts the hb50 service, so the new version runs right after the installation.
Updating the Steam Deck#
Copy the package to the Steam Deck, for example from a USB stick in the Steam Deck desktop mode.
Close the
HB50 Remoteapplication, open a terminal in the folder with the package and install it:sudo apt install ./hb50-remote_<version>_amd64.deb
Start the
HB50 Remoteapplication with theHB50 Remoteicon on the desktop.
If apt reports missing dependencies, connect the device to the internet and run the command again.
Checking the installed version#
On the robot or the Steam Deck, run:
dpkg-query -W hb50-robot # on the robot
dpkg-query -W hb50-remote # on the Steam Deck
The robot version is also published on the /hb50/version_data/robot topic, see VersionData.
Settings#
Package updates keep changed files in /etc, so the settings below are set once:
File |
Device |
Contents |
|---|---|---|
|
Robot |
Robot name ( |
|
Steam Deck |
Name of the robot to control ( |
ROBOT_NS and ROS_DOMAIN_ID must be the same on the robot and the Steam Deck.
Going back to an older version#
Install the older package with:
sudo apt install --allow-downgrades ./hb50-robot_<older version>_amd64.deb
On the Steam Deck, use the hb50-remote package in the same way. Keep the robot and the Steam Deck on the same version.
Moving from v1.2.0 or older#
Software v1.2.0 and older ran from ~/install and was updated with update bundles. Remove it once before installing the package. Saved parameters and maneuvers in ~/.ros/mab are kept.
Robot#
Connect to the robot over SSH (user hb) and remove the old software:
sudo systemctl disable --now hb50.service
sudo rm -f /etc/systemd/system/hb50.service /etc/systemd/system/hb50-updater.service /etc/sudoers.d/hb50-updater
sudo systemctl daemon-reload
rm -rf ~/install ~/install-* ~/hb50-tools ~/updates
Set the robot name, replacing <robot name> with hb50, hb50w (robot with wheels) or hb40:
sed -i -e '/install\/setup.bash/d' -e '/HB50_NAMESPACE/d' ~/.bashrc
printf 'ROBOT_NS=<robot name>\nROS_DOMAIN_ID=69\nNETWORK=enp1s0\n' | sudo tee /etc/default/hb50
Install the package, keeping the robot name set above:
sudo apt install -o Dpkg::Options::=--force-confold ./hb50-robot_<version>_amd64.deb
Steam Deck#
Open a terminal on the Steam Deck (user mab), remove the old software and install the package:
rm -rf ~/install ~/install-* ~/updates ~/Desktop/hb.desktop
sed -i '/install\/setup.bash/d' ~/.bashrc
sudo apt install ./hb50-remote_<version>_amd64.deb
Set the name of the robot to control, replacing <robot name> as above:
sudo sed -i 's/^ROBOT_NS=.*/ROBOT_NS=<robot name>/' /etc/default/hb50-remote
Start the HB50 Remote application with the HB50 Remote icon on the desktop.