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

בניין

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

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

הגדרת ממשק הגישור של Android

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

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

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

כדי לבדוק אם יש לכם את המודולים Google Play services Matter:

  1. יש להגדיר את ממשק הגישור של Android.
  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. מקישים 7 פעמים על 'גרסת פוקסיה'. פעולה זו תפעיל את האפשרויות למפתחים
      5. חזרה לתפריט ברמה העליונה
      6. מקישים על 'אפשרויות למפתחים'.
      7. מקישים על 'Partner Logging'.
    • התכונה תפעל למשך 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. יש לשלוח אל TAM ב-Google את חשבונות Google של המשתמשים שלא מצונזרים.
    2. אחרי שמאשרים שהחשבון נוסף לרשימת ההיתרים, מפעילים מחדש את הטלפון.

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

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

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

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

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

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

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

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

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

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

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

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

התאמה

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

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

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

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

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

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

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

כדי לאמת את גרסת ה-build של המרכז: החלקת האצבע למטה מהקצה העליון > גלגל ההגדרות > מידע מהמכשיר > מידע טכני > גרסת הקושחה של 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.