1. RPLidar激光雷达套件
2. RPlidar_multi_touch SDK : 请到官网下载哦~
注意事项
注意
此SDK仅适用于RPLiDAR A2 型号，其他型号暂不支持，请知悉。
1. 请确保USB线不宜过长，需保证RPLidar的供电需求，最好先使用RPLidar套件中0.3m的短USB线。
2. 需要在电脑上事先安装对应系统的cp210x驱动，具体详情可以参考RPLidar开发套装用户手册。
并且将电脑的IP地址配置到同样网段，例如模块默认IP地址为192.168.0.7, 此时可按照如下图片中设置电脑的IP地址。
另外，需要将multi_touch.json中的connect_path参数改为TCP。（此部分将在SDK文件组织结构中介绍）
配置流程
1. 首先打开位于workspacesvc10下的 VS 解决方案文件：sdk_and_demo.sln
注意
注意：本文档所使用的应用环境均基于VS2010， 其他版本的VS会出现编译问题。
2. 右键点击Solution Explorer 中的Solution”sdk_and_demo”(5 projects), 点击rebuild solution。
3. 打开workspacesvc10sdk_projectmultiTouch_sdkoutput 文件目录，拷贝目录下的multiTouch_sdk.dll文件。如果在该目录下没有发现multiTouch_sdk.dll文件，说明之前的编译未成功，请返回步骤2，重新编译Solution。
4. 复制到workspacesvc10demo_project 文件目录下对应的3个demo文件中的bin目录下，这样就可以打开对应的3个demo app来进行后续操作。
左边红框中显示当前目录为rplidar_multi_touch这个app的bin目录，右边红框中即为步骤2中编译出的multiTouch_sdk.dll文件。
5. 将RPLidar固定于墙面， 为了标定时方便，建议用户将雷达如下图所示方向固定，即雷达接线方向垂直向下。如若固定时按照其他角度来安装，请注意雷达的串口接线方向为雷达实际的180度方向。
6. 通过USB适配器或者网口附件板接入PC后，首先打开calibration application标定触摸区域，
点击左上角file菜单下load configuration读取对应的配置
注意
请注意这里要读取的multi_touch.json配置文件, 在Debug模式编译下，是存储在..conf文件目录下，Release模式编译下是存储在workspacesvc10demo_projectrplidar_multi_touchbin文件目录下，放在其他目录下无效。
7. 拖动白色虚线框体来标定触摸区域和大小
标定结束后保存区域至conf目录下multi_touch.json文件，图中标定范围为一个1米边长的正方形，即图中白色虚线区域，图中蓝色点为实时扫描的激光点，如步骤5中安装图所示，蓝色点扫描出的是固定在墙面时的房间轮廓。
8. 打开workspacesvc10demo_projectrplidar_multi_touchbin目录下的rplidar_multi_touch_debug.exe。会显示颜色大小不同的圆，代表了每一个TouchPoints。按照之前标定的1m*1m的区域内，将其按照屏幕比例映射显示（此时屏幕分辨率为1920*1080）
TouchPoints的大小是如何确定的?
Rplidar_multi_touch应用中首先将原始以极坐标系表示的雷达点数据转换成以笛卡尔坐标系表示，如果两个点距离小于0.05m (BlobCombinationThreshold参数)，则将两个点融合为一个以两个点为矩形顶点的矩形，矩形长度取两个点中较大x值，宽度取两个点中较大y值，如果融合后的矩形和其他的矩形距离还是小于0.05m，则将两个矩形继续融合，以两个矩形较大长度为新矩形长度，以两个矩形较大宽度为新矩形宽度，融合直到没有矩形或者点两两之间距离小于0.05.
然后根据矩形长度和宽度的大小关系，计算出以长度或者宽度为直径的圆的半径，作为TouchPoints在屏幕上画圆的半径。
SDK 和实例程序的编译
如果您使用Windows进行开发，请打开位于workspacesvc10下的 VS 解决方案文件：sdk_and_demo.sln。其中包含了 SDK 项目工程以及所有的示例程序项目。
您可以直接在 VS 环境中使用编译命令对 SDK 本身以及所有示例程序进行编译。按照开发需要，可以选择 Debug 或者 Release 编译方式。编译结果可以 在 outputwin32Debug 或者 outputwin32Release 中找到。
Ultra_simple_multi_touch
该示例程序演示 PC 通过串口与 RPLIDAR 进行连接，并不断的将在触摸区域内的 RPLIDAR 扫描数据输出的最简单过程。
使用方式：
1) 使用包装里提供的 USB 线连接 RPLIDAR 至 PC 机 （开发板集成了 USB 转 串口芯片） 2）控制台打开workspacevs10demo_projectultra_simple_multi_touch bin下ultra_rplidar_multi_touch.exe运行程序
如果不指定 COM 设备号，则程序会尝试打开 COM3。
rplidar_multi_touch
该示例程序演示 PC 通过串口与 RPLIDAR 进行连接，实时采集雷达扫描数据， 并在 GUI 界面上将触摸区域内的点数据融合以后以彩色圆圈的方式显示出来。
使用方式
1) 使用包装里提供的 USB 线连接 RPLIDAR 至 PC 机 （开发板集成了 USB 转 串口芯片）
2) 双击打开 workspacevs10demo_projectrplidar_multi_touchbin下的rplidar_multi_touch_debug.exe运行程序
在配置流程步骤8中已有详细介绍。
Calibration application
该示例程序演示 PC 通过串口与 RPLIDAR 进行连接，实时采集雷达扫描数据， 并在 GUI 界面上将触摸区域内的点数据,以及标定了触摸区域的大小与范围.
使用方式
1) 使用包装里提供的 USB 线连接 RPLIDAR 至 PC 机 （开发板集成了 USB 转 串口芯片）
2) 双击打开 workspacevs10demo_projectcalibration_appbin下的rplidar_multi_touch_debug.exe运行程序
3）点击左上方file目录下load configuration，选择..conf目录下（Debug编译）workspacevs10demo_projectcalibration_appbin目录下（Release编译）的对应json文件读取配置，此时雷达会开始转动，界面上会出现雷达扫描点和标定触摸区域的白框，可以手动拖动调整框体的大小和区域。点击file目录下的save configuration可以保存配置好的触摸区域位置信息。
注意
请注意保存的配置文件也必须位于相应同一目录下，否则将无效。
SDK文件架构
SDK的文件结构如下图所示:
文件中包含了此SDK中使用的第三方库，分别是：
· Jsoncpp库 用于解析Json格式的文件
· Open frameworks库 用来基于此框架快速开发高性能的互动程序
conf目录包含一个json格式的配置文件，会在每次开始扫面时读取这个配置文件中的参数，可配置的参数包括
· “connect path”连接路径和方式选择，暂时只支持串口和TCP，
· “touch_area”触摸区域的大小
· “show_lidar_scan”是否显示雷达扫描点
· “show_touch_point_coordination”是否显示touchpoint坐标
· “angle_offset”默认为180度，此参数不能改变。
demo_app目录包含了相关的示例程序代码，暂时提供了如下几个示例程序：
· rplidar_multi_touch
一个基于win32的GUI显示程序，获取到当前触摸的点数据后，经过渲染实时的呈现在界面上。
· Ultra_simple_multi_touch
一个基于命令行的演示程序，不断的输出当前的触摸点数据。
SDK目录包含了multi_touch驱动程序的外部头文件（include目录）以及SDK自身的内部实现代码（src目录）。
Workspace目录包含了SDK和相关示例程序的VS工程项目文件。
对于经过编译的 SDK，上述目录结构还会新增 2 个子目录：obj 和 output。 其中 output 目录存放了编译产生的 SDK 静态库(.lib 或者.a)以及示例程序的可 执行文件(exe 或者 elf 格式)。obj 目录存放了编译过程中的中间文件。
至此所有的配置步骤已经SDK介绍就结束了，用户可以通过配置快速将RPLIDAR与Multi_touch SDK结合，通过rplidar_multi_touch应用显示所有的TouchPoints，实现多点触摸的效果。
用户也可以根据Multi_touch SDK进行二次开发，附录中附有SDK头文件和接口函数的简介，以帮助用户快速开发。
举报
