简介：面向中国机器人及人工智能大赛、全球校园精英人工智能算法大赛等智能车赛项，这份ABOT-M1-ATK配置介绍PDF是参赛队快速上手的实用说明书。内容围绕ROS系统展开，覆盖激光雷达建图、机器人导航、视觉识别、语音交互、远程桌面控制与射击模块等功能测试，逐一给出终端启动指令和操作流程。同时说明多种建图方法的启动与地图保存方式，并通过设置导航目标点，帮助理解无人车自主巡航链路的实测步骤。资源仅包含1个PDF文件，大小2.3MB，页面从开机启动、连接显示器、Wi-Fi与向日葵远程接入，到各功能模块测试依次编排，并附安全注意事项与电源维护提醒。已有569人学习下载。文档可作为备赛教材，适合高校学生自学，也可直接对照指令验证设备状态，为机器人导航、激光雷达感知等方向的实践提供明确参考。

1. 智能车 ABOT-M1-ATK 为什么是巡航赛项的主流选择：先看硬件再看代码

赛场上最翻车的一类队伍，不是代码量最少的，而是赛前两小时还在乱调参数的那批。ABOT-M1-ATK 是智能车巡航赛项里流传很广的一套整车配置：主控、驱动板、灰度阵列、带编码器的直流减速电机在出厂时已经做了电气匹配，照着接线文档三小时能让车上赛道，但要把它从“能动”调到“能赢”，中间隔着硬件选型、控制参数和比赛策略三件事。这套配置可以按中国机器人及人工智能大赛、全球校园精英人工智能算法大赛等赛事的智能车巡航赛项规则备赛，赛道形态大同小异，核心都是沿黑线跑完规定圈数、用时短者胜。下面按“选型逻辑 -> 最小跑通 -> 调参 -> 排错 -> 刷圈速”的顺序拆开，新手能照着做，老队员也能看到参数边界和踩坑点。

2. 先看懂 ABOT-M1-ATK 的硬件选型：减速比、灰度与供电如何锁死圈速

2.1 底盘、电机与减速比：巡航赛项的速度上限，其实被减速比物理锁死

很多第一次接触巡航赛项的同学，上来就盯转向程序，觉得跑不快是算法问题。我一般会先让他们看电机减速比。ABOT-M1-ATK 这类整车配置，电机通常是带编码器的直流减速电机，减速比常见 1:20、1:30、1:45 三档。轮径不变时，理论极速 = 电机空载转速 ÷ 减速比 × 轮子周长。假设轮径 62mm，电机空载转速 11000rpm，减速比 1:30 时极速大概只有 1.2m/s 左右；换 1:20 能到 1.8m/s 以上，但低速扭矩明显变软，弯道里加速响应变差。

所以选减速比是在选赛道的“主形态”：多弯窄道用 1:45，扭矩大、加速快，极速低；长直道多的赛道用 1:20 更划算；绝大多数混合赛道我会先用 1:30 起步，等跑完第一版再根据弯道占比决定要不要换齿。

注意这只是空载理论值，实际加上电池电压、胎面摩擦和整车重量，能有 70%~80% 就不错。还有一点：换电机不是只换电机本体，要确认驱动板电流余量是否够。减速比变小后，电机堵转电流会更高，驱动板 MOS 管发热明显，原本能跑的板子可能直接热保护。

2.2 灰度传感器 + IMU：这套感知配置决定你能跑多复杂的赛道

ABOT-M1-ATK 的感知部分一般是灰度阵列加 IMU。灰度阵列负责“看线”，IMU 负责“还记得线在哪”。巡航赛项和传统巡线不一样的地方在于：巡线是贴着线慢慢走，巡航是在保持速度的前提下沿赛道路径走，所以对感知的连续性和抗干扰要求更高。

灰度阵列常见 8 路和 16 路两种。8 路是这套配置的默认搭配，误差计算范围窄，但对线宽 15~25mm 的标准赛道足够；16 路在中线附近分辨率更高，适合速度提到 1.5m/s 以上时用，因为高速状态下车辆每一帧偏移量小，误差跳变会更平滑。代价是 ADC 采样通道翻倍，控制周期可能从 5ms 被拖到 10ms，反而得不偿失。我一般建议：先 8 路跑稳，再决定要不要加 16 路。

IMU 的意义在十字交叉和反光路段。灰度传感器在十字路口会同时扫到横向黑线，误差计算会瞬间乱掉；光照变化时，白底反光可能让灰度值整体漂移。这时候 IMU 提供的是短时间的“航向记忆”：灰度丢失后的 100~200ms 内，用车头当前的角速度积分推算出继续前进的方向，扛过这一段，等灰度恢复再交回控制权。这也意味着 IMU 的零偏需要每次上电后重新标定，不然静止时角速度输出不为零，车会自己朝一个方向慢慢偏。

