企业官网建设流程全解析

产线上跑了三四年的 KUKA，最怕的不是节拍不够，是半夜跳闸之后第二天一早来开机——机器人姿态停在某个说不清的位置，工件还夹在夹具里，操作工一按启动，机械臂直接往 HOME 点窜过去，轻则撞夹具，重则撞刀库。这套"KUKA 机器人自动回原点程序"就是冲着这个场景来的。它不复杂，但非常吃细节：什么时候允许回、按什么路径回、用多快的速度回、中途被人拔了使能开关怎么办、回了之后怎么告诉 PLC 一声——每一环都得想清楚，否则程序能在示教器上跑通，到了现场就是事故。

我自己做过的项目里，回原点代码通常不超过两百行，但调试时间往往占整个联调周期的三成。原因很简单：单机空跑时谁都不会出错，一旦叠上夹具、变位机、安全门、上下游信号，边界条件就多起来了。这篇内容主要写给两类人：一类是刚接手 KUKA 项目、需要在 KRL 里写第一支自动回原点程序的现场工程师；另一类是负责联调、需要和电气、PLC 打交道但不想再被"机器人自己乱动"坑一次的调试人员。哪怕你完全没写过 KRL，只要会看点类似 C 的逻辑，也能照着复现。

1. 先把概念掰开：KUKA 里的"原点"到底是什么

1.1 HOME 点、机械零点、工件原点三者别混

新手最容易踩的第一个坑，就是把三个"原点"当成一个东西。它们在控制器里是完全独立的三套数据，牵一发动全身。

**机械零点（Mastering Position）**是物理层面的基准。每一根轴在出厂或者维修后都要做一次零点标定，标定完成之后编码器计数值才和真实机械角度对应起来。这个值是刻在控制器里的绝对基准，标定丢了，机器人所有位置数据全废——它连自己胳膊伸到哪儿都不知道了，这时候任何运动指令都是危险的。判断依据也很直白：开机报编码器电池相关的报警，或者提示需要重新标定，那就别急着按启动，先解决零点问题。

HOME 点是逻辑层面的"待机位"。KUKA 系统用$H_POS这个变量保存它，默认值通常是 A1=0、A2=-90、A3=90、A4=0、A5=0、A6=0，六个轴单位都是度。这个姿态看起来像机械臂收拢立起来，占地小、干涉少，是多数产线的默认待机姿势。但它完全可以改，比如某些机床上下料的应用会把 HOME 改成手臂伸出到上下料位的姿态，方便节拍衔接。

**工件原点/基坐标（BASE）**是作业层面的参考系。它决定你在程序里写的 XYZ 到底以谁为零点，和回不回原点没有直接关系，但会影响你用 LIN 指令规划的过渡路径。

把这三者分清楚之后你会发现，所谓"自动回原点"，95% 的情况指的是回到 HOME 点，剩下 5% 是回到某个自定义的待机位。而机械零点是底线，不是目标——你不需要"回"到机械零点，你需要的是确保它没丢。

1.2 一句 PTP HOME 为什么在产线上不够用

示教器上随手写一行PTP HOME Vel=100 % DEFAULT，这确实能回原点，在空载、无干涉、机器人姿态可控的条件下也没问题。但它有三个致命短板。

第一个短板是没有前置条件判断。机器人当前可能正插在工件里，你一启动它直接往外拔，如果工件是卡在夹具里的，那这一下就是硬拽。真实场景里回原点前至少要确认：夹爪是松开状态、工件已取走、变位机回到安全位、安全门是关的。

第二个短板是路径不可控。PTP 是关节空间插值，控制器只看各轴从起点到终点的角度变化，中间会走出什么轨迹它不关心。从某些姿态直接 PTP 回 HOME，手臂可能会划出一道穿过夹具上方的弧线，示教的时候看着没事，换个工件尺寸就撞了。

第三个短板是没有反馈。程序跑完了，机器人是到位了还是卡在半路被中断了，PLC 完全不知道。无人化产线里这个信息是刚需，缺了它，下游设备不敢动，节拍就卡住了。

所以一支能上产线的回原点程序，本质上是三件事的叠加：条件自检、可控路径、状态反馈。后面几节都围绕这三点展开。

