ROS Packages for Scout Mobile Robot

Packages

This repository contains minimal packages to control the scout robot using ROS.

scout_bringup: launch and configuration files to start ROS nodes
scout_base: a ROS wrapper around ugv_sdk to monitor and control the scout robot
scout_description: URDF model for the mobile base, a sample urdf (scout_description/sample/scout_v2_nav.xacro) is provided for customized robot with addtional sensors
scout_msgs: scout related message definitions

Update the packages for your customized robot

Additional sensors

It's likely that you may want to add additional sensors to the scout mobile platform, such as a Lidar for navigation. In such cases, a new ".xacro" file needs to be created to describe the relative pose of the new sensor with respect to the robot base, so that the sensor frame can be reflected in the robot tf tree.

A sample ".xacro" file is present in this repository, in which the base ".xacro" file of an empty scout platform is first included, and then additional links are defined.

The nodes in this ROS package are made to handle only the control of the scout base and publishing of the status. Additional nodes may need to be created by the user to handle the sensors.

Alternative odometry calculation

By default the scout_base package will publish odometry message to topic "/odom". In case you want to use a different approach to calculate the odometry, for example estimating the position together with an IMU, you could rename the default odometry topic to be something else.

$ roslaunch scout_bringup scout_base_robot.launch odom_topic_name:="<custom_name>"

Communication interface setup

Please refer to the README of "ugv_sdk" package for setup of communication interfaces.

Note on CAN interface on Nvidia Jetson Platforms

Nvidia Jeston TX2/Xavier/XavierNX have CAN controller(s) integrated in the main SOC. If you're using a dev kit, you need to add a CAN transceiver for proper CAN communication.

Basic usage of the ROS packages

Install dependent libraries

$ sudo apt install -y libasio-dev
$ sudo apt install -y ros-$ROS_DISTRO-teleop-twist-keyboard

Clone the packages into your catkin workspace and compile

(the following instructions assume your catkin workspace is at: ~/catkin_ws/src)

$ cd ~/catkin_ws/src
$ git clone https://github.com/agilexrobotics/ugv_sdk.git  
$ git clone https://github.com/agilexrobotics/scout_ros.git
$ cd ..
$ catkin_make

Setup CAN-To-USB adapter

Enable gs_usb kernel module(If you have already added this module, you do not need to add it)
```
$ sudo modprobe gs_usb
```

first time use scout-ros package

$ rosrun scout_bringup setup_can2usb.bash

if not the first time use scout-ros package(Run this command every time you turn off the power)
```
$ rosrun scout_bringup bringup_can2usb.bash
```

Testing command

# receiving data from can0
$ candump can0

Launch ROS nodes