פתרון בעיות בתקן 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 שהמכשיר משדר צריך להיות זהה לערך ה-VID/PID שהזנתם בפרויקט Google Home Developer Console.

  • ‫VIDs 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 ונבדקו עם גרסאות build שהשתמשו ב-commits מהענף היציב v1.0-branch.Matter בהערות על גרסאות לציבור אפשר למצוא את הקומיטים הספציפיים שמומלץ להשתמש בהם בכל גרסה חדשה של ה-Hub.

התאמה

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

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

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

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

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

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

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

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

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

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

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

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

בדיקה

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

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

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

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

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

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

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

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