绑定状态

设备唯一 ID

资产Id（业务层编号）

IP 地址

端口

账号

密码

更新时间

使能电气报警功能

核心：电气报警值配置

电气额定值使能

电气额定值配置

使能上电状态配置（是否应用该默认状态）

上电后端口的默认状态

通道网络报警使能

通道网络报警策略

工作模式：电平模式 或 脉冲模式

触点逻辑极性配置 (针对 DI/DO)： 【关键状态映射说明】为了统一上层业务层的状态感知（0-没有/正常，1-有/报警/开）， 边缘网关/驱动层必须根据此配置对底层物理电平进行转换，再转换结果写入到 DeviceChannel.switch_state 中。 1. 对于 DI (数字输入 - 如传感器)： - logic_inverted = 1 (正逻辑，默认值，适用于常开型 NO 传感器): 底层物理电平断开(0) -> 映射为业务状态 switch_state = 0 (低电平) 底层物理电平闭合(1) -> 映射为业务状态 switch_state = 1 (高电平) - logic_inverted = 2 (反逻辑/取反，适用于常闭型 NC 传感器，如门磁、急停按钮): 底层物理电平断开(0) -> 映射为业务状态 switch_state = 1 (低电平) 底层物理电平闭合(1) -> 映射为业务状态 switch_state = 0 (高电平) 2. 对于 DO (数字输出 - 如继电器控制)： - logic_inverted = 1 (正逻辑): 业务下发 switch_state=1 -> 硬件输出高电平/吸合 - logic_inverted = 2 (反逻辑): 业务下发 switch_state=1 -> 硬件输出低电平/断开

【电平模式特有】上电初始状态：设备掉电重启后，DO 默认是开还是关

【DI 特有】防抖时间 (单位：毫秒)

【脉冲模式特有】时长 (单位：毫秒) 仅当 work_mode == WORK_MODE_PULSE 时生效

端口基础配置 (可读写) 端口管理状态 (是否在软件层面启用该端口)

数据通信配置与状态 [配置] 是否开启速率和双工的自动协商 (通常为 true)

[配置] 目标速率 (当 auto_negotiation_enable=false 时生效)

[配置] 目标双工模式 (当 auto_negotiation_enable=false 时生效)

[状态] 实际链路状态 (网线是否插上且连通)

[状态] 端口阻塞状态 (通常指由 STP 生成树协议或环路保护机制触发的逻辑阻断， 此时端口虽然物理 Link Up，但无法转发业务数据帧，用于防止网络环路)

[状态] 实际协商后的工作速率

[状态] 实际协商后的双工模式

POE 运行状态与遥测数据 (只读) [状态] POE 端口当前的工作状态

[状态] 与受电设备(PD)握手协商后的供电等级

[状态] CRC 校验错误累计，数值升高通常代表网线质量差、接触不良或环境干扰。 场景：排查“网络卡顿、丢包、摄像头画面花屏”的首要指标。如果该值不断增长，说明物理链路存在隐患（如网线太长、水晶头老化或强电干扰）。 交换芯片内部有一个专门的计数器（Counter Register），每检测到一个错误帧，该寄存器加 1。

[状态] 端口累计接收报文数，用于判断受电设备是否正在正常发送业务数据。 场景：用于“判断设备死机/假死”。即使 POE 供电正常、链路 Link Up，如果该计数器长时间不增长，说明受电设备（如 IP 电话或相机）系统可能卡死，无法发送业务数据，此时可触发 POE 远程重启。

--- 定位 (Where) --- 公用结构：定位到具体的板载模块

场景 A: 简单粗暴，查所有模块所有通道

场景 B: 精确指定查询目标

查什么 (可多选：例如同时查 SETTINGS 和 BINDING)

(可选) 更细粒度的属性过滤 如果只需要查 Settings 中的某几个特定字段，可以用 keys 过滤。为空代表查全部属性。

通道索引列表 仅当 TARGET_TYPE_CHANNEL_INDEX = "index" 时，此字段才生效。

--- 动作内容 --- 开/关/重启-控制

[已废弃] 模块类型 ，已废弃，由客户端自己区分辨是什么类型的模块

关键标识 如果是 ONBOARD：通常只有一个，或者用索引/SlotID 区分 (e.g., "0", "1") 如果是 DOWNSTREAM：必须提供 serial_number

