חומרים להתאמה מהירה והערות טכניות

בדף הזה מופיע מידע שימושי שהשותפים זקוקים לו גם לתכנון פרויקטים בהתאמה מהירה וגם לשילוב המערכת.

התאמה מהירה של חומרים ותהליך

בקטע הזה יש קישורים למידע כללי בנושאי שיווק ותהליכים.

שיווק, מיתוג והעברת הודעות

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

מחזור החיים של הפרויקט בהתאמה מהירה

בדף תפקידים ותחומי אחריות בכלי לשילוב מערכות (SI) תוכלו למצוא תיאור כללי של מחזור החיים של הפרויקט ואת תחומי האחריות של שותפים שמשלבים התאמה מהירה במוצר.

תהליך האישור

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

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

גם מכשירים שמטמיעים תוספים של התאמה מהירה או משתמשים בהם, כמו שינוי מקור אודיו, צריכים להיות מאושרים. במסגרת שינוי מקור האודיו יש [הנחיות הסמכה נפרדות][ASGuideLink] שמתארות את השלבים לבדיקה עצמית ואת ההכנות לקראת הסמכה של צד שלישי ב-Lab.

תכונות Labs של צד שלישי יכולות לאשר את מתג ההתאמה המהירה ואת מתג האודיו ברצף. בדף משלוח מכשירים למעבדות של צד שלישי תוכלו לראות אילו שיעורי Lab מציעים שירותי הסמכה.

הערות טכניות

בקטע הזה מתוארות כמה הערות לגבי הטמעה טכנית שיעזרו לשותפים בתהליך הפיתוח וההטמעה.

איך לפרסם פרוטוקולים אחרים לצד התאמה מהירה

במכשירים מסוימים, יכול להיות שיתמכו בתכונות נוספות בנוסף להתאמה מהירה, כמו Google Assistant או Eddystone, שדורשות שטח פרסום נוסף. במקרים כאלה, מומלץ להחליף את נתוני הפרסומות. עם זאת, עדיין צריך לפרסם את הפרסומות של ההתאמה המהירה במרווח הזמן בין הפרסום, בהתאם למצב גלוי ולמצב שאינו גלוי.

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

קיצור המרווח בין חיבור BLE

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

מצב החיבור של האוזניות ופרסומת BLE

הפרסום של מזהה הדגם או של נתוני החשבון על ידי אוזניות עם התאמה מהירה תלוי במצב הגילוי BR/EDR של האוזניות, ולא במצב המחובר או מנותק. אפשר לעיין במפרט של השירות בהתאמה מהירה דרך הקישורים הבאים:

  • "כשמכשיר הספק נמצא במצב BR/EDR גלוי (כלומר, במצב התאמה), הוא מפרסם את נתוני מזהה המודל של ההתאמה המהירה ב-BLE". - קישור
  • "במקרים שבהם לא ניתן לגלות אותם (כלומר, לא במצב התאמה), הספק יפרסם נתוני חשבון בהתאמה מהירה" - קישור.

TxPower

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

התהליך לקביעת TxPower הוא:

  1. מודדים את הפלט בפועל של המכשיר באמצעות טלפון Android במרחק מטר אחד, ואז מוסיפים 41 dBm.
  2. יש לכלול את הערך הזה בפרסומת מסוג BLE.
  3. יש לכלול את הערך הזה עם בדיקת פרטי הטלפון בדוח הבדיקה העצמית.

מדידה והגדרה של TxPower באמצעות אפליקציית התיקוף

אפליקציית התיקוף מספקת בדיקה להתאמה ידנית של TxPower לרמה המתאימה ב-DUT. שותפים יכולים להשתמש בבדיקה הזו כדי לקבוע את רמת ה-TxPower המתאימה ב-DUT לפני הבדיקה העצמית או האישור.

הליך מדידת TxPower

