Driver 控制接口

本页给工厂适配实施。日常读写请走 人工控制。

路径在进程根上，没有 /api/v1 前缀。调用方不得自行加前缀。监听端口写在该装置点表的 Server.port。

目录与能力

方法	路径	含义
GET	/capabilities	进程级旗标。现行包含 max_step
GET	/devices	本进程设备列表
GET	/devices/{device}/commands	该设备的命令列表

命令项字段为 id、label、description、datatype、min、max。现行目录接口把 min 与 max 都填成 null。

写入与回读

方法	路径	含义
POST	/set_command	写入设定
POST	/get_command	回读当前值

写入请求体是 data 数组。每一项含 device、command 和 params.value；可选 params.max_step（须为正的有限数字，并且只用于数值）。客户端断开则取消尚未完成的写入。

回读请求体同样是 data 数组，每一项只有 device 与 command。

进程用本装置名作为 system，把 {system}.{device}.{command} 拼成小写后再写入或回读。未知命令标识会被拒绝。

探针

GET /live、GET /ready、GET /health 是进程探针，供本机监管使用。