diff --git a/docs/_sources/index.md.txt b/docs/_sources/index.md.txt index 7ed21d1..0a4cc45 100644 --- a/docs/_sources/index.md.txt +++ b/docs/_sources/index.md.txt @@ -4,23 +4,23 @@ * 产品介绍 - * [产品概览](introduction/overview/doc.md) - * [规格参数](introduction/tech_specs/doc.md) - * [发货清单](introduction/inthebox/doc.md) + * [产品概览](introduction/overview/doc) + * [规格参数](introduction/tech_specs/doc) + * [发货清单](introduction/inthebox/doc) * 使用指南 - * [收货指南](user_guide/quick_start/receipt.md) - * [组装与测试](user_guide/assembly_test/doc.md) + * [收货指南](user_guide/quick_start/receipt) + * [组装与测试](user_guide/assembly_test/doc) * 快速开始 - * [SLAM建图导航](user_guide/quick_start/slam_doc.md) - * [定位循迹](location/guide/doc.md) + * [SLAM建图导航](user_guide/quick_start/slam_doc) + * [定位循迹](location/guide/doc) * 了解定位系统 - * [定位系统介绍](location\marvelmind\doc.md) - * [定位系统 Dashbord 使用指南](location\dashboard\doc.md) + * [定位系统介绍](location/marvelmind/doc) + * [定位系统 Dashbord 使用指南](location/dashboard/doc) - * [恢复BIOS](user_guide/restore_bios/doc.md) - * [安装OS](user_guide/reinstall_os/doc.md) - * [参考资料](user_guide/reference/doc.md) + * [恢复BIOS](user_guide/restore_bios/doc) + * [安装OS](user_guide/reinstall_os/doc) + * [参考资料](user_guide/reference/doc) diff --git a/docs/_sources/location/guide/doc.md.txt b/docs/_sources/location/guide/doc.md.txt index 19324a3..277fac6 100644 --- a/docs/_sources/location/guide/doc.md.txt +++ b/docs/_sources/location/guide/doc.md.txt @@ -10,10 +10,8 @@ 定位循迹使用的定位系统,能够为机器人、自动驾驶车辆、无人机等设备提供 ±2cm 的定位精度。定位系统覆盖范围与定位标签的配置方式和使用个数有关。 - [>>详细了解定位系统](../marvelmind/doc.md) - ## 操作步骤 1. 搭建定位系统 @@ -29,9 +27,11 @@ 定位标签又称为固定标签,可将标签固定在高处(墙上、支架)或放置在平稳无遮挡的地方,使用的个数取决于用户的需求。 定位标签包含5个超声波换能器,收发各个方向的超声信号。 + ![beacon](imgs/beacon.png) 定位路由是整个定位系统的中心控制器,系统工作时路由必须一直在线,定位路由中没有电池,必须使用供电电源为它供电,如路由没有电源将会影响定位功能。 + ![beacon](imgs/modem.png) [>>详细了解定位标签与路由](../marvelmind/doc.md) diff --git a/docs/_sources/user_guide/assembly_test/doc.md.txt b/docs/_sources/user_guide/assembly_test/doc.md.txt index 80cae9d..48cecea 100644 --- a/docs/_sources/user_guide/assembly_test/doc.md.txt +++ b/docs/_sources/user_guide/assembly_test/doc.md.txt @@ -2,86 +2,76 @@ 本文将引导你安装导航套件并对各部件进行测试 - ## 组装 -详请参照视频 +> 详请参照视频 ### 线材连接 -#### Mini 计算机 +* Mini 计算机 ![](imgs/wire-2.jpg) -#### 显示器 +* 显示器 ![](imgs/wire-1.jpg) -#### 深度相机 +* 深度相机 ![](imgs/wire-3.jpg) -#### 激光雷达 +* 激光雷达 ![](imgs/wire-4.jpg) -#### USB-Hub +* USB-Hub ![](imgs/wire-6.jpg) -注:USB-Hub数据线**必须**插到计算机上**指定插口**(如下图),否则将影响功能。 +> 注:USB-Hub数据线**必须**插到计算机上**指定插口**(如下图),否则将影响功能。 ![](imgs/wire-7.jpg) #### 定位系统 -注: -* 仅室外导航套件含此组件 -* 仅车载定位标签需要进行线材连接 +> 注: +> * 仅室外导航套件含此组件 +> * 仅车载定位标签需要进行线材连接 ![](imgs/wire-5.jpg) - - ### 电气拓扑 ![](./imgs/autolabor_box_v2_electrical_topology.png) > 导航套件(一代) 的 用户请参考: 导航套件(一代)电气拓扑图 - ## 测试 -我们提供了一套工具软件,并将其放置在电脑桌面,你可以用来检测导航套件中各部件能否正常工作 - - +我们提供了一套工具软件,并将其放置在电脑桌面,你可以用来检测导航套件中各部件能否正常工作。 1. 激光雷达测试 - - 2. 深度相机测试 - - 3. 车载定位标签测试 ## 常见问题 -* “电池充电接口、工控机电源接口、Kinect-Hub电源接口可以互换适配器吗?” +* “电池充电接口、工控机电源接口、Kinect-Hub 电源接口可以互换适配器吗?” 少年,劝你别有这么大胆的想法! - 尽管这三者物理外形一致,但电气规格`并不通用`,使用时务必注意,错误的接线方式将会导致设备损坏,甚至危及人身安全 + 尽管这三者物理外形一致,但电气规格**并不通用**,使用时务必注意,错误的接线方式将会导致设备损坏,甚至危及人身安全。 * “为什么风扇噪音非常大?” - 众所周知,AMD旗下CPU最大的特点就是~~发热量大~~ 性能强劲,并且工控机内部结构十分紧凑,只有风扇维持在较高转速才保证系统正常工作 + 众所周知,AMD 旗下 CPU 最大的特点就是~~发热量大~~性能强劲,并且工控机内部结构十分紧凑,只有风扇维持在较高转速才保证系统正常工作。 * “为什么我看不到 Kinect 的数据?” - Kinect-Hub 的数据线另一端必须插在工控机 `USB3.0` 接口上,否则将无法从工控机读取到Kinect的数据 + Kinect-Hub 的数据线另一端必须插在工控机 **USB3.0** 接口上,否则将无法从工控机读取到Kinect的数据。 -* “ USB-Hub 上面的接口不通用吗?(仅 导航套件 二代 用户)” +* “ USB-Hub 上面的接口不通用吗(仅 导航套件 二代 用户)?” - 不通用,组装时务必按照文字提示插入设备,错误的接线方式将无法正常建图、定位、避障,甚至危及人身安全 + 不通用,组装时务必按照文字提示插入设备,错误的接线方式将无法正常建图、定位、避障,甚至危及人身安全。 diff --git a/docs/_sources/user_guide/quick_start/receipt.md.txt b/docs/_sources/user_guide/quick_start/receipt.md.txt index 311c027..92a2be6 100644 --- a/docs/_sources/user_guide/quick_start/receipt.md.txt +++ b/docs/_sources/user_guide/quick_start/receipt.md.txt @@ -2,29 +2,28 @@ ## 检查 -收到货后请不要急于签收,先检查外包装有无破损,如包装破损或贴于外包装上的防震标签感应器显示为红色,请拍照为证,并与快递员一同开箱验货,待确认无误后再签收,如需帮助可联系Autolabor客户服务平台。 +收到货后请不要急于签收,先检查外包装有无破损,如包装破损或贴于外包装上的防震标签感应器显示为红色,请拍照为证,并与快递员一同开箱验货,待确认无误后再签收,如需帮助可联系 Autolabor 客户服务平台。 ![](imgs/slamSet-label.png) # 清点 -收件后打开包装,对照产品装箱单进行清点,如有短缺请于三日内联系客服,过期不补。 - +收件后打开包装,对照产品装箱单进行清点,如有短缺请于**三日内**联系客服,**过期不补**。 ## Mini 计算机 | 名称 | 数量 | -| ------------ | ---- | +| :----------: | :--: | | Autolabor PC | 1 | | 天线 | 1 | -| 计算机电源线 | 1 | +| 计算机电源线 | 1 | ![](imgs/receipt-1.JPG) ## 显示器 -| 名称 | 数量 | -| -------------- | ---- | +| 名称 | 数量 | +| :-----------: | :--: | | 显示器 | 1 | | 360°显示器支架 | 1 | | 显示器视频线 | 1 | @@ -34,66 +33,65 @@ ## 电源模块 -注:深度相机集线器位于电量显示模块的背面,深度相机供电、数据传输使用。 +> 注:深度相机集线器位于电量显示模块的背面,深度相机供电、数据传输使用。 -| 名称 | 数量 | -| -------------- | ---- | +| 名称 | 数量 | +| :-------------------: | :--: | | 电源模块/深度相机集线器 | 1 | ![](imgs/receipt-3-1.JPG) ![](imgs/receipt-3-2.JPG) - ## 深度相机 | 名称 | 数量 | -| -------------- | ---- | -| 相机 | 1 | -| 相机支架 | 1 | -| 深度相机集线盒 | 1 | -| 相机数据线 | 1 | -| 相机电源线 | 1 | +| :-----------: | :--: | +| 相机 | 1 | +| 相机支架 | 1 | +| 深度相机集线盒 | 1 | +| 相机数据线 | 1 | +| 相机电源线 | 1 | ![](imgs/receipt-4.JPG) ## 激光雷达 | 名称 | 数量 | -| -------------- | ---- | -| 激光雷达组件 | 2 | -| 激光雷达数据线 | 2 | +| :------------: | :--: | +| 激光雷达组件 | 2 | +| 激光雷达数据线 | 2 | ![](imgs/receipt-5.JPG) ## USB-Hub -| 名称 | 数量 | -| ---- | ---- | -| USB Hub | 1 | -| USB-Hub数据线 | 1 | -| USB-Hub电源线 | 1 | +| 名称 | 数量 | +| :-----------: | :--: | +| USB Hub | 1 | +| USB-Hub数据线 | 1 | +| USB-Hub电源线 | 1 | ![](imgs/receipt-6.JPG) ## 定位系统 -注:仅室外导航套件含此组件 +> 注:仅室外导航套件含此组件。 -| 名称 | 数量 | -| ---- | ---- | -| 车载定位标签组件 | 1 | -| 车载定位标签支架 | 1 | -| 车载定位标签支架角码 | 3 | -| 定位标签 | 11 | -| 定位标签胶条 | 11 | -| 定位路由 | 1 | +| 名称 | 数量 | +| :------------------: | :--: | +| 车载定位标签组件 | 1 | +| 车载定位标签支架 | 1 | +| 车载定位标签支架角码 | 3 | +| 定位标签 | 11 | +| 定位标签胶条 | 11 | +| 定位路由 | 1 | ![](imgs/receipt-7.JPG) ## 其他 -| 名称 | 数量 | -| ---- | ---- | +| 名称 | 数量 | +| :--------------------: | :--: | | Autolabor OS系统安装U盘 | 1 | | 十字改锥 | 1 | | 内六角扳手 | 2 | @@ -105,7 +103,6 @@ ![](imgs/receipt-8.JPG) - 温馨提示: * 为保障产品售后运输途中的安全,请用户保留原厂外包装箱。 * 收货方收到货物后请进行清点,如有短缺请于三日内联系,过期不补。 diff --git a/docs/_sources/user_guide/quick_start/slam_doc.md.txt b/docs/_sources/user_guide/quick_start/slam_doc.md.txt index d634079..b2d21cc 100644 --- a/docs/_sources/user_guide/quick_start/slam_doc.md.txt +++ b/docs/_sources/user_guide/quick_start/slam_doc.md.txt @@ -1,81 +1,113 @@ # 快速开始 #### 准备工作: -1. AP1导航机器人 + +1. AP1 导航机器人 2. 成套键鼠 ## 操作步骤 ### 一、连接键鼠 + 鼠标键盘建议使用普通成套的无线键鼠,避免有线和无线混合使用。 ### 二、启动系统 -打开电源,打开工控机,等待Autolabor OS系统启动,输入密码autolabor,字母全部是小写,回车。 + +打开电源,打开工控机,等待 Autolabor OS 系统启动,输入密码 autolabor,字母全部是小写,回车。 ### 三、SLAM建图导航 +0. 准备工作: -#### 准备工作: -1. 将AP1控制模式切换到上位机控制,打开急停开关,确保急停开关没有被按下 -2. 禁用工控机无线功能 - 在建图过程中,如果工控机连接了无线网络,当AP1走出无线网络的覆盖区域后,网络连接会自动断开,这将导致AP1控制失控,所以在开始建图之前,为了避免失控,需要将工控机的无线网络连接关闭。 -3. 进入桌面【SLAM建图导航】文件夹 + 1. 将 AP1 控制模式切换到上位机控制,打开急停开关,确保急停开关**没有**被按下 + 2. 禁用工控机无线功能 + > 在建图过程中,如果工控机连接了无线网络,当 AP1 走出无线网络的覆盖区域后,网络连接会自动断开,这将导致AP1控制失控,所以在开始建图之前,为了避免失控,需要将工控机的无线网络连接关闭。 + 3. 进入桌面 `SLAM建图导航` 文件夹 -#### 1. 点击【开始建图】 -RVIZ工具打开,能够看到地图中的AP1,使用键盘的上下左右控制AP1行走,边走边建图,可以看到环境地图随着AP1的行走不断被构建更新。 +1. 点击 `开始建图` -地图中,黑色是不可行走区域,白色是可行走区域,灰色是未知区域,红色是激光雷达实时数据。 +2. 操纵机器人行驶 -#### 2. 建图完毕,点击【保存并停止建图】 + 打开 RVIZ 工具,能够看到地图中的 AP1,使用键盘的上下左右控制 AP1 行走,边走边建图,可以看到环境地图随着 AP1 的行走不断被构建更新。 -#### 3. 点击【开始导航】 -RVIZ工具打开,建好的地图会自动加载。 + 地图中,黑色是不可行走区域,白色是可行走区域,灰色是未知区域,红色是激光雷达实时数据。 -接下来这一步请一定不要忘记,按键盘数字键【0】关闭键盘控制功能,控制方式将切换至导航程序控制,如不切换机器人接收到目标点命令后将不会自动导航行走。 +3. 建图完毕,点击 `保存并停止建图` -点击2D Nav Goal,指定目标位置,拉动鼠标,箭头方向是最终车辆运行至目标的车头朝向,鼠标松开,这样就完成了目标点的指定。 +4. 点击 `开始导航` -目标点给定后在地图中我们能看到一条线,这是规划好的路径。根据这个规划好的路径,AP1向目标点行走。 + 打开 RVIZ 工具,建好的地图会自动加载。 -当AP1已经到达目标点后,再一次使用2D Pose Estimate指定初始位置,设置目标位置,AP1将去到下一个目标点。 + 接下来这一步请一定不要忘记,按键盘数字键 `0` 关闭键盘控制功能,控制方式将切换至导航程序控制,如不切换机器人接收到目标点命令后将不会自动导航行走。 + 点击 `2D Nav Goal`,指定目标位置,拉动鼠标,箭头方向是最终车辆运行至目标的车头朝向,鼠标松开,这样就完成了目标点的指定。 -四、点击【终止导航】,停止导航功能,导航结束。 -之后在同一环境中需要再次使用导航功能时,无须重复建图,点击【开始导航】即可。 + 目标点给定后在地图中我们能看到一条线,这是规划好的路径。根据这个规划好的路径,AP1 向目标点行走。 + + 当AP1已经到达目标点后,再一次使用 `2D Pose Estimate` 指定初始位置,设置目标位置,AP1 将去到下一个目标点。 + +5. 点击 `终止导航`,停止导航功能,导航结束。 + + 之后在同一环境中需要再次使用导航功能时,无须重复建图,点击【开始导航】即可。 #### 常见问题: ##### 建图篇 -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 行走时,AP1 动作异常,动一下停一下 + + 可调整显示器的位置,保持接收器不被遮挡,并调整自己的位置,使接收器可以接收到发送的指令信号,建议使用 USB 延长线或 USB-HUB 将接收器放置在架子的高处,无任何遮挡,便于信号传输。 + +2. 键盘控制,AP1 一动不动 + + 1. 确认已将 AP1 电源总开关打开,急停开关没有被按下,AP1 处于上位机控制模式 + + 2. 新开一个 terminal,执行以下命令,打出关系图,查看键盘节点 + + ```bash + $ rosrun rqt_graph rqt_graph + ``` + + 3. 执行以下命令,上下左右控制键盘看是否会有数据打出,如没有数据打出,说明 AP1 没有接收到键盘发送的指令 + + ```bash + $ rostopic echo /cmd_vel + ``` + + 4. 执行以下命令,确认 event-kbd 的数量,数量大于一个则有问题 + ```bash + $ ll /dev/input/by-path/ + ``` + + ![](imgs/keyboard.png) + + 5. 请排查是否有多个键盘设备,键盘驱动查找的是最后一个连接的键盘,需要将其他(显示为)键盘设备找出来,拔掉(可能是鼠标、机械键盘、混装键鼠) + +3. AP1 不受键盘控制、失控 + + 在开始建图前,需要禁用无线功能。如果没有禁用,AP1 在连接了 WIFI 的状态下开始建图,在地图构建过程中,一旦 AP1 离开无线覆盖区域,无线连接断开,ROS 的网络通信中断就会导致 AP1 失去控制。 ##### 导航篇 -1. 目标点给定后,可能会发生AP1不动或原地转圈,控制台显示【Failed to get a plan/不能规划路径】的红色错误,这可能是有两种原因造成: - * 目标点选择在了障碍物中 - * 车在地图中所处的位置是在障碍物中 - 那么这样的情况,我们可以先尝试重新给定目标点,或者将车换个位置重新给定初始位置。 +1. 目标点给定后,可能会发生 AP1 不动或原地转圈,控制台显示 `Failed to get a plan`/`不能规划路径` 的红色错误,这可能是有两种原因造成: + + * 目标点选择在了障碍物中 + * 车在地图中所处的位置是在障碍物中 + + 那么这样的情况,我们可以先尝试重新给定目标点,或者将车换个位置重新给定初始位置。 + 2. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生 - 这种情况是因为AP1在行走过程中,检测到障碍物,无法到达目标点,这个障碍物有可能是真实的障碍物,也有可能是误检,我们可以先等待观察,AP1会进行自我恢复(不超过一分钟),如果恢复之后AP1仍没有行动,导航已自动停止,此时我们需要重新设置目标点。 + + 这种情况是因为 AP1 在行走过程中,检测到障碍物,无法到达目标点,这个障碍物有可能是真实的障碍物,也有可能是误检,我们可以先等待观察,AP1 会进行自我恢复(不超过一分钟),如果恢复之后 AP1 仍没有行动,导航已自动停止,此时我们需要重新设置目标点。 + 3. 建图效果不佳/地图构建要点 - 在构建地图的过程,以下几点会影响到建图的准确性: - * 轮胎气不足影响里程计数据 - * 运行速度不宜过快,由于激光扫描有一定的频率,车速低时雷达可以扫描到的点更多,构建的地图会更准确一些 - * 走一个来回,增加激光雷达扫描次数,累计更多的数据 - * 地图构建的质量也受环境限制,请尽量选择特征比较明显的环境,玻璃、镜子、楼道、空旷等场景会影响建图效果 - * 构建完成的地图,会发现有些点会飞出,飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去 - * 当场景很大特征不足的时候,需要规划建图路径时,应先走一个小回环,当回环成功后,可以再多走几圈,消除粒子在这个回环的多样性。接下来走下一个回环,直到把整个地图连通成一个大的回环 + + 在构建地图的过程,以下几点会影响到建图的准确性: + + * 轮胎气不足影响里程计数据 + * 运行速度不宜过快,由于激光扫描有一定的频率,车速低时雷达可以扫描到的点更多,构建的地图会更准确一些 + * 走一个来回,增加激光雷达扫描次数,累计更多的数据 + * 地图构建的质量也受环境限制,请尽量选择特征比较明显的环境,玻璃、镜子、楼道、空旷等场景会影响建图效果 + * 构建完成的地图,会发现有些点会飞出,飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去 + * 当场景很大特征不足的时候,需要规划建图路径时,应先走一个小回环,当回环成功后,可以再多走几圈,消除粒子在这个回环的多样性。接下来走下一个回环,直到把整个地图连通成一个大的回环 diff --git a/docs/_sources/user_guide/reinstall_os/doc.md.txt b/docs/_sources/user_guide/reinstall_os/doc.md.txt index 161353a..9234fca 100644 --- a/docs/_sources/user_guide/reinstall_os/doc.md.txt +++ b/docs/_sources/user_guide/reinstall_os/doc.md.txt @@ -1,16 +1,13 @@ # Comming soon - # 重新安装操作系统 https://tower.im/teams/616204/documents/1698/ - - * “我可以把 Autolabor OS 安装到其他硬件平台吗?” - 原则上,Autolabor OS 兼容市面所有 X86/AMD64 架构硬件平台,但我们无法保证其可用性 + 原则上,Autolabor OS 兼容市面所有 X86/AMD64 架构硬件平台,但我们无法保证其可用性。 - 当然我们仍然欢迎你将 Autolabor OS 安装在任何 X86/AMD64 设备上,更欢迎给我们提出兼容性报告 - - 为获得最佳使用体验,推荐使用 Autolabor PC 来搭载 Autolabor OS + 当然我们仍然欢迎你将 Autolabor OS 安装在任何 X86/AMD64 设备上,更欢迎给我们提出兼容性报告。 + + 为获得最佳使用体验,推荐使用 Autolabor PC 来搭载 Autolabor OS。 diff --git a/docs/_sources/user_guide/restore_bios/doc.md.txt b/docs/_sources/user_guide/restore_bios/doc.md.txt index 502a9b7..e011d8f 100644 --- a/docs/_sources/user_guide/restore_bios/doc.md.txt +++ b/docs/_sources/user_guide/restore_bios/doc.md.txt @@ -1,6 +1,6 @@ # 恢复 BIOS - 如果你不小心更改了主板 BIOS 配置,本文将引导你如何恢复主板 BIOS 到最佳设置 + 如果你不小心更改了主板 BIOS 配置,本文将引导你如何恢复主板 BIOS 到最佳设置。 ## 准备 @@ -16,8 +16,8 @@ * “这些操作会导致我的代码/文档/程序丢失吗?” - 不会 + 不会。 * “我可以其他电脑(非 Autolabor PC)上执行这些操作吗” - 你拥有操作的自由,但我们强烈不建议这样做 + 你拥有操作的自由,但我们强烈不建议这样做。 diff --git a/docs/index.html b/docs/index.html index 4f17089..800210d 100644 --- a/docs/index.html +++ b/docs/index.html @@ -174,8 +174,8 @@
  • 了解定位系统

  • 恢复BIOS

  • diff --git a/docs/location/guide/doc.html b/docs/location/guide/doc.html index eae01af..64b0d39 100644 --- a/docs/location/guide/doc.html +++ b/docs/location/guide/doc.html @@ -189,10 +189,10 @@

    定位系统中包含车载定位标签,定位标签,定位路由。

    车载定位标签又称为车载移动定位标签,它安装在车上,随车移动。

    定位标签又称为固定标签,可将标签固定在高处(墙上、支架)或放置在平稳无遮挡的地方,使用的个数取决于用户的需求。

    -

    定位标签包含5个超声波换能器,收发各个方向的超声信号。 -../../_images/beacon.pngbeacon

    -

    定位路由是整个定位系统的中心控制器,系统工作时路由必须一直在线,定位路由中没有电池,必须使用供电电源为它供电,如路由没有电源将会影响定位功能。 -../../_images/modem.pngbeacon

    +

    定位标签包含5个超声波换能器,收发各个方向的超声信号。

    +

    ../../_images/beacon.pngbeacon

    +

    定位路由是整个定位系统的中心控制器,系统工作时路由必须一直在线,定位路由中没有电池,必须使用供电电源为它供电,如路由没有电源将会影响定位功能。

    +

    ../../_images/modem.pngbeacon

    >>详细了解定位标签与路由

    准备工作

    diff --git a/docs/searchindex.js b/docs/searchindex.js index 720c076..24c04b7 100644 --- a/docs/searchindex.js +++ b/docs/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["index","introduction/inthebox/doc","introduction/overview/doc","introduction/tech_specs/doc","location/dashboard/doc","location/guide/doc","location/marvelmind/doc","user_guide/assembly_test/doc","user_guide/quick_start/receipt","user_guide/quick_start/slam_doc","user_guide/reference/doc","user_guide/reinstall_os/doc","user_guide/restore_bios/doc"],envversion:{"sphinx.domains.c":1,"sphinx.domains.changeset":1,"sphinx.domains.cpp":1,"sphinx.domains.javascript":1,"sphinx.domains.math":2,"sphinx.domains.python":1,"sphinx.domains.rst":1,"sphinx.domains.std":1,sphinx:56},filenames:["index.md","introduction\\inthebox\\doc.md","introduction\\overview\\doc.md","introduction\\tech_specs\\doc.md","location\\dashboard\\doc.md","location\\guide\\doc.md","location\\marvelmind\\doc.md","user_guide\\assembly_test\\doc.md","user_guide\\quick_start\\receipt.md","user_guide\\quick_start\\slam_doc.md","user_guide\\reference\\doc.md","user_guide\\reinstall_os\\doc.md","user_guide\\restore_bios\\doc.md"],objects:{},objnames:{},objtypes:{},terms:{"0204":10,"10":[3,10],"1000mah":[3,6],"100m":6,"100mv":3,"1080":3,"10s":5,"11":[1,8],"1100":3,"112":10,"115200":5,"120gb":3,"126":3,"1280":3,"12v":3,"13":3,"15":3,"150w":3,"16":3,"165mm":6,"1698":11,"18":3,"1920":3,"1m":6,"1min":5,"2018":10,"2020":[1,8],"20a":3,"20hz":[3,6],"20m":[3,5,6],"2200g":[3,10],"253":3,"2cm":[3,5,6],"2d":9,"30":3,"300":3,"30m":[3,5,6],"33":[3,6],"36":3,"360":[1,8],"36v":3,"40":3,"424":3,"433mhz":6,"45hz":[3,6],"4gb":3,"512":3,"55":[3,6],"5v":5,"60":3,"616204":11,"65":[3,6],"70":3,"800":3,"8m":5,"default":[4,5],"float":3,"for":4,a2:10,ab350n:[3,10],address:5,ah100b:10,amd64:11,amd:[3,7,10],ap1:[5,9],apu:10,autolabor:[1,3,5,8,9,11,12],beacon:[5,6],bio:0,box:5,by:9,cd:3,chanpinshuomingshuxiazai:10,cm:3,cmd_vel:9,cn:10,com:[3,10],cpu:[3,7,10],cpzx:10,ctrl:4,d10:[3,10],dashboard:[5,6],dashborad:[4,5],dashbord:[0,4],dc:3,ddr4:3,desktop:10,dev:[5,9],devic:5,distanc:4,document:11,doubl:3,driver:4,echo:9,ect:5,enabl:5,enter:4,eras:[4,5],estim:9,event:9,fail:9,faselas:10,fp16:3,fp32:3,fp64:3,fps:3,freez:5,fs:[3,10],ga:[3,10],game:[3,10],get:9,gflop:3,ghz:3,gigabyt:10,goal:9,gpu:3,graphic:10,gxdh:10,half:3,han:10,hedgehog:5,height:5,html:[3,10],http:[3,10,11],hub:[1,5,9],hz:3,id:5,im:11,index:3,ini:4,input:9,interfac:5,kbd:9,kinect:[3,7],led:5,ll:[5,9],load:4,lr1108:3,lt:[3,6],m5:[1,8],m5x12:[1,8],m5x16:[1,8],map:[4,5],mhz:3,micro:5,mini:[1,5],mm:[3,6],mode:5,modem:5,motherboard:10,mydriv:3,nav:9,os:[0,1,8,9,11,12],pair:4,path:9,pc:[1,3,4,8,11,12],plan:9,pose:9,processor:10,product:2,radeon:[3,10],reset:4,rev:10,rgb:3,rion:10,ros:9,rosrun:9,rostop:9,rplidar:10,rqt_graph:9,rule:5,rviz:[5,9],ryzen3:3,ryzen:10,save:4,slam:0,slamtec:10,sleep:4,sp580:3,speed:5,star:10,submap:5,support:10,sync:4,team:11,termin:[5,9],tflop:3,tianti:3,time:4,to:9,todo:4,tof:3,tower:11,uart:5,ubs:5,up:4,usb3:7,usb:[1,3,4,5,6,9],v2:3,vega:[3,10],vim:5,wake:4,wakeup:5,wifi:[3,9,10],www:[3,10],x86:11,zh:10,zhuanti:3},titles:["Autolabor Pro1 \u5bfc\u822a\u5957\u4ef6\u6587\u6863\u4e3b\u9875","\u53d1\u8d27\u6e05\u5355","\u4ea7\u54c1\u6982\u89c8","\u89c4\u683c\u53c2\u6570","Dashboard \u8bf4\u660e","\u5b9a\u4f4d\u5faa\u8ff9","\u5b9a\u4f4d\u7cfb\u7edf","\u7ec4\u88c5\u4e0e\u6d4b\u8bd5","\u6536\u8d27\u6307\u5357","\u5feb\u901f\u5f00\u59cb","\u53c2\u8003\u8d44\u6599","Comming soon","\u6062\u590d BIOS"],titleterms:{autolabor:0,bio:12,com:11,dashboard:4,hub:[7,8],mini:[7,8],pro1:0,slam:9,soon:11,usb:[7,8]}}) \ No newline at end of file +Search.setIndex({docnames:["index","introduction/inthebox/doc","introduction/overview/doc","introduction/tech_specs/doc","location/dashboard/doc","location/guide/doc","location/marvelmind/doc","user_guide/assembly_test/doc","user_guide/quick_start/receipt","user_guide/quick_start/slam_doc","user_guide/reference/doc","user_guide/reinstall_os/doc","user_guide/restore_bios/doc"],envversion:{"sphinx.domains.c":1,"sphinx.domains.changeset":1,"sphinx.domains.cpp":1,"sphinx.domains.javascript":1,"sphinx.domains.math":2,"sphinx.domains.python":1,"sphinx.domains.rst":1,"sphinx.domains.std":1,sphinx:56},filenames:["index.md","introduction\\inthebox\\doc.md","introduction\\overview\\doc.md","introduction\\tech_specs\\doc.md","location\\dashboard\\doc.md","location\\guide\\doc.md","location\\marvelmind\\doc.md","user_guide\\assembly_test\\doc.md","user_guide\\quick_start\\receipt.md","user_guide\\quick_start\\slam_doc.md","user_guide\\reference\\doc.md","user_guide\\reinstall_os\\doc.md","user_guide\\restore_bios\\doc.md"],objects:{},objnames:{},objtypes:{},terms:{"0204":10,"10":[3,10],"1000mah":[3,6],"100m":6,"100mv":3,"1080":3,"10s":5,"11":[1,8],"1100":3,"112":10,"115200":5,"120gb":3,"126":3,"1280":3,"12v":3,"13":3,"15":3,"150w":3,"16":3,"165mm":6,"1698":11,"18":3,"1920":3,"1m":6,"1min":5,"2018":10,"2020":[1,8],"20a":3,"20hz":[3,6],"20m":[3,5,6],"2200g":[3,10],"253":3,"2cm":[3,5,6],"2d":9,"30":3,"300":3,"30m":[3,5,6],"33":[3,6],"36":3,"360":[1,8],"36v":3,"40":3,"424":3,"433mhz":6,"45hz":[3,6],"4gb":3,"512":3,"55":[3,6],"5v":5,"60":3,"616204":11,"65":[3,6],"70":3,"800":3,"8m":5,"default":[4,5],"float":3,"for":4,a2:10,ab350n:[3,10],address:5,ah100b:10,amd64:11,amd:[3,7,10],ap1:[5,9],apu:10,autolabor:[1,3,5,8,9,11,12],beacon:[5,6],bio:0,box:5,by:9,cd:3,chanpinshuomingshuxiazai:10,cm:3,cmd_vel:9,cn:10,com:[3,10],cpu:[3,7,10],cpzx:10,ctrl:4,d10:[3,10],dashboard:[5,6],dashborad:[4,5],dashbord:[0,4],dc:3,ddr4:3,desktop:10,dev:[5,9],devic:5,distanc:4,document:11,doubl:3,driver:4,echo:9,ect:5,enabl:5,enter:4,eras:[4,5],estim:9,event:9,fail:9,faselas:10,fp16:3,fp32:3,fp64:3,fps:3,freez:5,fs:[3,10],ga:[3,10],game:[3,10],get:9,gflop:3,ghz:3,gigabyt:10,goal:9,gpu:3,graphic:10,gxdh:10,half:3,han:10,hedgehog:5,height:5,html:[3,10],http:[3,10,11],hub:[1,5,7,9],hz:3,id:5,im:11,index:3,ini:4,input:9,interfac:5,kbd:9,kinect:[3,7],led:5,ll:[5,9],load:4,lr1108:3,lt:[3,6],m5:[1,8],m5x12:[1,8],m5x16:[1,8],map:[4,5],mhz:3,micro:5,mini:[1,5,7],mm:[3,6],mode:5,modem:5,motherboard:10,mydriv:3,nav:9,os:[0,1,8,9,11,12],pair:4,path:9,pc:[1,3,4,8,11,12],plan:9,pose:9,processor:10,product:2,radeon:[3,10],reset:4,rev:10,rgb:3,rion:10,ros:9,rosrun:9,rostop:9,rplidar:10,rqt_graph:9,rule:5,rviz:[5,9],ryzen3:3,ryzen:10,save:4,slam:0,slamtec:10,sleep:4,sp580:3,speed:5,star:10,submap:5,support:10,sync:4,team:11,termin:[5,9],tflop:3,tianti:3,time:4,to:9,todo:4,tof:3,tower:11,uart:5,ubs:5,up:4,usb3:7,usb:[1,3,4,5,6,7,9],v2:3,vega:[3,10],vim:5,wake:4,wakeup:5,wifi:[3,9,10],www:[3,10],x86:11,zh:10,zhuanti:3},titles:["Autolabor Pro1 \u5bfc\u822a\u5957\u4ef6\u6587\u6863\u4e3b\u9875","\u53d1\u8d27\u6e05\u5355","\u4ea7\u54c1\u6982\u89c8","\u89c4\u683c\u53c2\u6570","Dashboard \u8bf4\u660e","\u5b9a\u4f4d\u5faa\u8ff9","\u5b9a\u4f4d\u7cfb\u7edf","\u7ec4\u88c5\u4e0e\u6d4b\u8bd5","\u6536\u8d27\u6307\u5357","\u5feb\u901f\u5f00\u59cb","\u53c2\u8003\u8d44\u6599","Comming soon","\u6062\u590d BIOS"],titleterms:{autolabor:0,bio:12,com:11,dashboard:4,hub:8,mini:8,pro1:0,slam:9,soon:11,usb:8}}) \ No newline at end of file diff --git a/docs/user_guide/assembly_test/doc.html b/docs/user_guide/assembly_test/doc.html index 8081d2d..3970326 100644 --- a/docs/user_guide/assembly_test/doc.html +++ b/docs/user_guide/assembly_test/doc.html @@ -85,19 +85,14 @@
  • 组装与测试
  • @@ -171,73 +166,79 @@

    组装

    -

    详请参照视频

    +
    +

    详请参照视频

    +

    线材连接

    -
    -

    Mini 计算机

    +
      +
    • Mini 计算机

    • +

    ../../_images/wire-2.jpg

    -
    -
    -

    显示器

    +
      +
    • 显示器

    • +

    ../../_images/wire-1.jpg

    -
    -
    -

    深度相机

    +
      +
    • 深度相机

    • +

    ../../_images/wire-3.jpg

    -
    -
    -

    激光雷达

    +
      +
    • 激光雷达

    • +

    ../../_images/wire-4.jpg

    -
    -
    -

    USB-Hub

    +
      +
    • USB-Hub

    • +

    ../../_images/wire-6.jpg

    -

    注:USB-Hub数据线必须插到计算机上指定插口(如下图),否则将影响功能。

    +
    +

    注:USB-Hub数据线必须插到计算机上指定插口(如下图),否则将影响功能。

    +

    ../../_images/wire-7.jpg

    -
    -
    -

    定位系统

    -

    注:

    +
    +

    定位系统

    +
    +

    注:

    • 仅室外导航套件含此组件

    • 仅车载定位标签需要进行线材连接

    +

    ../../_images/wire-5.jpg

    -
    -

    电气拓扑

    +
    +

    电气拓扑

    ../../_images/autolabor_box_v2_electrical_topology.png

    导航套件(一代) 的 用户请参考: 导航套件(一代)电气拓扑图

    -
    -

    测试

    -

    我们提供了一套工具软件,并将其放置在电脑桌面,你可以用来检测导航套件中各部件能否正常工作

    +
    +

    测试

    +

    我们提供了一套工具软件,并将其放置在电脑桌面,你可以用来检测导航套件中各部件能否正常工作。

    1. 激光雷达测试

    2. 深度相机测试

    3. 车载定位标签测试

    -
    -

    常见问题

    +
    +

    常见问题

      -
    • “电池充电接口、工控机电源接口、Kinect-Hub电源接口可以互换适配器吗?”

      +
    • “电池充电接口、工控机电源接口、Kinect-Hub 电源接口可以互换适配器吗?”

      少年,劝你别有这么大胆的想法!

      -

      尽管这三者物理外形一致,但电气规格并不通用,使用时务必注意,错误的接线方式将会导致设备损坏,甚至危及人身安全

      +

      尽管这三者物理外形一致,但电气规格并不通用,使用时务必注意,错误的接线方式将会导致设备损坏,甚至危及人身安全。

    • “为什么风扇噪音非常大?”

      -

      众所周知,AMD旗下CPU最大的特点就是~~发热量大~~ 性能强劲,并且工控机内部结构十分紧凑,只有风扇维持在较高转速才保证系统正常工作

      +

      众所周知,AMD 旗下 CPU 最大的特点就是~~发热量大~~性能强劲,并且工控机内部结构十分紧凑,只有风扇维持在较高转速才保证系统正常工作。

    • “为什么我看不到 Kinect 的数据?”

      -

      Kinect-Hub 的数据线另一端必须插在工控机 USB3.0 接口上,否则将无法从工控机读取到Kinect的数据

      +

      Kinect-Hub 的数据线另一端必须插在工控机 USB3.0 接口上,否则将无法从工控机读取到Kinect的数据。

    • -
    • “ USB-Hub 上面的接口不通用吗?(仅 导航套件 二代 用户)”

      -

      不通用,组装时务必按照文字提示插入设备,错误的接线方式将无法正常建图、定位、避障,甚至危及人身安全

      +
    • “ USB-Hub 上面的接口不通用吗(仅 导航套件 二代 用户)?”

      +

      不通用,组装时务必按照文字提示插入设备,错误的接线方式将无法正常建图、定位、避障,甚至危及人身安全。

    diff --git a/docs/user_guide/quick_start/receipt.html b/docs/user_guide/quick_start/receipt.html index 2891ffe..98cc957 100644 --- a/docs/user_guide/quick_start/receipt.html +++ b/docs/user_guide/quick_start/receipt.html @@ -165,34 +165,34 @@

    收货指南

    检查

    -

    收到货后请不要急于签收,先检查外包装有无破损,如包装破损或贴于外包装上的防震标签感应器显示为红色,请拍照为证,并与快递员一同开箱验货,待确认无误后再签收,如需帮助可联系Autolabor客户服务平台。

    +

    收到货后请不要急于签收,先检查外包装有无破损,如包装破损或贴于外包装上的防震标签感应器显示为红色,请拍照为证,并与快递员一同开箱验货,待确认无误后再签收,如需帮助可联系 Autolabor 客户服务平台。

    ../../_images/slamSet-label.png

    清点

    -

    收件后打开包装,对照产品装箱单进行清点,如有短缺请于三日内联系客服,过期不补

    +

    收件后打开包装,对照产品装箱单进行清点,如有短缺请于三日内联系客服,过期不补

    Mini 计算机

    - - + + - - + + - - + + - - + +
    名称数量名称数量
    Autolabor PC1Autolabor PC1
    天线1天线1
    计算机电源线1计算机电源线1

    ../../_images/receipt-1.JPG

    @@ -202,44 +202,46 @@ - - + + - - + + - - + + - - + + - - + +
    名称数量名称数量
    显示器1显示器1
    360°显示器支架1360°显示器支架1
    显示器视频线1显示器视频线1
    显示器电源线1显示器电源线1

    ../../_images/receipt-2.JPG

    电源模块

    -

    注:深度相机集线器位于电量显示模块的背面,深度相机供电、数据传输使用。

    +
    +

    注:深度相机集线器位于电量显示模块的背面,深度相机供电、数据传输使用。

    +
    - - + + - - + +
    名称数量名称数量
    电源模块/深度相机集线器1电源模块/深度相机集线器1

    ../../_images/receipt-3-1.JPG @@ -250,30 +252,30 @@ - - + + - - + + - - + + - - + + - - + + - - + +
    名称数量名称数量
    相机1相机1
    相机支架1相机支架1
    深度相机集线盒1深度相机集线盒1
    相机数据线1相机数据线1
    相机电源线1相机电源线1

    ../../_images/receipt-4.JPG

    @@ -283,18 +285,18 @@ - - + + - - + + - - + +
    名称数量名称数量
    激光雷达组件2激光雷达组件2
    激光雷达数据线2激光雷达数据线2

    ../../_images/receipt-5.JPG

    @@ -304,60 +306,62 @@ - - + + - - + + - - + + - - + +
    名称数量名称数量
    USB Hub1USB Hub1
    USB-Hub数据线1USB-Hub数据线1
    USB-Hub电源线1USB-Hub电源线1

    ../../_images/receipt-6.JPG

    定位系统

    -

    注:仅室外导航套件含此组件

    +
    +

    注:仅室外导航套件含此组件。

    +
    - - + + - - + + - - + + - - + + - - + + - - + + - - + +
    名称数量名称数量
    车载定位标签组件1车载定位标签组件1
    车载定位标签支架1车载定位标签支架1
    车载定位标签支架角码3车载定位标签支架角码3
    定位标签11定位标签11
    定位标签胶条11定位标签胶条11
    定位路由1定位路由1

    ../../_images/receipt-7.JPG

    @@ -367,42 +371,42 @@ - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + +
    名称数量名称数量
    Autolabor OS系统安装U盘1Autolabor OS系统安装U盘1
    十字改锥1十字改锥1
    内六角扳手2内六角扳手2
    2020角码22020角码2
    M5大滑块2M5大滑块2
    M5小滑块2M5小滑块2
    M5x12螺钉2M5x12螺钉2
    M5x16螺钉2M5x16螺钉2

    ../../_images/receipt-8.JPG

    diff --git a/docs/user_guide/quick_start/slam_doc.html b/docs/user_guide/quick_start/slam_doc.html index 7953585..c6a1466 100644 --- a/docs/user_guide/quick_start/slam_doc.html +++ b/docs/user_guide/quick_start/slam_doc.html @@ -88,13 +88,9 @@
  • 一、连接键鼠
  • 二、启动系统
  • 三、SLAM建图导航
  • 二、启动系统

    -

    打开电源,打开工控机,等待Autolabor OS系统启动,输入密码autolabor,字母全部是小写,回车。

    +

    打开电源,打开工控机,等待 Autolabor OS 系统启动,输入密码 autolabor,字母全部是小写,回车。

    三、SLAM建图导航

    -
    -

    准备工作:

    -
      -
    1. 将AP1控制模式切换到上位机控制,打开急停开关,确保急停开关没有被按下

    2. -
    3. 禁用工控机无线功能 -在建图过程中,如果工控机连接了无线网络,当AP1走出无线网络的覆盖区域后,网络连接会自动断开,这将导致AP1控制失控,所以在开始建图之前,为了避免失控,需要将工控机的无线网络连接关闭。

    4. -
    5. 进入桌面【SLAM建图导航】文件夹

    6. +
        +
      1. 准备工作:

        +
          +
        1. 将 AP1 控制模式切换到上位机控制,打开急停开关,确保急停开关没有被按下

        2. +
        3. 禁用工控机无线功能

          +
          +

          在建图过程中,如果工控机连接了无线网络,当 AP1 走出无线网络的覆盖区域后,网络连接会自动断开,这将导致AP1控制失控,所以在开始建图之前,为了避免失控,需要将工控机的无线网络连接关闭。

          +
          +
        4. +
        5. 进入桌面 SLAM建图导航 文件夹

        -
    -
    -

    1. 点击【开始建图】

    -

    RVIZ工具打开,能够看到地图中的AP1,使用键盘的上下左右控制AP1行走,边走边建图,可以看到环境地图随着AP1的行走不断被构建更新。

    + +
  • 点击 开始建图

  • +
  • 操纵机器人行驶

    +

    打开 RVIZ 工具,能够看到地图中的 AP1,使用键盘的上下左右控制 AP1 行走,边走边建图,可以看到环境地图随着 AP1 的行走不断被构建更新。

    地图中,黑色是不可行走区域,白色是可行走区域,灰色是未知区域,红色是激光雷达实时数据。

    +
  • +
  • 建图完毕,点击 保存并停止建图

  • +
  • 点击 开始导航

    +

    打开 RVIZ 工具,建好的地图会自动加载。

    +

    接下来这一步请一定不要忘记,按键盘数字键 0 关闭键盘控制功能,控制方式将切换至导航程序控制,如不切换机器人接收到目标点命令后将不会自动导航行走。

    +

    点击 2D Nav Goal,指定目标位置,拉动鼠标,箭头方向是最终车辆运行至目标的车头朝向,鼠标松开,这样就完成了目标点的指定。

    +

    目标点给定后在地图中我们能看到一条线,这是规划好的路径。根据这个规划好的路径,AP1 向目标点行走。

    +

    当AP1已经到达目标点后,再一次使用 2D Pose Estimate 指定初始位置,设置目标位置,AP1 将去到下一个目标点。

    +
  • +
  • 点击 终止导航,停止导航功能,导航结束。

    +

    之后在同一环境中需要再次使用导航功能时,无须重复建图,点击【开始导航】即可。

    +
  • + +
    +

    常见问题:

    +
    +
    建图篇
    +
      +
    1. 键盘控制 AP1 行走时,AP1 动作异常,动一下停一下

      +

      可调整显示器的位置,保持接收器不被遮挡,并调整自己的位置,使接收器可以接收到发送的指令信号,建议使用 USB 延长线或 USB-HUB 将接收器放置在架子的高处,无任何遮挡,便于信号传输。

      +
    2. +
    3. 键盘控制,AP1 一动不动

      +
        +
      1. 确认已将 AP1 电源总开关打开,急停开关没有被按下,AP1 处于上位机控制模式

      2. +
      3. 新开一个 terminal,执行以下命令,打出关系图,查看键盘节点

        +
        $ rosrun rqt_graph rqt_graph
        +
        +
        +
      4. +
      5. 执行以下命令,上下左右控制键盘看是否会有数据打出,如没有数据打出,说明 AP1 没有接收到键盘发送的指令

        +
        $ rostopic echo /cmd_vel
        +
        +
        +
      6. +
      7. 执行以下命令,确认 event-kbd 的数量,数量大于一个则有问题

        +
        $ ll /dev/input/by-path/
        +
        +
        +

        ../../_images/keyboard.png

        +
      8. +
      9. 请排查是否有多个键盘设备,键盘驱动查找的是最后一个连接的键盘,需要将其他(显示为)键盘设备找出来,拔掉(可能是鼠标、机械键盘、混装键鼠)

      10. +
      +
    4. +
    5. AP1 不受键盘控制、失控

      +

      在开始建图前,需要禁用无线功能。如果没有禁用,AP1 在连接了 WIFI 的状态下开始建图,在地图构建过程中,一旦 AP1 离开无线覆盖区域,无线连接断开,ROS 的网络通信中断就会导致 AP1 失去控制。

      +
    6. +
    -

    2. 建图完毕,点击【保存并停止建图】

    -
    -
    -

    3. 点击【开始导航】

    -

    RVIZ工具打开,建好的地图会自动加载。

    -

    接下来这一步请一定不要忘记,按键盘数字键【0】关闭键盘控制功能,控制方式将切换至导航程序控制,如不切换机器人接收到目标点命令后将不会自动导航行走。

    -

    点击2D Nav Goal,指定目标位置,拉动鼠标,箭头方向是最终车辆运行至目标的车头朝向,鼠标松开,这样就完成了目标点的指定。

    -

    目标点给定后在地图中我们能看到一条线,这是规划好的路径。根据这个规划好的路径,AP1向目标点行走。

    -

    当AP1已经到达目标点后,再一次使用2D Pose Estimate指定初始位置,设置目标位置,AP1将去到下一个目标点。

    -

    四、点击【终止导航】,停止导航功能,导航结束。 -之后在同一环境中需要再次使用导航功能时,无须重复建图,点击【开始导航】即可。

    -
    -
    -

    常见问题:

    -
    -
    建图篇
    -
      -
    1. 键盘控制AP1行走时,AP1动作异常,动一下停一下 -可调整显示器的位置,保持接收器不被遮挡,并调整自己的位置,使接收器可以接收到发送的指令信号,建议使用USB延长线或USB-HUB将接收器放置在架子的高处,无任何遮挡,便于信号传输。

    2. -
    3. 键盘控制,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/ -../../_images/keyboard.png -e) 请排查是否有多个键盘设备,键盘驱动查找的是最后一个连接的键盘,需要将其他(显示为)键盘的设备找出来,拔掉(可能是鼠标、机械键盘、混装键鼠)

    4. -
    5. AP1不受键盘控制、失控 -在开始建图前,需要禁用无线功能。如果没有禁用,AP1在连接了WIFI的状态下开始建图,在地图构建过程中,一旦AP1离开无线覆盖区域,无线连接断开,ROS的网络通信中断就会导致AP1控制失控。

    6. -
    -
    -
    -
    导航篇
    -
      -
    1. 目标点给定后,可能会发生AP1不动或原地转圈,控制台显示【Failed to get a plan/不能规划路径】的红色错误,这可能是有两种原因造成:

    2. -
    +
    导航篇
    +
      +
    1. 目标点给定后,可能会发生 AP1 不动或原地转圈,控制台显示 Failed to get a plan/不能规划路径 的红色错误,这可能是有两种原因造成:

      • 目标点选择在了障碍物中

      • -
      • 车在地图中所处的位置是在障碍物中 -那么这样的情况,我们可以先尝试重新给定目标点,或者将车换个位置重新给定初始位置。

      • +
      • 车在地图中所处的位置是在障碍物中

      -
        -
      1. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生 -这种情况是因为AP1在行走过程中,检测到障碍物,无法到达目标点,这个障碍物有可能是真实的障碍物,也有可能是误检,我们可以先等待观察,AP1会进行自我恢复(不超过一分钟),如果恢复之后AP1仍没有行动,导航已自动停止,此时我们需要重新设置目标点。

      2. -
      3. 建图效果不佳/地图构建要点 -在构建地图的过程,以下几点会影响到建图的准确性:

      4. -
      +

      那么这样的情况,我们可以先尝试重新给定目标点,或者将车换个位置重新给定初始位置。

      +
    2. +
    3. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生

      +

      这种情况是因为 AP1 在行走过程中,检测到障碍物,无法到达目标点,这个障碍物有可能是真实的障碍物,也有可能是误检,我们可以先等待观察,AP1 会进行自我恢复(不超过一分钟),如果恢复之后 AP1 仍没有行动,导航已自动停止,此时我们需要重新设置目标点。

      +
    4. +
    5. 建图效果不佳/地图构建要点

      +

      在构建地图的过程,以下几点会影响到建图的准确性:

      • 轮胎气不足影响里程计数据

      • 运行速度不宜过快,由于激光扫描有一定的频率,车速低时雷达可以扫描到的点更多,构建的地图会更准确一些

      • @@ -260,6 +271,8 @@ e) 请排查是否有多个键盘设备,键盘驱动查找的是最后一个
      • 构建完成的地图,会发现有些点会飞出,飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去

      • 当场景很大特征不足的时候,需要规划建图路径时,应先走一个小回环,当回环成功后,可以再多走几圈,消除粒子在这个回环的多样性。接下来走下一个回环,直到把整个地图连通成一个大的回环

      +
    6. +
    diff --git a/docs/user_guide/reinstall_os/doc.html b/docs/user_guide/reinstall_os/doc.html index 7ff4f90..dfd2bfa 100644 --- a/docs/user_guide/reinstall_os/doc.html +++ b/docs/user_guide/reinstall_os/doc.html @@ -156,9 +156,9 @@

    https://tower.im/teams/616204/documents/1698/

    • “我可以把 Autolabor OS 安装到其他硬件平台吗?”

      -

      原则上,Autolabor OS 兼容市面所有 X86/AMD64 架构硬件平台,但我们无法保证其可用性

      -

      当然我们仍然欢迎你将 Autolabor OS 安装在任何 X86/AMD64 设备上,更欢迎给我们提出兼容性报告

      -

      为获得最佳使用体验,推荐使用 Autolabor PC 来搭载 Autolabor OS

      +

      原则上,Autolabor OS 兼容市面所有 X86/AMD64 架构硬件平台,但我们无法保证其可用性。

      +

      当然我们仍然欢迎你将 Autolabor OS 安装在任何 X86/AMD64 设备上,更欢迎给我们提出兼容性报告。

      +

      为获得最佳使用体验,推荐使用 Autolabor PC 来搭载 Autolabor OS。

    diff --git a/docs/user_guide/restore_bios/doc.html b/docs/user_guide/restore_bios/doc.html index a089902..9c87605 100644 --- a/docs/user_guide/restore_bios/doc.html +++ b/docs/user_guide/restore_bios/doc.html @@ -154,9 +154,7 @@

    恢复 BIOS

    -
    如果你不小心更改了主板 BIOS 配置,本文将引导你如何恢复主板 BIOS 到最佳设置
    -
    -
    +

    如果你不小心更改了主板 BIOS 配置,本文将引导你如何恢复主板 BIOS 到最佳设置。

    准备

      @@ -174,10 +172,10 @@

      常见问题

      • “这些操作会导致我的代码/文档/程序丢失吗?”

        -

        不会

        +

        不会。

      • “我可以其他电脑(非 Autolabor PC)上执行这些操作吗”

        -

        你拥有操作的自由,但我们强烈不建议这样做

        +

        你拥有操作的自由,但我们强烈不建议这样做。

    diff --git a/source/index.md b/source/index.md index 7ed21d1..0a4cc45 100644 --- a/source/index.md +++ b/source/index.md @@ -4,23 +4,23 @@ * 产品介绍 - * [产品概览](introduction/overview/doc.md) - * [规格参数](introduction/tech_specs/doc.md) - * [发货清单](introduction/inthebox/doc.md) + * [产品概览](introduction/overview/doc) + * [规格参数](introduction/tech_specs/doc) + * [发货清单](introduction/inthebox/doc) * 使用指南 - * [收货指南](user_guide/quick_start/receipt.md) - * [组装与测试](user_guide/assembly_test/doc.md) + * [收货指南](user_guide/quick_start/receipt) + * [组装与测试](user_guide/assembly_test/doc) * 快速开始 - * [SLAM建图导航](user_guide/quick_start/slam_doc.md) - * [定位循迹](location/guide/doc.md) + * [SLAM建图导航](user_guide/quick_start/slam_doc) + * [定位循迹](location/guide/doc) * 了解定位系统 - * [定位系统介绍](location\marvelmind\doc.md) - * [定位系统 Dashbord 使用指南](location\dashboard\doc.md) + * [定位系统介绍](location/marvelmind/doc) + * [定位系统 Dashbord 使用指南](location/dashboard/doc) - * [恢复BIOS](user_guide/restore_bios/doc.md) - * [安装OS](user_guide/reinstall_os/doc.md) - * [参考资料](user_guide/reference/doc.md) + * [恢复BIOS](user_guide/restore_bios/doc) + * [安装OS](user_guide/reinstall_os/doc) + * [参考资料](user_guide/reference/doc) diff --git a/source/location/guide/doc.md b/source/location/guide/doc.md index 19324a3..277fac6 100644 --- a/source/location/guide/doc.md +++ b/source/location/guide/doc.md @@ -10,10 +10,8 @@ 定位循迹使用的定位系统,能够为机器人、自动驾驶车辆、无人机等设备提供 ±2cm 的定位精度。定位系统覆盖范围与定位标签的配置方式和使用个数有关。 - [>>详细了解定位系统](../marvelmind/doc.md) - ## 操作步骤 1. 搭建定位系统 @@ -29,9 +27,11 @@ 定位标签又称为固定标签,可将标签固定在高处(墙上、支架)或放置在平稳无遮挡的地方,使用的个数取决于用户的需求。 定位标签包含5个超声波换能器,收发各个方向的超声信号。 + ![beacon](imgs/beacon.png) 定位路由是整个定位系统的中心控制器,系统工作时路由必须一直在线,定位路由中没有电池,必须使用供电电源为它供电,如路由没有电源将会影响定位功能。 + ![beacon](imgs/modem.png) [>>详细了解定位标签与路由](../marvelmind/doc.md) diff --git a/source/user_guide/assembly_test/doc.md b/source/user_guide/assembly_test/doc.md index 80cae9d..48cecea 100644 --- a/source/user_guide/assembly_test/doc.md +++ b/source/user_guide/assembly_test/doc.md @@ -2,86 +2,76 @@ 本文将引导你安装导航套件并对各部件进行测试 - ## 组装 -详请参照视频 +> 详请参照视频 ### 线材连接 -#### Mini 计算机 +* Mini 计算机 ![](imgs/wire-2.jpg) -#### 显示器 +* 显示器 ![](imgs/wire-1.jpg) -#### 深度相机 +* 深度相机 ![](imgs/wire-3.jpg) -#### 激光雷达 +* 激光雷达 ![](imgs/wire-4.jpg) -#### USB-Hub +* USB-Hub ![](imgs/wire-6.jpg) -注:USB-Hub数据线**必须**插到计算机上**指定插口**(如下图),否则将影响功能。 +> 注:USB-Hub数据线**必须**插到计算机上**指定插口**(如下图),否则将影响功能。 ![](imgs/wire-7.jpg) #### 定位系统 -注: -* 仅室外导航套件含此组件 -* 仅车载定位标签需要进行线材连接 +> 注: +> * 仅室外导航套件含此组件 +> * 仅车载定位标签需要进行线材连接 ![](imgs/wire-5.jpg) - - ### 电气拓扑 ![](./imgs/autolabor_box_v2_electrical_topology.png) > 导航套件(一代) 的 用户请参考: 导航套件(一代)电气拓扑图 - ## 测试 -我们提供了一套工具软件,并将其放置在电脑桌面,你可以用来检测导航套件中各部件能否正常工作 - - +我们提供了一套工具软件,并将其放置在电脑桌面,你可以用来检测导航套件中各部件能否正常工作。 1. 激光雷达测试 - - 2. 深度相机测试 - - 3. 车载定位标签测试 ## 常见问题 -* “电池充电接口、工控机电源接口、Kinect-Hub电源接口可以互换适配器吗?” +* “电池充电接口、工控机电源接口、Kinect-Hub 电源接口可以互换适配器吗?” 少年,劝你别有这么大胆的想法! - 尽管这三者物理外形一致,但电气规格`并不通用`,使用时务必注意,错误的接线方式将会导致设备损坏,甚至危及人身安全 + 尽管这三者物理外形一致,但电气规格**并不通用**,使用时务必注意,错误的接线方式将会导致设备损坏,甚至危及人身安全。 * “为什么风扇噪音非常大?” - 众所周知,AMD旗下CPU最大的特点就是~~发热量大~~ 性能强劲,并且工控机内部结构十分紧凑,只有风扇维持在较高转速才保证系统正常工作 + 众所周知,AMD 旗下 CPU 最大的特点就是~~发热量大~~性能强劲,并且工控机内部结构十分紧凑,只有风扇维持在较高转速才保证系统正常工作。 * “为什么我看不到 Kinect 的数据?” - Kinect-Hub 的数据线另一端必须插在工控机 `USB3.0` 接口上,否则将无法从工控机读取到Kinect的数据 + Kinect-Hub 的数据线另一端必须插在工控机 **USB3.0** 接口上,否则将无法从工控机读取到Kinect的数据。 -* “ USB-Hub 上面的接口不通用吗?(仅 导航套件 二代 用户)” +* “ USB-Hub 上面的接口不通用吗(仅 导航套件 二代 用户)?” - 不通用,组装时务必按照文字提示插入设备,错误的接线方式将无法正常建图、定位、避障,甚至危及人身安全 + 不通用,组装时务必按照文字提示插入设备,错误的接线方式将无法正常建图、定位、避障,甚至危及人身安全。 diff --git a/source/user_guide/quick_start/receipt.md b/source/user_guide/quick_start/receipt.md index 311c027..92a2be6 100644 --- a/source/user_guide/quick_start/receipt.md +++ b/source/user_guide/quick_start/receipt.md @@ -2,29 +2,28 @@ ## 检查 -收到货后请不要急于签收,先检查外包装有无破损,如包装破损或贴于外包装上的防震标签感应器显示为红色,请拍照为证,并与快递员一同开箱验货,待确认无误后再签收,如需帮助可联系Autolabor客户服务平台。 +收到货后请不要急于签收,先检查外包装有无破损,如包装破损或贴于外包装上的防震标签感应器显示为红色,请拍照为证,并与快递员一同开箱验货,待确认无误后再签收,如需帮助可联系 Autolabor 客户服务平台。 ![](imgs/slamSet-label.png) # 清点 -收件后打开包装,对照产品装箱单进行清点,如有短缺请于三日内联系客服,过期不补。 - +收件后打开包装,对照产品装箱单进行清点,如有短缺请于**三日内**联系客服,**过期不补**。 ## Mini 计算机 | 名称 | 数量 | -| ------------ | ---- | +| :----------: | :--: | | Autolabor PC | 1 | | 天线 | 1 | -| 计算机电源线 | 1 | +| 计算机电源线 | 1 | ![](imgs/receipt-1.JPG) ## 显示器 -| 名称 | 数量 | -| -------------- | ---- | +| 名称 | 数量 | +| :-----------: | :--: | | 显示器 | 1 | | 360°显示器支架 | 1 | | 显示器视频线 | 1 | @@ -34,66 +33,65 @@ ## 电源模块 -注:深度相机集线器位于电量显示模块的背面,深度相机供电、数据传输使用。 +> 注:深度相机集线器位于电量显示模块的背面,深度相机供电、数据传输使用。 -| 名称 | 数量 | -| -------------- | ---- | +| 名称 | 数量 | +| :-------------------: | :--: | | 电源模块/深度相机集线器 | 1 | ![](imgs/receipt-3-1.JPG) ![](imgs/receipt-3-2.JPG) - ## 深度相机 | 名称 | 数量 | -| -------------- | ---- | -| 相机 | 1 | -| 相机支架 | 1 | -| 深度相机集线盒 | 1 | -| 相机数据线 | 1 | -| 相机电源线 | 1 | +| :-----------: | :--: | +| 相机 | 1 | +| 相机支架 | 1 | +| 深度相机集线盒 | 1 | +| 相机数据线 | 1 | +| 相机电源线 | 1 | ![](imgs/receipt-4.JPG) ## 激光雷达 | 名称 | 数量 | -| -------------- | ---- | -| 激光雷达组件 | 2 | -| 激光雷达数据线 | 2 | +| :------------: | :--: | +| 激光雷达组件 | 2 | +| 激光雷达数据线 | 2 | ![](imgs/receipt-5.JPG) ## USB-Hub -| 名称 | 数量 | -| ---- | ---- | -| USB Hub | 1 | -| USB-Hub数据线 | 1 | -| USB-Hub电源线 | 1 | +| 名称 | 数量 | +| :-----------: | :--: | +| USB Hub | 1 | +| USB-Hub数据线 | 1 | +| USB-Hub电源线 | 1 | ![](imgs/receipt-6.JPG) ## 定位系统 -注:仅室外导航套件含此组件 +> 注:仅室外导航套件含此组件。 -| 名称 | 数量 | -| ---- | ---- | -| 车载定位标签组件 | 1 | -| 车载定位标签支架 | 1 | -| 车载定位标签支架角码 | 3 | -| 定位标签 | 11 | -| 定位标签胶条 | 11 | -| 定位路由 | 1 | +| 名称 | 数量 | +| :------------------: | :--: | +| 车载定位标签组件 | 1 | +| 车载定位标签支架 | 1 | +| 车载定位标签支架角码 | 3 | +| 定位标签 | 11 | +| 定位标签胶条 | 11 | +| 定位路由 | 1 | ![](imgs/receipt-7.JPG) ## 其他 -| 名称 | 数量 | -| ---- | ---- | +| 名称 | 数量 | +| :--------------------: | :--: | | Autolabor OS系统安装U盘 | 1 | | 十字改锥 | 1 | | 内六角扳手 | 2 | @@ -105,7 +103,6 @@ ![](imgs/receipt-8.JPG) - 温馨提示: * 为保障产品售后运输途中的安全,请用户保留原厂外包装箱。 * 收货方收到货物后请进行清点,如有短缺请于三日内联系,过期不补。 diff --git a/source/user_guide/quick_start/slam_doc.md b/source/user_guide/quick_start/slam_doc.md index d634079..b2d21cc 100644 --- a/source/user_guide/quick_start/slam_doc.md +++ b/source/user_guide/quick_start/slam_doc.md @@ -1,81 +1,113 @@ # 快速开始 #### 准备工作: -1. AP1导航机器人 + +1. AP1 导航机器人 2. 成套键鼠 ## 操作步骤 ### 一、连接键鼠 + 鼠标键盘建议使用普通成套的无线键鼠,避免有线和无线混合使用。 ### 二、启动系统 -打开电源,打开工控机,等待Autolabor OS系统启动,输入密码autolabor,字母全部是小写,回车。 + +打开电源,打开工控机,等待 Autolabor OS 系统启动,输入密码 autolabor,字母全部是小写,回车。 ### 三、SLAM建图导航 +0. 准备工作: -#### 准备工作: -1. 将AP1控制模式切换到上位机控制,打开急停开关,确保急停开关没有被按下 -2. 禁用工控机无线功能 - 在建图过程中,如果工控机连接了无线网络,当AP1走出无线网络的覆盖区域后,网络连接会自动断开,这将导致AP1控制失控,所以在开始建图之前,为了避免失控,需要将工控机的无线网络连接关闭。 -3. 进入桌面【SLAM建图导航】文件夹 + 1. 将 AP1 控制模式切换到上位机控制,打开急停开关,确保急停开关**没有**被按下 + 2. 禁用工控机无线功能 + > 在建图过程中,如果工控机连接了无线网络,当 AP1 走出无线网络的覆盖区域后,网络连接会自动断开,这将导致AP1控制失控,所以在开始建图之前,为了避免失控,需要将工控机的无线网络连接关闭。 + 3. 进入桌面 `SLAM建图导航` 文件夹 -#### 1. 点击【开始建图】 -RVIZ工具打开,能够看到地图中的AP1,使用键盘的上下左右控制AP1行走,边走边建图,可以看到环境地图随着AP1的行走不断被构建更新。 +1. 点击 `开始建图` -地图中,黑色是不可行走区域,白色是可行走区域,灰色是未知区域,红色是激光雷达实时数据。 +2. 操纵机器人行驶 -#### 2. 建图完毕,点击【保存并停止建图】 + 打开 RVIZ 工具,能够看到地图中的 AP1,使用键盘的上下左右控制 AP1 行走,边走边建图,可以看到环境地图随着 AP1 的行走不断被构建更新。 -#### 3. 点击【开始导航】 -RVIZ工具打开,建好的地图会自动加载。 + 地图中,黑色是不可行走区域,白色是可行走区域,灰色是未知区域,红色是激光雷达实时数据。 -接下来这一步请一定不要忘记,按键盘数字键【0】关闭键盘控制功能,控制方式将切换至导航程序控制,如不切换机器人接收到目标点命令后将不会自动导航行走。 +3. 建图完毕,点击 `保存并停止建图` -点击2D Nav Goal,指定目标位置,拉动鼠标,箭头方向是最终车辆运行至目标的车头朝向,鼠标松开,这样就完成了目标点的指定。 +4. 点击 `开始导航` -目标点给定后在地图中我们能看到一条线,这是规划好的路径。根据这个规划好的路径,AP1向目标点行走。 + 打开 RVIZ 工具,建好的地图会自动加载。 -当AP1已经到达目标点后,再一次使用2D Pose Estimate指定初始位置,设置目标位置,AP1将去到下一个目标点。 + 接下来这一步请一定不要忘记,按键盘数字键 `0` 关闭键盘控制功能,控制方式将切换至导航程序控制,如不切换机器人接收到目标点命令后将不会自动导航行走。 + 点击 `2D Nav Goal`,指定目标位置,拉动鼠标,箭头方向是最终车辆运行至目标的车头朝向,鼠标松开,这样就完成了目标点的指定。 -四、点击【终止导航】,停止导航功能,导航结束。 -之后在同一环境中需要再次使用导航功能时,无须重复建图,点击【开始导航】即可。 + 目标点给定后在地图中我们能看到一条线,这是规划好的路径。根据这个规划好的路径,AP1 向目标点行走。 + + 当AP1已经到达目标点后,再一次使用 `2D Pose Estimate` 指定初始位置,设置目标位置,AP1 将去到下一个目标点。 + +5. 点击 `终止导航`,停止导航功能,导航结束。 + + 之后在同一环境中需要再次使用导航功能时,无须重复建图,点击【开始导航】即可。 #### 常见问题: ##### 建图篇 -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 行走时,AP1 动作异常,动一下停一下 + + 可调整显示器的位置,保持接收器不被遮挡,并调整自己的位置,使接收器可以接收到发送的指令信号,建议使用 USB 延长线或 USB-HUB 将接收器放置在架子的高处,无任何遮挡,便于信号传输。 + +2. 键盘控制,AP1 一动不动 + + 1. 确认已将 AP1 电源总开关打开,急停开关没有被按下,AP1 处于上位机控制模式 + + 2. 新开一个 terminal,执行以下命令,打出关系图,查看键盘节点 + + ```bash + $ rosrun rqt_graph rqt_graph + ``` + + 3. 执行以下命令,上下左右控制键盘看是否会有数据打出,如没有数据打出,说明 AP1 没有接收到键盘发送的指令 + + ```bash + $ rostopic echo /cmd_vel + ``` + + 4. 执行以下命令,确认 event-kbd 的数量,数量大于一个则有问题 + ```bash + $ ll /dev/input/by-path/ + ``` + + ![](imgs/keyboard.png) + + 5. 请排查是否有多个键盘设备,键盘驱动查找的是最后一个连接的键盘,需要将其他(显示为)键盘设备找出来,拔掉(可能是鼠标、机械键盘、混装键鼠) + +3. AP1 不受键盘控制、失控 + + 在开始建图前,需要禁用无线功能。如果没有禁用,AP1 在连接了 WIFI 的状态下开始建图,在地图构建过程中,一旦 AP1 离开无线覆盖区域,无线连接断开,ROS 的网络通信中断就会导致 AP1 失去控制。 ##### 导航篇 -1. 目标点给定后,可能会发生AP1不动或原地转圈,控制台显示【Failed to get a plan/不能规划路径】的红色错误,这可能是有两种原因造成: - * 目标点选择在了障碍物中 - * 车在地图中所处的位置是在障碍物中 - 那么这样的情况,我们可以先尝试重新给定目标点,或者将车换个位置重新给定初始位置。 +1. 目标点给定后,可能会发生 AP1 不动或原地转圈,控制台显示 `Failed to get a plan`/`不能规划路径` 的红色错误,这可能是有两种原因造成: + + * 目标点选择在了障碍物中 + * 车在地图中所处的位置是在障碍物中 + + 那么这样的情况,我们可以先尝试重新给定目标点,或者将车换个位置重新给定初始位置。 + 2. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生 - 这种情况是因为AP1在行走过程中,检测到障碍物,无法到达目标点,这个障碍物有可能是真实的障碍物,也有可能是误检,我们可以先等待观察,AP1会进行自我恢复(不超过一分钟),如果恢复之后AP1仍没有行动,导航已自动停止,此时我们需要重新设置目标点。 + + 这种情况是因为 AP1 在行走过程中,检测到障碍物,无法到达目标点,这个障碍物有可能是真实的障碍物,也有可能是误检,我们可以先等待观察,AP1 会进行自我恢复(不超过一分钟),如果恢复之后 AP1 仍没有行动,导航已自动停止,此时我们需要重新设置目标点。 + 3. 建图效果不佳/地图构建要点 - 在构建地图的过程,以下几点会影响到建图的准确性: - * 轮胎气不足影响里程计数据 - * 运行速度不宜过快,由于激光扫描有一定的频率,车速低时雷达可以扫描到的点更多,构建的地图会更准确一些 - * 走一个来回,增加激光雷达扫描次数,累计更多的数据 - * 地图构建的质量也受环境限制,请尽量选择特征比较明显的环境,玻璃、镜子、楼道、空旷等场景会影响建图效果 - * 构建完成的地图,会发现有些点会飞出,飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去 - * 当场景很大特征不足的时候,需要规划建图路径时,应先走一个小回环,当回环成功后,可以再多走几圈,消除粒子在这个回环的多样性。接下来走下一个回环,直到把整个地图连通成一个大的回环 + + 在构建地图的过程,以下几点会影响到建图的准确性: + + * 轮胎气不足影响里程计数据 + * 运行速度不宜过快,由于激光扫描有一定的频率,车速低时雷达可以扫描到的点更多,构建的地图会更准确一些 + * 走一个来回,增加激光雷达扫描次数,累计更多的数据 + * 地图构建的质量也受环境限制,请尽量选择特征比较明显的环境,玻璃、镜子、楼道、空旷等场景会影响建图效果 + * 构建完成的地图,会发现有些点会飞出,飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去 + * 当场景很大特征不足的时候,需要规划建图路径时,应先走一个小回环,当回环成功后,可以再多走几圈,消除粒子在这个回环的多样性。接下来走下一个回环,直到把整个地图连通成一个大的回环 diff --git a/source/user_guide/reinstall_os/doc.md b/source/user_guide/reinstall_os/doc.md index 161353a..9234fca 100644 --- a/source/user_guide/reinstall_os/doc.md +++ b/source/user_guide/reinstall_os/doc.md @@ -1,16 +1,13 @@ # Comming soon - # 重新安装操作系统 https://tower.im/teams/616204/documents/1698/ - - * “我可以把 Autolabor OS 安装到其他硬件平台吗?” - 原则上,Autolabor OS 兼容市面所有 X86/AMD64 架构硬件平台,但我们无法保证其可用性 + 原则上,Autolabor OS 兼容市面所有 X86/AMD64 架构硬件平台,但我们无法保证其可用性。 - 当然我们仍然欢迎你将 Autolabor OS 安装在任何 X86/AMD64 设备上,更欢迎给我们提出兼容性报告 - - 为获得最佳使用体验,推荐使用 Autolabor PC 来搭载 Autolabor OS + 当然我们仍然欢迎你将 Autolabor OS 安装在任何 X86/AMD64 设备上,更欢迎给我们提出兼容性报告。 + + 为获得最佳使用体验,推荐使用 Autolabor PC 来搭载 Autolabor OS。 diff --git a/source/user_guide/restore_bios/doc.md b/source/user_guide/restore_bios/doc.md index 502a9b7..e011d8f 100644 --- a/source/user_guide/restore_bios/doc.md +++ b/source/user_guide/restore_bios/doc.md @@ -1,6 +1,6 @@ # 恢复 BIOS - 如果你不小心更改了主板 BIOS 配置,本文将引导你如何恢复主板 BIOS 到最佳设置 + 如果你不小心更改了主板 BIOS 配置,本文将引导你如何恢复主板 BIOS 到最佳设置。 ## 准备 @@ -16,8 +16,8 @@ * “这些操作会导致我的代码/文档/程序丢失吗?” - 不会 + 不会。 * “我可以其他电脑(非 Autolabor PC)上执行这些操作吗” - 你拥有操作的自由,但我们强烈不建议这样做 + 你拥有操作的自由,但我们强烈不建议这样做。