# user manual

##### The manual guides the usage of ROS packages for the XGO-E navigation kit.

<p class="callout info">ROS package backup location： [https://file.hexmove.cn/f/b1482fc3f5fe40eb8598/](https://file.hexmove.cn/f/b1482fc3f5fe40eb8598/)</p>

---

### File Locations And Functions

> <span lang="EN-US">***/home/hexman/cartographer\_ws*** <span style="mso-spacerun: yes;"> </span>cartographer source file location</span>
> 
> <span lang="EN-US">***/home/hexman/orbbec\_ws*** </span>摄像头驱动位置
> 
> <span lang="EN-US">***/home/hexman/test\_ws/src*** </span>所有自动驾驶相关文件位置
> 
> <span lang="EN-US">***--/base*** </span>底盘驱动文件
> 
> <span lang="EN-US">***--/modules*** </span>雷达驱动文件
> 
> <span lang="EN-US">***--/urdf*** </span>底盘<span lang="EN-US">urdf</span>文件
> 
> <span lang="EN-US">***--/nav*** </span>导航配置文件
> 
> <span lang="EN-US"><span style="mso-tab-count: 1;"> </span>***--/src\_xpkg\_multigoal\_plugin*** <span style="mso-tab-count: 1;"> </span>rviz</span>的<span lang="EN-US">UI</span>插件
> 
> <span lang="EN-US"><span style="mso-tab-count: 1;"> </span>***--/xpkg\_cartographer/config*** <span style="mso-tab-count: 1;"> </span>cartographer</span>配置文件<span lang="EN-US"> </span>
> 
> <span lang="EN-US">***--/bringup***  demo</span>的启动文件
> 
> <span lang="EN-US"><span style="mso-tab-count: 1;"> </span>***--/xpkg\_bringup/bringup\_camera*** </span>摄像头<span lang="EN-US">demo</span>
> 
> <span lang="EN-US"><span style="mso-tab-count: 1;"> </span>***--/xpkg\_bringup/bringup\_lidar*** <span style="mso-tab-count: 1;"> </span></span>雷达<span lang="EN-US">demo</span>
> 
> <span lang="EN-US"><span style="mso-tab-count: 1;"> </span>***--/xpkg\_bringup/bringup\_light*** </span>灯光控制<span lang="EN-US">demo</span>
> 
> <span lang="EN-US">***--/xpkg\_bringup/bringup\_vehicle*** </span>底盘控制<span lang="EN-US">demo</span>
> 
> <span lang="EN-US"><span style="mso-tab-count: 1;"> </span>***--/xpkg\_bringup/bringup\_nav*** </span>导航<span lang="EN-US">demo</span>
> 
> <span lang="EN-US"><span style="mso-tab-count: 2;">  </span>***--/maps*** </span>地图保存位置
> 
> <span lang="EN-US"><span style="mso-tab-count: 2;"> </span>***--/launch/localization/cartographer*** </span>建图<span lang="EN-US">launch</span>文件
> 
> <span lang="EN-US"><span style="mso-tab-count: 2;"> </span>***--/launch/planning/move\_base*** </span>导航<span lang="EN-US">launch</span>文件
> 
> <span lang="EN-US"><span style="mso-tab-count: 2;">  </span>***--/config/mark2\_mcnm/cartographer***<span style="mso-spacerun: yes;"> </span>movebase</span>配置文件

---

### The standard Procedure

<span lang="EN-US" style="mso-fareast-font-family: 等线; mso-fareast-theme-font: minor-latin; mso-bidi-font-family: 等线; mso-bidi-theme-font: minor-latin;"><span style="mso-list: Ignore;">1.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Turn off the remote controller or switch to CAN control mode (please refer to the chassis user manual).

<span lang="EN-US" style="mso-fareast-font-family: 等线; mso-fareast-theme-font: minor-latin; mso-bidi-font-family: 等线; mso-bidi-theme-font: minor-latin;"><span style="mso-list: Ignore;">2.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US">Terminal input: `roslaunch xpkg_bringup bringup_cartographer_map.launch`</span>

<span lang="EN-US" style="mso-fareast-font-family: 等线; mso-fareast-theme-font: minor-latin; mso-bidi-font-family: 等线; mso-bidi-theme-font: minor-latin;"><span style="mso-list: Ignore;">3.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Control movement using the arrow keys on the keyboard in the terminal. Keyboard control has been limited for speed.

<span lang="EN-US" style="mso-fareast-font-family: 等线; mso-fareast-theme-font: minor-latin; mso-bidi-font-family: 等线; mso-bidi-theme-font: minor-latin;"><span style="mso-list: Ignore;">4.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>To save the map, run the following command in a new terminal: `rosrun xpkg_cartographer save_map.sh`. After saving the map, close all terminals.

<span lang="EN-US" style="mso-fareast-font-family: 等线; mso-fareast-theme-font: minor-latin; mso-bidi-font-family: 等线; mso-bidi-theme-font: minor-latin;"><span style="mso-list: Ignore;">5.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span><span lang="EN-US">Run the following command in a new terminal: `roslaunch xpkg_bringup bringup_nav_mark2_mcnm.launch`.</span>

<span lang="EN-US" style="mso-fareast-font-family: 等线; mso-fareast-theme-font: minor-latin; mso-bidi-font-family: 等线; mso-bidi-theme-font: minor-latin;"><span style="mso-list: Ignore;">6.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>Plan path points and start navigation using the RViz plugin.（[Rviz Plugin usage tutorial](https://odocs.hexfellow.com/books/public-hexmove-docs/page/rviz-navigation-plugin)）