FANUC FOCAS2屏幕显示功能实战：从CNC画面采集到远程监控

简介面向发那科数控系统集成工程师、设备维护人员及智能制造方案开发者资料围绕FOCAS2以太网通信系统讲解如何远程读取CNC屏幕显示、监控机床实时状态并采集生产数据。压缩包共104个文件大小9.69MB类型覆盖较全gif演示动画直观展示界面操作与配置流程cab安装数据包存放驱动及示例组件dll与lib库支撑Windows环境下的二次开发exe工具可快速验证通信效果h头文件提供接口声明txt说明文档记录参数设置与注意事项。内容涵盖实时监控、远程编程、数据收集、故障诊断、远程维护等典型场景适合已具备一定数控基础、希望掌握FOCAS2接口调用的开发者。已有1111人学习。资料实用价值在于既给出了环境搭建与API调用的具体示例也整理了屏幕显示相关的数据读取、报警抓取、远程维护实现思路可帮助读者快速建立FOCAS2联调环境缩短二次开发周期并为现场故障诊断与远程管理提供直接参考。 去年接手一个项目客户车间里二十多台FANUC加工中心MES系统要求实时看到每一台设备的当前画面、报警信息和操作记录。设备数据接口本身不难找FOCAS2一上来就能读坐标、读宏变量、读报警可客户偏偏提出一个需求把CNC屏幕上正在显示的内容也抓出来跟远程桌面一样能在办公室看到机台当前的画面状态。这就涉及FANUC FOCAS2以太网通信里的屏幕显示功能Screen Display Function。这套功能网上的资料不多官方手册写得也比较简陋我前前后后踩了不少坑才把链路完全跑通。这篇博文就把整个实现过程、代码逻辑、以及我在现场遇到的疑难问题完整梳理一遍给后面要做FANUC设备数据采集、远程监控或者车间数字化的工程师做个参考。1. 屏幕显示功能解决的是最后一屏的采集难题1.1 为什么放着现成数据接口不用偏要读屏幕刚开始接这个需求时我其实有点不理解。FOCAS2能读的数据太多了轴坐标、进给倍率、主轴负载、报警号、程序号、宏变量几乎覆盖了设备监控需要的所有参数为什么还要去读屏幕后来跟客户的生产主管聊完才明白他们的需求不是简单的数据采集而是画面追溯。比如夜班操作员在某个时间点做了什么操作、屏幕上弹过什么提示、当时处于什么界面这些信息通过传统的数据接口很难完整还原。屏幕显示功能可以定时把CNC屏幕上的文本内容抓下来存到数据库里相当于给每一台机床装了一个黑匣子员工操作是否规范、设备当时处于什么状态一查便知。另外一个很实际的应用场景是远程协助。设备厂家在外地操作员遇到报警不知道怎么处理传统做法是打电话现描述屏幕内容经常说不清楚。通过屏幕显示功能厂家技术人员可以直接看到机台当前的画面文本快速定位问题。这个需求在很多做设备远程运维的公司里都存在。1.2 屏幕显示功能在FOCAS2生态里的定位FOCAS2是FANUC Open CNC API System 2的缩写是FANUC官方提供的一套基于以太网或HSSB高速串行总线的通信开发库。它由一系列动态链接库组成开发者可以用C、C、C#、VB等语言调用实现PC与CNC之间的双向数据交换。在FOCAS2庞大的API体系里屏幕显示功能属于比较特殊的一类。它不像读取坐标那样直接返回一个数值而是返回一段字符矩阵——也就是CNC屏幕在当前时刻渲染出来的文本内容。从技术上来说它模拟的是人在操作面板上看到的画面而不是内部寄存器里的原始数据。这个功能在FANUC 0i系列、16i/18i/21i系列、30i/31i/32i系列以及Power Motion i系列上都有支持但不同系列、不同NC系统版本之间函数返回的数据格式和屏幕规格会有些差异。比如0i系列和31i系列的屏幕分辨率、可显示的行列数就不同后面采集程序里对返回数据的处理逻辑必须做兼容适配否则很容易解析错位。2. 上手前必须搞清楚的通信前提和参数2.1 硬件与系统版本要求先说硬性前提。FANUC数控系统要支持以太网通信必须配备以太网功能板卡或内置以太网接口。0i-D以后的系统基本都标配了嵌入式以太网接口老一点的0i-B或者16i/18i可能要单独加装板卡。做项目前要做的第一件事就是到CNC的SYSTEM画面里确认以太网功能是否可用、板卡类型是什么。具体的等待确认方式我在后面踩坑部分会细说。这里提醒一个容易被忽略的点有些设备虽然带了以太网口但功能选项参数没打开FOCAS2连接会一直报错。FANUC的FOCAS2通信服务由嵌入式以太网功能提供如果系统参数没有启用这个选项Libraries里的连接请求会被直接拒绝。系统版本方面30i、31i系统对FOCAS2库的版本有要求。我建议开发机上的FOCAS2库版本尽可能用新一些的FANUC官方每季度都会更新FWLIB版本新版库对老系统向下兼容做得不错但对新版系统就必须要用对应的库版本否则会出现连接成功但读取数据异常的情况。2.2 以太网连接初始化与握手流程FOCAS2以太网通信的逻辑不复杂本质上就是TCP/IP协议基础上的应用层通信。连接流程分三步第一步设置CNC侧网络参数。在CNC的以太网设定画面里配置IP地址、子网掩码、默认网关。这里有个小细节有些老系统的IP地址修改后需要重启才能生效而且同一网段内不要有其他设备占用相同IP否则握手会冲突。第二步PC端调用cnc_allclibhndl3函数发起连接。这个函数需要传入CNC的IP地址、端口号、超时时间等参数。端口号默认是8193这是FANUC官方固定的一般不需要修改。超时时间建议设成10秒左右太短容易在CNC繁忙时误判超时太长则程序卡顿明显。第三步连接成功后程序会拿到一个会话句柄FlibHndl后面所有数据读取操作都基于这个句柄。操作完毕后调用cnc_freelibhndl释放连接。这里我特别强调一下会话概念。FOCAS2建立的不是一条简单的TCP连接而是一个有状态的会话。同一台CNC同时允许的会话数量有限具体取决于系统选项一般FANUC只允许1到2个PC同时连接。如果现场有多台电脑想同时采集同一台设备后连接的会被拒绝。这就需要在架构设计时考虑好用一个采集网关统一去连设备业务系统通过网关取数而不是让每台电脑都直连CNC。2.3 用FOCAS2库建立会话的基础代码我用C#举个例子。FANUC官方的FOCAS2库提供了面向.NET的互操作接口需要引用Focas1.dll和Focas1.cs这个互操作文件。实际项目中我比较推荐用C#来写采集服务开发效率高部署也方便。using System; using System.Runtime.InteropServices; public class FanucConnector { [DllImport(Fwlib32.dll, EntryPoint cnc_allclibhndl3)] public static extern short cnc_allclibhndl3(string ipAddress, ushort port, int timeout, out ushort flibHndl); public static ushort Connect(string ip, ushort port 8193, int timeout 10000) { ushort handle; short ret cnc_allclibhndl3(ip, port, timeout, out handle); if (ret 0) { Console.WriteLine($连接成功句柄: {handle}); return handle; } else { throw new Exception($连接失败错误码: {ret}); } } }注意FOCAS2的库文件分32位和64位项目编译目标平台必须和DLL位数一致。我之前遇到过一个诡异问题程序在开发机跑得好好的部署到工控机上就连接失败查了很久发现是工控机上装了64位系统而项目编译成了x86DLL加载路径不对。这个坑大家在发布时一定要留意。3. 屏幕数据读取实战从握手到拿到第一帧画面3.1 读取函数的使用逻辑与数据格式连接建立之后读取屏幕显示内容的核心函数在FOCAS2里是cnc_get_screenimage。这个名字看起来像是要返回一张图片其实不然它返回的是屏幕当前显示的字符数据也就是每个显示位置上的字符编码。函数的基本参数逻辑是这样的传入会话句柄、屏幕类型、缓冲区长度函数返回后数据缓冲区里装的就是按行列排列的字符数组同时还有一个结构体描述屏幕的行数、列数等规格。明白了这个机制后整个读取逻辑就清晰了先询问屏幕规格再分配足量缓冲区调用读取函数拿到字符矩阵最后按行列把字符还原成可读文本按行拼接输出。3.2 把原始字符还原成可读文本FOCAS2返回的字符数据是Unicode码还是ASCII码取决于具体的库版本和NC系统设置。多数情况下英文字符和数字是标准的ASCII码但日文汉字、中文注释以及特殊符号用的编码方式会复杂一些。我踩过的一个坑是FANUC系统里操作员经常给程序名加中文注释屏幕显示这些注释时FOCAS2返回的是Shift-JIS编码。直接用Encoding.ASCII转换会得到一堆问号。项目里需要根据CNC系统语言设置灵活处理日文系统用Encoding.GetEncoding(932)Shift-JIS转换简体中文系统可能涉及GBK相关编码。怎么判断当前系统语言可以在FOCAS2连接后读取CNC系统语言相关参数或者在配置界面手工指定。基础读取代码我写个核心示例真正项目里还需要加错误处理和状态判断// 以C#伪代码展示读取过程 public string ReadScreen(ushort handle) { // 1. 获取屏幕规格 ushort type 0; // 0表示当前显示画面 ushort length 1024 * 64; // 缓冲区长度的经验值 ushort[] data new ushort[length]; ushort[] screenInfo new ushort[1024]; short ret cnc_get_screenimage(handle, type, length, data, screenInfo); if (ret ! 0) return string.Empty; // 2. 解析结果 StringBuilder sb new StringBuilder(); foreach (ushort code in data) { if (code 0) continue; char ch (char)code; sb.Append(ch); } return sb.ToString(); }3.3 多行多区域画面的完整读取流程实际CNC屏幕不是简单的一整块文本。FANUC系统屏幕通常分为多个区域比如标题栏、程序内容区、软键提示栏、状态栏等。FOCAS2的屏幕数据读取函数返回的字符数组里会包含这些区域的文本但不同区域之间用什么分隔符隔开官方手册里写得不清楚。我做项目时的处理策略是把读取到的字符按行号拆分单行长度确认之后按行列坐标把数据切分成几个业务区域。比如报警画面中报警号出现在第3行报警文本出现在第4行程序列表画面中文件名在中间区域坐标画面中各轴坐标值分散在多行。这些画面解析规则需要在看得到CNC实际画面的情况下对照标定一次之后就能稳定使用了。这个标定过程必须仔细。我先写了一个调试工具把返回的屏幕文本实时输出旁边放着一个摄像头对着真实CNC屏幕两边对照。调整行列切割逻辑直到程序输出的文本顺序和真实画面逐行一致为止。这一步做好之后后续所有解析都以此为基础。4. 实测中的坑连接、编码、刷新率一个都不能少4.1 连接超时与路由问题的完整排查链路我在调试过程中遇到过连接不上的问题排查链路的每一步都有代表性分享出来可以让你们少走弯路。现象是cnc_allclibhndl3连接返回超时错误码。按照从易到难的顺序我先做了这么几步排查。第一步PC与CNC之间用ping命令测试网络连通性。结果发现ping不通。这就排除了FOCAS2本身的问题问题出在物理链路或网络配置上。第二步检查网线连接和交换机端口状态。FANUC板卡有些是百兆口有些是千兆口如果交换机端口强制成了千兆速率或者网线是只支持百兆的旧线都会导致协商失败。我把交换机端口改成自协商换了一根六类网线ping通了。第三步ping通之后FOCAS2连接还是报错。这时候我看了一下防火墙设置FOCAS2的8193端口在Windows防火墙里默认是拦截的。给防火墙添加入站规则开放8193端口后连接就成功了。这个问题的完整链路从物理层到网络层再到应用层每一步都有对应的验证手段。现场排查的时候不要一上来就怀疑FOCAS2库有问题先确认网络通不通再查端口放行最后查接口调用参数顺序对了效率就高了。4.2 中文注释乱码与字符集转换屏幕显示功能返回的中文、日文特殊字符乱码问题我前面提了一嘴这里展开讲。FANUC系统的字符编码默认是Shift-JIS即使显示的是中文界面底部数据交换用的编码也可能是Shift-JIS。这就导致直接按Unicode解码会乱码。但有个细节FOCAS2的cnc_get_screenimage函数返回的不是字节流而是ushort数组。每个ushort在某些情况下已经是Unicode编码在另一些情况下却只是Shift-JIS的字节扩展。判断依据是NC系统的屏幕显示语言版本和FOCAS2库的转换行为。最省事的做法是先全量按Unicode解码看乱码字符集中在哪个区域。如果只有中文注释乱码、英文数字正常那大概率是Shift-JIS需要对非ASCII区域做Shift-JIS - Unicode的再转换。我用的是Encoding.GetEncoding(932).GetString对原始字节做二次处理。还有一个容易忽略的点是半角全角问题。日文系统的屏幕字符有全角半角之分FOCAS2返回的半角空格和全角空格混在一起解析时如果不统一处理后续做字符串匹配时会踩坑。建议在解析阶段把全角空格统一转成半角空格或者把连续空格压缩成单空格这样匹配关键字时稳定得多。4.3 高刷新率引发的性能问题屏幕显示功能不是为高频读取设计的。我最初设计采集服务时想着能不能做到每秒刷新一次结果发现两个方面扛不住。第一CNC系统负载。FOCAS2屏幕读取会占用CNC内部的通信处理资源频繁读取会导致CNC屏幕操作卡顿极端情况下可能影响生产。所以屏幕显示功能的读取频率一定要保守现场实测1秒一次会让操作员明显感到屏幕迟钝最终我调成了3到5秒一次生产基本无感。第二数据存储量。CNC屏幕文本一次抓取下来大约有2到4KB看似不大但如果几十台设备每秒钟都存一次一天下来一个设备就有近一个GB的文本数据之后做趋势分析时数据库压力很大。实际项目里我做了两层优化平时只保存画面摘要和关键状态字段只有发生报警或者操作状态切换时才保存完整屏显文本另外做数据归档超过三个月的原始文本自动转存到冷存储。这样既满足了追溯需求又不会把数据库撑爆。高性能采集的正确姿势是坐标、宏变量等数值型数据走高频通道屏幕文本走低频通道。两者用不同的读取频率、不同的存储策略而不是一股脑全按同样的频率去抓。5. 从屏幕采集到车间监控的落地经验5.1 与MES/SCADA对接的数据结构设计屏幕显示功能的数据最终要喂给MES或SCADA系统这里就有一个数据契约设计的问题。我推荐的做法是建立一张设备屏显记录表核心字段包括设备编码、采集时间、画面类型、屏幕原始文本、解析后的关键字段如报警号、程序名、当前模式。采集服务负责把FOCAS2读到的屏幕文本处理成结构化数据MES只消费结果不感知底层的FOCAS2通信细节。CREATE TABLE cnc_screen_log ( id BIGINT PRIMARY KEY AUTO_INCREMENT, device_code VARCHAR(32) NOT NULL, collect_time DATETIME NOT NULL, screen_type VARCHAR(16), raw_text TEXT, alarm_no VARCHAR(16), program_name VARCHAR(64), work_mode VARCHAR(16), operator_id VARCHAR(32), INDEX idx_device_time (device_code, collect_time) );表结构设计时要把解析出的关键字段单独建列。原因很实际MES侧经常要按报警号、程序名做筛选查询如果只存原始文本每次查询都要全文检索性能和逻辑都会很麻烦。解析工作必须在采集服务里完成。5.2 区分报警画面与正常画面的自动判断实际项目里还有一个很常见的需求自动识别CNC是否处于报警状态并记录报警发生的时间点和恢复时间点。FOCAS2本身有报警读取函数可以直接读报警号但有时候报警内容显示在屏幕上的文本比报警号更有参考价值比如操作提示、报警详细描述这些只存在于屏幕文本中。我的判断逻辑是同时利用两个信号一是FOCAS2报警读取函数返回的报警号二是屏幕文本里是否包含ALARM报警等关键字。两者结合判断可以降低误判率。比如有些情况下系统状态栏会显示ALARM字样但实际并不是报警状态而是提示信息。这时仅靠报警号判断会漏报仅靠关键字判断会误报两者取交集最稳妥。报警画面的文本特征比较明显通常顶部有报警号列表、中间有报警详情、底部有操作指引。解析时可以按这些特征做区域识别。报警触发后采集服务立即把完整屏显文本存一条快照并推送通知到MES端报警恢复后再存一条恢复快照两者配对形成一次完整的报警事件闭环。5.3 扩展思路屏幕显示功能之外的FOCAS2常用接口屏显功能做出来后客户往往会接着提更多数据需求。FOCAS2的常用接口里有几个和屏幕显示功能搭配起来效果特别好。一个是cnc_rdaxisdata读取轴数据包括各轴机械坐标、绝对坐标、剩余移动量、负载等。这个用于实时监控加工进度的场景和屏幕显示功能一快一慢搭配能兼顾实时性和完整度。一个是cnc_rdmacro读取宏变量可以直接拿到用户宏程序里的关键工艺参数。很多客户会在宏程序里存放产品编号、刀具寿命、加工计数等信息通过宏变量读取比屏幕文本解析更直接。还有一个是cnc_rdalm读取报警信息返回结构化的报警号列表。和屏幕文本里的报警详情配合既拿到了标准报警编码又拿到了用户可读的报警描述做知识库积累时非常有用。选型建议上我一般这样分配高频状态监控用轴数据和宏变量低频画面追溯用屏幕显示功能报警联动时再触发一次高优先级的报警接口读取。这样每条通道都在自己适合的频率下工作CNC通信负载和服务器压力都能保持在一个健康水平。写在最后的实操心得这套FANUC CNC屏幕显示功能FOCAS2以太网的方案从搭建环境到完全稳定运行我前后花了大概两周时间其中大部分时间消耗在编码转换和画面解析规则标定上。如果你们项目里也要做类似功能我建议先花半天时间把一台设备、一条完整链路的调试工具跑通再做批量扩展。调试阶段有一个小技巧值得分享FOCAS2的屏幕数据读取函数在CNC处于不同界面时返回的文本布局差异很大。编写解析规则务必要覆盖坐标画面、程序编辑画面、报警画面、参数画面这几个典型界面。如果只按某一类画面写死逻辑现场换了个画面运行解析结果就会乱掉。最后提醒一点屏幕显示功能虽然实用但不要滥用。CNC是用来加工零件的不是用来做信息服务的。读取频率、读取时段都要以不影响生产为前提。我在项目里把屏幕读取频率默认设成5秒一次只有在报警触发时才临时提高到1秒一次持续10秒既保证了事件追溯的精细度又不会给CNC增加负担。目前这套机制已经在客户车间稳定运行了大半年每天记录的屏显数据量在可控范围内远程运维时画面追溯的价值体现得很明显。如果你们的MES或设备监控系统也卡在数据都有了但操作画面不可见这一步不妨考虑把FOCAS2屏幕显示功能加进去它补上的正是传统数据接口够不着的那一段。本文还有配套的精品资源点击获取