2. 回原点程序的整体设计：从三种方案里挑一个

2.1 方案一：单句 PTP HOME

这是最快能落地的版本，适合单机调试、教学演示，或者周边没有干涉物的简单搬运工位。核心就是一句关节运动指令，外加一个使能信号判断。

DEF HOME_SIMPLE( ) INI ; 确认没有急停和报警 IF $ALARM_STOP == TRUE THEN RETURN ENDIF ; 原地完成 BCO，避免开机瞬间窜出去 PTP $AXIS_ACT ; 回到 HOME PTP HOME Vel=50 % DEFAULT ; 到位后置位完成信号 $OUT[10] = TRUE END

代码短归短，但里面藏着两个关键点。第一行PTP $AXIS_ACT是"原地不动"的技巧，机器人会以当前姿态执行一次运动指令，目的只是完成 BCO 同步（3.4 节细说）。第二行速度给 50% 而不是 100%，是给自己留反应时间——真出问题时，50% 速度下按急停，滑行距离明显短。

注意：这支程序绝对不能直接用在有夹具、有变位机、有上下游联动的工位上。它的价值在于验证基础逻辑通路，而不是当生产程序用。

2.2 方案二：带位置判断的分段回原点

这是产线上最常用的骨架。核心思路是：先读当前姿态，判断机器人"离原点有多远"，再决定走几步回去。

具体做法是设一个中间过渡点，比如 A2 处于 -60° 左右、手臂半抬起的姿态。机器人先关节运动到这个过渡点，再从过渡点回 HOME。为什么加这一步？因为过渡点的选择可以刻意避开夹具区和腕部奇异区，让两段路径都在可控范围内。

判断逻辑也很重要。如果机器人当前已经非常接近 HOME（比如各轴偏差都在 5° 以内），那直接走回 HOME 就行，没必要绕过渡点，能省一两秒节拍。反之如果偏差很大，比如 A2 差了 80°，那就必须走过渡点，而且速度要压低。

DEF HOME_STAGED( ) INI DECL REAL D_A2 D_A2 = ABS($AXIS_ACT.A2 - XP_HOME.A2) ; 原地 BCO PTP $AXIS_ACT IF D_A2 < 15.0 THEN ; 姿态接近，直接回 PTP XP_HOME Vel=60 % PDAT1 Tool[0] Base[0] ELSE ; 姿态偏差大，走中间过渡点 PTP XP_MID Vel=30 % PDAT1 Tool[0] Base[0] PTP XP_HOME Vel=60 % PDAT1 Tool[0] Base[0] ENDIF $OUT[10] = TRUE END

这里的XP_HOME和XP_MID是两个 AXIS 类型的变量，定义在配套的 DAT 文件里。把目标点抽出来放到 DAT 里而不是写死在 SRC 里，好处是后期调点位不用改主逻辑，直接在示教器上重新示教变量就行，也方便不同机型共用同一套程序。

2.3 方案三：PLC 触发的自动回原点

无人化产线上跑的基本都是这一版。程序不再由操作工按启动键触发，而是等 PLC 的一个信号。整个交互流程大致是这样：

• PLC 置位$IN[1]表示"请求回原点"
• 机器人确认安全条件（无报警、无急停、驱动已使能、$OV_PRO 大于零）
• 机器人执行回原点动作
• 到位后置位$OUT[10]表示"回原点完成"
• 若中途失败或被中断，置位$OUT[11]表示"回原点失败"

这套握手信号看着简单，但现场 90% 的联调扯皮都出在这里。比如 PLC 侧要求"完成信号保持到下一个循环开始"，而机器人侧习惯"到位脉冲 200ms"，两边对不上，下游设备就一顿一顿的。所以信号定义一定要在联调前白纸黑字写清楚，包括电平保持时间、失败后是否自动重试、重试次数上限。

这类工位如果还接了上层调度系统，比如用 VDA5050 协议对接的混合产线，那回原点完成信号往往还要往上报一层。这时候信号命名和语义定义更要规范，别用 "Done1"、"OK2" 这种代号，直接写ROBOT_HOMED、ROBOT_HOME_FAIL，半年后维护的人会感谢你。

3. 核心细节拆解：变量、指令与速度设置

