whill

About

The “whill” is a ROS2 package for WHILL Model CR2.

<img width=22% title=”WHILL Model CR2” src=”https://github.com/WHILL/Model_CR_Technical_Support/assets/129816934/387a8aac-3808-4727-895d-9857059ee342”> <img width=24% title=”Wheeled Robot Base” src=”https://github.com/WHILL/Model_CR_Technical_Support/assets/129816934/6a63ed45-9e0c-40ca-b71c-8dff614af141”>

We also have Model CR Series Technical Support for current and potential Model CR series users.

Attention:
This package on humble branch only provides common functions for all models.
If you want to use features that are only available in WHILL Model CR, you will need to use crystal-devel branch.

Requirements

• Host device
  • Linux OS: Ubuntu 22.04
  • ROS2: Humble Hawksbill (humble)
• Target device
  • WHILL Model CR2 (Note that Model C2 does not have any serial ports)

Getting started

1. Download projects
2. Configure your serial port
3. Build project
4. Launch
   4-(A). With the bringup package
   4-(B). With ‘run’ command
   

1. Download projects

cd ~/<your_ros2_ws>/src
git clone https://github.com/whill-labs/ros2_whill_interfaces.git
git clone https://github.com/whill-labs/ros2_whill.git

2. Configure your serial port

If your serial port is not /dev/ttyUSB0, please edit port_name in the following file:

~/<your_ros2_ws>/src/ros2_whill/whill_bringup/config/params.yaml

3. Build project

colcon build --packages-up-to whill
. install/setup.bash

4. Launch

(A) With the bringup package

ros2 launch whill_bringup whill_launch.py

(B) With ‘run’ command

ros2 run whill_driver whill

Note: If your serial port is not /dev/ttyUSB0, for example /dev/ttyUSB1, please run the following command instead of the one above:

ros2 run whill_driver whill --ros-args -p port_name:=/dev/ttyUSB1

ROS2 APIs

Publish

Subscription

Service

File truncated at 100 lines see the full file