控制目标的类型 当 control_target_type 为 TARGET_TYPE_CHANNEL_ALL 时， 系统将根据 channelSwitchState 字段定义的开关状态，对该模块下的所有通道进行统一操作。

通道开关状态 注意：仅当 control_target_type 为 TARGET_TYPE_CHANNEL_ALL 时，此字段才生效并执行对应的开关逻辑。

针对该模块下属通道的控制指令列表

通道的索引

开关状态

--- 电气规格 --- 描述该通道是 12V 还是 220V，额定电流是多少

实时电气数据

--- 端口级别的常量配置 --- 通道级别的常量配置

绑定信息相关

[已废弃] 通道的业务定义类型

通道的业务定义类型 修正了 channel_type 直流交流设计错误

【关键字段】供电源索引 / 电源域 (Power Domain) 场景A(直通路由): 如果本通道没有自己的整流/逆变器，它的 AC/DC 属性 完全取决于关联的 power_inputs[power_input_id] 的状态。

扩展部分 【关键】通道绑定的下游网络设备状态 (Telemetry) 边缘网关通过 ActiveMonitorConfig 探测到的结果，自动映射汇总到此处

开关量端口特有配置

如果此通道是网络类型，则填充此字段

--- 核心身份 --- 必须存在。 对于板载模块，固件层需硬编码或动态生成一个固定的 ID (如 "LOCAL_12V_MAIN")

硬件型号/产品代码 (如 "NEXUS-IO-8080")，用于区分功能集

明确接入方式：是主板自带，还是总线扩展，还是串口直连端子

通道数量获取模式

模块的通道数量

--- 版本信息 (OTA必备) --- 固件版本 (如 "v1.2.0")

硬件版本 (如 "PCB_REV_A")

模块级物理状态 (如：模块掉电、总线断开或总闸关断)

模块工作电源规格 (Logic Power)

状态属性 模块在线/离线状态 (总线通讯状态)

模块内部温度 (关键健康指标)

该模块下的所有通道列表 只有当 control_scope == SCOPE_SINGLE 时，解析此列表 如果 control_scope == SCOPE_ALL，直接忽略此字段，从而避免传输N个ID

--- 负载/强电输入电源 --- 支持多路不同电压输入

--- 输出侧 (Output Side) --- 模块总负载能力 (输出侧：Throughput) 注意：这是设备本体的物理极限（铜排、散热），与接入电压无关。 如果接入 12V，最大功率受 max_total_current 限制 (P = 12 * I_max) 如果接入 36V，最大功率可能受 max_total_power (散热) 限制

模块总负载实时统计(所有通道之和) 语义：这是所有 enabled channel 的实时功率/电流累加值 作用：用于和 power_inputs 的输入总和进行对比，计算 PUE 或损耗

模块的业务定义类型

描述所有“板载”的模块

描述所有“下挂”的模块(通过总线等方式连接的外部模块)

[ 第一层：综合摘要 Summary ] 综合判定该通道下的设备是否在线 (需在边缘网关配置聚合策略，如：ANY_SUCCESS(只要一个通就算在线) 或 ALL_SUCCESS(必须全通))

综合通信延迟参考值 (毫秒) - 可选：所有成功任务的平均值，或基础网络(Ping)的延迟

综合设备告警标识 (用于前端快速标红展示)

综合健康度得分 (0-100)，例如：Ping通但HTTP挂了得50分，全通100分。比单纯的布尔值更有灰度。

[ 第二层：监控任务详情 Details ] 该通道下关联的所有具体监控任务的实时执行结果

响应状态码

响应消息, 如 "认证成功" 或 "Token无效"

通信模组的唯一设备识别码GSN (IMEI)

SIM 卡国际移动用户识别码 (IMSI)

SIM 卡唯一标识 (ICCID)

模块版本信息(通常对应 AT+CGMR)

模块固件版本信息(通常对应 AT+GMR)

[作用] 物理 SIM 卡的当前读取状态 [场景] 排查因设备震动导致 SIM 卡松动(未插入)、接触不良、或被锁卡(需 PIN 码) 等硬件级故障。

--- 核心网络注册与制式状态 --- [作用] 当前网络注册状态（对应 AT+CEREG / AT+CGREG） [场景] 区分设备是在找网、已注册、还是被基站拒绝，或者是否处于漫游状态

[排障] 当 reg_status 为“被拒绝”时，底层的 CME/AS 拒绝码 (例如 15 代表无漫游权限)

