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

מבנה

איך בודקים אם הטלפון תואם

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

הגדרת Android Debug Bridge

לפני פתרון הבעיות, צריך להגדיר את ממשק הגישור של Android‏ (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 Android O ‏ (8.1) ומעלה.
  2. המודולים של Matter עדיין לא הורדו. צריך להמתין לפחות 24 שעות עד שההורדה תסתיים. כדי שההורדה לא תתעכב, חשוב לוודא שהמכשיר מופעל ונטען בזמן הזה. אם לא קיבלתם את המודולים תוך 24 שעות, אתם יכולים לנסות איפוס לנתוני היצרן של המכשיר כדי לאלץ את הורדת המודולים.

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

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

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

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

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

באמצעות אפליקציית Bluetooth להנדסה כמו nRF Connect for Mobile, אפשר לראות את ה-VID/PID של המכשיר שמשדר אותות בשדה 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 Console, על סמך מה שמוצג ברחרחן ה-Bluetooth.

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

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

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

התאמה

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

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

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

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

אימות הרכזת שתואמת לתקן Matter

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

חלק מהרכזות הן גם Thread Border Router (TBR)s ולכן מאפשרות לפתח ולבדוק מכשירי Thread. רכזות אחרות תומכות רק במכשירי Wi-Fi ואתרנט Matter, אלא אם יש לכם border router אחר ברשת שמאפשר קישוריות Thread.

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

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

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

ההפעלה נכשלת ומוצגת הודעת השגיאה "המכשיר לא זמין"

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

בדיקה

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

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

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

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

מידע נוסף זמין במאמר פרטי המכשיר.

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

אם ביצעתם את כל השלבים לפתרון הבעיות והבעיה עדיין לא נפתרה, אל דאגה.

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