3.1 $AXIS_ACT、$POS_ACT、$H_POS 的用法与区别

这三个变量是回原点程序的骨架，用错了会直接导致判断逻辑失效。

$AXIS_ACT是当前各轴角度，一个 6 元素的轴位置结构，单位度。它能读到 A1 到 A6 的真实角度，也包含外部轴。写判断逻辑基本都用它，因为角度值直观、不受工具和基坐标影响，比较起来最稳。

$POS_ACT是当前笛卡尔位置，单位毫米和度，格式是 XYZ 加 ABC。它依赖当前激活的工具和基坐标，同一台机器人切换不同 TOOL 数据，读出来的值完全不一样。用它做判断要格外小心，除非你确实需要笛卡尔层面的判断。

$H_POS是系统里定义的 HOME 位置，也是轴角度格式。你可以直接读它来和$AXIS_ACT比较，也可以改它。改它等于改了整台机器人所有PTP HOME指令的目标点，影响面很大，建议改之前先备份。

实际写判断的时候，我一般不会直接调$H_POS，而是把自己示教的XP_HOME作为基准。原因很实际：产线上调点位是常态，如果判断基准用系统变量，改点位就得进到系统配置里去，步骤多、风险高；用自己的 DAT 变量，示教器上三次按键就改完了。

; 计算六个轴相对 HOME 的最大偏差 DEFFCT REAL MAX_DEV( ) DECL REAL D1, D2, D3, D4, D5, D6, DMAX D1 = ABS($AXIS_ACT.A1 - XP_HOME.A1) D2 = ABS($AXIS_ACT.A2 - XP_HOME.A2) D3 = ABS($AXIS_ACT.A3 - XP_HOME.A3) D4 = ABS($AXIS_ACT.A4 - XP_HOME.A4) D5 = ABS($AXIS_ACT.A5 - XP_HOME.A5) D6 = ABS($AXIS_ACT.A6 - XP_HOME.A6) DMAX = D1 IF D2 > DMAX THEN DMAX = D2 ENDIF IF D3 > DMAX THEN DMAX = D3 ENDIF IF D4 > DMAX THEN DMAX = D4 ENDIF IF D5 > DMAX THEN DMAX = D5 ENDIF IF D6 > DMAX THEN DMAX = D6 ENDIF RETURN DMAX ENDFCT

提示：不同控制器版本对函数形参的写法要求略有差异，如果编译时报参数相关错误，就把这个函数改成用全局变量传参的子程序，逻辑完全一样，只是调用方式变了。

3.2 PTP 还是 LIN：路径选择与腕部奇异区

回原点用 PTP 还是 LIN，这是个经常被争论的问题，我的答案是：默认用 PTP，但要在关键段用 LIN 补位。

PTP 的优势是快、简单、不会因为笛卡尔层面的不可达而报警。它的劣势是路径不可预测，特别是在大范围轴角变化的时候，中间轨迹可能完全出乎你的意料。

LIN 是直线插值，末端走的是空间直线，路径可预测，但要求整个路径上的每一个点都在可达范围内，而且要注意腕部奇异。所谓奇异就是 A5 轴接近 0° 时，A4 和 A6 的旋转轴几乎共线，控制器算不出唯一解，会出现角度突跳或者报错。KUKA 的默认 HOME 姿态 A5=0°，正好踩在奇异点上——这意味着如果你从 A5=180° 的姿态直接 LIN 回 HOME，最后一段很可能出问题。

实操上的做法是：大范围姿态调整用 PTP，接近目标点前的最后一段如果对路径有要求，再切 LIN。而且在规划路径时，尽量让机器人在经过过渡点时 A5 保持在一个非 0 的角度，比如 30° 或 -30°，避开奇异区。

还有一种情况必须用 LIN：机器人末端在狭小空间里，比如伸进了夹具内部取件。这时候不管回不回原点，都要先用 LIN 沿着退出方向直着退出来，退到安全区后再切 PTP。这个逻辑在回原点程序里同样适用，只是判断条件变成"末端是否在受限区域内"。

3.3 速度和加速度怎么定：从 20% 试到 100%

