Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CentraleNantesRobotics/ping360_sonar
ROS package for Blue Robotics Ping360 Sonar
https://github.com/CentraleNantesRobotics/ping360_sonar
Last synced: about 1 month ago
JSON representation
ROS package for Blue Robotics Ping360 Sonar
- Host: GitHub
- URL: https://github.com/CentraleNantesRobotics/ping360_sonar
- Owner: CentraleNantesRobotics
- License: mit
- Created: 2019-11-14T11:38:46.000Z (about 5 years ago)
- Default Branch: ros2
- Last Pushed: 2023-04-24T08:06:59.000Z (over 1 year ago)
- Last Synced: 2024-08-01T22:52:35.278Z (4 months ago)
- Language: C++
- Homepage: http://wiki.ros.org/ping360_sonar
- Size: 1.72 MB
- Stars: 32
- Watchers: 4
- Forks: 22
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-morocco - ping360_sonar - ROS package for Blue Robotics Ping360 Sonar by [@Stormix](https://github.com/Stormix) (Uncategorized / Uncategorized)
README
# ping360_sonar
[](https://GitHub.com/CentraleNantesRobotics/ping360_sonar/stargazers/)
[](https://GitHub.com/CentraleNantesRobotics/ping360_sonar/network/)
[](https://GitHub.com/CentraleNantesRobotics/ping360_sonar/)
[](https://GitHub.com/CentraleNantesRobotics/ping360_sonar/issues/)
[](https://github.com/CentraleNantesRobotics/ping360_sonar/blob/master/LICENSE)
[](https://GitHub.com/CentraleNantesRobotics/ping360_sonar/releases/)
[](https://GitHub.com/CentraleNantesRobotics/ping360_sonar/releases/)
[](#contributors-)
## Overview
A ROS 2 package for the [BlueRobotics] [Ping360] Sonar. This code is being developped for Foxy.
**Keywords:** ROS 2, ping360
### License
The source code is released under a [MIT license](LICENSE).
## Installation
### Building from Source
#### Dependencies
- [Robot Operating System (ROS) 2](http://wiki.ros.org) (middleware for robotics),
- [deployment branch of ping-cpp](https://github.com/GSO-soslab/ping-cpp.git), for the C++ node as a submodule
- [deployment branch of ping-python](https://github.com/bluerobotics/ping-python), for the Python node as a package to install
- [image_transport](http://wiki.ros.org/image_transport) for the C++ node
#### Building
Clone with `--recursive` in order to get the necessary `ping-cpp` library:
cd ros2_workspace/src
git clone https://github.com/CentraleNantesRobotics/ping360_sonar.git -b ros2 --recursive
cd ../..
colcon build --symlink-install --packages-select ping360_sonar
## Nodes
The package provides both C++ and Python nodes, they share the same ROS API and expose the same capabilities.
- C++ version: `ros2 run ping360_sonar ping360_node`
- Python: `ros2 run ping360_sonar ping360.py`
While continuously rotating the sonar in a set field of view (defined by the min and max angle parameters in gradians), it may publishes three types of messages:
- The raw response data (the echo intensities for a given angle & range)
- A LaserScan msg with ranges detected using a certain intensity threshold:
- A black and white image using the data received from the sonar. Same as the one generated by the ping viewer.
The rotation of the sonar is only limited by the maximum range (hence the echo maximum duration). Images are updated at this rate even if they are actually published at a lower rate.
## Published Topics
* **`scan_image`** ([sensor_msgs/Image])
The generated sonar image in gray level. Each pixel is filled depending on the range and angular step of the sonar.
This topic can be toggled using the **publish_image** parameter. The C++ node uses [image_transport](http://wiki.ros.org/image_transport) while the Python one publishes raw images.
* **`echo`** ([msg/SonarEcho])
Publishes the raw sonar data in a custom message:
Header header #header info
float32 angle # the measurement angle [rad]
uint8 gain # Sonar Gain
uint16 number_of_samples
uint16 transmit_frequency # [kHz]
uint16 speed_of_sound # [m/s]
uint8 range # range value [m]
uint8[] intensities # intensity data [0-255]. This is the actual data received from the sonar
This topic can be toggled using the **publish_echo** parameter.
* **`scan`** ([sensor_msgs/LaserScan])
Publishes a LaserScan msg with ranges detected above a certain intensity threshold (0-255). The intensities of the message are scaled down to (0,1).
This topic can be toggled using the **publish_scan** parameter.
## Parameters
The list below corresponds to the output of `ros2 param describe` for all `ping360` parameters:
- `angle_sector`
- Type: integer
- Description: Scanned angular sector around sonar heading [degrees]. Will oscillate if not 360
- Default value: 360 [60..360]
- `angle_step`
- Type: integer
- Description: Sonar angular resolution [degrees]
- Default value: 1 [1..20]
- `baudrate` (only used in serial connection)
- Type: integer
- Default value: 115200
- `connection_type`
- Type: string
- Description: Indicates if connection is serial or udp
- Default value: serial
- `device` (only used in serial connection)
- Type: string
- Default value: /dev/ttyUSB0
- `fallback_emulated`
- Type: boolean
- Description: Emulates a sonar if Ping360 cannot be initialized
- Default value: True
- `frame`
- Type: string
- Description: Frame ID of the message headers
- Default value: sonar
- `frequency`
- Type: integer
- Description: Sonar operating frequency [kHz]
- Default value: 740 [650..850]
- `gain`
- Type: integer
- Description: Sonar gain (0 = low, 1 = normal, 2 = high)
- Default value: 0 [0..2]
- `image_rate`
- Type: integer
- Description: Image publishing rate [ms]
- Default value: 100 [50..2000]
- `image_size`
- Type: integer
- Description: Output image size [pixels]
- Default value: 300 [100..2..1000]
- `publish_echo`
- Type: boolean
- Description: Publish raw echo on 'scan_echo'
- Default value: False
- `publish_image`
- Type: boolean
- Description: Publish images on 'scan_image'
- Default value: True
- `publish_scan`
- Type: boolean
- Description: Publish laserscans on 'scan'
- Default value: False
- `range_max`
- Type: integer
- Description: Sonar max range [m]
- Default value: 2 [1..50]
- `scan_image.format`
- Type: string
- Description: Compression method
- Default value: jpeg
- `scan_image.jpeg_quality`
- Type: integer
- Description: Image quality for JPEG format
- Default value: 95 [1..100]
- `scan_image.png_level`
- Type: integer
- Description: Compression level for PNG format
- Default value: 3 [0..9]
- `scan_threshold`
- Type: integer
- Description: Intensity threshold for LaserScan message
- Default value: 200 [1..255]
- `speed_of_sound`
- Type: integer
- Description: Speed of sound [m/s]
- Default value: 1500 [1450..1550]
- `sonar_timeout`
- Type: integer
- Description: Sonar timeout [ms]
- Default value: 8000 [0...20000]
- `udp_address` (only used in udp connection)
- Type: string
- Default value: 0.0.0.0
- `udp_port` (only used in udo connection)
- Type: integer
- Default value: 12345
Most the parameters can be updated during execution, except `baudrate`, `device`, `frame`, `image_rate` and `fallback_emulated`.
## Bugs & Feature Requests
Please report bugs and request features using the [Issue Tracker](https://github.com/CentraleNantesRobotics/ping360_sonar/issues).
[ROS]: http://www.ros.org
[BlueRobotics]: http://bluerobotics.com
[Ping360]: https://bluerobotics.com/store/sensors-sonars-cameras/sonar/ping360-sonar-r1-rp/
[Image transport]: http://wiki.ros.org/image_transport
[msg/SonarEcho]: /msg/SonarEcho.msg
[sensor_msgs/LaserScan]: https://github.com/ros2/common_interfaces/blob/master/sensor_msgs/msg/LaserScan.msg
## Contributors
Olivier Kermorgant
💻 ⚠️
Henrique Martinez Rocamora
💻 ⚠️
Anas Mazouni
💻 ⚠️
tomlogan501
🤔 ⚠️ 🐛
Alexis Fetet
💻 ⚠️
Jonathan Delacoux
💻 ⚠️
Gustavo Rezende
💻 ⚠️🐛
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification.
Contributions of any kind welcome! Please refer to our [Contribution Guide](CONTRIBUTING.md)