8. 电池充电要冲多久才能充满？
+ +AP1 标准版/导航套件-电源模块：电池从0-100%，需要7小时左右 + +AP1 高续航版： 电池从0-100%，需要10小时左右 diff --git a/source/common/q_a/doc2.md b/source/common/q_a/doc2.md index 6249e82..9704b1a 100644 --- a/source/common/q_a/doc2.md +++ b/source/common/q_a/doc2.md @@ -10,20 +10,29 @@ 5. AP1不受键盘控制、失控 6. 如何判断自己的建图质量 7. 如何建出高质量的地图/建图效果不佳/地图构建要点 +8. 建好的地图存放在哪里 +9. 我有多个环境，地图是否可以保存多个，不用每次重新建图 +10. 已构建好的地图文件是什么格式，如何对其进行修改 +11. （接上问）如果一定要手动修改地图，怎么办？ ## 导航 1. 建图完毕后，点击开始导航就会报错 2. 初始化定位如何完成 3. 初始化定位一直没有成功，地图和真实环境不符是什么原因 -4. 导航过程中，机器人走的太慢，速度能再快点吗？ -5. （接上问）我一定要提高速度，在哪里改参数？ +4. 开始导航后，为什么车走的特别慢，完全走不动的样子 +5. 导航过程中，机器人走的太慢，速度能再快点吗？ +6. （接上问）我一定要提高速度，在哪里改参数？ +7. 导航时，如何调整机器人可通过的宽度/让机器人离障碍物可以更近一点 +8. 机器人导航到达这个目标点是以什么作为参考的呢？这个位置又是如何确定的呢？ + + *** ## 建图导航-建图篇 -1.打开开始建图，RVIZ中只有一个白色的车，左侧 RobotModel 报错
+1. 打开开始建图，RVIZ中只有一个白色的车，左侧 RobotModel 报错
 @@ -32,7 +41,7 @@ *** -2.打开开始建图，RVIZ中只有一个黄色的车，左侧警告 No map receievd
+2. 打开开始建图，RVIZ中只有一个黄色的车，左侧警告 No map receievd
 @@ -53,14 +62,14 @@ *** -3.键盘控制AP1行走时，AP1动作异常，动一下停一下
