Appearance
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)
- Step IDs: ต้องตรงกับรูปแบบ
[a-z][a-z0-9_]{0,31} - การอ้างอิง Step: อ้างอิงได้เฉพาะ Step ก่อนหน้าที่
enabled: trueหรือ"frame"เท่านั้น (ห้ามอ้างอิงไปข้างหน้าหรือวนลูป) - Templates & Paths: Path ของไฟล์ Template และ
source.deviceId(สำหรับfiles/video) ต้องเป็น Relative Path เทียบกับโฟลเดอร์ของ Recipe เท่านั้น ห้ามใช้ Absolute Path หรือ.. - Parameters & Rules: ห้ามมี Key แปลกปลอม, ชนิดข้อมูลต้องตรงกับ
ParamSpec, และกฎในdecideต้องอ้างอิง Metric ที่โมดูลต้นทางสร้างได้จริง
3. แหล่งที่มาของภาพ (ICamera / source)
Session (src/runtime/session.cpp) จะสร้างอินสแตนซ์กล้องตามค่า source.type:
source.type | คลาสที่ใช้งาน | deviceId | รายละเอียด |
|---|---|---|---|
"files" | FileCamera | Relative path ของโฟลเดอร์ภาพ | อ่านไฟล์ภาพในโฟลเดอร์เรียงตามชื่อไฟล์ (ใช้ร่วมกันทั้ง Console และ Golden Tests) |
"video" | VideoCamera | Relative 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 (พิมพ์สถานะออกหน้าจอ)