การแก้ไขปัญหาและการตั้งค่ากล้องบนเรือฟริเกต

การติดตั้งระบบกล้องวงจรปิดด้วย Frigate ช่วยให้คุณตรวจจับคน ยานพาหนะ และวัตถุอื่นๆ ได้โดยไม่ต้องส่งบันทึกไปยังระบบคลาวด์ อย่างไรก็ตาม ในระหว่างการติดตั้ง มักจะพบปัญหาบางอย่างได้ กล้องที่ไม่แสดงภาพการถ่ายทอดสดที่หยุดชะงัก หรือข้อความแจ้งว่า FFmpeg ไม่สามารถรับเฟรมได้

ความล้มเหลวเหล่านี้มักไม่เกี่ยวข้องกับปัญญาประดิษฐ์ ในกรณีส่วนใหญ่ สาเหตุมาจาก... URL RTSP ไม่ถูกต้องข้อมูลรับรองไม่ถูกต้อง สตรีมไม่เข้ากัน ปัญหาเครือข่าย หรือข้อผิดพลาดในการตั้งค่า Frigate อาจเป็นสาเหตุ วิธีแก้ไขปัญหาที่เร็วที่สุดคือการตรวจสอบแต่ละส่วนประกอบแยกกัน: เริ่มจากกล้องก่อน จากนั้นสตรีม จากนั้น Frigate และสุดท้ายบริการเพิ่มเติม เช่น go2rtc, MQTT หรือ Home Assistant

ขั้นแรก ตรวจสอบการเชื่อมต่อของกล้อง

ก่อนแก้ไขไฟล์การกำหนดค่า โปรดตรวจสอบให้แน่ใจว่ากล้องทำงานได้อย่างอิสระ Frigate จำเป็นต้องเข้าถึงสตรีมที่เข้ากันได้ ซึ่งโดยปกติจะทำได้ผ่านทาง อาร์ทีเอสพีแม้ว่าบางรุ่นจะใช้รูปแบบอื่น เช่น HTTP-FLV ก็ตาม

ไปที่แอปของกล้องหรือแผงควบคุมผู้ดูแลระบบ แล้วตรวจสอบว่าได้เปิดใช้งานการเข้าถึงแบบโลคอล, RTSP หรือ ONVIF แล้ว ผู้ผลิตบางรายอาจกำหนดให้คุณสร้างบัญชีผู้ใช้เพิ่มเติมด้วย บัญชีเฉพาะสำหรับแอปพลิเคชันภายนอกซึ่งแตกต่างจากที่ใช้ในการเข้าถึงบริการคลาวด์

ขอแนะนำให้กำหนดที่อยู่ IP แบบคงที่ให้กับกล้องจากเราเตอร์ของคุณด้วย หากที่อยู่ IP เปลี่ยนไปหลังจากรีสตาร์ท Frigate จะพยายามเชื่อมต่อกับที่อยู่ IP เดิม และวิดีโอจะหยุดทำงาน

ทิศทางการไหลของกระแสน้ำมักมีโครงสร้างคล้ายกับแบบนี้:

rtsp://usuario:contraseñ[email protected]:554/ruta_del_stream

เส้นทางที่ถูกต้องจะขึ้นอยู่กับผู้ผลิตและรุ่น หากต้องการตรวจสอบว่าถูกต้องหรือไม่ ให้เปิด URL จาก VLC หรือ ffplayหากวิธีนี้ไม่ได้ผลกับผู้เล่นเหล่านี้เช่นกัน ก็ยังไม่คุ้มที่จะไปยุ่งกับ Frigate ในตอนนี้ คุณต้องตรวจสอบที่อยู่ IP พอร์ต ข้อมูลประจำตัว และเส้นทางที่กล้องให้มา

หากรหัสผ่านมีอักขระเช่นนี้ @, #, : o /สิ่งเหล่านี้อาจทำให้ URL เสียหายได้ ในกรณีนั้น ให้ใช้ตัวแปรสภาพแวดล้อมที่เข้ากันได้กับ Frigate หรือเข้ารหัสอักขระพิเศษอย่างถูกต้อง

เพิ่มกล้องโดยใช้ตัวช่วยสร้างเรือฟริเกต