2.3 供电与整车重心：过弯极限的物理边界

巡航赛项的圈速瓶颈，很多时候不在算法，而在重心。ABOT-M1-ATK 用的是锂电池组，常见 7.4V 两串或 11.1V 三串。电压高，驱动板能给电机的电压上限高，同样 PWM 下电机转速更快；但高电压电池组一般也更重，重心更难压。过弯时车辆受到的侧向加速度约等于速度平方除以弯道半径，重心越高，侧翻风险越大。车速从 1m/s 提到 1.5m/s，侧向加速度会变成 2.25 倍，不是 1.5 倍。

所以第一次组装时，电池是整车最大的一块质量，一定要放在底盘最低的位置，不要图方便插在二层板上。前轮和后轮的轴荷尽量控制在 45:55 到 50:50 之间，车头太轻过弯时会推头，车头太重加速响应会变“肉”。赛前也要查一下赛规对整车尺寸上限的要求，很多队伍栽在二层板上的 OLED 屏幕支架突出来几厘米，检录时直接被判超限。

3. 从接线到最小巡线代码：ABOT-M1-ATK 三小时跑通赛道的最小配置

3.1 上电前的五步检查：先排掉接线里的“玄学”问题

巡航赛项里有一半的故障不是程序问题，是接线和供电问题。第一次上电，我建议按下面五步检查，任何一步不对都不要强行上电：

1. 万用表量电池端电压。两串锂电池满电 8.4V，如果低于 7.2V 先充电，欠压状态下驱动板会异常复位，表现为车突然一顿一顿。
2. 驱动板电源线确认正负极。板上一般有防反插标识，但部分批次没有，接反会烧驱动芯片，这是不可逆的。
3. 电机相线要分清楚。左右电机各两根线，接到驱动板对应的 A1/A2、B1/B2。接反了不会烧，但车会反转，你调半天转向极性也调不回来。
4. 编码器四线确认。VCC、GND、A、B 四条线顺序接反，编码器读到的数值会乱跳，速度环会振荡。
5. 灰度阵列排线方向。灰度板上的传感器面要朝向车头方向，排线插反以后误差方向整体翻转，车会朝着线反方向跑。

这几项全部确认后，再做一次“抬轮测试”：把车架起来，轮胎悬空，逐步加大油门，确认左右轮转向一致、编码器读数持续递增，再放下地跑。

3.2 最小巡线代码：让车沿着赛道自己走

下面这段代码是 ABOT-M1-ATK 的最小巡线逻辑，只做三件事：读灰度、算误差、差速转向。控制周期 5ms，也就是 200Hz，这是这种八路灰度方案比较稳的起步周期。

#include "bsp_abot.h" #define BASE_SPEED 900 // 基础速度，PWM 码值范围 0~4095，900 约 22% 占空比 #define GRAY_THRESHOLD 1500 // 灰度阈值：大于此值视为白底，小于此值视为黑线 // 8 路灰度权重：左侧负、右侧正，误差范围约 -4 ~ +4 const int8_t weights[8] = {-4, -3, -2, -1, 1, 2, 3, 4}; int16_t abot_gray_error(uint16_t *gray) { int16_t err = 0; int8_t hit = 0; for (int i = 0; i < 8; i++) { if (gray[i] < GRAY_THRESHOLD) { // 检测到黑线 err += weights[i]; hit++; } } return hit ? err / hit : err; // 除以命中数，避免多路同时触发时误差跳变过大 } int main(void) { uint16_t gray[8]; int16_t err, last_err = 0, steer, left, right; abot_init(); // 初始化时钟、ADC、PWM、编码器接口 while (1) { abot_gray_read(gray); // 读取 8 路灰度值 err = abot_gray_error(gray); // 计算横向误差 // 转向量 = 比例项 + 微分项 steer = err * 45 + (err - last_err) * 12; left = BASE_SPEED - steer; right = BASE_SPEED + steer; abot_motor_set(left, right); last_err = err; delay_ms(5); // 控制周期 5ms } }

逻辑说明：weights数组把 8 路灰度映射成从 -4 到 +4 的横向误差，线在左侧时误差为负，在右侧时为正。转向量包含两项：err * 45是比例项，当前偏差越大转向越猛；(err - last_err) * 12是微分项，误差变化越快越提前抑制过冲。最后把转向量从基础速度里减到左轮、加到右轮，实现差速转向。电机 PWM 是 12 位码值，满量程 4095，所以BASE_SPEED = 900相当于约 22% 的占空比，这个速度起步很安全。

