跳到主要內容

AI 驅動文件

您想了解什麼？

後設資料設定

本指南介紹如何為您的 OV80i 相機影象配置後設資料。後設資料是與每張捕獲影象一起儲存的自定義資訊，幫助您跟蹤諸如零件號、序列號或生產資料等重要細節。

何時使用後設資料： 生產跟蹤、部件識別、質量控制記錄、批次資訊、操作員標識，或任何需要與檢驗影象關聯的自定義資料。

前提條件​

  • OV80i 攝像系統已設定並連線
  • 已配置成像和檢驗設定的活動配方
  • 至少一個 AI 塊（classification 或 segmentation）已配置
  • 瞭解要從檢驗結果中跟蹤的資料

後設資料是什麼？​

後設資料是附加到每張捕獲影象上的額外資訊。該資訊：

  • 與影象一起儲存在相機庫中
  • 在 HMI 中顯示，供操作員檢視
  • 有助於識別和跟蹤特定部件或生產批次
  • 可以在庫中進行檢索以進行分析

有用後設資料示例：

  • 零件號（例如，"P12345"）
  • 序列號（例如，"SN987654"）
  • 操作員姓名（例如，"John_Smith"）
  • 班次資訊（例如，"A_Shift"）
  • 批次號（例如，"Batch_2025_001"）
備註

後設資料只能在完成檢驗時儲存。後設資料必須是從相機捕獲並處理影象後從 "All Block Outputs" 開始的流程的一部分。

第1步：訪問 Node-RED 編輯器​

1.1 導航至 IO Block​

  1. 在 Recipe Editor 中開啟你的活動配方
  2. 點選 Configure IO 或在麵包屑選單中選擇 IO Block 進入 Node-RED 編輯器

1.2 驗證 Node-RED 介面​

檢查點： 您應該在左側看到帶有現有 IO Block 流和節點調色盤的 Node-RED 流編輯器。

第2步：定位 "All Block Outputs" 節點​

2.1 查詢起點​

在你的 Node-RED 流中，查詢 "All Block Outputs" 節點。該節點是在觸發並處理完檢驗後從相機接收資料的起點。

"All Block Outputs" 節點：

  • 包含來自所有 AI 塊的檢驗結果
  • 包含影象捕獲資訊
  • 提供後設資料建立所需的資料
  • 是提供後設資料和透過/失敗決策的來源

2.2 瞭解流程結構​

你的流程應遵循以下模式：

Camera Trigger → AI Processing → All Block Outputs → [Your Custom Logic]

從 "All Block Outputs" 您需要 兩條獨立路徑：

  1. 後設資料路徑：All Block Outputs → Function (Create Metadata) → 捕獲後設資料
  2. 決策路徑：All Block Outputs → Function (Logic) → 最終透過/失敗
備註

後設資料和透過/失敗決策必須從 "All Block Outputs" 節點分支。

第3步：新增 Capture Metadata 節點​

3.1 定位後設資料節點​

  1. 在左側面板（Overview 部分）找到 "Capture Metadata" 節點
  2. 將 "Capture Metadata" 節點拖到流程畫布上
  3. 將其放置在流程中 觸發之後、影象捕獲之前 的位置

3.2 節點在流程中的放置​

正確的流程結構：

All Block Outputs → Function (Create Metadata) → Capture Metadata
                  ↓
                  Function (Pass/Fail Logic) → Final Pass/Fail

注意

為確保流程正確工作，"Final Pass/Fail" 節點是必需的。每個流程都必須以此節點結束。

第 4 步：配置後設資料欄位​

4.1 基本後設資料設定​

  1. 雙擊 Capture Metadata 節點
  2. 配置您要跟蹤的後設資料欄位
  3. 為每個欄位設定資料來源

4.2 後設資料格式要求​

重要

後設資料必須格式化為一個物件，要求如下：

  • 字串鍵 - 欄位名必須為文字
  • 字串或數字值 - 資料可以是文字或數字

正確格式示例：

{
  "part_number": "P12345",
  "serial_number": "SN987654",
  "operator": "John_Smith",
  "shift": "A",
  "quantity": 100,
  "temperature": 23.5
}