ในเวอร์ชันปัจจุบัน วิธีที่แนะนำในการเพิ่มกล้องคือการใช้ตัวช่วยสร้างที่มีอยู่ในอินเทอร์เฟซ ไปที่ การตั้งค่า > การกำหนดค่าทั่วไป > การจัดการกล้อง และเลือก เพิ่มกล้อง.

ตัวช่วยสร้างนี้จะช่วยให้คุณป้อนที่อยู่ IP และข้อมูลประจำตัว ค้นหาโปรไฟล์โดยใช้ ONVIF หรือป้อน URL RTSP ด้วยตนเอง จากนั้นจะทดสอบแต่ละสตรีม แสดงภาพหน้าจอ และช่วยให้คุณกำหนดฟังก์ชันต่างๆ ได้

• ตรวจจับ: สตรีมที่ใช้ในการตรวจจับการเคลื่อนไหวและวัตถุ
• บันทึก: การสตรีมที่มีส่วนต่างๆ จะถูกบันทึกเป็นไฟล์บันทึก
• เสียง: สตรีมที่ใช้สำหรับการตรวจจับเสียง

โดยปกติแล้วจะใช้ สตรีมย่อยที่มีความละเอียดต่ำกว่าเพื่อตรวจจับ และกระแสหลักสำหรับการบันทึก ด้วยวิธีนี้ Frigate จะวิเคราะห์ภาพที่เบากว่า แต่ยังคงรักษาคุณภาพของการบันทึกไว้เช่นเดิม

ผู้ช่วยยังตรวจจับปัญหาทั่วไป เช่น ความละเอียดในการตรวจจับสูงเกินไป หรือการไม่มีสตรีมที่มีบทบาทที่กำหนด detect หรือตัวแปลงสัญญาณเสียงที่ไม่เข้ากัน

ตรวจสอบการกำหนดค่า YAML และบทบาทของแต่ละสตรีม

คุณยังสามารถกำหนดค่ากล้องด้วยตนเองโดยใช้ YAML ได้อีกด้วย รูปแบบนี้ใช้การเว้นวรรคเพื่อแสดงโครงสร้าง ดังนั้น คุณไม่ควรใช้แท็บ และไม่ควรผสมปริมาณช่องว่างที่แตกต่างกัน

การตั้งค่าพื้นฐานที่มีสตรีมสองสตรีมอาจมีลักษณะดังนี้:

mqtt:
  enabled: false

record:
  enabled: true
  continuous:
    days: 3

cameras:
  entrada:
    ffmpeg:
      inputs:
        - path: rtsp://usuario:{FRIGATE_RTSP_PASSWORD}@192.168.1.50:554/substream
          roles:
            - detect
        - path: rtsp://usuario:{FRIGATE_RTSP_PASSWORD}@192.168.1.50:554/mainstream
          roles:
            - record
    detect:
      width: 1280
      height: 720
      fps: 5

เส้นทางเหล่านี้เป็นเพียงตัวอย่างและควรแทนที่ด้วยเส้นทางที่ตรงกับกล้องของคุณ รหัสผ่านสามารถเก็บไว้ในตัวแปรที่มีชื่อขึ้นต้นด้วย FRIGATE_หลีกเลี่ยงการเปิดเผยข้อมูลโดยตรงในไฟล์

แทนที่จะพึ่งพาตัวตรวจสอบ YAML ทั่วไปเพียงอย่างเดียว ให้ใช้... โปรแกรมแก้ไขการกำหนดค่าเรือฟริเกตโปรแกรมตรวจสอบความถูกต้องภายนอกสามารถตรวจจับข้อผิดพลาดด้านการเว้นวรรคได้ แต่ไม่ทราบว่าคีย์เฉพาะนั้นมีอยู่จริงหรือไม่ หรือเข้ากันได้กับเวอร์ชันที่ติดตั้งไว้หรือไม่

ควรทำอย่างไรหากพบข้อผิดพลาด "ไม่มีเฟรม"

ข้อความเช่น “ไม่สามารถอ่านเฟรมจากกระบวนการ ffmpeg ได้” o “ไม่ได้รับเฟรมภาพใดๆ” ข้อมูลดังกล่าวระบุว่า กระบวนการที่รับผิดชอบในการบันทึกวิดีโอไม่ได้ส่งภาพไปยัง Frigate

