OpenPLC_v3runtime软PLC实战：编译运行与Modbus联调

简介OpenPLC_v3-master项目是一套面向工业自动化开发者以及可编程逻辑控制器工程师的开源运行环境其核心部分能够支持在普通个人电脑或服务器上模拟、编写与调试控制程序无需依赖特定硬件设备即可验证逻辑显著节省开发成本。压缩包内共有2769个文件大小约11.71MB以C和C系列源代码为主体同时也包含Java、C#、Scala等语言实现以及文本说明文档目录结构围绕运行时、构建配置与调试工具等进行组织。目前已有501人学习或下载既适合初学者理解IEC 61131-3标准中梯形图、结构化文本、顺序功能图等语言的实现方式也适合工程师评估开源控制方案。资源内含完整项目源码、自动构建脚本、示例及测试程序并涉及编译器、调试器与模拟器相关实现可支撑二次开发、课程实验或工业自动化项目预研整包模块清晰便于按需检索与深入学习。1. OpenPLC_v3runtime不碰真实 PLC 硬件也能把整条控制逻辑跑通OpenPLC_v3-master 这个开源项目核心是 OpenPLC_v3runtime——一套完全开源的 PLC 运行时环境。它把「PLC」从专用硬件里解放出来在普通 Linux 机器、树莓派甚至 ARM 开发板上就能运行 IEC 61131-3 标准程序写梯形图、结构化文本、功能块图编译上传后立即执行循环扫描再通过 Modbus 跟外部设备通信。对刚入门的从业者这是成本最低的学习路径对老手它可以当软 PLC 做原型验证、离线调试和小规模控制实验。我拆完这个包最深的感受是它不是一个仿真玩具而是把 PLC 的扫描周期、输入输出映射、通信协议全部摊开在你面前让你能看见 PLC 内部到底在怎么干活。下面从架构、编译、写程序到踩坑一条线讲完。2. 运行时架构拆解configure.ac 与 Makefile.am 里藏着哪些门道2.1 OpenPLC v3 的核心分层Web 管理面、编译桥与执行引擎OpenPLC_v3runtime 不是你想象中那种「读代码、模拟执行」的玩具解释器。它的执行模型和真实 PLC 一致程序被编译成机器码然后在一个固定扫描周期里反复执行「读输入 → 跑逻辑 → 写输出」这三步。整个运行时可以拆成三个层面来看。第一层是 Web 管理面运行后默认监听 8080 端口浏览器里能上传程序、监控变量、启停 PLC 会话。我在实际用的时候基本把它当成一个内嵌的调试面板比串口工具直观得多。第二层是编译桥。OpenPLC 的编辑器OpenPLC Editor负责把梯形图、结构化文本这类高级语言翻译成中间代码再由本机的 gcc 编译成可执行逻辑最后和运行时内部的一段胶水代码glue链接。第三层是执行引擎它维护一张输入输出变量表每个扫描周期按顺序求值同时把外部 Modbus 请求映射到这张表上。理解这个分层有个直接好处当你遇到「程序上传成功但输出不动」这类问题你会知道该去查编译桥代码有没有生成 C 文件、执行引擎PLC 有没有真正启动还是通信层Modbus 映射有没有对而不是瞎改逻辑。2.2 从 configure.ac 看依赖与构建门道项目根目录和 core 目录下有一堆 configure.ac 和 Makefile.am这属于 autotools 体系的典型布局。configure.ac 是构建系统的源头里面用 AC_INIT 声明项目信息用 AC_CHECK_LIB、AC_CHECK_HEADERS 检查本机有没有 libmodbus、sqlite 这些依赖Makefile.am 则按模块列出要编译的源文件比如 core 下的主程序、通信驱动和胶水代码。这里有一个新手最容易翻车的点从网上下载的源码包通常只带 configure.ac 和 Makefile.am不会带生成好的 configure 脚本。如果你直接敲 ./configure系统会告诉你文件不存在。必须先跑一遍 autoreconf让 autotools 根据 configure.ac 生成 configure再根据 Makefile.am 生成 Makefile.inconfigure 最终把 Makefile.in 展开成真正的 Makefile。cd OpenPLC_v3-master/core autoreconf -i -f ./configure --prefix/usr/local make -j$(nproc) sudo make install逻辑说明autoreconf 的作用是从 configure.ac 反向生成整套构建文件-i 表示缺失的辅助文件自动补齐-f 强制覆盖旧的生成物。configure 负责探测当前系统的编译器和库--prefix 指定安装路径。make -j 并行编译能省时间但依赖关系复杂时偶尔会出问题遇到莫名报错就退回 make 单线程试一次。参数说明--prefix 不写默认装到 /usr/local如果你的系统严格区分 /usr 和 /usr/local 的 PATH装完之后可能要手动 export PATH另外如果机器上没有 libmodbusconfigure 会直接报 missing dependency这时候先补基础包再回来重跑。sudo apt update sudo apt install -y build-essential autoconf automake libtool \ libmodbus-dev sqlite3 libsqlite3-dev逻辑说明build-essential 提供 gcc/g/makeautoconf、automake、libtool 是 autotools 全家桶libmodbus-dev 是 Modbus RTU/ASCII 通信库的运行依赖。装完这些configure 里的 AC_CHECK_LIB 检查基本能一次通过。2.3 IEC 61131-3 的五个语言入口与编译链路OpenPLC v3 对 IEC 61131-3 标准的支持覆盖了五种语言梯形图 LD、结构化文本 ST、功能块图 FBD、顺序功能图 SFC 和指令表 IL。编辑器会把它们统一翻译成编译器的中间表示最终落到 C 代码。这意味着你选哪种语言不影响运行时的执行效率因为跑起来都是同一套编译产物。我个人的经验是ST 最值得优先掌握。梯形图直观但一旦逻辑复杂连线和块会变得很难维护ST 是文本语言能用变量名、函数块和结构化语法把控制逻辑写清楚而且差异最小。后面第四章我会用一个完整的 ST 例子演示全流程。顺带说一个多数人不知道的细节OpenPLC 的编译桥输出的是 C 代码运行时通过胶水函数把这些代码里的变量和 PLC 输入输出地址绑起来。所以你在编辑器里看到的 %IX0.0、%QX0.0 这类地址最终会对应到执行引擎维护的一张变量表上Modbus 请求也是打在这张表上。搞清楚这个映射是后面排错的关键。3. 在 Linux 上把 OpenPLC_v3runtime 跑起来编译参数与首次启动3.1 环境准备Ubuntu LTS 与依赖清单我习惯在 Ubuntu 20.04 或 22.04 LTS 上跑 OpenPLC内核稳定依赖也全。树莓派上我也试过编译时间会长一点但跑起来没问题。这里有两个前置条件容易忽略一是磁盘剩余空间至少留 2GB编译过程中 gcc 的临时文件很占地方二是如果之后要对外监听 Modbus 502 端口openplc 进程需要 root 权限或者对应端口授权。还有一个玄学点某些最小化安装的服务器镜像是没有 locale 的编译过程中如果遇到奇怪的字符集警告先执行 export LC_ALLC.UTF-8 再继续这个问题在纯英文系统上从来不会出现但在中文环境里翻车概率不小。3.2 编译流程从 autoreconf 到 make install 的完整命令打开终端按顺序执行下面这段。注意每一步的返回信息configure 阶段如果打印 error 或 missing先解决再往前走不要硬着头皮 make。cd OpenPLC_v3-master/core autoreconf -i -f ./configure --prefix/usr/local make -j$(nproc) sudo make install逻辑说明第一行把 autoreconf 生成的辅助脚本补齐第二行 configure 探测系统能力并生成 Makefile第三行开始编译第四行把编译产物安装到系统路径。如果 make 中途报错优先看最后 20 行日志大部分是缺头文件或库版本对不上。参数说明make 的 -j 参数表示并行任务数$(nproc) 会自动取 CPU 核心数。我在一台 8 核机器上编译大约 3 分钟单核的树莓派可能要 10 分钟以上期间 CPU 风扇会起飞属正常现象。编译完可以验证一下产物ls -l core/openplc file core/openplc逻辑说明core/openplc 就是运行时主程序file 命令确认它是一个 ELF 可执行文件。看到这个文件说明编译链路已经打通接下来可以启动了。3.3 首次启动8080 管理界面与登录启动前先确认 8080 端口没被占用否则运行时同样会报 bind 失败。我一般这样检查ss -lntp | grep 8080逻辑说明如果没有任何输出说明端口空闲直接启动如果有输出说明被其他服务占了先处理占用进程或者换个端口v3 的 Web 端口在部分版本里可通过配置调整但默认固定 8080先以释放端口为主。启动方式cd OpenPLC_v3-master/core sudo ./openplc 逻辑说明sudo 是因为运行时可能要绑定 502 端口并提供原始套接字访问后台运行用 让它挂在终端后面。日志会直接打到当前终端像 Starting OpenPLC... Web server started on port 8080 这类字样出现就说明起来了。然后浏览器打开 http://localhost:8080默认账号密码是常见的 admin/openplc 组合首次登录后尽快在页面里改掉。登录进去会看到导航栏Program、PLC、Slave Devices 等。Program 页是编辑器入口PLC 页可以监控所有输入输出变量Slave Devices 页配置 Modbus 从站参数。首次跑通的标准动作是在硬件层选择 Simulator 模式这样不需要任何外部硬件纯软件环境就能执行逻辑。4. 用结构化文本写一个电机控制程序上传、编译、在线监控全流程4.1 梯形图与结构化文本的选型什么时候坚持用 ST梯形图对做电气出身的人非常友好继电器电路怎么画梯形图就怎么画。但我在项目里发现一个规律逻辑超过 20 行梯形图的维护成本会指数上升连线一多找断点就像在玩连连看。结构化文本的优势在于能用变量名、函数块和清晰的赋值语句表达同样的逻辑还能写注释出问题直接读代码就能定位。我的建议是交互简单、操作员要看的场景用梯形图逻辑复杂、需要复用和版本管理的场景用 ST。如果你要从这个项目里学东西ST 是理解 OpenPLC 执行模型的最短路径因为它和代码的对应关系最直接。4.2 电机启停控制一个带自锁和定时器的 ST 程序下面这个例子实现一个经典的电机启停控制启动按钮按下后电机保持运行自锁停止按钮按下后立即断开同时电机运行超过 3 秒后自动停止用于模拟过载保护逻辑。PROGRAM motor_control VAR start_btn AT %IX0.0 : BOOL; (* 启动按钮映射到输入位 *) stop_btn AT %IX0.1 : BOOL; (* 停止按钮 *) motor AT %QX0.0 : BOOL; (* 电机输出 *) timer_run : TON; (* 运行计时器 *) delay_s : TIME : T#3s; (* 超时时间 3 秒 *) END_VAR (* 调用 TON 计时器IN 为电机运行状态PT 为设定时长 *) timer_run(IN : motor, PT : delay_s); (* 自锁保持停止优先超时自动断开 *) motor : (motor OR start_btn) AND NOT stop_btn AND NOT timer_run.Q; END_PROGRAM逻辑说明TON 是 IEC 61131-3 标准里的接通延时定时器调用形式是 timer_run(IN : motor, PT : delay_s)IN 是使能输入PT 是设定时间Q 是输出当 IN 保持为真且时间到达后 Q 变为真。最后一行是自锁逻辑只要启动按钮按过motor 就保持为真停止按钮或超时信号一进来立即断开。AT 关键字把变量绑定到物理地址%IX0.0 表示输入第 0 字节第 0 位%QX0.0 是输出位。参数说明delay_s 设为 T#3s 表示 3 秒如果你想改 5 秒直接改成 T#5s 即可。地址编号从 0 开始这是 OpenPLC 的约定和 Modbus 寄存器地址的对应关系后面会专门讲这里先记住%IX 是输入、%QX 是输出、%IW 是输入寄存器、%QW 是输出寄存器。4.3 上传、编译与在线监控的完整操作在浏览器里打开 8080 页面的 Program 标签把上面的代码粘进编辑区。关键一步来了上传之前一定要先点页面里的 Stop PLC把运行中的 PLC 会话停掉否则上传会失败这是 v3 一个很让人困惑的设计。停止之后点 Compile Upload页面会显示编译日志看到类似 Compilation successful 的提示就说明 ST 代码已经被翻译成 C 并编译通过了。然后再点 Start PLC程序开始运行。这时候切到 PLC 页面能看到 %QX0.0 对应的复选框实时刷新如果你在页面里手动置位 %IX0.0 对应的输入电机输出会立刻变成真这就是软 PLC 的在线调试体验。有一点值得注意OpenPLC 的输入输出地址和 Modbus 地址有一个固定映射关系不是一一对应的直觉关系。我整理了一张表排错时对照着查PLC 绝对地址Modbus 线圈/寄存器映射%QX0.0 ~ %QX0.7Coils 0 ~ 7可写%IX0.0 ~ %IX0.7Coils 8 ~ 15只读%QW0 ~ %QW7Holding Registers 0 ~ 7可写%IW0 ~ %IW7Holding Registers 8 ~ 15只读表格说明OpenPLC 把 16 个线圈分成两段前 8 个对应输出位后 8 个对应输入位保持寄存器也是同样的分段逻辑。上位机如果按直觉去读线圈 0拿到的其实是 %QX0.0 的输出状态这个坑我在第五章里细说。5. 避坑指南OpenPLC_v3 运行时最常见的五个翻车现场5.1 坑一解压后直接 make报错说找不到 Makefile现象从网上下载的 OpenPLC_v3-master 压缩包解压后进入 core 目录直接执行 make系统提示 no Makefile or Makefile not found。原因这个项目用 autotools 管理构建仓库里只提交了 configure.ac 和 Makefile.am 这些源文件生成好的 configure 和 Makefile 不会提交。直接 make 等于跳过了生成步骤构建自然无法进行。解决先执行 autoreconf -i -f 生成 configure再执行 ./configure make。我后来养成的习惯是拿到任何 autotools 项目先看根目录有没有 configure 文件没有就先重生成省得浪费时间。5.2 坑二启动时报 bind 8080 失败浏览器怎么都打不开现象执行 sudo ./openplc 后终端打印类似 bind failed on port 8080 的报错浏览器访问 localhost:8080 一直转圈。原因8080 端口被其他进程占了比如你机器上跑着某个 Java 服务或者另一个 OpenPLC 实例。操作系统不允许两个进程绑定同一个端口运行时只能退出。解决用 ss -lntp | grep 8080 找到占用进程的 PID确认不是关键服务后杀掉再重新启动。如果 8080 确实被业务占用无法释放就检查当前版本是否支持修改 Web 端口配置不支持的话换一台机器或换个端口映射。5.3 坑三上传程序时提示 PLC 正在运行上传永远失败现象在 Program 页面写好代码点 Compile Upload页面提示无法上传或 The PLC is running代码没有生效。原因OpenPLC v3 的运行时会锁定当前装载的程序不允许在运行状态下覆盖。这是很多人都踩过的设计跟 IDE 里「保存后自动重启」的习惯完全不同。解决上传前先点 Stop PLC让运行时进入停止状态再 Compile Upload最后手动 Start PLC。从那以后我把「停止 → 上传 → 启动」当成固定三步再也没有因为这个浪费过时间。5.4 坑四Modbus 上位机读到的信号和监控页相反现象PLC 页面上 %QX0.0 明明是 ON但用 Modbus 调试工具读线圈 0 返回的是 0读线圈 8 反而拿到了 ON。原因OpenPLC 的 Modbus 映射不是按直觉排的。线圈 0~7 映射到 %QX0.0~%QX0.7线圈 8~15 才映射到 %IX0.0~%IX0.7。上位机想当然读线圈 0 拿输出方向就搞反了。另外很多 Modbus 工具显示地址从 1 开始而协议本身从 0 开始差了 1 个地址又是另一层混淆。解决严格按照第四章的映射表核对先用 Python 或 Modbus Poll 把 0~15 线圈全部扫一遍确认每个线圈对应的物理含义再写正式逻辑。这个坑属于典型的「协议没错人错了」的例子看起来玄学实际就是表没背熟。5.5 坑五改了 configure.ac 加了依赖重新 configure 却不生效现象给 configure.ac 里新增了 AC_CHECK_LIB 检查某个库重新跑 ./configure 时打印信息里完全没有新检查项链接阶段反而报 undefined reference。原因configure 是 autotools 根据 configure.ac 生成的产物改完 configure.ac 必须重新执行 autoreconf 才能更新 configure。只改源文件不重新生成等于改了需求没改实现。解决修改 configure.ac 后执行 autoreconf -i -f 强制重新生成再跑 configure。我后来把「改 configure.ac 之后第一件事就是 autoreconf」写进了自己的检查清单现在基本不会在这种低级问题上栽跟头。6. 把运行时当软 PLC 用Modbus 仿真、备份与心跳看门的进阶习惯6.1 用 Python 模拟 Modbus 上位机做联调真实现场里上位机通常用组态软件但联调阶段我更喜欢用 Python 脚本快速验证通信链路。from pymodbus.client import ModbusTcpClient client ModbusTcpClient(127.0.0.1, port502) client.write_coil(0, True) # 置位 %QX0.0 coils client.read_coils(0, 16) # 扫全量 16 个线圈 regs client.read_holding_registers(0, 16) print(coils:, coils.bits) print(regs:, regs.registers) client.close()逻辑说明脚本以 Modbus 主站身份连到 OpenPLC 运行时写线圈 0 相当于置位 %QX0.0读完 16 个线圈和 16 个保持寄存器就能核对映射关系。配合第四章的 ST 程序可以在不碰任何硬件的情况下验证整个闭环。参数说明端口固定 502 是 Modbus TCP 标准端口如果运行时没绑定成功先返回章节 3.3 检查权限。read_coils 第二个参数 16 表示连续读 16 个位bits 返回一个列表下标和线圈地址一一对应。6.2 上传前的数据库备份给自己留后悔药OpenPLC 的程序和配置存储在 core 目录下的 openplc.db 里每次上传新程序都会改写这个文件。我在反复调参的时候吃过亏一次上传了一个有问题的程序想回退到上一版发现旧代码已经没了。从那以后我每次上传前固定执行一次备份cp openplc.db openplc.db.$(date %Y%m%d_%H%M%S)逻辑说明把数据库复制一份带时间戳的备份出问题就把备份文件改回 openplc.db 再重启运行时。这个习惯成本极低但关键时候能救命属于花十秒钟买后悔药的典型做法。6.3 心跳看门程序让上位机知道你活着软 PLC 跑在生产环境里最怕的是运行时进程还活着但程序卡死上位机浑然不知。我习惯在程序里放一个心跳输出用定时器周期性翻转上位机只要发现心跳停了就立刻报警。PROGRAM heartbeat VAR tick : TON; hb_out AT %QX0.7 : BOOL; period : TIME : T#500ms; END_VAR (* 自复位定时器Q 翻转后让 IN 重新为真 *) tick(IN : NOT tick.Q, PT : period); hb_out : tick.Q; END_PROGRAM逻辑说明tick 的 IN 接自己 Q 的反相信号Q 每 500ms 翻转一次hb_out 跟着输出一个窄脉冲。上位机以 100ms 的轮询周期去读线圈 7能稳定看到电平跳变如果连续几个周期读不到变化基本可以判定运行异常。参数说明period 的 500ms 要根据上位机轮询周期调整轮询越快可以把时间设越短反之设长避免上位机漏掉窄脉冲误报警。跑完上面这些我对 OpenPLC 的用法已经心里有底。最后收个尾现在我每次拿到一个 autotools 项目第一件事就是确认 configure 是否已经生成每次上传 PLC 程序前强制走一遍「备份数据库 → 停 PLC → 上传 → 启动 → 看心跳」的流程这套习惯让我少踩了无数坑。希望帮到你。本文还有配套的精品资源点击获取