过程数据

过程映像是诊断之后的读写面。先用运行态和诊断确认应用关系健康、IOPS/IOCS 有效，再读当前值或写设备发往控制器的数据。

HTTP 轮询只适合观测或一次性写入。周期交换请走语言 SDK。

`GET /api/io`

GET /api/io HTTP/1.1
Host: 127.0.0.1

字段	说明
`epoch`	世代号（每次发布 +1）
`inputHex`	来自 IO 控制器的周期数据（大写 hex）
`inputLength`	上述区域长度（字节）
`inputIopsHex`	控制器侧提供状态（每子槽 1 字节）
`inputIocsHex`	设备侧消费状态（每子槽 1 字节）
`outputHex`	本设备发给 IO 控制器的周期数据（大写 hex，含尚未发出的本地写入）
`outputLength`	上述区域长度（字节）
`outputIopsHex`	设备侧提供状态
`outputIocsHex`	控制器侧消费状态
`inputValid`	本世代是否从控制器收到过数据
`outputValid`	本世代是否有应用写入过
`formatVersion`	JSON 契约版本（当前 `1`）。未知字段请跳过
`timestamp`	快照本地时间

掉线时服务把提供 / 消费状态置为无效（BAD），不虚构 GOOD。

{
  "epoch": 1204,
  "inputHex": "00000000",
  "inputLength": 16,
  "inputIopsHex": "80",
  "inputIocsHex": "80",
  "outputHex": "A1B2C3D4",
  "outputLength": 16,
  "outputIopsHex": "80",
  "outputIocsHex": "80",
  "inputValid": true,
  "outputValid": true,
  "formatVersion": 1,
  "timestamp": "…"
}

`POST /api/io`

写本设备发给控制器的区域，部分覆盖。不能经本接口改写控制器发来的数据。

{ "offset": 0, "data": "A1B2C3D4" }

字段	说明
`offset`	非负整数，字节偏移
`data`	偶数长度 hex（大小写均可）

成功：

{ "ok": true, "offset": 0, "length": 4, "timestamp": "…" }

offset + 长度 超出输出区 → HTTP 400，不截断。未连控制器时写入暂存在本地，连上后随周期帧发出。并发写入在服务内合并，不必先读后写。

GET /api/io​

POST /api/io​

`GET /api/io`

`POST /api/io`