مطالب و یادداشت‌های فنی «جفت‌سازی سریع»

این صفحه اطلاعات مفیدی را که «شرکا» برای برنامه‌ریزی پروژه «جفت‌سازی سریع» و ادغام سیستم نیاز دارند شرح می‌دهد.

مواد و فرایند «جفت‌سازی سریع»

این بخش پیوندهایی به اطلاعات کلی بازاریابی و فرایند ارائه می‌دهد.

بازاریابی، نمانام‌سازی، و پیام‌رسانی

برای راهنمایی درباره نمانام‌سازی و پیام‌رسانی، به مرکز بازاریابی شریک ما مراجعه کنید. شرکای جدید باید برای دسترسی درخواست دهند، درحالی‌که شرکای فعلی می‌توانند ازطریق حساب «دامنه شریک» خود به محتوا دسترسی داشته باشند.

چرخه حیات پروژه «جفت‌سازی سریع»

برای شرح سطح بالایی از چرخه حیات پروژه و مسئولیت‌های شرکایی که «جفت‌سازی سریع» را در محصولی ادغام می‌کنند، به صفحه نقش‌ها و مسئولیت‌های «یکپارچه‌ساز سیستم» (SI) مراجعه کنید.

فرایند گواهینامه

دستگاه‌هایی که «جفت‌سازی سریع» را پیاده‌سازی می‌کنند باید قبل‌از اینکه محصولی با این ویژگی به بازار عرضه شود، دارای گواهینامه باشند. دستورالعمل صدور گواهینامه «جفت‌سازی سریع» نحوه آماده شدن برای صدور گواهینامه و انجام «خودآزمایی‌های» پیش‌از صدور گواهینامه را شرح می‌دهد.

پرسشگان گواهینامه انواع سؤالات رایج را پوشش می‌دهد، ازجمله شرح کلی درباره اینکه چه زمانی گواهینامه کامل (یا گواهینامه مجدد) لازم است.

دستگاه‌هایی که افزونه‌های «جفت‌سازی سریع» را پیاده‌سازی یا استفاده می‌کنند، مانند تعویض منبع صدا، باید دارای گواهینامه نیز باشند. «تعویض منبع صدا» دستورالعمل گواهینامه جداگانه‌ای دارد که مراحل «خودآزمایی» و آماده‌سازی برای «گواهینامه آزمایشگاه شخص ثالث» را شرح می‌دهد.

«آزمایشگاه‌های شخص ثالث» می‌توانند «جفت‌سازی سریع» و «تعویض منبع صوتی» را به‌صورت متوالی تأیید کنند. برای اطلاع از اینکه کدام آزمایشگاه‌ها کدام خدمات «صدور گواهینامه» را ارائه می‌دهند، به صفحه ارسال دستگاه‌ها به آزمایشگاه‌های طرف سوم مراجعه کنید.

نکات فنی

این بخش برخی‌از نکات پیاده‌سازی فنی را برای کمک به «شرکا» در توسعه و ادغام شرح می‌دهد.

نحوه تبلیغ پروتکل‌های دیگر در کنار «جفت‌سازی سریع»

برخی‌از دستگاه‌ها ممکن است بخواهند از ویژگی‌های اضافی علاوه‌بر «جفت‌سازی سریع» پشتیبانی کنند، مانند «دستیار Google» یا Eddystone، که به فضای تبلیغاتی اضافی نیاز دارند. چرخش داده‌های تبلیغاتی بهترین گزینه برای این موارد است. بااین‌حال، آگهی‌های «جفت‌سازی سریع» همچنان باید در «فاصله زمانی آگهی» مطابق با حالت قابل‌شناسایی و حالت غیرقابل‌شناسایی آگهی شوند.

چرخش آگهی درطول مرحله آزمایش شخص ثالث فرایند صدور گواهینامه آزمایش می‌شود. حتماً هرگونه طرح چرخش را با برنامه «اعتبارسنج جفت‌سازی سریع» قبل‌از صدور گواهینامه درستی‌سنجی کنید تا از تأخیرهای احتمالی در صدور گواهینامه، آزمایش مجدد، و هزینه جلوگیری شود.

کوتاه کردن فاصله اتصال BLE