参数说明：45 和 12 是起步值，不要当最优值。误差最大 4 时，转向量为 180，左右轮速度差 360，车能缓慢入弯；如果赛道黑线很细、灰度读数波动大，把 45 降到 30，把 12 提到 18，先保证直线不抖，再加比例项。另一个关键点是电机极性，如果上电后车直接往线外跑，不是改 45 能救回来的，回 3.1 查电机相线。

3.3 编码器速度闭环：为什么开环配置越调越飘

上面这段最小代码是开环速度：PWM 固定，车速不固定。同一组参数，满电时跑 1.2m/s，跑两圈电压降 0.5V，车速变 0.95m/s，原本能过的弯可能就冲出去了。这就是很多队伍“上午调好，下午翻车”的根本原因。

解决办法是加速度闭环。编码器装在电机轴上，每秒能输出几百个脉冲，用定时器计数就能算出轮子转速，再换算成线速度。速度环的输出作为基础速度，转向量仍然叠加在左右轮上：

// 速度环 PID：目标是 mm/s，反馈来自编码器换算 int16_t pid_speed(int16_t target_mm, int16_t cur_mm) { static int32_t integral = 0; static int16_t last_err = 0; int16_t err = target_mm - cur_mm; integral += err; if (integral > 300) integral = 300; // 积分限幅，防止弯道减速时油门饱和 if (integral < -300) integral = -300; int16_t output = err * 12 + integral / 4 + (err - last_err) * 8; last_err = err; return output; }

逻辑说明：integral是误差积分，用来消除长时间存在的静差，比如电池电压慢慢下降导致的转速不足。积分限幅 300 很重要，不然入弯时误差大、误差积分持续累加，出弯后会有一两秒的“油门过量”，车直接冲直线出赛道。err * 12是比例项，(err - last_err) * 8是微分项，起步值可以按这个量级设。

调速度环的顺序：先只留比例项，从小到大加，观察车在直道上能不能稳住目标速度；如果速度表来回波动超过 ±10%，加点微分；如果始终差一截到不了目标，再加积分。速度环和转向环是串联关系——速度环先稳住，转向环才能拿到稳定的输入，不然你调出来的转向参数只对“某一圈的电量”有效。

4. 巡航赛项调参手册：把 ABOT-M1-ATK 从慢速巡航推到比赛速度

4.1 调参之前先定主矛盾：直道太慢、弯道推头、出弯不畅怎么选

调参最容易犯的错是一上来就调 Kp/Kd，然后越调越乱。我一般会先跑三圈，只做一件事：在直道给固定油门，记录每段直道的最高速度、每个弯道的最低速度，然后把问题分成三类：

• 直道速度上不去：多半是电机减速比太大或电池电压不够，不是参数问题。先把 4.3 的动态调速做好，再考虑换齿。
• 弯道推头，转向不够：以 U 型弯最典型，误差已经拉满但车还是往外侧滑。这说明转向比例项不够，或是入弯速度太高，物理极限摆在那，加参数也救不了。
• 出弯加速慢：弯心速度降得太低，或者减速判据太早，车还没出弯就傻等灰度回中。这种情况要把动态调速的“回速触发”阈值提高，让车在误差回落到 2 时就提前加速。

这三类问题对应三种不同解法，混着调就是浪费时间。我见过最典型的翻车现场：车直道确实慢，队伍却一直加转向 Kp，结果直道依旧慢，弯道开始蛇形，越调越差。

4.2 按弯型给参数：回头弯、S 弯、大弧线弯、十字交叉的调法

巡航赛项赛道不是只有一种弯，不同弯型对转向的要求差很多。下面这张表按“转向强度”和“巡航速度占比”给参考值。转向强度指的是：误差为 4 时，转向量占基础速度的比例。比如基础速度 2500，转向强度 0.4，那么满偏误差时转向量约 1000，左右轮一个 1500 一个 3500。

参数上，回头弯是“转向强度优先”，比例项要拉到最大，微分项反而要小，因为 U 型弯里误差会长时间保持大值，微分项只在入弯那一下起作用。S 弯相反，比例项可以保守一点，微分项要加大，因为两个弯连续出现时，第二个弯的入弯方向其实已经被第一个弯的出弯状态决定了，微分项能提前修正。

大弧线弯最容易忽略，因为看起来弯不大。但高速下只要转向量稍微大一点，轮胎就侧滑，整车直接横移出线。这个弯的正确调法是把比例项调小，靠“早转弯”而不是“猛转弯”来保持路径。十字交叉处灰度会同时检测到两条黑线，误差计算不可信，正确做法是检测到全白或全黑时保持上一帧转向输出，直行通过交叉点。

