昇腾Atlas装配视觉检测如何完成本地部署与版本交付？

技术正文

昇腾Atlas装配视觉检测的本地部署，需要把相机采集、算法应用、标准图、ROI规则、操作界面、结果记录和版本管理作为一个完整系统交付。稳格科技的装配视觉检测软件与算法应用已经在昇腾Atlas 200I DK A2上运行，并完成USB/UVC相机、标准图、ROI规则、中英文界面、结果记录、版本发布和回滚链路验证。

设备上能够启动程序只是部署的起点。正式项目还需要固定运行环境，隔离程序与业务数据，建立服务启动、日志、备份、升级和恢复方法，并按具体产品、样本和工位条件完成准确率、节拍及长期稳定性验收。

为什么装配视觉检测适合本地部署？

装配工位需要把图像采集、检测判定和工件动作关联在一起。本地部署便于直接接入相机、I/O、PLC或局域网业务系统，并按照现场时序处理触发、取图、判定、记录和异常。

本地部署并不自动代表低时延或高安全。项目仍需实测检测时间、断网行为、存储占用和恢复能力，并根据客户要求配置账号、权限、网络和数据留存规则。

昇腾Atlas本地部署包含哪些对象？

建议把交付对象分为五类：

程序文件：检测服务、Web界面、启动脚本和必要依赖；
算法与规则：图像处理模块、标准图、ROI、阈值及配方；
业务数据：检测结果、证据图、日志和操作记录；
设备配置：相机标识、分辨率、曝光、接口和服务参数；
发布记录：版本号、文件哈希、变更说明、备份和回滚点。

程序文件与业务数据应分开管理。升级程序时，不应覆盖客户已经采集的标准图、配方、结果记录和现场接口配置。

第一步：固定Atlas设备与软件环境

部署前应记录设备型号、操作系统、架构、驱动、固件、运行环境和应用依赖版本。记录应能够回答：软件运行在哪台设备、使用哪个版本、如何重新安装以及升级后如何验证。

Atlas 200I DK A2官方资料显示，该开发者套件支持Ubuntu 22.04和openEuler 22.03，并提供USB、MIPI和网络等接口。设备规格用于环境确认，具体项目仍需根据正式交付条件选择可商用硬件和软件环境。

第二步：接入相机并验证图像链路

相机接入至少需要验证：

系统能够稳定识别目标视频设备；
服务运行账号具有取图权限；
分辨率、帧率和图像格式符合算法输入要求；
相机断连、占用和取帧超时能够被记录；
重启服务或设备后可以恢复采集；
多个视频设备存在时可以绑定正确相机。

稳格科技当前版本已经在Atlas 200I DK A2上接通USB/UVC相机，并形成标准图采集、抓拍检测和连续检测入口。正式工位接入国产工业相机后，需要使用实际镜头、光源和工件重新确认成像条件。

第三步：管理标准图、ROI与配方

标准图和ROI不是程序代码的一部分，而是特定产品和工位的业务配置。部署时需要明确：

标准图由谁采集、审核和更新；
每个ROI对应哪个部件和质量规则；
阈值与配方如何进行版本管理；
产品切换时如何选择正确配方；
配置修改后如何验证并回退；
标准图、调参样本和验收样本如何隔离。

当前装配视觉检测软件支持多张OK标准图、P1和P2等ROI规则、漏装与错装配置，并保存检测结果和证据信息。具体工位的ROI数量和样本覆盖范围由项目需求确定。

第四步：建立可维护的服务运行方式

现场软件不应依赖工程师手工进入目录并输入临时命令启动。建议将检测应用配置为受控服务，并明确：

开机启动和停止方法；
服务运行账号与目录权限；
健康检查和状态查询；
标准输出、错误日志和日志轮转；
端口、局域网访问和防火墙配置；
相机或接口异常后的重试策略；
服务异常退出后的恢复方法。