[排障] 错误码的文本解析

[作用] 当前驻留的网络制式 (Radio Access Technology) [场景] 确认设备是否回落到了 2G/3G，或者确认当前使用的是 NB-IoT 还是 Cat.1

--- 网络标识与 LBS 定位辅助 --- [作用] 运营商公共陆地移动网络号 (MCC+MNC，如 46000 代表中国移动)

[作用] 当前驻留的小区基站 ID (Cell ID) 和 跟踪区代码 (TAC / LAC) [场景] 当设备 GPS 搜星失败时，云端可以通过 Cell ID + TAC 调用基站定位接口，获取设备大致位置（基站 LBS 定位）

[排障/定位] 跟踪区代码 (TAC / LAC)

[作用] 实际生效的 APN (接入点) [场景] 排查专网卡是否成功获取并应用了定向 APN

--- 模组运行健康度 --- [作用] 模组当前温度 [场景] 户外高温暴晒或频繁高频次发包，可能导致模组过热死机重启。监控此项可排查硬件重启原因

运营商名称 (这里更合适，因为漫游时会变)

信号强度总功率 (dBm)

参考信号接收功率 (dBm) - 核心强度指标

参考信号接收质量 (dB) - 纯净度参考指标

信号与干扰加噪声比 (dB) - 稳定性指标

换算后的信号格数 (0-5)，方便 UI 显示

--- 基础电气保护组件 --- [保险丝] (Fuse) 逻辑：supported 决定 UI 是否展示“保险丝状态”一行

实时状态: 正常 / 熔断 (FAULT)

--- 计量核心组件 (互感器状态) --- [电压互感器] (PT - Potential Transformer)

[电流互感器] (CT - Current Transformer)

[漏电流互感器] (Leakage CT)

[线温传感器] (Line Temp Sensor) - 内部传感器

--- 核心功能模块 --- [通信模块] (Communication Module: 4G/WiFi/Eth 芯片)

状态: 正常 / 模块无响应 / SIM卡未识别

补充: 通信模块的具体错误码 (可选，用于深层诊断)

[电源模块] (Power Module: 指设备内部的 AC-DC 或 DC-DC 供电单元)

状态: 正常 / 过热 / 电压输出异常

补充: 电源模块实时温度 (如果支持)

[定位模块] (Positioning/GPS Module)

状态: 正常 / 天线未连接 / 模块无响应

芯片型号 (e.g., "GD32F425VGT6")

内核架构 (e.g., "ARM Cortex-M4")

唯一芯片标识 (96-bit Unique Device ID) 通常显示为 hex 字符串，用于防止盗版或做设备指纹

主频上限 (e.g., 200000000 -> 200MHz)

=== 核心运行指标 === 当前系统主频 (Hz) - 某些设备会动态降频节能

核心供电电压 (mV) - 也可以叫 VDD GD32 内部通常有参考电压通道，可计算出 VDD

核心温度 (Celsius) - 利用片上内置温度传感器 排查高温导致的降频或重启

CPU 负载（单位：%）

栈水位线 (Stack Watermark) - 可选 记录系统运行以来栈剩余的最小值，用于检测栈溢出风险

--- 基础静态指标 --- 总容量

扣除系统预留后的实际可用量

--- 实时动态指标 --- 当前已用量

当前剩余量

当前使用百分比

--- 历史极值 (高水位线) --- 历史最大使用量 (High Watermark)

历史最小剩余量

峰值发生的时间戳

--- 内存质量/碎片化 (主要针对 RAM) --- 当前最大可分配的连续内存块 (对于防止 OOM 至关重要)

分配失败累计次数

--- 存储健康 (主要针对 Storage/Flash) --- 磨损程度 0-100 (百分比)，常用于 SSD/eMMC/Flash 寿命预警

坏块数量

--- 辅助元数据 ---

统计开始时间（Min/Max 是从何时开始统计的，通常是启动时间或上次手动复位时间）

当前监测值或配置值

出厂默认值，用于“恢复默认”功能

允许的最小值（下限约束）

允许的最大值（上限约束）

物模型物理量/电气量测量单位枚举

应对极端情况：如果 unit == UNIT_CUSTOM，可以通过此字段透传非常规单位字符串 正常情况下该字段为空，不消耗额外带宽

火线过压 (Live Wire Over voltage) - 1/2/3级

