Lynx - quick start
Lynx is a compact and robust Unmanned Ground Vehicle (UGV) platform designed for seamless operation in both indoor and outdoor environments. Featuring an IP54/66-rated, rugged alloy chassis, Lynx withstands harsh conditions while measuring just 54 cm in width—allowing it to navigate tight spaces and standard doorways effortlessly. Its modular design includes a hot-swappable battery system and a customizable user compartment, allowing users to tailor the robot to their specific needs without overcomplicating the setup. Lynx facilitates the integration of LIDARs, 3D cameras, manipulators, and other components through its T-slot mounting rail, accessible power ports, and extensive communication interfaces. Supported by open-source ROS 2 driver and a comprehensive suite of software examples, Lynx simplifies the development process for your product or research project.
If you don't have Lynx yet, you can get it from the online store.
This is a quick-start guide. If you need a manual instead, you can find it here
Instructions found in this guide do not account for installing a robotic arm on top of your Lynx platform. Please follow the Manipulator chapter instead, since it contains additional steps regarding your safety.
Quick Demo
We know that you would really like to read the Quick Demo section now, but your safety is the most important thing.
A brief safety information
- Please read the Safety instructions first.
- If you are not sure how something works, please read the Lynx manual.
- Please remember that the mechanical Emergency Button is available on the robot as well as software one in the WebUI (on the screen) and the Gamepad, but in some cases, you may not be able to use them quickly enough to stop the robot before causing damage.
- A detailed description of the safety features is available in the Safety section.
Here is a very basic demo that allows you to use your Lynx for the first time without coding:
Rotate the two-position Main Switch to the ON position. Push the Power Button for 1 second, a red light on the Power Button, and the LED panels on the Bumpers (called Bumper Lights) will light up. Wait for Wi-Fi to come up:
SSID: Lynx_<serial_number>
PASS: husarion
Connect to robot Wi-Fi and open the WebUI joystick available in your browser at 10.15.20.2:8080/ui. It allows you to manually control your robot and manage the E-stop.
Use the WebUI joystick carefully, as Panther is quite a heavy robot with powerful motors. Especially during a first run, be prepared to push the Emergency Button rapidly if needed.
Connecting Husarion UGV to Wi-Fi Network
To use Wi-Fi effectively, an active Internet connection is required. The robot comes with a built-in router, allowing you to configure it as a Wi-Fi client. This setup enables the router to connect to an external network and share Internet access with all devices on the local network (LAN).
RUTX11
To begin configuring the Wi-Fi network, first connect to the robot's network. The network name follows the format <robot-name>_<serial-number>
(e.g., panther_r2d2
). Next, open a web browser and navigate to http://10.15.20.1. Log in using the following credentials:
- Username:
admin
- Password:
Husarion1
After logging in, you will see the router configuration panel. This manual is based on firmware version RUTX_R_00.07.06.1
, which is the default version for this router.
To connect to a Wi-Fi network, navigate to Network → Wireless → SSIDs. Next edit Multi AP SSID.
Under the Access Points section, click Add, then configure the SSID and Password of your WiFi network. You can add multiple WiFi networks.
Save & Apply the configuration.
Wait for the network to connect. The Status should change to connected.
If you encounter any issues with network connection please refer to official RUTX11 Manual
Remote Access
OPTION 1: In a Local Network
Use a SSH connection at your PC that is connected to the hotspot provided by Lynx:
ssh husarion@10.15.20.2
The default password for user husarion
is also husarion
.
OPTION 2: Over The Internet (VPN)
If LAN access is not enough, you can access your Lynx over the Internet from anywhere in the world with Husarnet. First, you should connect Lynx to your internal Wi-Fi network, as described in the previous paragraph.
Once your Lynx is connected to your network, you can proceed to configure Husarnet. A full guide on how to do this is here.
Lynx ROS Packages
At this stage, your Lynx should be up and running, with a remote connection (either LAN or VPN) established from your laptop. Lynx is equipped with preinstalled ROS packages within Docker containers, which are set to launch automatically upon boot. For more information on Lynx's ROS system, please refer to Software Guide.
ROS nodes running in the containers are accessible at the host operating system level.
Check available ROS topics:
ros2 topic list
The complete architecture of the Lynx ROS 2 software is detailed in the Lynx ROS 2 API documentation.
You can run Lynx's ROS packages natively on your Lynx's host OS, by removing Docker containers, cloning, and building the husarion_ugv_ros repository. However, it is recommended to use Docker images for this purpose.
Updating Basic Docker Images for Lynx
Lynx ROS packages are frequently updated to improve Lynx performance or include new features. To update them to the latest version, first, check the latest stable Docker image version at husarion/panther. An example tag could be: humble
.
Then access your Lynx's terminal and edit the main compose file:
nano ~/compose.yaml
Update the Docker tag:
lynx_ros:
image: husarion/panther:<newest-stable-tag> # example tag: humble
Restart the Docker containers to apply the changes:
docker compose up -d --force-recreate
Reference Projects
Now you know how to access Lynx's ROS nodes from the Linux terminal.
Running ROS natively is fine for relatively small projects. For more complex ones, the full dockerized setup is a better approach.
Next demos start Lynx's Docker containers in different configurations, so remember to stop the basic setup at first:
docker compose down