برای بهبود عملکرد ایجاد اتصال GATT، از «ارائه‌دهنده» انتظار می‌رود فاصله اتصال را تا حد امکان کوتاه کند. مقدار بهینه موردانتظار ۷٫۵ میلی‌ثانیه است که برای اکثر «جستجوگران» اعمال می‌شود.

تبلیغات بلوتوث کم‌مصرف و وضعیت اتصال هدست

اینکه هدست «جفت‌سازی سریع» شناسه مدل یا داده‌های حساب را تبلیغ کند به حالت قابل‌کشف BR/EDR هدست بستگی دارد، نه به وضعیت متصل یا قطع‌شده. به مشخصات سرویس «جفت‌سازی سریع» در پیوندهای زیر مراجعه کنید:

• «وقتی دستگاه ارائه‌دهنده در حالت قابل‌شناسایی BR/EDR (یعنی در حالت جفت‌سازی) باشد، باید داده‌های شناسه مدل جفت‌سازی سریع را ازطریق BLE تبلیغ کند.» - پیوند
• «وقتی قابل‌شناسایی نیست (یعنی در حالت جفت‌سازی نیست)، «ارائه‌دهنده» باید «داده‌های حساب جفت‌سازی سریع» را تبلیغ کند» - پیوند

TxPower

همان‌طور که در مشخصات تعریف شده است، «جستجوگر» فاصله را براساس سطح TxPower ارائه‌شده توسط RSSI تخمین می‌زند. فاصله تخمینی عامل کلیدی برای تعیین نمایش یا عدم نمایش اعلان است.

فرایند تعیین TxPower عبارت است از:

1. خروجی واقعی دستگاه را بااستفاده از تلفن Android در فاصله ۱ متری اندازه‌گیری کنید، سپس ۴۱ دسی‌بل میلی‌وات به آن اضافه کنید.
2. این مقدار را در آگهی BLE اضافه کنید.
3. این مقدار را به‌همراه اطلاعات تلفن آزمایشی در گزارش خودآزمایی اضافه کنید.

توجه: مقدار TxPower ذخیره‌شده در کنسول دستگاه به شرکا اجازه می‌دهد مقدار TxPower را در دستگاه‌های ارسال‌شده به‌روز کنند. ارسال مقدار TxPower به «کنسول دستگاه» الزامی نیست و هر مقداری در «کنسول دستگاه» همه تنظیمات TxPower دستگاه را لغو می‌کند.

اندازه‌گیری و تنظیم TxPower با برنامه «اعتبارسنج»

«برنامه اعتبارسنج» آزمایشی برای تنظیم دستی TxPower روی سطح مناسب در تلفن آزمایشی ارائه می‌دهد. شرکا می‌توانند از این آزمایش برای تعیین سطح TxPower مناسب در DUT خود قبل‌از «خودآزمایی» یا «صدور گواهینامه» استفاده کنند.

توجه: به‌یاد داشته باشید که پس‌از اتمام آزمایش، سطح TxPower را در DUT و در کنسول دستگاه تنظیم کنید.

روش اندازه‌گیری TxPower

برای اندازه‌گیری TxPower با «برنامه اعتبارسنج»:

1. برنامه Validator را در تلفن آزمایشی باز کنید.
2. منو نقطه‌ای را در بالای برنامه باز کنید:

   

3. دستگاه تحت آزمایش را در فاصله ۱ متری از تلفن قرار دهید و روی دکمه «شروع» ضربه بزنید.

   

4. «دستگاه تحت آزمایش» را از فهرست دستگاه‌ها انتخاب کنید.

   

   1. می‌توانید با تک‌ضرب زدن روی دکمه «لغو» و انتخاب مجدد دکمه «شروع»، فهرست دستگاه‌ها را بازآوری کنید.
5. خط قرمز (نشان‌دهنده TxPower) را طوری تنظیم کنید که به‌سختی بالای ناحیه زرد را لمس کند.

   

   1. از دکمه «-۱» برای حرکت دادن خط قرمز به‌سمت منطقه زرد استفاده کنید.
   2. از دکمه «‎+۱» برای دور کردن خط قرمز از منطقه زرد استفاده کنید.
   3. تداخل سیگنال ممکن است خط قرمز را ناپایدار کند. اگر خط قرمز رفتار نامنظمی دارد، به منطقه‌ای با تداخل سیگنال کمتر بروید.
