פתרון בעיות והגדרת מצלמה בפריגטה

הגדרת מערכת מעקב וידאו עם Frigate מאפשרת לך לזהות אנשים, כלי רכב וחפצים אחרים מבלי לשלוח הקלטות לענן. עם זאת, במהלך ההתקנה, די נפוץ להיתקל ב... מצלמה שלא מציגה תמונה, שידור חי שנקטע או הודעות המציינות ש-FFmpeg לא יכול לקבל פריימים.

כשלים אלה אינם קשורים בדרך כלל לבינה מלאכותית. ברוב המקרים, המקור טמון ב... כתובת URL שגויה של RTSPייתכן שהגורם לכך הוא אישורים לא חוקיים, שידור לא תואם, בעיית רשת או שגיאה בתצורת ה-Frigate. הדרך המהירה ביותר לפתור בעיות היא לבדוק כל רכיב בנפרד: תחילה את המצלמה, אחר כך את השידור, אחר כך את Frigate, ולבסוף שירותים נוספים כגון go2rtc, MQTT או Home Assistant.

ראשית, בדוק את חיבור המצלמה.

לפני שינוי קובץ התצורה, ודא שהמצלמה פועלת באופן עצמאי. פריגטה זקוקה לגישה לשידור תואם, בדרך כלל דרך RTSPלמרות שחלק מהדגמים משתמשים בפורמטים אחרים כגון HTTP-FLV.

עבור לאפליקציית המצלמה או ללוח הניהול ובדוק שגישה מקומית, RTSP או ONVIF מופעלים. חלק מהיצרנים דורשים גם שתיצור חשבון ספציפי עבור יישומים חיצוניים, שונה מזו המשמשת לגישה לשירותי הענן שלה.

מומלץ גם להקצות כתובת IP סטטית למצלמה מהנתב שלך. אם הכתובת שלה משתנה לאחר הפעלה מחדש, פריגייט תמשיך לנסות להתחבר לכתובת ה-IP הישנה, ​​והווידאו יפסיק לעבוד.

לכיוון הזרם יש בדרך כלל מבנה דומה לזה:

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

הנתיב המדויק תלוי ביצרן ובדגם. כדי לבדוק אם הוא נכון, פתח את כתובת האתר מ... VLC או ffplayאם זה לא עובד גם על הנגנים האלה, לא כדאי להתעסק עם Frigate עדיין: תצטרכו לבדוק את כתובת ה-IP, הפורט, האישורים והנתיב שסיפקה המצלמה.

אם הסיסמה מכילה תווים כמו @, #, : o /אלה עלולים לשבור את כתובת ה-URL. במקרה כזה, השתמש במשתני סביבה התואמים ל-Frigate או קודד כראוי את התווים המיוחדים.

הוסף את המצלמה באמצעות אשף הפריגטה

בגרסאות הנוכחיות, הדרך המומלצת להוסיף מצלמה היא להשתמש באשף הכלול בממשק. עבור אל הגדרות > תצורה גלובלית > ניהול מצלמה ובחר הוסף מצלמה.

האשף מאפשר לך להזין את כתובת ה-IP והאישורים, לחפש פרופילים באמצעות ONVIF, או להזין ידנית את כתובת ה-URL של RTSP. לאחר מכן הוא בודק כל זרם, מציג צילום מסך ומאפשר לך להקצות את הפונקציות שלו.

• לְגַלוֹת: זרם המשמש לזיהוי תנועה ועצמים.
• רְשׁוּמָה: זרם שקטעיו יישמרו כהקלטות.
• שֶׁמַע: זרם המשמש לזיהוי צליל.

הדבר הרגיל הוא להשתמש ב- תת-זרם ברזולוציה נמוכה יותר לזיהוי והזרם הראשי להקלטה. בדרך זו, פריגייט מנתחת תמונה בהירה יותר, אך שומרת על ההקלטות באיכות המקורית.

העוזר מזהה גם בעיות נפוצות, כגון רזולוציה מוגזמת לזיהוי, היעדר זרם עם התפקיד 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 "לא התקבלו מסגרות" הם מציינים שהתהליך האחראי על צילום הסרטון אינו מספק תמונות לפריגטה.

פתחו את יומני הרישום מקטע המערכת ואתרו את השורות המתאימות למצלמה המושפעת. הסיבות הנפוצות ביותר הן:

• כתובת ה-IP של המצלמה השתנתה.
• שם המשתמש או הסיסמה שגויים.
• נתיב ה-RTSP שייך לדגם מצלמה אחר.
• הקושחה מגבילה את מספר החיבורים בו זמנית.
• המצלמה מאבדת קליטת WiFi או מפעילה מחדש את השידור.
• הוגדרה האצת וידאו לא תואמת.
• הקודק או הפרמטרים הנפלטים על ידי המצלמה אינם תקינים.

אם אתם משתמשים ב-go2rtc, בדקו גם את מצב הסטרימינג מ- /api/go2rtc/streamsזה מאפשר לך לבדוק אם go2rtc יכול להתחבר למצלמה ואילו רכיבי codec הוא מקבל.