火线欠压 (Live Wire Under voltage) - 1/2/3级

火线过载 (Live Wire Overload) - 1/2/3级 注：通常指电流过大 (Amps)

漏电 (Leakage Current) - 1/2/3级 注：通常单位为 mA

火线过温 (Live Wire Over temperature) - 1/2/3级

零线过温 (Neutral Wire Over temperature) - 1/2/3级

过载 (AC Total Overload) - 仅3级 注：通常指整机功率过大 (Watts)，与上面的火线过载区分开

回路断开、负载突然掉线

欠流

市电停电 (Mains Failure)

--- 全局默认告警持续上报策略 --- [作用] 提供整个交流系统的兜底上报规则。 [逻辑] 设备在判断某个具体告警(如直流过流1级)是否需要持续上报时： 优先读取其 ThresholdLevel 中的 continuous_report； 如果未下发/未配置，则回退使用此处的 default_continuous_report。 [优势] 绝大多数同类别的告警心跳时间是一致的，配置在根节点可以大幅度压缩云端下发的 Protobuf 报文体积。

DC 侧告警策略配置 若当前设备未启用DC或不支持DC，则下发时该字段置空即可

AC 单相侧告警策略配置

AC 三相侧告警策略配置 (如果该通用设备兼容三相)

--- 交直流通用特有告警 --- 交直流转换模块/逆变器故障告警 (Inverter/Rectifier Fault)

绝缘阻抗告警 (Insulation Resistance) - 储能/交直流系统中常见

设备当前工作模式指示 (辅助业务逻辑判断告警该取哪一部分) [作用] 动态指示设备当前的实际运行工况（掩码字典） [排障] 若云端接收到大量无效的单侧“幽灵告警”（如DC未接却报DC欠压），需优先排查此指示字段是否正确随物理工况进行了动态切换。

--- 全局默认告警持续上报策略 --- [作用] 提供整个交直流系统的兜底上报规则。 [逻辑] 设备在判断某个具体告警(如直流过流1级)是否需要持续上报时： 优先读取其 ThresholdLevel 中的 continuous_report； 如果未下发/未配置，则回退使用此处的 default_continuous_report。 [优势] 绝大多数同类别的告警心跳时间是一致的，配置在根节点可以大幅度压缩云端下发的 Protobuf 报文体积。

过压 (Over voltage)

欠压 (Under voltage)

过流 (Over current)

过温 (Over temperature)

过载 (Overload)

负载不匹配 (Load Mismatch)

市电停电 (Mains Failure)

回路断开、负载突然掉线

欠流

--- 全局默认告警持续上报策略 --- [作用] 提供整个直流系统的兜底上报规则。 [逻辑] 设备在判断某个具体告警(如直流过流1级)是否需要持续上报时： 优先读取其 ThresholdLevel 中的 continuous_report； 如果未下发/未配置，则回退使用此处的 default_continuous_report。 [优势] 绝大多数同类别的告警心跳时间是一致的，配置在根节点可以大幅度压缩云端下发的 Protobuf 报文体积。

直流 (DC) 配置

单相交流 (Single Phase AC) 配置

三相交流 (Three Phase AC) 配置

交直流通用告警配置

直流 (DC) 配置

单相交流 (Single Phase AC) 配置

三相交流 (Three Phase AC) 配置

交直流通用告警配置

--- 电压类 (A/B/C相电压) --- 三相电压过压报警 (任一相电压高于阈值触发)

三相电压欠压报警 (任一相电压低于阈值触发)

三相缺相报警 (检测到某相电压丢失) - 仅3级

三相电压不平衡报警 (三相电压差值或不平衡度过大) - 仅3级

--- 电流类 ( A/B/C相电流) --- 三相电流过流报警 (任一相电流高于阈值触发)

--- 漏电类 (漏电流) --- 三相漏电流过大报警 (检测到漏电流超过阈值)

--- 温度类 (A/B/C相温度、N线温度) --- 三相相线过温报警 (A/B/C任一相端子/线缆温度过高)

零线过温报警 (N线端子/线缆温度过高)

--- 功率类 (A/B/C相有功/视在功率、总功率) --- 单相功率过载报警 (任一相有功功率过大)

总功率过载报警 (三相总有功功率过大)

回路断开、负载突然掉线

欠流

