如何用 80 行 Lua 搞定组件间通信:cc-mek-scada 中 PSIL 发布-订阅数据互联层完整解析
如何用 80 行 Lua 搞定组件间通信:cc-mek-scada 中 PSIL 发布-订阅数据互联层完整解析
cc-mek-scada 是一套运行在 Minecraft ComputerCraft 上的 SCADA 监控系统,用于多台 Mekanism 裂变反应堆的集中控制、安全联锁与废物处理。这套系统由 Supervisor(监控计算机)、Coordinator(协调/HMI 服务器)、RTU 与 PLC 多台计算机协作完成,而把它们解耦粘合在一起的核心,就是一个只有 90 行的发布-订阅(Publish-Subscribe,简称 Pub/Sub)实现——PSIL(Publisher-Subscriber Interconnect Layer)。
📌 核心关键词:Lua 发布-订阅模式、cc-mek-scada psil、SCADA 数据互联
一、为什么 SCADA 系统需要发布-订阅模式?
传统"点对点"通信中,发送方必须知道每个接收方是谁,导致代码互相引用、难以扩展。发布-订阅模式用一块共享总线解耦了两者:
- 发布者(Publisher):只管把数据发到某个"键"(key)上,不知道谁在听
- 订阅者(Subscriber):声明"我关心某个键",数据变化时自动收到回调
PSIL 正是这样一个轻量总线:一个字符串键对应一组订阅函数和一份缓存值。在 cc-mek-scada 中,硬件状态、会话心跳、UI 指示灯刷新全部走这条总线。
二、PSIL 数据结构:一张表 + 闭包,极简设计
打开 scada-common/psil.lua,整个"总线"就是一个普通 Lua 表 ic:
local ic = {} -- 结构:{ [key] = { subscribers = { ... }, value = 任何值 } }
- 每个键按需分配(
alloc函数),值为{ subscribers = {}, value = nil } - 所有 API 通过闭包共享这张表,因此
psil.create()每次调用都会产生相互隔离的独立实例——这正是多反应堆系统的关键设计:每台设备拥有自己的数据域,互不串扰
💡 这种"工厂函数 + 闭包"的写法在单线程 Lua 里天然无竞争,无需加锁,非常适合 ComputerCraft 的协程环境。
三、核心 API 逐个拆解
PSIL 对外只暴露 6 个方法(见 scada-common/psil.lua),全部语义清晰:
1. subscribe(key, func):订阅并立即同步一次
function public.subscribe(key, func)
if ic[key] == nil then
alloc(key)
elseif ic[key].value ~= nil then
func(ic[key].value) -- 已有缓存值时,立刻回调一次
end
table.insert(ic[key].subscribers, { notify = func })
end
两个值得注意的细节:
- 键可"懒加载":订阅一个从未发布过的键也不会报错,自动分配
- 订阅即同步:如果该键已有值,回调立刻执行一次,订阅者无需再手动
get,杜绝了"订阅早于发布"导致的首帧丢失问题
2. publish(key, value):带变化检测的发布
if ic[key].value ~= value then
ic[key].value = value
for i = 1, #ic[key].subscribers do
ic[key].subscribers[i].notify(value)
end
end
~= 比较意味着相同值不会重复触发回调。在每秒多次轮询传感器值的 SCADA 场景中,这个"去重"直接省掉了大量无意义的 UI 重绘,是性能优化的第一道闸。
3. toggle(key):布尔翻转专用
ic[key].value = ic[key].value == false
专为心跳信号这类布尔闪烁指示器设计(各组件中的 databus.heartbeat() 都调用它,如 supervisor/databus.lua)。订阅者无需自己维护状态,每次通知必然携带翻转后的新值。
4. get(key) / purge() / unsubscribe(key, func)
get:UI 初始化时直接读取当前值(Coordinator 面板启动时就用它显示固件版本,见 coordinator/ui/layout/front_panel.lua)unsubscribe:借助 scada-common/util.lua 的filter_table按函数引用精确移除订阅,防止 UI 反复重建导致回调泄漏purge:一键清空整条总线,用于会话重置
四、PSIL 在 cc-mek-scada 中的三大实战场景
场景 1:每台计算机一条"数据总线"(databus)
Supervisor、RTU、Reactor PLC 三套组件都用 PSIL 做中央总线(supervisor/databus.lua、rtu/databus.lua、reactor-plc/databus.lua)。以 Supervisor 为例:
- 网络会话层发现 PLC 连接后,调用
databus.tx_plc_connected()发布plc_1_fw、plc_1_conn、plc_1_rtt等键 - 前端面板 LED 只订阅这些键,完全不需要知道网络层如何工作
🎯 效果:网络代码、业务逻辑、显示界面三层彻底解耦,任意一层都可以独立测试。
场景 2:多实例隔离——一个反应堆一台"微型总线"
Coordinator 的 IO 控制器为每个物理设备创建独立 PSIL 实例:
- 全局面板总线:
fp = { ps = psil.create() }(coordinator/ioctl.lua) - 每个单元
unit_ps、每台锅炉/汽轮机boiler_ps_tbl/turbine_ps_tbl(coordinator/ioctl.lua)
命名键 plc_1_rtt 中的数字后缀 + 按设备分实例,双保险地避免了多设备数据互相覆盖。Pocket 掌机应用(pocket/ioctl.lua、pocket/ioctl.lua)采用完全相同的模式。
场景 3:UI 控件与总线的自动生命周期绑定
图形元素基类提供 register 方法(graphics/element.lua):
function public.register(ps, key, func)
table.insert(self.subscriptions, { ps = ps, key = key, func = func })
ps.subscribe(key, func)
end
控件销毁时会自动 unsubscribe,开发者不需要手动管理订阅生命周期。Coordinator 面板中大量 LED 指示灯靠它一行代码接入总线(coordinator/ui/layout/front_panel.lua);Pocket 主界面则直接订阅连接质量键来驱动信号强度条(pocket/ui/main.lua)。
项目还内置了一个调试工具 test/watch_psil_allocs.lua,统计各总线上的订阅数量,帮助排查"订阅了但没解绑"的内存泄漏。
五、PSIL 适合什么场景?(适用边界)
✅ 推荐使用的场景
| 场景 | 原因 |
|---|---|
| 单线程/协程程序的 UI 数据刷新 | 无并发问题,回调即渲染 |
| 高频轮询 + 变化量小的传感器数据 | 内置去重,避免无效重绘 |
| 设备状态与显示逻辑解耦 | 发布者零耦合,便于独立测试 |
| 多设备系统的数据域隔离 | create() 天然产生隔离实例 |
⚠️ 不太适合的场景
- 跨进程/跨机器通信:PSIL 只存在于单个 Lua 环境内,跨机通信需配合 cc-mek-scada 的 modbus 协议层(scada-common/comms.lua)
- 需要历史数据或事件回放:PSIL 只保留最新值,不存消息队列
- 复杂消息(多字段结构化载荷):建议像项目一样拆成多个单值键(
plc_1_fw、plc_1_rtt),而不是发一个大表
六、总结:从 90 行代码能学到什么
PSIL 是 Lua 发布-订阅模式的一个教科书级精简实现,它的四条经验可以直接搬进你的项目:
- 一张表 + 闭包就够了,不必引入框架
- 订阅即同步 + 发布去重,两条规则消灭绝大多数"首次回调丢失/重复刷新"bug
- 工厂函数多实例,比单例更适合多设备隔离
- 用封装的
register绑定 UI 生命周期,让订阅自动清理
如果你想进一步学习,建议按顺序阅读:scada-common/psil.lua(核心实现)→ supervisor/databus.lua(总线用法)→ coordinator/ui/layout/front_panel.lua(UI 订阅全貌),三个文件合计不到 500 行,是理解"Pub/Sub 如何撑起一整套分布式监控系统"的最佳路径。🚀