Skip to content

WP Machine Vision — คู่มือส่วน Runtime & I/O ​

ส่วน Runtime (src/runtime/) และ I/O (src/io/) ทำหน้าที่เป็นตัวกลางเชื่อมต่อโลกภายนอก (ไฟล์ Recipe, กล้อง, ระบบบันทึกผล NG, และสัญญาณ I/O) เข้ากับแกนประมวลผลภาพ (RecipeRunner และ 9 Tools) โดยแยกส่วน JSON และ I/O ออกจาก src/core/ และ src/tools/ อย่างชัดเจน


1. วงจรการทำงานต่อ 1 รอบ (Cycle Execution Loop) ​

ในทุกๆ รอบการตรวจสอบ ระบบจะทำงานตามลำดับควบคุมเดียว (Single Control Flow) ดังนี้:

กฎเหล็กด้าน Fail-Safe

  • Timeout, Exception, ภาพว่าง, หรือ Tool คืนค่า Status::Error จะหยุดกราฟทันทีและเรียก IIoSink::setFailSafe() โดยไม่มีทางเรียก publish(true) ได้
  • ค่า pass ไม่ถูกส่งต่อข้ามรอบ (No state carried forward)

2. โครงสร้างไฟล์ Recipe (recipe.wps.json) ​

ระบบรองรับเฉพาะ "schema": 1 เท่านั้น (หากเป็นเวอร์ชันอื่นจะปฏิเสธการโหลดทันที) โดยแบ่งกลุ่มข้อมูลระดับบนดังนี้:

json
{
  "schema": 1,
  "product": "wp.vision",
  "id": "oring-001",
  "name": "O-ring presence and span",
  "calibration": { "pxPerMm": 45.2 },
  "source": {
    "type": "files",
    "deviceId": "images",
    "trigger": "software",
    "timeoutMs": 500,
    "pixelFormat": "mono8"
  },
  "templates": {
    "body": "templates/body.png"
  },
  "steps": [
    {
      "id": "gray",
      "type": "to_gray",
      "enabled": true,
      "params": {},
      "inputs": { "image": "frame" }
    }
  ],
  "log": {
    "directory": "logs",
    "saveNgImage": true,
    "saveOverlay": true,
    "saveMetrics": true,
    "maxFiles": 500
  },
  "io": {
    "protocol": "modbus_tcp",
    "endpoint": "192.168.0.10:502",
    "passCoil": 0,
    "failCoil": 1
  }
}

กฎการตรวจสอบตอนโหลด (Load-time Validation) ​

  1. Step IDs: ต้องตรงกับรูปแบบ [a-z][a-z0-9_]{0,31}
  2. การอ้างอิง Step: อ้างอิงได้เฉพาะ Step ก่อนหน้าที่ enabled: true หรือ "frame" เท่านั้น (ห้ามอ้างอิงไปข้างหน้าหรือวนลูป)
  3. Templates & Paths: Path ของไฟล์ Template และ source.deviceId (สำหรับ files/video) ต้องเป็น Relative Path เทียบกับโฟลเดอร์ของ Recipe เท่านั้น ห้ามใช้ Absolute Path หรือ ..
  4. Parameters & Rules: ห้ามมี Key แปลกปลอม, ชนิดข้อมูลต้องตรงกับ ParamSpec, และกฎใน decide ต้องอ้างอิง Metric ที่โมดูลต้นทางสร้างได้จริง

3. แหล่งที่มาของภาพ (ICamera / source) ​

Session (src/runtime/session.cpp) จะสร้างอินสแตนซ์กล้องตามค่า source.type:

source.typeคลาสที่ใช้งานdeviceIdรายละเอียด
"files"FileCameraRelative path ของโฟลเดอร์ภาพอ่านไฟล์ภาพในโฟลเดอร์เรียงตามชื่อไฟล์ (ใช้ร่วมกันทั้ง Console และ Golden Tests)
"video"VideoCameraRelative path ของไฟล์วิดีโอรองรับไฟล์ .mp4 และ .avi
"uvc"UvcCameraดัชนีกล้อง เช่น "0", "1"เปิดกล้อง USB/UVC ผ่าน OpenCV (ต้องเป็นตัวเลขไม่มีเลข 0 นำหน้า ยกเว้น "0")

หมายเหตุเรื่อง "camera"

source.type: "camera" สำหรับ Industrial Camera SDK ถูกสงวนไว้สำหรับ Phase ถัดไป ปัจจุบัน Runtime จะแจ้งเตือนว่ายังไม่มี Backend รองรับ


4. ระบบบันทึกผล NG (ng_logger) ​

เมื่อรอบการทำงานจบลงด้วย !result.pass (ไม่ว่าจะ Fail จากกฎใน decide หรือเกิด Error/Timeout) ระบบจะบันทึกหลักฐานลงในโฟลเดอร์ log.directory (Relative path):

  • ไฟล์ภาพ: YYYYMMDD_HHMMSS_fail.png (หากเกิดซ้ำในวินาทีเดียวกัน จะต่อท้ายด้วย _2, _3 ตามลำดับ)
    • หาก saveOverlay: true ระบบจะวาด Overlay (สีเขียว = ผ่าน/พบ, สีแดง = ไม่ผ่าน/ไม่พบ) ลงบนสำเนาภาพสี โดยไม่ยุ่งกับ Buffer ภาพต้นฉบับ
  • ไฟล์ข้อมูล JSON: YYYYMMDD_HHMMSS_fail.json (ชื่อคู่กัน) เก็บข้อมูล recipeId, timestamp, reasons, และค่า Metrics ของทุก Step
  • การหมุนเวียนไฟล์ (maxFiles): เมื่อจำนวนไฟล์เกิน log.maxFiles ระบบจะลบไฟล์ที่เก่าที่สุดออกอัตโนมัติ

5. ระบบส่งออกสัญญาณ (IIoSink) ​

ฟังก์ชัน applyCycleResult(IIoSink& io, const CycleResult& result) ใน src/runtime/ng_logger.cpp ทำหน้าที่ส่งออกผลลัพธ์:

  • หาก result.status != Status::Ok → เรียก io.setFailSafe()
  • หาก result.status == Status::Ok → เรียก io.publish(result.pass)

ใน Phase 1 มี Implementation สำหรับทดสอบและแสดงผลบน Console ได้แก่ FakeIoSink (บันทึกประวัติการเรียกใช้เพื่อทำ Unit Test) และ ConsoleIoSink (พิมพ์สถานะออกหน้าจอ)