RoboSense RS-LiDAR-M1 User Manual Download Page 36

 

·

 

RS-LiDAR-M1 User Guide 

secondary  development  needs,  or  users  who  want  to  directly  use  ROS  or  ROS2  for 
secondary development, can directly use this software package to view the point cloud 
with the RVIZ visualization tool that comes with ROS or ROS2. For users who have further 
secondary  development  needs  and  want  to  integrate  the  LiDAR  driver  into  their  own 
projects, please refer to the relevant documentation of the LiDAR driver kernel and directly 
use the kernel rs_driver for secondary development. 

You can download the rsliar_sdk.tar.gz package from our official account on GitHub: 
https://github.com/RoboSense-LiDAR/rslidar_sdk/releases 

 

Note: Downloading the source code will not include the rs_driver parsing kernel, 

users need to download and add it manually.   

B.2.1 Install Dependent Libraries   

 

B.2.1.1 ROS Environment   

To use the LiDAR driver in ROS environment, users need to install ROS related dependent 
libraries 
Ubuntu 16.04 - ROS kinetic desktop-full 
Ubuntu 18.04 - ROS melodic desktop-full 
Installation method: refer to http://wiki.ros.org 
If  ROS  kinetic  desktop-full  or  ROS  melodic  desktop-full  is  installed,  other  dependent 
libraries of compatible versions should also be installed at the same time, so there is no 
need to reinstall them to avoid problems caused by multiple version conflicts. Therefore, 
it is strongly recommended to install the desktop-full version, which will save a lot of time 
to install and configure the libraries one by one. 

B.2.1.2 ROS2 Environment 

To  use  the  LiDAR  driver  in  ROS2  environment,  users  need  to  install  ROS2  related 
dependent libraries 
Ubuntu 16.04 - not supported 
Ubuntu 18.04 - ROS2 Eloquent desktop 
Installation  method:  refer  to  https://index.ros.org/doc/ros2/Installation/Eloquent/Linux-
Install-Debians/ 

Note: Please avoid installing ROS and ROS2 on the same computer at the same time, 
this may cause conflicts! You also need to install the Yaml library manually. 

B.2.2 Compile and Run rslidar_sdk 

rslidar_sdk can be compiled and run in three different ways. 

B.2.1.1 Direct Compilation 

Follow the instructions below, users can directly compile and run the program. Direct 

Summary of Contents for RS-LiDAR-M1

Page 1: ...RS LiDAR M1 User Guide Executive Standard Q RS 001 2021 User Guide...

Page 2: ...l FOV footnote MSOP data definition Add types of Interface Box in Section 3 1 Add Section 3 2 State Machine of LiDAR Add Chapter 4 Time Synchronization Update Appendix D Dimension Revise some improper...

Page 3: ...5 4 2 Use Linuxptp tool to verify time synchronization 16 4 3 GPS Time Synchronization 19 Appendix A RSView 21 A 1 Software Features 21 A 2 Install RSView 21 A 3 Set Up Network 21 A 4 Visualization of...

Page 4: ...nal space coordinates reflection intensity time stamp etc 1 The ranging capability of 150 meters is measured with the 10 NIST diffuse reflector as the target the test results may be affected by the en...

Page 5: ...equired for long hours of work 6 Storage temperature 40 C 105 C 5 The device power consumption is tested when the device is working stably and the results may be affected by external environment condi...

Page 6: ...LiDAR is initially set at the factory and the MAC address of each LiDAR is unique When using the LiDAR you need to set the computer s IP to the same network segment as the LiDAR for example 192 168 1...

Page 7: ...and time stamp The payload length of the MSOP packet is 1210 bytes which consists of a synchronization header of 32 bytes a data packet of 1175 bytes a total of 25 data blocks of 47 bytes and a tail o...

Page 8: ...mode flag 0 means dual return mode 1 N A 2 N A 3 N A 4 means strongest return 5 means last return 6 means first return time_sync_mode time synchronization mode 0x00 currently using the LiDAR internal...

Page 9: ...easurement The total number of data points in a dual return mode is twice that of a single return mode The detailed definition is as follows Table 5 Definition of data block in MSOP packet data block...

