1. 先把需求边界划清楚这套滑轨到底给谁用做开源双轴电动滑轨这件事我一开始的想法很朴素让相机能沿着一条直线匀速滑过去再让平台上下微调一点高度拍一组焦点堆栈。真动起手来才发现只要沾上双轴两个字问题就从能不能动变成了动得准不准、停得稳不稳、重复来一次还是不是同一个位置。这套基于 ESP32 的低成本高精度运动控制系统本质上解决的是中小型自动化场景里买成品太贵、自己搭又不知道从哪下手的尴尬一套商用的双轴电动滑轨模组报价动辄四位数往上而用开源方案把主控、驱动、传动、固件拆开自己配硬件成本能压到前者的三分之一甚至更低精度却能做到亚毫米级、重复定位精度稳定在几十微米量级。它适合的人其实比想象中多。拍延时和微距堆栈的摄影爱好者需要平滑无抖动的直线运动做显微镜载物台改造的人需要小行程、高分辨率的两轴定位搞小型自动化检测、激光打标辅助、3D 扫描转台的开发者需要一套能接受指令、能回零、能重复定位的运动平台。这些人共同的需求是开源、可改、成本可控、精度够用而不是追求工业级机床那种微米级重复定位。我把这套东西的定位说得很清楚它不是工业运动控制卡别指望它带伺服、跑多轴联动插补、做闭环光栅反馈。它是一套能用、好改、便宜的开源双轴电动滑轨方案核心是 ESP32 做主控两路步进驱动配合丝杆或同步带传动用硬件定时器发脉冲用一套精简的 G 代码子集和上位机对话。把边界划清楚后面所有的选型和取舍才有依据。1.1 三种典型使用场景倒推设计指标我习惯从场景倒推指标而不是先堆参数。第一种是摄影滑轨行程 300mm 到 800mm速度要求不高0.5mm/s 到 30mm/s 就够但对速度平滑度极其敏感任何一点速度突变在视频里都会变成肉眼可见的顿挫。第二种是微距堆栈平台行程只有几十毫米但步进分辨率要求高单步位移最好在 1μm 到 5μm 之间而且需要能精确重复回到同一起点。第三种是小型检测或扫描平台两轴都要动要求能走直线、能走方框轨迹速度中等重点在轨迹精度和长期运行的稳定性。这三类需求放到一张表里对比取舍就很清楚了场景行程速度范围分辨率要求核心痛点摄影延时滑轨300-800mm0.5-30mm/s0.01mm速度平滑、无抖动微距堆栈平台20-80mm0.05-5mm/s0.001-0.005mm回差、重复定位小型检测扫描100-300mm5-50mm/s0.01mm双轴插补、轨迹精度看这张表就知道一套硬件不可能同时把三类场景都做到极致。我的做法是把机械部分做成模块化长行程用同步带短行程高精度用丝杆主控板和固件完全通用靠参数配置切换。这样一套固件能覆盖三种用法用户按自己的场景换传动件就行不用重新学一套系统。1.2 为什么主控选 ESP32 而不是别的很多人第一反应是运动控制为什么不用 STM32。STM32 当然更合适定时器资源丰富、中断响应确定、生态成熟。但开源项目要考虑的是上手门槛和整体成本ESP32 模组价格低自带 WiFi 和蓝牙开发用 Arduino 框架或者 ESP-IDF 都行社区资料多一块板子既能发脉冲又能开网页做上位机省掉了一个额外的通信模块和一块屏幕。对于低成本这个前提这是决定性的。另一个现实原因是算力够用。双轴步进控制的核心计算量其实很小每个脉冲只需要判断该不该发、往哪个轴发加减速规划在运动开始前就算完了运行期只是查表或者做几次整数加减。ESP32 双核 240MHz一个核专门跑脉冲生成和状态机另一个核跑通信和网页服务互不干扰实测下来很稳。当然有代价。ESP32 的硬件定时器数量有限Arduino 框架下常用的是hw_timer_t两个定时器分别给两个轴发脉冲是最直接的做法但如果要做严格的双轴插补两个独立定时器会有相位漂移。我的解法是一个定时器统一发脉冲另一个轴用 Bresenham 式的步进分配算法在同一个中断里决定这一步走不走这样两轴的脉冲在时间上天然对齐插补出来的直线不会变成锯齿。这个细节后面第 3 章会展开讲。1.3 传动方案丝杆和同步带不是二选一的问题新手最容易在这里走弯路听说丝杆精度高就全用丝杆结果发现 800mm 行程的丝杆又贵又容易下垂、临界转速还低跑快一点整根杆子都在抖。反过来全用同步带短行程下回差和弹性又压不住。我的经验是按行程和精度分界行程 150mm 以内、要求亚毫米级以下分辨率用丝杆行程超过 300mm、要求速度和平顺性用同步带中间地带看具体需求优先同步带加涨紧成本低很多。丝杆选 T8 梯形丝杆导程 2mm 的比 8mm 的分辨率高四倍但同样的速度需要四倍的转速电机容易进入共振区这是个典型的取舍。同步带这边GT2 规格、20 齿的带轮一圈正好 40mm配 1.8° 步进电机整步 200 步一圈算下来一个整步就是 0.2mm。听起来很粗但加上 16 细分之后一个脉冲只有 0.0125mm做摄影滑轨完全够用。同步带的软肋是弹性形变和回差长行程下皮带会被拉长反向运动时有一段空走这个必须靠固件里的反向间隙补偿来补后面会讲具体怎么标定。2. 硬件搭接钱要花在刀刃上低成本不等于省该省的钱。这套系统里我最不愿意省的三样东西是驱动器、电源、接插件。主控板坏了换一块几十块驱动器选便宜的在低速下丢步、发热、啸叫你排查半天会以为是固件问题电源功率不够两个轴同时加速时电压瞬间塌陷表现出来就是偶尔丢一步这种间歇性故障最折磨人。整体架构我画成了一条很直白的链路上位机电脑或手机网页通过串口或者 WiFi 下发指令ESP32 解析成运动任务交给脉冲发生器脉冲进驱动器驱动器推电机电机带传动件传动件上挂着滑台。回零开关和急停按钮接在 ESP32 的输入脚上作为安全兜底。整条链路里任何一个环节的裕量不够最终都会体现在滑台的位置上。2.1 主控与驱动器的搭配逻辑驱动器我一般用带细分和静音控制的两类模块一类是带 UART 配置的静音驱动芯片细分可以设到 1/64运行噪音低适合摄影和室内场景另一类是传统的拨码式细分驱动模块便宜、皮实、不需要配置适合预算紧或者不想折腾的用户。两者的接口都是 STEP/DIR/EN 三根线固件层面完全一样换驱动器只要改一下每圈脉冲数的配置。这里有个很容易忽略的点驱动器的使能极性。有的模块 EN 低电平使能有的高电平使能接反了表现为电机通电但锁不死手一推就转。我在固件里把使能极性做成了配置项上电自检时先使能再读一次限位状态如果限位状态和预期不符就报错避免带病运行。电流设置是第二个坑。步进电机的额定电流是每相电流驱动器上的电位器或者 UART 参数设的是峰值电流一般取额定值的 70% 到 85%。设太高电机烫手、低速共振明显设太低扭矩不够加速时直接丢步。我的做法是先按额定值的 80% 设跑一段带负载的往复运动用手背贴电机外壳感受温度温热40-50℃是正常的烫到不能碰就往下调。2.2 电源、接地与走线噪声是精度的隐形杀手我踩过最贵的一个坑就是电源。第一次搭的时候用了一个标称 12V 5A 的适配器带两个轴空载一切正常一加速就随机丢步日志里看不出任何规律。换成 24V 开关电源之后问题消失。原因很朴素步进电机在加速瞬间的电流需求是额定值的数倍电源响应跟不上母线电压瞬间跌落驱动器进入欠压保护丢一步。电压选 24V 而不是 12V是因为更高的母线电压能让电流更快地建立起来高速段的扭矩衰减明显更小。同样转速下24V 能跑到的最高速度大概是 12V 的一倍半。电流按两个电机额定电流之和 × 1.5来配比如两个 1.2A 的电机电源至少选 24V 4A 以上留足余量。接地这件事看起来玄学实际很实在。电机线、电源线、信号线捆在一起走脉冲信号上会串进开关噪声表现是电机偶尔多走一步或者少走一步。我的做法是电机线用双绞信号线尽量远离电机线所有地线单点汇到电源负极ESP32 的 GND 和驱动器的 GND 必须共地但不要把电机的大电流回路和逻辑地混在一根细线上。如果条件允许光耦隔离或者加一级缓冲器是最省心的。注意调试阶段务必先断开电机只上逻辑电确认 ESP32 能正常启动、能读到限位状态、串口有输出再接电机上强电。反过来的顺序很容易在接线错误时烧驱动器。2.3 回零与限位最便宜也最容易翻车的一环回零开关我用过三种机械微动、光电对射、霍尔磁感应。机械微动最便宜但触发位置有 0.05mm 左右的抖动重复精度差只适合做粗略找零光电对射重复精度好但需要遮挡片结构上麻烦一点霍尔加磁铁安装最灵活成本居中重复精度也够用我现在默认推荐这个。接线上的关键点是常闭还是常开。很多人图省事用常开断线的时候系统认为没触发滑台会一路撞到底。用常闭接法断线等同于触发固件立刻停机这是安全设计的基本功。如果你的开关只有常开那就在固件里加一个回零超时保护走完最大行程还没触发立即停止并报错。回零流程我固定成三步快速逼近比如 20mm/s→ 触发后回退 2mm → 慢速二次逼近2mm/s直到再次触发这个位置记为原点。加二次逼近的原因很直接快速逼近时触发位置受速度和开关响应延迟影响慢速逼近把这个误差压到最小实测重复精度能从 0.05mm 提到 0.01mm 以内。多花两秒换来的是每次开机位置一致。3. 步距换算与运动规划精度是算出来的很多人装完机器发现走 100mm 实际走了 98.6mm第一反应是固件有 bug其实是没做步距标定。开源双轴电动滑轨的精度不是买来的是一步步算出来、标出来的。这一章我把换算过程、加减速规划和双轴插补的算法摊开讲你照着算一遍心里就有数了。3.1 一个脉冲到底走多远先算理论值。以 T8 丝杆、导程 2mm 为例1.8° 步进电机转一圈是 360/1.8 200 个整步驱动器设 16 细分则一圈需要 200 × 16 3200 个脉冲丝杆转一圈滑台走 2mm所以每个脉冲对应 2 / 3200 0.000625mm也就是 0.625μm。这个数字听着很美好但注意它是理论分辨率不等于实际精度——丝杆本身有导程误差螺母有回差滑台有间隙实际能到 0.01mm 的重复定位精度就已经很不错了。同步带的算法类似GT2 带轮 20 齿节圆周长 40mm一圈 3200 个脉冲同样 16 细分每个脉冲 40 / 3200 0.0125mm。想要更细可以提高细分到 32 或者换齿数更少的带轮但细分不是越高越好超过 1/32 之后扭矩下降明显而且大部分驱动器的细分精度本身就不高1/16 到 1/32 是性价比区间。理论算完必须做实测标定。方法很土但有效在滑台上贴一张纸用铅笔划一条起始线指令走 100mm用游标卡尺量实际位移算出比例系数写回固件。我一般往返各测三次取平均因为单向测量会把回差算进去。标定后的系数存在 ESP32 的 NVS 里掉电不丢。传动方式每圈位移16细分每脉冲位移适用行程注意事项T8 丝杆 导程2mm2mm0.000625mm≤150mm临界转速低别跑太快T8 丝杆 导程8mm8mm0.0025mm≤300mm自锁性差垂直安装要配重GT2 同步带 20齿40mm0.0125mm≥300mm必须做张紧和回差补偿3.2 梯形曲线手算全过程步进电机不能说走就走、说停就停直接给脉冲会失步或者过冲。必须做加减速规划最常用的是梯形速度曲线加速段、匀速段、减速段。参数就三个最大速度 v、加速度 a、目标位移 s。手算一遍。设 v 20mm/sa 100mm/s²s 100mm。加速到最大速度需要的时间 t1 v/a 0.2s这段走的距离 s1 v²/(2a) 400/200 2mm。减速同理减速距离也是 2mm。那么匀速段距离 100 - 2 - 2 96mm匀速时间 96/20 4.8s总时间 5.2s。如果目标位移很小比如 s 2mm那 s1 s2 4mm 已经超过总行程说明根本加速不到最大速度这就是三角形曲线实际峰值速度 v √(a·s) √(100×2) 14.14mm/s。固件里必须有这个判断否则短距离移动会算出负的匀速段表现为电机猛地一顿。实际实现时我不在运行期做浮点积分而是在运动开始前把整段轨迹离散成每个脉冲的间隔时间存进一个缓冲区中断里只管取出下一个间隔装进定时器。ESP32 的 RAM 够用一段 100mm 的运动大概几万个脉冲按每步存一个 16 位间隔太占空间所以我的做法是分段查表把加减速过程分成若干段每段用起始间隔和间隔增量做线性插值运行期只做加法和比较整数运算中断里几微秒就完事。提示加速度不要设太大。机械结构的刚性有限a 设到 500mm/s² 以上时滑台在启停瞬间会有明显回弹视频里看得出来长期还会松动螺丝。200-300mm/s² 是大多数小型滑轨的舒适区。3.3 双轴插补怎么保证不走斜线双轴联动走直线理论上要求两个轴的脉冲在时间上严格成比例。如果两个轴各用一个定时器即使频率算得一样中断响应的抖动也会让某一轴偶尔多走一步累积起来直线就变成了波浪线。我用的是经典的步进分配算法思路和画直线的 Bresenham 算法一样把位移大的那个轴定为主轴主轴每发一个脉冲累加器加上从轴的步数累加值超过主轴步数就給从轴发一个脉冲并减去主轴步数。这样从轴的脉冲天然嵌在主轴脉冲序列里不会出现两轴各跑各的。主轴的速度曲线决定整体节奏从轴只是跟着走插补出来的直线误差不超过一个脉冲。圆弧插补我也做了简化版把圆弧按角度切成足够多的小线段每段用直线插补走完段数按弦高误差小于 0.01mm来算。听起来粗糙但 0.01mm 的弦高误差在视觉和小型检测场景里完全看不出来代码量却只有真正圆弧插补的十分之一。4. 固件结构与通信协议固件这块我的原则是结构简单、状态明确、出错能查。整个程序跑两个任务一个在核心 0 上跑运动控制硬件定时器中断里发脉冲、更新位置、判断是否到位另一个在核心 1 上跑通信和网页服务接收指令、解析、入队。两个任务之间用一个环形的指令队列通信运动任务每完成一条指令就取下一个队列空了就进入空闲。这样拆分的好处是通信卡顿不会影响脉冲输出。我试过在单任务里轮询串口网页一刷新脉冲就抖一下滑台肉眼可见地顿一顿。分开之后即使上位机发了疯一样刷指令运动端该多稳还多稳。4.1 用硬件定时器做脉冲源ESP32 在 Arduino 框架下可以用hw_timer_t配置硬件定时器精度到微秒级。我的做法是配置一个 1MHz 的定时器每次中断根据当前速度算出下一个脉冲的间隔重装定时器。速度低的时候间隔大速度快的时候间隔小最小间隔受中断开销限制实测安全下限在 15-20μs 左右对应大概 50kHz 的脉冲频率换算成丝杆就是 31mm/s同步带就是 625mm/s够用了。中断服务函数里只做最简单的几件事翻转 STEP 引脚、更新当前位置计数、判断是否走完当前段、取出下一个间隔。绝对不要在中断里做浮点运算、串口打印、内存分配这些操作会让中断延迟忽长忽短表现出来就是电机声音发虚、位置漂移。我见过有人在中断里Serial.println调试结果电机跑起来像卡了痰就是这个原因。4.2 一套够用的指令协议协议不需要多复杂我实现了一个 G 代码的最小子集够用且容易和现有上位机软件对接指令含义示例G0快速定位G0 X100 Y50G1直线插补带进给速度G1 X100 F20G28回零G28 X或G28G92设置当前位置G92 X0 Y0M114查询当前位置M114M112急停M112每条指令执行完回一个ok出错回error:代码。位置查询返回X:12.345 Y:6.789保留三位小数对应微米级显示。急停指令优先级最高收到立刻停脉冲、断使能不等队列。这套协议的优点是兼容性好很多现成的控制软件、切片软件、CNC 前端都能直接连用户不用为了这套滑轨专门学一个新软件。缺点是 G 代码本身冗长长距离高频小段运动会把串口带宽吃满所以我加了行号校验和发送窗口上位机可以连续发多条不等待固件按顺序执行队列满了返回busy让上位机重试。4.3 关键代码片段脉冲中断的骨架大概是这样删掉了具体引脚定义保留逻辑// 运动状态 volatile int32_t stepsRemaining[2] {0, 0}; volatile int32_t currentPos[2] {0, 0}; volatile uint32_t intervalUs 100; // 当前脉冲间隔 volatile bool dirBit[2] {false, false}; void IRAM_ATTR onPulseTimer() { // 主轴固定发脉冲从轴按累加器决定是否发 digitalWrite(PIN_STEP_X, HIGH); digitalWrite(PIN_STEP_X, LOW); currentPos[0] dirBit[0] ? 1 : -1; stepsRemaining[0]--; accY abs(stepsRemaining[1]); if (accY abs(stepsRemaining[0]) 1) { digitalWrite(PIN_STEP_Y, HIGH); digitalWrite(PIN_STEP_Y, LOW); currentPos[1] dirBit[1] ? 1 : -1; accY - abs(stepsRemaining[0]) 1; } if (stepsRemaining[0] 0) { timerStop(); // 本段结束交给主循环规划下一段 segmentDone true; return; } timerAlarmWrite(timer, intervalUs, true); // 重装下一个间隔 }加减速表的生成放在主循环里一次算好整段的间隔序列中断只负责取用void planTrapezoid(int32_t totalSteps, float vMax, float accel, float stepsPerMm) { // 全部换算成步和步/秒^2 float vMaxSteps vMax * stepsPerMm; float accelSteps accel * stepsPerMm; int32_t accelStepsDist (int32_t)(vMaxSteps * vMaxSteps / (2 * accelSteps)); if (accelStepsDist * 2 totalSteps) { // 三角形曲线加速不到设定速度 accelStepsDist totalSteps / 2; } // 加速段、匀速段、减速段的间隔依次压入环形缓冲 buildAccelTable(0, accelStepsDist, accelSteps); buildCruiseTable(accelStepsDist, totalSteps - accelStepsDist * 2, vMaxSteps); buildDecelTable(totalSteps - accelStepsDist, totalSteps, accelSteps); }这里有个实践中的小优化间隔表不用存每一步而是存每 N 步的间隔中断里做线性插值。N 取 8 到 16内存省了十几倍速度曲线的误差小到测不出来。5. 联调现场那些文档里不会写的问题软件跑通不代表机器能干活。真正的功夫在联调而联调阶段遇到的问题九成在教科书和芯片手册里都找不到。这一章我把踩过的坑按症状归类附上排查路径你可以当成一份速查手册用。5.1 丢步的四种典型症状丢步是步进系统最常见的病但病因有好几种得靠症状区分。第一种加速瞬间丢步。现象是每次启动都少走一点匀速段正常。这是扭矩不够要么电流设低了要么加速度设大了要么电源功率不足。排查顺序先把加速度砍一半试好了就是加速度问题没好就量母线电压加速瞬间掉超过 10% 就是电源问题都正常就往上调电流。第二种高速段丢步。低速正常速度一提就丢。这是电机的高频扭矩衰减步进电机的扭矩随转速上升而下降超过某个转速就带不动了。解法是提高母线电压、降低细分细分越高高速扭矩越差、或者减小负载。第三种随机丢步毫无规律。这种最烦八成是干扰。检查电机线是否和信号线捆在一起、地线是否共地良好、驱动器是否和主控共用一条细地线。我遇到过一次原因是电机线和限位开关线绑在一起限位触发瞬间的干扰窜进脉冲线换线序就好了。第四种反向时丢步。正向准反向差一截。这不是丢步是回差看下一节。5.2 抖动、异响与共振区步进电机在某个特定速度区间会进入共振表现为声音突然变大、滑台明显抖动、甚至丢步。这个区间通常在 100-300 转/分之间换算成丝杆大概就是 3-10mm/s恰好是摄影滑轨最常用的速度段非常要命。三个办法对付它。一是避开把常用速度设在共振区之外但摄影场景需要慢速避不开。二是加细分细分越高单步的力矩冲击越小共振越不明显1/16 以上改善很明显。三是加阻尼机械上可以在电机轴上加一个惯性轮或者用带阻尼的联轴器电学上可以用驱动器的静音模式内部的电流斩波算法会抑制共振。我最后是 1/32 细分加静音驱动慢速段基本听不到声音。还有一种异响来自机械同步带张紧不够会在启动时啪一下丝杆润滑不足会有连续的沙沙声。这些问题不难判断断电用手推滑台感觉一下有没有卡顿、有没有旷量比通电听声更直接。5.3 回差与重复定位精度回差是机械传动的固有属性丝杆螺母有间隙同步带有弹性反向运动时有一段走了但没带动的空行程。丝杆的回差通常在 0.05-0.2mm同步带能到 0.3mm 以上对微距堆栈这种要求 0.01mm 的场景是致命的。补偿的办法是单向逼近不管目标位置在哪个方向永远从同一个方向靠近它。比如目标在 X50当前在 X60不要直接反向走 10mm而是先反向走到 X49再正向走 1mm 到 X50。这样每次逼近的方向一致回差被吃在同一边重复定位精度立刻就上来了。代价是多走一段距离但对精度要求高的场景完全值得。标定回差的方法指令从 0 走到 50mm记录实际位置再从 50 走回 0记录实际位置两者之差就是回差。往返测三次取平均写进固件作为补偿量。如果回差随位置变化丝杆不同段的磨损不同就分几段分别标定用查找表补偿。5.4 常见问题速查表联调时我基本靠这张表定位问题现象最可能原因快速验证方法处理电机通电但不锁死使能极性反了 / 电流太低手动转轴有阻力说明已使能改使能配置或调电流上电就朝一个方向猛冲限位接错 / 回零方向配反手动触发限位看串口状态改方向或换常闭接法走 100mm 只走了 98mm步距系数没标定卡尺实测后反算比例写回标定系数慢速时抖动明显进入共振区换个速度试提细分、开静音模式反向定位不准机械回差往返测同一位置单向逼近 补偿偶尔随机丢步电源或干扰加速瞬间量母线电压换电源、改走线网页一刷新就顿通信和脉冲同核竞争观察是否只在通信时发生双核拆分任务回零位置每次不同单次快速逼近对比多次回零坐标加二次慢速逼近这张表不是穷举但覆盖了我遇到的八成问题。真遇到表里没有的我的排查顺序永远是先断开负载空转确认是电气问题还是机械问题再单轴运行排除双轴插补的干扰最后才怀疑固件。这个顺序能省掉大量瞎猜的时间。6. 最后分享几点实际调试的体会这套系统我从第一版焊洞洞板到现在前后改了七八版。最大的感受是低成本的瓶颈从来不在主控而在机械和电源。一块 ESP32 能做的事远超大多数人的想象真正拖后腿的是丝杆的导程误差、同步带的弹性、电源的瞬态响应。我个人的习惯是每改一版都留一份参数快照把步距系数、回差补偿、加速度、电流设置这些东西记下来。不同负载下这些参数是要变的换个滑台、加个相机加速度就得往下调。有记录才能快速回滚不然调着调着就不知道哪一版是好的了。还有个小技巧值得一试把限位开关的状态和当前位置实时显示在上位机网页上做成一个简单的可视化面板。调试的时候肉眼盯着数字变化比看串口滚屏高效得多尤其是排查回零异常的时候你能直接看到触发瞬间的坐标跳变。 
长河君 · 2026/10/29 5:54:45 · 阅读 1.2k 基于ESP32的开源双轴电动滑轨：低成本高精度运动控制
1. 先把需求边界划清楚这套滑轨到底给谁用做开源双轴电动滑轨这件事我一开始的想法很朴素让相机能沿着一条直线匀速滑过去再让平台上下微调一点高度拍一组焦点堆栈。真动起手来才发现只要沾上双轴两个字问题就从能不能动变成了动得准不准、停得稳不稳、重复来一次还是不是同一个位置。这套基于 ESP32 的低成本高精度运动控制系统本质上解决的是中小型自动化场景里买成品太贵、自己搭又不知道从哪下手的尴尬一套商用的双轴电动滑轨模组报价动辄四位数往上而用开源方案把主控、驱动、传动、固件拆开自己配硬件成本能压到前者的三分之一甚至更低精度却能做到亚毫米级、重复定位精度稳定在几十微米量级。它适合的人其实比想象中多。拍延时和微距堆栈的摄影爱好者需要平滑无抖动的直线运动做显微镜载物台改造的人需要小行程、高分辨率的两轴定位搞小型自动化检测、激光打标辅助、3D 扫描转台的开发者需要一套能接受指令、能回零、能重复定位的运动平台。这些人共同的需求是开源、可改、成本可控、精度够用而不是追求工业级机床那种微米级重复定位。我把这套东西的定位说得很清楚它不是工业运动控制卡别指望它带伺服、跑多轴联动插补、做闭环光栅反馈。它是一套能用、好改、便宜的开源双轴电动滑轨方案核心是 ESP32 做主控两路步进驱动配合丝杆或同步带传动用硬件定时器发脉冲用一套精简的 G 代码子集和上位机对话。把边界划清楚后面所有的选型和取舍才有依据。1.1 三种典型使用场景倒推设计指标我习惯从场景倒推指标而不是先堆参数。第一种是摄影滑轨行程 300mm 到 800mm速度要求不高0.5mm/s 到 30mm/s 就够但对速度平滑度极其敏感任何一点速度突变在视频里都会变成肉眼可见的顿挫。第二种是微距堆栈平台行程只有几十毫米但步进分辨率要求高单步位移最好在 1μm 到 5μm 之间而且需要能精确重复回到同一起点。第三种是小型检测或扫描平台两轴都要动要求能走直线、能走方框轨迹速度中等重点在轨迹精度和长期运行的稳定性。这三类需求放到一张表里对比取舍就很清楚了场景行程速度范围分辨率要求核心痛点摄影延时滑轨300-800mm0.5-30mm/s0.01mm速度平滑、无抖动微距堆栈平台20-80mm0.05-5mm/s0.001-0.005mm回差、重复定位小型检测扫描100-300mm5-50mm/s0.01mm双轴插补、轨迹精度看这张表就知道一套硬件不可能同时把三类场景都做到极致。我的做法是把机械部分做成模块化长行程用同步带短行程高精度用丝杆主控板和固件完全通用靠参数配置切换。这样一套固件能覆盖三种用法用户按自己的场景换传动件就行不用重新学一套系统。1.2 为什么主控选 ESP32 而不是别的很多人第一反应是运动控制为什么不用 STM32。STM32 当然更合适定时器资源丰富、中断响应确定、生态成熟。但开源项目要考虑的是上手门槛和整体成本ESP32 模组价格低自带 WiFi 和蓝牙开发用 Arduino 框架或者 ESP-IDF 都行社区资料多一块板子既能发脉冲又能开网页做上位机省掉了一个额外的通信模块和一块屏幕。对于低成本这个前提这是决定性的。另一个现实原因是算力够用。双轴步进控制的核心计算量其实很小每个脉冲只需要判断该不该发、往哪个轴发加减速规划在运动开始前就算完了运行期只是查表或者做几次整数加减。ESP32 双核 240MHz一个核专门跑脉冲生成和状态机另一个核跑通信和网页服务互不干扰实测下来很稳。当然有代价。ESP32 的硬件定时器数量有限Arduino 框架下常用的是hw_timer_t两个定时器分别给两个轴发脉冲是最直接的做法但如果要做严格的双轴插补两个独立定时器会有相位漂移。我的解法是一个定时器统一发脉冲另一个轴用 Bresenham 式的步进分配算法在同一个中断里决定这一步走不走这样两轴的脉冲在时间上天然对齐插补出来的直线不会变成锯齿。这个细节后面第 3 章会展开讲。1.3 传动方案丝杆和同步带不是二选一的问题新手最容易在这里走弯路听说丝杆精度高就全用丝杆结果发现 800mm 行程的丝杆又贵又容易下垂、临界转速还低跑快一点整根杆子都在抖。反过来全用同步带短行程下回差和弹性又压不住。我的经验是按行程和精度分界行程 150mm 以内、要求亚毫米级以下分辨率用丝杆行程超过 300mm、要求速度和平顺性用同步带中间地带看具体需求优先同步带加涨紧成本低很多。丝杆选 T8 梯形丝杆导程 2mm 的比 8mm 的分辨率高四倍但同样的速度需要四倍的转速电机容易进入共振区这是个典型的取舍。同步带这边GT2 规格、20 齿的带轮一圈正好 40mm配 1.8° 步进电机整步 200 步一圈算下来一个整步就是 0.2mm。听起来很粗但加上 16 细分之后一个脉冲只有 0.0125mm做摄影滑轨完全够用。同步带的软肋是弹性形变和回差长行程下皮带会被拉长反向运动时有一段空走这个必须靠固件里的反向间隙补偿来补后面会讲具体怎么标定。2. 硬件搭接钱要花在刀刃上低成本不等于省该省的钱。这套系统里我最不愿意省的三样东西是驱动器、电源、接插件。主控板坏了换一块几十块驱动器选便宜的在低速下丢步、发热、啸叫你排查半天会以为是固件问题电源功率不够两个轴同时加速时电压瞬间塌陷表现出来就是偶尔丢一步这种间歇性故障最折磨人。整体架构我画成了一条很直白的链路上位机电脑或手机网页通过串口或者 WiFi 下发指令ESP32 解析成运动任务交给脉冲发生器脉冲进驱动器驱动器推电机电机带传动件传动件上挂着滑台。回零开关和急停按钮接在 ESP32 的输入脚上作为安全兜底。整条链路里任何一个环节的裕量不够最终都会体现在滑台的位置上。2.1 主控与驱动器的搭配逻辑驱动器我一般用带细分和静音控制的两类模块一类是带 UART 配置的静音驱动芯片细分可以设到 1/64运行噪音低适合摄影和室内场景另一类是传统的拨码式细分驱动模块便宜、皮实、不需要配置适合预算紧或者不想折腾的用户。两者的接口都是 STEP/DIR/EN 三根线固件层面完全一样换驱动器只要改一下每圈脉冲数的配置。这里有个很容易忽略的点驱动器的使能极性。有的模块 EN 低电平使能有的高电平使能接反了表现为电机通电但锁不死手一推就转。我在固件里把使能极性做成了配置项上电自检时先使能再读一次限位状态如果限位状态和预期不符就报错避免带病运行。电流设置是第二个坑。步进电机的额定电流是每相电流驱动器上的电位器或者 UART 参数设的是峰值电流一般取额定值的 70% 到 85%。设太高电机烫手、低速共振明显设太低扭矩不够加速时直接丢步。我的做法是先按额定值的 80% 设跑一段带负载的往复运动用手背贴电机外壳感受温度温热40-50℃是正常的烫到不能碰就往下调。2.2 电源、接地与走线噪声是精度的隐形杀手我踩过最贵的一个坑就是电源。第一次搭的时候用了一个标称 12V 5A 的适配器带两个轴空载一切正常一加速就随机丢步日志里看不出任何规律。换成 24V 开关电源之后问题消失。原因很朴素步进电机在加速瞬间的电流需求是额定值的数倍电源响应跟不上母线电压瞬间跌落驱动器进入欠压保护丢一步。电压选 24V 而不是 12V是因为更高的母线电压能让电流更快地建立起来高速段的扭矩衰减明显更小。同样转速下24V 能跑到的最高速度大概是 12V 的一倍半。电流按两个电机额定电流之和 × 1.5来配比如两个 1.2A 的电机电源至少选 24V 4A 以上留足余量。接地这件事看起来玄学实际很实在。电机线、电源线、信号线捆在一起走脉冲信号上会串进开关噪声表现是电机偶尔多走一步或者少走一步。我的做法是电机线用双绞信号线尽量远离电机线所有地线单点汇到电源负极ESP32 的 GND 和驱动器的 GND 必须共地但不要把电机的大电流回路和逻辑地混在一根细线上。如果条件允许光耦隔离或者加一级缓冲器是最省心的。注意调试阶段务必先断开电机只上逻辑电确认 ESP32 能正常启动、能读到限位状态、串口有输出再接电机上强电。反过来的顺序很容易在接线错误时烧驱动器。2.3 回零与限位最便宜也最容易翻车的一环回零开关我用过三种机械微动、光电对射、霍尔磁感应。机械微动最便宜但触发位置有 0.05mm 左右的抖动重复精度差只适合做粗略找零光电对射重复精度好但需要遮挡片结构上麻烦一点霍尔加磁铁安装最灵活成本居中重复精度也够用我现在默认推荐这个。接线上的关键点是常闭还是常开。很多人图省事用常开断线的时候系统认为没触发滑台会一路撞到底。用常闭接法断线等同于触发固件立刻停机这是安全设计的基本功。如果你的开关只有常开那就在固件里加一个回零超时保护走完最大行程还没触发立即停止并报错。回零流程我固定成三步快速逼近比如 20mm/s→ 触发后回退 2mm → 慢速二次逼近2mm/s直到再次触发这个位置记为原点。加二次逼近的原因很直接快速逼近时触发位置受速度和开关响应延迟影响慢速逼近把这个误差压到最小实测重复精度能从 0.05mm 提到 0.01mm 以内。多花两秒换来的是每次开机位置一致。3. 步距换算与运动规划精度是算出来的很多人装完机器发现走 100mm 实际走了 98.6mm第一反应是固件有 bug其实是没做步距标定。开源双轴电动滑轨的精度不是买来的是一步步算出来、标出来的。这一章我把换算过程、加减速规划和双轴插补的算法摊开讲你照着算一遍心里就有数了。3.1 一个脉冲到底走多远先算理论值。以 T8 丝杆、导程 2mm 为例1.8° 步进电机转一圈是 360/1.8 200 个整步驱动器设 16 细分则一圈需要 200 × 16 3200 个脉冲丝杆转一圈滑台走 2mm所以每个脉冲对应 2 / 3200 0.000625mm也就是 0.625μm。这个数字听着很美好但注意它是理论分辨率不等于实际精度——丝杆本身有导程误差螺母有回差滑台有间隙实际能到 0.01mm 的重复定位精度就已经很不错了。同步带的算法类似GT2 带轮 20 齿节圆周长 40mm一圈 3200 个脉冲同样 16 细分每个脉冲 40 / 3200 0.0125mm。想要更细可以提高细分到 32 或者换齿数更少的带轮但细分不是越高越好超过 1/32 之后扭矩下降明显而且大部分驱动器的细分精度本身就不高1/16 到 1/32 是性价比区间。理论算完必须做实测标定。方法很土但有效在滑台上贴一张纸用铅笔划一条起始线指令走 100mm用游标卡尺量实际位移算出比例系数写回固件。我一般往返各测三次取平均因为单向测量会把回差算进去。标定后的系数存在 ESP32 的 NVS 里掉电不丢。传动方式每圈位移16细分每脉冲位移适用行程注意事项T8 丝杆 导程2mm2mm0.000625mm≤150mm临界转速低别跑太快T8 丝杆 导程8mm8mm0.0025mm≤300mm自锁性差垂直安装要配重GT2 同步带 20齿40mm0.0125mm≥300mm必须做张紧和回差补偿3.2 梯形曲线手算全过程步进电机不能说走就走、说停就停直接给脉冲会失步或者过冲。必须做加减速规划最常用的是梯形速度曲线加速段、匀速段、减速段。参数就三个最大速度 v、加速度 a、目标位移 s。手算一遍。设 v 20mm/sa 100mm/s²s 100mm。加速到最大速度需要的时间 t1 v/a 0.2s这段走的距离 s1 v²/(2a) 400/200 2mm。减速同理减速距离也是 2mm。那么匀速段距离 100 - 2 - 2 96mm匀速时间 96/20 4.8s总时间 5.2s。如果目标位移很小比如 s 2mm那 s1 s2 4mm 已经超过总行程说明根本加速不到最大速度这就是三角形曲线实际峰值速度 v √(a·s) √(100×2) 14.14mm/s。固件里必须有这个判断否则短距离移动会算出负的匀速段表现为电机猛地一顿。实际实现时我不在运行期做浮点积分而是在运动开始前把整段轨迹离散成每个脉冲的间隔时间存进一个缓冲区中断里只管取出下一个间隔装进定时器。ESP32 的 RAM 够用一段 100mm 的运动大概几万个脉冲按每步存一个 16 位间隔太占空间所以我的做法是分段查表把加减速过程分成若干段每段用起始间隔和间隔增量做线性插值运行期只做加法和比较整数运算中断里几微秒就完事。提示加速度不要设太大。机械结构的刚性有限a 设到 500mm/s² 以上时滑台在启停瞬间会有明显回弹视频里看得出来长期还会松动螺丝。200-300mm/s² 是大多数小型滑轨的舒适区。3.3 双轴插补怎么保证不走斜线双轴联动走直线理论上要求两个轴的脉冲在时间上严格成比例。如果两个轴各用一个定时器即使频率算得一样中断响应的抖动也会让某一轴偶尔多走一步累积起来直线就变成了波浪线。我用的是经典的步进分配算法思路和画直线的 Bresenham 算法一样把位移大的那个轴定为主轴主轴每发一个脉冲累加器加上从轴的步数累加值超过主轴步数就給从轴发一个脉冲并减去主轴步数。这样从轴的脉冲天然嵌在主轴脉冲序列里不会出现两轴各跑各的。主轴的速度曲线决定整体节奏从轴只是跟着走插补出来的直线误差不超过一个脉冲。圆弧插补我也做了简化版把圆弧按角度切成足够多的小线段每段用直线插补走完段数按弦高误差小于 0.01mm来算。听起来粗糙但 0.01mm 的弦高误差在视觉和小型检测场景里完全看不出来代码量却只有真正圆弧插补的十分之一。4. 固件结构与通信协议固件这块我的原则是结构简单、状态明确、出错能查。整个程序跑两个任务一个在核心 0 上跑运动控制硬件定时器中断里发脉冲、更新位置、判断是否到位另一个在核心 1 上跑通信和网页服务接收指令、解析、入队。两个任务之间用一个环形的指令队列通信运动任务每完成一条指令就取下一个队列空了就进入空闲。这样拆分的好处是通信卡顿不会影响脉冲输出。我试过在单任务里轮询串口网页一刷新脉冲就抖一下滑台肉眼可见地顿一顿。分开之后即使上位机发了疯一样刷指令运动端该多稳还多稳。4.1 用硬件定时器做脉冲源ESP32 在 Arduino 框架下可以用hw_timer_t配置硬件定时器精度到微秒级。我的做法是配置一个 1MHz 的定时器每次中断根据当前速度算出下一个脉冲的间隔重装定时器。速度低的时候间隔大速度快的时候间隔小最小间隔受中断开销限制实测安全下限在 15-20μs 左右对应大概 50kHz 的脉冲频率换算成丝杆就是 31mm/s同步带就是 625mm/s够用了。中断服务函数里只做最简单的几件事翻转 STEP 引脚、更新当前位置计数、判断是否走完当前段、取出下一个间隔。绝对不要在中断里做浮点运算、串口打印、内存分配这些操作会让中断延迟忽长忽短表现出来就是电机声音发虚、位置漂移。我见过有人在中断里Serial.println调试结果电机跑起来像卡了痰就是这个原因。4.2 一套够用的指令协议协议不需要多复杂我实现了一个 G 代码的最小子集够用且容易和现有上位机软件对接指令含义示例G0快速定位G0 X100 Y50G1直线插补带进给速度G1 X100 F20G28回零G28 X或G28G92设置当前位置G92 X0 Y0M114查询当前位置M114M112急停M112每条指令执行完回一个ok出错回error:代码。位置查询返回X:12.345 Y:6.789保留三位小数对应微米级显示。急停指令优先级最高收到立刻停脉冲、断使能不等队列。这套协议的优点是兼容性好很多现成的控制软件、切片软件、CNC 前端都能直接连用户不用为了这套滑轨专门学一个新软件。缺点是 G 代码本身冗长长距离高频小段运动会把串口带宽吃满所以我加了行号校验和发送窗口上位机可以连续发多条不等待固件按顺序执行队列满了返回busy让上位机重试。4.3 关键代码片段脉冲中断的骨架大概是这样删掉了具体引脚定义保留逻辑// 运动状态 volatile int32_t stepsRemaining[2] {0, 0}; volatile int32_t currentPos[2] {0, 0}; volatile uint32_t intervalUs 100; // 当前脉冲间隔 volatile bool dirBit[2] {false, false}; void IRAM_ATTR onPulseTimer() { // 主轴固定发脉冲从轴按累加器决定是否发 digitalWrite(PIN_STEP_X, HIGH); digitalWrite(PIN_STEP_X, LOW); currentPos[0] dirBit[0] ? 1 : -1; stepsRemaining[0]--; accY abs(stepsRemaining[1]); if (accY abs(stepsRemaining[0]) 1) { digitalWrite(PIN_STEP_Y, HIGH); digitalWrite(PIN_STEP_Y, LOW); currentPos[1] dirBit[1] ? 1 : -1; accY - abs(stepsRemaining[0]) 1; } if (stepsRemaining[0] 0) { timerStop(); // 本段结束交给主循环规划下一段 segmentDone true; return; } timerAlarmWrite(timer, intervalUs, true); // 重装下一个间隔 }加减速表的生成放在主循环里一次算好整段的间隔序列中断只负责取用void planTrapezoid(int32_t totalSteps, float vMax, float accel, float stepsPerMm) { // 全部换算成步和步/秒^2 float vMaxSteps vMax * stepsPerMm; float accelSteps accel * stepsPerMm; int32_t accelStepsDist (int32_t)(vMaxSteps * vMaxSteps / (2 * accelSteps)); if (accelStepsDist * 2 totalSteps) { // 三角形曲线加速不到设定速度 accelStepsDist totalSteps / 2; } // 加速段、匀速段、减速段的间隔依次压入环形缓冲 buildAccelTable(0, accelStepsDist, accelSteps); buildCruiseTable(accelStepsDist, totalSteps - accelStepsDist * 2, vMaxSteps); buildDecelTable(totalSteps - accelStepsDist, totalSteps, accelSteps); }这里有个实践中的小优化间隔表不用存每一步而是存每 N 步的间隔中断里做线性插值。N 取 8 到 16内存省了十几倍速度曲线的误差小到测不出来。5. 联调现场那些文档里不会写的问题软件跑通不代表机器能干活。真正的功夫在联调而联调阶段遇到的问题九成在教科书和芯片手册里都找不到。这一章我把踩过的坑按症状归类附上排查路径你可以当成一份速查手册用。5.1 丢步的四种典型症状丢步是步进系统最常见的病但病因有好几种得靠症状区分。第一种加速瞬间丢步。现象是每次启动都少走一点匀速段正常。这是扭矩不够要么电流设低了要么加速度设大了要么电源功率不足。排查顺序先把加速度砍一半试好了就是加速度问题没好就量母线电压加速瞬间掉超过 10% 就是电源问题都正常就往上调电流。第二种高速段丢步。低速正常速度一提就丢。这是电机的高频扭矩衰减步进电机的扭矩随转速上升而下降超过某个转速就带不动了。解法是提高母线电压、降低细分细分越高高速扭矩越差、或者减小负载。第三种随机丢步毫无规律。这种最烦八成是干扰。检查电机线是否和信号线捆在一起、地线是否共地良好、驱动器是否和主控共用一条细地线。我遇到过一次原因是电机线和限位开关线绑在一起限位触发瞬间的干扰窜进脉冲线换线序就好了。第四种反向时丢步。正向准反向差一截。这不是丢步是回差看下一节。5.2 抖动、异响与共振区步进电机在某个特定速度区间会进入共振表现为声音突然变大、滑台明显抖动、甚至丢步。这个区间通常在 100-300 转/分之间换算成丝杆大概就是 3-10mm/s恰好是摄影滑轨最常用的速度段非常要命。三个办法对付它。一是避开把常用速度设在共振区之外但摄影场景需要慢速避不开。二是加细分细分越高单步的力矩冲击越小共振越不明显1/16 以上改善很明显。三是加阻尼机械上可以在电机轴上加一个惯性轮或者用带阻尼的联轴器电学上可以用驱动器的静音模式内部的电流斩波算法会抑制共振。我最后是 1/32 细分加静音驱动慢速段基本听不到声音。还有一种异响来自机械同步带张紧不够会在启动时啪一下丝杆润滑不足会有连续的沙沙声。这些问题不难判断断电用手推滑台感觉一下有没有卡顿、有没有旷量比通电听声更直接。5.3 回差与重复定位精度回差是机械传动的固有属性丝杆螺母有间隙同步带有弹性反向运动时有一段走了但没带动的空行程。丝杆的回差通常在 0.05-0.2mm同步带能到 0.3mm 以上对微距堆栈这种要求 0.01mm 的场景是致命的。补偿的办法是单向逼近不管目标位置在哪个方向永远从同一个方向靠近它。比如目标在 X50当前在 X60不要直接反向走 10mm而是先反向走到 X49再正向走 1mm 到 X50。这样每次逼近的方向一致回差被吃在同一边重复定位精度立刻就上来了。代价是多走一段距离但对精度要求高的场景完全值得。标定回差的方法指令从 0 走到 50mm记录实际位置再从 50 走回 0记录实际位置两者之差就是回差。往返测三次取平均写进固件作为补偿量。如果回差随位置变化丝杆不同段的磨损不同就分几段分别标定用查找表补偿。5.4 常见问题速查表联调时我基本靠这张表定位问题现象最可能原因快速验证方法处理电机通电但不锁死使能极性反了 / 电流太低手动转轴有阻力说明已使能改使能配置或调电流上电就朝一个方向猛冲限位接错 / 回零方向配反手动触发限位看串口状态改方向或换常闭接法走 100mm 只走了 98mm步距系数没标定卡尺实测后反算比例写回标定系数慢速时抖动明显进入共振区换个速度试提细分、开静音模式反向定位不准机械回差往返测同一位置单向逼近 补偿偶尔随机丢步电源或干扰加速瞬间量母线电压换电源、改走线网页一刷新就顿通信和脉冲同核竞争观察是否只在通信时发生双核拆分任务回零位置每次不同单次快速逼近对比多次回零坐标加二次慢速逼近这张表不是穷举但覆盖了我遇到的八成问题。真遇到表里没有的我的排查顺序永远是先断开负载空转确认是电气问题还是机械问题再单轴运行排除双轴插补的干扰最后才怀疑固件。这个顺序能省掉大量瞎猜的时间。6. 最后分享几点实际调试的体会这套系统我从第一版焊洞洞板到现在前后改了七八版。最大的感受是低成本的瓶颈从来不在主控而在机械和电源。一块 ESP32 能做的事远超大多数人的想象真正拖后腿的是丝杆的导程误差、同步带的弹性、电源的瞬态响应。我个人的习惯是每改一版都留一份参数快照把步距系数、回差补偿、加速度、电流设置这些东西记下来。不同负载下这些参数是要变的换个滑台、加个相机加速度就得往下调。有记录才能快速回滚不然调着调着就不知道哪一版是好的了。还有个小技巧值得一试把限位开关的状态和当前位置实时显示在上位机网页上做成一个简单的可视化面板。调试的时候肉眼盯着数字变化比看串口滚屏高效得多尤其是排查回零异常的时候你能直接看到触发瞬间的坐标跳变。