企业官网建设流程全解析

简介：一款基于STM32的智能搬运码垛小车工程资料包，面向单片机爱好者、嵌入式初学者及自动化竞赛备赛者，提供完整的工程级参考方案。项目以STM32为控制核心，融合伺服电机与舵机实现精准运动与关节控制，配合颜色传感器完成货物识别、超声波传感器实现避障测距、QTI传感器感知负载与接触力，覆盖码垛小车从底层驱动到上层调度逻辑的完整设计链路。压缩包共772个文件，约15.83MB，以C语言源码（.c/.h）、Keil工程配置（.uvproj/.uvopt）、启动与链接文件（.s/.sct）、编译产物（.hex/.axf/.o/.d）以及机械手调试说明等为主，目录结构清晰，便于按模块学习、二次开发或直接烧录验证。在工业物流与仓储自动化场景中，已有1343人学习下载，适合希望系统掌握多传感器融合、电机驱动与码垛控制算法的读者。

1. stm32智能搬运码垛小车：真正难的不是动起来，而是“码得准”

很多人第一次接触stm32智能搬运码垛小车，是从一个误区开始的：以为给底盘装上电机、给机械臂装上舵机，让它把东西从A点搬到B点就算完事。等真正调起来才发现，小车跑起来容易，但要让它在固定位置停下、让机械爪精准抓到货物、再按坐标一层层码放整齐，中间隔着一整套状态调度和位置闭环的逻辑。这份资源解决的就是从“会走”到“会码垛”的完整链路：主控选型、电机驱动、传感器布局、PID调速、动作状态机、调试排错，每一环都有对应的代码和参数。适合正在做课程设计、竞赛小车、或者想把手上的单片机项目从“演示级”推到“可复现级”的人。新手能按步骤搭起来，熟手可以直接抄状态机的调度思路和参数整定方法。

2. 硬件选型与系统架构：先定主控、电机与传感器，再谈码垛

动手之前最容易翻车的地方，不是代码，而是硬件选型。很多项目做到一半回头换主控、换电机驱动板，成本远高于一开始把架构想清楚。搬运码垛小车看着简单，但它同时涉及运动控制、位置检测和机构动作，三者的时序配合比单项功能难得多。

2.1 主控选择：为什么多数DIY方案落在STM32F103上

做搬运码垛小车的主控，最常被问的就是“用F103够不够”。我的回答是：对于常规的双电机差速底盘加一路舵机或步进电机驱动的升降机构，F103的算力完全够用，资源还能剩下不少。真正常见的瓶颈不在CPU，而在定时器数量和引脚冲突。F103系列至少带4个通用定时器和2个高级定时器，刚好覆盖两路电机编码器输入、两路PWM输出和一路舵机控制信号。如果选F407，性能确实强，但对这个场景属于溢出，而且封装更大、引脚更复杂，手工焊接和布线难度都上去了。

另一个关键点是调试接口。搬运小车在调PID和状态机的时候，需要频繁烧录和看实时数据。F103的SWD接口只需要两根线，比JTAG省引脚也省事，配合一个几块钱的下载器就能跑。资源包里给的例程也基本都是标准外设库加HAL库双版本，不管你习惯哪种写法的库都能直接套。

选型上还要注意Flash和RAM。搬运码垛的状态机如果只写搬运逻辑，8KB内存都嫌多，但如果要加摄像头识别货架编号或者存储多组码垛坐标，那就建议选F103RCT6这类256KB Flash的型号。C8T6的内存小一些，跑纯搬运逻辑没问题，加了视觉就容易捉襟见肘。

2.2 电机驱动与底盘：差速底盘是性价比最高的搬运平台

搬运码垛小车的底盘形态直接决定运动控制的复杂度。很多竞赛方案用的是麦克纳姆轮底盘，可以全向平移，码垛对位确实方便，但四个电机的闭环控制对单片机的定时器和PWM通道要求翻倍，调四路PID的积分参数也远比两路痛苦。相比之下，两轮差速底盘加一个万向轮的结构，控制模型简单可靠，转弯半径小，在平整场地上完全够用。

