🔌 API 接口
获取设备列表
获取关注的所有灌溉控制器设备清单，包括在线状态、控制对象数量、监测对象数量等统计信息。
请求参数
| 参数名 | 类型 | 描述 | 必选 |
|---|
acctount | string | 帐号 | 是 |
page | int | 页码 (0~30) | 否 |
注意： 当请求参数为空时，服务器返回第 0 页的内容
请求示例
GET http://mhelectr.top:13600/api/devicelist/get?acctount=88888888888&page=0
响应字段
| 字段 | 类型 | 描述 |
|---|
summation.device | int | 所有关注的设备总数 |
summation.online | int | 在线的设备总数 |
summation.ctrlcount | int | 控制对象总数 |
summation.ctrlerrcount | int | 故障控制对象数 |
list[].deviceid | string | 设备唯一 ID |
list[].status | string | 在线/离线 |
获取设备注册表
获取指定灌溉服务器的完整注册表结构，包括水泵、阀门、传感器的树形层级关系。
请求参数
| 参数名 | 类型 | 描述 | 必选 |
|---|
acctount | string | 帐号 | 是 |
registid | string | 灌溉服务器设备 ID | 是 |
请求示例
GET http://mhelectr.top:13600/api/registtab/get?acctount=88888888888®istid=2119992778
控制对象字段
| 字段 | 类型 | 描述 | 示例 |
|---|
nodeaddr | int | 结点地址 | 01 |
subaddr | int | 子地址 | 01 |
name | string | 设备名称 | 水泵/阀门 |
power | string | 电量百分比 | 80% |
signal | string | 信号强度 | -89dbm(强) |
status | string | 开关状态 | 打开/关闭 |
list | array | 子设备列表 | 支持多级嵌套 |
🌳 设备层级结构
MHP 控制器采用树形层级结构管理设备：
灌溉服务器 (registid)
└── 水泵 (nodeaddr: 01, subaddr: 01)
├── 阀门 1 (nodeaddr: 01, subaddr: 02)
├── 阀门 2 (nodeaddr: 01, subaddr: 03)
└── 阀门 3 (nodeaddr: 01, subaddr: 04)
└── 子阀门 (支持多级嵌套)
└── 水泵 (nodeaddr: 02, subaddr: 01)
└── ...
地址编码规则：
• nodeaddr: 主设备地址（如水泵地址）
• subaddr: 从设备地址（如阀门地址）
• 一对 (nodeaddr, subaddr) 唯一标识一个控制节点