בדיקת שילוב של 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 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
הבא
שליחת תוצאות הבדיקה