接口命名从信号语义出发
GR-Edge接入将目标采集、背景参考、时间、供电与维护通路分别标识。逻辑通道名称说明数据来源和用途,物理端口标识说明插座、导线及接线位置;工程人员使用对应设备版本的接线资料完成两者映射。CAN、Modbus、MQTT及API等对外协议按各自接口说明接入,不以名称相近代替协议核对。
从采样线束到事件报告
接口在现场往往经历三次“翻译”:探头接线被标记为采集通道,采集样本附上时间,软件再按窗口组织成一份解释报告。若这三步复用含混名称,例如把“信号一”用于目标轴又用于参考探头,维护人员可能把失联或干扰误认为车辆事件。
约定名称时必须有方向与来源:例如设计层写“目标测量输入”和“参考测量输入”,而不把 reference 定义成已证实的“噪声真值”。参考探头只是另一个观测位置,它会受到不同的近场源影响,其价值依赖布设和同步。
逻辑通道与物理端口的界限
GR-Edge交付设备按“逻辑信号→插座位号→导线编号→固件通道”核对接线映射,随设备与配置版本保存。CSV列名、报告字段和物理插座属于不同层级,不相互充当端口定义。变更接线或配置时,同步核对图纸、设备版本和日志名称;具体针脚、电气参数及接线方法使用对应交付资料。
分析模块接口与异常状态
| 层级 | 命名对象 | 核对内容 |
|---|---|---|
| 采集通道 | 目标测量 / 背景参考 / 时间源 | 来源、方向、单位及时间同步 |
| 物理连接 | 插座位号 / 导线编号 / 固件通道 | 对应设备版本的接线映射与电气参数 |
| 事件与报告 | 设备号 / 事件号 / 报告号与修订 | 事件关联、状态含义及版本 |
| 对外协议 | CAN / Modbus / MQTT / SDK与API | 各协议的权限、字段、数据方向和回执 |
测量位置与OPM读出链
车库磁源示意解释不同通道会受到哪些空间场源影响,原子自旋图说明磁测元件的基本读出原理。接口名称与接线应以文字和实际工程定义为准,原理图不能替代GR-Edge板卡引脚图。
软件字段、硬件规划与科学依据
硬件接线资料定义物理连接,协议文档定义对外交换,事件与报告文档定义数据语义。外部OPM原理资料用于理解感测与补偿,不定义GR-Edge板卡针脚或接口电气参数。安装和联调分别核对这三层资料,保持采集、报告与通信状态一致。
版本化映射表和延伸阅读
每个名称同时记录生成方、单位或数据类型、有效条件和失败编码。接线标签、日志键名与图表图例沿用对应版本的同一映射;更换设备、固件或接口版本时,核对映射后再恢复连接。