פתרון בעיות בתקן Matter

מבנה

מוודאים שהטלפון תואם

כל המכשירים עם Android מגרסה Android O (8.1, API ברמה 27) ואילך תואמים ל-Matter. כדי לבדוק אם הטלפון שלכם כולל את המודולים הנדרשים, פועלים לפי השלבים הבאים.

הגדרת Android Debug Bridge

צריך להגדיר את Android Debug Bridge‏ (adb) לפני פתרון הבעיות. כדי להגדיר את האפשרות הזו:

  1. מתקינים את 'adb' במחשב.
  2. מפעילים את האפשרויות למפתחים ואת ניפוי הבאגים ב-USB בטלפון Android.

אימות המודולים של Matter ב-Google Play Services (GPS)

כדי לבדוק אם מודול Google Play services Matter מותקן, מבצעים את הפעולות הבאות:

  1. מגדירים את Android Debug Bridge.
  2. מחברים את הטלפון Android למחשב באמצעות כבל USB.
  3. מריצים את הפקודה הבאה בטרמינל כדי לוודא שהמודולים הנדרשים של Matter מותקנים: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    אם מופיע פלט דומה לזה שבהמשך, מודול Matter מותקן: 
    com.google.android.gms.home [v222110900]
     שימו לב שמספר הגרסה שלמעלה עשוי להיות שונה במכשיר שלכם.
  4. מריצים את הפקודה הבאה בטרמינל כדי לוודא שהמודולים הנדרשים של Thread מותקנים: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    אם הפלט שמוצג דומה לדוגמה הבאה, משמעות הדבר היא שהמודולים של Thread מותקנים: 
    com.google.android.gms.threadnetwork [v222106301]
     שימו לב שמספר הגרסה במכשיר עשוי להיות שונה.

אם המודולים לא מופיעים ברשימה, המשמעות היא שאחד מהמצבים הבאים מתקיים:

  1. מותקנת אצלכם גרסה מיושנת של Android. מוודאים שהגרסה היא Android O (8.1) ואילך.
  2. המודולים של Matter עדיין לא הורדתם. ממתינים לפחות 24 שעות עד שההורדה תסתיים. חשוב לוודא שהמכשיר פועל ומחובר לחשמל במהלך התקופה הזו, כדי שההורדה לא תתעכב. אם לא תקבלו את המודולים תוך 24 שעות, תוכלו לנסות לאפס את המכשיר לנתוני היצרן כדי לאלץ את ההורדה של המודולים.

אימות ה-VID/PID של המכשיר

כדי להתחיל לפתח את השילוב עם Google, צריך ליצור פרויקט ושילוב במסוף Google Home.

פתרון בעיות ב-Bluetooth Sniffer

ערך ה-VID/PID שהמכשיר משדר צריך להתאים לערך ה-VID/PID שהוזן בפרויקט Google Home Developer Console.

  • מזהי הווידאו 0xFFF1 – 0xFFF4 שמורים לבדיקה. אפשר להשתמש בהם לבדיקות בקרה ובדיקות הזמנות ראשוניות בסיסיות, אבל אי אפשר להשתמש בהם בשלבים הבאים של הפיתוח:

באמצעות אפליקציה להנדסת Bluetooth, כמו nRF Connect for Mobile, אפשר לראות את ה-VID/PID של מכשיר ה-beacon בשדה Service Data.

בצילום המסך הזה מגרסת Android של nRF Connect, אפשר לראות שה-VID/PID מופיע כ-5A23FFFE החל מהבית הרביעי בשדה Service Data. המשמעות היא VID‏ 5A23 ו-PID‏ FFFE – שניהם בפורמט little endian.

באפליקציית ה-BLE הערכים מוצגים ב-little endian,אבל ערכי ה-VID/PID שמזינים בפרויקט Developer Console הם ב-big endian.

מוודאים שהערכים והפורמט הנכונים הוכנסו לפרויקט במסוף Actions על סמך מה שמוצג בסורק ה-Bluetooth.

לפי הערכים בצילום המסך לדוגמה, הערכים של VID ו-PID ב-Developer Console יהיו 235A ו-FEFF, בהתאמה.