--- 全局默认告警持续上报策略 --- [作用] 提供整个交直流系统的兜底上报规则。 [逻辑] 设备在判断某个具体告警(如直流过流1级)是否需要持续上报时： 优先读取其 ThresholdLevel 中的 continuous_report； 如果未下发/未配置，则回退使用此处的 default_continuous_report。 [优势] 绝大多数同类别的告警心跳时间是一致的，配置在根节点可以大幅度压缩云端下发的 Protobuf 报文体积。

开关量/事件类告警 (Digital / Event Based) 门磁告警 (Door Sensor) 逻辑: 门被打开(状态改变)时触发，可配合 delay_ms 实现“门长时间未关告警”

门锁告警 (Door Lock) 逻辑: 门锁被暴力破坏、非正常开启或门锁硬件故障

防雷器告警 (Surge Protector / SPD) 逻辑: 防雷器模块失效（通常为干接点输出，正常为闭合，故障为断开）

震动告警 (Vibration) 逻辑: 设备被撞击或非法移动触发震动传感器 (如果传感器输出的是简单的开关量信号)

如果你的震动传感器输出的是模拟量（震动强度绝对值），则应改用： optional SingleLevelAlarmConfig vibration_intensity = 5; 模拟量阈值类告警 (Analog / Threshold Based) 环境过温告警 (Environment Over Temperature) 逻辑: 机柜/机房环境温度过高，复用多级告警结构

环境欠温告警 (Environment Under Temperature) 逻辑: 机柜/机房环境温度过低 (极端寒冷地区需要开启加热)

环境过湿告警 (Environment Over Humidity) 逻辑: 湿度过高，可能导致凝露、短路

环境欠湿告警 (Environment Under Humidity) 逻辑: 湿度过低，易产生静电隐患

[作用] 持续上报总开关 true: 开启持续上报 (告警未恢复期间，周期性重传告警) false: 关闭持续上报 (仅在“触发”和“恢复”的瞬间各上报一次事件，即边缘触发)

[作用] 持续上报的时间间隔 (单位：秒) [说明] 仅在 enabled = true 时生效。 [场景] 安防开门告警设为 10 秒（高频），市电停电转电池设为 60-300 秒（心跳）。

重传次数限制 [作用] 是否限制最大重传次数 (独立开关) true: 限制重传次数 (需读取 max_repeat_count) false: 不限制重传次数 (只要没恢复就无限期周期性上报，适用于严重故障)

[作用] 最大重复上报次数 [说明] 仅在 limit_repeat_count = true 时生效。 [场景] 用于节省流量。例如轻微告警重传 3 次后云端已记录即可，无需无限耗费流量。

告警自动升级 [作用] 是否开启告警未处理自动升级 (独立开关) true: 开启 (需读取 escalate_after_sec) false: 关闭

[作用] 告警未处理自动升级时间阈值 (单位：秒) [说明] 仅在 enable_escalation = true 时生效。 [逻辑] 告警触发后如果持续该时间仍未恢复，设备端自动生成更高级别的告警上报。 [场景] 漏电流1级预警持续 10 分钟无人处理，自动升级为3级严重告警，触发前端断路器强制断电。

整个功能的总开关

指定该事件触发时的告警等级

(可选) 持续时间/防抖时间

事件类告警的持续上报策略

是否启用报警

1级报警配置

2级报警配置

3级报警配置

仅有3级

触发值 (绝对值 例如：245.0 或 倍数 如1.1)

(可选) 恢复滞后值/回差值。 告警触发后，必须满足 [当前值 < 阈值 - hysteresis] 才会判定为恢复。 用于防止在阈值点附近的数值波动导致告警频繁抖动。

(可选) 持续时间/防抖时间，单位毫秒

--- 判定逻辑 --- 阈值判定类型：区分是绝对值、倍数还是百分比

是否启用报警

--- 针对当前告警等级的特有持续上报策略 --- [作用] 允许为不同等级配置不同上报频率。 [例如] 3级告警(level_3)可配置 interval_sec=10 (10秒一次)； 1级告警(level_1)可配置 interval_sec=300 (5分钟一次)。 [注意] 若此字段为空，则设备应继承上一级的全局默认配置。

校准补偿 (RAW/Offset) GPQA/APGain: 增益校正 (有功)

PhsA/APhase: 相位校正

APOSA/APOffset: 有功功率 Offset 校正

IARMSOS/AIOffset: 有效值(电流) Offset 校正

