navgationkit-docs-sphinx/source/user_guide/quick_start/doc.md

82 lines
5.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 快速开始
#### 准备工作:
1. AP1 室内套件2代
2. 成套键鼠
## 操作步骤
### 一、连接键鼠
鼠标键盘建议使用普通成套的无线键鼠,避免有线和无线混合使用。
### 二、启动系统
打开电源打开工控机等待Autolabor OS系统启动输入密码autolabor字母全部是小写回车。
### 三、SLAM建图导航
#### 准备工作:
1. 将AP1控制模式切换到上位机控制打开急停开关确保急停开关没有被按下
2. 禁用工控机无线功能
在建图过程中如果工控机连接了无线网络当AP1走出无线网络的覆盖区域后网络连接会自动断开这将导致AP1控制失控所以在开始建图之前为了避免失控需要将工控机的无线网络连接关闭。
3. 进入桌面【SLAM建图导航】文件夹
#### 1.点击【开始建图】
RVIZ工具打开能够看到地图中的AP1使用键盘的上下左右控制AP1行走边走边建图可以看到环境地图随着AP1的行走不断被构建更新。
地图中,黑色是不可行走区域,白色是可行走区域,灰色是未知区域,红色是激光雷达实时数据。
二、建图完毕,点击【保存并停止建图】
三、点击【开始导航】
RVIZ工具打开建好的地图会自动加载。
接下来这一步请不要忘记按【0】关闭键盘控制功能控制方式将切换至导航程序控制。
点击2D Nav Goal指定目标位置拉动鼠标箭头方向是最终车辆运行至目标的车头朝向鼠标松开这样就完成了目标点的指定。
目标点给定后在地图中我们能看到一条线这是规划好的路径。根据这个规划好的路径AP1向目标点行走。
当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. 目标点给定后可能会发生AP1不动或原地转圈控制台显示【Failed to get a plan/不能规划路径】的红色错误,这可能是有两种原因造成:
* 目标点选择在了障碍物中
* 车在地图中所处的位置是在障碍物中
那么这样的情况,我们可以先尝试重新给定目标点,或者将车换个位置重新给定初始位置。
2. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生
这种情况是因为AP1在行走过程中检测到障碍物无法到达目标点这个障碍物有可能是真实的障碍物也有可能是误检我们可以先等待观察AP1会进行自我恢复不超过一分钟如果恢复之后AP1仍没有行动导航已自动停止此时我们需要重新设置目标点。
3. 建图效果不佳/地图构建要点
在构建地图的过程,以下几点会影响到建图的准确性:
* 轮胎气不足影响里程计数据
* 运行速度不宜过快,由于激光扫描有一定的频率,车速低时雷达可以扫描到的点更多,构建的地图会更准确一些
* 走一个来回,增加激光雷达扫描次数,累计更多的数据
* 地图构建的质量也受环境限制,请尽量选择特征比较明显的环境,玻璃、镜子、楼道、空旷等场景会影响建图效果
* 构建完成的地图,会发现有些点会飞出,飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去
* 当场景很大特征不足的时候,需要规划建图路径时,应先走一个小回环,当回环成功后,可以再多走几圈,消除粒子在这个回环的多样性。接下来走下一个回环,直到把整个地图连通成一个大的回环