Skip to main content

Installing Husarion OS

Husarion OS images can be obtained for many different computer platforms and single board computers, such as the Raspberry Pi 4, Raspberry Pi 5, UP Board, Intel NUC and Lenovo ThinkStation P360 Tiny.

These computer platforms are used across Husarion robots:

RobotSupported Computers
Panther / LynxIntel NUC, Lenovo ThinkStation P360 Tiny
ROSbot XLIntel NUC, RPi 5, RPi 4
ROSbot 3RPi 5
ROSbot 2RRPi 4
ROSbot 2 PROUP Board
Panther Built-in Computer

To reinstall Panther Built-in Computer follow this guide.

DO NOT install Husarion OS on a Built-in Computer in Panther!

To acquire the appropriate operating system image for your SBC and complete the initial setup for your Husarion robot, please adhere to the instructions provided below.

Installing the Husarion OS​

Select from the available platforms:

Intel NUC for ROS

warning

For Intel NUC single-board computers (version 13), the built-in Wi-Fi may not work initially due to missing drivers in the default Linux kernel. This happens because older kernels may lack support for the latest Wi-Fi hardware. To resolve this on Husarion OS, install the necessary hardware enablement (HWE) kernel package and reboot:

sudo apt update
sudo apt install linux-generic-hwe-22.04
sudo reboot now

  1. Download one of the following images

  2. Flash the image onto the SSD disk

    Follow the steps in Husarion OS Flasher section to flash the image onto the SSD disk.

    If you want to write image directly onto the SSD disk, use Etcher to write the selected OS image onto the SSD disk and then plug the SSD disk into the appropriate slot in your Intel NUC computer.

    for ROS Noetic only

    It may be necessary to turn off "Secure Boot" in your NUC's BIOS settings. Follow the steps below:

    2.1 Power on your NUC and press the F2 key. 2.2 Navigate to the "Boot" tab. 2.3 Select and change the "Secure Boot" option to "Disabled".

Setup Guide​

This step adds configuration files, including compose.yaml necessary to run the ROSbot.

  1. Connect Hardware

    Plug your ROSbot into a display via HDMI, and attach a mouse and keyboard to the USB ports for easier configuration.

  2. Open the Terminal

    Once booted, launch the Application Launcher (click on the Husarion logo in the top-left corner of the screen) and navigate to System Tools > Terminator app. Alternatively, use the keyboard shortcut Ctrl + Alt + T to open a terminal quickly.

    Operaing system GUI

  3. Run the Setup Command

    Execute the command below with the corresponding command line arguments, based on the Husarion robot you are using:

    sudo setup_robot_configuration <robot_model> <ros_version>

    Examples:

    Your RobotCommand to execute
    ROSbot XLsudo setup_robot_configuration rosbot_xl
    ROSbot 2Rsudo setup_robot_configuration rosbot_2r
    ROSbot 2 PROsudo setup_robot_configuration rosbot_2_pro
    Description of setup_robot_configuration arguments

    <robot_model> options​

    • rosbot_xl if you are using ROSbot XL
    • rosbot_2r if you are using ROSbot 2R
    • rosbot_2_pro if you are using ROSbot 2 PRO

    <ros_version> options (optional)​

    For ROS 2 Humble, Vulcanexus Humble, and ROS Noetic OS images, this parameter is detected automatically and can be omitted.

    • ros_noetic
    • ros2_humble
    • vulcanexus_humble

Proceeding Steps​

With operating system image configured your ROSbot is like brand new. Follow our quick start guides for ROSbot XL or ROSbot 2R / 2 PRO to finish configuration.