# 指令响应码与排故

用户在触摸屏或小程序发起操作后，页面可能先显示“已接受”，再显示最终结果。维护人员
必须用最终响应码判断该次操作是否完成。USB、工站和 RS485 的响应只用于授权连接或集成
工作，不作为普通用户操作设备的入口。

## 响应码总表

| 响应码 | 含义 | 是否最终结果 | 现场判断 |
| ---: | --- | --- | --- |
| `102` | 正在进行 | 否 | 设备仍在执行或分段返回信息，继续等待 |
| `202` | 已接受 | 否 | 请求已排队或已启动，不能视为成功完成 |
| `200` | 成功 | 是 | 本次操作正常结束，还应核对实际设备状态 |
| `400` | 指令或参数无效 | 是 | 请求本身有误，修正选择或输入后再试 |
| `409` | 资源忙或流程冲突 | 是 | 当前有冲突任务，等待或安全结束后再试 |
| `499` | 已取消、已退出或被停止 | 是 | 本次操作未按原目标完成，确认设备收尾状态 |
| `500` | 执行失败 | 是 | 已尝试执行但失败，结合正文和健康故障码排查 |

## 正确判读顺序

1. 记录操作名称、发起时间和消息编号。
2. 收到 `202` 后保持等待，不重复发起同一操作。
3. `102` 或进度变化期间保持供电和必要资源。
4. 等待最终 `200/400/409/499/500`。
5. 同时查看屏幕健康告警和维护页面状态。
6. 核对实际动作结果，例如液体是否到位、记录是否保存、版本是否更新。

```{warning}
`202` 只表示设备接受了请求。试剂对齐、进排水、清洗、校准、检测、存储和升级均可能在稍后失败。
```

## 响应码与健康故障码的区别

| 信息 | 回答的问题 | 示例 |
| --- | --- | --- |
| 指令响应码 | 这一次请求是否被接受、完成、拒绝、冲突、取消或失败 | `409` 表示本次启动因资源忙未执行 |
| 健康故障码 | 设备当前哪个部件或业务状态异常 | `1928` 表示检测进水无水 |

两者没有固定一一对应关系：

- `400` 通常是操作输入问题，可能没有健康故障码。
- `409` 通常是资源占用，可能只是另一任务正在运行，也可能伴随未恢复故障。
- `500` 可能由硬件、液路、试剂、存储或流程失败造成，应优先找同时出现的健康故障码。
- `200` 说明该指令成功结束，但不能清除此前独立存在的健康故障。
- 健康故障可能在没有人工指令时自动出现。

## 联合排故方法

| 响应与故障组合 | 判断 | 处理 |
| --- | --- | --- |
| `400`，无故障码 | 目标、模式、范围或输入不合法 | 核对页面选择和允许范围，不检查硬件 |
| `409`，无故障码 | 检测、校准、升级或维护任务冲突 | 查看当前状态，等待或安全停止冲突任务 |
| `409` + 存储占用 `1710` | USB 电脑占用 SD 卡 | 安全弹出并断开 USB，等待存储恢复 |
| `500` + `1928` | 进水无水导致操作失败 | 检查样品源、吸液管、泵、阀和堵塞 |
| `500` + `1939` | 排水失败导致流程终止 | 检查废液、折弯、堵塞和排水执行器 |
| `500` + `1902/1932` | 试剂不足或为空 | 补充试剂、排气并重新对齐 |
| `500` + `1210/1918` | 光学读取或噪声严重 | 清洁反应器，检查漏光、传感器和光源 |
| `500` + `1703/1711` | 文件系统或记录写入失败 | 检查 SD 卡、空间、USB 占用并验证保存 |
| `500` + `1601/1602/1603` | 升级阶段失败 | 根据下载、准备或安装阶段分别处理 |
| `499` + 检测已中止 `1910` | 检测已被停止或取消 | 等待排液收尾，原因消除后重新检测 |

## 常见操作响应

### 检测