מוודאים שהמכשיר נוצר באמצעות הסתעפות תואמת של Matter SDK

צמתים של Google Matter תואמים ל-Matter 1.0 ונבדקו עם גרסאות build שהשתמשו ב-commits מההסתעפות היציבה v1.0-branch. בהערות לגרסה הציבורית מפורטות ההמלצות לגבי השמירות הספציפיות שאפשר להשתמש בהן בכל גרסה חדשה של מרכז הקוד.

התאמה

אימות פרטי הכניסה של המכשיר

כשמשתמשים ב-VID שהוקצה על ידי Alliance, צריך לוודא שיש לכם פרטי כניסה נכונים במכשיר:

  • הצהרת אישור (CD).
  • אישור אימות המכשיר (DAC) ורשת האישורים שלו.

מידע נוסף זמין במאמר יצירת אישורי בדיקה של מכשירי Matter.

אימות של Hub תואם ל-Matter

מרכז ה-Matter צריך להיות אחד מהמרכזים הנתמכים על ידי Google. בנוסף, הוא צריך להיות בגרסה תואמת ל-Matter.

חלק מהרכזים הם גם נתבי גבול של Thread, כך שאפשר לפתח ולבדוק בהם מכשירים עם פרוטוקול Thread. רכזים אחרים תומכים רק במכשירי Wi-Fi ו-Ethernet Matter, אלא אם יש לכם נתב גבול נוסף ברשת שמאפשר קישוריות ל-Thread.

כדי לאמת את גרסת ה-build של ה-Hub: גוררים את האצבע למטה מהקצה העליון > גלגל ההגדרות > פרטי המכשיר > מידע טכני > גרסת הקושחה של Chromecast

ההפעלה נכשלת עם הודעת השגיאה 'לא ניתן ליצור קשר עם Google'

חשוב לוודא שיצרתם שילוב עם השילוב הנכון של VID/PID ב-Developer Console. מידע נוסף זמין במאמר יצירת שילוב עם Matter.

ההגדרה נכשלת עם הודעת השגיאה 'לא ניתן להגיע למכשיר'

אם מופיעה שוב ושוב הודעת השגיאה 'לא ניתן להגיע למכשיר' כשמפעילים מכשיר Thread, ואזלת כל האפשרויות הזמינות לניפוי באגים, כדאי למחוק את פרטי הכניסה המועדפים על Thread ששמורים בטלפון Android כדי לבצע הגדרה נקייה. לשם כך, עוברים אל הגדרות > אפליקציות > אפליקציות מערכת > שירותי Google Play > אחסון ומטמון > ניהול נפח האחסון > מחיקה של כל הנתונים.

בדיקה

מכשיר שהוקצה לא מופיע בחבילת הבדיקות

אם התאמתם מכשיר עם מזהה ספק (VID) ומזהה מוצר (PID) לבדיקה, אבל הוא לא מופיע כשאתם מנסים לבדוק את המכשיר באמצעות חבילת הבדיקה ב-Developer Console, סביר להניח שהסיבה לכך היא שימוש באותה שילוב של VID ו-PID לבדיקה בכמה שילובים.

כדי לפתור את הבעיה, מסירים את כל המכשירים לבדיקה מ-Developer Console ומתאימים שוב את המכשיר שרוצים לבדוק.

כדי לוודא שביצעתם התאמה למכשיר הנכון, תוכלו להגדיר את פרטי היצרן והדגם (ערכים של CHIP_DEVICE_CONFIG_DEVICE_*) של המכשיר לערכים ייחודיים בקושחת הבדיקה.

למידע נוסף, ראו פרטי המכשיר.

אם הבעיה נמשכת

אם אחרי ביצוע כל שלבי פתרון הבעיות המפורטים כאן הבעיה עדיין לא נפתרה, אין בעיה!

בשלבים לפתרון הבעיות, צברתם נתונים חשובים על המכשיר, על הפרויקט במסוף ועל הסביבה. אחרי שתאספו את הנתונים האלה, תוכלו לקרוא בדף התמיכה איך לשתף את הבעיה עם הקהילה ועם צוות התמיכה של Google Home.