เปิดไฟล์บันทึกจากส่วนระบบและค้นหาบรรทัดที่ตรงกับกล้องที่มีปัญหา สาเหตุที่พบบ่อยที่สุด ได้แก่:

• ที่อยู่ IP ของกล้องเปลี่ยนไปแล้ว
• ชื่อผู้ใช้หรือรหัสผ่านไม่ถูกต้อง
• เส้นทาง RTSP เป็นของกล้องรุ่นอื่น
• เฟิร์มแวร์จำกัดจำนวนการเชื่อมต่อพร้อมกัน
• กล้องสูญเสียสัญญาณ WiFi หรือเริ่มการถ่ายทอดสดใหม่
• มีการตั้งค่าการเร่งความเร็ววิดีโอที่ไม่เข้ากัน
• ตัวแปลงสัญญาณหรือพารามิเตอร์ที่ส่งมาจากกล้องไม่ถูกต้อง

หากคุณใช้ go2rtc โปรดตรวจสอบสถานะของสตรีมจาก go2rtc ด้วย /api/go2rtc/streamsวิธีนี้ช่วยให้คุณตรวจสอบได้ว่า go2rtc สามารถเชื่อมต่อกับกล้องได้หรือไม่ และกล้องรับข้อมูลในรูปแบบโคเดกใดบ้าง

เมื่อกล้องรองรับโปรโตคอลการส่งข้อมูลหลายแบบ การทดสอบ RTSP ผ่าน TCP สามารถช่วยเพิ่มเสถียรภาพบนเครือข่ายที่มีการสูญหายของแพ็กเก็ตได้ อย่างไรก็ตาม การเชื่อมต่ออีเธอร์เน็ตยังคงเป็นตัวเลือกที่ดีกว่า Wi-Fi สำหรับกล้องที่ส่งวิดีโออย่างต่อเนื่อง

วิดีโอใช้งานได้ แต่ Frigate ไม่บันทึกวิดีโอไว้

การที่ภาพปรากฏขึ้นแบบเรียลไทม์ไม่ได้หมายความว่าการบันทึกได้รับการตั้งค่าอย่างถูกต้อง ในการบันทึกวิดีโอ ต้องมีเงื่อนไขสามประการดังนี้: ต้องมีสตรีมที่มีบทบาทดังกล่าวอยู่แล้ว recordต้องเปิดใช้งานการบันทึกและต้องกำหนดนโยบายการเก็บรักษาข้อมูลไว้แล้ว

กุญแจโบราณ retain_days ไม่ควรใช้การตั้งค่านี้ในระบบปัจจุบัน หากต้องการบันทึกวิดีโอทั้งหมดตลอดสามวัน โครงสร้างที่ถูกต้องคือ:

record:
  enabled: true
  continuous:
    days: 3

หากคุณต้องการลดการใช้พื้นที่ดิสก์และเก็บเฉพาะข้อมูลจากช่วงเวลาที่มีการเคลื่อนไหว คุณสามารถใช้คำสั่งต่อไปนี้:

record:
  enabled: true
  motion:
    days: 3
  alerts:
    retain:
      days: 10
      mode: motion
  detections:
    retain:
      days: 10
      mode: motion

ไฟล์บันทึกจะถูกจัดเก็บไว้ภายใน /media/frigate/recordingsตรวจสอบให้แน่ใจว่าไดรฟ์ถูกเมานต์ในตำแหน่งที่ถูกต้อง มีสิทธิ์ในการเขียน และมีพื้นที่เพียงพอ การเมานต์ที่ไม่ถูกต้องอาจทำให้ Frigate เขียนข้อมูลลงในดิสก์ระบบโดยไม่ตั้งใจและทำให้ดิสก์เต็มอย่างรวดเร็ว

คุณควรพิจารณาเรื่องตัวแปลงสัญญาณด้วย การบันทึกแบบ H.265 อาจใช้ไม่ได้กับทุกเบราว์เซอร์ ในขณะที่ H.264 มีความเข้ากันได้ดีกว่ามาก หากไฟล์มีอยู่แต่เล่นไม่ได้จากหน้าจอแสดงผล ปัญหาอาจอยู่ที่เบราว์เซอร์ ไม่ใช่กล้อง

การเชื่อมต่อกับ Home Assistant และ MQTT