4.3 动态调速策略：直道和弯道用不同速度，而不是一整圈一个速度

固定速度跑一整圈，要么弯道冲出去，要么直道跑太慢，两难。巡航赛项的打法是动态调速：误差大就减速，误差小就加速，并且加减速要用斜坡平滑，不能跳变。

// 每 5ms 执行一次的动态调速逻辑 // 误差大于等于 3 视为入弯，小于等于 1 视为直道 static int16_t speed_smooth = 2500; int16_t speed_target; if (err >= 3 || err <= -3) { speed_target = 900; // 弯心速度：900 对应约 22% 占空比 } else if (err <= 1 && err >= -1) { speed_target = 3200; // 直道速度：约 78% 占空比 } else { speed_target = speed_smooth; // 误差处于中间态，维持当前速度，避免频繁切换 } speed_smooth += (int16_t)((speed_target - speed_smooth) * 0.15f);

逻辑说明：动态调速的判据是误差绝对值，因为误差大意味着车离黑线中心远，通常就是进入弯道区域。speed_smooth是平滑后的目标速度，每次只向目标值靠近 15%，这样减速和加速都是斜坡，不会出现“直道 78% 油门突然变成 22% 油门”的顿挫。控制周期 5ms，0.15 的斜坡系数意味着大约 30ms 内完成大部分速度过渡，体感上刚好。

参数说明：0.15 这个系数适合混合赛道。如果赛道回头弯多，减速太慢会导致入弯速度偏高，把系数改成 0.08，减速更早更柔和；如果直道长且速度快，加速太慢会损失直道时间，改成 0.3。另外，误差中间态维持当前速度是关键一步，不然车辆会在直道和弯道判据之间反复横跳，速度一抖一抖的，比固定速度还慢。这里没有后悔药，调参前一定把上一组参数记下来，动态调速改完不满意要能快速回滚。

5. 巡航赛项避坑指南：灰度误判、蛇形、冲出赛道的五个常见原因

5.1 现象：上电后电机抖动，车轮却不转

现象：按下开关后电机发出“嗡嗡”声，能感觉到振动但轮胎不动，推一下车又开始转一下停一下。

原因：最常见是 PWM 频率太低。ABOT-M1-ATK 的驱动板如果你用低速 PWM（几百 Hz），电机电枢电流纹波很大，扭矩波动严重，低速下直接表现为抖动不转。另一个原因是驱动板使能引脚没有拉高，芯片处于待机状态。还要检查电池电压，锂电欠压保护时驱动板会反复重启，电机表现为转一下停一下。

解决：把 PWM 定时器频率设置在 10kHz 以上，不要为了省 CPU 把频率降到 1kHz。使能引脚在初始化函数里显式拉高。电池上电后先看一眼电压，低于 7.3V 就不要跑了。抖动问题排查顺序是：PWM 频率 -> 使能引脚 -> 电池电压，基本能覆盖 90% 的情况。

5.2 现象：直道上车子左右蛇行，越跑越偏

现象：直线赛段上误差本来接近 0，但车头左右摆动，摆幅越来越大，像在走 S 形。

原因：转向比例项 Kp 太大，误差稍微偏一点就猛打方向，车冲到另一侧又触发反向修正，形成振荡。另一个隐藏原因是 8 路灰度在中线附近分辨率不够，线在中间两路之间来回跳变，误差在 -0.5 到 +0.5 之间高频抖动，转向也跟着抖。

解决：第一步加误差死区，误差绝对值在 0.5 以内时不更新转向；第二步加大微分项，让系统对误差变化提前响应、抑制过冲；第三步检查灰度读数是不是本身在抖，如果某一路灰度值上电后就在 1400~1600 之间跳，先检查排线接触和供电纹波，而不是调参数。蛇形问题中，D 项的作用被人为放大了，其实很多车蛇形是灰度采样噪声造成的，先看数据再看参数。

5.3 现象：同一个弯，有时转得过去，有时直接冲出去

现象：同一套参数、同一个弯道，前两圈正常过，第三圈突然冲出赛道，且每次失败点不完全一样。

原因：开环速度下，每一圈的入弯速度都不一样，取决于上一段直道输出电压和当前电池电压。转弯有没有问题不是参数决定的，是入弯瞬间的速度决定的。另一个原因是减速判据太“死板”，只用当前误差判断时，一旦车辆在弯道前提前切向赛道内侧，误差还没拉大就冲进弯心，等到误差报警时已经来不及了。

