diff --git a/docs/_images/autolabor_box_v1_electrical_topology.png b/docs/_images/autolabor_box_v1_electrical_topology.png deleted file mode 100644 index 8a1799f..0000000 Binary files a/docs/_images/autolabor_box_v1_electrical_topology.png and /dev/null differ diff --git a/docs/_images/autolabor_box_v2_electrical_topology.png b/docs/_images/autolabor_box_v2_electrical_topology.png deleted file mode 100644 index e405827..0000000 Binary files a/docs/_images/autolabor_box_v2_electrical_topology.png and /dev/null differ diff --git a/docs/_images/autolabor_os_desktop.png b/docs/_images/autolabor_os_desktop.png deleted file mode 100644 index 60882f4..0000000 Binary files a/docs/_images/autolabor_os_desktop.png and /dev/null differ diff --git a/docs/_images/backcolor_green1.png b/docs/_images/backcolor_green1.png deleted file mode 100644 index 6d6b36f..0000000 Binary files a/docs/_images/backcolor_green1.png and /dev/null differ diff --git a/docs/_images/backcolor_red1.png b/docs/_images/backcolor_red1.png deleted file mode 100644 index 7332a11..0000000 Binary files a/docs/_images/backcolor_red1.png and /dev/null differ diff --git a/docs/_images/backcolor_white1.png b/docs/_images/backcolor_white1.png deleted file mode 100644 index ba92f43..0000000 Binary files a/docs/_images/backcolor_white1.png and /dev/null differ diff --git a/docs/_images/backcolor_yellow1.png b/docs/_images/backcolor_yellow1.png deleted file mode 100644 index b532eb8..0000000 Binary files a/docs/_images/backcolor_yellow1.png and /dev/null differ diff --git a/docs/_images/beacon2.png b/docs/_images/beacon2.png deleted file mode 100644 index b63c1a6..0000000 Binary files a/docs/_images/beacon2.png and /dev/null differ diff --git a/docs/_images/beacon3.png b/docs/_images/beacon3.png deleted file mode 100644 index 3733011..0000000 Binary files a/docs/_images/beacon3.png and /dev/null differ diff --git a/docs/_images/beacon_settings1.png b/docs/_images/beacon_settings1.png deleted file mode 100644 index b7861cf..0000000 Binary files a/docs/_images/beacon_settings1.png and /dev/null differ diff --git a/docs/_images/control_panel1.png b/docs/_images/control_panel1.png deleted file mode 100644 index d8e14d7..0000000 Binary files a/docs/_images/control_panel1.png and /dev/null differ diff --git a/docs/_images/dashboard1.png b/docs/_images/dashboard1.png deleted file mode 100644 index 69a924e..0000000 Binary files a/docs/_images/dashboard1.png and /dev/null differ diff --git a/docs/_images/device_list1.png b/docs/_images/device_list1.png deleted file mode 100644 index 659238f..0000000 Binary files a/docs/_images/device_list1.png and /dev/null differ diff --git a/docs/_images/device_list_beacon1.png b/docs/_images/device_list_beacon1.png deleted file mode 100644 index b9dda26..0000000 Binary files a/docs/_images/device_list_beacon1.png and /dev/null differ diff --git a/docs/_images/device_list_hedge1.png b/docs/_images/device_list_hedge1.png deleted file mode 100644 index 338b4f0..0000000 Binary files a/docs/_images/device_list_hedge1.png and /dev/null differ diff --git a/docs/_images/display_settings1.png b/docs/_images/display_settings1.png deleted file mode 100644 index 3a071a3..0000000 Binary files a/docs/_images/display_settings1.png and /dev/null differ diff --git a/docs/_images/distance_table1.png b/docs/_images/distance_table1.png deleted file mode 100644 index e086f70..0000000 Binary files a/docs/_images/distance_table1.png and /dev/null differ diff --git a/docs/_images/distance_table_enter1.png b/docs/_images/distance_table_enter1.png deleted file mode 100644 index 765261f..0000000 Binary files a/docs/_images/distance_table_enter1.png and /dev/null differ diff --git a/docs/_images/distance_table_menu1.png b/docs/_images/distance_table_menu1.png deleted file mode 100644 index 91f7238..0000000 Binary files a/docs/_images/distance_table_menu1.png and /dev/null differ diff --git a/docs/_images/imu_test.png b/docs/_images/imu_test.png deleted file mode 100644 index 1e0cc6c..0000000 Binary files a/docs/_images/imu_test.png and /dev/null differ diff --git a/docs/_images/keyboard1.png b/docs/_images/keyboard1.png deleted file mode 100644 index 5fec5be..0000000 Binary files a/docs/_images/keyboard1.png and /dev/null differ diff --git a/docs/_images/keyboard2.png b/docs/_images/keyboard2.png deleted file mode 100644 index 5fec5be..0000000 Binary files a/docs/_images/keyboard2.png and /dev/null differ diff --git a/docs/_images/kinect_test.png b/docs/_images/kinect_test.png deleted file mode 100644 index 8e78ff4..0000000 Binary files a/docs/_images/kinect_test.png and /dev/null differ diff --git a/docs/_images/lidar_test.png b/docs/_images/lidar_test.png deleted file mode 100644 index ed52d24..0000000 Binary files a/docs/_images/lidar_test.png and /dev/null differ diff --git a/docs/_images/location1.png b/docs/_images/location1.png deleted file mode 100644 index 7ad22e0..0000000 Binary files a/docs/_images/location1.png and /dev/null differ diff --git a/docs/_images/map1.png b/docs/_images/map1.png deleted file mode 100644 index 0d78cf5..0000000 Binary files a/docs/_images/map1.png and /dev/null differ diff --git a/docs/_images/map_settings1.png b/docs/_images/map_settings1.png deleted file mode 100644 index cd61e0f..0000000 Binary files a/docs/_images/map_settings1.png and /dev/null differ diff --git a/docs/_images/mirror1.png b/docs/_images/mirror1.png deleted file mode 100644 index 74f3a76..0000000 Binary files a/docs/_images/mirror1.png and /dev/null differ diff --git a/docs/_images/modem2.png b/docs/_images/modem2.png deleted file mode 100644 index 5a22bb1..0000000 Binary files a/docs/_images/modem2.png and /dev/null differ diff --git a/docs/_images/modem3.png b/docs/_images/modem3.png deleted file mode 100644 index 5a22bb1..0000000 Binary files a/docs/_images/modem3.png and /dev/null differ diff --git a/docs/_images/modem_settings1.png b/docs/_images/modem_settings1.png deleted file mode 100644 index 4f2996c..0000000 Binary files a/docs/_images/modem_settings1.png and /dev/null differ diff --git a/docs/_images/product-11.JPG b/docs/_images/product-11.JPG deleted file mode 100644 index cd8503e..0000000 Binary files a/docs/_images/product-11.JPG and /dev/null differ diff --git a/docs/_images/receipt-11.JPG b/docs/_images/receipt-11.JPG deleted file mode 100644 index 8bc1029..0000000 Binary files a/docs/_images/receipt-11.JPG and /dev/null differ diff --git a/docs/_images/receipt-12.JPG b/docs/_images/receipt-12.JPG deleted file mode 100644 index 8bc1029..0000000 Binary files a/docs/_images/receipt-12.JPG and /dev/null differ diff --git a/docs/_images/receipt-21.JPG b/docs/_images/receipt-21.JPG deleted file mode 100644 index 07cce89..0000000 Binary files a/docs/_images/receipt-21.JPG and /dev/null differ diff --git a/docs/_images/receipt-22.JPG b/docs/_images/receipt-22.JPG deleted file mode 100644 index 07cce89..0000000 Binary files a/docs/_images/receipt-22.JPG and /dev/null differ diff --git a/docs/_images/receipt-3-11.JPG b/docs/_images/receipt-3-11.JPG deleted file mode 100644 index 74fd592..0000000 Binary files a/docs/_images/receipt-3-11.JPG and /dev/null differ diff --git a/docs/_images/receipt-3-12.JPG b/docs/_images/receipt-3-12.JPG deleted file mode 100644 index 74fd592..0000000 Binary files a/docs/_images/receipt-3-12.JPG and /dev/null differ diff --git a/docs/_images/receipt-3-21.JPG b/docs/_images/receipt-3-21.JPG deleted file mode 100644 index 4be9189..0000000 Binary files a/docs/_images/receipt-3-21.JPG and /dev/null differ diff --git a/docs/_images/receipt-3-22.JPG b/docs/_images/receipt-3-22.JPG deleted file mode 100644 index 4be9189..0000000 Binary files a/docs/_images/receipt-3-22.JPG and /dev/null differ diff --git a/docs/_images/receipt-41.JPG b/docs/_images/receipt-41.JPG deleted file mode 100644 index ef1fbd6..0000000 Binary files a/docs/_images/receipt-41.JPG and /dev/null differ diff --git a/docs/_images/receipt-42.JPG b/docs/_images/receipt-42.JPG deleted file mode 100644 index ef1fbd6..0000000 Binary files a/docs/_images/receipt-42.JPG and /dev/null differ diff --git a/docs/_images/receipt-51.JPG b/docs/_images/receipt-51.JPG deleted file mode 100644 index 06ba757..0000000 Binary files a/docs/_images/receipt-51.JPG and /dev/null differ diff --git a/docs/_images/receipt-61.JPG b/docs/_images/receipt-61.JPG deleted file mode 100644 index ee18c1a..0000000 Binary files a/docs/_images/receipt-61.JPG and /dev/null differ diff --git a/docs/_images/receipt-71.JPG b/docs/_images/receipt-71.JPG deleted file mode 100644 index 67d92b7..0000000 Binary files a/docs/_images/receipt-71.JPG and /dev/null differ diff --git a/docs/_images/receipt-81.JPG b/docs/_images/receipt-81.JPG deleted file mode 100644 index 393e6d7..0000000 Binary files a/docs/_images/receipt-81.JPG and /dev/null differ diff --git a/docs/_images/receipt-82.JPG b/docs/_images/receipt-82.JPG deleted file mode 100644 index 393e6d7..0000000 Binary files a/docs/_images/receipt-82.JPG and /dev/null differ diff --git a/docs/_images/sensor1.png b/docs/_images/sensor1.png deleted file mode 100644 index e67b935..0000000 Binary files a/docs/_images/sensor1.png and /dev/null differ diff --git a/docs/_images/settings1.png b/docs/_images/settings1.png deleted file mode 100644 index 5c7a236..0000000 Binary files a/docs/_images/settings1.png and /dev/null differ diff --git a/docs/_images/slamSet-label1.png b/docs/_images/slamSet-label1.png deleted file mode 100644 index 11dcdda..0000000 Binary files a/docs/_images/slamSet-label1.png and /dev/null differ diff --git a/docs/_images/slamSet-label2.png b/docs/_images/slamSet-label2.png deleted file mode 100644 index 11dcdda..0000000 Binary files a/docs/_images/slamSet-label2.png and /dev/null differ diff --git a/docs/_images/starter_set1.png b/docs/_images/starter_set1.png deleted file mode 100644 index 7eea054..0000000 Binary files a/docs/_images/starter_set1.png and /dev/null differ diff --git a/docs/_images/switch1.png b/docs/_images/switch1.png deleted file mode 100644 index bc69b06..0000000 Binary files a/docs/_images/switch1.png and /dev/null differ diff --git a/docs/_images/wakeup1.png b/docs/_images/wakeup1.png deleted file mode 100644 index 95121cc..0000000 Binary files a/docs/_images/wakeup1.png and /dev/null differ diff --git a/docs/_images/wire-11.jpg b/docs/_images/wire-11.jpg deleted file mode 100644 index 8a54de4..0000000 Binary files a/docs/_images/wire-11.jpg and /dev/null differ diff --git a/docs/_images/wire-21.jpg b/docs/_images/wire-21.jpg deleted file mode 100644 index 74e0074..0000000 Binary files a/docs/_images/wire-21.jpg and /dev/null differ diff --git a/docs/_images/wire-31.jpg b/docs/_images/wire-31.jpg deleted file mode 100644 index 4d5d858..0000000 Binary files a/docs/_images/wire-31.jpg and /dev/null differ diff --git a/docs/_images/wire-41.jpg b/docs/_images/wire-41.jpg deleted file mode 100644 index 77c5ced..0000000 Binary files a/docs/_images/wire-41.jpg and /dev/null differ diff --git a/docs/_images/wire-51.jpg b/docs/_images/wire-51.jpg deleted file mode 100644 index 4121082..0000000 Binary files a/docs/_images/wire-51.jpg and /dev/null differ diff --git a/docs/_images/wire-61.jpg b/docs/_images/wire-61.jpg deleted file mode 100644 index 3a06f46..0000000 Binary files a/docs/_images/wire-61.jpg and /dev/null differ diff --git a/docs/_images/wire-71.jpg b/docs/_images/wire-71.jpg deleted file mode 100644 index 82cd76a..0000000 Binary files a/docs/_images/wire-71.jpg and /dev/null differ diff --git a/docs/_sources/user_guide/install_os/doc.md.txt b/docs/_sources/common/install_os/doc.md.txt similarity index 100% rename from docs/_sources/user_guide/install_os/doc.md.txt rename to docs/_sources/common/install_os/doc.md.txt diff --git a/docs/_sources/common/q&a.md.txt b/docs/_sources/common/q&a.md.txt new file mode 100644 index 0000000..a6b8303 --- /dev/null +++ b/docs/_sources/common/q&a.md.txt @@ -0,0 +1,19 @@ +# 常见问题 + +* “电池充电接口、工控机电源接口、Kinect-Hub 电源接口可以互换适配器吗？” + + 少年，劝你别有这么大胆的想法！ + + 尽管这三者物理外形一致，但电气规格**并不通用**，使用时务必注意，错误的接线方式将会导致设备损坏，甚至危及人身安全。 + +* “为什么风扇噪音非常大？” + + 众所周知，AMD 旗下 CPU 最大的特点就是~~发热量大~~性能强劲，并且工控机内部结构十分紧凑，只有风扇维持在较高转速才保证系统正常工作。 + +* “为什么我看不到 Kinect 的数据？” + + Kinect-Hub 的数据线另一端必须插在工控机 **USB3.0** 接口上，否则将无法从工控机读取到Kinect的数据。 + +* “ USB-Hub 上面的接口不通用吗（仅 导航套件 二代 用户）？” + + 不通用，组装时务必按照文字提示插入设备，错误的接线方式将无法正常建图、定位、避障，甚至危及人身安全。 diff --git a/docs/_sources/user_guide/reference/doc.md.txt b/docs/_sources/common/reference/doc.md.txt similarity index 100% rename from docs/_sources/user_guide/reference/doc.md.txt rename to docs/_sources/common/reference/doc.md.txt diff --git a/docs/_sources/user_guide/restore_bios/doc.md.txt b/docs/_sources/common/restore_bios/doc.md.txt similarity index 100% rename from docs/_sources/user_guide/restore_bios/doc.md.txt rename to docs/_sources/common/restore_bios/doc.md.txt diff --git a/docs/_sources/index.rst.txt b/docs/_sources/index.rst.txt index cd7ecab..149011a 100644 --- a/docs/_sources/index.rst.txt +++ b/docs/_sources/index.rst.txt @@ -51,34 +51,35 @@ Autolabor NavigationKit 文档主页 欢迎查看 Autolabor NavigationKit 官方文档！ + - 产品介绍： - :doc:`introduction/overview/doc` - + - :doc:`introduction/tech_specs/doc` - + - :doc:`introduction/inthebox/doc` - 快速开始： - :doc:`user_guide/quick_start/slam_doc` - + - :doc:`location/guide/doc` - 了解定位系统： - :doc:`location/marvelmind/doc` - + - :doc:`location/dashboard/doc` - 使用说明： - :doc:`user_guide/quick_start/receipt` - + - :doc:`user_guide/assembly_test/doc` - + - :doc:`user_guide/restore_bios/doc` - + - :doc:`user_guide/install_os/doc` - + - :doc:`user_guide/reference/doc` diff --git a/docs/_sources/introduction/inthebox/doc.md.txt b/docs/_sources/introduction/inthebox/doc.md.txt deleted file mode 100644 index f28f9a4..0000000 --- a/docs/_sources/introduction/inthebox/doc.md.txt +++ /dev/null @@ -1,38 +0,0 @@ -# 发货清单 - -| 组件 | 元件 | 数量 | -| --------------------- | ----------------------- | ---- | -| Mini计算机 | Autolabor PC | 1 | -| | 天线 | 1 | -| | 计算机电源线 | 1 | -| 显示器 | 显示器 | 1 | -| | 360°显示器支架 | 1 | -| | 显示器视频线 | 1 | -| | 显示器电源线 | 1 | -| 电源模块 | 电源模块/深度相机集线器 | 1 | -| 深度相机 | 相机 | 1 | -| | 相机支架 | 1 | -| | 深度相机集线盒 | 1 | -| | 相机数据线 | 1 | -| | 相机电源线 | 1 | -| 激光雷达 | 激光雷达组件 | 2 | -| | 激光雷达数据线 | 2 | -| USB-Hub | 4口USB 3.0 Hub | 1 | -| | USB-Hub数据线 | 1 | -| | USB-Hub电源线 | 1 | -| 定位系统 1 | 车载定位标签组件 | 1 | -| | 车载定位标签支架 | 1 | -| | 车载定位标签支架角码 | 3 | -| | 定位标签 | 11 | -| | 定位标签胶条 | 11 | -| | 定位路由 | 1 | -| 其他 | Autolabor OS系统安装U盘 | 1 | -| | 十字改锥 | 1 | -| | 内六角扳手 | 2 | -| | 2020角码 | 2 | -| | M5大滑块 | 2 | -| | M5小滑块 | 2 | -| | M5x12螺钉 | 2 | -| | M5x16螺钉 | 2 | - -1 仅室外导航套件含此组件 diff --git a/docs/_sources/introduction/overview/doc.md.txt b/docs/_sources/introduction/overview/doc.md.txt deleted file mode 100644 index 7c8438f..0000000 --- a/docs/_sources/introduction/overview/doc.md.txt +++ /dev/null @@ -1,3 +0,0 @@ -# 产品概览 - -![[product]](imgs/product-1.JPG) diff --git a/docs/_sources/introduction/tech_specs/doc.md.txt b/docs/_sources/introduction/tech_specs/doc.md.txt deleted file mode 100644 index aab9166..0000000 --- a/docs/_sources/introduction/tech_specs/doc.md.txt +++ /dev/null @@ -1,88 +0,0 @@ -# 规格参数 - -* Autolabor PC - -| 项目 | 规格 | -| ------------------- | --------------- | -| CPU | AMD Ryzen3 2200G | -| 主板 | 技嘉 GA-AB350N-Gaming WIFI| -| 内存 | 威刚 万紫千红 DDR4 4GB | -| 硬盘 | 威刚 SP580 120GB | -| 电源 | 立人 LR1108 (150W) | - -* CPU （AMD Ryzen3 2200G 1） - -| 项目 | 规格 | -| ---------------- | --------------------------| -| 核心频率 | 3.5 GHz | -| 加速频率 | 3.7 GHz | -| 核心/线程 | 4 / 4 | -| GPU核心 | 4 | -| 核显 | Radeon Vega 8 1100 MHz | -| FP16（half） | 2.253 TFLOPS （2：1） | -| FP32（float） | 1,126 GFLOPS | -| FP64（double） | 70.40 GFLOPS （1:16） | - -* 电源组件 - -| 项目 | 规格 | -| ------------------- | --------------- | -| 输入电压 | DC 18-36V | -| 输出电压 | DC 12v | -| 输出电流 | 20A | -| 纹波电压 | < 100mV | - -* 显示器 - -| 项目 | 规格 | -| ------------------- | --------------- | -| 尺寸 | 13.3 英寸 | -| 比例 | 16: 9 | -| 分辨率 | 1920*1080 | -| 亮度 | 300 cd/m² | -| 对比度 | 800: 1 | -| 触摸 | 否 | - -* 激光雷达（FS-D10） - -| 项目 | 规格 | -| ------------------- | --------------- | -| 测量距离 | 0.15-10 m @ 10% | -| 角度分辨率 | 0.36 ° | -| 扫描速度 | 15 Hz | -| 重复精度 | ±3 cm | -| 距离分辨率 | 1 cm | - -* 深度相机（Kinect V2） - -| 项目 | 规格 | -| ------------------- | --------------- | -| 原理 | TOF | -| RGB流 | 1920 x 1280 @ 30 FPS | -| 深度流 | 512 x 424 @ 30 FPS | -| 红外流 | 512 x 424 @ 30 FPS | -| 深度距离 | 0.4 m - 4.5 m | -| 水平视角 | 70 ° | -| 垂直视角 | 60 ° | -| 通信接口 | USB 3.0 | - -* 定位系统 2 - -| 项目 | 规格 | -| ------------------- | --------------- | -| 标签距离 | 30m (理想情况下测试结果) | -| | <20m (常规建图定位建议距离) | -| 定位精度 | 绝对精度：距离的1~3% | -| | 差分精度：±2cm | -| 定位频率 | 1/20Hz ~ 45Hz | -| | 与移动标签到固定标签的距离有关（距离越近频率越高） | -| | 与移动标签的数量有关（数量越多频率越低） | -| 供电 | 内部：1000mAh 锂电池（根据使用情况可续航2天到数月） | -| | 外部：USB供电 | -| 尺寸 | 55 x 55 x 33 mm（含天线：55 x 55 x 65 mm）| - - - -1 附CPU性能天梯图供参考：https://www.mydrivers.com/zhuanti/tianti/cpu/index.html - -2 仅室外导航套件含此功能 diff --git a/docs/_sources/location/dashboard/doc.md.txt b/docs/_sources/location/dashboard/doc.md.txt deleted file mode 100644 index 7003148..0000000 --- a/docs/_sources/location/dashboard/doc.md.txt +++ /dev/null @@ -1,105 +0,0 @@ -# Dashboard 说明 - -## 软件概述 - -使用 Dashborad 软件对定位标签或路由进行设置、构建地图以及查看可视化定位结果。软件界面如下图所示 - -![](imgs/dashboard.png) - -下载地址：TODO - -## 显示设置 - -设置移动标签运动轨迹的显示。 - -![](imgs/display_settings.png) - -## 距离表 - -距离表显示系统中所有定位标签之间的距离。固定标签之间的距离用来计算地图，移动标签与固定标签之间的距离用来计算移动标签在地图中的坐标。固定标签之间的距离可以通过超声自动测量，也可以用户手动测量，下面详细介绍。 - -### 超声自动测量 - -大多数情况下，表中的距离由系统自动测量完成。距离值波动较小且背景色为白色表示测距结果稳定可信，如下图。 - -![](imgs/distance_table.png) - -如果背景色不是白色，根据下文颜色的定义解决对应的问题。 - -只有所有的背景色都是白色的话才能锁定地图（使用这些距离数据构建地图）。 - -### 用户手动测量 - -固定标签之间的距离难以自动测量时，可以通过其他方式手动测量标签间的距离然后输入到距离表格，这种情况下距离背景色为绿色。在要修改的距离上右键点击 `Enter distance for pair` 菜单项完成距离手动输入，如下图。 - -![](imgs/distance_table_menu.png) - -可以看到输入后背景色变为绿色，如下图。 - -![](imgs/distance_table_enter.png) - -背景色定义： - -![](imgs/backcolor_white.png) 白色表示距离可靠，可以锁定地图了。 - -![](imgs/backcolor_yellow.png) 黄色表示测距存在异常，锁定地图前还需要对距离与标签进行检查。 - -![](imgs/backcolor_red.png) 红色表示距离严重错误，不要在此状态下锁定地图。 - -![](imgs/backcolor_green.png) 绿色表示锁定了距离值（手动输入后会自动锁定），可以锁定地图。 - -## 换能器开关 - -对于特定的安装位置与工作范围，只需要部分换能器工作，此时可通过此处关闭不用的换能器。定位标签上换能器分布如下图所示。不能明确需要哪些换能器时，则开启所有换能器。 - -![](imgs/sensor.png) - -## 设备参数设置 - -打开 Dashbord 后，USB 连接定位标签或者路由设置相应参数。 - -> 注意：设备（定位标签/路由）会被电脑识别为串口，请确保安装了相应 USB 串口驱动（安装Dashbord时在安装选项中选中 USB Driver 项）! - -定位标签参数设置如下图，一般情况下只需关注或设置图中注释的参数，其他参数保持默认。 - -![](imgs/beacon_settings.png) - -路由参数设置如下图，一般情况下只需关注或设置图中注释的参数，其他参数保持默认。 - -![](imgs/modem_settings.png) - -## 设备列表 - -设备列表包含系统中所有标签，如下图。 - -![](imgs/device_list.png) - -列表中的设备分为固定标签与移动标签两类。固定标签显示为绿色，移动标签显示为蓝色，右键菜单不同，如下图所示。 - -![](imgs/device_list_beacon.png) ![](imgs/device_list_hedge.png) - -## 地图设置 - -![](imgs/map_settings.png) - -`Save map` 将地图保存为 ini 文件到 "Dashboard 安装路径/maps" - -`Load map` 从 ini 文件加载地图 - -`Erase map` 清除地图 - -## 定位标签快速设置面板 - -![](imgs/control_panel.png) - -`Reset` 重置设备 - -`Sleep` 控制设备进入睡眠模式（省电模式） - -`Wake up` 从睡眠模式唤醒设备 - -`Default` 恢复所有设置到出厂状态 - -`Time sync` 发送 PC 的时间到设备 - -其中 `Reset`、`Sleep`、`Wake up` 可批量设置，按下 Ctrl 键时这三个按钮变为黑体，此时点击按钮对所有设备生效。 diff --git a/docs/_sources/location/guide/doc.md.txt b/docs/_sources/location/guide/doc.md.txt deleted file mode 100644 index 7e56372..0000000 --- a/docs/_sources/location/guide/doc.md.txt +++ /dev/null @@ -1,182 +0,0 @@ -# 定位循迹 - -> 注：仅室外导航套件含此功能 - -## 功能简介 - -定位循迹是机器人循着用户提前录好的轨迹自主行走，行走过程中机器人能够自动躲避障碍物，自动规划路线，达到目标点。可设置多种循迹模式。 - -软件上提供了可视化的操作按钮和开发接口，可在行走途中对机器人发送停止/启动的指令，用户可以根据自己的需要对机器人进行二次开发。 - -定位循迹使用的定位系统，能够为机器人、自动驾驶车辆、无人机等设备提供 ±2cm 的定位精度。定位系统覆盖范围与定位标签的配置方式和使用个数有关。 - -[>>详细了解定位系统](../marvelmind/doc.md) - -## 操作步骤 - -1. 搭建定位系统 -2. 录制轨迹 -3. 开始循迹 - -### 一、搭建定位系统 - -定位系统中包含车载定位标签，定位标签，定位路由。 - -车载定位标签又称为车载移动定位标签，它安装在车上，随车移动。 - -定位标签又称为固定标签，可将标签固定在高处（墙上、支架）或放置在平稳无遮挡的地方，使用的个数取决于用户的需求。 - -定位标签包含5个超声波换能器，收发各个方向的超声信号。 - -![](imgs/beacon.png) - -定位路由是整个定位系统的中心控制器，系统工作时路由必须一直在线，定位路由中没有电池，必须使用供电电源为它供电，如路由没有电源将会影响定位功能。 - -![](imgs/modem.png) - -[>>详细了解定位标签与路由](../marvelmind/doc.md) - -#### 准备工作 - -1. 给定位标签充电 - 打开包装，连接 micro USB 线给定位标签充电，可使用手机充电器(5V)、充电宝(5V)或者电脑 USB 接口充电。充电时定位标签上红色 LED 指示灯闪烁，充满电后停止闪烁。从低电量到充满电大概需要1-2小时。 - -2. 打开定位标签开关 - 两个拨码开关左侧保持远离 LED 指示灯，右侧为电源开关，拨到靠近 LED 指示灯位置为开。 - ![](imgs/switch.png) - -3. 打开软件——Dashborad（[下载]()） - 打开 Dashboard 软件，使用 micro USB 线连接标签或路由到电脑，Dashboard 识别后将会显示配置信息。 - -4. 初始化定位路由 - 使用micro USB 线将定位路由与电脑连接，点击 Dashboard 右下 Default 按钮加载默认配置。 - -5. 初始化定位标签 - 使用micro USB 线将定位标签与电脑连接，点击 Dashboard 右下 Default 按钮加载默认配置，然后查看标签 id (Device address)并标记到标签外壳上方便使用过程中进行区分。也可对标签 id 进行修改，注意不要出现重复的 id。 - 建议将标签 id 从1开始设置，逐个递增。 - -6. 初始化车载定位标签 - 首先执行上一步操作初始化标签，接着配置 Hedgehog mode 设置为 enable，将配置 Interfaces 的第一个子项 UART speed 设置为115200。 - -![](imgs/settings.png) - -#### 开始搭建 - -以室内4个固定标签为例，快速搭建一个小范围的定位系统（需要4个固定标签+1个车载移动标签+1个路由，关闭其他用不到的标签电源开关），步骤如下： - -1. 固定定位标签 - -按照以下规则，将已经打开电源开关的4个固定标签固定到墙壁或其他可安装位置上。 - -* 为减少遮挡的情况，标签位置尽量高，例如1.8m 以上 -* 标签相对地面等高且需要测量出高度值 -* 标签必须两两之间可见（无遮挡、有换能器相对） -* 标签尽量分散开，避免4个标签中有3个甚至全部在一条直线上 -* 建议任意标签之间的距离控制在20m 以内（理论最大30m） -* 移动标签应在固定标签围成的区域内部运动，布置固定标签时还应考虑此因素 - -2. 建立地图 - -打开 Dashboard 连接路由，连接成功后左下角显示 `modem`。 - -如非首次使用，本次标签位置与最后一次建图时位置一致，则可跳过此步骤。 - -如重新建图，则需清除路由中可能已经存储的地图，点击设备列表右侧的 `Erase map` 按钮清除地图，然后点击 `Submap 0` 按钮。 - -3. 点击设备列表中固定标签对应编号唤醒标签，过程大概需要 10 秒 。 - -![](imgs/wakeup.png) - -4. 点击设备列表中某个在线的标签，则右侧列表为该标签的参数设置。依次设置 4 个固定标签的 Height 参数为第 1 步布置的高度，注意单位为**米**。 - -5. 地图会自动构建。等待地图显示中四个绿色固定信标位置基本不再变化、左上角距离表全部为白色、且 `freeze map` 按钮上方显示橙色 `Freeze submap!` 字样后，点击 `freeze map` 按钮锁定地图。如果锁定后的地图与实际情况手性相反（例如地图中从1到2到3是逆时针而实际布置的是顺时针），点击镜像按钮![](imgs/mirror.png)翻转地图。 - -![](imgs/map.png) - -6. 类似第3、4步的操作唤醒车载标签并设置车载标签相对地面的高度。 - -7. 定位系统已经开始工作了，车载移动标签在 Dashboard 中查看运动轨迹。之后使用系统定位已经不再依赖 Dashboard 软件，只要给路由供电，数秒后即可从移动标签的串口读取到定位坐标。 - -> 注： - * 路由连接 Dashboard 可在参数列表中查看所有标签的电量（电压），标签电量过低时界面上会有红色文字提示。 - * 停止使用时路由断电即可，1min 后所有标签会自动进入睡眠状态。长时间不使用时请关闭标签电源开关。 - -以上即完成定位系统的搭建 - -### 二、循迹 - -#### 操作步骤 - -1. 车载定位标签测试 -2. 激光雷达测试 -3. 开始导航 -4. 录制轨迹 -5. 保存轨迹 -6. 开始循迹 -7. 停止循迹 - -##### 车载定位标签测试 - -准备工作： - -* 打开电源模块 -* 打开 Mini 计算机（密码 autolabor ） -* 确保所有线材连接正确 - -1. 确认车载定位标签的 USB 线插正确的 USB-Hub 口上，插上通电后会常亮红色电源灯 -2. 定位系统设置完毕，定位路由开始工作后，车载定位标签上面会闪着红灯，并发出“哒哒哒...”的高频声音，代表标签功能正常 -3. 进入桌面测试文件夹，点击标签测试 -4. 查看 RVIZ 中是否有蓝色的点，如有数据则表示连接正常 - -常见问题： - -* 如果使用软件测试时没有显示蓝色数据会有哪些原因？ - * 车载定位标签的 USB 线没有插在 USB-Hub 的指定接口上 - * USB-Hub 的 USB 线没有插在 Mini 计算机的指定接口上 - * 车载定位标签的波特率设置错误，正确应为设置为115200，回到上文初始化车载定位标签步骤重新设置 - * Mini 计算机 UBS 设备规则有误 -* 如果没有显示蓝色数据，那该如何排查？ - * 打开terminal，执行以下内容，查看是否有"box-3"这个设备 - ```bash - ll /dev/box-3 - ``` - * 如有该设备则检查波特率设置 - * 如没有该设备，则检查线材连接 - * USB-Hub 的指示灯是否亮 - * 如不亮则表示没有插紧 - * 如亮则检查规则文件，执行 - ```bash - vim /ect/rules.d - ``` - -##### 激光雷达测试 - -1. 进入桌面测试文件夹，点击雷达测试 -2. 查看 RVIZ 中是否有黄色激光雷达数据，如有则激光雷达功能正常 - -常见问题： - -* 看不到激光雷达数据？ - * 检查激光雷达的数据线两头的连接是否插紧 - * 检查激光雷达是否插在 USB-Hub上指定的口，前侧雷达插前雷达，后侧雷达插后雷达 - * USB-Hub 数据线是否插在 Mini 计算机正确的插口上，检查电源连接线 - -##### 开始导航 - -1. 打开开始导航，查看 RVIZ 中 AP1 是否显示为纯白色，如有 AP1 的模型则 AP1 连接正常。 -2. 使用键盘控制 AP1 遥控走一段路，如从未录制过轨迹，在走的过程中 AP1 在RVIZ 中会持续跳动，此时 AP1 是在进行地图坐标匹配，当 AP1 不再跳动时，则表示稳定。 -3. 如已经录有历史轨迹，遥控 AP1 走一段后，会直接跳到某一位置，表示 AP1 已经在（定位系统）地图中找到自己的位置 -4. 点击开始录制，控制 AP1 在目标路径上走一圈 -5. 保存轨迹 -6. 按键盘 `0`，点击执行，开始循迹 -7. 如想要停止循迹，按键盘 `9`，点击停止，循迹停止 - -如下次再次使用时，仍是在无需录制轨迹的同一环境中，则可跳过以上 4、5 步骤，无需录制轨迹，测试完毕后直接执行循迹功能。 - -如执行4、5步骤会清楚上一次已保存的地图，请知悉。 - -常见问题： - -* “看不到 AP1？” - * 检查 AP1 是否在上位机控制模式 - * 检查 AP1 数据线是否插紧 diff --git a/docs/_sources/location/marvelmind/doc.md.txt b/docs/_sources/location/marvelmind/doc.md.txt deleted file mode 100644 index cf7259e..0000000 --- a/docs/_sources/location/marvelmind/doc.md.txt +++ /dev/null @@ -1,52 +0,0 @@ -# 定位系统 - -## 产品概要 - -定位系统能够为机器人、自动驾驶车辆、无人机等设备提供 ±2cm 的定位精度。定位系统包含一个由多个固定超声标签构成的基站网络（地图），一个或多个安装在被定位物体上的移动标签和协调整个系统工作的中心路由节点，所有设备之间通过无线电通信。 - -![](imgs/location.png) - -系统通过超声脉冲的飞行时间计算移动标签与固定标签的距离，进而利用三边定位算法计算出移动标签在地图中的位置。固定标签之间也能通过超声测距，因此在合理布置固定标签的情况下，系统能够实现自动建图，避免人工测量距离。 - -![](imgs/starter_set.png) - -## 参数列表 - -| 参数 | 技术指标 | -| ------- | ---------------------------------------------- | -| 标签距离 | 30m (理想情况下测试结果) | -| | <20m (常规建图定位建议距离) | -| 定位精度 | 绝对精度：距离的1~3% | -| | 差分精度：±2cm | -| 定位频率 | 1/20Hz ~ 45Hz | -| | 与移动标签到固定标签的距离有关（距离越近频率越高） | -| | 与移动标签的数量有关（数量越多频率越低） | -| 供电 | 内部：1000mAh 锂电池（根据使用情况可续航2天到数月）| -| | 外部：USB供电 | -| 尺寸 | 55 x 55 x 33 mm（含天线：55 x 55 x 65 mm） | - -## 设备介绍 - -### 定位标签 - -![](imgs/beacon.png) - -一个定位标签包含5个超声波换能器，收发各个方向的超声信号。一个标签可以作为固定标签也可作为移动标签使用，通过 Dashboard 修改配置可以很方便使二者互换。 - -固定标签通常被安装在墙上或者天花板上，并且换能器朝下以提供与机器人尽可能大的无遮挡覆盖区域。 - -应该合理设计固定标签的位置和角度以提供最大的超声信号覆盖范围，系统的定位效果非常依赖固定标签收到的超声信号的质量。 - -建图过程中，固定标签发射并接收超声波信号。地图锁定后定位过程中，固定标签只接收超声波信号，移动标签只发送超声波信号。 - -移动标签放置在被定位对象上，为了尽可能避免遮挡提高覆盖范围，应该水平放置在较高处。任何覆盖物都可能降低超声信号的强度导致系统不能正常工作，因此应完全避免标签换能器被覆盖。 - -### 路由 - -![](imgs/modem.png) - -路由是整个定位系统的中心控制器，系统工作时路由必须一直在线。注意路由没有内置电池，只能使用USB供电。 - -路由的放置位置需要保证无线电信号覆盖所有标签，一般情况下使用默认的天线时能够达到100m 的覆盖半径。降低无线电通信速率并且使用全尺寸（165mm、433MHz）天线能进一步提高覆盖范围。 - -注意路由和标签的距离不能小于0.5-1m，如果需要某个标签与路由距离非常近，则取下标签的天线。 diff --git a/docs/_sources/user_guide/assembly_test/doc.md.txt b/docs/_sources/user_guide/assembly_test/doc.md.txt deleted file mode 100644 index fe11167..0000000 --- a/docs/_sources/user_guide/assembly_test/doc.md.txt +++ /dev/null @@ -1,77 +0,0 @@ -# 组装与测试 - - 本文将引导你安装导航套件并对各部件进行测试 - -## 组装 - -> 详请参照视频 - -### 线材连接 - -* Mini 计算机 - -![](imgs/wire-2.jpg) - -* 显示器 - -![](imgs/wire-1.jpg) - -* 深度相机 - -![](imgs/wire-3.jpg) - -* 激光雷达 - -![](imgs/wire-4.jpg) - -* USB-Hub - -![](imgs/wire-6.jpg) - -> 注：USB-Hub数据线**必须**插到计算机上**指定插口**（如下图），否则将影响功能。 - -![](imgs/wire-7.jpg) - -#### 定位系统 - -> 注： -> * 仅室外导航套件含此组件 -> * 仅车载定位标签需要进行线材连接 - -![](imgs/wire-5.jpg) - -### 电气拓扑 - -![](./imgs/autolabor_navigationkit_v2_electrical_topology.png) - -> 导航套件（一代） 的 用户请参考： 导航套件（一代）电气拓扑图 - -## 测试 - -我们提供了一套工具软件，并将其放置在电脑桌面，你可以用来检测导航套件中各部件能否正常工作。 - -1. 激光雷达测试 - -2. 深度相机测试 - -3. 车载定位标签测试 - -## 常见问题 - -* “电池充电接口、工控机电源接口、Kinect-Hub 电源接口可以互换适配器吗？” - - 少年，劝你别有这么大胆的想法！ - - 尽管这三者物理外形一致，但电气规格**并不通用**，使用时务必注意，错误的接线方式将会导致设备损坏，甚至危及人身安全。 - -* “为什么风扇噪音非常大？” - - 众所周知，AMD 旗下 CPU 最大的特点就是~~发热量大~~性能强劲，并且工控机内部结构十分紧凑，只有风扇维持在较高转速才保证系统正常工作。 - -* “为什么我看不到 Kinect 的数据？” - - Kinect-Hub 的数据线另一端必须插在工控机 **USB3.0** 接口上，否则将无法从工控机读取到Kinect的数据。 - -* “ USB-Hub 上面的接口不通用吗（仅 导航套件 二代 用户）？” - - 不通用，组装时务必按照文字提示插入设备，错误的接线方式将无法正常建图、定位、避障，甚至危及人身安全。 diff --git a/docs/_sources/user_guide/quick_start/receipt.md.txt b/docs/_sources/user_guide/quick_start/receipt.md.txt deleted file mode 100644 index 92a2be6..0000000 --- a/docs/_sources/user_guide/quick_start/receipt.md.txt +++ /dev/null @@ -1,109 +0,0 @@ -# 收货指南 - -## 检查 - -收到货后请不要急于签收，先检查外包装有无破损，如包装破损或贴于外包装上的防震标签感应器显示为红色，请拍照为证，并与快递员一同开箱验货，待确认无误后再签收，如需帮助可联系 Autolabor 客户服务平台。 - -![](imgs/slamSet-label.png) - -# 清点 - -收件后打开包装，对照产品装箱单进行清点，如有短缺请于**三日内**联系客服，**过期不补**。 - -## Mini 计算机 - -| 名称 | 数量 | -| :----------: | :--: | -| Autolabor PC | 1 | -| 天线 | 1 | -| 计算机电源线 | 1 | - -![](imgs/receipt-1.JPG) - -## 显示器 - -| 名称 | 数量 | -| :-----------: | :--: | -| 显示器 | 1 | -| 360°显示器支架 | 1 | -| 显示器视频线 | 1 | -| 显示器电源线 | 1 | - -![](imgs/receipt-2.JPG) - -## 电源模块 - -> 注：深度相机集线器位于电量显示模块的背面，深度相机供电、数据传输使用。 - -| 名称 | 数量 | -| :-------------------: | :--: | -| 电源模块/深度相机集线器 | 1 | - -![](imgs/receipt-3-1.JPG) -![](imgs/receipt-3-2.JPG) - -## 深度相机 - -| 名称 | 数量 | -| :-----------: | :--: | -| 相机 | 1 | -| 相机支架 | 1 | -| 深度相机集线盒 | 1 | -| 相机数据线 | 1 | -| 相机电源线 | 1 | - -![](imgs/receipt-4.JPG) - -## 激光雷达 - -| 名称 | 数量 | -| :------------: | :--: | -| 激光雷达组件 | 2 | -| 激光雷达数据线 | 2 | - -![](imgs/receipt-5.JPG) - -## USB-Hub - -| 名称 | 数量 | -| :-----------: | :--: | -| USB Hub | 1 | -| USB-Hub数据线 | 1 | -| USB-Hub电源线 | 1 | - -![](imgs/receipt-6.JPG) - -## 定位系统 - -> 注：仅室外导航套件含此组件。 - -| 名称 | 数量 | -| :------------------: | :--: | -| 车载定位标签组件 | 1 | -| 车载定位标签支架 | 1 | -| 车载定位标签支架角码 | 3 | -| 定位标签 | 11 | -| 定位标签胶条 | 11 | -| 定位路由 | 1 | - -![](imgs/receipt-7.JPG) - -## 其他 - -| 名称 | 数量 | -| :--------------------: | :--: | -| Autolabor OS系统安装U盘 | 1 | -| 十字改锥 | 1 | -| 内六角扳手 | 2 | -| 2020角码 | 2 | -| M5大滑块 | 2 | -| M5小滑块 | 2 | -| M5x12螺钉 | 2 | -| M5x16螺钉 | 2 | - -![](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 deleted file mode 100644 index b2d21cc..0000000 --- a/docs/_sources/user_guide/quick_start/slam_doc.md.txt +++ /dev/null @@ -1,113 +0,0 @@ -# 快速开始 - -#### 准备工作： - -1. AP1 导航机器人 -2. 成套键鼠 - -## 操作步骤 - -### 一、连接键鼠 - -鼠标键盘建议使用普通成套的无线键鼠，避免有线和无线混合使用。 - -### 二、启动系统 - -打开电源，打开工控机，等待 Autolabor OS 系统启动，输入密码 autolabor，字母全部是小写，回车。 - -### 三、SLAM建图导航 - -0. 准备工作： - - 1. 将 AP1 控制模式切换到上位机控制，打开急停开关，确保急停开关**没有**被按下 - 2. 禁用工控机无线功能 - > 在建图过程中，如果工控机连接了无线网络，当 AP1 走出无线网络的覆盖区域后，网络连接会自动断开，这将导致AP1控制失控，所以在开始建图之前，为了避免失控，需要将工控机的无线网络连接关闭。 - 3. 进入桌面 `SLAM建图导航` 文件夹 - -1. 点击 `开始建图` - -2. 操纵机器人行驶 - - 打开 RVIZ 工具，能够看到地图中的 AP1，使用键盘的上下左右控制 AP1 行走，边走边建图，可以看到环境地图随着 AP1 的行走不断被构建更新。 - - 地图中，黑色是不可行走区域，白色是可行走区域，灰色是未知区域，红色是激光雷达实时数据。 - -3. 建图完毕，点击 `保存并停止建图` - -4. 点击 `开始导航` - - 打开 RVIZ 工具，建好的地图会自动加载。 - - 接下来这一步请一定不要忘记，按键盘数字键 `0` 关闭键盘控制功能，控制方式将切换至导航程序控制，如不切换机器人接收到目标点命令后将不会自动导航行走。 - - 点击 `2D Nav Goal`，指定目标位置，拉动鼠标，箭头方向是最终车辆运行至目标的车头朝向，鼠标松开，这样就完成了目标点的指定。 - - 目标点给定后在地图中我们能看到一条线，这是规划好的路径。根据这个规划好的路径，AP1 向目标点行走。 - - 当AP1已经到达目标点后，再一次使用 `2D Pose Estimate` 指定初始位置，设置目标位置，AP1 将去到下一个目标点。 - -5. 点击 `终止导航`，停止导航功能，导航结束。 - - 之后在同一环境中需要再次使用导航功能时，无须重复建图，点击【开始导航】即可。 - - -#### 常见问题： - -##### 建图篇 - -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`/`不能规划路径` 的红色错误，这可能是有两种原因造成： - - * 目标点选择在了障碍物中 - * 车在地图中所处的位置是在障碍物中 - - 那么这样的情况，我们可以先尝试重新给定目标点，或者将车换个位置重新给定初始位置。 - -2. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生 - - 这种情况是因为 AP1 在行走过程中，检测到障碍物，无法到达目标点，这个障碍物有可能是真实的障碍物，也有可能是误检，我们可以先等待观察，AP1 会进行自我恢复（不超过一分钟），如果恢复之后 AP1 仍没有行动，导航已自动停止，此时我们需要重新设置目标点。 - -3. 建图效果不佳/地图构建要点 - - 在构建地图的过程，以下几点会影响到建图的准确性： - - * 轮胎气不足影响里程计数据 - * 运行速度不宜过快，由于激光扫描有一定的频率，车速低时雷达可以扫描到的点更多，构建的地图会更准确一些 - * 走一个来回，增加激光雷达扫描次数，累计更多的数据 - * 地图构建的质量也受环境限制，请尽量选择特征比较明显的环境，玻璃、镜子、楼道、空旷等场景会影响建图效果 - * 构建完成的地图，会发现有些点会飞出，飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去 - * 当场景很大特征不足的时候，需要规划建图路径时，应先走一个小回环，当回环成功后，可以再多走几圈，消除粒子在这个回环的多样性。接下来走下一个回环，直到把整个地图连通成一个大的回环 diff --git a/docs/_sources/version_one/index.md.txt b/docs/_sources/version_one/index.md.txt deleted file mode 100644 index 1b6727d..0000000 --- a/docs/_sources/version_one/index.md.txt +++ /dev/null @@ -1,19 +0,0 @@ -# Autolabor Pro1 导航套件（一代）使用文档 - -### 目录 - -* [产品介绍]() - -* 使用指南 - - * [组装与测试](user_guide/assembly_test/doc.md) - - * [快速上手]() - - * [常见问题]() - - * [恢复BIOS](../common/restore_bios/doc.md) - - * [安装OS](../common/reinstall_os/doc.md) - - * [参考资料](../common/reference/doc.md) diff --git a/docs/_sources/version_one/quick_start/receipt.md.txt b/docs/_sources/version_one/quick_start/receipt.md.txt deleted file mode 100644 index e625551..0000000 --- a/docs/_sources/version_one/quick_start/receipt.md.txt +++ /dev/null @@ -1,11 +0,0 @@ -# 收货指南 - -## 检查 - -收到货后请不要急于签收，先检查外包装有无破损，如包装破损或贴于外包装上的防震标签感应器显示为红色，请拍照为证，并与快递员一同开箱验货，待确认无误后再签收，如需帮助可联系Autolabor客户服务平台。 - -![](imgs/slamSet-label.png) - -# 清点 - -收件后打开包装，对照产品装箱单进行清点，如有短缺请于三日内联系客服，过期不补。 diff --git a/docs/_sources/version_one/quick_start/slam_doc.md.txt b/docs/_sources/version_one/quick_start/slam_doc.md.txt deleted file mode 100644 index 06abca4..0000000 --- a/docs/_sources/version_one/quick_start/slam_doc.md.txt +++ /dev/null @@ -1,88 +0,0 @@ -# 快速上手 - -#### 准备工作： -1. AP1导航机器人 -2. 成套键鼠 - -## 操作步骤 - -### 一、连接键鼠 -鼠标键盘建议使用普通成套的无线键鼠，避免有线和无线混合使用。 - -### 二、启动系统 -打开电源，打开工控机，等待Autolabor OS系统启动，输入密码autolabor，字母全部是小写，回车。 - -### 三、SLAM建图导航 - - -#### 准备工作： -1. 将AP1控制模式切换到上位机控制，打开急停开关，确保急停开关没有被按下 -2. 禁用工控机无线功能 - 在建图过程中，如果工控机连接了无线网络，当AP1走出无线网络的覆盖区域后，网络连接会自动断开，这将导致AP1控制失控，所以在开始建图之前，为了避免失控，需要将工控机的无线网络连接关闭。 -3. 进入桌面【SLAM建图导航】文件夹 - -#### 1. 点击【开始建图】 -RVIZ工具打开，能够看到地图中的AP1，使用键盘的上下左右控制AP1行走，边走边建图，可以看到环境地图随着AP1的行走不断被构建更新。 - -地图中，黑色是不可行走区域，白色是可行走区域，灰色是未知区域，红色是激光雷达实时数据。 - -#### 2. 建图完毕，点击【保存并停止建图】 - -#### 3. 点击【开始导航】 -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. 定位要走一走 - 2. 建图地图质量不好，障碍物颜色虚，效果好墙面黑色实现 - 3. 周围没有明显的特征信息，使得机器人能够找到自己的位置，开到有折角拐弯或明显标志物附近，能够加速机器人找到自己的位置 -2. 建图白，多走几遍， -3. 镜面，建图 - -1. 目标点给定后，可能会发生AP1不动或原地转圈，控制台显示【Failed to get a plan/不能规划路径】的红色错误，这可能是有两种原因造成： - * 目标点选择在了障碍物中 - * 车在地图中所处的位置是在障碍物中 - 那么这样的情况，我们可以先尝试重新给定目标点，或者将车换个位置重新给定初始位置。 -2. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生 - 这种情况是因为AP1在行走过程中，检测到障碍物，无法到达目标点，这个障碍物有可能是真实的障碍物，也有可能是误检，我们可以先等待观察，AP1会进行自我恢复（不超过一分钟），如果恢复之后AP1仍没有行动，导航已自动停止，此时我们需要重新设置目标点。 -3. 建图效果不佳/地图构建要点 - 在构建地图的过程，以下几点会影响到建图的准确性： - * 轮胎气不足影响里程计数据 - * 运行速度不宜过快，由于激光扫描有一定的频率，车速低时雷达可以扫描到的点更多，构建的地图会更准确一些 - * 走一个来回，增加激光雷达扫描次数，累计更多的数据 - * 地图构建的质量也受环境限制，请尽量选择特征比较明显的环境，玻璃、镜子、楼道、空旷等场景会影响建图效果 - * 构建完成的地图，会发现有些点会飞出，飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去 - * 当场景很大特征不足的时候，需要规划建图路径时，应先走一个小回环，当回环成功后，可以再多走几圈，消除粒子在这个回环的多样性。接下来走下一个回环，直到把整个地图连通成一个大的回环 diff --git a/docs/_sources/version_one/user_guide/assembly_test/doc.md.txt b/docs/_sources/version_one/user_guide/assembly_test/doc.md.txt deleted file mode 100644 index 98c4d87..0000000 --- a/docs/_sources/version_one/user_guide/assembly_test/doc.md.txt +++ /dev/null @@ -1,54 +0,0 @@ -# 组装与测试 - - 本文将引导你安装导航套件并对各部件进行测试 - - -## 组装 - -详请参照视频 - -### 电气拓扑 - -![](imgs/autolabor_box_v1_electrical_topology.png) - -## 测试 - -我们提供了一套工具软件，并将其放置在电脑桌面，用户可以用来检测导航套件中各部件能否正常工作。 - -![](./imgs/autolabor_os_desktop.png) - - -1. 激光雷达测试 - -![](./imgs/lidar_test.png) - - -2. 惯导测试 - -![](./imgs/imu_test.png) - - -3. Kinect测试 - -![](./imgs/kinect_test.png) - -4. 联合测试 - -点击`开始建图`，尝试使用键盘方向键控制小车运动。 - -## 常见问题 - -* “电池充电接口、工控机电源接口、Kinect-Hub电源接口可以互换适配器吗？” - - 少年，劝你别有这么大胆的想法！ - - - 尽管这三者物理外形一致，但电气规格`并不通用`，使用时务必注意，错误的接线方式将会导致设备损坏，甚至危及人身安全。 - -* “为什么风扇噪音非常大？” - - Kinect-Hub 的数据线另一端必须插在工控机 `USB3.0` 接口上，否则将无法从工控机读取到Kinect的数据。 - -* “为什么建图时无法使用键盘控制小车运动？” - - 尝试拔掉多余的鼠标或键盘，最好只保留一把键盘与工控机连接，然后重新尝试建图。 diff --git a/docs/_sources/version_one/user_guide/quick_start/receipt.md.txt b/docs/_sources/version_one/user_guide/quick_start/receipt.md.txt deleted file mode 100644 index d1d24c3..0000000 --- a/docs/_sources/version_one/user_guide/quick_start/receipt.md.txt +++ /dev/null @@ -1,91 +0,0 @@ -# 收货指南 - -## 检查 - -收到货后请不要急于签收，先检查外包装有无破损，如包装破损或贴于外包装上的防震标签感应器显示为红色，请拍照为证，并与快递员一同开箱验货，待确认无误后再签收，如需帮助可联系Autolabor客户服务平台。 - -![](imgs/slamSet-label.png) - -# 清点 - -收件后打开包装，对照产品装箱单进行清点，如有短缺请于三日内联系客服，过期不补。 - - -## Mini 计算机 - -| 名称 | 数量 | -| ------------ | ---- | -| Autolabor PC | 1 | -| 天线 | 1 | -| 计算机电源线 | 1 | - -![](imgs/receipt-1.JPG) - -## 显示器 - -| 名称 | 数量 | -| -------------- | ---- | -| 显示器 | 1 | -| 360°显示器支架 | 1 | -| 显示器视频线 | 1 | -| 显示器电源线 | 1 | - -![](imgs/receipt-2.JPG) - -## 电源模块 - -注：深度相机集线器位于电量显示模块的背面，深度相机供电、数据传输使用。 - -| 名称 | 数量 | -| -------------- | ---- | -| 电源模块/深度相机集线器 | 1 | - -![](imgs/receipt-3-1.JPG) -![](imgs/receipt-3-2.JPG) - - -## 深度相机 - -| 名称 | 数量 | -| -------------- | ---- | -| 相机 | 1 | -| 相机支架 | 1 | -| 深度相机集线盒 | 1 | -| 相机数据线 | 1 | -| 相机电源线 | 1 | - -![](imgs/receipt-4.JPG) - -## 激光雷达 - -| 名称 | 数量 | -| -------------- | ---- | -| 激光雷达组件 | 1 | -| 激光雷达数据线 | 1 | - - - -## 惯导 - - - -## 其他 - -| 名称 | 数量 | -| ---- | ---- | -| Autolabor OS系统安装U盘 | 1 | -| 十字改锥 | 1 | -| 内六角扳手 | 2 | -| 2020角码 | 2 | -| M5大滑块 | 2 | -| M5小滑块 | 2 | -| M5x12螺钉 | 2 | -| M5x16螺钉 | 2 | - -![](imgs/receipt-8.JPG) - - -温馨提示： -* 为保障产品售后运输途中的安全，请用户保留原厂外包装箱。 -* 收货方收到货物后请进行清点，如有短缺请于三日内联系，过期不补。 -* 部分配件可能随版本升级有所改动，但不影响性能，恕不另行通知。 diff --git a/docs/_sources/version_one/user_guide/quick_start/slam_doc.md.txt b/docs/_sources/version_one/user_guide/quick_start/slam_doc.md.txt deleted file mode 100644 index 25c6c07..0000000 --- a/docs/_sources/version_one/user_guide/quick_start/slam_doc.md.txt +++ /dev/null @@ -1,88 +0,0 @@ -# 快速开始 - -#### 准备工作： -1. AP1导航机器人 -2. 成套键鼠 - -## 操作步骤 - -### 一、连接键鼠 -鼠标键盘建议使用普通成套的无线键鼠，避免有线和无线混合使用。 - -### 二、启动系统 -打开电源，打开工控机，等待Autolabor OS系统启动，输入密码autolabor，字母全部是小写，回车。 - -### 三、SLAM建图导航 - - -#### 准备工作： -1. 将AP1控制模式切换到上位机控制，打开急停开关，确保急停开关没有被按下 -2. 禁用工控机无线功能 - 在建图过程中，如果工控机连接了无线网络，当AP1走出无线网络的覆盖区域后，网络连接会自动断开，这将导致AP1控制失控，所以在开始建图之前，为了避免失控，需要将工控机的无线网络连接关闭。 -3. 进入桌面【SLAM建图导航】文件夹 - -#### 1. 点击【开始建图】 -RVIZ工具打开，能够看到地图中的AP1，使用键盘的上下左右控制AP1行走，边走边建图，可以看到环境地图随着AP1的行走不断被构建更新。 - -地图中，黑色是不可行走区域，白色是可行走区域，灰色是未知区域，红色是激光雷达实时数据。 - -#### 2. 建图完毕，点击【保存并停止建图】 - -#### 3. 点击【开始导航】 -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. 定位要走一走 - 2. 建图地图质量不好，障碍物颜色虚，效果好墙面黑色实现 - 3. 周围没有明显的特征信息，使得机器人能够找到自己的位置，开到有折角拐弯或明显标志物附近，能够加速机器人找到自己的位置 -2. 建图白，多走几遍， -3. 镜面，建图 - -1. 目标点给定后，可能会发生AP1不动或原地转圈，控制台显示【Failed to get a plan/不能规划路径】的红色错误，这可能是有两种原因造成： - * 目标点选择在了障碍物中 - * 车在地图中所处的位置是在障碍物中 - 那么这样的情况，我们可以先尝试重新给定目标点，或者将车换个位置重新给定初始位置。 -2. 在行走的过程中也可能会发生AP1停止不动或原地转圈的现象发生 - 这种情况是因为AP1在行走过程中，检测到障碍物，无法到达目标点，这个障碍物有可能是真实的障碍物，也有可能是误检，我们可以先等待观察，AP1会进行自我恢复（不超过一分钟），如果恢复之后AP1仍没有行动，导航已自动停止，此时我们需要重新设置目标点。 -3. 建图效果不佳/地图构建要点 - 在构建地图的过程，以下几点会影响到建图的准确性： - * 轮胎气不足影响里程计数据 - * 运行速度不宜过快，由于激光扫描有一定的频率，车速低时雷达可以扫描到的点更多，构建的地图会更准确一些 - * 走一个来回，增加激光雷达扫描次数，累计更多的数据 - * 地图构建的质量也受环境限制，请尽量选择特征比较明显的环境，玻璃、镜子、楼道、空旷等场景会影响建图效果 - * 构建完成的地图，会发现有些点会飞出，飞出的点可能是由于物体的表面不平或者有空隙激光直接穿越了过去 - * 当场景很大特征不足的时候，需要规划建图路径时，应先走一个小回环，当回环成功后，可以再多走几圈，消除粒子在这个回环的多样性。接下来走下一个回环，直到把整个地图连通成一个大的回环 diff --git a/docs/_sources/version_two/user_guide/assembly_test/doc.md.txt b/docs/_sources/version_two/user_guide/assembly_test/doc.md.txt index 427b71d..dbb9e3f 100644 --- a/docs/_sources/version_two/user_guide/assembly_test/doc.md.txt +++ b/docs/_sources/version_two/user_guide/assembly_test/doc.md.txt @@ -2,85 +2,57 @@ 本文将引导你安装导航套件并对各部件进行测试 - ## 组装 -详请参照视频 +> 详请参照视频 ### 线材连接 -#### 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) +![](./imgs/autolabor_navigationkit_v2_electrical_topology.png) ## 测试 -我们提供了一套工具软件，并将其放置在电脑桌面的测试文件夹中，用户可以用来检测导航套件中各部件能否正常工作。 +我们提供了一套工具软件，并将其放置在电脑桌面的**测试**文件夹中，用户可以用来检测导航套件中各部件能否正常工作。 ![](imgs/autolabor-destop.jpg) - 1. 激光雷达测试 - - 2. 深度相机测试 - - 3. 车载定位标签测试 - -## 常见问题 - -* “电池充电接口、Mini 计算机电源接口、Kinect-Hub电源接口可以互换适配器吗？” - - 少年，劝你别有这么大胆的想法！ - - 尽管这三者物理外形一致，但电气规格`并不通用`，使用时务必注意，错误的接线方式将会导致设备损坏，甚至危及人身安全。 - -* “为什么风扇噪音非常大？” - - 众所周知，AMD旗下CPU最大的特点就是~~发热量大~~ 性能强劲，并且Mini 计算机内部结构十分紧凑，只有风扇维持在较高转速才保证系统正常工作。 - -* “为什么我看不到 Kinect 的数据？” - - Kinect-Hub 的数据线另一端必须插在Mini 计算机 `USB3.0` 接口上，否则将无法从Mini 计算机读取到Kinect的数据。 - -* “ USB-Hub 上面的接口不通用吗？” - - 不通用，组装时务必按照文字提示插入设备，错误的接线方式将无法正常建图、定位、避障，甚至危及人身安全。 diff --git a/docs/user_guide/install_os/doc.html b/docs/common/install_os/doc.html similarity index 66% rename from docs/user_guide/install_os/doc.html rename to docs/common/install_os/doc.html index b6f5145..e149aed 100644 --- a/docs/user_guide/install_os/doc.html +++ b/docs/common/install_os/doc.html @@ -36,9 +36,7 @@ - - - + @@ -86,36 +84,6 @@ -

产品介绍

- -

快速开始

- -

了解定位系统

- -

使用说明

- @@ -166,7 +134,7 @@
  • - View page source + View page source
    • @@ -216,15 +184,6 @@