第 5 步：建立後設資料函式節點​

5.1 新增用於後設資料建立的 function 節點​

  1. 在“All Block Outputs”與“Capture Metadata”節點之間新增一個“function”節點
  2. 雙擊該節點進行配置
  3. 該函式將從檢測結果中提取資料並建立後設資料

5.2 從 All Block Outputs 提取資料​

“All Block Outputs”節點提供豐富的檢測資料。以下是提取方法：

// Extract data from inspection results
const captureId = msg.payload.capture_id;
const serialNumber = msg.payload.serial_number || "No_Serial";
const inspectionTime = msg.payload.inspection_time || new Date().toISOString();

// Create metadata from inspection data
msg.payload = {
    "capture_id": captureId,
    "serial_number": serialNumber,
    "inspection_time": inspectionTime,
    "operator": global.get("current_operator") || "Unknown"
};
return msg;

5.3 靜態後設資料（固定值）​

對於在生產過程中不會改變的資訊：

// Set static metadata values
msg.payload = {
    "recipe_name": "Bolt_Inspection_v2",
    "line_number": "Line_3",
    "shift": "A_Shift",
    "station": "QC_Station_1"
};
return msg;

5.4 動態後設資料（使用檢測資料）​

對於來自檢測結果的資訊：

// Extract inspection data
const captureId = msg.payload.capture_id;
const imageUrl = msg.payload.image_url;
const predictions = msg.payload.classification?.predictions || [];

// Create dynamic metadata
msg.payload = {
    "capture_id": captureId,
    "part_number": "P" + Date.now(),
    "total_rois": predictions.length,
    "timestamp": new Date().toISOString(),
    "batch": global.get("current_batch") || "Default_Batch"
};
return msg;

第 6 步：連線後設資料以及透過/失敗流程​

6.1 所需的流程結構​

每個流程必須同時包含來自“All Block Outputs”的兩條路徑：

All Block Outputs → Function (Create Metadata) → Capture Metadata
                  ↓
                  Function (Pass/Fail Logic) → Final Pass/Fail

6.2 連線後設資料路徑​

  1. 將“All Block Outputs”輸出連線到後設資料函式的輸入
  2. 將後設資料函式輸出連線到“Capture Metadata”輸入
  3. Capture Metadata 節點可以是終端節點（不需要輸出連線）

6.3 連線透過/失敗路徑​

  1. 將“All Block Outputs”輸出連線到一個透過/失敗邏輯函式
  2. 將邏輯函式輸出連線到“Final Pass/Fail”輸入
  3. 最終透過/失敗（Final Pass/Fail）節點是強制性的 - 每個流程必須在此處結束

6.4 示例 Pass/Fail 邏輯函式​

// Extract inspection result for pass/fail decision
const predictions = msg.payload.classification?.predictions || [];

// Determine if inspection passed (all ROIs passed)
let passed = true;
for (let prediction of predictions) {
    if (!prediction.predicted_class.includes("pass")) {
        passed = false;
        break;
    }
}

// Set the pass/fail result
msg.payload = passed;
return msg;

步驟 7：後設資料配置測試​

7.1 部署與測試​

  1. 點選 'Deploy' 按鈕（右上角）
  2. 透過您配置的觸發方式觸發一次檢查（手動、數字輸入，或 PLC）
  3. 驗證：
    • 已捕獲影象
    • 與影象一起出現的後設資料
    • 已做出 Pass/fail 決定
    • 流程已成功完成

7.2 驗證完整流程​

確保兩個路徑均可正常工作：

Metadata 路徑：

  • 在主介面導航至 Library
  • 找到您的測試影象
  • 驗證影象詳情中顯示後設資料

Pass/Fail 路徑：

  • 檢查檢查結果是否顯示 Pass/fail 狀態
  • 驗證 'Final Pass/Fail' 節點是否正確處理
  • 確認任何連線輸出（PLCs、指示燈/指示器）能夠正確響應

7.3 測試不同的觸發源​

驗證後設資料是否與您特定的觸發源一起工作：

對於手動觸發：

  • 使用軟體觸發按鈕
  • 驗證每次手動捕獲時後設資料是否顯示

對於數字輸入觸發：

  • 啟用外部感測器/開關
  • 確認在觸發的影象中捕獲到後設資料

對於 PLC 觸發：

  • 從 PLC 傳送觸發訊號
  • 如適用，驗證後設資料包含 PLC 資料

Step 8: 高階後設資料配置​

8.1 來自多個全域性變數的後設資料​

將來自全域性儲存的不同源的資料進行聚合：

// Combine data from various global storage
const operatorData = global.get("operator_info") || {};
const productData = global.get("product_info") || {};
const shiftData = global.get("shift_info") || {};

msg.payload = {
    "operator": operatorData.name || "Unknown",
    "operator_id": operatorData.id || "000",
    "product_code": productData.code || "Default",
    "product_version": productData.version || "1.0",
    "shift": shiftData.current || "Day",
    "line_status": "Running",
    "timestamp": new Date().toISOString()
};
return msg;

Step 9：後設資料故障排除​

9.1 常見問題​

問題症狀解決方案
後設資料未顯示Library 中無資料驗證後設資料節點是否在 main IO Block 流中
後設資料與影象不符資料在捕獲的影象中顯示不正確檢查時序 - 後設資料必須在影象捕獲之前
觸發不起作用未捕獲影象驗證 IO Block 觸發配置
缺少後設資料欄位某些資料缺失檢查函式節點有效載荷格式
資料型別錯誤節點顯示錯誤狀態確保值僅為字串或數字

9.2 除錯後設資料流​

新增除錯節點以排查：

  1. 在觸發後新增除錯節點以驗證觸發是否工作
  2. 在後設資料函式之後新增除錯節點以檢查有效載荷
  3. 在 Capture Metadata 之後新增除錯節點以確認處理
  4. 檢查除錯面板中的錯誤訊息

步驟 10：最佳實踐​

10.1 流設計​

設計高效的後設資料流：

  • 在流程中儘早設定後設資料 - 觸發後立即設定後設資料
  • 使用單一後設資料節點 - 不要重複使用 Capture Metadata 節點
  • 保持流程連續性 - 後設資料必須是主檢查流程的一部分
  • 處理缺失資料 - 始終提供預設值

10.2 後設資料欄位命名​

使用一致、清晰的欄位命名：

  • 使用下劃線替代空格（"part_number" 而非 "part number"）
  • 描述性強但簡潔（"operator" 而非 "op"）
  • 統一使用小寫字母以保持一致性
  • 避免可能引發問題的特殊字元

10.3 效能考量​

對於高產量生產：

  • 最小化後設資料大小 - 僅包含必要資訊
  • 使用高效資料型別 - 儘可能使用數字，短字串
  • 避免複雜處理 - 讓後設資料建立簡單且快速
  • 快取全域性資料 - 將經常使用的資料儲存在全域性變數中

成功！您的後設資料系統已就緒​

現在，您的後設資料配置可以：

✅ 將自定義資訊附加到每次觸發的影象捕獲

✅ 跟蹤與檢查流程同步的生產資料

✅ 將可搜尋資訊儲存在相機庫中

✅ 在操作員使用的 HMI 上顯示相關資料

✅ 支援製造要求的可追溯性

持續維護​

定期系統檢查​

  • 驗證後設資料是否隨觸發捕獲一起出現
  • 檢查生產執行中的缺失資料
  • 在高觸發率下監控流程效能
  • 隨需求變化更新後設資料欄位

流管理​

  • 檢查生產中的後設資料時序
  • 最佳化函式節點效能
  • 更新全域性變數管理
  • 培訓操作員進行基於觸發的操作

下一步​

在設定基於觸發的後設資料之後：

  1. 使用所有配置的觸發型別（手動、數字、PLC）進行測試
  2. 培訓操作員正確使用觸發以捕獲後設資料
  3. 設定全域性變數管理以實現動態資料
  4. 為不同產品線建立後設資料模板
  5. 使用後設資料分析實現生產監控

🔗 相關內容​