昇騰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