open-smart-grid-platform

OSGP：把电网设备协议栈收敛成一个中间层

项目背景与痛点

在配电网和城市照明这类场景里，一个运维方往往同时面对几十种设备：不同厂商的智能电表、路灯控制器、变电站 RTU、分布式电源网关。它们各自说自己的话——OSLP、DLMS/COSEM、IEC 61850、MQTT、私有串口协议。业务系统每接入一个新厂商，就要重写一套适配代码、一套鉴权和一套审计逻辑，最后演变成几十个小系统互相复制粘贴。

OSGP（Open Smart Grid Platform）的出发点正是把这份重复劳动收束到一层：向下屏蔽协议差异，向上提供统一的设备管理、命令下发和事件回传能力。这个仓库本身是一次"合并重构"——把原先分散的 Shared、Platform、三个协议适配器和集成测试仓全部并进来，说明维护方已经意识到：协议适配器和核心平台必须作为一个整体演进，否则接口版本永远对不上。

核心技术揭秘

架构上它是一套典型的分层微服务：最上层是 Web Service 层（同时暴露 SOAP 和 REST，服务对象是 MDM、SCADA、市政管理系统这类后端），中间是 Core 业务模块（设备管理、设备安装、智能电表抄读、费率切换、公共照明、微电网、固件管理），最下层是由独立进程部署的协议适配器。Core 与适配器之间不直接调用，而是通过 JMS（ActiveMQ）做异步命令投递与响应回写。

真正的设计精髓在于 DeviceFunction 抽象：设备注册时不是在数据库里挂一个协议地址，而是绑定"设备标识 + 功能类型 + 所属组织"三元组。Core 只认识"给这台设备执行开关灯""读这台表的 15 分钟负荷曲线"这种领域动作，至于动作如何翻译成 61850 的 MMS 报文还是 OSLP 帧，完全是适配器的职责。这让功能寻址与协议彻底解耦，一个物理设备可以同时挂多个功能，也可以换适配器而不动业务代码。

命令链路是一个显式状态机：新建 → 已投递 → 成功 / 失败 / 被拒 / 超时。每条命令带关联 ID、超时时间和重试上限，适配器收到后自行完成协议编解码、报文签名、等待应答或等待异步事件。超时和死信会被回收，最终落到设备日志表里形成可追溯的执行档案。

安全性是这套系统最不"玩具"的部分。OSLP 源自 IEC 62056 的 DLMS 体系，通信层用 AES 加密并配合报文签名与序列号防重放，每台设备持有独立密钥；平台侧则有组织级租户隔离和功能级授权，命令在落库前要过一遍合法性校验。这套模型是给"抄表指令被伪造会直接造成经济损失"的场景设计的，不是物联网 Demo 的思维。

功能亮点与差异

对比常见的 IoT 平台（ThingsBoard、AWS IoT Core 这类），OSGP 的差异点很鲜明：

• 协议不是外挂，是原生一等公民。多数平台把 MQTT 当默认通道，其他协议靠桥接；OSGP 的适配器有独立的部署、队列和生命周期，适合"现场已经装满老设备"的存量改造。
• 设备安装流程有完整设计。设备注册不是手工填表，而是包含随机码/标识校验的受控流程，这对防止设备冒名接入很关键。
• 面向电网语义而非传感器语义。它内置的是费率切换、照明场景调度、微电网能量管理这些行业动作，而不是通用的"上报遥测点"。
• 生产级审计与日志。命令、事件、设备响应三者可关联，出问题能定位到具体某一帧。

应用场景与落地建议

最适合三条线：城市照明的集中控制与能耗统计、配电网侧的智能电表批量抄读与需求响应、变电站 IEC 61850 设备的统一接入。这些场景的共同特征是设备存量大、协议杂、对可靠性和审计有硬要求。

落地要注意几点。其一，技术栈偏传统（Java + Spring + Hibernate + PostgreSQL + ActiveMQ + Tomcat 部署 war），云原生支持很弱，容器化需要自己补；其二，适配器是独立进程，部署拓扑必须提前规划网络分区和队列容量；其三，接入新厂商协议本质上是要写一个新的适配器模块，工程量不小，评估时别把它当成"配置项"；其四，这个仓库的实际演进已经在社区分叉后由 GXF 承接，选型时要确认你追的是哪条线，避免踩到停更分支。

建议先用路灯这类低速、低风险、可回滚的设备做试点，跑通命令状态机和日志链路，再往电表和配电设备推进。

综合评价

优点：分层干净，协议适配器的边界切得非常准；DeviceFunction 这个抽象足以支撑多年演进；安全模型是按电网生产环境设计的，不是事后补丁；有荷兰真实电网的规模背书，不是实验室产物。

缺点：技术栈明显老化，构建和多模块依赖偏重；文档以厂商交付文档为主，社区向的入门材料零散；OSLP 的色彩太浓，脱离荷兰电表生态后适配成本陡增；云原生、可观测性这些现代基础设施基本缺席。

一句话：它是一份优秀的"设备协议中间层"参考架构，也是能真正跑在生产上的系统，但更像一座结构扎实的老建筑——想住进去，得自己重做水电。