Setting Up Husky’s Network¶
Husky is normally equipped with a combination Wifi + Bluetooth module, such as the Intel Centrino Advanced-N 6235. If this is your first unboxing, ensure that Husky’s wireless antennas are firmly screwed on to the chassis.
Some Husky robots may only be equipped with a single antenna, depending on the exact model of PC installed in the robot.
By default, Husky’s wireless is in client mode, looking for the wireless network at the Clearpath factory. In
order to set it up to connect to your own network, you’ll have to connect an ethernet cable to the Husky’s PC and connect
the other end to your laptop. Configure your laptop to have a static IP address on the
192.168.131.x subnet, e.g.
192.168.131.100. Then, make the connection to Husky’s default static IP:
The default password is
clearpath. You should now be logged into Husky as the administrator user.
Changing the Default Password¶
All Clearpath robots ship from the factory with their login password set to
clearpath. Upon receipt of your
robot we recommend changing the password.
To change the password to log into your robot, run the
command. This will prompt you to enter the current password, followed by the new password twice. While typing the
passwords in the
passwd prompt there will be no visual feedback (e.g. “*” characters).
To further restrict access to your robot you can reconfigure the robot’s SSH service to disallow logging in with a password and require SSH certificates to log in. This tutorial covers how to configure SSH to disable password-based login.
Connecting to Wifi Access Point¶
netplan for configuring its wired and wireless interfaces. To connect Husky to your wireless network,
create the file
/etc/netplan/60-wireless.yaml and fill in the following:
network: wifis: # Replace WIRELESS_INTERFACE with the name of the wireless network device, e.g. wlan0 or wlp3s0 # Fill in the SSID and PASSWORD fields as appropriate. The password may be included as plain-text # or as a password hash. To generate the hashed password, run # echo -n 'WIFI_PASSWORD' | iconv -t UTF-16LE | openssl md4 -binary | xxd -p # If you have multiple wireless cards you may include a block for each device. # For more options, see https://netplan.io/reference/ WIRELESS_INTERFACE: optional: true access-points: SSID_GOES_HERE: password: PASSWORD_GOES_HERE dhcp4: true dhcp4-overrides: send-hostname: true
Once configured, run
sudo netplan apply
to bring up your wireless connection. Running
ip a will show all active connections and their IP addresses.
Remote ROS Connection¶
To use ROS desktop tools, you’ll need your computer to be able to connect to Husky’s ROS master. This can be a tricky process, but we’ve tried to make it as simple as possible.
In order for the ROS tools on your computer to talk to Husky, they need to know two things:
How to find the ROS master, which is set in the
ROS_MASTER_URIenvironment variable, and
How processes on the other computer can find your computer, which is the
The suggested pattern is to create a file in your home directory called
remote-husky.sh with the following
export ROS_MASTER_URI=http://cpr-husky-0001:11311 # Husky's hostname export ROS_IP=10.25.0.102 # Your laptop's wireless IP address
If your network doesn’t already resolve Husky’s hostname to its wireless IP address, you may need to add
a corresponding line to your computer’s
Then, when you’re ready to communicate remotely with Husky, you can source that script like so, thus defining those two key environment variables in the present context.
Now, when you run commands like
rosnode list, and others, the output
you see should reflect the activity on Husky’s ROS master, rather than on your own machine. Once you’ve
verified the basics (list, echo) from the prompt, try launching some of the standard visual ROS tools:
roslaunch husky_viz view_robot.launch rosrun rqt_robot_monitor rqt_robot_monitor rosrun rqt_console rqt_console
If there are particular rqt widgets you find yourself using a lot, you may find it an advantage to dock them together and then export this configuration as the default RQT perspective. Then, to bring up your standard GUI, you can simply run: