1.0
doubleTing 2019-07-22 17:01:53 +08:00
parent 786eb32d50
commit b69376a099
16 changed files with 191 additions and 60 deletions

View File

@ -17,3 +17,48 @@
* “ USB-Hub 上面的接口不通用吗(仅 导航套件 二代 用户)?” * “ USB-Hub 上面的接口不通用吗(仅 导航套件 二代 用户)?”
不通用,组装时务必按照文字提示插入设备,错误的接线方式将无法正常建图、定位、避障,甚至危及人身安全。 不通用,组装时务必按照文字提示插入设备,错误的接线方式将无法正常建图、定位、避障,甚至危及人身安全。
#### 常见问题:
##### 建图篇
1. 键盘控制AP1行走时AP1动作异常动一下停一下
可调整显示器的位置保持接收器不被遮挡并调整自己的位置使接收器可以接收到发送的指令信号建议使用USB延长线或USB-HUB将接收器放置在架子的高处无任何遮挡便于信号传输。
2. 键盘控制AP1一动不动
a) 确认已将AP1电源总开关打开急停开关没有被按下AP1处于上位机控制模式
b) 新开一个terminal执行以下命令打出关系图查看键盘节点
`$ rosrun rqt_graph rqt_graph`
c) 执行以下命令上下左右控制键盘看是否会有数据打出如没有数据打出说明AP1没有接收到键盘发送的指令
`$ rostopic echo /cmd_vel`
d)执行以下命令确认event-kbd的数量数量大于一个则有问题
`ll /dev/input/by-path/ `
![](imgs/keyboard.png)
e) 请排查是否有多个键盘设备,键盘驱动查找的是最后一个连接的键盘,需要将其他(显示为)键盘的设备找出来,拔掉(可能是鼠标、机械键盘、混装键鼠)
3. AP1不受键盘控制、失控
在开始建图前需要禁用无线功能。如果没有禁用AP1在连接了WIFI的状态下开始建图在地图构建过程中一旦AP1离开无线覆盖区域无线连接断开ROS的网络通信中断就会导致AP1控制失控。
##### 导航篇
常见问题:
1. 定位要走一走
2. 建图地图质量不好,障碍物颜色虚,效果好墙面黑色实现
3. 周围没有明显的特征信息,使得机器人能够找到自己的位置,开到有折角拐弯或明显标志物附近,能够加速机器人找到自己的位置
2. 建图白,多走几遍,
3. 镜面,建图
1. 目标点给定后可能会发生AP1不动或原地转圈控制台显示【Failed to get a plan/不能规划路径】的红色错误,这可能是有两种原因造成:
* 目标点选择在了障碍物中
* 车在地图中所处的位置是在障碍物中
那么这样的情况,我们可以先尝试重新给定目标点,或者将车换个位置重新给定初始位置。
2. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生
这种情况是因为AP1在行走过程中检测到障碍物无法到达目标点这个障碍物有可能是真实的障碍物也有可能是误检我们可以先等待观察AP1会进行自我恢复不超过一分钟如果恢复之后AP1仍没有行动导航已自动停止此时我们需要重新设置目标点。
3. 建图效果不佳/地图构建要点
在构建地图的过程,以下几点会影响到建图的准确性:
* 轮胎气不足影响里程计数据
* 运行速度不宜过快,由于激光扫描有一定的频率,车速低时雷达可以扫描到的点更多,构建的地图会更准确一些
* 走一个来回,增加激光雷达扫描次数,累计更多的数据
* 地图构建的质量也受环境限制,请尽量选择特征比较明显的环境,玻璃、镜子、楼道、空旷等场景会影响建图效果
* 构建完成的地图,会发现有些点会飞出,飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去
* 当场景很大特征不足的时候,需要规划建图路径时,应先走一个小回环,当回环成功后,可以再多走几圈,消除粒子在这个回环的多样性。接下来走下一个回环,直到把整个地图连通成一个大的回环

View File

@ -2,13 +2,15 @@
### 目录 ### 目录
* [产品介绍]() * [产品介绍](overview/doc.md)
* 使用指南 * 使用指南
* [收货与清点](user_guide/quick_start/receipt.md)
* [组装与测试](user_guide/assembly_test/doc.md) * [组装与测试](user_guide/assembly_test/doc.md)
* [快速上手]() * [快速上手](user_guide/quick_start/slam_doc.md)
* [常见问题]() * [常见问题]()

View File

@ -1 +0,0 @@
# 产品介绍

View File

@ -0,0 +1,70 @@
# 产品介绍
Autolabor Pro1 导航平台搭载激光雷达、深度相机、惯导、里程计等传感器可实现SLAM建图导航、视觉SLAM、图像识别等功能。
![](imgs/667width.png)
定制化操作系统AutolaborOS系统已实现室内自主导航无须开发一键式建图导航操作简单。
系统持续更新代码全部开源使用户可以快速上手ROS基于平台高效的进行二次开发。
![](imgs/667width-3.png)
# 传感器及设备清单
序号 | 设备 | 型号
:---:|:---:|---
1| 激光雷达 | 思岚 RPLIDAR-A2
2 | 深度相机 | Kinect V2
3| IMU | AH-100B
4 | mini 电脑 | AMD Ryzen 3 2200G/4G/120G
5 | 13.3 寸高清显示屏| 1080P 便携 HDR 显示器
6 | 电源模块 | 24V 10AH 锂电池/稳压模块/电量显示模块/分线板船型电源
# 功能及效果演示
![](imgs/667width-1.png)
![](imgs/667width-4.png)
![](imgs/667width-7.png)
![](imgs/667width-8.png)
### 驱动列表:
* Autolabor Pro1 驱动包
* 激光雷达驱动包
* RPLIDAR A1
* RPLIDAR A2
* HOKUYO URG-04LX-UG01
* 深度相机驱动包
* Kinect V2
* 惯导驱动包
* AH100B
### 功能列表:
* 一键SLAM导航
* 键盘控制机器人运动
* 手柄控制机器人运动
* Gmapping 单线激光雷达SLAM建图
* Amcl 基于单线激光雷达定位
* Navigation 自动导航功能
* Autolabor Simulation 仿真模拟器场景应用
## 应用场景:
* ROS学习
* 算法验证
* 自动驾驶
* 自主导航
* 智能建图
平台可实现的功能包括但不仅限于以上内容更多功能还在持续开发中后续功能将通过AutolaborOS更新发布敬请关注。

Binary file not shown.

After

Width:  |  Height:  |  Size: 230 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 124 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 261 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 135 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 424 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 121 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 257 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 824 KiB

View File

@ -7,6 +7,18 @@
详请参照视频 详请参照视频
https://video-autolabor-1255388470.cos.ap-beijing.myqcloud.com/AutolaborPro1/%E5%AF%BC%E8%88%AA%E5%A5%97%E4%BB%B6%E7%BB%84%E8%A3%85%E6%95%99%E7%A8%8B.mp4
### 注意事项
1. 激光雷达的朝向一定要与视频中一致,否则将影响程序功能。
2. Autolabor Pro1的串口数据线与雷达的数据线需插在工控机的USB2.0接口上
3. 新版显示器不再使用圆形dc电源插口以USB typec方式供电USB线另一端直接插在上位机USB口上。(2019-01-04)
![](imgs/update-1.jpg)
4. Kinect集线器电源线升级 (2019-01-04)
![](imgs/update-2.jpg)
### 电气拓扑 ### 电气拓扑
![](imgs/autolabor_navigationkit_v1_electrical_topology.png) ![](imgs/autolabor_navigationkit_v1_electrical_topology.png)

Binary file not shown.

After

Width:  |  Height:  |  Size: 119 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 109 KiB

View File

