简介FANUC机器人KAREL编程入门学习1是一份面向机器人集成与应用初学者的Word图文笔记系统讲解KAREL语言与TP示教器的区别——KAREL用于增强系统、辅助动作但并不直接控制机器人运动。文档从KAREL程序的基本结构入手说明PROGRAM与END之间的变量声明、关键字限制、命名规则等再结合ROBOGUIDE仿真环境演示添加KAREL软件包、修改KAREL_ENB变量、创建源文件并编译生成.PC文件的完整流程并通过DO[1]信号示例展示手动执行与测试方法。资源为单个DOCX文档约5.63MB适合边看边操作。已有2674人学习对于希望快速入门FANUC KAREL编程的工程师是一份简明实用的起步资料既能理解语言规则也能按步骤完成一次从代码到运行的闭环体验。 每次一提到FANUC机器人的高级编程身边总有工程师问我“KAREL到底值不值得学”我的回答通常很简单如果你只做点位示教和简单搬运TP语言确实够用但凡你碰到数据解析、队列调度、文件读写、上位机交互这些需求KAREL就是绕不开的坎。这篇内容是我的KAREL入门学习笔记第一弹先聊清楚它是什么、程序长什么样、和TP语言怎么配合最后给一个能从示教器直接跑起来的完整例子。FANUC机器人KAREL编程本质上是用一种PASCAL风格的高级语言去写机器人控制器底层能识别的程序。它和TPTeach Pendant程序最大的区别在于KAREL能做复杂逻辑运算、字符串处理、数组操作还能直接读取系统变量和寄存器数据。这篇文章适合三类人现场调试遇到TP写不聊功能的工程师、做自动化集成想扩展机器人功能的朋友、以及准备系统学习FANUC二次开发的初学者。读完你能明白KAREL和TP程序的调用关系掌握程序结构并且拿到一个可以直接上机验证的例程。1. 内容整体设计与思路拆解1.1 为什么FANUC要保留一套“老派”语言很多人第一次打开KAREL编辑器都会被它的界面吓到——没有自动补全、没有彩色高亮、错误提示也是老式的行号定位。这个体验和现代IDE确实没法比但它背后有很实在的理由。KAREL语言从FANUC早期控制器沿用至今核心优势是稳定和直接。它编译后生成的是控制器原生执行的伪代码不依赖解释器运行效率比TP逐行解释要高很多。更重要的是KAREL能访问TP语言碰不到的系统内部数据比如$SBR[n].$PARAM[47]这种系统参数数组、位置寄存器PR[i]的每一个分量、IO状态位、刀具负载数据等。举个例子你想在机器人运行中动态修改速度倍率TP里通常只能手动按示教器上的倍率键。但在KAREL里直接写$GENOVERRIDE : 80就能把全局倍率改成80%而且还能用条件判断决定什么时候改。这类对控制器内部状态的精细控制才是KAREL真正的价值所在。1.2 KAREL与TP程序的分工定位在实际项目中我的习惯是“TP搭骨架KAREL做内脏”。TP程序负责主流程等待启动信号、调用各工位程序、判断完成条件KAREL程序负责需要复杂计算的环节比如读取扫码枪数据并解析ASCII字符串根据数据库或配方文件动态计算目标位置执行文件读写、日志记录、数据上报处理多线程后台逻辑比如监控安全信号的同时执行运动两者之间的桥梁是CALL指令。TP里可以用CALL KAREL_PROG调用KAREL程序KAREL里也可以用CALL TPPROG回调TP程序。这种互相调用的机制非常灵活意味着你不必把所有的KAREL逻辑都写成一个巨大的程序可以拆分成多个模块每个模块只做一件事这样调试起来会轻松非常多。2. 核心细节解析与实操要点2.1 KAREL程序的基本结构从PROGRAM到END写KAREL程序之前先记住它的骨架。一个最简单的KAREL程序长这样PROGRAM TEST_PROG VAR msg : STRING[50] BEGIN msg : HELLO KAREL WRITELN(msg) END TEST_PROG几点关键说明PROGRAM关键字后面接程序名程序名必须和文件名一致否则编译报错。VAR部分声明变量。类型有INTEGER、REAL、STRING[n]、BOOLEAN、ARRAY等STRING必须指定长度。BEGIN ... END之间是程序主体。注意KAREL里赋值是:比较相等是这点和Pascal完全一样。每条语句后面不需要加分号换行就是语句结束符。这个最容易忘写习惯了C语言的人天天手滑加分号然后报错找了半天。也许你会问为什么FANUC不把KAREL做得更现代化一点我的理解是KAREL的定位是“稳定可靠地运行十年”而不是“写起来爽”。既然它语法稳定、兼容性好FANUC自然不愿意大改。我们作为使用者只需要记住它跟主流C系语法的差异就够了。2.2 系统变量KAREL和TP共享的“数据中枢”KAREL最强大的地方就是可以直接操作系统变量。系统变量以$开头比如$TIMER[1]、$POSITION、$MNUTYPE。这里重点提一下$SBR[n].$PARAM[m]这个结构。$SBR[n]是SBR寄存器n是寄存器编号。每个SBR寄存器下面有若干个$PARAM[m]字段可以存整数或布尔值。在TP程序里你会看到R[1]或者SBR[1]这种表示法在KAREL程序里它们的完整表示就是$SBR[1].$PARAM[47]。我在一个上下料项目里遇到过这样一个需求上位机实时下发不同工件的抓取高度机器人要根据高度值动态调整Z轴。当时用的方案就是上位机把高度值写入PLCPLC通过Profinet映射到机器人SBR寄存器的特定参数位KAREL程序循环读取这个参数然后计算目标位置。KAREL里读SBR参数只需要一行height : $SBR[1].$PARAM[47]注意$PARAM的数据类型不是整型就是布尔型读取之后要根据业务需求转换成REAL再参与计算。写的时候也一样$SBR[1].$PARAM[47] : new_height这里有个容易踩的坑某些系统参数在控制器运行过程中会周期性刷新比如当前位置、速度但SBR寄存器不是它只在被写入的时候更新。所以如果你在上位机上改了一个值KAREL程序里却没读到新值先检查一下写入是否真的到了控制器再看程序里有没有别的地方对同一个SBR做了覆盖写。2.3 数据类型与变量声明的“坑”KAREL的变量类型规格和现代语言比显得有点“古早”但它并不难用只要记住几点STRING长度必须显式声明比如STRING[80]最大长度通常255。字符串拼接用但要注意别超长超长会触发INVSTR错误。INTEGER是16位有符号整数范围-32768到32767。曾经有朋友在KAREL里算一个工件数量干了几个月数值超过32767之后直接变负数排查了半天才发现是这个原因。如果要存大数用REAL或者改用两个INTEGER位分别存储。REAL是浮点数存在精度误差不要直接判断浮点相等。我一般用ABS(a - b) 0.001这种写法。数组从下标1开始不是0。这个和大多数编程语言都不一样写FOR循环的时候要特别注意VAR arr : ARRAY[1..5] OF INTEGER BEGIN FOR i : 1 TO 5 arr[i] : i * 2 ENDFOR END3. 实操过程与核心环节实现3.1 硬件与软件环境准备学习KAREL不需要一台真实的机器人但有个趁手的工具会效率翻倍。两种常用途径Roboguide仿真软件FANUC官方的PC端仿真工具内置KAREL编辑器、编译器和虚拟控制器。推荐纯软件学习者使用因为它不占设备、随便折腾也不怕撞机。真实控制器如果你手头有机器人那就在示教器上操作。从MENUS键进入翻到NEXT页找到KAREL选项。没有这个选项的话需要先设置$KAREL_ENB为TRUE并重启控制器。实际项目中我习惯在Roboguide里把KAREL程序调好、编译通过、验证逻辑再拷贝到真实机器人上跑。这样省时间也安全特别是涉及运动指令的时候仿真环境里至少不会撞到夹具。3.2 一个完整例子读取系统参数计算偏移位置执行直线运动我们来写一个真正能用的程序。场景输送线上传来一个工件的偏移量存放在SBR[2]的PARAM[47]和PARAM[48]中KAREL程序读取这两个值在当前基准位置基础上偏移然后走一个直线运动到目标点。PROGRAM KRL_DEMO1 VAR off_x : INTEGER off_y : INTEGER base_pos : XYZWPR target_pos : XYZWPR speed : INTEGER BEGIN -- 读取SBR参数 off_x : $SBR[2].$PARAM[47] off_y : $SBR[2].$PARAM[48] -- 读取当前位置注意必须稍作延时确保位置刷新 DELAY 100 GET_POSITION(base_pos) -- 计算目标位置 target_pos.X : base_pos.X off_x target_pos.Y : base_pos.Y off_y target_pos.Z : base_pos.Z target_pos.W : base_pos.W target_pos.P : base_pos.P target_pos.R : base_pos.R -- 设定速度 speed : 500 -- 直线运动到目标 LWPRECISION 2 PTH_APPROACH(target_pos, speed, 50) -- 到这里说明运动执行完毕 $SBR[2].$PARAM[49] : 1 END KRL_DEMO1这里有几段代码值得展开说。GET_POSITION是KAREL里获取当前机器人位置的系统函数返回的XYZWPR是一个记录类型包含X、Y、Z位置和W、P、R欧拉角对应FANUC的姿态表示。如果你要在程序里读位置这个函数基本是必用的。LWPRECISION 2设置直线运动精度等级数字越大预计算点越密路径越精准但程序运行时的CPU占用也越高。一般默认2就够用特殊要求再调高。PTH_APPROACH是KAREL里做TCP直线运动的函数长度可以指定任意数量的位置点。它和TP里的L指令等价但写起来灵活很多——目标点可以是变量、表达式结果甚至是从文件里读出来的数据。括号里的最后一个参数是接近点距离单位mm意思是接近目标点前50mm的路径部分采用更平滑的方式过渡避免姿态突变。这个例子看起来简单但它覆盖了KAREL编程中最高频的三类操作读取系统变量、数学计算、运动指令调用。把这三种组合好了就已经能解决现场至少七成的问题。3.3 编译、上传与示教器调用KAREL程序写完之后不能直接运行必须先编译。在Roboguide里右键程序文件选择Build编译器会在FR盘符下生成对应的.PC文件。真实控制器上的操作路径是SELECT→NEXT→KAREL然后进入编程界面按F2编译。编译通过之后调用方式有三种TP程序里调用在TP指令列表里插入CALL KRL_DEMO1这应该是最常用的方式。适合把KAREL程序嵌入到已有的自动化流程中。KAREL程序之间调用A程序里写CALL MY_OTHER_PROG实现模块化。直接运行在KAREL程序列表里选中程序按FWD适合单机调试。我个人的习惯是KAREL程序尽量写成“无界面、纯后台计算”的形式界面的启停交给TP程序控制。因为TP程序有明确的行号显示和暂停/复位逻辑现场电控人员更熟悉这种交互方式KAREL程序一旦运行示教器上只能看到它正在RUNNING不好中断。3.4 一个实际项目的程序骨架配方管理后台来看一个比上面更接近真实生产的骨架。项目需求是机器人根据扫码枪读取的产品型号从配方文件里找到对应的偏移量组合然后搬运到不同料框。如果不用KAREL这个功能在TP里写会非常痛苦——你得把每种产品的偏移量变成一堆位置寄存器再写一大堆IF判断。KAREL版本就简洁得多。PROGRAM RECIPE_MGR VAR product_code : STRING[20] scan_result : INTEGER offset : REAL flag : BOOLEAN BEGIN -- 读取扫码数据假设已经写入SBR product_code : FOR i : 1 TO 20 -- 从SBR中逐字符恢复字符串 ENDFOR -- 根据型号匹配配方 IF product_code A001 THEN offset : 10.5 flag : TRUE ELSE offset : 0 flag : FALSE ENDIF -- 调用TP主流程 CALL TPPROG_MAIN END RECIPE_MGR这里CALL TPPROG_MAIN就是KAREL回调TP程序的语法。在这个例子里KAREL先把扫码数据解析成产品型号字符串再根据型号设置好偏移量标志最后把控制权交回TP主流程由TP去执行后续的路径运动。这样分工的好处很明显字符串解析放在KAREL里既简单又可调试TP只管按位置寄存器的值去跑。4. 常见问题与排查技巧实录KAREL编程报错是家常便饭下面整理了我自己遇到过的典型问题以及现场排查的思路。4.1 常见报错速查表报错信息原因分析解决方案KAREL0350标识符未声明或拼写错误检查变量是否在VAR区声明程序名是否与文件名一致KAREL0354语法错误通常是分号或字符不合法KAREL不需要分号重点检查字符串引号是否配对UNRECOGNIZED INSTRUCTION指令名称拼错或者版本不支持查阅该控制器版本的KAREL参考手册确认指令是否存在INVSTR字符串操作越界检查STRING长度是否足够拼接时是否超过255字符FILE_NOT_FOUND找不到指定的程序文件或数据文件确认文件是否已经编译并上传到正确的盘符目录INTPRC数值运算错误常见0除在除法运算前加保护判断分母接近0时赋默认值MOTN_IMPROP运动指令参数不合理检查速度是否为正目标点是否可达接近距离是否过小4.2 程序编译通过但运行时无响应的排查这类问题最折磨人因为系统不报错但就是不动。按我的经验优先级排序如下看程序是否真的在运行。示教器上切到KAREL界面看到RUNNING标志才说明程序启动了。检查是否卡在某个等待条件上。比如程序里有WAIT $SBR[1].$PARAM[10]但PLC一直没有把对应标志位置TRUE。解决办法是在程序里临时加WRITELN调试信息输出关键变量的值。确认是不是被TP程序占用了控制权。如果TP主程序处于暂停状态而KAREL程序试图执行运动指令运动指令会一直排队等待。检查是不是有循环未退出。KAREL里用WHILE TRUE DO ... ENDWHILE写死循环时一定要在内部设置退出条件否则程序看起来“没反应”其实是在疯狂循环。4.3 KAREL和TP通信的几个坑KAREL程序里的WRITELN输出到哪里默认是示教器的KAREL控制台界面不是TP程序的信息窗口。如果需要把KAREL的调试信息显示在TP上需要往对应的$TP_MSG或SBR标志位里写值。TP程序的R[i]寄存器在KAREL里怎么表示直接用$R[i]。注意不是R[i]必须带$前缀。很多从TP转过来的人在这里吃过亏。KAREL程序里能不能直接调用TP程序可以CALL TPPROG即可。但要注意KAREL调用TP时TP程序里的CALL指令不能递归嵌套太深否则控制器会报调用栈溢出。4.4 调试技巧善用调试模式与系统标志Roboguide里有一个非常好用的KAREL调试工具可以单步执行、查看变量值、设置断点。在主菜单Debug里选择KAREL Debugger加载编译后的.PC文件就能像调试C程序一样调试机器人程序了。另外强烈建议在写复杂KAREL程序时养成一个习惯在程序入口位置加一条WRITELN(START...)在每个阶段结束加一条WRITELN(DONE STEP1)。这些输出在仿真环境里刷屏无所谓但换上真机时它们能让你快速定位问题出在哪一段。调试完再注释掉或者用条件标志控制输出即可。4.5 现场经验从TP思维转换到KAREL思维最后说点走心的体会。很多工程师学KAREL学得痛苦不是因为语法难而是因为思维没切换过来。TP语言是“按行执行”的程序跑完一遍就停了KAREL则有完整的控制流有循环、有函数调用、有变量作用域这些都需要按通用编程语言的方式来理解。我自己转型时期的练习方法是把以前在TP里做过的一个复杂工位程序用KAREL重新实现一遍。不求功能更多只求代码结构更清晰。比如原本用20个IF判断串联的逻辑用数组和选择分支重写原本靠一堆位置寄存器的数据流用函数参数和局部变量表达。这个过程非常有价值——它会倒逼你理清数据流和控制流而不是遇到问题堆判断。我用到今天还算顺手的组合是KAREL程序只做两件事一是算二是传。算就是搬数据、做逻辑、生成目标点传就是把算好的数据写进SBR、R寄存器、IO区供TP程序读取执行。把KAREL和TP的边界画清楚程序的维护成本会低很多现场排查问题时一看到故障现象就能快速定位是逻辑层出问题还是运动层出问题。这个系列下一篇我会写KAREL的字符串处理与文件读写实战包括从扫码枪读取字符串并解析CRC校验以及把机器人运行日志写入U盘的操作。这些功能在TP里基本是无解的但对产线数据追溯来说又必不可少。到时候再把这部分经验整理出来分享给大家。本文还有配套的精品资源点击获取 FANUC机器人KAREL编程入门：系统变量与运动控制实战
简介FANUC机器人KAREL编程入门学习1是一份面向机器人集成与应用初学者的Word图文笔记系统讲解KAREL语言与TP示教器的区别——KAREL用于增强系统、辅助动作但并不直接控制机器人运动。文档从KAREL程序的基本结构入手说明PROGRAM与END之间的变量声明、关键字限制、命名规则等再结合ROBOGUIDE仿真环境演示添加KAREL软件包、修改KAREL_ENB变量、创建源文件并编译生成.PC文件的完整流程并通过DO[1]信号示例展示手动执行与测试方法。资源为单个DOCX文档约5.63MB适合边看边操作。已有2674人学习对于希望快速入门FANUC KAREL编程的工程师是一份简明实用的起步资料既能理解语言规则也能按步骤完成一次从代码到运行的闭环体验。 每次一提到FANUC机器人的高级编程身边总有工程师问我“KAREL到底值不值得学”我的回答通常很简单如果你只做点位示教和简单搬运TP语言确实够用但凡你碰到数据解析、队列调度、文件读写、上位机交互这些需求KAREL就是绕不开的坎。这篇内容是我的KAREL入门学习笔记第一弹先聊清楚它是什么、程序长什么样、和TP语言怎么配合最后给一个能从示教器直接跑起来的完整例子。FANUC机器人KAREL编程本质上是用一种PASCAL风格的高级语言去写机器人控制器底层能识别的程序。它和TPTeach Pendant程序最大的区别在于KAREL能做复杂逻辑运算、字符串处理、数组操作还能直接读取系统变量和寄存器数据。这篇文章适合三类人现场调试遇到TP写不聊功能的工程师、做自动化集成想扩展机器人功能的朋友、以及准备系统学习FANUC二次开发的初学者。读完你能明白KAREL和TP程序的调用关系掌握程序结构并且拿到一个可以直接上机验证的例程。1. 内容整体设计与思路拆解1.1 为什么FANUC要保留一套“老派”语言很多人第一次打开KAREL编辑器都会被它的界面吓到——没有自动补全、没有彩色高亮、错误提示也是老式的行号定位。这个体验和现代IDE确实没法比但它背后有很实在的理由。KAREL语言从FANUC早期控制器沿用至今核心优势是稳定和直接。它编译后生成的是控制器原生执行的伪代码不依赖解释器运行效率比TP逐行解释要高很多。更重要的是KAREL能访问TP语言碰不到的系统内部数据比如$SBR[n].$PARAM[47]这种系统参数数组、位置寄存器PR[i]的每一个分量、IO状态位、刀具负载数据等。举个例子你想在机器人运行中动态修改速度倍率TP里通常只能手动按示教器上的倍率键。但在KAREL里直接写$GENOVERRIDE : 80就能把全局倍率改成80%而且还能用条件判断决定什么时候改。这类对控制器内部状态的精细控制才是KAREL真正的价值所在。1.2 KAREL与TP程序的分工定位在实际项目中我的习惯是“TP搭骨架KAREL做内脏”。TP程序负责主流程等待启动信号、调用各工位程序、判断完成条件KAREL程序负责需要复杂计算的环节比如读取扫码枪数据并解析ASCII字符串根据数据库或配方文件动态计算目标位置执行文件读写、日志记录、数据上报处理多线程后台逻辑比如监控安全信号的同时执行运动两者之间的桥梁是CALL指令。TP里可以用CALL KAREL_PROG调用KAREL程序KAREL里也可以用CALL TPPROG回调TP程序。这种互相调用的机制非常灵活意味着你不必把所有的KAREL逻辑都写成一个巨大的程序可以拆分成多个模块每个模块只做一件事这样调试起来会轻松非常多。2. 核心细节解析与实操要点2.1 KAREL程序的基本结构从PROGRAM到END写KAREL程序之前先记住它的骨架。一个最简单的KAREL程序长这样PROGRAM TEST_PROG VAR msg : STRING[50] BEGIN msg : HELLO KAREL WRITELN(msg) END TEST_PROG几点关键说明PROGRAM关键字后面接程序名程序名必须和文件名一致否则编译报错。VAR部分声明变量。类型有INTEGER、REAL、STRING[n]、BOOLEAN、ARRAY等STRING必须指定长度。BEGIN ... END之间是程序主体。注意KAREL里赋值是:比较相等是这点和Pascal完全一样。每条语句后面不需要加分号换行就是语句结束符。这个最容易忘写习惯了C语言的人天天手滑加分号然后报错找了半天。也许你会问为什么FANUC不把KAREL做得更现代化一点我的理解是KAREL的定位是“稳定可靠地运行十年”而不是“写起来爽”。既然它语法稳定、兼容性好FANUC自然不愿意大改。我们作为使用者只需要记住它跟主流C系语法的差异就够了。2.2 系统变量KAREL和TP共享的“数据中枢”KAREL最强大的地方就是可以直接操作系统变量。系统变量以$开头比如$TIMER[1]、$POSITION、$MNUTYPE。这里重点提一下$SBR[n].$PARAM[m]这个结构。$SBR[n]是SBR寄存器n是寄存器编号。每个SBR寄存器下面有若干个$PARAM[m]字段可以存整数或布尔值。在TP程序里你会看到R[1]或者SBR[1]这种表示法在KAREL程序里它们的完整表示就是$SBR[1].$PARAM[47]。我在一个上下料项目里遇到过这样一个需求上位机实时下发不同工件的抓取高度机器人要根据高度值动态调整Z轴。当时用的方案就是上位机把高度值写入PLCPLC通过Profinet映射到机器人SBR寄存器的特定参数位KAREL程序循环读取这个参数然后计算目标位置。KAREL里读SBR参数只需要一行height : $SBR[1].$PARAM[47]注意$PARAM的数据类型不是整型就是布尔型读取之后要根据业务需求转换成REAL再参与计算。写的时候也一样$SBR[1].$PARAM[47] : new_height这里有个容易踩的坑某些系统参数在控制器运行过程中会周期性刷新比如当前位置、速度但SBR寄存器不是它只在被写入的时候更新。所以如果你在上位机上改了一个值KAREL程序里却没读到新值先检查一下写入是否真的到了控制器再看程序里有没有别的地方对同一个SBR做了覆盖写。2.3 数据类型与变量声明的“坑”KAREL的变量类型规格和现代语言比显得有点“古早”但它并不难用只要记住几点STRING长度必须显式声明比如STRING[80]最大长度通常255。字符串拼接用但要注意别超长超长会触发INVSTR错误。INTEGER是16位有符号整数范围-32768到32767。曾经有朋友在KAREL里算一个工件数量干了几个月数值超过32767之后直接变负数排查了半天才发现是这个原因。如果要存大数用REAL或者改用两个INTEGER位分别存储。REAL是浮点数存在精度误差不要直接判断浮点相等。我一般用ABS(a - b) 0.001这种写法。数组从下标1开始不是0。这个和大多数编程语言都不一样写FOR循环的时候要特别注意VAR arr : ARRAY[1..5] OF INTEGER BEGIN FOR i : 1 TO 5 arr[i] : i * 2 ENDFOR END3. 实操过程与核心环节实现3.1 硬件与软件环境准备学习KAREL不需要一台真实的机器人但有个趁手的工具会效率翻倍。两种常用途径Roboguide仿真软件FANUC官方的PC端仿真工具内置KAREL编辑器、编译器和虚拟控制器。推荐纯软件学习者使用因为它不占设备、随便折腾也不怕撞机。真实控制器如果你手头有机器人那就在示教器上操作。从MENUS键进入翻到NEXT页找到KAREL选项。没有这个选项的话需要先设置$KAREL_ENB为TRUE并重启控制器。实际项目中我习惯在Roboguide里把KAREL程序调好、编译通过、验证逻辑再拷贝到真实机器人上跑。这样省时间也安全特别是涉及运动指令的时候仿真环境里至少不会撞到夹具。3.2 一个完整例子读取系统参数计算偏移位置执行直线运动我们来写一个真正能用的程序。场景输送线上传来一个工件的偏移量存放在SBR[2]的PARAM[47]和PARAM[48]中KAREL程序读取这两个值在当前基准位置基础上偏移然后走一个直线运动到目标点。PROGRAM KRL_DEMO1 VAR off_x : INTEGER off_y : INTEGER base_pos : XYZWPR target_pos : XYZWPR speed : INTEGER BEGIN -- 读取SBR参数 off_x : $SBR[2].$PARAM[47] off_y : $SBR[2].$PARAM[48] -- 读取当前位置注意必须稍作延时确保位置刷新 DELAY 100 GET_POSITION(base_pos) -- 计算目标位置 target_pos.X : base_pos.X off_x target_pos.Y : base_pos.Y off_y target_pos.Z : base_pos.Z target_pos.W : base_pos.W target_pos.P : base_pos.P target_pos.R : base_pos.R -- 设定速度 speed : 500 -- 直线运动到目标 LWPRECISION 2 PTH_APPROACH(target_pos, speed, 50) -- 到这里说明运动执行完毕 $SBR[2].$PARAM[49] : 1 END KRL_DEMO1这里有几段代码值得展开说。GET_POSITION是KAREL里获取当前机器人位置的系统函数返回的XYZWPR是一个记录类型包含X、Y、Z位置和W、P、R欧拉角对应FANUC的姿态表示。如果你要在程序里读位置这个函数基本是必用的。LWPRECISION 2设置直线运动精度等级数字越大预计算点越密路径越精准但程序运行时的CPU占用也越高。一般默认2就够用特殊要求再调高。PTH_APPROACH是KAREL里做TCP直线运动的函数长度可以指定任意数量的位置点。它和TP里的L指令等价但写起来灵活很多——目标点可以是变量、表达式结果甚至是从文件里读出来的数据。括号里的最后一个参数是接近点距离单位mm意思是接近目标点前50mm的路径部分采用更平滑的方式过渡避免姿态突变。这个例子看起来简单但它覆盖了KAREL编程中最高频的三类操作读取系统变量、数学计算、运动指令调用。把这三种组合好了就已经能解决现场至少七成的问题。3.3 编译、上传与示教器调用KAREL程序写完之后不能直接运行必须先编译。在Roboguide里右键程序文件选择Build编译器会在FR盘符下生成对应的.PC文件。真实控制器上的操作路径是SELECT→NEXT→KAREL然后进入编程界面按F2编译。编译通过之后调用方式有三种TP程序里调用在TP指令列表里插入CALL KRL_DEMO1这应该是最常用的方式。适合把KAREL程序嵌入到已有的自动化流程中。KAREL程序之间调用A程序里写CALL MY_OTHER_PROG实现模块化。直接运行在KAREL程序列表里选中程序按FWD适合单机调试。我个人的习惯是KAREL程序尽量写成“无界面、纯后台计算”的形式界面的启停交给TP程序控制。因为TP程序有明确的行号显示和暂停/复位逻辑现场电控人员更熟悉这种交互方式KAREL程序一旦运行示教器上只能看到它正在RUNNING不好中断。3.4 一个实际项目的程序骨架配方管理后台来看一个比上面更接近真实生产的骨架。项目需求是机器人根据扫码枪读取的产品型号从配方文件里找到对应的偏移量组合然后搬运到不同料框。如果不用KAREL这个功能在TP里写会非常痛苦——你得把每种产品的偏移量变成一堆位置寄存器再写一大堆IF判断。KAREL版本就简洁得多。PROGRAM RECIPE_MGR VAR product_code : STRING[20] scan_result : INTEGER offset : REAL flag : BOOLEAN BEGIN -- 读取扫码数据假设已经写入SBR product_code : FOR i : 1 TO 20 -- 从SBR中逐字符恢复字符串 ENDFOR -- 根据型号匹配配方 IF product_code A001 THEN offset : 10.5 flag : TRUE ELSE offset : 0 flag : FALSE ENDIF -- 调用TP主流程 CALL TPPROG_MAIN END RECIPE_MGR这里CALL TPPROG_MAIN就是KAREL回调TP程序的语法。在这个例子里KAREL先把扫码数据解析成产品型号字符串再根据型号设置好偏移量标志最后把控制权交回TP主流程由TP去执行后续的路径运动。这样分工的好处很明显字符串解析放在KAREL里既简单又可调试TP只管按位置寄存器的值去跑。4. 常见问题与排查技巧实录KAREL编程报错是家常便饭下面整理了我自己遇到过的典型问题以及现场排查的思路。4.1 常见报错速查表报错信息原因分析解决方案KAREL0350标识符未声明或拼写错误检查变量是否在VAR区声明程序名是否与文件名一致KAREL0354语法错误通常是分号或字符不合法KAREL不需要分号重点检查字符串引号是否配对UNRECOGNIZED INSTRUCTION指令名称拼错或者版本不支持查阅该控制器版本的KAREL参考手册确认指令是否存在INVSTR字符串操作越界检查STRING长度是否足够拼接时是否超过255字符FILE_NOT_FOUND找不到指定的程序文件或数据文件确认文件是否已经编译并上传到正确的盘符目录INTPRC数值运算错误常见0除在除法运算前加保护判断分母接近0时赋默认值MOTN_IMPROP运动指令参数不合理检查速度是否为正目标点是否可达接近距离是否过小4.2 程序编译通过但运行时无响应的排查这类问题最折磨人因为系统不报错但就是不动。按我的经验优先级排序如下看程序是否真的在运行。示教器上切到KAREL界面看到RUNNING标志才说明程序启动了。检查是否卡在某个等待条件上。比如程序里有WAIT $SBR[1].$PARAM[10]但PLC一直没有把对应标志位置TRUE。解决办法是在程序里临时加WRITELN调试信息输出关键变量的值。确认是不是被TP程序占用了控制权。如果TP主程序处于暂停状态而KAREL程序试图执行运动指令运动指令会一直排队等待。检查是不是有循环未退出。KAREL里用WHILE TRUE DO ... ENDWHILE写死循环时一定要在内部设置退出条件否则程序看起来“没反应”其实是在疯狂循环。4.3 KAREL和TP通信的几个坑KAREL程序里的WRITELN输出到哪里默认是示教器的KAREL控制台界面不是TP程序的信息窗口。如果需要把KAREL的调试信息显示在TP上需要往对应的$TP_MSG或SBR标志位里写值。TP程序的R[i]寄存器在KAREL里怎么表示直接用$R[i]。注意不是R[i]必须带$前缀。很多从TP转过来的人在这里吃过亏。KAREL程序里能不能直接调用TP程序可以CALL TPPROG即可。但要注意KAREL调用TP时TP程序里的CALL指令不能递归嵌套太深否则控制器会报调用栈溢出。4.4 调试技巧善用调试模式与系统标志Roboguide里有一个非常好用的KAREL调试工具可以单步执行、查看变量值、设置断点。在主菜单Debug里选择KAREL Debugger加载编译后的.PC文件就能像调试C程序一样调试机器人程序了。另外强烈建议在写复杂KAREL程序时养成一个习惯在程序入口位置加一条WRITELN(START...)在每个阶段结束加一条WRITELN(DONE STEP1)。这些输出在仿真环境里刷屏无所谓但换上真机时它们能让你快速定位问题出在哪一段。调试完再注释掉或者用条件标志控制输出即可。4.5 现场经验从TP思维转换到KAREL思维最后说点走心的体会。很多工程师学KAREL学得痛苦不是因为语法难而是因为思维没切换过来。TP语言是“按行执行”的程序跑完一遍就停了KAREL则有完整的控制流有循环、有函数调用、有变量作用域这些都需要按通用编程语言的方式来理解。我自己转型时期的练习方法是把以前在TP里做过的一个复杂工位程序用KAREL重新实现一遍。不求功能更多只求代码结构更清晰。比如原本用20个IF判断串联的逻辑用数组和选择分支重写原本靠一堆位置寄存器的数据流用函数参数和局部变量表达。这个过程非常有价值——它会倒逼你理清数据流和控制流而不是遇到问题堆判断。我用到今天还算顺手的组合是KAREL程序只做两件事一是算二是传。算就是搬数据、做逻辑、生成目标点传就是把算好的数据写进SBR、R寄存器、IO区供TP程序读取执行。把KAREL和TP的边界画清楚程序的维护成本会低很多现场排查问题时一看到故障现象就能快速定位是逻辑层出问题还是运动层出问题。这个系列下一篇我会写KAREL的字符串处理与文件读写实战包括从扫码枪读取字符串并解析CRC校验以及把机器人运行日志写入U盘的操作。这些功能在TP里基本是无解的但对产线数据追溯来说又必不可少。到时候再把这部分经验整理出来分享给大家。本文还有配套的精品资源点击获取