Control
闸门与开度
渠道阀支持按百分比设开度；开闸位置、保护时间、阻断电流等数据展示更准确。
Capabilities
平台能力
围绕灌区现场控制与系统对接，持续增强设备类型、控制精度与运维可见性。
Devices
灯 / 水位 / 传感
杀虫灯与水位仪全流程；采集仪传感器通道入库；流量计 K 值与智能开关开/关。
Ops
巡检与群控
夜间轮询跳过离线网关；广播群控与工程内设备分组批控，便于片区应急。
Open API
开放对接
AppId 签名换取 Token，覆盖工程、设备、指令下发、批量入队与回调通知。
Console
对接工作台
工程概览、账号密钥、回调记录、队列任务、API 记录与在线调试一体完成。
Batch
批量控制
对多台闸门一次下发相同动作，支持批量开度，适合片区联调与应急处置。
Open Platform
用户开放平台
面向第三方对接。对接文档可免登录查阅；联调、回调与队列需 AppId 登录工作台。
对接文档
开放平台接口全文：鉴权、基础地址、路由、响应规范与业务接口（含 V2.3～V2.5）。无需登录即可阅读。
- 鉴权：AppId + 签名换取 access_token
- 业务：工程 / 设备 / 指令 / 批量入队 / 回调
- V2.5：溢流闸 8 固定点位（不建表）；commands 返回 overflow_ui
- V2.4.2：仅 4146 指令字节 01 超时原帧补发
- V2.3：广播群控、设备分组、传感器 / 流量计 / 智能开关
- 地址：
/index.php/openapi
开放平台工作台
需 AppId + AppSecret。用于联调与排查，不替代用户客户端。
- 密钥在管理后台「用户管理 → 密钥」生成
- 工程概览、在线调试、回调 / 队列 / API 记录
- 登录后也可在工作台内打开同一套对接文档
V2.5 最新
2026-09溢流闸（gate_type=2）支持 8 个固定停止点位调控；不新建数据表，由代码常量组 4146 控制帧。
- 点位：溢流低/中/高、关闭、开 25%/50%/75%、全开（末字节 04/12/21/2F/3D/4B/5A/68）
- 布局建议：左开 75/50/25；中 开|停|关；右溢流高/中/低
- open→全开 68；close→关闭 2F；stop→停 69（不是通用停 03）
- 溢流闸不支持开度滑条 aperture、不支持平闸 flat
- 开放 API：/wlw/commands 返回虚拟点位与 overflow_ui；用 action 下发
V2.4.2
2026-09按协议收敛回执补发：仅对 4146 下行「指令」字节 = 01 的帧做超时原帧重发；禁止改写成状态查询。
- 可补发：指令字节 01，超时无业务上行 → 原帧重发
- 不补发：非 01（如状态查询 03）、非 4146、夜间巡检
- 仍为约 5 秒首等、间隔 5 秒、最多补发 3 次；有回执即停
- 满次无结果 → 设备异常终态回调
V2.4.1
2026-09在 V2.4 回执补偿基础上调整：仅操作超时重发原控制；查询一律不补发。对接回调规则不变。
- 控制类（开/关/平/停/开度、灯控、设 ID 等）超时无回执 → 重发原控制
- 查询类（状态/电压/电流等）→ 不补发
- 仍为约 5 秒首等、间隔 5 秒、最多 3 次；有回执即停
- 满次无结果 → 设备异常终态回调（与 V2.4 相同）
- 开放平台：有回传才推状态；中间补发只在通讯记录标「补发」
V2.4
2026-09聚焦指令回执更可靠：凡有回执的命令，超时无上行则自动补偿——操作曾补对应查询，查询则原指令重发。对接方最终能收到成功状态或设备异常回调。（补偿内容已由 V2.4.1 调整为重发原指令。）
- 下发后等待 5 秒；无回执则同网关自动补偿
- 操作（开/关/平/停/开度、灯控、设 ID 等）→ 曾补偿对应「查询」（见 V2.4.1）
- 查询（状态/电压/电流/角度/灯状态/传感拉数等）→ 原指令再发
- 最多补偿 3 次、间隔 5 秒；有回执即停并按现网回调
- 3 次仍无结果 → 判定设备异常并推送状态类终态
- 覆盖闸门 / 杀虫灯 / 水位仪 / 智能开关 / 传感器；广播群控不适用
- 通讯记录中自动补发带「补发」标识，便于与人工下发区分
V2.3
2026-08强化群控与分组、接入采集仪传感器与智能开关，完善流量计参数与巡检/电压解析；并明确区分用户客户端与用户开放平台两套入口。
- 入口拆分：用户客户端（/h5/）与用户开放平台（对接文档免登录 + 工作台需密钥）
- 群控改为广播下发（设备域 ffffffff），界面不强制等待回执
- 工程内设备分组：建组、绑设备、组内批量控制
- 采集仪传感器：EB55/EB5A 协议收发、通道解析入库与查询
- 流量计：配置 K1/S/S1，自动计算 K=K1×S/S1
- 智能开关：开/关指令，设备域固定广播式 ID
- 夜间巡检跳过离线网关；24V 电压按协议 2 字节解析
V2.2
2026-07聚焦闸门控制更准、开度可调、夜间自动巡检、运维看得更清；管理端与开放 API 同步增强。
- 渠道阀支持按百分比设开度（管理端 / 通讯记录 / API）
- 开闸位置、保护时间、阻断电流等解析与展示纠错
- 夜间自动轮询：故障、欠压自动标记并在首页预警
- 管理端运维总览、开放 API 客户端工程概览
- 子设备序号可自定义（水位仪除外）
V2.1
2026-07在闸门控制基础上，正式支持杀虫灯、水位仪全流程管理，并扩展开放 API 便于移动端与第三方对接。
- 杀虫灯：开关、定时、状态查询；支持灯管类型配置
- 水位仪：液位监测、原点角标定、与闸门关联展示
- 批量控制：对多台闸门一次下发相同动作
- 设备数据更丰富：电压时间、运行状态、液位 / 灯光状态等