电机本身的选择上，直流减速电机配霍尔编码器是这类小车的主流方案。编码器的意义在于让单片机知道轮子实际转了多少，这是速度闭环的反馈来源。没有编码器的话，PID只能开环调，电压一波动车速就变，码垛位置必然漂。步进电机也可以做底盘驱动，精度确实好，但步进电机的扭矩随转速下降快，而且低速时抖动明显，小车跑到半路货物容易滑，对搬运场景不友好。

驱动板这块，TB6612比L298N更适合这个项目。L298N的压降大，发热严重，两路电机全速跑一会儿就烫手，而且PWM频率高了波形质量差。TB6612的导通压降只有零点几伏，体积小，逻辑电平直接兼容3.3V，接F103不需要额外的电平转换。唯一要注意的是TB6612的峰值电流参数，额定1.2A，堵转瞬间可能会触发过流保护，所以负载重的场合建议在电机端并联一个470uF的电解电容。

2.3 传感器配置：循迹、避障与到位检测怎么搭配

搬运码垛的场景里，传感器不是越多越好，而是每一路都要服务一个明确的状态。底盘沿固定路线搬运，灰度循迹模块就够了，少于4路的循迹只能保证“大概在线上”，到货架前的位置精度完全不可控，所以至少配5路灰度，左右各两路加中间一路，这样过弯和直行都有余量。

避障这一层，超声波模块放在小车前方偏下位置，高度控制在能探测到货架立柱而不是悬空的位置。注意超声波模块有最小探测距离，一般2cm以下会直接返回错误值，所以要加一下距离上限和下限的滤波，否则前方突然贴近物体时数据跳变会把状态机搞乱。

到位检测是码垛精度最容易被忽视的一环。只在灰度或视觉上判断“到了”是不够的，轮子的打滑和累计误差会让小车每次停的位置差出两三厘米。常见做法是在小车侧面加光电对射开关，配合货架上的反射贴纸做硬到位信号，误差能控制在毫米级。机械臂的升降和夹爪开合也一样，行程两端加微动开关，动作执行到极限位置时用开关信号确认到位，而不是死等延时。

3. 运动控制与码垛逻辑：从PID调速到状态机调度

硬件定下来以后，真正的工程量在软件。搬运码垛小车的软件可以拆成两个层次：底层是电机的速度闭环，保证小车“走得好”；上层是动作状态机，保证小车“做得对”。两个层次分开写，调试的时候才能定位问题到底出在控制环还是逻辑环。

3.1 速度闭环：增量式PID在搬运小车上的参数初值

给直流减速电机写速度闭环，工程上用增量式PID比位置式PID更顺手。增量式输出的是PWM占空比的修正量，不需要对误差做累加，天然不容易积分饱和，而且对执行机构的冲击小。速度环的周期一般取10ms到20ms，周期太短编码器计数分辨率不够，太长响应又迟钝。整车在平地上跑，10ms的周期配合每圈13脉冲的编码器，低速下也能有比较平滑的调速表现。

