Thumbnail

Rplidar

by Slamtec

NMS Lidar is the robot skill driver for all Slamtec Lidars (i.e., A series, C series, and S series, etc.).

Requires ARC v19 (Updated 12/24/2024) Hardware Info

How to add the Rplidar robot skill

  1. Load the most recent release of ARC (Get ARC).
  2. Press the Project tab from the top menu bar in ARC.
  3. Press Add Robot Skill from the button ribbon bar in ARC.
  4. Choose the Navigation category tab.
  5. Press the Rplidar icon to add the robot skill to your project.

Don't have a robot yet?

Follow the Getting Started Guide to build a robot and use the Rplidar robot skill.

How to use the Rplidar robot skill

NMS Lidar is the robot skill driver for all Slamtec Lidars (i.e., A series, C series, and S series, etc.). This pushes scan data to the ARC NMS (Navigation Messaging System) as a level #3 Group #1 sensor.  Read the NMS manual page to learn how this skill can be combined with a mapping robot skill for navigation.

In simple explanation, this robot skill will take distance data from any Slamtec lidar sensor using a laser in a 360-degree circle around the robot. It takes that data and pushes it to another robot skill that can display the data and use the information for navigation. The NMS manual explains more about how to set it up. Some videos also demonstrate how to set it up with similar hardware.

Main Window

User-inserted image

When connecting to the Lidar, simply select the COM port from the drop-down menu and press START. There are also control commands for starting and stopping the lidar. If you need to change the COM port or adjust settings, use the configuration menu. By default, this robot skill will use the suggested default scanning mode for the lidar. You cannot change the scanning mode type with this robot skill, as it will choose the default. Upon connection, you will see the console preset data about the product model, version, firmware, and details about the scan modes.

Configuration

User-inserted image

1) BaudRate dropdown The baud rate for the communication. The dropdown presents a few options for you to manually choose or enter the value. The baud rates for Slamtec LIDARs vary depending on the model and the mode of communication. Here’s a summary of commonly supported baud rates for Slamtec RPLIDAR devices:

  1. RPLIDAR A1 (Standard Edition):

    • Default baud rate: 115200 bps
  2. RPLIDAR A2 (Performance Edition):

    • Default baud rate: 115200 bps
    • Other supported baud rates: Configurable in firmware, but 115200 is standard.
  3. RPLIDAR A3 (Enhanced Performance):

    • Default baud rate: 256000 bps
  4. RPLIDAR S1 (Advanced Model):

    • Default baud rate: 256000 bps
  5. RPLIDAR S2 (High Precision):

    • Default baud rate: 256000 bps
  6. RPLIDAR T1 (TOF Technology):

    • Default baud rate: 256000 bps
  7. RPLIDAR C1:

    • Default baud rate: 460800 bps

2) Offset Degrees Correct the angle at which the lidar is mounted. If you find the map reversed, type 180 in this field to rotate the lidar scan data 180 degrees.

3) Set variables with location data If you're not using the NMS, check this option to create global variables for the scan data. Otherwise, keep this unchecked because it will use a significant CPU.

4) Fake NMS Pose hint event The Better Navigator can use the Hector SLAM pose hint, which will not require a pose sensor. You can enable this option if you have The Better Navigator configured to use Hector as the pose hint. This will send a "fake" pose hint of 0,0 to the NMS so that the pose event will run after every lidar scan. If you use a wheel encoder or other pose sensor, leave this checkbox empty.

NMS (Navigation Messaging System) Stack

This skill operates in Level #3 Group #1. It publishes obstacle detection to the NMS. While some SLAM systems will attempt to determine the cartesian position of the robot without telemetry, it is best to combine this skill with a Group #2 sensor.

User-inserted image

How to Use

Program the LIDAR in Blockly Like all Synthiam controls, the Blockly programming language can be used. In the example below, the robot will speak when an object has come close to it. It will also speak the degrees of where the object was. To see a similar lidar program in action, click HERE.

User-inserted image

Cheat Sheet Shortcuts There are several ControlCommand() commands for this robot skill. For a complete list, view the Cheat Sheet for this control. The commands will start and stop.

User-inserted image

Variables You can view the variables this skill creates in the configuration menu of this control. The variables hold the most recent values of the lidar's minimum/maximum distance, degrees, and running status.

User-inserted image


Control Commands for the Rplidar robot skill

There are Control Commands available for this robot skill which allows the skill to be controlled programmatically from scripts. These commands enable you to automate actions, respond to sensor inputs, and integrate the robot skill with other systems or custom interfaces. If you're new to the concept of Control Commands, we have a comprehensive manual available here that explains how to use them, provides examples to get you started and make the most of this powerful feature.

controlCommand("RPLidar", "Start")



  • Start the RP Lidar robot skill by connecting to the lidar and begin scanning.


controlCommand("RPLidar", "Stop")



ARC Pro

Upgrade to ARC Pro

Experience early access to the latest features and updates. You'll have everything that is needed to unleash your robot's potential.

PRO
Colombia
#1  

It's great to have this Skill available, but until now I just got this screen 

User-inserted image

I push Start and only takes a couple to seconds to return again to Start with that message.  I appreciate any suggestion to continue. Also any video showing how this works together with the new Navigator would be great.

Pablo