כאשר מצלמה מציעה פרוטוקולי תעבורה מרובים, בדיקת RTSP דרך TCP יכולה לשפר את היציבות ברשתות בהן מתרחש אובדן חבילות. עם זאת, חיבור Ethernet נותר עדיף על פני Wi-Fi עבור מצלמות שמשדרות וידאו באופן רציף.

הסרטון עובד, אבל פריגייט לא שומר הקלטות.

העובדה שהתמונה מופיעה בשידור חי אינה אומרת שההקלטות מוגדרות כהלכה. כדי לשמור וידאו, יש לעמוד בשלושה תנאים: חייב להתקיים שידור עם התפקיד. 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 כמועמד. הכתובת האמיתית של שרת הפריגטה אשר נגיש ממכשיר הלקוח.

ניתן להשתמש בפרוקסי הפוך של HTTP כמו Traefik כדי לגשת לממשק האינטרנט, אך הוא אינו מחליף את חשיפת הפורטים המשמשים ישירות את RTSP או WebRTC.

הפחתת ניצול המעבד בצורה נכונה

פריגטה מבצעת מספר משימות שונות, וכל אחת מהן עשויה להשתמש ברכיב שונה. פענוח וידאו זה מתאים ל-FFmpeg וניתן להאיץ אותו באמצעות GPU משולב או ייעודי. זיהוי עצמיםבמקום זאת, הוא משתמש בגלאי כגון Coral, Hailo, OpenVINO, ONNX או TensorRT.

כונן USB של Coral יכול להפחית משמעותית את העבודה הנדרשת להפעלת מודל הזיהוי, אך הוא אינו מאיץ באופן טבעי את פענוח הזרם. לשם כך, עליך להגדיר הגדרה מוגדרת מראש של hwaccel_args תואם לחומרת שרת.

לדוגמה, מערכות אינטל ו-AMD תואמות רבות יכולות להשתמש ב:

ffmpeg:
  hwaccel_args: preset-vaapi

אין להעתיק ערך זה מבלי לוודא תאימות עם הציוד שלך. תצורה שגויה עלולה לגרום ל-FFmpeg לקרוס שוב ושוב, מכיוון שלא תמיד יש החלפת תוכנה אוטומטית כאשר התאוצה שנבחרה נכשלת.

יתר על כן, הימנעו מפירוש נתוני ניצול המעבד של Frigate כמייצגים את המעבד כולו. בסטטיסטיקה שלהם, תהליך של 100% בדרך כלל פירושו שהוא משתמש במעבד כולו. ליבה אחתכדי לחשב את הצריכה הכוללת, השוו את הנתונים עם docker stats או עם צג מערכת המארח.

כדי להפחית את העומס מבלי להשפיע על ההקלטות:

• השתמש בתת-זרם כדי detect.
• בדרך כלל מגדירים את הזיהוי לכ-5 פריימים לשנייה.
• שמור את הזרם ברזולוציה גבוהה עבור record.
• הפעל פענוח חומרה תואם.
• השתמש בגלאי מתאים במקום בגלאי המעבד לבדיקה.
• הימנעו מפתיחת מספר חיבורים מיותרים לאותה מצלמה.

רשימת בדיקה אם מצלמה עדיין לא עובדת

1. ודא שהמצלמה מגיבה בכתובת ה-IP שלה.
2. ודא את כתובת האתר המדויקת באמצעות VLC או ffplay.
3. ודא ש-RTSP או ONVIF מופעלים במצלמה.
4. בדוק את שם המשתמש, הסיסמה, היציאה והתווים המיוחדים.
5. נסה להזרים מאשף הוספת מצלמות הפריגטה.
6. בדוק את התפקידים detect y record.
7. בדוק את יומני ה-FFmpeg והלכידה.
8. השבתה זמנית hwaccel_args אם FFmpeg יופעל מחדש.
9. בדוק את הזרמים של go2rtc ואת השמות שבהם נעשה שימוש בשידור מחדש.
10. בדקו את המקום, את ההתקנה ואת ההיתרים של /media/frigate.
11. ודא ש-Frigate ו-Home Assistant משתמשים באותו מתווך MQTT.
12. חשוף כראוי את פורטים 8554 ו-8555 אם אתה זקוק ל-RTSP או WebRTC.

ביצוע סדר זה מונע שינוי של מספר אפשרויות בו זמנית ומאפשר לך לאתר במדויק היכן השידור נקטע. אם המצלמה פועלת ב-VLC, השידור מופיע כהלכה ב-go2rtc, ו-FFmpeg לא מציג שגיאות, הבעיה קשורה בדרך כלל לתפקידים, שמירת הקלטה או האינטגרציה שבה משתמשים להצגת הסרטון.

תצורה יציבה תלויה בהפרדה נכונה של כל פונקציה: זרם קל משקל לניתוח תמונה, זרם באיכות גבוהה יותר להקלטה, האצה ייעודית לפענוח וגלאי מתאים לבינה מלאכותית. בעזרת מבנה זה, פריגטה יכולה לפעול למשך תקופות ממושכות ללא הפרעות או צריכת משאבים מוגזמת.