| 操作 | 正常过程 | 常见异常及处理 |
| --- | --- | --- |
| 启动 | `202` 已接受，最终 `200` 已完成 | `409`：已有检测或资源忙；`500`：查看预检和硬件故障 |
| 暂停 | `202` 已接受，最终 `200` 已暂停 | `409`：没有运行中的检测或已经暂停 |
| 恢复 | `202` 已接受，最终 `200` 已恢复 | `409`：检测未暂停或已结束 |
| 停止 | `202` 已接受，最终通常为 `499` 已停止 | `409`：当前没有运行中的检测；`500`：等待状态切换后重试 |
| 状态查询 | `202` 已接收，最终 `200` 或 `499` 查询结束 | `409`：响应资源忙，稍后查询 |

检测启动出现 `500` 时，按以下顺序检查：关键硬件、设备水平、存储、试剂、进排水校准、颜色基线和当前任务冲突。

### 流体与清洗

| 响应 | 含义 | 处理 |
| ---: | --- | --- |
| `202` | 流体或清洗请求已接受 | 观察目标反应器和管路，等待最终结果 |
| `200` | 流体控制或清洗完成 | 确认实际液位、排空和无漏液 |
| `400` | 目标、类型或输入无效 | 核对反应器、液体类型和允许体积 |
| `409` | 流体会话或执行器忙 | 等待当前动作完成，不重复点击 |
| `500` | 启动或执行失败 | 检查泵、阀、管路、参数和对应健康码 |

### 试剂

| 响应 | 含义 | 处理 |
| ---: | --- | --- |
| `202` | 加液、对齐、回抽或补充请求已接受 | 观察泵和液柱，等待终态 |
| `200` | 试剂会话完成 | 检查管口液位、挂滴和目标体积 |
| `400` | 目标或校准输入无效 | 核对试剂名称、操作类型和输入范围 |
| `409` | 会话、目标泵或校准资源忙 | 等待或停止冲突泵，再单独重试失败目标 |
| `499` | 补充或操作取消/失败退出 | 检查收尾状态，不直接开始检测 |
| `500` | 泵未启用、硬件异常或部分目标失败 | 根据失败目标逐泵检查，不能把部分成功当全部成功 |

### 校准

| 响应 | 含义 | 处理 |
| ---: | --- | --- |
| `202` | 校准已启动或请求已接受 | 保持标液、试剂和设备状态，等待终态 |
| `200` | 校准动作完成 | 查看点位、残差、保存和独立验证结果 |
| `400` | 校准类型、目标、通道或输入无效 | 核对项目、标准点、通道和实测值 |
| `409` | 检测/校准/反馈资源忙 | 等待当前流程结束，不叠加校准 |
| `499` | 校准已退出或取消 | 未完成点位不得视为有效三点标定 |
| `500` | 校准动作、硬件、参数读取或保存失败 | 查看健康码，检查标准液、液路、光学和存储 |

### 存储与参数

- `202`：保存、格式化、归档或上传请求已接受，等待最终结果。
- `200`：操作完成，重新读取或重启后验证结果。
- `409`：存储忙、USB 占用或重复请求，停止重复操作。
- `500`：介质、空间、文件系统、写入或持久化失败；处理 `1703` 至 `1715` 类健康故障。

### 软件升级

- 查询、下载和解包收到 `202` 后继续等待。
- 下载并准备完成应收到最终 `200`，才可进入安装。
- `409` 表示其他关键升级阶段或存储资源正在占用。
- `500` 应结合 `1601/1602/1603` 判断失败发生在下载、准备还是安装。
- 安装开始并重启后，不再以指令响应判断最终成功，应核对新版本启动和整机验证。

## 超时与没有最终响应

1. 不立即重复发送同一指令。
2. 查看设备综合状态和相关部件是否仍在动作。
3. 对有液体动作的操作，先保证不会溢液或干转。
4. 查询当前任务状态；查询也无响应时记录现场。
5. 确认不处于程序写入或存储格式化阶段后，才考虑重启。
6. 保存消息编号、最后响应、时间、屏幕照片和健康故障码。