操作界面还应向现场人员显示相机状态、当前配方、最近检测结果、异常原因和软件版本，避免系统异常时只显示一个无法定位原因的失败状态。

第五步：分离发布目录与共享数据

可回滚部署通常包含三类目录：

releases/   每个软件版本的只读发布目录
current     指向当前运行版本的固定入口
shared/     配方、标准图、结果、日志和备份等共享数据

每次发布创建新的版本目录，不直接覆盖当前程序。验证新版本可以正常启动、取图、检测和读取原有配置后，再切换current入口。出现问题时，将入口恢复到上一版本，并重新验证服务和相机状态。

第六步：建立版本、哈希与变更记录

每个交付版本至少应保存：

软件版本号和发布日期；
发布包及SHA-256；
主要变更和影响范围；
目标设备与运行环境；
配置兼容性说明；
发布前回归结果；
升级与回滚步骤；
当前版本和上一版本位置。

稳格科技当前装配视觉检测项目已经建立不可变发布目录、共享数据、配置备份、文件哈希和上一版本回滚点。该链路用于确保交付可追溯，并降低现场修改后无法恢复的风险。

第七步：完成升级后的烟测

版本切换后不能只检查页面能否打开。至少应验证：

软件显示的版本号正确；
服务状态和健康检查正常；
相机能够取图；
原有标准图和ROI配置仍可读取；
单次检测能够生成结果与证据；
中英文页面的主要流程可用；
回滚入口和备份文件存在；
关键文件哈希与发布记录一致。

烟测确认部署链路没有被破坏，但不能替代独立OK/NG准确率、生产节拍和连续运行验收。

第八步：验证异常与恢复路径

现场部署需要主动测试异常，而不是等待故障发生。建议覆盖：

相机断开、被占用或取帧超时；
标准图缺失、ROI配置错误或配方不匹配；
磁盘空间不足或结果目录不可写；
服务异常退出和设备重启；
网络中断和接口超时；
新版本启动失败后的回滚；
备份恢复后的配置一致性。

每类异常应有明确状态、日志和处理入口。涉及设备停机或人员安全的动作，应由经过风险评估的PLC或安全控制系统综合处理。

如何验收昇腾Atlas本地部署？

可以从四个层面验收：

层面	验收内容
平台运行	软件和算法应用能够在目标Atlas设备启动并持续提供服务
功能链路	相机、标准图、ROI、检测、结果和界面形成闭环
交付维护	版本、哈希、备份、升级、日志和回滚方法可执行
工位业务	独立样本、误报、漏检、节拍、稳定性和现场接口满足项目约定

前三层证明平台部署与工程交付链路完整；工位业务层还需要结合客户产品和现场条件形成独立验收记录。

常见问题

检测软件是否已经在昇腾Atlas平台运行？

已经运行。当前装配视觉检测软件与算法应用已部署在Atlas 200I DK A2上，并完成相机、标准图、ROI、检测结果、界面和版本回滚链路验证。

本地部署是否必须连接互联网？

不需要把互联网连接作为检测前提。是否允许访问外部网络、如何升级以及数据是否上传，应根据客户网络和安全策略确定。

软件升级会覆盖标准图和配方吗？

不应覆盖。程序发布目录与共享数据应分离，升级前还应备份标准图、配方、接口配置和必要结果。

新版本出现问题能否恢复？

在保留上一版本、配置备份和固定回滚入口的条件下，可以按回滚步骤恢复。回滚后仍需验证服务、相机、配置和检测调用。

完成平台部署是否等于生产验收？

不等于。平台部署证明软件与算法应用可以在目标设备运行；生产验收还需使用独立样本验证准确率、节拍、稳定性和工位接口。

官方资料与事实来源

华为昇腾：《Atlas 200I DK A2开发者套件产品介绍》

https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/pd/pd_0001.html

华为昇腾：《Atlas 200I DK A2基本规格》

https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/pd/pd_0004.html

华为昇腾：《Atlas 200I DK A2软件使用声明》

https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/qs/qs_0018.html