简介面向工业自动化开发者的 OMRON CJ2M PLC 与 C# 上位机通信源代码资源包围绕 FINS 协议讲解如何通过 .NET4.0 平台实现对 CJ2M 的数据读写与状态监控适合需要编写上位机通信程序或进行设备联调的工程师参考。压缩包共 165 个文件、约 15.74MB以 C# 源码18 个 cs、C 头文件与源文件16 个 h、11 个 cpp为主另含 9 个 dll、5 个 exe、演示工程及配置文件可看到 FINS 协议类库、接口互操作层、输出处理和 demo 演示等模块划分。目前已有 252 人学习下载。通过运行 demo 并结合源码读者可快速理解 FINS 指令的封装与解析、寄存器读写流程、异常处理及与硬件联调的方法并能将其中的通信接口直接复用到生产线监控、设备参数远程调整或报警采集等项目中节省从零调试协议的时间。1. 拿到 OMRON CJ2M.rar 之后先别急着双击解压拿到一个名为 OMRON CJ2M.rar 的压缩包通常是三种场景设备厂商做项目交付、二手设备交接、或者产线上老工程师离职前留下的最后一个版本。CJ2M 是欧姆龙 CJ 系列里的紧凑型 PLC在包装机械、橡胶机械、小型装配线上存量很大十年前的老设备到今天还有大量在产运行。这个 rar 里装的不是固件也不是编程软件安装包而是 CX-Programmer 工程文件、IO 表备份、符号表导出以及可能存在的图纸和文档。直接右键解压再“打开工程”不是不行但你会漏掉最有用的信息包是什么时候打的、用哪个 CX-One 版本、有没有加密、IO 表是否和现场硬件一致。下面按一条真实工程交付的路径展开先拆包看内容再选对软件版本打开核对符号表和通信参数最后做完整性验证。适合要接手旧设备维护的电气工程师、做设备改造的乙方以及需要把散落各地的归档工程纳入版本管理的团队。2. CJ2M 归档压缩包的文件构成与软件版本匹配2.1 CJ2M.rar 里常见的文件类型与处理建议解压后最常见的是一个 .cxp 文件这是 CX-Programmer 的工程主文件梯形图、符号表、IO 表、PLC 设置、注释全部封装在里面。同名的 .opt 是个人界面配置记录窗口布局、配色和快捷键谁打开都会重新生成删掉不影响程序。真正容易被忽略的是 .iop它是 IO 表备份用于“新建工程后导入 IO 表”如果现场机架和这份备份不一致直接导入会把单元号分配弄乱。扩展名典型内容处理建议.cxp工程主文件梯形图、符号表、IO 表、PLC 设置、注释只读打开保留原件.optCX-Programmer 界面配置可删除不影响程序.iopIO 表备份核对现场硬件后再加载.csv / .xls符号表、D 区初值清单导出用于审计和批量回填.pdf梯形图打印件、接线图、操作说明存档备查以纸质签收为准还有一种常见情况压缩包里只有一个 .cxp没有 .opt 也没有 .iop。这通常是用“从 PLC 传送”时只勾了程序区IO 表和 PLC 设置没被带出来。这种包能打开但通信参数和单元配置都是空的处理方式见第 3.2 节。另外归档包里可能同时躺着好几个 .cxp比如2020_备份和2020_最终两个目录。交接时永远以 PLC 里实际运行的程序为准不要凭文件名猜。文件名里带 final、backup、old 的先比修改时间再比文件大小最后用第 5.2 节的比较功能收口。2.2 CX-Programmer 版本与 CJ2M 的匹配规则CJ2M 从发布到现在跨越了 CX-One 多个大版本匹配规则只有一条老版本打不开新工程高版本打开老工程基本无障碍。报“工程版本高于当前 CX-Programmer 版本”时不要去改文件头正确做法是升级 CX-One或者换一台装了新版软件的电脑。实际交接里 CX-One 4.x 打开十年前的老工程没有任何问题具体从哪个版本开始支持 CJ2M以你手头 CX-One 的版本说明为准。打开工程时如果提示“是否转换为当前版本”我的习惯是先复制一份原件用副本打开。转换后另存为新格式文件不要覆盖原文件名。高版本工程被降级保存时部分新指令会被替换或丢弃再次编译前必须对比一次编译结果。工程管理机上最好装两个版本的 CX-One一个是现场在用的老版本用于兼容性验证一个是主力版本用于日常维护。2.3 解压命令与中文文件名的坑Windows 直接右键解压最省事但交接验收时我习惯用命令行因为能留日志。CJ2M 的归档多来自日企和国内厂商文件名经常是 GBK 编码在 Linux 上用 unrar 解压会出现乱码目录名这是老生常谈的坑。# 解压并保留完整目录结构-o 表示覆盖已存在文件-p 交互式输入密码 unrar x -o -p OMRON_CJ2M.rar /var/backup/cj2m/project/ # 7-Zip 方式-y 跳过确认注意 -o 后面直接跟路径不能有空格 7z x -y -o/var/backup/cj2m/project OMRON_CJ2M.rar # 先测试归档完整性不解压交接时最快的一步验收 unrar t OMRON_CJ2M.rar参数说明unrar 的x按压缩包内完整路径释放比e全部丢到当前目录更适合工程目录结构-o遇到同名文件直接覆盖建议配合一个干净的副本目录使用。7z 的-o参数后不能加空格这是它和大多数 Linux 工具不同的地方。t是 test 模式只校验文件头和 CRC几分钟就能确认 rar 在传输过程中有没有损坏所以顺序永远是先t后x。提示如果压缩包本身有密码且交接文档里没写先找设备厂商要。厂商打包的 rar 密钥强度不是字典能撞出来的不要浪费时间在暴力破解上。3. 用 CX-Programmer 打开并还原 CJ2M 项目3.1 打开 .cxp 时弹出的每一类警告怎么处理双击 .cxp 后CX-Programmer 会按顺序弹出几类窗口不要一路点“确定”。每一类弹窗对应的处理方式完全不同误操作轻则打不开重则污染原工程。弹窗类型含义处理方式工程版本转换高版本工程在低版本软件中打开取消换高版本软件CPU 单元型号不匹配归档设定的 CPU 型号与当前工程不一致右键 PLC 节点改 CPU 型号密码输入工程密码或 UM 读取保护找原工程师要拿不到就放弃数据一致性警告IO 表或符号表存在手工修改痕迹打开后立即另存重新编译重点说 CPU 型号不匹配。CJ2M 的 CPU11/13/14/15 和 CPU31/32/33/34 在指令组上基本一致差异主要在是否自带 EtherNet/IP 网口和内置 I/O 点数。把 CPU15 的工程改成 CPU13 打开时CX-Programmer 提示转换后必须核对 IO 表里内置 I/O 的 CIO 地址。CPU13 占用的字比 CPU15 少程序里引用到超出部分的地址编译器会当未定义处理报错位置往往离真正的根因很远。工程密码是另一个高频卡点。项目开发阶段设的密码通常会写在交付文档里找不到密码时正规路径是让原工程师解除保护或提供只读版。欧姆龙没有公开的取回工具拿到加密文件就去研究破解既不合规也大概率无果。如果 PLC 侧没设 UM 读取保护还有一条路不打开 .cxp直接用第 3.2 节的在线上传方式把程序读出来。3.2 只有 .iop 备份时用在线传送从 CJ2M 读回程序归档包里偶尔只有 .iop 和图纸程序本体没放进来。只要 PLC 还在通电、串口参数没被改乱就能在线读回。CJ2M 正面有一个外围端口物理上是 RS-232C 电平用原装电缆或确认过引脚定义的转接线连接电脑。操作路径新建工程选对 CPU 型号然后 PLC → 工作在线 → PLC → 传送 → 从 PLC 传送。具体步骤新建一个同 CPU 型号的空工程。型号选错会导致地址分配全部错位。串口连接对话框里选对 COM 口波特率默认 38400拿不准就勾“自动检测”。在线后先看 PLC → 错误日志ERR/ALM 灯闪的原因通常是电池电压低或单元异常先拍照记录。PLC → 传送 → 从 PLC 传送勾选程序、IO 表、PLC 设置三项。符号表和注释是否勾选看需求它们本来就在本地工程里勾了会被上传内容覆盖。注意从 PLC 传送是覆盖操作不是合并。上传前先把本地工程另存一份副本避免读回来的程序和旧版本混在一起。上传完成后 CX-Programmer 会弹出对比结果确认程序区一致后立刻另存文件名带上日期和 PLC 序列号后四位。这一步很多人会省导致三个月后分不清哪份才是现场实际运行的程序。读回来的程序默认没有符号表注释全丢这是正常现象不是传输失败。3.3 符号表和 D 区初值怎么回填如果归档里只有符号表 CSV 没有 .cxp回填有两种方式新建工程后在工程树的符号节点上右键导入或者先导入 IO 表再导入符号。导入 CSV 最容易栽在编码上——CX-Programmer 在简体中文系统下导出的 CSV 是 ANSI/GBK用 UTF-8 环境直接导入中文注释会全部乱码。先用文本编辑器转成 ANSI 再导入。导入前先做一遍地址查重比导入后等编译报错高效得多# 检查符号表 CSV 中是否有重复地址 # 列顺序假设为名称, 地址, 数据类型, 注释按实际导出格式调整 import csv from collections import defaultdict addr_map defaultdict(list) with open(symbols.csv, encodinggbk) as f: for row in csv.reader(f): if not row or len(row) 2: continue name, addr row[0].strip(), row[1].strip() if addr: addr_map[addr].append(name) for addr, names in addr_map.items(): if len(names) 1: print(f重复地址 {addr}: {, .join(names)})逻辑说明符号表导入 CX-Programmer 时同一个 CIO 地址被两个符号占用旧版本会静默替换导致一堆编译过了但逻辑对不上的隐患。这段脚本按地址聚合把所有一址多名的情况列出来导入前就能处理干净。D 区初值清单用同样思路处理抽出地址列和值列后先扫一遍地址是否落在 CJ2M 的 D 区范围内越界的标红再通过 PLC → 记忆体组件里的初始化表批量导入。4. CJ2M 项目的关键参数与四个高频坑4.1 IO 表、单元号与内置 I/O 的地址占用CJ2M 项目里物理输入输出、特殊 IO 单元、CPU 总线单元各自占用不同的 CIO 字区分配关系写在 IO 表里和梯形图本身是两回事。梯形图里最常见的引用是字.位形式比如0.00是 CPU 单元内置输入的第一位W10.01是工作区的一个位。接手归档工程后第一件事是把 IO 表展开截图或者导出成文本标注现场每个槽位的实际模块型号。区域书写形式示例典型范围断电后行为CIO0.00 / CIO 20000000 至 6143 字取决于 IOM 保持位WW0.00 / W100W000 至 W511取决于 IOM 保持位HH0.00 / H100H000 至 H511保持DD0 / D12345D00000 至 D32767取决于 IOM 保持位AA0.00 / A500A000 至 A959系统定义具体型号的边界以 CX-Programmer 的 PLC → 信息页面为准上表是 CJ2M 系列最常见的一组范围。D 区越界是归档工程里的隐性炸弹编译阶段不报错运行映射到非法区域才有反应# 从地址清单里找出 D 区越界的行 # 假设 address_list.txt 每行一个地址形如 D12345 或 W010 grep -E ^D[0-9] address_list.txt | awk -FD { if ($2 0 32767) print 越界:, $0 }这个命令把以 D 开头且后面跟数字的行筛出来用$20强制把字符串转成数字再和 32767 比较。awk 里直接比字符串会把D9999排在D20000后面加0就是为了避免这种文本比较的坑。单元号冲突是 CJ 系列最典型的新手坑。特殊 IO 单元和 CPU 总线单元在机架上的槽位决定单元号单元号直接决定它在 CIO 区的偏移。归档里 IO 表和现场硬件不一致时最常见的现象是输入点全乱按了按钮动作的是另一台气缸。4.2 串口、FINS 节点与内置 EtherNet/IP 的参数核对CJ2M 的串口有两类用途连接编程软件或者跑 Host Link / FINS 协议做上位通信。通信参数全部存在 PLC 设置里归档工程打开后要重点核对以下几项。参数常见默认值影响波特率38400外围端口/ 9600Host Link改错后无法在线连接数据位 / 停止位7/2 或 8/1必须与上位机一致校验方式偶校验 / 无校验与上位机一致FINS 节点号1 至 127上位机通信的目标节点串口模式Host Link / FINS / 无协议决定上位机用哪套指令CPU31/32/33/34 自带 EtherNet/IP 网口FINS 节点号常见做法是勾选“节点号自动生成”此时节点号等于 IP 地址最后一组比如 192.168.1.50 的节点号就是 50。如果归档工程里手动改过节点号上位机组态里也要同步改否则 FINS 命令直接超时。注意CJ2M 的通信参数是上电时加载的修改后必须断电重启才生效。在线改完点确定连接的电脑会立刻掉线这只是通信中断不代表设置已经生效。4.3 高速计数器、中断与脉冲输出相关的 PLC 设置CJ2M CPU 单元是否集成高速计数、支持几路、频率上限取决于具体 CPU 型号和输出形式继电器还是晶体管以选型样本为准。这类功能不能像普通输入那样直接读要现在 PLC 设置里把对应输入点定义为高速计数模式再指定计数类型递增、加减计数、相位差和复位方式当前值会映射到固定的 CIO 字梯形图直接读那个字。三个必查项计数模式改完必须断电重启否则计数器不更新。中断子程序编号要在 CX-Programmer 里和输入中断号绑定归档工程经常出现子程序还在、绑定关系丢失的情况。之前的工程师可能在设置里试验过又删掉的功能残留的计数模式会和实际接线不符。打开“内置输入设置”截图保存到现场逐点核对。4.4 老工程归档里最常见的四个坑IOM 保持位被关掉。D 区和 CIO/WR 断电后清零HR 不受影响。设备重启后参数全部回零点程序却完好无损十有八九是这个位被动过位置在 PLC 设置里的“IOM 保持”选项。电池没电。CJ2M 的程序靠电池保持电池电压低时 ALM 灯闪烁继续放下去程序会整体丢失。拿到归档工程后第一件事在 PLC → 信息里看电池电压和程序容量。符号表和实际地址不一致。老工程师习惯直接用地址写梯形图符号表是后来补的。遇到注释和地址对不上的归档以梯形图里的直接地址为准不要迷信符号表。本地保存覆盖了现场版本。改完程序直接断电没传送CX-Programmer 本地已经存了改过的版本现场实际跑的却是旧程序。这种差异只有通过第 5.2 节的比较功能才能确认。5. 不用开 PLC 也能验证归档完整性的三个办法5.1 接收归档时先用校验命令过一遍# rar 完整性和内容的双检查t 测试文件头v 列出详细文件清单 unrar t OMRON_CJ2M.rar unrar v OMRON_CJ2M.rar # 生成哈希交接双方各自比对防止传输过程被篡改或损坏 sha256sum OMRON_CJ2M.rar OMRON_CJ2M.rar.sha256t通过只代表 rar 结构完整。厂商批量打包的 rar 可能带恢复记录t的输出里能看到相关信息恢复记录越多对传输损坏的容忍度越高。交接时把 sha256 值写进验收单双方算出来一致再谈下一步这一分钟能省掉三个月后“程序是不是有问题”的扯皮。5.2 在 PLC 上电时用“与 PLC 比较”验证程序和设置第 4.4 节说过本地工程和现场实际程序可能不一致。连接 PLC 后PLC → 验证 → 与 PLC 比较CX-Programmer 会逐段对比程序、IO 表、PLC 设置不一致的地方列成清单。比较时把符号表和注释两个勾去掉——这两项不影响运行但老工程里几乎必定不一致勾上只会刷屏。更快的土办法比较前先看 PLC → 信息里的程序容量和下传时间。CJ2M 的信息页会显示最后一次程序传送时间如果这个时间和归档包的修改时间差了好几个月说明归档的九成是开发版而不是量产版直接按现场实际运行版重新归档。5.3 归档时顺手做成“一档三件套”再规范的交付也不要只留一个 .cxp。我一般会在 rar 里同时放三样东西工程主文件 .cxp、符号表 CSV 导出、D 区初值清单外加一份梯形图 PDF 打印件给不会装 CX-One 的现场维护人员看。# 重新打包时的目录结构 # cj2m_archive/ # OMRON_CJ2M.cxp # symbols.csv # dm_init.csv # 梯形图_20240115.pdf # -m5 是最高压缩比符号表这类文本文件压缩率接近极限体积不重要 rar a -m5 OMRON_CJ2M_20240115.rar cj2m_archive/符号表和 D 区清单用第 3.3 节的脚本先扫一遍重复地址和越界地址确认干净后再打包。打包完成后立刻生成 sha256 文件放在同一目录别人拿到手先验哈希再unrar t最后按第 2.3 节的顺序解压整套交接就再也不会出现“解压出来打不开”这种最浪费时间的故障。本文还有配套的精品资源点击获取