cc-mek-scada RTU 设计解析:用函数引用实现通用 I/O 设备驱动的 5 个实用技巧

原创2026-11-12 13:55:381,630 阅读

cc-mek-scada RTU 设计解析:用函数引用实现通用 I/O 设备驱动的 5 个实用技巧

cc-mek-scada 是一个运行在 Minecraft(ComputerCraft)中的 SCADA 监控系统,用于集中控制多台 Mekanism 裂变反应堆及其配套设施。它的 RTU(Remote Terminal Unit,远程终端单元)模块最值得一提的设计,就是用 Lua 函数引用实现通用 I/O 设备驱动:RTU 不关心背后是锅炉还是涡轮机,它只认"寄存器地址 + 函数引用"这一套抽象。本文带你拆解这个机制,并总结 5 个可以直接借鉴的技巧。

什么是 RTU?为什么需要"通用 I/O 驱动"

在 cc-mek-scada 的架构里,RTU 扮演的是"边缘节点"角色:它挂载在一台 Advanced Computer 上,把各种外围设备(锅炉、涡轮机、SPS、红石接口等)通过类 MODBUS 协议暴露给上层的 Supervisor(监护计算机)统一管理,一台计算机即可同时代理多台 RTU。

问题在于:设备种类繁多,但上位机只说一种"语言"——MODBUS 的四种寄存器。传统做法是为每种设备写一套协议处理逻辑,代码会迅速失控。cc-mek-scada 的答案是:把每个 I/O 点"绑定"到一个函数引用上,协议层从此与具体设备完全解耦。

四种寄存器与驱动绑定的对应关系:

MODBUS 寄存器类型 语义 绑定的函数引用
Discrete Inputs 单比特只读 1 个读函数
Coils 单比特读写 读 + 写各 1 个
Input Registers 多比特只读 1 个读函数
Holding Registers 多比特读写 读 + 写各 1 个

术语对照可参见项目 README 的 ComputerCraft Architecture 与 Communications 小节。

核心机制:函数引用如何变成"寄存器"

一切从 rtu/rtu.lua 的 rtu.init_unit(device) 开始。它创建 4 个空数组(对应四类寄存器),并提供一组 connect_* 方法把函数"挂"上去。其中真正把"设备函数"和"寄存器"焊接起来的是 _as_func:

local function _as_func(f)
    if type(f) == "string" then
        local name = f
        if device then
            f = function (...) return devicename end
        else f = stub end
    end
    return f
end

来源:rtu/rtu.lua

短短几行,它接受两种入参:函数对象原样通过;字符串则包装成一个闭包,每次调用时动态去 device 上按名字取函数。之后 connect_input_reg("getTemperature") 这类调用(见 rtu/dev/boilerv_rtu.lua)就完成了一个 I/O 点的注册:

  • 读:read_input_reg(addr) 按地址取出自定义函数并调用(rtu/rtu.lua)
  • 计数:io_count() 缓存各类型寄存器数量,供协议层做越界检查

5 个实用技巧

技巧 1:传字符串函数名,实现"动态晚绑定"

最简单的写法是只给一个函数名字符串:

unit.connect_di("isFormed")
unit.connect_input_reg("getFlowRate")

