husarion_ugv_configurator

The Husarion UGV Configurator is a Text User Interface (TUI) application designed to simplify the management and configuration of Husarion UGV platforms, including Panther and Lynx. It provides an intuitive interface for updating robot parameters, managing driver versions, debugging, and more.

Installation

Clone this repository:

git clone https://github.com/husarion/husarion_ugv_configurator.git

Install the Husarion UGV Configurator app. You have to be connected to the robot during this porcess. You may be asked to provide passowrd to the Built-in Computer, the default is husarion.

cd husarion_ugv_configurator
just install

Running Husarion UGV Configurator TUI

just husarion_ugv_configurator

Using standalone just commands

Suggested way of using the configurator is with the husarion_ugv_configurator application. This section describes some of the available just that are used by the application, but can be also used as a standalone commands.

You can list all available commands with:

just --list

Initializing configuration

To initialize the configuration, run (you will be asked for password, default: husarion):

just init_config

Modifying configuration

Edit files inside the config directory, then apply changes to the driver.

just update_config
just restart_driver

Restore default configuration

This command will overwrite all files in the config directory to their default state for the currently running driver version.

just restore_default

To completely erase all changes made to the config directory (except for files located in config/common), use the restore command with hard mode:

just restore_default hard

Warning

This will completely erase all data from the config directory except for files located in the config/common subdirectory.

Update driver version

List available stable driver versions:

just list_driver_versions
# To list for a specific ROS distro
just list_driver_versions humble

Choose the newest tag and update the driver:

just update_driver_version <tag>
# Example
just update_driver_version humble-2.1.2-20241125

Debug driver

Logs from the driver can be seen using following command:

just driver_logs

To follow the output.

just driver_logs -f