PRO
Synthiam
#2  

Try the latest version - see if that works for your model. There's a few differences amongst RPI models

The Better navigator is probably a smarter choice for this device. You can read about it on it's manual page and the NMS page. There's about 5-6 videos related to the NMS that you can watch on it. Also it's the same as using the Hitachi Lidar, so the videos and hack videos will be the same for this.

PRO
Colombia
#3  

Thanks DJ for the very fast reply!!, unfortunately I am having the same result.  I checked the lidar with the serial terminal and is answering the Hex commands like reset, start scan etc. , also the Frame Grabber app and is displaying ok the scan.  I Appreciate any other comment or suggestions.  Pablo

PRO
Synthiam
#4  

I don't have one to test with - so i ordered one. It'll be here this week. I can take a closer look in a week to find out what is going on

PRO
Colombia
#5  

That sounds good. Thank you!

PRO
Colombia
#7  

Excellent. By the way I have the intel realsense 435 and T265 to feed the navigator also.  I will be ready to test it!.

PRO
Synthiam
#8   — Edited

Nice - you can try The Better Navigator now if you wish. It "sort of" works but doesn't have auto path planning with the current version.

Actually, you can add all three sensors (realsense & lidar) for The Better Navigator to get even more data fusing lol.

PRO
Colombia
#9  

I can not wait to have those 3 working!. Also auto path planning will be something great.

PRO
Synthiam
#10   — Edited

The RPI Lidar A1 arrived today, and I got it working. Big surprise, but the example opensource code was broken that I built the skill from. What else is new:)

I can't update the robot skill until I update ARC. The ARC NMS is being updated to a new revision, so all of the NMS robot skills need to be updated simultaneously.

User-inserted image

PRO
Colombia
#11   — Edited

Thanks DJ, I will be waiting for the NMS update.

PRO
Colombia
#12  

Hi, I tested this new skill version and Is working now!! Thanks DJ for the prompt fix. Tomorrow I will test the updated navigator. Impresive work done  with all the recent updates.!

PRO
Synthiam
#13  

Updated with performance improvement

PRO
Colombia
#14  

Hi DJ.  My COM port for the Lidar is usually  COM20 ( but always starts in the interface in COM1) is possible to define a default port or remember the last one used?  this is to be able to autostart the Lidar with a script.  Thanks in advance for any help.

PRO
Synthiam
#15   — Edited

The COM port saves with the project. Select your COM port and press the SAVE button in ARC to save the project.

PRO
Colombia
#16  

Yes, I always save the project with the selected port (COM20) but each time I Open it, it selects COM1.

PRO
Synthiam
#17  

Sure you’re using the latest version?

PRO
Synthiam
#18  

I updated the version because maybe it was out of sync on my side somehow

#19  

So this Lidar is working good now,it is a great price!

PRO
Colombia
#20  

Thanks DJ. Now is saving COM port with version7.

PRO
Synthiam
#21  

v8 Updated with minor performance improvement

PRO
Synthiam
#22  

v9 - updated with option to disable setting variable to save on performance

PRO
Synthiam
#23   — Edited

v11

  • fix for the offset value. it wasn't working before
  • fix for scan preview orientation
PRO
Synthiam
#24  

v14

  • has a new option to enable a fake pose hint event. Read the manual above about the option
PRO
Germany
#25  

Hi, everyone,

I have a question about lidar, does a 360 degree clear view have to be available? What if, for example, the view to the rear on the robot is blocked (Servo Cam), does it still work to the front?

And one more question, if this would be the right one: RPLidar A1M8

Regards Uwe

PRO
Synthiam
#26  

This robot skill doesn’t use any mapping. It provides data to the NMS for another robot skill to use the data for mapping. The other robot skill that compliments this would be The Better Navigator.

in The Better Navigator, you can specify the min distance to register. That way, if something blocks the sensor, the values are ignored.

That lidar looks like the correct one.

PRO
Germany
#27   — Edited

great, thanks for the info.

.... Well, if you can read, you have an advantage, the answer to my question is already there:

  1. Disregard values lower than Ignore distance values less than this specified distance in CM. The distance values are provided by any NMS Level #3 Group #1 sensor. If wires or a camera block the sensor, this will ignore those values.

It shows up again, read everything first ;-)

PRO
Synthiam
#28   — Edited

Hahaha - there’s a lot of information to take in. You’ve already accomplished a lot with few questions.

PRO
Synthiam
#29  

Updated v15 to fix an issue when saving a project while no lidar is connected to the PC.

#30   — Edited

Is there a way to specify a certain degree of lidar readings to be put into two different variables. Here is the scenario- going in reverse and trying to get the robot squared up (equal distance at 160 degrees and 200 degrees)  say 6" and then go straight backwards to connect. Having the availability to access certain degree values would be a big plus.

Will do it a different way. Sometimes just talking about it brings up different avenues on how to do things. Have to work with what you have available!

#31  

Updated with options in the settings for RTS and DTR if required. Some USB devices may require RTS enabled. Often RTS is required before DTR, so verify with the documentation of your USB or UART device. If you experience connection issues, RTS may be required to have set enabled.

User-inserted image

PRO
Synthiam
#32   — Edited

v19 has been updated to include support for all Slamtec RP Lidars.