+3. 键盘控制AP1行走时，AP1动作异常，动一下停一下
可调整显示器的位置，保持接收器不被遮挡，并调整自己的位置，使接收器可以接收到发送的指令信号，建议使用USB延长线或USB-HUB将接收器放置在架子的高处，无任何遮挡，便于信号传输。 *** -4.键盘控制，AP1一动不动
+4. 键盘控制，AP1一动不动
a) 确认已将AP1电源总开关打开，急停开关没有被按下，AP1处于上位机控制模式 @@ -83,14 +92,14 @@ e) 请排查是否有多个键盘设备，键盘驱动查找的是最后一个 *** -5.AP1不受键盘控制、失控
+5. AP1不受键盘控制、失控
在开始建图前，需要禁用无线功能。如果没有禁用，AP1在连接了WIFI的状态下开始建图，在地图构建过程中，一旦AP1离开无线覆盖区域，无线连接断开，ROS的网络通信中断就会导致AP1控制失控。 *** -6.如何判断自己的建图质量
+6. 如何判断自己的建图质量
在构建完成的地图中，如很明显是障碍物（墙）的颜色是虚的，则不太好。 @@ -98,7 +107,7 @@ e) 请排查是否有多个键盘设备，键盘驱动查找的是最后一个 *** -7.如何建出高质量的地图/建图效果不佳/地图构建要点
+7. 如何建出高质量的地图/建图效果不佳/地图构建要点
在构建地图的过程，以下几点会影响到建图的准确性： @@ -114,6 +123,61 @@ e) 请排查是否有多个键盘设备，键盘驱动查找的是最后一个 * 当场景很大特征不足的时候，需要规划建图路径时，应先走一个小回环，当回环成功后，可以再多走几圈，消除粒子在这个回环的多样性。接下来走下一个回环，直到把整个地图连通成一个大的回环 +*** + +8. 建好的地图存放在哪里
+ +catkin_ws/src/launch/autolabor_navigation_launch/map + +*** + +9. 我有多个环境，地图是否可以保存多个，不用每次重新建图
+ +可以。所有成功保存的地图都会保存在： + +`catkin_ws/src/launch/autolabor_navigation_launch/map` + + +导航时使用的地图文件为`map.pbstream`，最后一次保存的地图会自动存储为`map.pbstream`，而过去建好的地图会用时间戳重命名，备份在同一路径下，备份地图的名称可以自定义。 + + + +如果要切换地图，可以将现有地图重命名，将要替换的地图修改为`map.pbstream`，之后需要再次切换的时候，依然更换地图名称即可。 + + +*** + +10. 已构建好的地图文件是什么格式，如何对其进行修改
+ +SLAM 建图算法使用的是 Cartographer ，地图文件为 pbstream 格式。 + +pbstream 文件本质上是一个压缩的 protobuf 文件，其中包含 Cartographer 内部使用的数据结构的快照。 + +>Cartographer can serialize its internal state in a .pbstream file format which is essentially a compressed protobuf file containing a snapshot of the data structures used by Cartographer internally. + +由此可知，pbstream 与 ROS格式地图（.pgm+.yaml）不同，pbstream 不可修改编辑。 + +*** + +11. （接上问）如果一定要手动修改地图，怎么办？
+ +由上问可知 pbstream 是不可编辑的，但如果因为环境的原因，建图效果不是很好，一定要手动修改地图。 + +有2点要提前知晓： + +1. pbstream 格式只能向 ROS 格式地图（.pgm+.yaml）单向转换 +2. 导航中定位使用的是 Cartographer 定位，Cartographer 定位是只支持基于 pbstream 格式地图的 pure localization，不接受其他格式的地图。如果要修改地图，就要放弃 Cartographer 定位。 + +可参考的方案有： + +1. 使用 Cartographer 建图，得到 pbstream 文件，转换为ROS格式地图（.pgm+.yaml），手动修改后使用其他定位算法，如AMCL +2. 更换 Cartographer 为 gmapping，得到ROS格式地图（.pgm+.yaml），手动修改后使用其他定位算法，如AMCL + + +但 gmapping 没有回环检测，建图效果与 Cartographer 比有差距。 + +请按照各自的需求，来进行决策。 + ## 建图导航-导航篇 @@ -126,6 +190,7 @@ e) 请排查是否有多个键盘设备，键盘驱动查找的是最后一个 catkin_ws\src\launch\autolabor_navigation_launch\map\map.pbstream 是否有 map.pbstream 文件存在，如果没有则没有成功保存地图。 + 2. 有地图存在，但文件大小较小（不到1MB） 地图文件不完整，没有正常保存地图。 @@ -150,7 +215,17 @@ e) 请排查是否有多个键盘设备，键盘驱动查找的是最后一个 *** - + + +给定目标，开始导航后，要按【0】关闭键盘控制。 + +键盘未关闭，且又不进行任何控制时，键盘程序会一直向底层发送速度0指令。 + +接到目标点导航任务后，导航程序又一直向底层发布速度指令，2个程序同时发送速度，会导致底层走不动。 + +*** + + 可以，但机器人行走速度过快，实时雷达数据与环境地图匹配不佳会导致无法正确避障而撞到障碍物。 @@ -159,11 +234,11 @@ e) 请排查是否有多个键盘设备，键盘驱动查找的是最后一个 *** - + 修改以下文件： -catkin_ws\src\launch\autolabor_navigation_launch\two_laser_navigation_param\teb_local_planner_params.yaml +`catkin_ws\src\launch\autolabor_navigation_launch\two_laser_navigation_param\teb_local_planner_params.yaml` ``` max_vel_x: 0.2 //机器人的最大平移速度 @@ -177,3 +252,38 @@ max_vel_x: 0.8 max_vel_x_backwards: 0.6 max_vel_theta: 0.6 ``` + + + +修改以下文件： + +`/src/launch/autolabor_navigation_launch/two_laser_navigation_param/teb_local_planner_params.yaml` + +参考下图： + + + + + +修改以下3个参数： + +``` +line_start: [-0.3, 0.0] # for type "line" +line_end: [0.3, 0.0] # for type "line" +min_obstacle_dist:0.4 +``` + +具体的数值要按照修改期望与实际环境进行计算， +虚线圈越小，离障碍物就越近，可过的宽度越窄，但不建议修改太小。 + +*** + + + +在map坐标系下，机器人base_link坐标系原点，到达目标点位置，即视为到达目标点。 + +**Autolabor Pro1 base_link坐标系** + +以机器人四轮接触面为X-Y平面，四轮轴心连线的点做垂线，与x-y平面的交点为base_link坐标系原点，车头朝向方向为X轴，正左方向为Y轴，向上为Z轴。 + + \ No newline at end of file diff --git a/source/common/q_a/doc3.md b/source/common/q_a/doc3.md new file mode 100644 index 0000000..9d80550 --- /dev/null +++ b/source/common/q_a/doc3.md @@ -0,0 +1,132 @@ +## 常见问题 - 定位巡迹 + + +### 定位标签 + +1. Dashboard 软件打开报错 +2. Dashboard 无法唤醒对应id的标签 +3. 唤醒标签后，标签会自动关闭吗 +4. 设备插上电脑后，电脑无法识别 +5. 路由连接电脑，Dashboard 软件打开后，无法找到路由 Not found modem connection to computer through USB. + + + + +## 巡迹 + +1. 录制轨迹保存的路径，是怎么存储的？存储在哪里？ +2. 轨迹是否可以保存多个，如何选择不同的轨迹进行巡迹任务？ +3. 如何调整机器人在巡迹时的速度 + + +*** + +## 定位巡迹-定位标签篇 + +1. Dashboard 软件打开报错
+ +Dashboard 软件由硬件方提供，在不同系统中兼容性有差异，经我方测试稳定性排名： Window XP > Window 7 > Window 10 + +推荐使用 WIN7/XP环境。 + +在 Window 10下有一定几率会出现错误弹窗（见下图），如出现该弹窗，点击abort，多次执行直至正常。 + + + + + +*** + +2. Dashboard 无法唤醒对应id的标签
+ +1. 请检查标签电源是否打开 +2. 如标签距离路由过近，请稍微拿远后再次操作 +3. 如已通电，且有一定距离，仍无法唤醒，请将标签连接到电脑上，使用 Dashboard 进行检查（如下图） + + Channel：是否为 0，如不是则修改 + + Device address：是否与标签上贴的数字一致，如不是则修改 + +  + + + +*** + +3. 唤醒标签后，标签会自动关闭吗
+ +当路由通电工作时不会，当路由断电1min后，所有标签会休眠。 + +*** + +4. 设备插上电脑后，电脑无法识别
+ +定位路由或定位标签（必须要打开电源），插上电脑会自动安装驱动，在设备管理器-端口中，能看到对应设备。 + +如插上后显示不能识别，端口下无设备，请检查数据线是否插紧，确定插紧后仍未识别： + +尝试手动安装驱动，[驱动下载地址](https://marvelmind.com/pics/stm32_vcp.zip)。 + +如手动安装后仍未能识别，请取2个设备，标签/路由，2根数据线，进行交叉测试。 + +判断是数据线，还是设备故障。 + +*** + +5. 路由连接电脑，Dashboard 软件打开后，无法找到路由 Not found modem connection to computer through USB.
+ +请检查在设备管理器-端口中，是否有设备。 + +无如设备，请参见第 4 条。 + +*** + + + +## 定位巡迹-巡迹篇 + + + +录制的轨迹，记录的是机器人在 map 坐标系中的坐标点，将这些坐标点写入到一个文本文件中，存放在 + +`catkin_ws/src/navigation/path_server/path_data` + +巡迹程序执行巡迹的时，读取文件名称为`default_path.path`的文件。 + + +*** + + + +可以，像建图一样，轨迹也会有重命名备份这一操作，在路径文件夹下会存储所有录制成功的轨迹文件。 + +如需选择不同的路径文件，需在使用的时候对其进行重命名为`default_path.path`，程序会自动载入。 + + +*** + + + +说明：机器人行走速度过快，会影响定位标签定位，影响巡迹效果。 + +修改以下文件： + +`src/launch/autolabor_navigation_launch/two_laser_tracking_param/teb_local_planner_params.yaml` + + +``` +max_vel_x: 0.2 //机器人的最大平移速度 +max_vel_x_backwards: 0.2//当向后移动时，机器人的最大绝对平移速度 +max_vel_theta: 0.2//机器人的最大旋转速度 +``` + +修改为 +``` +max_vel_x: 0.8 +max_vel_x_backwards: 0.6 +max_vel_theta: 0.6 +``` + +注：此建议参数为最高值，用户可根据实际使用情况进行调整。 + +*** diff --git a/source/common/q_a/doc4.md b/source/common/q_a/doc4.md new file mode 100644 index 0000000..e69de29 diff --git a/source/common/q_a/imgs/info10.png b/source/common/q_a/imgs/info10.png new file mode 100644 index 0000000..97149bb Binary files /dev/null and b/source/common/q_a/imgs/info10.png differ diff --git a/source/common/q_a/imgs/info5.png b/source/common/q_a/imgs/info5.png new file mode 100644 index 0000000..3c8a09d Binary files /dev/null and b/source/common/q_a/imgs/info5.png differ diff --git a/source/common/q_a/imgs/info6.png b/source/common/q_a/imgs/info6.png new file mode 100644 index 0000000..9893687 Binary files /dev/null and b/source/common/q_a/imgs/info6.png differ diff --git a/source/common/q_a/imgs/info7.png b/source/common/q_a/imgs/info7.png new file mode 100644 index 0000000..4ac2650 Binary files /dev/null and b/source/common/q_a/imgs/info7.png differ diff --git a/source/common/q_a/imgs/info8.jpg b/source/common/q_a/imgs/info8.jpg new file mode 100644 index 0000000..4c8ce4a Binary files /dev/null and b/source/common/q_a/imgs/info8.jpg differ diff --git a/source/common/q_a/imgs/info9.png b/source/common/q_a/imgs/info9.png new file mode 100644 index 0000000..34df747 Binary files /dev/null and b/source/common/q_a/imgs/info9.png differ diff --git a/source/conf.json b/source/conf.json index 904376e..4bee112 100644 --- a/source/conf.json +++ b/source/conf.json @@ -123,6 +123,10 @@ { "name": "建图导航", "uri": "common/q_a/doc2" + }, + { + "name": "定位巡迹", + "uri": "common/q_a/doc3" } ], }, diff --git a/source/version_two/google_test.md b/source/version_two/google_test.md deleted file mode 100644 index 9039f26..0000000 --- a/source/version_two/google_test.md +++ /dev/null @@ -1 +0,0 @@ - diff --git a/source/version_two/google_test_en.md b/source/version_two/google_test_en.md deleted file mode 100644 index 7baf654..0000000 --- a/source/version_two/google_test_en.md +++ /dev/null @@ -1 +0,0 @@ - diff --git a/source/version_two/google_test_store.md b/source/version_two/google_test_store.md deleted file mode 100644 index 820d13f..0000000 --- a/source/version_two/google_test_store.md +++ /dev/null @@ -1,2 +0,0 @@ - - diff --git a/source/version_two/google_test_store_en.md b/source/version_two/google_test_store_en.md deleted file mode 100644 index d1b65a0..0000000 --- a/source/version_two/google_test_store_en.md +++ /dev/null @@ -1 +0,0 @@ - diff --git a/source/version_two/google_test_text.md b/source/version_two/google_test_text.md deleted file mode 100644 index ca44fee..0000000 --- a/source/version_two/google_test_text.md +++ /dev/null @@ -1,7 +0,0 @@ -Autolabor Pro 1 导航套件是一个基于ROS的开放式机器人平台，包含机器人底盘、全套传感器及软件系统，已实现了室内外自动导航、Cartographer 建图、路径规划、自动循迹、智能避障等功能。 - -平台搭载了激光雷达、深度相机、高精度定位标签、Mini 计算机等设备，同时预留了接口，可扩展安装GPS、惯导、超声波等传感器，云台、机械臂、抓持器等附件设备。 - -一键式导航操作，极大降低了使用门槛，代码全部开源，软件持续更新，丰富的资料，可帮助使用者快速开始应用开发。 - -[详细了解](http://www.autolabor.com.cn/pro/detail/4) diff --git a/source/version_two/location/guide/doc.md b/source/version_two/location/guide/doc.md index b9fa852..e150cc9 100644 --- a/source/version_two/location/guide/doc.md +++ b/source/version_two/location/guide/doc.md @@ -306,6 +306,9 @@ Channel -> 0 1. 如下次再次使用时，仍是在无需录制轨迹的同一环境中，则可跳过录制路线的步骤，测试完毕后直接执行循迹功能。 2. 如重新录制路径会清除上一次已保存的地图。 + +[>>常见问题](/usedoc/navigationKit2/common/q_a/doc3) + ## 补充知识 #### 恢复出厂配置 diff --git a/source/version_two/location/guide/location_qa.md b/source/version_two/location/guide/location_qa.md deleted file mode 100644 index e773523..0000000 --- a/source/version_two/location/guide/location_qa.md +++ /dev/null @@ -1,34 +0,0 @@ -# 定位路由、标签故障排查流程 - -## 1.设备插上电脑后，电脑无法识别 - -定位路由或定位标签（必须要打开电源），插上电脑会自动安装驱动，在设备管理器-端口中，能看到对应设备。 - -如插上后显示不能识别，端口下无设备，请检查数据线是否插紧，确定插紧后仍未识别： - -尝试手动安装驱动，https://marvelmind.com/pics/stm32_vcp.zip - -如手动安装后仍未能识别，请取2个设备，标签/路由，2根数据线，进行交叉测试。 - -判断是数据线，还是设备故障。 - - -## 2.Dashboard 软件打开故障 - -Dashboard 软件由硬件方提供，目前对于各个系统的兼容性有差异，推荐使用 WIN7/XP环境。 - -如在Win10 系统下遇到以下故障，请点击Abort，再次打开软件，多次Abort尝试后会正常。 - ->Access violation. ->Press OK to ignore and risk data corruption. ->Press Abort to kill the program. - - -## 3.路由连接电脑，Dashboard 软件打开后，无法找到路由 Not found modem connection to computer through USB. - -请检查在设备管理器-端口中，是否有设备。 - -无如设备，请参见第1条。 - - -