PTP 指令里的Vel=50 %是各轴最大速度的百分比。这里有个常见误解：很多人以为 50% 就是整体速度减半，实际上 KUKA 是按各轴分别计算，最后取"最慢的那根轴先到"的约束来协调，所以不同姿态下同样的百分比，实际耗时可能差很多。

我的调试习惯是分三轮定速度。第一轮空载、手动慢速，从 20% 开始，观察路径有没有擦碰；第二轮带上实际工具和负载，提到 50%，看有没有异常振动和过冲；第三轮才是生产节拍需要的速度，通常落在 70%~100% 之间，具体看负载和动作幅度，重载高速的情况下减速比要在控制器里配好，否则末端抖动明显。

加速度这块，KUKA 的运动指令通常配一个 DAT 参数集，常见名字就是PDAT1，里面包含加速、减速度和近似（APO）参数。默认参数集在多数工况下够用，但有两个场景要改：一是重载或者长臂机型，默认减速度会让末端有明显甩动；二是高节拍短距离来回运动，需要适当放开近似距离让路径平滑，否则每个点都要停一下，节拍差一大截。

程序倍率$OV_PRO也得提一句。自动模式下这个值是可以从 PLC 侧改写的，做联调的时候经常出现"程序没问题但机器人不动"，最后发现是 PLC 初始化时把倍率写成了 0。回原点程序里加一句判断，倍率为零时直接报失败，能省不少排查时间。

; 倍率为 0 或驱动未使能时不执行动作 IF $OV_PRO < 1 THEN $OUT[11] = TRUE RETURN ENDIF

3.4 BCO 机制：开机第一动为什么必须防

BCO 是 KUKA 程序启动时的一个同步机制。简单说，程序指针所在的位置和机器人实际位置可能不一致——比如程序执行到第 20 行时你按了急停，机器人停在半路，指针却还在第 20 行。再次启动时，控制器不会凭空相信位置数据，它要求先执行一次运动指令来完成"块一致"同步。

问题就在这儿：完成 BCO 的这次运动，机器人的目的地是当前程序指针所在的那个点。如果你直接启动程序，第一行就是PTP HOME，那机器人会从当前位置直接奔向 HOME，速度还不低——这就是新手最常遇到的"一按启动机器人就窜"。

规避方法就是在程序最开头加一句原地运动指令：

; 原地完成 BCO，机器人不动 PTP $AXIS_ACT

因为目标点就是当前位置，机器人实际上不动，但 BCO 完成了。之后所有运动指令都在受控状态下执行，指针和实际位置也就对齐了。

这个技巧还有个小细节：PTP $AXIS_ACT本身也是一次真实运动，正常情况下耗时极短，但在某些版本上会有一个很小的动作。所以第一次上机试验时，还是要把使能开关拿在手里，人在急停按钮旁边。

注意：BCO 相关行为在不同控制器版本和不同启动模式下略有差异，正式投产前务必在空载条件下完整走一遍上电启动流程，确认第一动符合预期。

4. 完整实操：一个可以直接抄的自动回原点程序

4.1 全局 DAT 文件配置

先把目标点和阈值放到 DAT 里，SRC 只写逻辑。这样后面调点位、换机型都轻松。

DEFDAT HOME_RETURN ; HOME 位置，示教或直接输入角度 DECL AXIS XP_HOME = {A1 0.0, A2 -90.0, A3 90.0, A4 0.0, A5 0.0, A6 0.0} ; 中间过渡点，避开夹具区 DECL AXIS XP_MID = {A1 0.0, A2 -60.0, A3 60.0, A4 0.0, A5 -30.0, A6 0.0} ; 判断阈值，单位度 DECL REAL TOL_NEAR = 15.0 ; 重试次数上限 DECL INT RETRY_MAX = 3 ; 速度设定 DECL INT V_MID = 30 DECL INT V_HOME = 60 ENDDAT

几点说明。XP_MID里我特意把 A5 设成 -30° 而不是 0°，理由是前面说的奇异区规避，同时这个姿态下腕部偏向一侧，回 HOME 的最后一段旋转幅度小。TOL_NEAR取 15° 是个经验值，太小会导致每次都走两段路径、浪费时间，太大则可能让机器人从一个不该直接走的姿态硬回。

