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

מבנה

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

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

הגדרת 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 שעות, תוכלו לנסות לאפס את המכשיר לנתוני היצרן כדי לאלץ את ההורדה של המודולים.

יומני מכשירים של Fuchsia hub

כדי להפעיל מרכז לאחזור יומנים מקומיים:

  1. שולחים אימייל עם המספר הסידורי והדגם של המכשירים שלך אל Technical Account Manager (TAM) ב-Google. הם מופיעים באותיות קטנות מתחת למכשיר.
  2. אחרי שמקבלים אישור להצטרף לרשימת ההיתרים, צריך להפעיל את התכונה לפי השלבים הבאים:
    • מהמרכז:
      1. מחליקים למטה מהחלק העליון של המסך.
      2. מקישים על סמל ההגדרות .
      3. חיפוש גרסת Fuchsia: ב-Google Nest Hub (2nd gen), עוברים אל פרטי המכשיר > מידע טכני > גרסת Fuchsia
      4. מקישים על 'גרסת Fuchsia' 7 פעמים. הפעולה הזו תפעיל את האפשרויות למפתחים.
      5. חזרה לתפריט ברמה העליונה
      6. מקישים על 'אפשרויות למפתחים'.
      7. מקישים על 'רישום ביומן של שותף'.
    • התכונה תופעל למשך 24 שעות. לאחר מכן, מפעילים מחדש את תכונת הרישום ביומן החל משלב 5 ואילך.
  3. בודקים מה כתובת ה-IP של הצומת:
    • מהמרכז, אם יש לו מסך:
      1. מחליקים למטה מהחלק העליון של המסך.
      2. מקישים על סמל ההגדרות .
      3. מחפשים את כתובת ה-IP של המכשיר: ב-Nest Hub (2nd gen), עוברים אל פרטי המכשיר > מידע טכני > כתובת IP
    • מ-Google Home app (GHA) בטלפון:
      1. מקישים על המכשיר כדי להציג את דף הפרטים שלו.
      2. מקישים על סמל ההגדרות כדי להציג את דף ההגדרות.
      3. מוצאים את כתובת ה-IP של המכשיר: עוברים אל פרטי המכשיר > מידע טכני > כתובת IP
  4. כדי לאחזר יומנים מהרכז, שולחים אליו בקשת GET HTTP ממחשב שמחובר לאותה רשת Wi-Fi.
    • מציינים את היציאה והנתיב של נקודת הקצה: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • אפשר להשאיר את החיבור פתוח למשך דקה אחת בלבד, אבל הנתונים שאוחזרים מהמאגר בדרך כלל כוללים אירועים קודמים מ-20 עד 30 דקות.
      • באופן אידיאלי, כדאי לחלץ את היומנים באמצעות השיטה הזו מיד אחרי השלמת תהליך הבדיקה, כדי לוודא שהמאגר הזמני מכיל תוכן שרלוונטי לבדיקה (בדומה לדוחות איתור הבאגים של Android).

השבתת השמטת תוכן ביומני Android

  • מטעמי פרטיות ואבטחה, מומלץ להשתמש בתכונה הזו למטרות בדיקה הנדסית בלבד.
  • אין להשתמש באפשרות הזו עם משתמשים או מכשירים בסביבת הייצור.
  • השלבים:
    1. שולחים את חשבונות Google של המשתמשים שיהיו להם יומנים ללא צנזור אל TAM ב-Google.
    2. אחרי שמקבלים אישור על כך שהחשבון נוסף לרשימת ההיתרים, מפעילים מחדש את הטלפון.

אימות ה-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.