ในการเชื่อมต่อ Frigate กับ Home Assistant คุณต้องติดตั้งส่วนเสริม Frigate และกำหนดค่าการเชื่อมต่อ MQTT ก่อน นอกจากนี้ ทั้งสองระบบต้องเชื่อมต่อกับเครือข่ายด้วย โบรกเกอร์ MQTT ตัวเดียวกัน เพื่อให้เอนทิตี้ เซ็นเซอร์ และตัวนับจำนวนมากทำงานได้อย่างถูกต้อง

การกำหนดค่าพื้นฐานจะเป็นดังนี้:

mqtt:
  enabled: true
  host: 192.168.1.20
  user: frigate
  password: "{FRIGATE_MQTT_PASSWORD}"

เมื่อเพิ่มการเชื่อมต่อกับ Home Assistant คุณต้องระบุ URL ภายในของ Frigate ด้วย โดยสามารถใช้พอร์ตได้ 5000ซึ่งไม่ได้รวมการตรวจสอบสิทธิ์ หรือ 8971ซึ่งให้การเข้าถึงที่ต้องมีการตรวจสอบสิทธิ์ พอร์ต 5000 ควรเปิดใช้งานเฉพาะภายในเครือข่ายที่เชื่อถือได้เท่านั้น

สำหรับการรับชมวิดีโอสด การแยกความแตกต่างระหว่างพอร์ตสองพอร์ตนั้นมีประโยชน์:

• 8554: การสตรีม RTSP ใหม่ให้บริการโดย go2rtc
• 8555. โปรโตคอล TCP และ UDP: การเชื่อมต่อ WebRTC

สามารถเปิดการสตรีมซ้ำได้โดยใช้ที่อยู่เช่น rtsp://IP_DEL_SERVIDOR:8554/nombre_streamหาก Home Assistant อยู่ในเครือข่ายอื่น VLAN อื่น หรืออยู่หลังพร็อกซีบางตัว อาจจำเป็นต้องกำหนดค่า WebRTC ให้เป็นตัวเลือกที่เหมาะสม ที่อยู่จริงของเซิร์ฟเวอร์ Frigate ซึ่งสามารถเข้าถึงได้จากอุปกรณ์ของลูกค้า

สามารถใช้ HTTP reverse proxy เช่น Traefik เพื่อเข้าถึงเว็บอินเทอร์เฟซได้ แต่ไม่สามารถทดแทนการเปิดพอร์ตที่ใช้โดยตรงโดย RTSP หรือ WebRTC ได้

ลดการใช้งาน CPU อย่างถูกต้อง

เรือฟริเกตสามารถปฏิบัติภารกิจได้หลายอย่าง และแต่ละภารกิจอาจใช้ส่วนประกอบที่แตกต่างกัน การถอดรหัสวิดีโอ นี่ตรงกับ FFmpeg และสามารถเร่งความเร็วได้ด้วย GPU ในตัวหรือ GPU เฉพาะ การตรวจจับวัตถุแต่จะใช้ตัวตรวจจับ เช่น Coral, Hailo, OpenVINO, ONNX หรือ TensorRT แทน

Coral USB สามารถลดภาระงานที่จำเป็นในการเรียกใช้โมเดลการตรวจจับได้อย่างมาก แต่ไม่ได้ช่วยเร่งความเร็วในการถอดรหัสสตรีมโดยธรรมชาติ สำหรับการนั้น คุณต้องกำหนดค่าพรีเซ็ตของ hwaccel_args ใช้งานร่วมกับฮาร์ดแวร์เซิร์ฟเวอร์ได้

ตัวอย่างเช่น ระบบ Intel และ AMD ที่ใช้งานร่วมกันได้หลายระบบสามารถใช้สิ่งต่อไปนี้ได้:

ffmpeg:
  hwaccel_args: preset-vaapi

คุณไม่ควรคัดลอกค่านี้โดยไม่ตรวจสอบความเข้ากันได้กับอุปกรณ์ของคุณก่อน การกำหนดค่าที่ไม่ถูกต้องอาจทำให้ FFmpeg หยุดทำงานซ้ำ ๆ เนื่องจากไม่มีการแทนที่ซอฟต์แวร์โดยอัตโนมัติเสมอไปเมื่อการเร่งความเร็วที่เลือกไว้ล้มเหลว