无功/视在功率校准 (如果设备支持) RQGain: 无功增益校正

RQOffset: 无功 Offset 校正

物理量转换系数 (硬件RAW值 -> 真实物理量) KUrms: 电压系数 (一般一相一个，或全局共享)

KIArms: 电流系数

KPrms: 功率系数

SYSCON: 系统控制寄存器 (启用ADC、增益选择等)

EMUCON: 计量控制寄存器 (有功/无功计算模式等)

EMUCON2: 计量控制寄存器2

计量唯一序列号 (在机身贴纸上)

芯片底层控制寄存器

计量系统全局配置与阈值

通道校准与转换系数

计量数据校验和，用于防止校准数据在 Flash/EEPROM 中损坏

实时电气数据

[补充] 计量芯片硬件状态 芯片通信故障/异常状态

校准数据校验失败报警

HFConst: 高频脉冲频率常数

PStart: 潜动与启动阈值 (低于此值不计电量，防潜动)

其他常见全局配置 硬件级过流保护阈值

硬件级过压保护阈值

连接断开告警 逻辑：底层通信链路（如TCP/MQTT/串口）的心跳超时或物理断开

网络中断告警 逻辑：通常指广域网(WAN)或上行网口的网络完全不可用

--- 为物理层与链路层细化监控 --- 物理网线断开 (L1 物理层) 逻辑：网卡检测到没有载波（No Carrier），即网线没插或对端交换机掉电

网线已插但不可达 (网关不通) 逻辑：网线物理连接正常，但无法 Ping 通默认网关（通常是由于静态IP配置错误、VLAN划分或交换机端口被禁）

链路降速告警 逻辑：网口协商速率低于预期（例如：千兆网口降速为100M level_3 ）

IP 地址冲突 逻辑：检测到局域网内有其他设备占用了相同的 IP

DNS 解析异常 逻辑：能够 Ping 通 IP，但无法解析域名，导致业务中断

--- 质量监控 (数值型) --- 网络高延迟告警 逻辑：基于 Ping 值延迟。(例如：>500ms 3级, >2000ms 2级)

网络丢包率告警 逻辑：基于丢包百分比。(例如：>10% 3级, >30% 2级)

--- 无线网络扩展 (可选) --- 4G/5G/Wi-Fi 信号强度过低 逻辑：RSSI 或 RSRP 低于阈值

是否为物联网专网卡 true: 启用物联网卡专用逻辑。

接入点名称 (APN) 普通卡一般留空自动获取；物联网专网卡(VPDN)必填，如 "cmiot", "szxyz.gd"

SIM 卡 PIN 码 仅当 SIM 卡开启了 PIN 锁保护时填写 (通常为4位数字)

(可选补充) 认证方式，有些专网 APN 还需要账号密码

(可选补充) 认证方式，有些专网 APN 还需要账号密码

是否允许数据漫游 许多物联网卡（特别是全球卡或虚商卡）在本地使用时也被识别为漫游。 如果是物联网卡，建议此项默认为 true。

4G/5G 物理网卡参数 (APN, PIN, 漫游等)

服务器配置 无论选择哪种链路，服务器配置通常是通用的

是否启用该功能

兜底服务器地址 通常是一个高可用的日志接收服务

"以太网" (可能有 eth0, eth1 多网口选择)

终端IP地址, 终端子网掩码, 终端默认网关

服务器配置 无论选择哪种链路，服务器配置通常是通用的

连续失败多少次判定为故障 (例如：连续3次心跳超时、连续3次Ping失败)

当高优先级节点（如：有线网卡 / 主服务器）恢复正常时，是否自动切回？ true: 恢复后自动切回 (Active-Standby 模式) false: 保持在备用节点，直到备用节点也挂掉或人工干预 (防止频繁震荡)

网络防抖动稳定时间 (秒) 仅当 auto_revert_enabled = true 时有效。 高优先节点恢复后，必须持续稳定 N 秒，才真正执行回切动作。 防止接触不良导致的“反复横跳”。

以太网, 4G/5G

全局链路切换策略 (断网检测、防抖动、回切)

全局上行工作策略 (决定设备当前是跑单链路还是跑多模)

指明当前单一链路到底用的是哪种物理网卡 (例如: CONN_CELLULAR_4G 或 CONN_ETHERNET)

终端链路特有配置 4G/5G 设置