由于闭包内部每次调用都执行 device<a href="https://link.gitcode.com/i/b1523fd4ff3a7728039491ecca6e3c88" target="_blank">name],这是典型的动态晚绑定。它在 Mekanism 多块结构(multiblock)场景下至关重要:结构未成型时,设备对象上根本没有 getFlowRate 这类函数;成型后 PPM 层的元表魔法(__index 惰性发现,见 [scada-common/ppm.lua)会自动把新出现的函数补上并套上保护壳——而字符串绑定无需重新注册,"下一个读请求"自然就能取到函数。这也是 rtu/threads.lua 中设备热重挂载(remount)时能无缝切换新旧设备引用、闭包始终指向最新设备的关键。

技巧 2:直接传函数对象,完成"静态早绑定"

如果调用时设备状态已知,也可以直接把受保护的函数对象传过去,例如 SNA(太阳中子活化器)驱动(rtu/dev/sna_rtu.lua):

unit.connect_input_reg(sna.getInputCapacity)
unit.connect_input_reg(sna.getProductionRate)

这里 sna 是 PPM 层包装过的设备对象,sna.getInputCapacity 本身已经是一个带故障保护的函数引用。早绑定少一层字符串查找,还能在连接后立即探测故障(如 rtu/dev/sna_rtu.lua 中通过 __p_is_faulted() 判断)。

技巧 3:用匿名闭包"改写"读写语义

当设备 API 与 MODBUS 语义对不上时,闭包是最佳适配层。涡轮机驱动(rtu/dev/turbinev_rtu.lua)用两个无参函数表达"步进"式的线圈:

unit.connect_coil(function () turbine.incrementDumpingMode() end, function () end)
unit.connect_coil(function () turbine.decrementDumpingMode() end, function () end)

而"读值 + 写值"的组合也常由闭包拼装,如 rtu/dev/turbinev_rtu.lua 中用 "getDumpingMode" / "setDumpingMode" 这对函数名绑定一个 Holding Register。红石驱动(rtu/dev/redstone_rtu.lua)则更典型:link_di/link_do/link_ai/link_ao 按端口、颜色、是否反相在连接时刻生成带参数的闭包,每个物理端口对应一组独立的函数引用——用闭包捕获 side、color、invert,让"每个 I/O 点一个驱动实例"成为自然结果。

技巧 4:寄存器地址统一寻址,让协议层"设备无关"

协议层 rtu/modbus.lua 的 modbus.new(rtu_dev, ...) 只接收一个通用的 rtu_device 接口:先 rtu_dev.io_count() 做范围校验,再循环 rtu_dev.read_coil(addr) 等按地址取值(rtu/modbus.lua),完全不知道背后是锅炉、SNA 还是红石端口。更妙的是它支持把每个读任务塞进 parallel.waitForAll 并行执行,读取一串寄存器时吞吐量立刻上来。

每个设备单元在 rtu/uinit.lua 完成注册:按外设类型分派到对应驱动的 new(device),再包一层 modbus.new(rtu_iface, true) 并配一条专属消息队列(rtu/uinit.lua)。协议、寻址、并发全部通用化,设备差异被压缩到一行行 connect_* 调用里。

技巧 5:让设备故障顺着函数引用安全返回

Minecraft 的周边调用可能随时抛错(设备断开、结构拆掉……)。PPM 层(scada-common/ppm.lua)把所有设备函数替换成 pcall 保护壳,出错时置位故障标志而不是崩溃;init_unit 则把故障探测函数也"引用化":_is_faulted = device.__p_is_faulted(rtu/rtu.lua)。于是每次 read_*/write_* 都会多返回一个故障布尔值,MODBUS 层将其翻译为标准异常码 SERVER_DEVICE_FAIL(rtu/modbus.lua),上位机收到的是规范的错误应答而非整个 RTU 宕机。故障信息沿着"函数引用"这条链路一路安全地传到了协议层。

完整数据链路:一个读请求的旅程

  1. 上位机发来 MODBUS 报文,RTU 主线程按 unit_id 查表,校验后压入该单元的 pkt_queue(rtu/rtu.lua);队列超过 3 个未处理事务则直接回复"设备忙"
  2. 每单元独享的通信线程(rtu/threads.lua)取出报文,调用 unit.modbus_io.handle_adu(msg.message)
  3. MODBUS 层按功能码选择 _1_read_coils / _4_read_input_registers 等处理器,按地址调用 rtu_dev.read_*(addr)
  4. 函数引用真正执行——比如 turbine.getFlowRate(),PPM 保护壳兜底
  5. 返回值与故障标志打包成应答帧发回

整条链路里,"设备是什么"只在第 4 步出现一次,其余环节全部通用——这正是函数引用驱动的最终价值。

动手实践:3 步接入一个新设备

🔧 如果你要扩展 cc-mek-scada 支持新外设,模板已经现成:

  1. 新建驱动文件:仿照 rtu/dev/boilerv_rtu.lua 写一个 xxx_rtu.new(device),内部调用 rtu.init_unit(device) + 若干 connect_*,返回 unit.interface()
  2. 注册设备类型:在 rtu/uinit.lua 的类型分派分支里加上你的外设类型,调用新驱动生成 rtu_iface
  3. 热挂载支持:如需支持设备热插拔,在 rtu/threads.lua 的 handle_unit_mount 中补一个对应分支,重连时重新 new(device) 即可

得益于"字符串函数名 = 晚绑定"的设计,多块结构类设备在成型前后都能自然工作,不需要额外的状态机。

小结

cc-mek-scada 的 RTU 用一个极轻量的机制解决了"一对多"设备适配问题:寄存器地址负责寻址,函数引用负责执行,闭包负责语义适配,PPM 层负责故障隔离。这套"地址 + 函数引用"的模式不限于游戏开发——任何需要让通用协议层对接多种硬件抽象的场景(网关、BACnet 转换、IoT 桥接),都可以直接借鉴这 5 个技巧。

登录后查看全文
cc-mek-scada