解决：必须上编码器速度闭环，让每圈入弯速度保持一致。动态调速的判据从“当前误差大于 3 才减速”改成“误差绝对值大于 3 或者误差变化率大于阈值就减速”，提前一拍介入。注意，这个问题如果靠加大转向 Kp 解决，往往会把原本能过的弯也搞成蛇形，属于典型的错上加错。

5.4 现象：换了一个场地，灰度读数整体漂移，车一直识别不到线

现象：在训练场地跑得好好的，到了比赛场地后，灰度阈值 1500 完全失效，车在线上要么全体误判、要么线宽检测异常。

原因：灰度传感器本质是反射式光电，白底反光率和环境光强度都会影响输出。训练场地灯光和比赛场地灯光差一档，白底灰度值可能从 2000 掉到 1400，固定阈值 1500 就会把所有白底都误判成黑线。这是巡航赛项里最常见的“赛场翻车”原因，而且是纯硬件问题。

解决：上电后动态校准阈值。灰度传感器先放在白底上采样，再扫过黑线采样，取两者的中值作为阈值。校准逻辑也很简单：

uint16_t white_min = read_max_while_on_white(); // 白底采样，取最大值 uint16_t black_max = read_min_while_on_line(); // 黑线采样，取最小值 uint16_t threshold = (white_min + black_max) / 2;

如果比赛现场来不及校准，至少用灰度值的相对变化做判断：每 100ms 更新一次白底基线，实时阈值取基线减一个固定偏移。很多有经验的队伍会做“上电自动校准”，就是因为吃过这个亏。另外，不要试图用 16 路灰度来解决灰度漂移，通路越多越敏感，先解决阈值问题再谈分辨率。

5.5 现象：检录时被告知整车尺寸超限或重量超限

现象：车跑得很好，到了检录台，裁判用尺子一量，长宽高超了零点几厘米直接判不合格。

原因：赛规对整车尺寸和重量有明确限制，但队伍往往只顾着调车，没人花十分钟核对尺寸标准。最常见的是二层板上的 OLED 屏支架、天线、电池绑带多出来几毫米，或者电池从底盘下方穿出导致高度超限。

解决：比赛前三天，整车带电池、带固定件做一次尺寸实测。固定电池时用低矮的扎带方案，不要用厚的海绵垫。多余的外设板在比赛日卸掉，只留必需部分。重量超限的话，优先换小容量电池——容量小 30% 通常轻 40g 以上，代价只是续航短一圈，但巡航赛项跑完一组通常也就几分钟，续航完全够。这条是纯赛前功夫，但每年都有队伍在这上面翻车，而且是无法通过调参解决的翻车。

6. 赛前冲圈速的技巧：用一圈日志定位你车里最慢的那个弯

冲圈速的时候，主观感觉非常不可靠。人眼盯着车看三圈，会觉得每个弯都差不多，实际上圈速差距往往集中在某一个特定弯道。我的习惯是给车辆日志加三个变量：单圈用时、单圈内转向误差峰值、单圈内最低车速，把每一圈都当成一个黑匣子数据包。

typedef struct { uint16_t lap_ms; // 本圈用时，单位 ms int8_t max_err; // 本圈内转向误差的最大绝对值 uint16_t min_speed; // 本圈内最低车速，发生在哪个弯一目了然 } LapLog; // 每圈结束时通过串口输出一帧日志 void log_send_lap(LapLog *log) { char buf[32]; snprintf(buf, sizeof(buf), "%u,%d,%u\r\n", log->lap_ms, log->max_err, log->min_speed); uart_send_string(buf); }

字段说明：max_err反映某个弯道对转向提出的最大需求，如果这个值长期大于 3.5，说明该弯已接近车辆的物理极限；min_speed反映减速策略是否合理，如果某个回头弯的min_speed比其他弯低出一大截，说明减速过早或减过多了。这两个值配合单圈用时，能精确定位“时间丢在哪个弯”。

我的习惯是每次只改一个参数，然后跑三圈记录日志。参数调整前先看这一圈里哪个弯的max_err最高、min_speed最低，改完再看同一弯的这两项有没有变化，而不是只看总用时涨了还是跌了——因为赛道上的风速和轮胎温度都会干扰总用时，但同一个弯的误差峰值是相对稳定的。我以前也干过这种事：赛前两小时连续调了五六组参数，最后完全分不清是哪一组让圈速变好的，那才是真正的调参玄学。后来我就把日志定成了铁规矩，每组参数跑三圈，拿数据说话，不再凭感觉下结论。希望这个日志习惯能帮你在赛前少走两圈冤枉路。

本文还有配套的精品资源，点击获取