Operating System Reinstallation
System Reinstallation
In some cases, you will need to restore your Panther system to its default settings:
- in case of accidental damage to the system
- to update the OS
- to clear all user changes and restore factory settings
User Computer System Reinstallation
This process varies depending on your computer model. Please select your User Computer model and follow the instruction.
- Intel NUC (PC02)
- Lenovo ThinkStation (PC03)
Intel NUC is compatible with the Husarion OS image. To install Husarion OS, please follow this guide.
In the case of a User Computer, you should install the same distribution of ROS that is on the Build in Computer.
The installation process cannot be performed in headless mode. Connection to a monitor and keyboard is required.
Lenovo ThinkStation is compatible with the Husarion OS image. To install Husarion OS, please follow this guide.
In the case of a User Computer, you should install the same distribution of ROS that is on the Build in Computer.
- The installation process cannot be performed in headless mode. Connection to a monitor and keyboard is required.
- NVIDIA GPU drivers are not pre-configured. If you intend to use it, it is necessary to properly configure the required software.
Motor Drivers
To configure motor drivers, a Windows computer with Roborun+ PC Utility v3.0 beta software installed is needed.
- ROS
- ROS 2 Beta
-
Follow the Service Space Manual to open both (front and rear) service spaces.
-
Follow the Roboteq Driver Setup guide, to update motor drivers configuration.
-
Follow the Service Space Manual to open both (front and rear) service spaces.
-
Follow the Roboteq Driver Setup guide, to update motor drivers configuration.
This step is needed only when switching between ROS and ROS2. If you're updating to the latest version or resetting to default settings, you can skip it.
Built-in Computer System Reinstallation
This computer is used to manage all the basic functions of a mobile platform. The reinstallation procedure for the Built-in Computer is as follows:
- ROS
- ROS 2 Beta
- ROS 2 Beta - using USB drive
-
To access it, follow the instructions in the section - Service Spaces. Depending on the Panther platform version, the location of the computer varies:
- the rear Service Space for version 1.2 and above,
- the front Service Space for older versions.
-
Extract the SD card from the Built-in Computer by carefully pulling it out.
REPLACING THE SD CARDIf you want to use your own SD card, make sure it has at least 32 GB of capacity and 10 Speed Class.
-
Download our custom OS image for the Built-in Computer.
-
Flash the image onto an SD card (For this process, we recommend using Balena Etcher, steps may vary depending on the software used for flashing):
- Download Balena Etcher and install it.
- Plug the SD card into an SD card reader.
- Open Etcher and select from your hard drive the .img.xz file.
- Select the SD card you wish to write your image to.
- Click Flash! to begin writing data to the SD card.
- Wait for the flashing and validation steps to finish.
-
Insert the SD card back into the Built-in Computer.
-
Access the Built-in Computer (remember, you must be connected to the Panther hotspot):
user@mylaptop:~$ssh husarion@10.15.20.2
-
Launch the software:
husarion@10.15.20.2:~$docker compose pull
docker compose up -d
-
To access it, follow the instructions in the section - Service Spaces. Depending on the Panther platform version, the location of the computer varies:
- the rear Service Space for version 1.2 and above,
- the front Service Space for older versions.
-
Extract the SD card from the Built-in Computer by carefully pulling it out.
REPLACING THE SD CARDIf you want to use your own SD card, make sure it has at least 32 GB of capacity and 10 Speed Class.
-
Download our custom OS image for the Built-in Computer.
-
Flash the image onto an SD card (For this process, we recommend using Balena Etcher, steps may vary depending on the software used for flashing):
- Download Balena Etcher and install it.
- Plug the SD card into an SD card reader.
- Open Etcher and select from your hard drive the .img.xz file.
- Select the SD card you wish to write your image to.
- Click Flash! to begin writing data to the SD card.
- Wait for the flashing and validation steps to finish.
-
Insert the SD card back into the Built-in Computer.
-
Access the Built-in Computer (remember, you must be connected to the Panther hotspot):
user@mylaptop:~$ssh husarion@10.15.20.2
-
Launch the software:
husarion@10.15.20.2:~$docker compose pull
docker compose up -d
Support for USB system installation was introduced for Panther robots delivered after July 18, 2024. If you have an older robot, you need to perform a one-time update for the Built-in computer's internal EEPROM. To do so, please refer to the Bootable USB Drive Not Working.
-
Download the flashing OS image for the Built-in Computer.
-
Flash the image onto a USB drive. The USB drive should have a capacity of at least 8GB. (For this process, we recommend using Balena Etcher. Steps may vary depending on the software used for flashing):
- Download Balena Etcher and install it.
- Plug in the USB drive.
- Open Etcher and select the .img.xz file from your hard drive.
- Select the USB drive you want to write the image to.
- Click Flash! to start writing data to the USB drive.
- Wait for the flashing and validation steps to complete.
-
Insert the USB drive into the robot's USB port.
-
Turn on the robot and access the Built-in Computer (remember, you must be connected to the Panther hotspot):
user@mylaptop:~$ssh husarion@10.15.20.2
-
Flash the new OS image:
husarion@10.15.20.2:~$sudo ./image-install.sh /dev/mmcblk0
The flashing program will ask for confirmation. Type
y
and pressEnter
. -
Wait for the flashing process to complete.
-
Turn off the robot:
husarion@10.15.20.2:~$sudo shutdown now
-
Remove the USB drive, then turn on the robot.
-
Access the Built-in Computer (remember, you must be connected to the Panther hotspot):
user@mylaptop:~$ssh husarion@10.15.20.2
-
Launch the software:
husarion@10.15.20.2:~$docker compose pull
docker compose up -d
Next steps
- After reinstalling the system, it is recommended to update the SSH key on the RUTX11 router. Instructions can be found here.
- You can go through How To Start to check if everything is behaving correctly.