简介本资源是一套面向工业自动化工程师、智能制造系统集成人员及数控设备运维开发者的Fanuc FOCAS机床数据采集实战资料包聚焦解决CNC设备联网监控、实时状态获取与生产数据解析等核心问题。压缩包共含多个文件以PDF技术文档、跨平台Windows/Linux可运行Demo工程、FOCAS API调用示例代码含C#/Python等语言、配置指南及数据解析说明为主整体大小为28.36MB结构清晰便于按需查阅与快速部署。已有389人学习下载内容覆盖从环境搭建、协议通信、报警信息读取到刀具寿命监控等典型应用场景特别包含安全连接配置与常见通信故障排查要点显著降低FOCAS二次开发门槛助力用户高效构建本地化机床数据采集系统。 做机床数据采集这些年我最大的感受就是FANUC 系统的 FOCAS 库资料和示例代码才是真正的门槛。很多人不是不懂需求而是卡在“资料太散、demo 太少、Windows 和 Linux 两套环境还得各踩一遍坑”这个阶段。所以我把自己整理过的 FOCAS 采集资料和 Demo 打包分享出来了Windows 和 Linux 都支持省得大家再去翻那几百页英文 PDF 和逛各种老外论坛。这篇内容就当是资料包的使用说明书我会把 FOCAS 采集的技术原理、系统选型、环境搭建、核心 API 调用、常见报错排查一次讲透。适合做 MES、SCADA、设备数据采集看板、刀具寿命管理的开发者也适合工厂设备科想自己搞数据采集的工程师。只要车间里是 FANUC 的 0i、16i、18i、30i 系列系统这套方法论基本通用。1. FOCAS 采集到底是怎么回事1.1 先搞清楚 FOCAS 是什么FOCAS 的全称是 FANUC Open CNC API Specifications翻译过来就是“FANUC 开放式数控系统 API 规范”。它是 FANUC 官方提供给第三方开发者的一套开发接口让外部软件能够通过网络或板卡和机床进行数据交互。你可以把它理解成一个“翻译官”——MES 系统、采集程序问它要数据它再去和 CNC 系统底层沟通拿到坐标、主轴负载、报警信息之后以结构体的形式交还给你。FOCAS 能解决的问题非常明确市面上绝大多数 FANUC 系统都不是封闭的黑盒子只要你拿到授权、连对接口就能实时读取机床运行数据。这就是为什么国内做设备数据采集的项目只要是 FANUC 系统的机床基本都绕不开 FOCAS。它也支持远程上送程序、写入宏变量、修改 PMC 地址等操作这些在自动化和柔性线里尤其有用。1.2 FOCAS1 和 FOCAS2 怎么选很多人刚接触 FOCAS 时会困惑为什么资料里一会儿说 FOCAS1一会儿说 FOCAS2。其实区分很简单FOCAS1 走以太网通信FOCAS2 走 HSSB 高速串行总线板卡通信。对比项FOCAS1FOCAS2通信方式以太网 TCP/IPHSSB 专用板卡线缆距离可达百米级适合车间联网通常几米内板卡直连采集速率常规 500ms 以上足够稳定可做到更高频率适合高速采集部署成本低机床联网即可高需要安装板卡和光缆适用场景绝大多数车间采集项目高频振动监控、伺服数据深度分析从我接触的项目来看90% 以上的场景选 FOCAS1 就够了。车间里拉网线、机床配置 IP采集程序通过网络连接稳定性和便利性都很不错。FOCAS2 那套板卡方案除非你要求几十毫秒级的高频采样否则没必要上。1.3 能采到什么、能写到什么FOCAS 能采集的数据可以分为几大类坐标位置相对坐标、绝对坐标、机械坐标、主轴信息转速、负载、倍率、进给信息实际进给速度、进给倍率、程序信息当前程序号、正在执行的程序段号、运行模式自动、手动、MDI 等、报警信息当前报警号、报警文本、宏变量、PMC 地址开关门信号、夹具信号、刀具号等、系统状态运行时间、加工时间、待机时间。能写的操作也很有价值写宏变量例如把测量结果写入#600号变量、写 PMC 地址例如远程输出一个排屑信号、上传/下载加工程序、执行系统的一些控制指令。但也要注意边界FOCAS 只能访问官方 API 暴露出来的数据系统内部有些私有数据、未公开地址、非 FANUC 品牌设备的数据是拿不到的。另外FOCAS 的写操作是有权限限制的部分系统需要在功能选项中开通对应权限否则写入会报错。这一点后面在实操部分我会详细说。2. 我这套资料的整理思路2.1 为什么 Windows 和 Linux 必须都覆盖这个项目最初只有一个需求方用的 Windows 工控机做采集所以我只写了 Windows 版的 Demo。后面项目一扩展产线边缘服务器要上 Linux很多工厂边缘计算节点都是 CentOS 或者 Ubuntu上面跑 Docker采集服务就必须跨平台。于是我专门把 Linux 版本的库和 Demo 也补齐了。同样的代码逻辑Windows 下用 DLLLinux 下用 .so 和 .a 静态库接口参数完全一致。唯一麻烦的是 Linux 版 FOCAS 库目前官方提供的大多是 32 位的 libfwlib32.so在 64 位系统上编译运行需要装 32 位兼容库或者用 -m32 参数编译你的采集程序。这点资料包里我写清楚了两种处理方式。2.2 资料包里都有什么我整理的 FOCAS 资料包内容包括官方 API 手册英文 PDF覆盖 FOCAS1/FOCAS2 全部函数说明、常用函数速查表把 cnc_allclibhndl3、cnc_rdposition、cnc_rdspindle 这类高频函数单独摘出来注明参数含义、Windows 版 DemoC/C 和 C# 两个版本、Linux 版 DemoC 语言版本带 Makefile、编译运行常见问题汇总、以及我自己验证过的连接测试工具源码。很多人拿到官方 SDK 后最大的困境是“不知道从哪个函数入口开始”。我这份资料把这些内容全部摊开按“连接、读数据、断开”这条主线整理基本上照着 Demo 改 IP 就能在十五分钟内跑通第一行数据采集。2.3 开发语言怎么选FOCAS 官方原生 API 是 C 语言接口所有语言的调用底层都是走这套 C 接口。Windows 平台上C/C、C#、Python、Java 都可以调用Linux 平台上以 C/C 为主Python 通过 ctypes 调用 .so 也能实现。从项目维护角度来看我建议如果只是快速搭个验证 demo用 C# 最省事如果是正式生产环境、对性能和稳定性要求高用 C/C 更稳如果采集程序要集成到已有网关里Python 也很好调试。资料包里三种风格都给了示例但核心连接和读取逻辑是共通的。3. 从零跑通 FOCAS Demo3.1 机床侧的准备一定要先做对很多人拿到采集程序第一步就想着改代码实际上一大半连接不上的问题出在机床侧配置不对。FANUC 系统想要被 FOCAS 采集必须满足几个基础条件系统得有嵌入式以太网功能板卡现在绝大多数新系统都有机床得配置一个有效的 IP 地址和采集电脑在同一个局域网内系统参数里还得设置好端口号FOCAS 默认端口是 8193机床还必须开通 FOCAS 相关的功能选项否则 API 会直接拒绝连接。建议现场调试时先拿一根网线直连IP 配成同一网段比如机床 192.168.1.1电脑 192.168.1.2先排除交换机、防火墙等因素。我见过太多项目栽在“机床 IP 没设对”或者“直接插了普通网线但机床系统没启用以太网功能”这种问题上。3.2 Windows 环境跑通 DemoWindows 下开发 FOCAS 采集我推荐用 Visual Studio。库文件方面注意区分 fwlib32.dll 和 fwlib64.dll如果你编译的是 64 位程序必须对应 fwlib64.dll否则运行时会报“无法加载 DLL”。配置步骤很简单项目属性里把附加包含目录指向 FOCAS 头文件路径把附加库目录指向 Lib 文件夹然后在附加依赖项里加上对应的 .lib 文件。编译跑起来之后如果提示缺少 DLL把这个 DLL 复制到 exe 所在目录或者加入系统 PATH 即可。C# 版本更直接我在 Demo 里封装了一个 FocusFocas 类用 DllImport 引入 fwlib32.dll公开了 Connect、ReadPosition、ReadSpindle、Disconnect 等方法。做原型验证、给领导演示的时候非常方便。3.3 Linux 环境跑通 DemoLinux 下面的流程稍微绕一点。首先得确认系统有没有 32 位编译环境如果没有用 apt 或 yum 安装 gcc-multilib 之类的包。编译命令大概长这样gcc -m32 -o focas_demo focas_demo.c -I./include -L./lib -lfwlib32 -lpthread -ldl运行前还需要让系统找到 .so 文件两种情况任选其一把 libfwlib32.so 复制到 /usr/lib/ 或 /usr/local/lib/ 下执行 ldconfig或者启动脚本里设置export LD_LIBRARY_PATH./lib:$LD_LIBRARY_PATH。我实际用下来LD_LIBRARY_PATH 这种方式最灵活换库版本不用动系统。3.4 一个最小可用的连接测试不管 Windows 还是 Linux核心连接代码都是一样的。我贴一个 C 语言版本的极简示例#include stdio.h #include fwlib32.h int main() { unsigned short handle 0; long ret cnc_allclibhndl3(192.168.1.1, 8193, 10, handle); if (ret ! EW_OK) { printf(connect failed, ret%ld\n, ret); return -1; } printf(connect success, handle%d\n, handle); ODBPOS pos; ret cnc_rdposition(handle, 0, pos); if (ret EW_OK) { printf(axis num%d\n, pos.axis); for (int i 0; i pos.axis i MAX_AXIS; i) { printf(axis %d: %f\n, i, pos.pos[i].data); } } cnc_freehndl(handle); return 0; }这里 cn c_allclibhndl3 的第三个参数是超时时间秒我习惯设 10 秒。连不上时返回值是 -17也就是连接超时的错误码这个在后面的排查部分我会专门讲。4. 高频 API 调用与数据解析实战4.1 连接句柄的建立与释放FOCAS 所有操作都依赖一个句柄FlibHndl。这个句柄通过 cnc_allclibhndl3 建立连接后获得用完后必须通过 cnc_freehndl 释放。每个句柄对应一个独立的网络连接所以多台机床采集时每一台机床都要建立自己的句柄放到各自的线程里去轮询读取。这里有个容易忽略的细节cnc_allclibhndl3 的 port 参数传 0 表示使用系统默认端口 8193。如果你的系统自定义过端口需要和机床参数里的端口号保持一致否则连接会直接失败。实际项目里为了安全有人会把端口改掉这种情况下采集程序的配置项务必做成可配置的。4.2 坐标、主轴、程序状态读取读取坐标最常用的是 cnc_rdposition它有三个参数句柄、坐标系类型、输出结构体。坐标系类型 0 是相对坐标1 是机械坐标2 是绝对坐标3 是剩余移动量。项目里做位置定位和监控经常需要同时读机械坐标和绝对坐标建议把两种坐标系都取出来不要只读一种。主轴信息走 cnc_rdspindle输出结构体里包含主轴转速、实际主轴转速、主轴倍率、主轴负载。这里面主轴负载百分比是做设备 OEE 报警的关键数据比如负载持续超过 90% 可能意味着刀具磨损。程序状态用 cnc_rdprogram 和 cnc_rdexecprog。前者读当前程序号和序列号后者读正在执行的程序块列表。读出来的程序号是整数对应系统中的程序编号 O0001、O1234 这种。有些现场的机床程序命名不规范建议结合宏变量 #100 之类的编号规则做二次映射。4.3 报警与 PMC 数据报警读取用 cnc_rdalm它返回当前所有激活报警的列表每个报警包括报警号和报警文本。报警号本身很有用但更关键的可能是报警发生的时间点。我建议采集程序在记录报警时同时记录本机时间戳不要依赖机床内部时间因为有些老系统的内部时间校准并不准确。PMC 数据是 FOCAS 的进阶玩法。通过 cnc_rdpmc/cnc_wrpmc 可以读写 PMC 地址这就能拿到很多系统 API 不直接暴露的信号比如机床的开关门信号、液压站压力信号、机械手准备就绪信号。我做过一个自动线项目机械手是否到位完全靠 PMC 地址 G 标志位判断这比光电传感器可靠得多。宏变量 cnc_rdmacro/cnc_wrmacro 则是更通用的数据交换通道很多机加程序会把加工数量、当前刀具寿命写入宏变量采集程序直接读就行。4.4 老系统与新系统的采集差异FANUC 系统从 0i-C、0i-D 到 0i-F再到 16i/18i/30i 系列API 名称和结构体基本兼容但细节上有不少差异。最明显的差异是坐标轴数0i 系列通常 3-4 轴30i 系列可能有 5 轴甚至更多轴读取位置时结构体里的 axis 字段会返回实际轴数程序要做数组越界保护。另一个差异是数据刷新速度。新系统0i-F、30iB 之后的以太网响应更快我测试过 500ms 采集周期下数据非常稳定。老系统比如 0i-C如果采集频率太密容易出现读不到或超时的情况。对于老系统我建议采集周期放宽到 1 秒以上减少对机床 PLC 的干扰。5. 常见问题排查与避坑清单5.1 连接 -17 错误的完整排查开发过程中最多的报错就是 cnc_allclibhndl3 返回 -17代表连接超时。我的排查顺序是先 ping 机床 IP看网络通不通再确认端口是否正确可以从电脑上 telnet 一下 8193 端口然后确认机床系统里有没有开通 FOCAS 功能选项最后确认系统版本和库版本是否兼容。很多情况下问题不在代码而在机床参数根本没打开服务。分享一个实战经验我遇到过一个机床IP 能 ping 通端口也通但连接就是超时。最后发现是系统参数里把 FOCAS 的访问权限设成了只读并且没有打开 CTL 可执行权导致握手阶段没通过。所以排查时不要把眼光只放在程序侧机床操作面板上的参数页面也要逐项核对。5.2 库版本位数与系统兼容性Windows 平台最容易犯的错是 DLL 位数不匹配。64 位系统上编译 64 位程序结果误用 fwlib32.dll一运行就报“试图加载格式不正确的程序”。我一般建议直接把解决方案平台设成 x64然后把 fwlib64.dll 放到输出目录简单粗暴不出错。Linux 平台上旧版本 FOCAS 库在主板较新的机器上可能存在链接符号缺失的问题编译时加 -ldl、-lpthread 能解决大部分链接错误。如果遇到段错误或软件莫名崩溃优先检查是否为 32 位兼容库缺失不要着急改代码。5.3 多台设备并发采集的线程设计采集程序一旦上了量比如同时采 30 台机床线程模型就很重要。FOCAS 的 API 本身是同步阻塞的一个句柄在一个线程里调用没问题但千万不要在多个线程里共享同一个句柄否则会出现数据错乱或程序崩溃。我的设计习惯是每台机床一个独立线程线程里按固定周期轮询自己那台机床的句柄数据写库单独一个队列采集线程只负责把数据 push 到内存队列入库逻辑由另一组消费线程处理避免写数据库耗时影响采集节奏。30 台机床的规模下这种架构非常稳。5.4 一次困扰我很久的宏变量读写问题最后说一个我踩了很久的坑。写宏变量时要仔细看系统的宏变量数量范围比如有些系统只开了 #100-#199 用于公共宏#500 以上的保持型宏变量需要额外许可。我用 cnc_wrmacro 往 #700 写值一直返回错误码 16后来看手册才发现是系统没打开保持型宏变量写入权限而不是代码问题。这个小问题给了我一个很大的教训读 FOCAS 返回的错误码时别只想着代码逻辑权限类错误大概率在机床侧找答案。权限开启后同一套代码立刻就跑通了。这种问题最容易在项目验收阶段困住人提前在合同中写清楚权限责任能少很多扯皮。本文还有配套的精品资源点击获取 FANUC FOCAS数据采集实战：Windows/Linux环境搭建与核心API调用详解
简介本资源是一套面向工业自动化工程师、智能制造系统集成人员及数控设备运维开发者的Fanuc FOCAS机床数据采集实战资料包聚焦解决CNC设备联网监控、实时状态获取与生产数据解析等核心问题。压缩包共含多个文件以PDF技术文档、跨平台Windows/Linux可运行Demo工程、FOCAS API调用示例代码含C#/Python等语言、配置指南及数据解析说明为主整体大小为28.36MB结构清晰便于按需查阅与快速部署。已有389人学习下载内容覆盖从环境搭建、协议通信、报警信息读取到刀具寿命监控等典型应用场景特别包含安全连接配置与常见通信故障排查要点显著降低FOCAS二次开发门槛助力用户高效构建本地化机床数据采集系统。 做机床数据采集这些年我最大的感受就是FANUC 系统的 FOCAS 库资料和示例代码才是真正的门槛。很多人不是不懂需求而是卡在“资料太散、demo 太少、Windows 和 Linux 两套环境还得各踩一遍坑”这个阶段。所以我把自己整理过的 FOCAS 采集资料和 Demo 打包分享出来了Windows 和 Linux 都支持省得大家再去翻那几百页英文 PDF 和逛各种老外论坛。这篇内容就当是资料包的使用说明书我会把 FOCAS 采集的技术原理、系统选型、环境搭建、核心 API 调用、常见报错排查一次讲透。适合做 MES、SCADA、设备数据采集看板、刀具寿命管理的开发者也适合工厂设备科想自己搞数据采集的工程师。只要车间里是 FANUC 的 0i、16i、18i、30i 系列系统这套方法论基本通用。1. FOCAS 采集到底是怎么回事1.1 先搞清楚 FOCAS 是什么FOCAS 的全称是 FANUC Open CNC API Specifications翻译过来就是“FANUC 开放式数控系统 API 规范”。它是 FANUC 官方提供给第三方开发者的一套开发接口让外部软件能够通过网络或板卡和机床进行数据交互。你可以把它理解成一个“翻译官”——MES 系统、采集程序问它要数据它再去和 CNC 系统底层沟通拿到坐标、主轴负载、报警信息之后以结构体的形式交还给你。FOCAS 能解决的问题非常明确市面上绝大多数 FANUC 系统都不是封闭的黑盒子只要你拿到授权、连对接口就能实时读取机床运行数据。这就是为什么国内做设备数据采集的项目只要是 FANUC 系统的机床基本都绕不开 FOCAS。它也支持远程上送程序、写入宏变量、修改 PMC 地址等操作这些在自动化和柔性线里尤其有用。1.2 FOCAS1 和 FOCAS2 怎么选很多人刚接触 FOCAS 时会困惑为什么资料里一会儿说 FOCAS1一会儿说 FOCAS2。其实区分很简单FOCAS1 走以太网通信FOCAS2 走 HSSB 高速串行总线板卡通信。对比项FOCAS1FOCAS2通信方式以太网 TCP/IPHSSB 专用板卡线缆距离可达百米级适合车间联网通常几米内板卡直连采集速率常规 500ms 以上足够稳定可做到更高频率适合高速采集部署成本低机床联网即可高需要安装板卡和光缆适用场景绝大多数车间采集项目高频振动监控、伺服数据深度分析从我接触的项目来看90% 以上的场景选 FOCAS1 就够了。车间里拉网线、机床配置 IP采集程序通过网络连接稳定性和便利性都很不错。FOCAS2 那套板卡方案除非你要求几十毫秒级的高频采样否则没必要上。1.3 能采到什么、能写到什么FOCAS 能采集的数据可以分为几大类坐标位置相对坐标、绝对坐标、机械坐标、主轴信息转速、负载、倍率、进给信息实际进给速度、进给倍率、程序信息当前程序号、正在执行的程序段号、运行模式自动、手动、MDI 等、报警信息当前报警号、报警文本、宏变量、PMC 地址开关门信号、夹具信号、刀具号等、系统状态运行时间、加工时间、待机时间。能写的操作也很有价值写宏变量例如把测量结果写入#600号变量、写 PMC 地址例如远程输出一个排屑信号、上传/下载加工程序、执行系统的一些控制指令。但也要注意边界FOCAS 只能访问官方 API 暴露出来的数据系统内部有些私有数据、未公开地址、非 FANUC 品牌设备的数据是拿不到的。另外FOCAS 的写操作是有权限限制的部分系统需要在功能选项中开通对应权限否则写入会报错。这一点后面在实操部分我会详细说。2. 我这套资料的整理思路2.1 为什么 Windows 和 Linux 必须都覆盖这个项目最初只有一个需求方用的 Windows 工控机做采集所以我只写了 Windows 版的 Demo。后面项目一扩展产线边缘服务器要上 Linux很多工厂边缘计算节点都是 CentOS 或者 Ubuntu上面跑 Docker采集服务就必须跨平台。于是我专门把 Linux 版本的库和 Demo 也补齐了。同样的代码逻辑Windows 下用 DLLLinux 下用 .so 和 .a 静态库接口参数完全一致。唯一麻烦的是 Linux 版 FOCAS 库目前官方提供的大多是 32 位的 libfwlib32.so在 64 位系统上编译运行需要装 32 位兼容库或者用 -m32 参数编译你的采集程序。这点资料包里我写清楚了两种处理方式。2.2 资料包里都有什么我整理的 FOCAS 资料包内容包括官方 API 手册英文 PDF覆盖 FOCAS1/FOCAS2 全部函数说明、常用函数速查表把 cnc_allclibhndl3、cnc_rdposition、cnc_rdspindle 这类高频函数单独摘出来注明参数含义、Windows 版 DemoC/C 和 C# 两个版本、Linux 版 DemoC 语言版本带 Makefile、编译运行常见问题汇总、以及我自己验证过的连接测试工具源码。很多人拿到官方 SDK 后最大的困境是“不知道从哪个函数入口开始”。我这份资料把这些内容全部摊开按“连接、读数据、断开”这条主线整理基本上照着 Demo 改 IP 就能在十五分钟内跑通第一行数据采集。2.3 开发语言怎么选FOCAS 官方原生 API 是 C 语言接口所有语言的调用底层都是走这套 C 接口。Windows 平台上C/C、C#、Python、Java 都可以调用Linux 平台上以 C/C 为主Python 通过 ctypes 调用 .so 也能实现。从项目维护角度来看我建议如果只是快速搭个验证 demo用 C# 最省事如果是正式生产环境、对性能和稳定性要求高用 C/C 更稳如果采集程序要集成到已有网关里Python 也很好调试。资料包里三种风格都给了示例但核心连接和读取逻辑是共通的。3. 从零跑通 FOCAS Demo3.1 机床侧的准备一定要先做对很多人拿到采集程序第一步就想着改代码实际上一大半连接不上的问题出在机床侧配置不对。FANUC 系统想要被 FOCAS 采集必须满足几个基础条件系统得有嵌入式以太网功能板卡现在绝大多数新系统都有机床得配置一个有效的 IP 地址和采集电脑在同一个局域网内系统参数里还得设置好端口号FOCAS 默认端口是 8193机床还必须开通 FOCAS 相关的功能选项否则 API 会直接拒绝连接。建议现场调试时先拿一根网线直连IP 配成同一网段比如机床 192.168.1.1电脑 192.168.1.2先排除交换机、防火墙等因素。我见过太多项目栽在“机床 IP 没设对”或者“直接插了普通网线但机床系统没启用以太网功能”这种问题上。3.2 Windows 环境跑通 DemoWindows 下开发 FOCAS 采集我推荐用 Visual Studio。库文件方面注意区分 fwlib32.dll 和 fwlib64.dll如果你编译的是 64 位程序必须对应 fwlib64.dll否则运行时会报“无法加载 DLL”。配置步骤很简单项目属性里把附加包含目录指向 FOCAS 头文件路径把附加库目录指向 Lib 文件夹然后在附加依赖项里加上对应的 .lib 文件。编译跑起来之后如果提示缺少 DLL把这个 DLL 复制到 exe 所在目录或者加入系统 PATH 即可。C# 版本更直接我在 Demo 里封装了一个 FocusFocas 类用 DllImport 引入 fwlib32.dll公开了 Connect、ReadPosition、ReadSpindle、Disconnect 等方法。做原型验证、给领导演示的时候非常方便。3.3 Linux 环境跑通 DemoLinux 下面的流程稍微绕一点。首先得确认系统有没有 32 位编译环境如果没有用 apt 或 yum 安装 gcc-multilib 之类的包。编译命令大概长这样gcc -m32 -o focas_demo focas_demo.c -I./include -L./lib -lfwlib32 -lpthread -ldl运行前还需要让系统找到 .so 文件两种情况任选其一把 libfwlib32.so 复制到 /usr/lib/ 或 /usr/local/lib/ 下执行 ldconfig或者启动脚本里设置export LD_LIBRARY_PATH./lib:$LD_LIBRARY_PATH。我实际用下来LD_LIBRARY_PATH 这种方式最灵活换库版本不用动系统。3.4 一个最小可用的连接测试不管 Windows 还是 Linux核心连接代码都是一样的。我贴一个 C 语言版本的极简示例#include stdio.h #include fwlib32.h int main() { unsigned short handle 0; long ret cnc_allclibhndl3(192.168.1.1, 8193, 10, handle); if (ret ! EW_OK) { printf(connect failed, ret%ld\n, ret); return -1; } printf(connect success, handle%d\n, handle); ODBPOS pos; ret cnc_rdposition(handle, 0, pos); if (ret EW_OK) { printf(axis num%d\n, pos.axis); for (int i 0; i pos.axis i MAX_AXIS; i) { printf(axis %d: %f\n, i, pos.pos[i].data); } } cnc_freehndl(handle); return 0; }这里 cn c_allclibhndl3 的第三个参数是超时时间秒我习惯设 10 秒。连不上时返回值是 -17也就是连接超时的错误码这个在后面的排查部分我会专门讲。4. 高频 API 调用与数据解析实战4.1 连接句柄的建立与释放FOCAS 所有操作都依赖一个句柄FlibHndl。这个句柄通过 cnc_allclibhndl3 建立连接后获得用完后必须通过 cnc_freehndl 释放。每个句柄对应一个独立的网络连接所以多台机床采集时每一台机床都要建立自己的句柄放到各自的线程里去轮询读取。这里有个容易忽略的细节cnc_allclibhndl3 的 port 参数传 0 表示使用系统默认端口 8193。如果你的系统自定义过端口需要和机床参数里的端口号保持一致否则连接会直接失败。实际项目里为了安全有人会把端口改掉这种情况下采集程序的配置项务必做成可配置的。4.2 坐标、主轴、程序状态读取读取坐标最常用的是 cnc_rdposition它有三个参数句柄、坐标系类型、输出结构体。坐标系类型 0 是相对坐标1 是机械坐标2 是绝对坐标3 是剩余移动量。项目里做位置定位和监控经常需要同时读机械坐标和绝对坐标建议把两种坐标系都取出来不要只读一种。主轴信息走 cnc_rdspindle输出结构体里包含主轴转速、实际主轴转速、主轴倍率、主轴负载。这里面主轴负载百分比是做设备 OEE 报警的关键数据比如负载持续超过 90% 可能意味着刀具磨损。程序状态用 cnc_rdprogram 和 cnc_rdexecprog。前者读当前程序号和序列号后者读正在执行的程序块列表。读出来的程序号是整数对应系统中的程序编号 O0001、O1234 这种。有些现场的机床程序命名不规范建议结合宏变量 #100 之类的编号规则做二次映射。4.3 报警与 PMC 数据报警读取用 cnc_rdalm它返回当前所有激活报警的列表每个报警包括报警号和报警文本。报警号本身很有用但更关键的可能是报警发生的时间点。我建议采集程序在记录报警时同时记录本机时间戳不要依赖机床内部时间因为有些老系统的内部时间校准并不准确。PMC 数据是 FOCAS 的进阶玩法。通过 cnc_rdpmc/cnc_wrpmc 可以读写 PMC 地址这就能拿到很多系统 API 不直接暴露的信号比如机床的开关门信号、液压站压力信号、机械手准备就绪信号。我做过一个自动线项目机械手是否到位完全靠 PMC 地址 G 标志位判断这比光电传感器可靠得多。宏变量 cnc_rdmacro/cnc_wrmacro 则是更通用的数据交换通道很多机加程序会把加工数量、当前刀具寿命写入宏变量采集程序直接读就行。4.4 老系统与新系统的采集差异FANUC 系统从 0i-C、0i-D 到 0i-F再到 16i/18i/30i 系列API 名称和结构体基本兼容但细节上有不少差异。最明显的差异是坐标轴数0i 系列通常 3-4 轴30i 系列可能有 5 轴甚至更多轴读取位置时结构体里的 axis 字段会返回实际轴数程序要做数组越界保护。另一个差异是数据刷新速度。新系统0i-F、30iB 之后的以太网响应更快我测试过 500ms 采集周期下数据非常稳定。老系统比如 0i-C如果采集频率太密容易出现读不到或超时的情况。对于老系统我建议采集周期放宽到 1 秒以上减少对机床 PLC 的干扰。5. 常见问题排查与避坑清单5.1 连接 -17 错误的完整排查开发过程中最多的报错就是 cnc_allclibhndl3 返回 -17代表连接超时。我的排查顺序是先 ping 机床 IP看网络通不通再确认端口是否正确可以从电脑上 telnet 一下 8193 端口然后确认机床系统里有没有开通 FOCAS 功能选项最后确认系统版本和库版本是否兼容。很多情况下问题不在代码而在机床参数根本没打开服务。分享一个实战经验我遇到过一个机床IP 能 ping 通端口也通但连接就是超时。最后发现是系统参数里把 FOCAS 的访问权限设成了只读并且没有打开 CTL 可执行权导致握手阶段没通过。所以排查时不要把眼光只放在程序侧机床操作面板上的参数页面也要逐项核对。5.2 库版本位数与系统兼容性Windows 平台最容易犯的错是 DLL 位数不匹配。64 位系统上编译 64 位程序结果误用 fwlib32.dll一运行就报“试图加载格式不正确的程序”。我一般建议直接把解决方案平台设成 x64然后把 fwlib64.dll 放到输出目录简单粗暴不出错。Linux 平台上旧版本 FOCAS 库在主板较新的机器上可能存在链接符号缺失的问题编译时加 -ldl、-lpthread 能解决大部分链接错误。如果遇到段错误或软件莫名崩溃优先检查是否为 32 位兼容库缺失不要着急改代码。5.3 多台设备并发采集的线程设计采集程序一旦上了量比如同时采 30 台机床线程模型就很重要。FOCAS 的 API 本身是同步阻塞的一个句柄在一个线程里调用没问题但千万不要在多个线程里共享同一个句柄否则会出现数据错乱或程序崩溃。我的设计习惯是每台机床一个独立线程线程里按固定周期轮询自己那台机床的句柄数据写库单独一个队列采集线程只负责把数据 push 到内存队列入库逻辑由另一组消费线程处理避免写数据库耗时影响采集节奏。30 台机床的规模下这种架构非常稳。5.4 一次困扰我很久的宏变量读写问题最后说一个我踩了很久的坑。写宏变量时要仔细看系统的宏变量数量范围比如有些系统只开了 #100-#199 用于公共宏#500 以上的保持型宏变量需要额外许可。我用 cnc_wrmacro 往 #700 写值一直返回错误码 16后来看手册才发现是系统没打开保持型宏变量写入权限而不是代码问题。这个小问题给了我一个很大的教训读 FOCAS 返回的错误码时别只想着代码逻辑权限类错误大概率在机床侧找答案。权限开启后同一套代码立刻就跑通了。这种问题最容易在项目验收阶段困住人提前在合同中写清楚权限责任能少很多扯皮。本文还有配套的精品资源点击获取