בדיקת שילוב של 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. הגדרת המערכת והמותג.

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

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

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

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

כניסה ל-Developer Console

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

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

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

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

    • בוחרים באפשרות מבחן הסמכה אם מתכוננים להסמכה בסביבת Google.
    • אי אפשר להשתמש בבדיקת פיתוח לצורך אישור.
    • בוחרים באפשרות בדיקת תאימות של CSA כדי להשתמש בתוצאות של Allianceמעבדת בדיקות התאימות ולדלג על שלבי הבדיקה והניסוי בשטח בתהליך השילוב של 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, אפשר לראות את תוצאות הבדיקות הקודמות של תוכנית פיתוח או של תוכנית בדיקה להסמכה שלא נשלחה. לשם כך, לוחצים על בדיקה חוזרת בתוכנית הבדיקה הרצויה בקטע תוכניות בדיקה. תועברו לדף סביבת בדיקה שבו מוצגים תוצאות הבדיקה.

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

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

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

סטטוסים של מסוף

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

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

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

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

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

בדיקה חוזרת

הסמכה

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

פיתוח

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

פתרון בעיות

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

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

כדי לפתור את הבעיה, צריך להסיר את כל מכשירי הבדיקה מ-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
הבא
שליחת תוצאות הבדיקה