4.2 主程序框架与中断处理

主程序负责流程控制，中断负责异常处理，两者分工明确。

DEF HOME_RETURN_MAIN( ) INI DECL INT N DECL REAL DEV ; 清理输出信号 $OUT[10] = FALSE $OUT[11] = FALSE N = 0 LOOP ; 等待 PLC 请求 WAIT FOR $IN[1] == TRUE ; 安全检查 IF $ALARM_STOP == TRUE THEN $OUT[11] = TRUE WAIT FOR $IN[1] == FALSE $OUT[11] = FALSE ELSE IF $OV_PRO < 1 THEN $OUT[11] = TRUE WAIT FOR $IN[1] == FALSE $OUT[11] = FALSE ELSE ; 原地 BCO PTP $AXIS_ACT ; 计算偏差 DEV = MAX_DEV() IF DEV < TOL_NEAR THEN PTP XP_HOME Vel=V_HOME % PDAT1 Tool[0] Base[0] ELSE PTP XP_MID Vel=V_MID % PDAT1 Tool[0] Base[0] PTP XP_HOME Vel=V_HOME % PDAT1 Tool[0] Base[0] ENDIF ; 到位反馈 $OUT[10] = TRUE N = 0 WAIT FOR $IN[1] == FALSE $OUT[10] = FALSE ENDIF ENDIF ENDLOOP END

这段代码里几个细节值得单独拎出来说。

WAIT FOR是阻塞等待，会占用提交解释器。如果这台机器人同时在跑 SPS 里的后台任务，要注意别让回原点逻辑把解释器卡死。更稳的方式是用中断驱动，或者把回原点做成一个被调用的子程序，由上层流程决定什么时候调。

信号的清理顺序很重要。$OUT[10]在动作完成后置位，然后程序会WAIT FOR请求信号撤销——这一步相当于握手确认，确保 PLC 看到了完成信号，避免信号一闪而过被漏掉。很多联调问题就是在这一步上互相等，两边都在等对方先松手。

4.3 回原点前的条件自检

前面那段只查了急停和倍率，真实项目里自检项要多得多。常见的检查清单：

最后一行是底线。零点一旦丢失，任何自动动作都不能执行，哪怕操作工说"先试试看"。这时候正确做法是走手动模式重新标定，标定完再回原点。程序里可以用$ALARM_STOP或者查具体报警位来拦截，具体变量名各版本有差异，用现场实测确认。

把这些检查项做成一个独立的子程序，主程序开头调一次，逻辑会清爽很多，也方便复用。

4.4 与 PLC 的握手信号设计

信号设计这块我踩过坑，说几个血泪教训。

不要在动作过程中反复置位完成信号。有些写法是在循环里每圈都置位，结果 PLC 收到一串脉冲，触发多次下游动作。正确做法是状态变化时置位一次，握手结束后清零。

失败信号要有原因区分。只给一个"失败"位，现场排查全靠猜。至少拆成三到四个：急停类、倍率类、条件不满足类、超时类。用一组 INT 或者几个 BOOL 位编码，PLC 侧做报警文字映射，操作工一眼就知道该干什么。

加超时保护。回原点动作理论上几秒就完成，如果三十秒还没到位，大概率是卡住了或者信号丢了。程序里加一个超时计数，超时后主动报失败并停止等待，别傻等。

信号命名要见名知义。$IN[1]改不了，但可以在注释里写清楚。我习惯在程序头部加一段信号表注释，列出每个用到的输入输出及含义，交接给下一个人时省大量沟通。

; ==== 信号定义 ==== ; $IN[1] : HOME_REQ 回原点请求（来自 PLC） ; $IN[2] : GRIPPER_OPEN 夹爪松开确认 ; $IN[3] : SAFE_DOOR 安全门关闭确认 ; $OUT[10]: HOME_DONE 回原点完成 ; $OUT[11]: HOME_FAIL 回原点失败 ; $OUT[12]: HOME_BUSY 回原点执行中

4.5 上机调试的完整步骤

调这支程序，我一般按下面这个顺序走，每一步都做完了再进下一步。

第一步，离线验证。在仿真环境里把机器人和夹具模型搭起来，重点验证过渡点到 HOME 的路径有没有穿过夹具。仿真里能看到的干涉，现场一样会撞。这一轮不用管信号，先把路径跑顺。

