干调试这行时间长了，都会有一个感觉：KUKA机器人本身很皮实，真正让你加班到半夜的，往往是示教器上那些重复又琐碎的操作。工艺参数调来调去，菜单一层一层翻，明明一个电位、一个信号就能解决的事，非要来回按七八下。今天说的这个“白键”，就是KUKA示教器上那排容易被当成摆设的用户自定义键。把它用起来之后，我现场调机的效率提升不是一点点，很多复杂工艺流程可以做到一键触发，连刚入行的同事都能直接上手操作。
这篇内容我想了很久，决定不写成干巴巴的说明书，而是把我实际配置白键、写KRL轮询程序、踩过的坑、绕过的弯全部整理出来。如果你是做KUKA机器人集成、调试或者产线维护的，手里正好有一台KRC4或KRC5系统，那这篇文章能帮你把那排白键真正变成自己的快捷指令面板，省掉大量重复操作。纯新手也不用担心，每一步我都会解释为什么要这样做，而不是只给一个结果。
1. 白键到底是什么：先从示教器面板认识它
1.1 白键的物理身份
KUKA的smartPAD示教器，正面最大的当然是那个3D鼠标和急停按钮，但很多人忽略了显示器两侧和面板上方的那几排物理按键。我说的“白键”，就是其中一部分标着空白或者只有小图标的用户自定义按键。
不同的控制柜型号，比如KRC4和KRC5，白键的数量和位置会有一点差异。KRC4时代，smartPAD左右两侧各有一组按键区域，其中大部分是系统保留键，剩下几个就是用户可以自定义的按键。有些设备上，按键面板还带一层透明标识条，可以插纸片写上功能名，方便识别。KRC5的smartPAD外形变了，但用户键的思路是一样的，只是配置入口有些区别。
很多现场工程师以为这些白键是死键，按了没反应，其实不是。它们默认处于空置状态，需要你去“告诉”机器人这枚键代表什么功能。系统层面可以做按键重定义，程序层面也能实时读取按键状态，两种做法可以配合使用，也可以独立工作。
1.2 白键和绿色确认键、急停的区别
要想把白键用好，先要分清它和“安全相关按键”的本质区别。急停按钮、模式开关、确认按键（就是常见的三段式使能开关）这些都是安全链路的组成部分，它们的信号是直接接入控制柜安全回路的，优先级最高，不能用程序随便改写，也不建议做任何自定义映射。
白键完全不一样。它走的是逻辑信号通道，本质上就是一个给程序看的输入信号。只要你按下白键，操作系统会把按键状态更新到系统变量里，KRL程序可以读取这个变化，然后去调用对应的工艺子程序。
换句话说，白键不参与安全回路，它只参与“逻辑请求”。你完全可以把它想象成贴在手机上方的那个“快捷指令”按钮，按一下，发一条指令给某个App去干活。
1.3 一个常见的误区
很多人觉得用户键要专门接IO模块才有信号，不接就没法用，其实不是。白键的状态是控制系统内部变量，不需要额外硬件接线。它和机器人抓手上有没有装传感器、PLC那边有没有配置Profinet通信，完全没关系。就算你的机器人处于“手动慢速”模式下、没有任何外部设备连接，只要程序在跑，白键就能触发逻辑。
明白了这一点，后面所有的配置和开发工作才有基础。简单说，白键是一个免费又好用的“本地快捷开关”，千万别浪费。
2. 把工艺挂到白键上，到底解决了什么问题
2.1 最典型的现场痛点
我接过不少改造项目，现场最常见的场景是这样的：产线在换型，夹具动作、焊接参数、检测流程都要跟着切换，工艺员或调试员站在示教器前面，一遍一遍进到不同的菜单页面里修改参数、启动程序、确认信号。
这个过程至少有四个痛点：
- 菜单层级深，从主界面到工装配置往往要四五步。
- 操作重复性高，每次换型都是同一套动作。
- 操作员容易误触，在多个页面之间来回切，一旦点错位置，可能把参数改乱。
- 对新人极不友好，老师傅不在场，别人不敢碰。
白键一键触发的好处就在这：它把“多层级操作”压缩成“一次按键”。把配置好的工艺流程关联到某一颗白键上，操作工只需要按一下，剩下的工艺步骤由KRL程序按顺序完成。
2.2 设计思路：按“一个键等于一个完整动作”来规划
白键不是用来做细碎操作的，你要把它设计成一个抽象层。什么意思？就是每个键代表一层完整的业务逻辑，而不是一个底层指令。
举个例子：
- 白键1：切换到“产品A生产模式”（包含定位、夹紧、焊接参数切换、检测流程）。
- 白键2：启动“产品B生产模式”。
- 白键3：呼叫复位并清理报警。
- 白键4：暂停当前工艺流程。
这种“一键一流程”的设计，比“一键一步”要科学。因为人的记忆容量有限，示教器本来就小，如果每个键只做一步操作，操作工根本记不住，还要低头看标签，反而是负担。
2.3 三种实现方案的对比
我实际用过的方法有三种，各有各的适用场景。先用一张表把区别讲明白，后面再逐个展开：
| 方案 | 实现方式 | 门槛 | 灵活性 | 适合场景 |
|---|---|---|---|---|
| 系统按键配置 | 示教器菜单里直接分配功能 | 极低 | 低 | 简单动作关联，比如切换程序、调用固定子程序 |
| KRL轮询检测 | 主程序或后台程序读取按键状态并调用逻辑 | 中等 | 高 | 需要多条件判断、多步骤联动、带状态机的工艺 |
| 提交解释器监听 | 在SPS提交解释器里后台轮询，与主程序并行运行 | 较高 | 非常高 | 需要随时响应、不影响当前主程序流程的场景 |
如果你是第一次接触白键，我建议先走后两种方案，因为系统按键配置受限于厂商预设的选项，自由度不高。而写KRL程序虽然要多敲几行代码，但你能完全控制按键按下之后发生什么。
3. 实操：白键一键触发复杂工艺的三套方案
3.1 方案一：系统层直接分配用户键
如果你不想写代码，只想把某个子程序挂到一个白键上，KUKA的系统菜单里其实有对应的入口。
操作流程大致是这样的：
- 将示教器上的钥匙开关拨到“专家”或“管理员”模式。
- 在主菜单中选择“投入运行”或者“显示”菜单里的“按键分配”相关页面。
- 找到用户键列表，选中你要配置的那一颗白键。
- 在功能列表里选择要触发的动作，或者指定要调用的程序文件。
- 保存配置后，退出菜单，按下白键看效果。
系统按键配置的局限在于，它只能触发“系统已经定义好的动作”，比如切换运行模式、打开某个界面等。想要触发自己写的复杂KRL子程序，不同系统版本能力不同，有些版本支持回调程序，有些版本需要借助其他方法。
我这里必须提醒一句：系统配置方案的每一步菜单名称，在KRC4和KRC5上可能都有差异。比如KRC4 8.3.x和KRC5 2.x的菜单布局就不同。如果你进入系统菜单后找不到对应页面，直接在帮助文档里搜索“User Key”或“按键分配”关键词，基本都能找到入口。
3.2 方案二：KRL程序读取按键状态
这是我最常用的方法，也是把白键玩出花样的基础。思路很简单：KRL程序循环检测系统变量 $KEY[i]，某个变量为TRUE，就代表对应的白键被按下，程序就跳转到对应的工艺子程序去执行。
先看一个基础版的关键代码：
DEF KEY_MONITOR() ; 主程序循环检测 LOOP IF $KEY[1] THEN CALL PART_A_PROCESS() ; 白键1触发产品A工艺 ENDIF IF $KEY[2] THEN CALL PART_B_PROCESS() ; 白键2触发产品B工艺 ENDIF IF $KEY[3] THEN CALL RESET_ALARM() ; 白键3做报警复位 ENDIF WAIT SEC 0.05 ; 轮询间隔50ms，避免占用CPU ENDLOOP END这段程序结构很清晰，就是一个死循环加条件判断。但有几个细节你必须注意，不然容易翻车。
第一个是轮询周期。我用的是50毫秒，也就是说程序每50毫秒检查一次按键状态。这个频率对人手按键来说完全够用了，人再快也不可能在20毫秒内完成“按下-松开”的动作。如果你写得太快，比如WAIT SEC 0.001，会让逻辑系统CPU负载升高，严重时甚至会影响其它后台任务。如果写得太大，比如200毫秒，按键响应会有明显延迟感。
第二个细节是按键抖动。工业按键虽然比普通键盘耐造，但物理触点按下和松开的瞬间，信号在几毫秒内可能会有多次跳动。如果你的工艺动作要求严格的单次触发，比如按一下只执行一次程序，我建议在程序里加一个“松开才允许再次触发”的互锁机制。
改进版代码：
DEF KEY_MONITOR() ; 互锁变量，TRUE表示按键已被处理，需要松开后才能处理下一次 DECL BOOL KEY1_LOCKED DECL BOOL KEY2_LOCKED DECL BOOL KEY3_LOCKED KEY1_LOCKED = FALSE KEY2_LOCKED = FALSE KEY3_LOCKED = FALSE LOOP ; 白键1：按下且未处于锁定状态 IF $KEY[1] AND NOT KEY1_LOCKED THEN KEY1_LOCKED = TRUE ; 先锁定 CALL PART_A_PROCESS() ; 再执行工艺 ENDIF ; 白键1松开时解锁 IF NOT $KEY[1] THEN KEY1_LOCKED = FALSE ENDIF ; 白键2、3的逻辑类似，这里省略 WAIT SEC 0.05 ENDLOOP END这种“先锁定，执行完再等待松开解锁”的方式，能避免长按或抖动导致的多次触发。在现场调试时，这个细节能帮你省很多麻烦。
3.3 方案三：提交解释器里做后台监听
方案二的思路虽然好用，但有个前提：主程序必须在运行这个KEY_MONITOR程序，也就是说你不能同时运行其他主程序。如果产线的主程序本身是一个长时间的焊接循环，你又想让白键随时可以触发辅助功能，比如暂停、继续、呼叫服务，怎么办？
这时候要用到KUKA的提交解释器（SPS）。
提交解释器可以理解成一个后台进程，它和主程序并行执行。主程序负责走轨迹，提交解释器负责监控信号、按键、报警这些逻辑。KRC系统的编程语言里，提交解释器上跑的程序通常叫SPS程序，后缀依然是 .src，只是在系统配置里被声明为提交解释器程序。
一个典型的写法是这样的：
DEF SPS_MONITOR() LOOP ; 自动模式且程序运行中 IF $MODE_OP == #AUT AND $PRO_STATE1 == #P_ACTIVE THEN IF $KEY[4] THEN ; 触发暂停请求，给主程序一个标志位 FLAG_PAUSE_REQUEST = TRUE ENDIF IF $KEY[5] THEN FLAG_CONTINUE_REQUEST = TRUE ENDIF ENDIF WAIT SEC 0.05 ENDLOOP END主程序里只需要定期检查这些标志位：
DEF MAIN_WELD_PROCESS() ; 焊接主流程 PTP HOME_VEC ; 主循环开始 LOOP ; 如果收到暂停请求，就进入暂停分支 IF FLAG_PAUSE_REQUEST THEN ; 在这里实现暂停保持 WAIT FOR NOT FLAG_CONTINUE_REQUEST FLAG_CONTINUE_REQUEST = FALSE ENDIF ; 正常焊接流程 CALL WELD_SEGMENT_1() CALL WELD_SEGMENT_2() ENDLOOP END这种感觉就像主线程和后台线程协作，一个管工艺，一个管人机交互。白键按下去以后，后台立刻改变标志位，主程序经过一个循环周期后响应，互不干扰。
实际应用时要注意，提交解释器程序的优先级比主程序低一些，不要在里面放太重的逻辑，比如大量的数学计算或者长时间延时。它最擅长的是“看着状态，改标志位”，像这种工作干得又快又稳。
3.4 一个完整示例：一键完成“夹紧-焊接-检测-松开”流程
前面把三种方案的基础逻辑都讲了一遍，现在用一个实际案例串起来。假设你有一条小型的自动焊接工位，工艺流程是：
- 白键1按下，机器人执行“工件就位”确认。
- 如果检测到工件到位，执行夹具夹紧。
- 然后机器人走焊接轨迹。
- 焊接完成后做一个视觉或IO检测。
- 检测通过，夹具松开并回原点。
如果用系统按键配置，你几乎做不了这种多步骤关联，因为中间要判断信号，要等待夹具实际到位。所以正确做法是把它编写成一个主工艺程序，用白键触发：
DEF START_FULL_PROCESS() ; 焊前检查：确认工件到位信号 IF NOT $IN[1] THEN MsgNotify("工件未就位，流程终止", 0) RETURN ENDIF ; 第一步：夹紧并等待确认 $OUT[1] = TRUE ; 夹紧请求 WAIT FOR $IN[2] ; 等待夹具到位反馈 ; 第二步：焊接 CALL WELD_START() PTP HOME_VEC LIN P1_VEC LIN P2_VEC CALL WELD_END() ; 第三步：检测 CALL CHECK_WELD_QUALITY() ; 第四步：松开夹具 $OUT[1] = FALSE ; 松夹请求 WAIT FOR NOT $IN[2] ; 等待松开反馈 PTP HOME_VEC END然后回到前面那个KEY_MONITOR程序，把白键1的调用改成CALL START_FULL_PROCESS()，这样一个复杂工艺就被白键“接管”了。操作工不需要懂KRL编程，按一个键，整套流程自动跑完。如果中途有什么问题，程序会通过消息窗口提示，或者走到急停逻辑。
这种做法最大的价值，是把“人的经验”固化成了“机器的流程”。老师傅不需要天天站在旁边盯着，新同事按一下键也不会把参数改乱。
4. 常见问题与排查技巧实录
4.1 按下白键程序没反应
这应该是问得最多的问题。现场调试时，明明程序看着没有问题，但按白键就是没反应。我梳理一下排查顺序，按这个顺序检查基本能定位。
先确认系统层面是否拦截了这个按键。很多机型出厂时，用户键默认被系统“屏蔽”，不会产生程序可读的状态变化。这时候你先切到“专家模式”，在按键分配界面随便改一下某个用户键的动作，再改回来，强制系统刷新一次按键配置，很多时候问题就消失了。
再检查程序运行状态。白键检测程序如果跑在主程序里，而主程序又停在一个等待指令上，比如WAIT FOR 某个条件一直没满足，那LOOP循环根本没执行到按键检测那一步。这种情况要排查主程序卡在哪一行，而不是怀疑白键坏了。
然后确定模式开关。有些程序只在自动模式下才允许按键响应，手动模式下按白键没有任何输出。这是正常的，说明你的程序逻辑是安全优先的，不是bug。
4.2 $KEY[i] 读取不到按键状态
如果你确认程序在跑、键也分配好了，但 $KEY[1] 永远不变化，可能的坑有两个。
一个是变量编号不对。KUKA不同版本对用户键的编号方式有差异，有些版本用户键从1开始，有些版本系统键占用了一部分编号。我建议先写一段遍历程序，把前10个按键状态循环打印出来，按哪个键亮哪个数，一次就能确认对应关系。
DEF KEY_SCAN() DECL INT I LOOP FOR I = 1 TO 10 IF $KEY[I] THEN ; 把I显示出来，就是当前按下的按键编号 MsgNotify("KEY " + REAL_TO_STR(I), 0) ENDIF ENDFOR WAIT SEC 0.1 ENDLOOP END另一个坑是变量刷新周期。提交解释器里的变量刷新不是实时的，如果你的SPS程序循环周期太快或者太慢，都可能看不到状态变化。把WAIT SEC的值调到50毫秒到100毫秒之间，基本就能稳定读到。
4.3 白键误触问题怎么处理
白键毕竟物理可见、伸手就能按到，现场确实会有误触。我踩过最惨的一次是在调试机器人时，手肘不小心压到白键，直接触发了回原点的动作，好在当时速度很低，没出大事故，但吓出一身冷汗。
从那以后，我给自己定了几条规则：
- 逻辑互锁：白键只有在特定模式、特定状态下才会触发动作。比如自动模式下才响应，手动模式直接忽略。
- 图像反馈：按下白键后，程序必须在示教器上给出明确提示，比如弹出消息或改变屏幕颜色，让操作者知道“这个键已经开始执行了”。
- 风险动作分离：涉及高速运动、大范围移动的动作，不建议直接挂白键，至少要在白键触发后加一个“再按一次确认”或者延时等待的逻辑。
写程序时，互锁逻辑并不复杂，但能大幅降低风险。
4.4 与零点校正、通信配置有关联的坑
很多工艺跑着跑着位置偏了，第一反应是改程序里的坐标，其实要查的是机器人零点。零点漂移之后，再好的快速指令也白搭，因为机器人每一个目标点都是基于零点计算的。我建议每次做完零点校正后用白键触发一个固定轨迹验证程序，看轨迹是否与校正前一致，这样能很直观地发现问题。
和外部设备联动时，通信配置也是重灾区。白键触发了一个流程，流程里要给PLC发信号，如果WorkVisual里的Profinet设备映射没配好，或者GSD文件的IO地址对不上，信号就会石沉大海。查这个问题的速度直接取决于你对WorkVisual软件熟练程度，很多人卡在“PLC收不到机器人信号”上，最后发现是模块槽号偏移了一位。
这方面有两个实用经验：第一，Profinet通信配置完成后，先用手动模式单独输出一个测试信号，让PLC那边看有没有实时变化；第二，写白键程序前先把所有需要的输入输出信号名定义清楚，否则程序写到一半还要回去翻IO表，效率极低。
5. 进阶玩法：白键与其他功能联动
5.1 一个键按出多个层级：多级菜单思路
白键数量有限，而工艺步骤可能很多，这时候可以用多级菜单来扩展按键功能。核心思路是定义一个“当前页面”变量，白键在不同页面下代表不同功能。
比如把页面变量命名为 PAGE_MODE：
- PAGE_MODE = 1 时，白键1~4分别代表产品A切换、产品B切换、暂停、复位。
- PAGE_MODE = 2 时，白键1~4分别代表呼叫料车、呼叫AGV、启动检测、停止检测。
切换页面的动作也可以放白键上，比如白键8双击、长按，或者配合一个系统变量切换页面。长按和短按的判断可以用计时实现，记录按键按下的时间，超过500毫秒认为是长按。
这种设计做出来后，示教器就不再是一块需要频繁点击的屏幕，而是变成了一个可以盲操作的键盘。操作工戴着手套、眼睛盯着工件的时候，凭肌肉记忆就能完成工艺切换。
5.2 和外部IO、PLC、视觉系统的联动
白键不只可以控制机器人内部逻辑，还可以通过IO信号影响整个产线。比如按键触发后，程序先给PLC发一个“请求进料”的信号，等PLC返回“料已到位”，再开始抓取。这种联动的核心是把白键当成整个产线流程的人机交互入口，而不只是机器人单机的按钮。
一个比较完整的动作流程可以设计成：
- 白键按下 → 机器人侧发出“请求上料”。
- PLC收到信号 → 控制传送带上料。
- 传感器检测到工件到位 → 反馈给机器人。
- 机器人执行抓取 → 进入焊接流程。
- 流程结束 → 机器人发出“完工”信号给PLC。
这种多层联动，需要在WorkVisual里把Profinet信号的映射关系仔细检查一遍，建议把IO表打出来贴在控制柜里面。因为时间一长，你真的会忘记哪个字节对应哪个信号。
5.3 哪些工艺适合挂到白键上，哪些不适合
用得多了，我慢慢总结出一个判断标准：凡是“高频、固定、不需要临场判断”的动作，都适合挂白键；凡是“需要临场判断、路径多变、涉及安全风险”的动作，不适合。
适合的包括：
- 生产模式切换。
- 固定焊接或搬运流程启动。
- 复位和报警处理。
- 视觉拍照和结果读取。
- 夹具的固定开合动作。
不适合的包括：
- 手动示教时的点动移动。
- 意外情况处理。
- 对精度和姿态有严格要求的特殊工艺步骤。
- 任何需要在运动中改变速度、轨迹的动作。
因为白键的本质是“把程序定义好的流程调出来”，它本身不具备决策能力。让它去干需要临场发挥的活，等于让一个只会执行固定脚本的人去做自由发挥，肯定会出事。
5.4 现场维护角度：做好白键的文档化和恢复方案
白键自定义这个事情，方便是真方便，但也是个“隐形配置”。一旦控制柜出问题，比如系统重新安装、CF卡更换、程序重新导入，白键配置没有备份的话，所有快捷功能都要重新搭一遍。
我给客户的交付资料里，一定包含一页“白键功能定义表”，表格里写明每个键位、对应程序名、触发条件、操作说明。同时，程序文件夹里专门挂一个说明文件，把按键检测、互锁逻辑、变量列表都写清楚。这样即使模块维护人员换了一拨人，后面的人接手时也不至于两眼一抹黑。
还有一个建议：把白键检测程序做成独立的子程序，不嵌在某个主程序文件里。这样主程序升级时，白键逻辑不会被动到，维护起来也清晰很多。
个人实际用下来的体会是，白键真正带来的改变不是“少按几下按钮”，而是改变了整个现场的交互方式。它让机器人从“需要工程师低头盯屏幕操作”变成“操作员抬手就能启动一个完整工艺”，这中间的效率提升和安全改善，只有真正在产线上待过的人才能体会。
如果你手里正好有一台KUKA，我建议从最小的功能开始试，比如先让白键触发一条消息提示，成功之后再慢慢往里加逻辑。熟悉之后再逐步扩展，你会觉得这排小按键越用越顺手。
