# 软件升级

软件升级应由经过授权的人员按正式发布说明执行。升级包必须与设备型号及主控、屏幕、扩展部件的配套要求一致。

升级查询、下载确认、安装和取消均从设备触摸屏“设置 → 软件升级”页面操作。

<div class="figure-placeholder">
  <strong>触摸屏软件升级页面示意图待补充</strong>
  <span>后续图片应标出：当前版本、可用版本、查询更新、下载、安装、取消、进度和失败提示。</span>
</div>

## 升级前

- 记录当前主控、屏幕和扩展部件版本。
- 导出重要检测记录、参数和维护资料。
- 确认设备空闲，停止检测和维护动作。
- 保证供电稳定，禁止使用接触不良的插座或线缆。
- 确认存储空间充足，并断开会占用存储的 USB 连接。
- 核对升级包来源、适用型号、目标版本和发布说明。

还应确认设备没有正在进行检测、校准、清洗、文件上传或其他升级任务。云端升级要求移动网络和云平台会话稳定；本地升级要求使用正式发布、完整且配套的主控文件，不能使用工程中间文件。

## 云端升级

### 查询更新

1. 从触摸屏首页进入“设置 → 软件升级”，点击“查询更新”。
2. “查询已接受”只代表设备开始查询，不代表一定存在新版本。
3. 查看当前版本、可用版本和兼容性提示。
4. 显示无可用更新时停止操作，不要通过修改版本信息强制升级。
5. 查询失败时先恢复网络和平台连接。

### 下载和准备

1. 确认 SD 卡空间充足且未被 USB 电脑占用。
2. 启动下载后保持网络与供电稳定。
3. 下载可能持续数分钟，不要重复点击。
4. 设备会检查文件完整性、设备型号、版本兼容性和发布签名。
5. 只有页面明确显示升级包已准备完成后，才能开始安装。

### 安装

安装开始后设备会进行最终检查并自动重启。后续可能经历备份、写入、校验和再次启动。此阶段不得以断电方式取消。

## 本地存储升级

适用于云端不可用但已取得正式发布文件的场景。

1. 向发布负责人获取与设备型号和目标版本匹配的完整文件组。
2. 将设备通过 USB 连接电脑，等待出现可移动存储。
3. 先备份重要数据，再把发布文件放入设备指定的升级目录。
4. 文件名必须保持发布要求，配套文件不能来自不同版本。
5. 在电脑端安全弹出存储并断开 USB。
6. 等待设备重新接管 SD 卡并确认文件可用。
7. 从触摸屏“设置 → 软件升级”页面启动安装，后续要求与云端安装相同。

未经授权的人员不应自行制作升级文件。文档中也不提供发布签名、内部目录生成或工程打包方法。

## 升级过程中

- 不关闭电源，不移动设备，不插拔存储卡和通信线。
- 按屏幕进度等待，不因短时间无变化而反复操作。
- 屏幕更新或设备重启期间出现短暂无显示可能属于正常过程。
- 若明确显示失败，记录提示和失败阶段，不要连续重试。

## 取消升级

- 下载或升级包准备阶段可使用页面的取消操作。
- 发出取消后应等待最终结果，再开始其他升级任务。
- 安装最终校验已经开始、设备已经重启或正在写入程序时，不能通过断电取消。
- 不确定当前阶段时，保持供电并联系技术支持。

## 升级后验证

1. 等待设备完整启动并进入空闲状态。
2. 核对主控、屏幕和扩展部件版本是否符合发布说明。
3. 检查时间、存储、通信、温度和电源状态。
4. 执行一次基础管路动作，确认进排液正常。
5. 使用标准液完成检测验证。
6. 记录升级日期、升级前后版本、包来源、人员和验证结果。

“设备已经重启”不等于升级成功。只有新版本完整启动、关键部件初始化正常、版本正确且整机验证通过，才能结束升级工单。

若新版本无法完成关键启动检查，设备可能自动恢复到旧版本。发现版本回退时，应保存整个过程信息并排查新版本启动失败原因，不要立即重复安装。

## 升级失败

- 下载失败：检查网络、升级来源和可用空间。
- 升级包准备失败：重新获取正式升级包，确认文件完整且版本匹配。
- 主控、屏幕或扩展部件更新失败：保持现场，不自行拆机，联系技术支持。
- 升级后无法启动：不要频繁断电重试，记录指示灯、屏幕表现和最后一次操作。

## 常见问题

| 现象 | 常见原因 | 处理方法 |
| --- | --- | --- |
| 查询更新失败 | 设备离线、平台会话未就绪或发布信息缺失 | 恢复网络和平台，核对发布状态 |
| 显示无可用更新 | 已是最新、目标版本更低或兼容范围不符 | 核对发布说明，不强制绕过 |
| 升级包被拒绝 | 文件不完整、签名不正确、型号或版本不匹配 | 删除错误文件，重新获取正式发布包 |
| 完整性校验失败 | 下载/复制不完整或配套文件不一致 | 重新下载或复制同一发布包 |
| 存储不可用 | SD 卡异常、USB 占用、空间不足或存储忙 | 退出 USB，恢复存储并重试 |
| 安装后未重启 | 最终校验或升级请求失败 | 记录页面提示，不连续发起安装 |
| 重启后仍为旧版本 | 安装失败或新版本自动回退 | 保存启动信息并联系支持 |
| 屏幕与主控功能不一致 | 只升级了部分部件或版本不配套 | 按整机发布说明补齐配套版本 |

## 升级操作记录

每次升级至少记录：设备编号、操作时间、操作人员、升级方式、升级前版本、目标版本、发布包标识、查询结果、下载结果、安装结果、是否发生回退以及升级后验证结果。