6. مقدار TxPower را ذخیره کنید و آن را هم در DUT و هم در «کنسول دستگاه» به‌روز کنید.

   

اعلان‌های باتری

همان‌طور که در مشخصات تعریف شده است، «ارائه‌دهنده» می‌تواند اطلاعات باتری را در آگهی بگنجاند. «جستجوگر» براساس نوع، تصمیم می‌گیرد اعلان باتری را نشان دهد یا پنهان کند، یعنی 0b0011 برای نشان دادن اعلان باتری یا 0b0100 برای پنهان کردن آن. در اینجا چند دستورالعمل درباره زمان گنجاندن اطلاعات باتری در آگهی و نوع باتری مورد استفاده آورده شده است:

1. اطلاعات باتری را در آگهی با نمایش اعلان باتری 0b0011 برای حداقل ۸ ثانیه وقتی قاب باز است و هر دو هدفون توگوشی در آن قرار دارند بگنجانید.
2. اطلاعات باتری را در آگهی با اعلان پنهان کردن باتری 0b0100 برای حداقل ۵ ثانیه وقتی قاب بسته است و هر دو هدفون توگوشی در جای خود قرار دارند، بگنجانید.
3. برای اینکه آگهی در نشان دادن یا پنهان کردن اعلان‌های باتری پاسخگو باشد، باید وضعیت واقعی را ظرف ۲ ثانیه منعکس کند.
4. ‫۲ روش برای پنهان کردن اعلان باتری وجود دارد:
   1. اگر اطلاعات باتری دیگر در آگهی گنجانده نشود، «جستجوگر» پس‌از مدتی (که درحال‌حاضر ۲۰ ثانیه تنظیم شده است) اعلان را پنهان می‌کند.
   2. اطلاعات باتری را در آگهی با اعلان پنهان کردن باتری 0b0100 اضافه کنید، «جستجوگر» بلافاصله پس‌از دریافت آگهی، اعلان را پنهان می‌کند.
5. اگر هنگام باز یا بسته بودن قاب فقط یک هدفون در آن قرار داشته باشد، گنجاندن اطلاعات باتری در آگهی اختیاری است.
6. وقتی هدفون‌ها از قاب خارج می‌شوند یا در قاب قرار می‌گیرند، درج اطلاعات باتری در آگهی اختیاری است.
7. برای جلوگیری از ردیابی، «ارائه‌دهنده» باید فقط درصورت نیاز (نه همیشه) داده‌های خام باتری را در آگهی بگنجاند.

پیاده‌سازی باید در نتیجه خودآزمایی برای «گواهینامه» شرح داده شود.

نحوه فعال کردن گزارش‌گیری «جفت‌سازی سریع»

مطمئن شوید که گزارش جاسوسی HCI بلوتوث را در دستگاه قبل‌از اشکال‌زدایی فعال کرده‌اید. علاوه‌براین، برای جلوگیری از ویرایش گزارش‌های کلیدی «جفت‌سازی سریع» به‌دلایل امنیتی، با «حساب‌های Google» آزمایشی خود به گروه Google آزمایشی شریک «جفت‌سازی سریع» ([e-mail]) بپیوندید.

برای ضبط پیام‌های «جفت‌سازی سریع» در گزارش‌های اشکال‌زدایی، این فرمان را اجرا کنید:

$ 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 توصیه می‌کند فرمان‌های قبلی را در هر توالی راه‌اندازی اجرا کنید.

توجه: گزارش‌های VERBOSE ممکن است در نسخه‌های تولیدی حذف شوند.

نحوه استخراج گزارش اشکال‌زدایی

$ adb bugreport را اجرا کنید تا فایل zip تولید شود که باید حاوی همه داده‌ها باشد. تولید فایل zip ممکن است چند دقیقه طول بکشد.

بسته به نسخه Android، یکی از فرمان‌های زیر را برای دریافت btsnoop_hic.log اجرا کنید:

• برای Android نسخه ۸.x و بالاتر: shell $ adb pull data/misc/bluetooth/logs logs
• برای Android نسخه 7.x: shell $ adb pull sdcard/btsnoop_hci.log

توجه: Google توصیه می‌کند قبل‌از تلاش برای بارگیری فایل zip گزارش اشکال، تلفن را برای چند دقیقه در کنار دستگاه بلوتوث قرار دهید.