בדיקת שילוב של Matter

ב-Google Home Developer Console יש דף Test שבו אפשר להגדיר בדיקות ולהריץ אותן בשילוב עם Matter באמצעות Google Home Test Suite. ‫Test Suite היא אפליקציה נפרדת שמובנית ב-Developer Console ומטפלת בכל בדיקות השילוב.

כדי לבדוק את המכשירים, צריך להפעיל אותם ולהוסיף אותם אל Google Home app (GHA) בחשבון שבו משתמשים עם Developer Console. מידע נוסף זמין במאמר בנושא צימוד מכשיר Matter.

אפשר להריץ את Test Suite על קבוצת מכשירים ששייכים להגדרת פרויקט ספציפית של Matter. חשוב מאוד להריץ את Test Suite על השילובים כדי לוודא שהכול פועל בצורה תקינה.

בדף בדיקה, שילובי Matter שהושלמו ומוכנים לבדיקה מופיעים בקטע מוכן לבדיקה.

שילובים של Matter שנבדקו מפורטים בקטע נבדק.

סוגים של תוכניות בדיקה

אלה סוגי תוכניות הבדיקה שזמינות:

  • תוכניות בדיקה של פיתוח משמשות לבדיקת השליטה במכשירים באמצעות Matter. אפשר לערוך אותם, אבל אי אפשר לשלוח אותם לאישור Matter.

  • תוכניות בדיקה של הסמכה מיועדות במיוחד להסמכת Matter ולא ניתן לערוך אותן. בחירה באפשרות הזו תיצור גרסה חדשה של השילוב Matter.

  • תוכניות הבדיקה של CSA Interop מאפשרות לדלג על שלב הבדיקה ולהשתמש בתוצאות של Connectivity Standards Alliance (Alliance) Interop Test Lab. אפשרות הבדיקה הזו זמינה לכל סוגי המכשירים הנתמכים.

אפשר להשתמש בTest Suite בDeveloper Console כדי לשלוח תוצאות בדיקה לצורך קבלת אישור. אם רוצים להריץ את Test Suite למטרות בדיקה במהלך הפיתוח, אפשר לעיין בדף Google Home Test Suite כדי למצוא את הגרסה העצמאית.

גרסאות השילוב

כשיוצרים תוכנית בדיקה לצורך אישור, נוצרת גרסה חדשה של השילוב. הגרסה הממוספרת הזו מופיעה בכל רשימות השילוב בכרטיסייה Developer ConsoleTest (בדיקה) ואילך.

לעולם לא נוצרות גרסאות חדשות מגרסאות ממוספרות אחרות. לדוגמה, תוכנית הבדיקה הראשונה שתיצרו לשילוב מסוים תיצור גרסה v.1 לשילוב הזה. אם תיצרו עוד תוכנית בדיקה, תיצור גרסה v.2 לאותו שילוב, אבל הגרסה הזו לא תתבסס על v.1. במקום זאת, הגרסה הזו מבוססת על המופע של השילוב שלא כולל גרסה, כמו v.1.

הגרסה N/A של שילוב מייצגת את המופע של השילוב שלא הוגדרה לו גרסה, שמנוהל בכרטיסייה Develop.

במילים אחרות, ב-Matter > Test ב-Developer Console:

  • אם לוחצים על בדיקה לגרסה לא זמין של השילוב, נוצרת גרסה חדשה. מספר הגרסה יהיה גבוה ב-1 ממספר הגרסה הקיימת.
    • אם לא קיימות גרסאות ממוספרות, נוצרת גרסה v.1.
    • אם קיימת גרסה v.1, נוצרת גרסה v.2. אם קיימת גרסה v.2 נוצרת גרסה v.3 וכן הלאה.
  • אם לוחצים על בדיקה לגרסה ממוספרת של השילוב (לדוגמה, v.1), לא נוצרת גרסה חדשה. במקום זאת, גרסה v.1 נבדקת שוב.

מידע נוסף זמין במאמר בנושא ניהול גרסאות של אינטגרציות.

יצירת תוכנית בדיקה

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

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

  1. יצירת פרופיל סוכנות.
  2. הזנתם את מזהה הספק (VID) של הסביבה הפרודקטיבית לשילוב.
  3. הגדרת המיתוג.

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

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

כדי ליצור תוכנית בדיקה:

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