Page 10: ...0 01 ch3_azimuth 24 2 In the polar coordinate system the horizontal angle of the channel 3 points the resolution is 0 01 ch3_intensity 26 1 Reflection intensity value of the channel 3 points the valu...

Page 11: ...s chn_radius the radial distance value of the points of channel n in the polar coordinate system the resolution is 5mm chn_elevation the vertical angle of the channel n points in polar coordinate syst...

Page 12: ...annel R1 256 R2 3 256 252 1020 According to the resolution of the coordinates it is converted to meters 1020 0 005 5 10m Therefore the radial distance of this channel in the corresponding elevation an...

Page 13: ...pe LiDAR output computer read Default port number 7788 DIFOP is an output only protocol to periodically send the LiDAR serial number S N firmware version information host computer driver compatibility...

Page 14: ...V start angle 32 2 Vertical FOV end angle 34 2 6 Version Information Firmware version number of the motherboard programmable logic 36 5 Firmware version number of the motherboard programming system 41...

Page 15: ...nd the maximum value is 25 4 Return mode setting the return mode flag 0 dual return 1 N A 2 N A 3 N A 4 strongest return 5 last return 6 The first return 5 Time synchronization mode setting the defaul...

Page 16: ...et Figure 2 Image for topology of LiDAR and PC Note Figure 2 shows the topology of connection of Interface Box AN1 Currently RS LiDAR M1 has two versions of interfaces namely AN1 and AN2 supporting th...

Page 17: ...RS LiDAR M1 User Guide Connecting to LiDAR Connecting to Power Adaptor and Host Computer 3 2 State Machine of LiDAR S1 OFF Definition of State Machine S1 LiDAR OFF S2 NORMAL operation S2 NORMAL...

Page 18: ...achieve the sub second level of time synchronization precision while PTP can support sub microsecond level 2 Compared to Global Positioning System GPS PTP has advantages of lower construction and mai...

Page 19: ...ion about the accuracy of the master clock by principle If the timestamp of LiDAR point cloud deviates from the real time please check whether gPTP Grand Master clock is accurate 3 When time synchroni...

Page 20: ...re Clock should be 1 Figure 5 Check PTP hardware supporting status 3 Download and install the Linuxptp tool sudo git clone git git code sf net p linuxptp code linuxptp cd linuxptp sudo make sudo make...

Page 21: ...t least one port using this option or configuration file p dev This option is used to specify the PHC device such as dev ptp0 clock device to be used on the former Linux kernel The default is auto ign...

Page 22: ...e the file default cfg for the complete list of available options global domainNumber 0 logSyncInterval 3 syncReceiptTimeout 3 neighborPropDelayThresh 800 path_trace_enabled 1 follow_up_info 1 transpo...

Page 23: ...RS LiDAR M1 User Guide Figure 6 Topology of GPS Timing service synchronization...

Page 24: ...iles at the moment RSView displays directly the point cloud that is exchanged from the measured distance from RS LiDAR M1 It supports changing the display mode of point cloud according to XYZ coordina...

Page 25: ...e Open Sensor Stream Fig A 1 Fig A 1 Open the Sensor Stream in RSView 4 After finishing the above 3 steps the dialogue box Sensor Configuration shows up In this dialogue box the Sensor Calibration def...

Page 26: ...he Play button click again the stream continues Figure A 4 RS LiDAR M1 Sensor Stream display 7 If there is no point cloud display please click Tools and check if the MSOP and DIFOP port number are cor...

Page 27: ...to use a fast local HDD or SSD instead of a slow subsystem such as USB storage LiDAR or network drive Figure A 6 RSView record data 3 Click Record button again to stop recording pcap packets Use Wire...

Page 28: ...the red boxes represent LiDAR IP PC IP MSOP port number and DIFOP packet port number respectively Figure A 9 Wireshark at work 4 Click File at the up left corner of the window and click Save to save t...

Page 29: ...eration guide Figure A 12 Wireshark data saving A 6 Replay Recorded Sensor Data from PCAP Files The pcap file can be replayed or examined through RSView User can press the Play button to play or pause...

Page 30: ...RS LiDAR M1 then click OK button 4 Click Play button to play or pause 3D point cloud data streaming Using the Scrub tool to select the interested frame The Scrub tool and the Record button are in the...