typedef struct { int16_t target; // 目标速度，单位：编码器脉冲数/控制周期 int16_t actual; // 实际速度 int16_t err; // 当前误差 int16_t last_err; // 上次误差 int16_t prev_err; // 上上次误差 int16_t p_out; // 比例项输出 int16_t i_out; // 积分项输出 int16_t d_out; // 微分项输出 int16_t output; // PWM占空比修正量 float kp; float ki; float kd; } IncrementalPID; void PID_Calc(IncrementalPID *pid) { pid->err = pid->target - pid->actual; pid->p_out = (int16_t)(pid->kp * (pid->err - pid->last_err)); pid->i_out = (int16_t)(pid->ki * pid->err); pid->d_out = (int16_t)(pid->kd * (pid->err - 2 * pid->last_err + pid->prev_err)); pid->output += pid->p_out + pid->i_out + pid->d_out; pid->prev_err = pid->last_err; pid->last_err = pid->err; }

这段代码是典型的增量式PID实现。核心逻辑是输出变量在每个周期做累加修正，而不是直接计算绝对值，这样即使某一次误差跳变，输出也不会瞬间变化过大。参数初值上，我一般先令 kp=20、ki=0.5、kd=0，让车能跑起来且不抖，再逐步加 kd 抑制超调。两个轮的PID参数必须单独标定，因为电机和轮子的机械特性不可能完全一致，共用一套参数会让小车直线行驶时往一侧偏。

注意这里的 target 和 actual 单位是“每个控制周期内的编码器脉冲数”，不是转每秒。这个单位的好处是直接和定时器捕获值挂钩，整定的时候读数直观。如果想换成转速，需要额外除以减速比和编码器线数，但那样反而多一层换算误差。

3.2 码垛动作编排：用状态机管理“取货-运输-放货”全流程

搬运码垛的逻辑层几乎不用写复杂的数学公式，难点在于把整个流程拆成边界清晰的状态。一个合格的搬运流程至少包含这几个状态：待机、前往取货点、取货、前往码放点、放货、返回待机。每个状态内部只做一件完整的事，状态跳转的条件必须是传感器或定时器给出的确定信号，不能靠猜测和延时硬凑。

typedef enum { STATE_IDLE, STATE_GOTO_PICK, STATE_PICK_WAIT_GRAB, STATE_GOTO_STACK, STATE_STACK_PLACE, STATE_BACK_IDLE } SysState; SysState current_state = STATE_IDLE; void StateMachine_Run(void) { switch (current_state) { case STATE_IDLE: if (start_flag) { PID_SetTarget(SPEED_CRUISE, SPEED_CRUISE); current_state = STATE_GOTO_PICK; } break; case STATE_GOTO_PICK: if (LineFollower_ArrivedAtPick()) { Motor_Stop(); Servo_Lower(); current_state = STATE_PICK_WAIT_GRAB; } break; case STATE_PICK_WAIT_GRAB: if (Gripper_ConfirmedClosed()) { Servo_Raise(); current_state = STATE_GOTO_STACK; } break; case STATE_GOTO_STACK: if (LineFollower_ArrivedAtStack()) { Motor_Stop(); Servo_Lower(); current_state = STATE_STACK_PLACE; } break; case STATE_STACK_PLACE: if (Gripper_ConfirmedOpened()) { Servo_Raise(); Stack_LayerCount++; current_state = STATE_BACK_IDLE; } break; case STATE_BACK_IDLE: if (LineFollower_ArrivedAtHome()) { Motor_Stop(); current_state = STATE_IDLE; } break; } }

这段状态机骨架把搬运流程抽象成了六个状态，每个跳转都绑定一个明确的确认条件。写逻辑的时候最忌讳在GOTO状态里面写“延时2秒然后认为到了”，因为负载变化、地面摩擦差异会导致同样的PWM下行驶距离完全不同，延时判断必然漂。仓库里的经验是：所有“到达”的判断一律走传感器确认，状态机里不允许出现盲目的定时跳转。

码垛多层的坐标管理也是状态机的一部分。放完一层货后，升降机构抬高的目标位置要累加一个层高偏移，这个偏移值在码垛前就按货物实际高度标定好，存成数组。注意不同批次的货物高度会有公差，所以我在资源包里给了一个货高校准参数，每次换货物规格后先跑一次单层码放校准，再跑完整流程，不要直接拿着出厂参数跑多层。

3.3 舵机与步进抬升机构：位置控制与限位保护

升降机构和夹爪的动作，工程上常见的组合是舵机加连杆的轻量方案，或者步进电机加丝杆的重载方案。舵机方案便宜好调，但舵机的堵转电流大，电压不足时扭矩衰减明显，夹持重物容易中途抖动。步进方案精度高、保持力强，但驱动板需要额外的脉冲引脚，而且步进电机在失步后位置就错了，必须有原点开关做回零。

void Servo_Init(void) { TIM_TimeBaseInitTypeDef tim_base; TIM_OCInitTypeDef tim_oc; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); TIM_TimeBaseStructureInit(&tim_base); tim_base.TIM_Prescaler = 72 - 1; // 72MHz/72 = 1MHz，1us计数一次 tim_base.TIM_Period = 20000 - 1; // 20ms周期，标准舵机PWM TIM_TimeBaseInit(TIM2, &tim_base); tim_oc.TIM_OCMode = TIM_OCMode_PWM1; tim_oc.TIM_Pulse = 1500; // 1.5ms脉宽，舵机中位 tim_oc.TIM_OutputState = TIM_OutputState_Enable; TIM_OC1Init(TIM2, &tim_oc); TIM_OC1PreloadConfig(TIM2, TIM_OCPreload_Enable); TIM_Cmd(TIM2, ENABLE); } void Servo_SetAngle(uint16_t angle_us) { TIM_SetCompare1(TIM2, angle_us); }

舵机控制的本质是输出一个周期20ms、脉宽0.5ms到2.5ms的方波，脉冲宽度直接对应角度。上面这段配置让定时器2工作在PWM模式，预分频72得到1MHz计数频率，自动重装值20000得到20ms周期，TIM_Pulse设为1500us就是中立位置。改角度时直接改比较寄存器的值即可，500对应0度，2500对应180度。

步进方案的话，升降到位要加原点开关。每次上电先执行一次回零动作，让升降台撞到原点开关后停止，再以此为基准计算后续要走的步数。这个回零动作不能省，因为步进电机上电后的绝对位置是未知的，直接在任意位置开始码垛，第一层就偏了。

4. 调试避坑：电机不转、小车跑偏、码垛歪斜的排查清单

这个项目我前后调过三轮，每次翻车的点都不重样，但归总起来其实就那么几类：电的问题、时序的问题、机械的问题。下面按踩坑频率排序，每条都是先给现象再给原因，最后给解决路径。

4.1 电机不转或无力：先查电源，再看PWM配置

一个很典型的现场：代码烧进去，小车两个轮子纹丝不动，用手拨一下轮子反而能转起来。这种“手拨才转”的现象基本可以锁定是PWM死区问题——电机在低占空比下启动扭矩不足，信号来了但转子克服不了静摩擦。解决方法是软件上保证启动瞬间给一个不低于15%的占空比台阶，跑起来后再降回目标值，这个逻辑放在PID输出限幅里处理。

另一个高频原因是电源压降。四个电机同时启动的瞬间电流可能是额定电流的三四倍，如果电池供电线太细或者逻辑电路和电机共用一个电源，单片机会瞬间复位。排查方法是看复位引脚的电平状态以及串口日志是否突然从头开始打印，一旦出现这种现象，就是电源纹波把单片机拉掉了。处理办法是把电机电源和逻辑电源彻底分开，地线单点共地，电机供电线上加一个大容量的电解电容。

4.2 小车直线跑偏：编码器装反与PWM死区是两个高频原因

现象是小车明明两轮目标速度一致，跑几米后明显往一侧弯。先确认编码器的A、B相是否接反，接反了速度反馈为负，PID会往错误方向修正，表现就是车轮一抖一抖地倒转。排查方式是只给单轮使能，看编码器计数的正负和车轮实际转向是否一致，不一致就对调A/B引脚。

如果编码器方向没问题，那就是两路PWM的死区或非线性区不一致。同一型号的两个电机，在10%以下占空比的实际输出差异可能达到20%，这时候光靠PID的积分项去拉，效果很勉强。我一般会在速度环整定前先做一次开环标定，用一串固定占空比记录两个轮子的实际速度，把差异做成一张补偿表，在闭环计算前先把占空比预补偿掉。

4.3 码垛位置漂移：机械间隙与坐标系基准要固定

现象是小车在空载时码垛位置很准，装了货物后每一层都往一个方向偏移一点，到第三层已经明显歪了。核心原因有两点，一是货物重量导致底盘轮子打滑，同样的行程实际距离变短；二是升降机构和夹爪的机械间隙让放货瞬间的横向位置产生偏差。

解决分两层。轮子打滑的问题，在码放点前设置一个减速区，让小车提前进入低速状态，用低速完成最后10cm的对位，而不是全速冲到传感器触发点才急刹。机械间隙的问题，靠软件补偿不现实，但可以在夹爪放开货物的时候做一次“停顿确认”，夹爪张开后保持零点几秒，确认货物完全脱离再抬升，避免夹爪回程的惯性带动货物移位。坐标系基准也要固定，每次上电后先做一次“回原点”动作，用限位开关把机械臂的绝对基准找回来，不依赖上次断电前的位置记忆。

4.4 调试过程中的“玄学”问题：用日志定位而非肉眼猜

搬运小车跑起来以后，会出现一些偶发问题，比如十次里有两次码放偏了、偶尔启动时嗡一声不转、放到第三层时夹爪误触发。这些问题的共同特征是没法稳定复现，靠盯状态变量很难定位。

我的习惯是给每个状态跳转加串口日志，日志格式统一为“状态名+触发条件+关键传感器值”。复现两次以后，把两次的日志放在一起对比，基本就能看出是哪一路信号在临界点抖动。比如夹爪误触发可能是微动开关的抖动没有被滤波，启动嗡声可能是电源电压跌落触发了欠压保护。日志上还应该带上时间戳，这样能判断一个状态卡了多久，辅助分析是不是逻辑条件永远不满足。小车上最难的调试不是逻辑复杂，而是信息不全，日志是成本最低的后悔药。

5. 进阶用法：串口上位机做参数整定与动作回放

码垛小车如果把功能做完了但精度达不到要求，通常不是代码逻辑的问题，而是参数没有整定到位。常规做法是改一次参数烧一次程序，效率低而且没法对比。我一般会在工程里加一套简单的串口指令协议，让小车在运行状态下直接在线改PID参数和标定值，配合电脑上的串口终端做实时整定。

串口协议不需要做得复杂，固定帧头加参数ID加数值即可。比如用帧头0xA5表示写参数请求，第二个字节表示参数编号，第三个字节表示数据，第四字节是校验和。烧录后通过串口发送A5 01 28 06这样的指令，就能把PID的Kp改成40，不需要重新编译。这个做法在整定阶段省下大量时间，因为速度环参数之间相互影响，必须反复试错才能找到合适的组合。

除了在线改参数，另一个实用技巧是动作回放。把整个搬运过程的传感器状态和动作指令按时间顺序记录下来，放在上位机里一遍遍回放。回放时关注每个状态跳转的时刻差，例如从“确认夹爪闭合”到“开始抬升”之间的间隔是不是存在异常等待。很多时候轴动作慢是因为状态间等待时间设长了，回放能直观地看到这个等待到底占了多久，从而决定是减少延时还是换一个响应更快的传感器。

还有一个容易忽略的验证技巧：跑完一轮搬运后，手动测量码放位置的偏差值，把它记录进日志，再和当时的轮速反馈比较。如果位置偏差一直往一个方向积累，说明不是随机抖动而是系统性的比例失调，优先检查编码器安装是否松动；如果偏差是在某一个固定环节突变的，说明该环节的机械结构存在卡滞。这套“测量-对比-定位”的流程能筛掉很多看起来像软件问题实则是硬件装配的问题。

从那以后，我每次给搬运小车换硬件或者改负载，都强制先跑一遍空载标定，再做一三轮满载复核，最后才跑完整的码垛流程。整个过程从最初的半天降到现在的半小时，省下的时间都花在了真正值得优化的机械结构上。希望帮到你。

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