כדי למדוד את TxPower באמצעות אפליקציית התיקוף:

  1. פותחים את אפליקציית התיקוף ב-DUT.
  2. פותחים את תפריט הנקודות בחלק העליון של האפליקציה:
    הבדיקה נקראת 'כלי כיול מסוג Tx Power Level'.
  3. מציבים את ה-DUT במרחק מטר אחד מהטלפון ומקישים על הלחצן 'התחלה'.
    דף הבדיקה מציג את המרחק המשוער ליעד, בצבע צהוב.
  4. בוחרים את ה-DUT מרשימת המכשירים.
    המכשירים מפורטים לפי כתובת ה-MAC שלהם.
    1. כדי לרענן את רשימת המכשירים, מקישים על הלחצן 'ביטול' ובוחרים מחדש את הלחצן 'התחלה'.
  5. כוונן את הקו האדום (שמייצג את TxPower) עד שהוא כמעט ייגע בחלק העליון של האזור הצהוב.
    התאמה נכונה מציבה את הקו האדום בחלק העליון של האזור הצהוב.
    1. משתמשים בלחצן '1-' כדי להזיז את הקו האדום לכיוון האזור הצהוב.
    2. השתמשו בלחצן 1+ כדי להרחיק את הקו האדום מהאזור הצהוב.
    3. הפרעה לאות עלולה להפוך את הקו האדום לבלתי יציב. נסו לעבור לאזור עם פחות הפרעות לאות, אם הקו האדום מתנהג בצורה לא סדירה.
  6. שומרים את הערך של TxPower ומעדכנים אותו גם ב-DUT וגם במסוף המכשיר.
    המספר מופיע בראש המסך.

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

כפי שמוגדר במפרט, הספק יכול לכלול את פרטי הסוללה בפרסומת. המחפש מחליט אם להציג או להסתיר את ההתראה לגבי הסוללה בהתאם לסוג, 0b0011 כדי להציג את ההתראה לגבי הסוללה או 0b0100 כדי להסתיר אותה. הנה כמה הנחיות לגבי המקרים שבהם יש לכלול את פרטי הסוללה בפרסומת, ובאיזה סוג להשתמש:

  1. הצגת פרטי הסוללה בפרסומת עם ההתראה 0b0011 למשך 8 שניות לפחות, כשהנרתיק נפתח ושתי האוזניות מחוברות לאביזר עגינה.
  2. פרטי הסוללה יופיעו בפרסומת עם הסתרת ההתראה 0b0100 למשך 5 שניות לפחות, כשהנרתיק נסגר ושתי האוזניות מחוברות לאביזר עגינה.
  3. על מנת להגיב תוך כדי הצגה או הסתרה של התראות הסוללה, הפרסום אמור לשקף את המצב האמיתי תוך 2 שניות.
  4. יש שתי דרכים להסתיר את התראת הסוללה:
    1. אין לכלול מידע על הסוללה בפרסומת, המחפש מסתיר את ההתראה לאחר זמן מה (שמוגדר כרגע ל-20 שניות).
    2. כלול את פרטי הסוללה בפרסומת עם התראה על הסתרת הסוללה 0b0100. המחפש יסתיר את ההתראה מיד עם קבלת הפרסום.
  5. אם המארז פתוח או סגור, לא חובה לכלול את פרטי הסוללה בפרסומת.
  6. אם האוזניות מוסרות מהנרתיק או נעגנות בנרתיק, לא חובה לכלול בפרסומת את פרטי הסוללה.
  7. כדי למנוע מעקב, הספק צריך לכלול בפרסום נתוני סוללה גולמיים רק במקרה הצורך (לא כל הזמן).

צריך לתאר את ההטמעה בתוצאת הבדיקה העצמית של האישור.

איך מפעילים רישום ביומן של התאמה מהירה

חשוב לוודא שהפעלתם את יומן snoop של Bluetooth HCI במכשיר לפני ניפוי הבאגים.

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

$ adb logcat -G 16M
$ adb shell setprop log.tag.NearbyMessages VERBOSE
$ adb shell setprop log.tag.NearbyDiscovery VERBOSE
$ adb shell setprop log.tag.FastPair VERBOSE

Google ממליצה להריץ את הפקודות הקודמות בכל רצף הפעלה.

איך מחלצים יומן ניפוי באגים

מריצים את הפקודה $ adb bugreport כדי ליצור קובץ ZIP שמכיל את כל הנתונים. יצירת קובץ ה-ZIP עשויה להימשך מספר דקות.

בהתאם לגרסת Android, מריצים אחת מהפקודות הבאות כדי לקבל btsnoop_hic.log:

  • ב-Android מגרסה 8.x ואילך: shell $ adb pull data/misc/bluetooth/logs logs
  • ב-Android 7.x: shell $ adb pull sdcard/btsnoop_hci.log