Skip to content

Latest commit

 

History

History
179 lines (105 loc) · 4.82 KB

README_CN.md

File metadata and controls

179 lines (105 loc) · 4.82 KB

1 rslidar_sdk

English Version

1.1 工程简介

rslidar_sdk 是速腾聚创在Ubuntu环境下的雷达驱动软件包。它包括:

  • 雷达驱动内核rs_driver
  • ROS拓展功能,
  • ROS2拓展功能

如果希望基于ROS/ROS2进行二次开发,可以使用本软件包。配合ROS/ROS2自带的可视化工具rviz,可以查看点云。

如果希望将雷达驱动集成到自己的工程,作更深一步的二次开发,请基于rs_driver进行开发。

1.1.1 支持的雷达型号

  • RS-LiDAR-16
  • RS-LiDAR-32
  • RS-Bpearl
  • RS-Helios
  • RS-Helios-16P
  • RS-Ruby-128
  • RS-Ruby-80
  • RS-Ruby-48
  • RS-Ruby-Plus-128
  • RS-Ruby-Plus-80
  • RS-Ruby-Plus-48
  • RS-LiDAR-M1
  • RS-LiDAR-M2
  • RS-LiDAR-M3
  • RS-LiDAR-E1
  • RS-LiDAR-MX

1.1.2 支持的点类型

  • XYZI - x, y, z, intensity
  • XYZIRT - x, y, z, intensity, ring, timestamp

1.2 下载

1.2.1 使用 git clone

rslidar_sdk项目包含子模块驱动内核rs_driver。在执行git clone后,还需要执行相关指令,初始化并更新子模块。

git clone https://github.com/RoboSense-LiDAR/rslidar_sdk.git
cd rslidar_sdk
git submodule init
git submodule update

1.2.2 直接下载

用户可以直接访问 rslidar_sdk_release 下载最新版本的rslidar_sdk.

请下载 rslidar_sdk.tar.gz 压缩包,不要下载Source code。因为Source code压缩包内不包含子模块rs_driver的代码, 用户还需自行下载rs_driver的代码放入其中才行。

1.3 依赖介绍

1.3.1 ROS

在ROS环境下使用雷达驱动,需要安装ROS相关依赖库。

  • Ubuntu 16.04 - ROS Kinetic desktop
  • Ubuntu 18.04 - ROS Melodic desktop
  • Ubuntu 20.04 - ROS Noetic desktop

安装方法请参考 http://wiki.ros.org。

强烈建议安装ROS desktop-full版。这个过程会自动安装一些兼容版本的依赖库,如PCL库等。这样可以避免花大量时间,去逐个安装和配置它们

1.3.2 ROS2

在ROS2环境下使用雷达驱动,需要安装ROS2相关依赖库。

  • Ubuntu 16.04 - 不支持
  • Ubuntu 18.04 - ROS2 Eloquent desktop
  • Ubuntu 20.04 - ROS2 Galactic desktop
  • Ubuntu 22.04 - ROS2 Humble desktop

安装方法请参考 https://index.ros.org/doc/ros2/Installation/Eloquent/Linux-Install-Debians/

请不要在一台电脑上同时安装ROS和ROS2,以避免可能的版本冲突,和手工安装其他库(如Yaml)的麻烦。

1.3.3 Yaml (必需)

版本号: >= v0.5.2

若已安装ROS desktop-full, 可跳过

安装方法如下:

sudo apt-get update
sudo apt-get install -y libyaml-cpp-dev

1.3.4 libpcap (必需)

版本号: >= v1.7.4

安装方法如下:

sudo apt-get install -y  libpcap-dev

1.4 编译、运行

1.4.1 依赖于ROS-catkin编译

(1) 新建一个文件夹作为工作空间,然后再新建一个名为src的文件夹, 将rslidar_sdk工程放入src文件夹内。

(2) 返回工作空间目录,执行以下命令即可编译&运行(若使用.zsh,将第二句指令替换为 source devel/setup.zsh)。

catkin_make
source devel/setup.bash
roslaunch rslidar_sdk start.launch

1.4.2 依赖于ROS2-colcon编译

(1) 新建一个文件夹作为工作空间,然后再新建一个名为src的文件夹, 将rslidar_sdk工程放入src文件夹内。

(2) 通过链接,下载ROS2环境下的雷达packet消息定义,将rslidar_msg工程也放在刚刚新建的src文件夹内,与rslidar_sdk并列。

(3) 返回工作空间目录,执行以下命令即可编译、运行。如果使用.zsh,将第二行替换为source install/setup.zsh

colcon build
source install/setup.bash
ros2 launch rslidar_sdk start.py

不同ROS2版本start.py的格式可能不同,请使用对应版本的start.py。如ROS2 Elequent,请使用elequent_start.py。

1.5 参数介绍

rslidar_sdk的功能通过配置参数文件来实现,请仔细阅读。

参数介绍

隐藏参数介绍

1.6 快速上手

以下是一些常用功能的使用指南。

连接在线雷达数据并发送点云到ROS

解析PCAP包并发送点云到ROS

切换点类型

1.7 使用进阶

在线雷达-高级主题

PCAP文件-高级主题

点云坐标变换

录制ROS数据包然后播放它