נכנסים ל-Play Console

  1. ברשימת הפרויקטים, לוחצים על פתיחה לצד הפרויקט שרוצים לעבוד איתו.

  2. בתפריט הניווט בצד ימין של הדף, עוברים אל Matter > בדיקה.

  3. לוחצים על Test (בדיקה) לגרסה N/A של השילוב שרוצים לבדוק. הפעולה הזו יוצרת גרסה חדשה של השילוב.

  4. בוחרים סוג בדיקה ולוחצים על בדיקה.

    • בוחרים באפשרות מבחן הסמכה אם מתכוננים להסמכה במערכת האקולוגית של Google.
    • אי אפשר להשתמש בבדיקת פיתוח לצורך אישור.
    • בוחרים באפשרות CSA Interop test כדי להשתמש בתוצאות של AllianceInterop Test Lab כדי לדלג על שלבי הבדיקה והניסוי בשטח בתהליך השילוב של Matter.

  5. במסך Configure your test (הגדרת הבדיקה), מציינים שם לבדיקה ולוחצים על Automatically pair device (צימוד אוטומטי של מכשיר) כדי לבחור מכשיר לצימוד.

    הגדרת שם לתוכנית הבדיקה

    • במכשיר Android:

      1. מוודאים שהאפליקציה GHA מותקנת בטלפון.
      2. מחברים את הטלפון למחשב המארח באמצעות כבל USB.
      3. צריך להפעיל ניפוי באגים ב-USB במכשיר. APK com.chip.interop.moblysnippet יורד ויותקן באופן אוטומטי.
      4. אחרי שהטלפון מחובר, מזינים את קוד ההתאמה ואת שם המכשיר כדי להתאים את המכשיר באופן אוטומטי.

    • במכשירי iOS:

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

  6. לוחצים על הלחצן הבא: תוכנית בדיקה.

  7. בדף Create a test plan, בקטע Test suites, בוחרים את חבילות הבדיקה שרוצים להריץ.

יצירת תוכנית בדיקה אם רוצים לצאת מTest Suite, לוחצים על חזרה אל מרכז המפתחים.

הרצת תוכנית הבדיקה

בTest Suite, בדף Create a test plan, לוחצים על Run Test. מופיע הדף סביבת בדיקה, עם הסטטוס והיומנים של כל הבדיקות.

תוצאות הבדיקה יופיעו אחרי שהבדיקות יסתיימו. הסטטוס של כל הרצת חבילת בדיקות מופיע לידה (עבר, נכשל).

בחלונית Logs (יומנים) מוצג הסטטוס של כל ביצוע בדיקה.

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

בסיום:

הצגה ופירוש של תוצאות הבדיקה

בדף היסטוריית הבדיקות ב-Test Suite, אפשר לראות את תוצאות הבדיקות הקודמות של תוכנית פיתוח או של תוכנית בדיקה של אישור שלא נשלחה. לשם כך, לוחצים על בדיקה חוזרת בתוכנית הבדיקה הרצויה בקטע תוכניות בדיקה. תועברו לדף סביבת בדיקה שבו מוצגים תוצאות הבדיקה.

היסטוריית הבדיקות

כדי לראות את דוח תוצאות הבדיקה של תוכנית אישורים שנשלחה, לוחצים על תוצאות בקטע נשמר לצורך אישור.

אפשר גם לגשת לתוצאות הבדיקה של גרסת שילוב מהכרטיסייה Test (בדיקה) ב-Developer Console. לוחצים על הצגה בהיסטוריית הבדיקות של כל גרסת שילוב שמופיעה בדף כדי לעבור לדף היסטוריית הבדיקות ב-Test Suite.

סטטוסים במסוף

בשלב הבדיקה, יכולים להופיע הסטטוסים הבאים במסוף:

Section סטטוס תיאור דרישה מה לעשות עכשיו
מוכן לבדיקה מוכן הגרסה הזו של integration מוכנה לבדיקה. לא רלוונטי בדיקה של הגרסה הזו של integration.
נבדק מוכן הגרסה הזו של integration נבדקה ואפשר לשלוח אותה לField Trial או להסמכה.

הגרסה נבדקה ונשמרה.

כל מקרי הבדיקה שנכשלו כוללים הצדקות לבדיקה על ידי Google.

 אם רוצים, אפשר ללחוץ על בדיקה מחדש.

בדיקה חוזרת

הסמכה

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

פיתוח

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

פתרון בעיות

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

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

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

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

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

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

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

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

ערך ה-VID/PID שהמכשיר משדר צריך להיות זהה לערך ה-VID/PID שהזנתם בפרויקט 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
הבא
שליחת תוצאות הבדיקה