นอกจากนี้ ควรหลีกเลี่ยงการตีความตัวเลขการใช้งาน CPU ของ Frigate ว่าหมายถึงการใช้งานโปรเซสเซอร์ทั้งหมด ในสถิติของพวกเขา กระบวนการที่ใช้ CPU 100% โดยทั่วไปหมายความว่ากำลังใช้โปรเซสเซอร์ทั้งหมด แกนเดี่ยวเพื่อหาปริมาณการบริโภคทั้งหมด ให้เปรียบเทียบข้อมูลกับ docker stats หรือใช้โปรแกรมตรวจสอบระบบโฮสต์ก็ได้

เพื่อลดภาระการทำงานโดยไม่กระทบต่อการบันทึก:

• ใช้สตรีมย่อยเพื่อ detect.
• ตั้งค่าการตรวจจับไว้ที่ประมาณ 5 เฟรมต่อวินาที
• สำรองการสตรีมความละเอียดสูงไว้สำหรับ record.
• เปิดใช้งานการถอดรหัสฮาร์ดแวร์ที่เข้ากันได้
• ให้ใช้ตัวตรวจจับที่เหมาะสมแทนตัวตรวจจับ CPU สำหรับการทดสอบ
• หลีกเลี่ยงการเปิดการเชื่อมต่อที่ไม่จำเป็นหลายรายการกับกล้องตัวเดียวกัน

รายการตรวจสอบหากกล้องยังคงใช้งานไม่ได้

1. ตรวจสอบว่ากล้องตอบสนองตามที่อยู่ IP ของมันหรือไม่
2. ตรวจสอบ URL ที่ถูกต้องโดยใช้ VLC หรือ ffplay
3. ตรวจสอบให้แน่ใจว่าได้เปิดใช้งาน RTSP หรือ ONVIF บนกล้องแล้ว
4. ตรวจสอบชื่อผู้ใช้ รหัสผ่าน พอร์ต และอักขระพิเศษ
5. ลองใช้ตัวช่วยเพิ่มกล้อง Frigate ในการสตรีมดู
6. ตรวจสอบบทบาทต่างๆ detect y record.
7. ตรวจสอบบันทึกการทำงานของ FFmpeg และไฟล์บันทึกการจับภาพ
8. ปิดใช้งานชั่วคราว hwaccel_args หาก FFmpeg รีสตาร์ท
9. ตรวจสอบสตรีม go2rtc และชื่อที่ใช้ในการรีสตรีม
10. ตรวจสอบพื้นที่ การจัดวาง และใบอนุญาตของสถานที่นั้นๆ /media/frigate.
11. ตรวจสอบให้แน่ใจว่า Frigate และ Home Assistant ใช้โบรกเกอร์ MQTT เดียวกัน
12. หากต้องการใช้งาน RTSP หรือ WebRTC โปรดเปิดพอร์ต 8554 และ 8555 อย่างถูกต้อง

การทำตามลำดับนี้จะช่วยหลีกเลี่ยงการเปลี่ยนแปลงตัวเลือกหลายอย่างพร้อมกัน และช่วยให้คุณระบุจุดที่สตรีมถูกขัดจังหวะได้ หากกล้องทำงานใน VLC สตรีมแสดงผลได้อย่างถูกต้องใน go2rtc และ FFmpeg ไม่แสดงข้อผิดพลาดใดๆ ปัญหาโดยทั่วไปมักเกี่ยวข้องกับบทบาท การเก็บรักษาการบันทึก หรือการรวมระบบที่ใช้ในการแสดงวิดีโอ

การกำหนดค่าที่เสถียรขึ้นอยู่กับการแยกฟังก์ชันแต่ละอย่างอย่างเหมาะสม ได้แก่ สตรีมข้อมูลขนาดเล็กสำหรับการวิเคราะห์ภาพ สตรีมข้อมูลคุณภาพสูงสำหรับการบันทึก การเร่งความเร็วเฉพาะสำหรับการถอดรหัส และตัวตรวจจับที่เหมาะสมสำหรับปัญญาประดิษฐ์ ด้วยโครงสร้างนี้ Frigate สามารถทำงานได้เป็นระยะเวลานานโดยไม่หยุดชะงักหรือใช้ทรัพยากรมากเกินไป