Page 31: ...SView Spreadsheet display 7 Click Show only selected elements in the spreadsheet only the data of selected points will be displayed If no point is selected there will be no data shown in table Fig A 1...

Page 32: ...ta points The data of these points will be displayed in the Spreadsheet and these points will turn pink in the point cloud display space Figure A 20 Figure A 20 RSView List Selected Points 10 Any sele...

Page 33: ...ries rs_driver depends on the following third party libraries which need to be installed before compilation Boost Pcap PCL not required can be ignored if visualization tools are not needed Eigen3 not...

Page 34: ...eded 1 MSVC If you are going to use the MSVC compiler please install the official installation package provided by PCL Select Add PCL to the system PATH for xxx during installation Figure B 1 Set up P...

Page 35: ...parameters when executing the CMake configuration cmake DCOMPILE_DEMOS ON B 1 3 2 Visualization Tools rs_driver provides a point cloud visualization tool based on PCL which is stored in rs_driver tool...

Page 36: ...full Ubuntu 18 04 ROS melodic desktop full Installation method refer to http wiki ros org If ROS kinetic desktop full or ROS melodic desktop full is installed other dependent libraries of compatible...

Page 37: ...ecute the following command to compile and run if you use zsh replace the second command with source devel setup zsh catkin_make source devel setup bash roslaunch rslidar_sdk start launch B 2 1 3 Comp...

Page 38: ...e details please refer to Reading LiDAR data online and sending to ROS 2 Parse ROS or ROS2 packets offline For more details please refer to Recording ROS data packets parsing ROS data packets offline...

Page 39: ...fic status lidar driver lidar_type RSM1 frame_id rslidar msop_port 6699 difop_port 7788 start_angle 0 end_angle 360 min_distance 0 2 max_distance 200 use_lidar_clock false ros ros_recv_packet_topic rs...

Page 40: ...s message timestamp false use system time as message timestamp B 2 3 3 Example of Multiple LiDAR Sensors Connect 2 RS LiDAR M1 LiDAR sensors online and send the point cloud to ROS Attention Indentatio...

Page 41: ...Transformation rslidar_sdk provides a built in coordinate transformation feature which can directly output the point cloud after coordinate transformation which significantly saves the user s time co...

Page 42: ...arameters including x y z roll pitch and yaw Here is an example of the parameter file which can be configured by the user according to the actual situation common msg_source 1 send_packet_ros false se...

Page 43: ...buntu20 04 The corresponding version of the tool can be obtained by contacting RS technical support C 3 Operation Instructions C 3 1 Function Description The little robo tool supports two modes State...

Page 44: ...3 2 Interface Description A license is required for the first time running the software As shown in Figure 2 Please use the following license serial number Figure C 2 RoboSense License Notice After en...

Page 45: ...default It can be modified After entering the desired IP address in the box click E ROUTE to confirm and then restart the LiDAR to complete the modification Get the PL firmware version of the LiDAR m...

Page 46: ...n of the Project button at the top right and select M0210 the interface is as follows Step2 Enter Link mode Please confirm the source IP and target IP of the LiDAR before clicking Link If the LiDAR is...

Page 47: ...mple to modify the default LIDAR information to the following state LiDAR Info Description LiDAR IP ECU 10 10 1 200 PC IP TST 10 10 1 102 MSOP Port 2010 DIFOP Port 2011 Step1 After entering the Link m...

Page 48: ...PL Function Enable Control and click QUERY button DID RSEP value of 00 indicates ROI Function off DID RSEP value of 01 indicates ROI Function on C 3 3 4 Firmware Flashing Step1 Click OpenFile select t...

Page 49: ...e upgrade is done the upgrade completion window pops up click OK to complete the upgrade Step4 After the upgrade is done LiDAR will start automatically Re enter the Link mode after booting and get the...

Page 50: ...RS LiDAR M1 User Guide Appendix D Dimension Drawing of LiDAR with interface AN1...

Page 51: ...RS LiDAR M1 User Guide Definition of AN1 Pins...

Page 52: ...RS LiDAR M1 User Guide Drawing of LiDAR with interface AN2...

Page 53: ...RS LiDAR M1 User Guide Definition of AN2 Pins...

Page 54: ...RS LiDAR M1 User Guide...

Reviews: