ROS packages for working with Toposens 3D ultrasonic sensors. Developed and tested for ROS Kinetic on Ubuntu 16.04 (Xenial) and ROS Melodic on Ubuntu 18.04 (Bionic).

Detailed documentation for the packages along with a set of tutorials on using them with Toposens sonars can be found on our the ROS Wiki page: http://wiki.ros.org/toposens

Setup ROS

This section is for users who are new to ROS (Robot Operating System) and need guidance in setting up their initial environment.

• Install ROS on your machine:

  • For Ubuntu 16.04 (Xenial): http://wiki.ros.org/kinetic/Installation/Ubuntu

  * For Ubuntu 18.04 (Bionic): http://wiki.ros.org/melodic/Installation/Ubuntu

• Install catkin tools:

  sudo apt install python-catkin-tools

• Setup your catkin workspace:

  mkdir -p ~/catkin_ws/src && cd ~/catkin_ws && catkin init

Our tutorials assume that you use catkin tools instead of the older catkin_make commands. If you are more comfortable with the latter, simply switch all occurrences of catkin build in the documentation with catkin_make_isolated. If you are ready to switch an existing workspace that was previously built with catkin_make, call catkin clean to enable builds with catkin tools.

Tutorials

• Getting Started with the TS3

• Using Multiple TS3 Sensors

• Use a TS3 Sensor for Mapping with a TurtleBot3

• Getting Started with the TS3 on a Raspberry Pi

Code API

Doxygen results for all packages are stored on the ROS Docs server:

• toposens_msgs
• toposens_driver
• toposens_markers
• toposens_pointcloud
• toposens_sync

Get Involved

Contribute to this open source project by submitting feature requests, reporting bugs and extending the packages with your own ideas. Open up a topic on our issue tracker to start a discussion with the admins.

Note that this repository conforms to best practices adopted by the ROS community. Please check your contributions against these community guidelines to ensure uniformity across the codebase:

• Use Patterns and Best Practices
• Developer's Guide
• Coding Style Guide