@ -1,8 +1,15 @@
# 快速开始 # 快速开始
## 视频版
https://video-autolabor-1255388470.cos.ap-beijing.myqcloud.com/AutolaborPro1/%E5%AF%BC%E8%88%AA%E5%A5%97%E4%BB%B6%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B.mp4
## 文字版
#### 准备工作: #### 准备工作:
1. AP1导航机器人 1. AP1室内导航套件
2. 成套键鼠 2. 一套无线键鼠
## 操作步骤 ## 操作步骤
@ -19,70 +26,66 @@
1. 将AP1控制模式切换到上位机控制打开急停开关确保急停开关没有被按下 1. 将AP1控制模式切换到上位机控制打开急停开关确保急停开关没有被按下
2. 禁用工控机无线功能 2. 禁用工控机无线功能
在建图过程中如果工控机连接了无线网络当AP1走出无线网络的覆盖区域后网络连接会自动断开这将导致AP1控制失控所以在开始建图之前为了避免失控需要将工控机的无线网络连接关闭。 在建图过程中如果工控机连接了无线网络当AP1走出无线网络的覆盖区域后网络连接会自动断开这将导致AP1控制失控所以在开始建图之前为了避免失控需要将工控机的无线网络连接关闭。
3. 进入桌面【SLAM建图导航】文件夹
#### 1. 点击【开始建图】 #### 1. 点击【开始建图】
RVIZ工具打开能够看到地图中的AP1使用键盘的上下左右控制AP1行走边走边建图可以看到环境地图随着AP1的行走不断被构建更新 RVIZ工具打开能够看到地图中的一个黄色的小车这是AP1在环境中的初始位置
地图中,黑色是不可行走区域,白色是可行走区域,灰色是未知区域,红色是激光雷达实时数据。 使用键盘的上下左右控制AP1行走小车边走边建图可以看到环境地图随着小车的行走不断被构建更新。
我们看到地图中,黑色是不可行走区域,白色是可行走区域,灰色是未知区域,红色是激光雷达实时数据。
注:
* ROS键盘控制功能在系统中已经安装好无需安装可直接使用。
* 使用键盘上下左右控制车辆行走数字键【1/2】线速度增加/减少数字键【3/4】角速度增加/减少数字键【9】启用数字键【0】禁用。
在小车行走建图的时候,有临时移动障碍物的出现在小车附近,如走动的人,即便之后离开了,建图的结果上有可能会有黑色障碍物在对应的位置;有些障碍物也有可能没有被检测到,在地图中没有显示出来,那么想要导航的效果更好的话,可以手动修正地图,但这一步不是必须操作,可做可不做,不影响导航功能。
#### 2. 建图完毕,点击【保存并停止建图】 #### 2. 建图完毕,点击【保存并停止建图】
#### 3. 点击【开始导航】 #### 3. 修正建图结果
RVIZ工具打开建好的地图会自动加载。
接下来这一步请一定不要忘记按键盘数字键【0】关闭键盘控制功能控制方式将切换至导航程序控制如不切换机器人接收到目标点命令后将不会自动导航行走。 注:此步非必须操作,可跳过至下一步。
建好的地图存放在下面的文件夹中
`/home/autolabor/catkin_ws/src/launch/autolabor_box_launch/map`
每一次建图的结果都会存放在这里每次会生成对应的4个文件real_map.pgm、real_map.yaml、show_map.pgm、show_map.yaml后缀.pgm是图像文件.yaml是对图像文件的解释文件real_map是定位时使用的地图show_map是导航时使用的地图。
请注意在这里要修改的建图文件是show_map.pgm其他的文件不做修改。
使用U盘将show_map.pgm拷贝至自己的电脑里使用系统画图工具或者专业的绘图软件来修改地图。
注意:地图文件不能有任何的翻转、移动操作,只能进行涂抹操作。
拿到地图,对照真实的建图环境,将没有障碍物的地方使用白色涂抹掉,真实环境中存在障碍物,但建图结果上没有的,使用黑色增加。
哪些区域不希望小车去行走,也可以使用黑色来涂抹设置为不可行走范围的,比如环境中有椅子或者桌子等开放式区域,我们可以涂抹黑色进行封闭处理,将其变为墙。
最好也对地图边缘等未知区域进行封闭处理,使用黑色将边界涂抹。
处理完地图之后,将该文件拷贝回原文件夹中,可将之前的文件做一个备份,请注意将修改后的地图文件名称与之前保持一致。
#### 4. 点击【开始导航】
RVIZ工具打开我们看到修改后的地图已经自动加载进来了。
在地图中初始化车的所在位置,并设定一个目标位置,小车就可以自动导航了。
初始化所在位置的设置方式有两种:
1. 使用键盘控制小车走到初始建图位置,注意车头、车尾方向与之前基本保持一致;
2. 使用2D Pose Estimate点击 2D Pose Estimate2D nav goal左边根据小车现在的所在位置对比地图找到车辆在地图中大概的位置根据真实车头的朝向拉动鼠标方向指向车头朝向的方向这样车辆就完成了位置初始化。
初始化位置之后,我们可以使用键盘控制小车,小幅度的控制小车行走,看到小车周围的蓝色块收敛,程序会依据激光雷达的数据校准当前位置,这样我们给定的初始位置相对来说也就更精准一些。
接下来这一步请不要忘记按【0】关闭键盘控制功能控制方式将切换至导航程序控制。
点击2D Nav Goal指定目标位置拉动鼠标箭头方向是最终车辆运行至目标的车头朝向鼠标松开这样就完成了目标点的指定。 点击2D Nav Goal指定目标位置拉动鼠标箭头方向是最终车辆运行至目标的车头朝向鼠标松开这样就完成了目标点的指定。
目标点给定后在地图中我们能看到一条线这是规划好的路径。根据这个规划好的路径AP1向目标点行走。 #### 5. 点击【终止导航】,停止导航功能,导航结束
当AP1已经到达目标点后再一次使用2D Pose Estimate指定初始位置设置目标位置AP1将去到下一个目标点。
四、点击【终止导航】,停止导航功能,导航结束。
之后在同一环境中需要再次使用导航功能时,无须重复建图,点击【开始导航】即可。 之后在同一环境中需要再次使用导航功能时,无须重复建图,点击【开始导航】即可。
#### 常见问题:
##### 建图篇
1. 键盘控制AP1行走时AP1动作异常动一下停一下
可调整显示器的位置保持接收器不被遮挡并调整自己的位置使接收器可以接收到发送的指令信号建议使用USB延长线或USB-HUB将接收器放置在架子的高处无任何遮挡便于信号传输。
2. 键盘控制AP1一动不动
a) 确认已将AP1电源总开关打开急停开关没有被按下AP1处于上位机控制模式
b) 新开一个terminal执行以下命令打出关系图查看键盘节点
`$ rosrun rqt_graph rqt_graph`
c) 执行以下命令上下左右控制键盘看是否会有数据打出如没有数据打出说明AP1没有接收到键盘发送的指令
`$ rostopic echo /cmd_vel`
d)执行以下命令确认event-kbd的数量数量大于一个则有问题
`ll /dev/input/by-path/ `
![](imgs/keyboard.png)
e) 请排查是否有多个键盘设备,键盘驱动查找的是最后一个连接的键盘,需要将其他(显示为)键盘的设备找出来,拔掉(可能是鼠标、机械键盘、混装键鼠)
3. AP1不受键盘控制、失控
在开始建图前需要禁用无线功能。如果没有禁用AP1在连接了WIFI的状态下开始建图在地图构建过程中一旦AP1离开无线覆盖区域无线连接断开ROS的网络通信中断就会导致AP1控制失控。
##### 导航篇
常见问题:
1. 定位要走一走
2. 建图地图质量不好,障碍物颜色虚,效果好墙面黑色实现
3. 周围没有明显的特征信息,使得机器人能够找到自己的位置,开到有折角拐弯或明显标志物附近,能够加速机器人找到自己的位置
2. 建图白,多走几遍,
3. 镜面,建图
1. 目标点给定后可能会发生AP1不动或原地转圈控制台显示【Failed to get a plan/不能规划路径】的红色错误,这可能是有两种原因造成:
* 目标点选择在了障碍物中
* 车在地图中所处的位置是在障碍物中
那么这样的情况,我们可以先尝试重新给定目标点,或者将车换个位置重新给定初始位置。
2. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生
这种情况是因为AP1在行走过程中检测到障碍物无法到达目标点这个障碍物有可能是真实的障碍物也有可能是误检我们可以先等待观察AP1会进行自我恢复不超过一分钟如果恢复之后AP1仍没有行动导航已自动停止此时我们需要重新设置目标点。
3. 建图效果不佳/地图构建要点
在构建地图的过程,以下几点会影响到建图的准确性:
* 轮胎气不足影响里程计数据
* 运行速度不宜过快,由于激光扫描有一定的频率,车速低时雷达可以扫描到的点更多,构建的地图会更准确一些
* 走一个来回,增加激光雷达扫描次数,累计更多的数据
* 地图构建的质量也受环境限制,请尽量选择特征比较明显的环境,玻璃、镜子、楼道、空旷等场景会影响建图效果
* 构建完成的地图,会发现有些点会飞出,飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去
* 当场景很大特征不足的时候,需要规划建图路径时,应先走一个小回环,当回环成功后,可以再多走几圈,消除粒子在这个回环的多样性。接下来走下一个回环,直到把整个地图连通成一个大的回环