第二步，空载手动验证。把使能开关握在手里，用 T1 模式手动把机器人分别摆到几个典型姿态，比如贴近 HOME、A2 偏差 40°、A2 偏差 80°、末端处于低位，然后逐个执行回原点逻辑，观察路径和速度。T1 模式下倍率压到 10% 甚至更低。

第三步，信号对点。断开机器人输出，只让 PLC 读信号，模拟请求和握手时序，确认信号保持时间、电平定义、失败分支都对得上。这一步纯电气联调，不动机器人，最安全。

第四步，带载低速联调。装上真实工具和工件，倍率设 30%，完整走一遍从请求到完成的流程。重点看带载情况下的过冲和振动，必要时调整减速参数。

第五步，节拍优化。前四步都稳了之后再提速度。我的原则是每次提 10%，跑满二十个循环无异常再继续提，别一次从 30% 提到 100%。

5. 常见问题与排查技巧实录

5.1 常见问题速查表

这张表我建议打印出来贴到控制柜旁边，尤其是前四条，现场遇到的频率最高。

5.2 零点丢失与重新标定

零点丢失的典型信号是开机报警提示编码器电池电压低，或者直接提示需要重新标定。原因通常是电池耗尽，特别是长期断电的设备。这个电池一般是给编码器维持计数的，位置就在机器人本体底座附近（不同机型位置有差异，按对应机型的保养手册找），属于常规易耗件，建议列入年度保养清单。

处理流程上，先换电池，再标定。别反过来——标定完再换电池，如果换的时候又断电，白标一次。标定本身需要专业工装，用千分表配合专用校准销，把每根轴转到机械零点标记对齐，然后在示教器的标定菜单里逐一标定。这个过程对精度要求很高，尤其是长臂机型，末端一米外的偏差会被放大好几倍，没把握就找厂家或者有资质的服务方。

提示：标定前把机器人的程序、配置备份出来。标定过程会改变位置数据，虽然通常不影响程序本身，但备份永远是好习惯。

5.3 轴超程报警的处理

超程分软限位和机械限位两种。软限位是参数里设的角度范围，一般是可恢复的；机械限位是硬挡块，碰到了就麻烦。

软限位超程的处理很简单：切到 T1 模式，按住使能开关，用示教器上的轴运动键把对应的轴往反方向移一点。有些机型会弹一个确认提示，按下去就能动；有些则需要先复位报警。关键在于移的方向要对——如果你不确定超的是上限还是下限，看示教器上显示的当前角度和限位设定值对比一下，一目了然。

处理完之后，回头想想为什么会超程。如果是回原点程序里某个中间点设得太极限，那就把那个点往回收一点；如果是操作工手动误操作，那就把软限位范围收紧一点。

5.4 回原点过程中的安全联锁

再好的程序也不能替代硬件安全回路。自动回原点这类"无人触发"的动作，安全设计上至少要保证三层。

第一层是区域扫描或安全光幕，人进入工作区立即触发停止。这一层是硬件级的，和程序无关。

第二层是安全门联锁，门开则驱动断开。回原点程序里可以读这个信号做逻辑判断，但真正的保护靠回路本身。

第三层是程序内的条件自检，也就是前面 4.3 节那套。它只能拦住逻辑层面的问题，比如倍率为零、夹爪没松，拦不住人。

三层里任何一层缺失，回原点动作都不应该开放自动触发。我见过为了赶节拍把安全门短接的工位，最后出的事都不是程序问题，是人觉得"不会那么巧"。这个钱不能省。

最后分享一个我自己的习惯：这支程序上线之后，我会在 DAT 里留两个变量，一个是DEBUG_MODE，一个是LAST_DEV。前者置位时程序只计算不动作，用来在不停机的情况下验证判断逻辑；后者记录最后一次回原点时的最大轴偏差，累积跑一段时间后把这个值导出来看，能提前发现机械磨损或者参数漂移的苗头——比如某根轴的偏差均值从 3° 涨到 8°，那大概率是该做保养了。这种小手段不解决大问题，但能让你在设备真的趴窝之前就收到信号。