WIFI 设置

有线网络 设置

对多模网络 设置

链路类型

优先级

工作模式

主服务器配置

备用服务器配置 (仅在 主从模式 或 双工模式 下有效)

服务器之间的故障转移与回切策略 专门控制 "primary_server" 和 "slave_server" 之间的切换逻辑 即使物理层只是单纯的 "EthernetConfig"，这里依然生效。

应急日志上报配置(兜底) 当主、备服务器均无法连接时，尝试向此地址发送一次诊断日志

北向网络设置 (设备连接云端/平台)

南向网络设置 (设备连接本地传感器/局域网)

网络名称 (SSID)

密码

加密方式 (WPA2, WPA3, OPEN 等，后端自动检测或指定)

IP获取方式 (WIFI 也可以配静态 IP)

服务器配置 无论选择哪种链路，服务器配置通常是通用的

IP 分配方式

静态 IP 模式下必填 终端IP地址

终端子网掩码

终端默认网关

首选 DNS (可选)

备选 DNS (可选)

IPv6 地址分配模式

[场景1] 当 assign_mode 为 IPV6_ASSIGN_STATIC 时使用

[场景2] 当 assign_mode 为 IPV6_ASSIGN_TRACK 时使用 核心逻辑：LAN 口的 IPv6 跟着 WAN 口获取到的前缀动态变化

[附带属性] LAN 口的 IPv6 路由通告 (Router Advertisement) 配置 在 IPv6 中，即使不提供 DHCPv6 服务，网关也必须发送 RA 报文，局域网设备才能知道网关的存在。 虽然它具有 "Service" 的性质，但它与接口的 IPv6 强绑定，建议放在此处。

是否允许在此 LAN 口发送 RA 报文

管理地址配置标志 (M 标志/Managed flag) true: 局域网设备必须通过 DHCPv6 获取 IPv6 地址 (有状态) false: 局域网设备通过 SLAAC 自动生成地址 (无状态，最常见)

其他配置标志 (O 标志/Other config flag) true: 局域网设备通过 DHCPv6 获取 DNS 等其他信息

RA 报文发送间隔 (秒)

网关的静态 IPv6 地址，例如 "fd00:114:514::1"

子网前缀长度，通常为 64

被追踪的 WAN 接口名称，例如 "wan0" 或 "pppoe-wan"

接口 ID 后缀 (Interface ID)。 如果 WAN 口获取到了 2001:db8:abcd:0012::/64 的前缀， suffix 设置为 "::1"，则当前 LAN 口地址自动配置为 2001:db8:abcd:0012::1

子网划分 ID (Subnet ID)。如果网关获取到了 /56 的前缀，分配给当前 LAN 口的是哪个 /64 子网。

是否启用 TLS 加密

认证模式

根证书 (CA) 别名/路径 用于校验服务端的合法性

设备公钥证书别名/路径 (仅双向认证需要)

设备私钥别名/路径 (仅双向认证需要) 注意：私钥通常存储在安全芯片(SE)或加密文件系统中，此处仅传递索引ID

服务器地址 (IP 或 域名)

端口号

账号 (MQTT ClientID 或 认证账号)

密码

TLS/SSL

全局总开关：使用 optional 确保向后兼容

Ping 探测任务开关

Ping 探测任务列表 [场景] 最基础的存活心跳检测，监控下游设备网络层是否在线。

SSH 探测任务开关

SSH 目标设备列表 [场景] 网关作为跳板机，或者网关通过脚本自动登录局域网内的 Linux 边缘计算节点拉取日志。

通用 TCP 端口探测任务开关

通用 TCP 端口探测任务 [场景] 监控下游业务端口是否存活（例如某台工控机的 502 端口是否在监听）。

HTTP 探测任务开关

通用 HTTP/API 探测任务 [场景] 定时调用局域网内本地业务系统的健康检查(Health Check)接口，或拉取特定数据。

视频安防设备探测任务开关

安防监控设备(海康/大华)专属任务 [场景] 针对 IPCAM(摄像头) 或 NVR(录像机)，不仅判断网络通不通，还需判断视频流是否正常或抓取一张快照上传。

[核心] 任务唯一标识 (长度为 10 的字符串) 任务数组下发时的操作依据： - 新增 (Create)：不传此字段或传空字符串，系统将视为新任务并自动分配 ID。 - 修改 (Update)：传入已存在的 ID，系统将匹配并覆盖更新该任务的配置。

