feat: 完成 issue #3 边缘采集网关模板化封装

- 点位字典 CSV schema/加载/自动校验(缺失字段/量纲/重复点号,PRD 5.1)
- 协议可插拔只读驱动:OPC UA(S7-1200 适配)/S7/Modbus/称重/能源/模拟
- 周期采集引擎:只读+背压保护+健康度指标(丢失率/P99/可用性)
- Kafka 流式上行 + 本地 spool 断点续传(丢失率≤0.02% 保障)
- 模板配置外置(gateway.yaml + 点位字典 CSV),换行业零改码
- 18 个单元测试全绿;端到端运行 SLA 达标
This commit is contained in:
2026-08-04 15:32:16 +08:00
parent 21c6259739
commit f49c0920d4
27 changed files with 1806 additions and 0 deletions
@@ -0,0 +1,45 @@
# -*- coding: utf-8 -*-
"""称重终端驱动 —— 化工/树脂行业称重仪参数化适配。
多数称重仪表走串口(连续输出 / 命令应答)或 Modbus TCP;
本驱动作为模板封装:优先按配置走 Modbus(复用 ModbusDriver),
若配置指定 `mode: serial` 则走串口协议(需现场协议文档,由子类定制)。
"""
from __future__ import annotations
from typing import Dict, List, Optional
from point_dict.loader import Point
from .base import Driver, SampleValue
from .modbus_driver import ModbusDriver
class WeighingDriver(Driver):
"""称重终端只读采集驱动(参数化适配)。"""
protocol = "weighing"
def __init__(self, config: Optional[dict] = None):
super().__init__(config)
self.mode: str = self.config.get("mode", "modbus") # modbus | serial
self._delegate: Optional[Driver] = None
def connect(self) -> None:
if self.mode == "modbus":
# 称重仪表普遍支持 Modbus RTU/TCP,复用 ModbusDriver 参数化实现
self._delegate = ModbusDriver(self.config)
else:
raise ConnectionError(
"称重驱动 serial 模式需要现场协议文档支持,请实现子类或改用 modbus 模式"
)
self._delegate.connect()
def read_points(self, points: List[Point]) -> Dict[str, SampleValue]:
if self._delegate is None:
raise ConnectionError("称重驱动未连接,请先 connect()")
return self._delegate.read_points(points)
def close(self) -> None:
if self._delegate is not None:
self._delegate.close()
self._delegate = None