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

מבנה

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

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

הגדרה של ממשק הגישור של Android‏ (ADB‏)

צריך להגדיר את ממשק הגישור של Android‏ (adb) לפני שמתחילים לפתור בעיות. כדי להגדיר את האפשרות הזו:

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

אימות מודולי Matter של Google Play Services ‏ (GPS)

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

  1. הגדרת ממשק הגישור של Android‏ (ADB)
  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 Console.

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

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

  • ‫VID‏ 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 Console על סמך מה שמוצג בכלי לניטור Bluetooth.

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

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

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

התאמה

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

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

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

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

אימות של רכזת שתואמת ל-Matter

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

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

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

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

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

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

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

בדיקה

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

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

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

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

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

אם עדיין יש בעיות

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

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