登录的账号 (通常是 admin)

登录的密码

探测/抓图间隔时间(秒)

统一标准寻址方式

[核心] 任务唯一标识 (长度为 10 的字符串) 任务数组下发时的操作依据： - 新增 (Create)：不传此字段或传空字符串，系统将视为新任务并自动分配 ID。 - 修改 (Update)：传入已存在的 ID，系统将匹配并覆盖更新该任务的配置。

请求方法: "GET", "POST" 等 (默认 GET)

期望返回的 HTTP 状态码，例如 200。非 200 则判定告警

请求超时时间(毫秒)

探测间隔(秒)

统一标准寻址方式 完整的请求路径，例如 "http://192.168.1.10/api/health"

是否启用该网口

例如: "eth1", "lan0"

网关在这个网口的IP (需另行定义 Ipv4Config)

网关在这个网口上提供的本地服务 (防火墙/监听策略) [场景] 为了安全，限制局域网内的未知设备访问网关自身的后台。

是否允许下游设备 Ping 本网关 (ICMP Echo Reply) [场景] 开启后，现场工程师可以用电脑 Ping 网关内网 IP 测试网络连通性。

是否允许通过本网口访问本地 Web 配置界面 [场景] 是否允许现场人员通过浏览器访问 http://网关IP 进行调试。

是否允许下游通过本网口 SSH 登录到本网关

(进阶) 如果开启SSH服务端，可以选填允许登录的IP白名单 [场景] 仅允许运维人员专用的管理机 IP (如 192.168.1.100) SSH登录网关。

--- 该字段为兼容旧版本的废弃字段，新业务请勿使用 --- 场景 A：手动指定目标 (脱离业务拓扑的纯网络探测，如测试外网 8.8.8.8) [核心] 探测目标：支持 IPv4, IPv6 地址或域名 (FQDN) [已废弃]

[核心] 任务唯一标识 (长度为 10 的字符串) 任务数组下发时的操作依据： - 新增 (Create)：不传此字段或传空字符串，系统将视为新任务并自动分配 ID。 - 修改 (Update)：传入已存在的 ID，系统将匹配并覆盖更新该任务的配置。

是否删除标识: 0-没有删除、1-删除

探测间隔 (秒)，例如 60秒

超时时间 (毫秒)，例如 2000毫秒

失败重试次数，超过则判定设备离线

统一标准寻址方式

局域网/物理接口配置列表 (网关自身的网络设置) 支持多网口(eth1, eth2...)独立配置 [场景] 网关 eth1(192.168.1.x) 连接安防网络，eth2(192.168.2.x) 连接工控网络 (预留) 其他南向协议配置，如 RS485, LoRa 等 optional ModbusConfig modbus = 2;

主动网络探测/监控任务 (网关主动发起) [场景] 网关需要定时检查局域网内的设备是否掉线，或抓取设备状态。

[核心] 任务唯一标识 (长度为 10 的字符串) 任务数组下发时的操作依据： - 新增 (Create)：不传此字段或传空字符串，系统将视为新任务并自动分配 ID。 - 修改 (Update)：传入已存在的 ID，系统将匹配并覆盖更新该任务的配置。

认证帐号

认证密码 (建议密文)

证书/私钥内容 (可选，优先使用)

统一标准寻址方式

场景 A：手动指定目标 (脱离业务拓扑的纯网络探测，如测试外网 8.8.8.8) [核心] 探测目标：支持 IPv4, IPv6 地址或域名

目标端口

场景 B: 关联业务拓扑，网关底层自动反查 IP

显式指定目标类型 下游程序直接读取此字段做 switch-case 路由，无需进行判空猜测

[核心] 任务唯一标识 (长度为 10 的字符串) 任务数组下发时的操作依据： - 新增 (Create)：不传此字段或传空字符串，系统将视为新任务并自动分配 ID。 - 修改 (Update)：传入已存在的 ID，系统将匹配并覆盖更新该任务的配置。

建连超时时间(毫秒)

探测间隔(秒)

统一标准寻址方式

指向具体的模块编号/ID (例如: "mod_plc_01", "mod_camera_group")

指向该模块下的具体通道编号/ID (例如: "ch_01", "ch_02")

资产简要绑定信息（为了业务查看方便，只做查询给展示使用，不能直接设置该字段内容）