ABOT-M1-ATK竞赛智能车ROS建图导航与验收避坑指南

简介这份资源是 ABOT-M1-ATK 智能车的快速上手配置指南面向准备参加中国机器人及人工智能大赛、全球校园精英人工智能算法大赛巡航赛项的参赛学生与机器人初学者。资源包内只有 1 个 PDF 文件约 2.3MB属于图文混排的操作手册。正文依次讲解开机与显示器连接、借助向日葵远程桌面上车操控、激光雷达建图与地图保存、机器人导航目标点设置、射击模块、视觉与语音功能测试等环节并说明 abot_vision、abot_voice、lidar_ws、robot_ws 各工作空间的职责以及 Gmapping、Hector、Cartographer 三种 SLAM 方案的启动与保存命令能够帮助读者按顺序完成整车功能自检并建立对 ROS 导航链路的整体认识。文档开篇列出取机、雷达、相机、充电与拆解等注意事项可减少调试过程中的硬件损耗。目前已有 591 人学习适合作为赛前环境搭建与功能验证的对照手册。1. 开箱先别急着上电ABOT-M1-ATK 到手后的第一组检查某开发者第一次把 ABOT-M1-ATK 从箱子里抬出来两只手直接抠住激光雷达往上提车还没通电雷达的机械结构先挨了一下。这类竞赛智能车的环境配置和普通开发板完全不是一回事激光雷达、USB 相机、底盘、IMU 全挂在同一套 ROS 主控上机器人导航和视觉识别能不能跑通取决于上电顺序、网络接入、launch 文件的启动次序有没有对上。装错不会报错只会表现成建图拖影、导航原地打转、相机黑屏这些玄学现象。这篇笔记按开箱、上电、远程接入、建图、导航、验收的顺序写新手可以照着一步步走熟手可以只看版本差异和踩坑记录。2. 上电与远程接入先让这台车能被你看见2.1 上电四步最容易被人跳过的是第二、三步随机手册里的启动顺序写得很死HDMI 线接 10 寸显示器、显示器供电、按电源开关等 5 秒、按主控制器开关等开机完成。四个动作连在一起看像废话拆开就知道每一步都在防一个具体的故障。先接 HDMI 再上电是因为主控的显示服务在启动那一刻会探测一次输出设备。如果开机时 HDMI 口是空的图形界面会按无头模式起之后你远程连上去看到的就是黑屏或者 640×480 的低分辨率桌面分辨率怎么调都调不回来只能重启。第二、三步之间那 5 秒是给底盘控制板留的初始化窗口主控抢在底盘前面起来串口驱动经常抓不到底盘板表现为robot_with_imu.launch起来以后/odom没数据。我一般会在这 5 秒里顺手看一眼车身的电源指示灯确认不是虚接。抬机器的姿势也得在这儿说清楚两只手放在前后轮胎之间的底盘位置往上抬不要拎激光雷达也不要在雷达上方压任何东西。雷达的旋转部件被外力别过一次后面建图会一直带着一个固定方向的拖影看起来像算法问题其实是硬件被拧歪了。关机顺序反过来先在系统里关主控等主机完全断电再关总电源。断电顺序反了文件系统没同步完就掉电SD 卡上的工作空间有概率直接损坏这是最典型的一类后悔药场景。充电这块记一张小表就够了不用记参数含义项值说明充电器规格DC 12.6V / 2.0A不要拿手机快充头替代红灯充电中正常充电状态绿灯已充满绿灯后拔掉即可电量一格立即充电不要跑到自动关机半个月不用补一次电长期存放前充满车身上不要倒任何液体操作时手不要碰相机模组镜头这两条不是客套话。相机镜头被指纹糊过一次视觉识别那一章的测试图会一直发虚很多人以为是标定坏了擦一下镜头就好了。设备在保修期内不要私自拆解拆过之后出现的问题只能自己扛。2.2 网络接入与远程桌面先给车一个地址再给自己留条后路主控开机进桌面之后第一件事是连网。现场没有路由器的时候用手机开热点是最省事的做法车端和你的电脑端连同一个热点后面远程桌面才谈得上。连上以后在车端的终端里确认一下地址# 车端确认无线网卡已经拿到地址并记住这个 IP ip addr show wlan0 | grep inet # 看默认路由确认网关是热点那一侧 ip route | grep defaultip addr的输出里inet后面那串就是车在局域网里的地址记下来。有些现场热点会做客户端隔离两台设备都在同一个热点下却互相 ping 不通这时候换成路由器或者用有线直连折腾远程桌面软件是没用的。车端桌面的左下角图标里有一个远程助手入口点开会显示本机的识别码和验证码。这两个码每台设备不同以车身上显示的那一组为准不要在别处抄。电脑端装好对应的远控客户端输入识别码和验证码就能连上看到车端的桌面。远程桌面好用但它有两个先天问题一是画质和延迟受网络影响建图的时候你盯着 rviz 看画面卡一下就会误判二是远控服务本身挂了你就彻底进不去了。所以我会额外留一条 SSH 通道做兜底# 电脑端远控连不上时的备用入口用户名和 IP 以车端实际输出为准 ssh abot192.168.x.x # 连上后确认工作空间还在顺便看一眼磁盘余量 df -h ~SSH 能进、远控进不去说明问题出在远控服务或者图形会话不在网络两个都进不去问题在网络或者主控没起来。这条判断路径能省掉很多来回试的时间。远控软件第一次连上时分辨率可能不是你想要的在远控客户端的显示设置里调成和车端屏幕一致别在车端系统设置里乱改改完接显示器会发现桌面比例不对。2.3 认清四个工作空间同名包不在同一个目录是常态这台车的功能包按用途分在四个工作空间里动手之前先把目录结构认全后面roslaunch报找不到包的时候才知道该去哪儿找。工作空间负责的功能典型内容~/robot_ws机器人配置、底盘与模块驱动、综合 demoabot_bringup、robot_slam、自主巡航~/lidar_ws激光雷达与导航abot_slam建图、保存地图、导航~/abot_vision视觉相关usb_cam相机驱动~/abot_voice语音相关robot_voice语音播报每个工作空间下的src目录里放的是具体功能包。这里有个几乎所有人都会踩到的点建图用的gmapping.launch和view_mapping.launch在robot_slam包里而save_map.launch、hector_mapping.launch、cartographer.launch在abot_slam包里两个包分别属于不同的工作空间。你在一个终端里 source 了robot_ws然后去 launchabot_slam的节点大概率报找不到包。# 确认当前终端能看到的包路径工作空间是按顺序叠加的 echo $ROS_PACKAGE_PATH # 分别定位两个容易混淆的包 rospack find robot_slam rospack find abot_slamROS_PACKAGE_PATH里靠前的路径优先。正确的 source 顺序是先系统 ROS、后工作空间工作空间叠加在系统之上# 系统 ROS发行版用 rosversion -d 确认melodic 和 noetic 都要先 source 这一层 source /opt/ros/noetic/setup.bash # 再叠加自己的功能包 source ~/robot_ws/devel/setup.bash source ~/lidar_ws/devel/setup.bashrosversion -d的输出决定了第一行的路径写错了会报No such file or directory。如果你不确定这套环境装的是哪个发行版就在车端敲一下这个命令不要凭记忆写。source 完以后rospack find还有包找不到说明这个包根本不在当前 source 的工作空间里换一个终端 source 另一个工作空间再来不用急着重装。每次新开终端都要重新 source这一条听起来啰嗦但它是后面所有“找不到包”报错的根源。3. 激光雷达建图三套 SLAM 的启动链路3.1 先起底盘robot_with_imu.launch 是整个链路的地基建图、导航、视觉、语音所有功能的底座都是同一个 launchrobot_with_imu.launch。它一次性把底盘串口驱动、IMU、激光雷达驱动、以及odom → base_link → laser → imu这一串 TF 全部拉起来。这个文件起不来后面任何一个 launch 都是空转。# 终端一底盘、IMU、雷达、TF 一起起 source ~/robot_ws/devel/setup.bash roslaunch abot_bringup robot_with_imu.launch启动完不要立刻推车等终端里刷屏停下来、确认没有红色的报错行再动。验证这一层是否正常看三样东西话题有没有、频率对不对、TF 通不通。# 终端二确认关键话题都发出来了 rostopic list | grep -E scan|odom|imu # 雷达频率健康状态下应该是稳定的一串数字不是 0 也不是乱跳 rostopic hz /scan # 里程计和底盘的坐标变换能看到平移和旋转分量就说明底盘在正常回传 rosrun tf tf_echo odom base_linkrostopic hz /scan出来是空的或者一直no new messages问题一般不在 ROS 层而在设备层雷达的 USB 没枚举上或者串口被别的进程占了。先在系统层确认设备有没有被识别到# 底盘控制板和雷达通常各占一个串口看到几个 ttyUSB 取决于接了哪些模块 ls -l /dev/ttyUSB* # 看 USB 总线层没插好或者供电不足的设备这里就看不到 lsusb # 相机是 video 设备和串口不是一类 ls -l /dev/video*设备节点少了一个先拔插一次还不行就换一个 USB 口。用无源扩展坞转接的时候雷达和相机同时工作会抢供电表现为设备时有时无这种问题在 ROS 层怎么查都查不出来只能从供电上解决。launch 文件里可以改的参数主要三类串口设备名、波特率、雷达的frame_id。默认值和实际枚举出来的设备对不上时改这三处就行不用动其他节点。另一个容易忽略的点是robot_with_imu.launch起来之后不要重复启动第二次两个驱动进程抢同一个串口第二个会静默失败你看到的现象是“明明起了但没数据”。3.2 gmapping 建图、键盘控制与地图保存底盘稳定之后建图就简单了。手上有两种启动方式快速测试用的是脚本封装./1-gmapping.sh手动拆开就是下面这几个 launch两种方式等价我一般用后者因为能看到每个终端在报什么。# 终端一常驻底盘与传感器 roslaunch abot_bringup robot_with_imu.launch # 终端二gmapping 建图节点 roslaunch robot_slam gmapping.launch # 终端三rviz 可视化看地图有没有实时长出来 roslaunch robot_slam view_mapping.launch # 终端四键盘遥控建图阶段靠它推车 rosrun teleop_twist_keyboard teleop_twist_keyboard.py键盘遥控的按键是固定的英文大写开启时行为会变这一点手册里写得很绕整理成表更清楚按键小写状态大写状态U/O左前 / 右前斜向移动左前 / 右前平移I直行前进直行前进J/L原地左转 / 右转向左 / 向右平移M后退后退/后退中的斜向左后 / 右后平移K停止停止建图的质量和你推车的习惯直接相关。速度控制在小幅度档位转弯前先停稳再转不要边走边猛打方向。人不要贴着雷达的扫描平面跟着走你的腿会在图上留下一道跟着车跑的墙。第一次建图不要求一次画完整个场地绕一圈回起点让地图闭环剩下的缺口再补。地图建完不要关任何终端直接保存# 地图保存yaml 和 pgm 两个文件会一起生成 roslaunch abot_slam save_map.launch存完确认一下文件真的落盘了别只看终端打了成功# 定位包路径地图一般就在包目录下的 maps 文件夹里 rospack find abot_slam # 能看到 .yaml 和同名 .pgm 才算存成功 ls -lh $(rospack find abot_slam)/maps.yaml里有三个字段后面导航会用到image指向 pgm 文件名resolution是每个像素代表的实际距离origin是地图左下角在全局坐标系里的位置。这三个值不要手改除非你明确知道自己在重定位一张旧地图。改了resolution却没改origin导航时机器人会系统性地偏出去一段固定距离看着像定位算法抽风。3.3 hector 与 cartographer什么时候换、怎么换三套 SLAM 的区别不在命令行在它们对传感器和算力的假设。选错了不是跑不起来是跑起来以后地图一直歪。方案依赖里程计特点适用场景gmapping需要粒子滤波小场景稳定参数少单间教室、场地边界清晰hector不需要纯雷达匹配对雷达频率敏感快速旋转容易丢雷达数据质量好的开阔场地cartographer需要带回环检测吃 CPU大场地优势明显多房间、绕行路线长换方案的时候只切建图节点那一层robot_with_imu.launch一直挂着不用重启# 先把上一套建图节点 CtrlC 停掉再起新的 roslaunch abot_slam hector_mapping.launch # 另一个终端看地图 roslaunch abot_slam view_mapping.launch# cartographer 同理底盘那层不动 roslaunch abot_slam cartographer.launch roslaunch abot_slam view_mapping.launchhector 不需要里程计所以在/odom有问题的时候它反而能出图这是现场应急的一个土办法底盘串口没修好先用 hector 把场地扫出来应急。代价是它对角度变化很敏感原地快速转一圈基本必崩推车得比 gmapping 更慢。cartographer 反过来它靠回环把长走廊的累计误差拉回来但主控 CPU 占用明显高建图的时候同时开着远控和 rviz画面会卡这时候不要以为是网络问题。三套方案都可以用同一套键盘遥控推车控制方式完全一致。切换过程中唯一要注意的是前一套的建图节点一定要彻底停掉再起下一套两套地图同时在 rviz 里发/map你会看到两张地图叠在一起很容易误判成算法出了问题。4. 导航、视觉、语音与扩展模块把剩下的模块逐个点亮4.1 导航三个 launch 的顺序和那个没人提的初始位姿导航的启动链路比建图多一层顺序不能乱# 终端一底盘与传感器 roslaunch abot_bringup robot_with_imu.launch # 终端二move_base、amcl、代价地图 roslaunch robot_slam navigation.launch # 终端三rviz加载建好的地图 roslaunch robot_slam view_nav.launchnavigation.launch里其实做了两件事把地图加载进map_server把amcl和move_base拉起来。地图加载失败的话rviz 里是一片灰色不是空白这两种状态要分清楚空白是没加载到地图灰色是加载了但没收到激光数据。导航真正开始之前有一个手册里没写、但不做就大概率失败的步骤给初始位姿。AMCL 是粒子滤波定位它需要知道机器人大概在哪儿。把车放回建图时的起点在 rviz 里用2D Pose Estimate在地图上点一下、拖出朝向让粒子云收敛到车身上然后再用2D Nav Goal点目标点。跳过这一步直接导航常见的现象是车原地小幅度左右转转速很慢像在犹豫。# 确认定位是否收敛协方差那一行的数值越小越可信 rostopic echo /amcl_pose # 确认规划器有没有真的收到目标 rostopic echo /move_base/goal/amcl_pose一直在大范围跳说明初始位姿给错了或者地图和实际场地对不上这时候点多少次 2D Nav Goal 都没用。代价地图的膨胀半径inflation_radius决定了车离墙多远就开始避让场地窄的时候把它调小一点不然规划器会认为所有通道都过不去报no valid path。4.2 视觉相机驱动起来只是第一步相机这一路相对独立起两个终端就能验证# 终端一USB 相机驱动 roslaunch usb_cam usb_cam_test.launch # 终端二图像查看器选对话题才能出画面 rosrun rqt_image_view rqt_image_view在rqt_image_view左上角的下拉框里选/usb_cam/image_raw有画面就说明链路通了没画面再往下查。相机是最容易出玄学的一路几个高频原因设备号被占。车上有多个 video 设备时usb_cam默认抓的可能不是你要的那一个改 launch 里的video_device参数指向正确的/dev/videoN。分辨率和帧率不匹配。设了一个相机不支持的组合驱动能起来但出不了图。USB 带宽不够。同一路总线上同时挂着雷达和相机高分辨率下会掉帧把分辨率降一档通常就好了。镜头本身也要看一眼。相机模组前面有一层保护膜的话撕掉镜头上有指纹就用镜头布擦不要用手指蹭。画面整体发虚、颜色发灰八成是物理层面的问题不是驱动参数。视觉识别类的算法在上层跑输入图像本身不清楚后面怎么调阈值都白搭。4.3 语音单独起 master 的那一路语音功能的启动方式和前面几个不一样它是自己起roscore的# 终端一如果车上没有别的节点在跑需要自己起 master roscore # 终端二语音播报订阅节点 rosrun robot_voice tts_subscribe # 终端三往话题里发一条文本耳机里应该能听到播报 rostopic pub /voiceWords std_msgs/String data: 1234输出到蓝牙耳机之前先在桌面右上角的设置里把耳机配对连上。配对成功了但没声音检查系统声音输出设备是不是切到了耳机这一条比 ROS 层的问题更常见。rostopic pub那一行的格式有讲究消息类型和话题名之间是空格数据部分要写成data: 内容的形式引号不能省。手册里排版粘连成voiceWordsstd_msgs/String是排版问题实际敲的时候中间必须有空格。发出去以后第二个终端会打印收到的内容耳机里同时出声两个都有才算正常。只有终端打印没有声音问题在音频输出两个都没有问题在节点没订阅上回头确认tts_subscribe是不是真的起来了。4.4 扩展模块订阅式驱动的自检套路车上的扩展模块部分赛项用的发射机构走的是同一套 ROS 驱动模型这个套路值得单独说因为它是所有“驱动起了但没反应”类问题的通用解法。# 终端一把扩展模块的驱动节点挂上 roslaunch abot_bringup shoot.launch # 终端二驱动是订阅式的必须往话题里发一条消息才会动作 rostopic pub /shoot std_msgs/String data: 关键点在第二行。roslaunch只是把节点挂到 master 上节点在等/shoot这个话题上的消息你不发它就一直待着。很多人起完 launch 发现没反应以为驱动坏了其实是少发了这一条。测试之前确认模块的独立电源开关是打开的动作方向朝向空地不要对着人和设备。这套“先起驱动、再发话题、看有没有动作”的验证顺序同样适用于底盘、云台这些订阅式节点。手上有一个能发消息的工具比反复重启 launch 有用得多。5. 避坑与排查六条现场翻车记录5.1 建图与导航类的三个坑现象建图时墙体出现双层重影怎么走都消不掉。原因通常不在算法在推车方式。速度太快、原地猛转、雷达扫描平面里站着人这三种情况都会让相邻两帧的匹配对不上重影一旦形成后面的帧会跟着一起偏。解决办法是把速度降到最低档转弯前先停稳再转建图全程人离开车的扫描平面站在车后方跟着走。已经歪掉的地图救不回来CtrlC 停掉重新建一遍比在原地补图快得多。现象导航点了 2D Nav Goal车原地小幅度转或者报no valid path。前者的原因是 AMCL 没有收敛初始位姿和建图起点对不上用2D Pose Estimate重新给一次粗位姿把车物理上放回建图起点最稳。后者的原因是代价地图膨胀半径太大窄通道被判定为不可通行把inflation_radius调小一档再试。两种情况都不是 move_base 的 bug是参数和初始条件的问题。现象换了一套 SLAM 方案rviz 里两张地图叠在一起。原因是前一套建图节点没彻底停掉两个节点同时在/map上发消息。切方案之前先把上一套的终端 CtrlC 干净确认rosnode list里没有残留的建图节点再起新的。这个坑的迷惑性在于地图看起来“有点歪但还能用”实际上你是在拿两张地图做定位。5.2 远程与启动类的三个坑现象远程桌面连上了但桌面是黑的或者分辨率极低怎么调都不回来。原因是主控启动时 HDMI 口上没有显示器图形服务按无头模式起了。解决办法是接上显示器重启一次让系统重新探测输出设备。稳妥的习惯是每次重启前先把 HDMI 线接好哪怕你根本没打算用显示器。现象roslaunch报RLException: ... is neither a launch file in package但文件明明在。原因是这个终端没 source 对应的工作空间或者同名包在另一个工作空间里roslaunch找错了。用rospack find 包名确认路径用echo $ROS_PACKAGE_PATH确认叠加顺序。这一类报错九成以上是环境变量问题不要急着重装功能包。现象车跑到电量剩一格主控突然掉电再开机工作空间打不开。原因是电压跌到主控的欠压阈值掉电瞬间文件系统没同步完。解决靠两头一是电量一格就充用 DC 12.6V/2.0A 的原配充电器红灯充电、绿灯充满不要用大功率充电头硬顶二是提前做一张系统卡的镜像当后悔药卡坏了换卡不要把时间花在抢救文件系统上。半个月以上不用车也要补一次电再存放。6. 验收用一遍串起来跑通的流程代替逐个点灯单点测试全过不代表整套流程能跑通。我最后一定会做一遍串联验收顺序是固定的接显示器上电、连网、远控进桌面、起底盘、看雷达频率、建一小块图、存图、重启、加载地图导航到两个点、起相机看一眼画面、发一条语音、发一条扩展模块指令。这一圈走完才算是真正装好了。上电后的第一层自检可以固化成脚本省得每次手敲#!/usr/bin/env bash # ABOT-M1-ATK 上电自检话题、频率、TF 三层依次过一遍 source /opt/ros/noetic/setup.bash # 发行版用 rosversion -d 确认 source ~/robot_ws/devel/setup.bash echo 关键话题是否存在 rostopic list | grep -E scan|odom|imu|image_raw echo 雷达频率看是否稳定输出 timeout 5 rostopic hz /scan | head -3 echo 里程计到基座的 TF 是否连通 timeout 5 rosrun tf tf_echo odom base_link | head -8脚本只做读操作不改任何状态跑一遍就能定位问题出在哪一层话题列表里少东西是设备层话题在但频率是 0是驱动层话题和频率都正常但 TF 报错是 launch 的坐标系配置。这三层分清楚了再去翻具体节点效率比从头查高很多。验收用的检查表我是这么排的每一项都要亲眼看到结果不能凭“应该没问题”放过去验收项通过标准不通过先查上电与显示桌面正常分辨率无花屏HDMI 是否开机前接好网络与远控电脑端能操作车端桌面是否同一网段、热点是否隔离底盘与雷达/scan频率稳定/odom有数据串口枚举、USB 供电建图绕场一周能闭环墙体无双层推车速度、雷达平面是否有人存图maps 目录下同时有 yaml 和 pgmsave_map.launch是否在终端未关时执行导航两个目标点都能到达途中不原地打转初始位姿、膨胀半径相机rqt_image_view有清晰画面设备号、镜头是否干净语音耳机出声且终端有回显蓝牙输出设备、话题格式扩展模块发话题后有动作响应模块电源开关是否打开有一步没过就先停下来修不要带着问题往下走。建图没闭环还去导航只会把定位的问题和建图的问题混在一起排查成本翻倍。从那以后我每次动这台车之前都会强制走一遍这个串联验收哪怕只是改了一个 launch 参数。智能车这类多模块耦合的环境坏掉的地方往往不在你刚改的那一行而在你上一次没收尾的某个终端里。希望帮到你。本文还有配套的精品资源点击获取