This software package provides a C++ interface to communicate with the mobile platforms from Weston Robot and AgileX Robotics, for sending commands to the robot and receiving the latest robot state. The repository is a joint effort by the development teams at Weston Robot (Singapore) and AgileX Robotics (China).

• Copyright (c) 2020 Weston Robot
• Copyright (c) 2020 AgileX Robotics

Please create an issue on Github at https://github.com/westonrobot/ugv_sdk/issues if you encounter any problems when using the packages.

Supported robot platforms

• Scout
• Scout Mini
• Hunter
• Tracer
• Bunker
• Ranger Mini

Supported environments

• Architecture: x86_64/arm64
• OS: Ubuntu 16.04/18.04/20.04
• ROS: Kinetic/Melodic/Noetic

It should also work in other similar Linux environments but only the above listed environments are regularly tested.

Communication protocol

Important Note: Currently we're transitioning the communication protocol from version 1 to version 2. Please check with Weston Robot or AgileX Robotics to confirm which version your robot is using.

• V1 Protocol: master branch of scout_ros and ugv_sdk
• V2 Protocol: v2.x branch of scout_ros and ugv_sdk

$ sudo apt-get update
$ sudo apt-get install build-essential git cmake libasio-dev

$ cd <your-catkin-ws>/src
$ git clone -b next https://github.com/westonrobot/ugv_sdk.git
$ cd ..
$ catkin_make

1. Enable gs_usb kernel module

   $ sudo modprobe gs_usb
   

2. Bringup can device

   $ sudo ip link set can0 up type can bitrate 500000
   

3. If no error occured during the previous steps, you should be able to see the can device now by using command

   $ ifconfig -a
   

4. Install and use can-utils to test the hardware

   $ sudo apt install can-utils
   

5. Testing command

   # receiving data from can0
   $ candump can0
   # send data to can0
   $ cansend can0 001#1122334455667788
   

Two scripts inside the "./scripts" folder are provided for easy setup. You can run "./setup_can2usb.bash" for the first-time setup and run "./bringup_can2usb.bash" to bring up the device each time you unplug and re-plug the adapter.

You can find demo code for each robot in "demo" folder. For example, run the demo for Scout robot

$ ./bin/demo_scout_robot can0

• CAN command reference in Linux