ממשק בקר המארח (HCI) משמש לאינטראקציה עם בקר Bluetooth.
במאמר הזה מפורטות הדרישות של HCI (Host Controller Interface) ל-Bluetooth (BT) ול-Bluetooth עם צריכת אנרגיה נמוכה (BLE). המטרה היא שספקי ערימות BT של המארח וספקי בקרי BT יעמדו בדרישות הפלטפורמה האלה כדי להשתמש במערכת התכונות שמתוארת בהמשך.
במסמך הזה, המונח "מפרט" מתייחס למפרט הליבה של Bluetooth 5.2. מפרט Bluetooth Core 5.2 זמין ב אתר Bluetooth SIG, יחד עם מסמכים מאומצים אחרים.
סקירה כללית של העיצוב
יכולות והגדרות של הצ'יפ
בתור פלטפורמה פתוחה, ל-Android יש מטריצה של גרסאות תוכנה, יצרני ציוד מקורי (OEM), ספקים ויכולות של פלטפורמות ושבבים.
כדי לנהל את המצב המשתנה ולנהל העברות, במסמך הזה מתואר עיקרון עיצובי שמאפשר לבקרי BT לחשוף את היכולות שלהם (מעבר למפרט הליבה של Bluetooth 5.2). לאחר מכן, מחסנית ה-BT של המארח יכולה להשתמש ביכולות האלה כדי לקבוע אילו תכונות להפעיל.
תמיכה בתקנים פתוחים
אחת המטרות של Android היא לתמוך בתקנים פתוחים אחרי אישור במפרט Bluetooth. אם תכונה שמתוארת בהמשך תהיה זמינה בשיטות HCI רגילות במפרט Bluetooth עתידי, נשאף להפוך את הגישה הזו לגישת ברירת המחדל.
יכולות ספציפיות לספק
פקודה ספציפית לספק: LE_Get_Vendor_Capabilities_Command
שדה הפקודה של קוד האופרציה (OCF): 0x153
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
| לא רלוונטי | רשימת פרמטרים ריקה של פקודה |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
max_advt_instances(הוצאה משימוש) |
אוקטט אחד |
מספר המופעים של מודעות שנתמכים. שמור אחרי גרסה v0.98. הפרמטר הזה הוצא משימוש במפרט התכונות של Google בגרסה 0.98 ומעלה, לטובת פרסום מורחב ב-LE שזמין במפרט BT בגרסה 5.0 ומעלה. |
offloaded_resolution_of_private-address(הוצאה משימוש) |
אוקטט אחד |
יכולת שבב ה-BT של RPA. אם השבב תומך בכך, המארח צריך להפעיל את האפשרות. 0 = לא מסוגל 1 = מסוגל שמור אחרי גרסה 0.98. הפרמטר הזה הוצא משימוש במפרט התכונות של Google בגרסה 0.98 ומעלה, לטובת תכונת הפרטיות שזמינה במפרט BT בגרסה 4.2 ומעלה. |
total_scan_results_storage |
2 אוקטטים | נפח האחסון של תוצאות הסריקה בבייטים |
max_irk_list_sz |
אוקטט אחד | מספר רשומות ה-IRK שנתמכות בקושחה |
filtering_support |
אוקטט אחד |
תמיכה בסינון בבקר 0 = לא נתמך 1 = נתמך |
max_filter |
1 octet | מספר המסננים הנתמכים |
activity_energy_info_support |
אוקטט אחד |
תומך בדיווח על פעילות ומידע על אנרגיה 0 = לא מסוגל 1 = מסוגל |
version_supported |
2 אוקטטים |
מציין את הגרסה של מפרט התכונות של Google שנתמכת byte[0] = מספר הגרסה הראשית byte[1] = מספר הגרסה המשנית v1.05 byte[0] = 0x01 byte[1] = 0x05 תוספות של תכונות בגרסאות הבאות: v1.05:
|
total_num_of_advt_tracked |
2 אוקטטים |
המספר הכולל של מפרסמים שמתבצע אחריהם מעקב למטרות OnLost/OnFound
|
extended_scan_support |
אוקטט אחד | תמיכה בחלון סריקה ובמרווח סריקה מורחבים |
debug_logging_supported |
אוקטט אחד | תמיכה ברישום ביומן של מידע בינארי לניפוי באגים מהבקר |
LE_address_generation_offloading_support(הוצאה משימוש) |
1 octet |
0 = לא נתמך 1 = נתמך שמור אחרי גרסה 0.98. הפרמטר הזה הוצא משימוש במפרט התכונות של Google בגרסה 0.98 ומעלה, לטובת תכונת הפרטיות שזמינה במפרט BT בגרסה 4.2 ומעלה. |
A2DP_source_offload_capability_mask |
4 אוקטטים |
מסיכות ביטים לסוגי קודקים נתמכים ביט 0 – SBC ביט 1 – AAC ביט 2 – APTX ביט 3 – APTX HD ביט 4 – LDAC ביטים 5 עד 31 שמורים |
bluetooth_quality_report_support |
אוקטט אחד |
תומך בדיווח על אירועי איכות של Bluetooth 0 = לא מסוגל 1 = מסוגל |
dynamic_audio_buffer_support |
4 אוקטטים |
תמיכה במאגר אודיו דינמי בבקר Bluetooth מסיכות ביטים לסוגי קודקים נתמכים ביט 0 – SBC ביט 1 – AAC ביט 2 – APTX ביט 3 – APTX HD ביט 4 – LDAC ביטים 5 עד 31 שמורים |
a2dp_offload_v2_support |
אוקטט אחד |
תמיכה בפקודות A2DP offload v2 בבקר Bluetooth (ראו Start A2DP offload, Stop A2DP offload) 0 = אין תמיכה 1 = יש תמיכה |
iso_link_feedback_support |
1 octet |
תמיכה באירוע ISO Link Feedback 0 = לא נתמך 1 = נתמך |
sniff_offload_support |
אוקטט אחד |
תמיכה בפקודות Sniff Offload בבקר Bluetooth 0 = לא נתמך 1 = נתמך |
תוצאות של סריקה של קבוצת קבצים
אחת ממטרות התכנון היא לשפר את האופן שבו ההתראות על אירוע התגובה לסריקה של Bluetooth LE מועברות למארח, כדי לחסוך בחשמל במארח.
הפחתת התדירות שבה בקר ההפעלה שולח הודעה למעבד של אפליקציית המארח כדי לסרוק תוצאות, מאפשרת למעבד של אפליקציית המארח להישאר במצב סרק או שינה למשך זמן ארוך יותר. כך מצמצמים את צריכת החשמל במארח. פרמטר ההחזרה total_scan_results_storage של LE_Get_Vendor_Capabilities_Command מציין את יכולת השבב לאחסון תוצאות הסריקה.
התכונה הזו מתמקדת בניהול ובהגדרה של מתקן האחסון של תוצאות הסריקה של LE בבקר Bluetooth. האחסון משמש לאגירת נתונים של מודעות, נתוני סריקה ומטא-נתונים שמתקבלים מהבקר, כדי להעביר אותם מאוחר יותר למארח.
הקושחה תתמוך בשני סוגים של אצווה, שאפשר להפעיל אותם בו-זמנית:
- חתוך. הוא מכיל את רכיבי המידע הבאים: {MAC, TX Power, RSSI, Timestamp}
- מלא. מכיל את רכיבי המידע הבאים: {MAC, TX Power, RSSI, Timestamp, Adv Data, Scan Response}
LE_Batch_Scan_Command
OCF: 0x156
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
Batch_Scan_opcode |
אוקטט אחד |
0x1 – הפעלת תכונה ספציפית ללקוח 0x2 – הגדרת פרמטרים של אחסון סריקות באצווה 0x3 – הגדרת פרמטרים של סריקות באצווה 0x4 – קריאת פרמטרים של תוצאות סריקה באצווה |
אירוע Command Complete ייווצר עבור הפקודה הזו. הפעלת התכונה הספציפית ללקוח לא מתחילה את הסריקה.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Batch_Scan_opcode |
1 octet |
0x1 – הפעלת תכונה ספציפית ללקוח 0x2 – הגדרת פרמטרים של אחסון סריקות באצווה 0x3 – הגדרת פרמטרים של סריקות באצווה 0x4 – קריאת פרמטרים של תוצאות סריקה באצווה |
LE_Batch_Scan_Command: הפעלת תכונה ספציפית ללקוח
Sub OCF: 0x01
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
enable_customer_specific_feature_set |
אוקטט אחד |
0x01 – הפעלה של התכונה 'סריקה של קבוצת מסמכים' 0x00 – השבתה של התכונה 'סריקה של קבוצת מסמכים' |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Batch_Scan_opcode |
1 octet |
0x1 – הפעלת תכונה ספציפית ללקוח 0x2 – הגדרת פרמטרים של אחסון סריקות באצווה 0x3 – הגדרת פרמטרים של סריקות באצווה 0x4 – קריאת פרמטרים של תוצאות סריקה באצווה |
LE_Batch_Scan_Command: פקודת משנה להגדרת פרמטר האחסון של סריקת אצווה
Sub OCF: 0x02
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
Batch_Scan_Full_Max |
1 octet |
נפח האחסון המקסימלי (באחוזים) שהוקצה לסגנון מלא [טווח: 0-100] |
Batch_Scan_Truncated_Max |
1 אוקטט |
נפח האחסון המקסימלי (באחוזים) שהוקצה לסגנון קטוע [טווח: 0-100] |
Batch_Scan_Notify_Threshold |
1 octet |
הגדרת רמת ההתראה (באחוזים) עבור מאגר אחסון ספציפי
[הטווח: 0-100] הגדרה של 0 תשבית את ההתראה. נוצר אירוע HCI ספציפי לספק (אירוע משנה של חריגה מסף האחסון) |
אירוע Command Complete (הפקודה הושלמה) ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Batch_scan_opcode |
אוקטט אחד | 0x02 [הגדרת פרמטרים של סריקה באצווה] |
LE_Batch_Scan_Command: פקודת משנה להגדרת פרמטר של סריקת אצווה
Sub OCF: 0x03
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
Batch_Scan_Mode |
אוקטט אחד |
0x00 – סריקת אצווה מושבתת 0x01 – מצב חלקי מופעל 0x02 – מצב מלא מופעל 0x03 – מצב חלקי ומצב מלא מופעלים |
Duty_cycle_scan_window |
4 אוקטטים | זמן הסריקה של סריקת קבוצות (מספר המשבצת) |
Duty_cyle_scan_interval |
4 אוקטטים | פרק הזמן המיוצג על ידי המקבץ (מספר המשבצות) |
own_address_type |
אוקטט אחד |
0x00 – כתובת מכשיר ציבורית 0x01 – כתובת מכשיר אקראית |
Batch_scan_Discard_Rule |
אוקטט אחד |
0 – השמטת המודעה הכי ישנה 1 – השמטת המודעה עם עוצמת האות החלשה ביותר (RSSI) |
אם האפשרות הזו מופעלת, פקודת המשנה הזו תתחיל סריקה של קבוצת קבצים. בסריקה קטומה, התוצאות מאוחסנות בצורה קטומה, כאשר המפתח הייחודי לסגנון קטום = {BD_ADDR, scan_interval}. כלומר, רק BD_ADDR will יתועד לכל מרווח סריקה. הרשומה שצריך לשמור למצב קטוע היא הבאה: {BD_ADDR,
Tx Power, RSSI, Timestamp}
כשמצב מלא מופעל, נעשה שימוש בסריקה פעילה והתגובות לסריקה מוקלטות. המפתח הייחודי בסגנון Full = {MAC, Ad packet},
ללא קשר למרווח הסריקה. הרשומה שצריך לשמור למצב מלא היא
{BD_ADDR, Tx Power, RSSI, Timestamp, Ad packet, Scan
Response}. בסגנון 'מלא', אותו חבילת מודעות, כשרואים אותה כמה פעמים במרווחי סריקה שונים, נרשמת רק פעם אחת. עם זאת, במצב קטום, מה שמעניין הוא הנראות של BA_ADDR במרווחי סריקה שונים (פעם אחת בכל מרווח סריקה). הערך של
RSSI הוא הערך הממוצע של כל הכפילויות של מודעה ייחודית
בתוך מרווח סריקה.
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Batch_scan_opcode |
אוקטט אחד | 0x03 [הגדרת פרמטרים של סריקה באצווה] |
LE_Batch_Scan_Command: Read batch scan results subcommand
Sub OCF: 0x04
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
Batch_Scan_Data_read |
אוקטט אחד |
0x01 – נתונים במצב חלקי 0x02 – נתונים במצב מלא |
אירוע Command Complete ייווצר עבור הפקודה הזו. כשהמארח מנפיק את הפקודה הזו, יכול להיות שכל התוצאות בבקר לא יתאימו לאירוע אחד של השלמת פקודה. המארח יחזור על הפקודה הזו עד שהתוצאות התואמות באירוע Command Complete יציינו 0 במספר הרשומות, מה שמצביע על כך שאין לבקר יותר רשומות לתקשורת עם המארח. כל אירוע Command Complete יכול להכיל כמה רשומות של סוג נתונים אחד בלבד (מלא או חלקי).
ההפניות לזמן של הבקר והמארח לא מסונכרנות. יחידת הזמן של חותמת הזמן היא 50 אלפיות השנייה. ערך חותמת הזמן מבוסס על המועד שבו המארח מעביר את Read_Batch_Scan_Results_Sub_cmd. אם זמן ההגעה של הפקודה הוא
T_c בקושחה, אז הזמן בפועל שבו חותמת הזמן נוצרה בקושחה הוא T_fw. הזמן שיוצג בדוח יהיה:
(T_c - T_fw). T_c ו-
T_fw הם בטווח הזמן של הקושחה. כך המארח יכול לחשב כמה זמן עבר מאז שהאירוע התרחש.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Batch_scan_opcode |
אוקטט אחד | 0x03 [הגדרת פרמטרים של סריקה באצווה] |
Batch_Scan_data_read |
אוקטט אחד | מזהה את הפורמט (חתוך או מלא) |
num_of_records |
1 octet | מספר הרשומות של Batch_Scan_data_read |
format_of_data |
משתנה |
מצב חתוך: כתובת[0]: 6 אוקטטות סוג הכתובת[0]: אוקטטה אחת הספק השידור[0]: אוקטטה אחת עוצמת האות[0] : אוקטטה אחת חותמת זמן[0]: 2 אוקטטות [multiple records ( num_of_records) with above format]מצב מלא: כתובת[0]: 6 אוקטטות סוג הכתובת[0]: אוקטטה אחת הספק השידור[0]: אוקטטה אחת עוצמת האות[0]: אוקטטה אחת חותמת זמן[0]: 2 אוקטטות אורך מנת המידע של הפרסום[0]: אוקטטה אחת מנת המידע של הפרסום[0]: אוקטטות באורך מנת המידע של הפרסום אורך נתוני התגובה לסריקה[0]: אוקטטה אחת נתוני התגובה לסריקה[0]: Scan_data_resp אוקטטות[multiple records with above format ( num_of_records)]
|
Advertising Packet Content Filter
משתמשים באפשרות הזו כדי להפעיל, להשבית או להגדיר את מסנן התוכן של חבילת הפרסום (APCF) בבקר. מסנני APCF מסננים דוחות פרסום בבקר, אבל לא מסננים פרסום תקופתי.
LE_APCF_Command
OCF: 0x157
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
APCF_opcode |
1 octet |
0x00 – הפעלת APCF 0x01 – הגדרת פרמטרים של סינון APCF 0x02 – כתובת שידור APCF 0x03 – UUID של שירות APCF 0x04 – UUID של בקשת שירות APCF 0x05 – שם מקומי של APCF 0x06 – נתוני יצרן של APCF 0x07 – נתוני שירות של APCF 0x08 – שירות גילוי העברה של APCF 0x09 – מסנן סוג מודעה של APCF 0x10 עד 0xAF – שמור לשימוש עתידי 0xB0 עד 0xDF – שמור לספק 0xE0 עד 0xFE – שמור לשימוש עתידי 0xFF – קריאת תכונות מורחבות של APCF |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | סטטוס החזרה |
APCF_opcode |
1 octet |
0x00 – הפעלת APCF 0x01 – הגדרת פרמטרים של סינון APCF 0x02 – כתובת שידור APCF 0x03 – UUID של שירות APCF 0x04 – UUID של בקשת שירות APCF 0x05 – שם מקומי של APCF 0x06 – נתוני יצרן של APCF 0x07 – נתוני שירות של APCF 0x08 – שירות גילוי העברה של APCF 0x09 – מסנן סוג מודעה של APCF 0x10 עד 0xAF – שמור לשימוש עתידי 0xB0 עד 0xDF – שמור לספק 0xE0 עד 0xFE – שמור לשימוש עתידי 0xFF – קריאת תכונות מורחבות של APCF |
LE_APCF_Command: Enable_sub_cmd
Sub OCF: 0x00
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
APCF_enable |
אוקטט אחד |
0x01 – הפעלת התכונה APCF 0x00 – השבתת התכונה APCF |
אירוע Command Complete (הפקודה הושלמה) ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
1 octet | 0x0 – הפעלת APCF |
APCF_Enable |
אוקטט אחד | ההגדרה 'הפעלה/השבתה' מוגדרת דרך APCF_enable |
LE_APCF_Command: set_filtering_parameters_sub_cmd
פקודת המשנה הזו משמשת להוספה או למחיקה של הגדרת מסנן, או לניקוי של רשימת מסננים לסינון על שבב.
Sub OCF: 0x01
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
APCF_Action |
1 אוקטט |
0x00 – הוספה 0x01 – מחיקה 0x02 – ניקוי הפעולה 'מחיקה' תנקה את המסנן הספציפי יחד עם רשומות התכונות המשויכות בטבלאות אחרות. האפשרות Clear (ניקוי) תנקה את כל המסננים והערכים המשויכים בטבלאות אחרות. |
APCF_Filter_Index |
אוקטט אחד | אינדקס המסנן (0, max_filter-1) |
APCF_Feature_Selection |
2 אוקטטים |
מסכות ביטים לתכונות שנבחרו: ביט 0: מוגדר להפעלה של מסנן כתובות שידור ביט 1: מוגדר להפעלה של מסנן שינויים בנתוני השירות ביט 2: מוגדר להפעלה של בדיקת UUID של השירות ביט 3: מוגדר להפעלה של בדיקת UUID של בקשת שירות ביט 4: מוגדר להפעלה של בדיקת שם מקומי ביט 5: מוגדר להפעלה של בדיקת נתוני יצרן ביט 6: מוגדר להפעלה של בדיקת נתוני שירות ביט 7: מוגדר להפעלה של בדיקת שירות גילוי התעבורה ביט 8: מוגדר להפעלה של בדיקת סוג AD |
APCF_List_Logic_Type |
2 אוקטטים |
פעולה לוגית לכל בחירת תכונה (לפי מיקום ביט)
שמצוינת ב-APCF_Feature_Selection.
תקף רק כשתכונה מופעלת. ערך מיקום הביט: 0: OR 1: AND אם נבחרה לוגיקת AND, חבילת ADV תעבור את המסנן רק אם היא מכילה את כל הערכים ברשימה. אם נבחרה לוגיקת OR, מנה של ADV תעבור את המסנן אם היא מכילה אחת מהרשומות ברשימה. |
APCF_Filter_Logic_Type |
אוקטט אחד |
0x00: OR 0x01: AND הערה: סוג הלוגיקה לא רלוונטי לשלושת השדות הראשונים של APCF_Feature_Selection, שתמיד מוגדרת בהם לוגיקת AND. הם רלוונטיים רק לארבעה שדות (Bit 3 - Bit 6) של APCF_Feature_Selection.
|
rssi_high_thresh |
אוקטט אחד |
[in dBm] המערכת מחשיבה שהמשתמש ראה את המודעה רק אם עוצמת האות גבוהה מהסף הגבוה של RSSI. אחרת, הקושחה צריכה להתנהג כאילו היא לא ראתה את הנתונים האלה. |
delivery_mode |
אוקטט אחד |
0x00 - immediate0x01 - on_found0x02 - batched
|
onfound_timeout |
2 אוקטטים |
המבצע תקף רק אם delivery_mode הוא on_found.[באלפיות השנייה] הזמן שחולף עד שהקושחה אוספת עוד מודעות לפני הדיווח. |
onfound_timeout_cnt |
1 octet |
המבצע תקף רק אם delivery_mode הוא on_found.[count] אם מודעה ב- onFound נשארת בקושחה למשך
onfound_timeout, היא תאסוף כמה מודעות והמערכת תבדוק את המספר. אם הספירה חורגת מ-onfound_timeout_cnt, המערכת מדווחת על כך באופן מיידי.OnFound
|
rssi_low_thresh |
אוקטט אחד |
המבצע תקף רק אם delivery_mode הוא on_found.[in dBm] חבילת המפרסם נחשבת כלא נראית אם ערך ה-RSSI של החבילה שהתקבלה לא גבוה מסף ה-RSSI הנמוך. |
onlost_timeout |
2 אוקטטים |
המבצע תקף רק אם delivery_mode הוא on_found.[באלפיות השנייה] אם מודעה לא מוצגת ברציפות במשך תקופת הזמן lost_timeout אחרי שהיא נמצאה, המערכת תדווח מיד שהיא אבדה.
|
num_of_tracking_entries |
2 אוקטטים |
המבצע תקף רק אם delivery_mode הוא on_found.[count] המספר הכולל של מפרסמים למעקב לפי מסנן. |
כדי לייצג ערכים שליליים של RSSI, צריך להשתמש בשיטת המשלים ל-2.
המארח יוכל להגדיר כמה מסננים עם
APCF_Application_Address_type שמוגדר ל-0x02 (לכל כתובות השידור) כדי לנהל שילובים שונים של מסננים.
סינון, אצווה ודיווח הם מושגים שקשורים זה לזה. כל מודעה ותגובת סריקה קשורה צריכות לעבור את כל המסננים, אחד אחרי השני. לכן, הפעולות שמתקבלות
(delivery_mode) קשורות קשר הדוק לסינון. מצבי המסירה הם: report_immediately, batch ו-onFound. הערך OnLost קשור לערך OnFound במובן הזה שהוא יופיע אחרי OnFound אם הוא יאבד.
תרשים הזרימה הזה מתאר את המודל הקונספטואלי:
כשמתקבלת מסגרת של מודעה (או תגובה לסריקה), היא מוחלת על כל המסננים בסדר סדרתי. יכול להיות שמודעה תגרום לדיווח מיידי על סמך מסנן אחד, ולדיווח באצווה על סמך פעולת מסנן אחרת.
סף הרמות של RSSI (גבוה ונמוך) מאפשר לשלוט במקרים שבהם הפריים גלוי לעיבוד הסינון, גם כשבקר מקבל מנה תקפה. אם מצב המסירה מוגדר כ'מיידי' או כ'אצווה', עוצמת האות (RSSI) של פריים נלקחת בחשבון לצורך עיבוד נוסף של הבקר. אפליקציות שונות צריכות התנהגות שונה של דיווח ושל עיבוד בקבוצות. כך אפשר לכמה אפליקציות לדווח ישירות ו/או לאגד תוצאות בקושחה, בו-זמנית. לדוגמה, במקרה שבו סריקת אצווה פעילה מאפליקציה אחת, ומאוחר יותר אפליקציה אחרת מנפיקה סריקת LE רגילה. לפני הנפקת סריקת אצווה, המסגרת או האפליקציה מגדירות מסננים מתאימים. בשלב מאוחר יותר, כשהאפליקציה השנייה מבצעת סריקה רגילה, האפליקציה ממשיכה את האצווה הקודמת. עם זאת, בגלל הסריקה הרגילה, זה דומה מבחינה מושגית להוספת מסנן null (יחד עם כל המסננים הקיימים) יחד עם פקודת הסריקה LE. הפרמטרים של פקודת הסריקה LE מקבלים עדיפות כשהם פעילים. כשסריקת ה-LE הרגילה מושבתת, הבקר חוזר לסריקת אצווה קודמת, אם היא קיימת.
מצב המסירה OnFound מבוסס על מסננים שהוגדרו. שילוב שמפעיל את הפעולה של המסנן בהצלחה נחשב לישות למעקב עבור onLost. האירוע המתאים הוא אירוע המשנה של מעקב אחר מודעות LE.
המעבר של מסנן OnFound/OnLost (אם הוא מופעל) ייראה כך:
אירוע Command Complete (הפקודה הושלמה) ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
אוקטט אחד | 0x01 – APCF Set Filtering Parameters |
APCF_Action |
אוקטט אחד | פקודת הדהוד APCF_Action |
APCF_AvailableSpaces |
אוקטט אחד | מספר הרשומות הזמינות בטבלת המסננים |
LE_APCF_Command: broadcast_address_sub_cmd
פקודת המשנה הזו משמשת להוספה או למחיקה של כתובת מפרסם, או לניקוי רשימת הכתובות של המפרסמים לצורך סינון בתוך השבב.
Sub OCF: 0x02
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
APCF_Action |
אוקטט אחד |
0x00 – הוספה 0x01 – מחיקה 0x02 – ניקוי הפעולה 'מחיקה' תמחק את כתובת השידור שצוינה במסנן שצוין. הפקודה Clear תנקה את כל כתובות השידור במסנן שצוין. |
APCF_Filter_Index |
אוקטט אחד | אינדקס המסנן (0, max_filter-1) |
APCF_Broadcaster_Address |
6 אוקטטים | כתובת מכשיר באורך 6 בייט שרוצים להוסיף לרשימת הכתובות של המשדר או למחוק ממנה |
APCF_Application_Address_type |
אוקטט אחד |
0x00: ציבורי 0x01: אקראי 0x02: לא רלוונטי (התעלמות מסוג הכתובת) כדי לסנן דוחות פרסום לפי סוגי כתובות של זהויות (0x02, 0x03). כדי לקבל דוחות פרסום עם סוגי הכתובות 0x02 ו-0x03, צריך להגדיר את השדה הזה ל-0x02: NA (התעלמות מסוג הכתובת). |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
אוקטט אחד | 0x02 – כתובת של משדר APCF |
APCF_Action |
1 octet | פקודת הדהוד APCF_Action |
APCF_AvailableSpaces |
אוקטט אחד | מספר הרשומות החינמיות שעדיין זמינות בטבלה Broadcast Address |
LE_APCF_Command: service_uuid_sub_cmd
משתמשים בפקודת המשנה הזו כדי להוסיף או למחוק מזהה ייחודי אוניברסלי (UUID) של שירות, או כדי לנקות רשימה של מזהים ייחודיים אוניברסליים של שירות לסינון על שבב.
Sub OCF: 0x03
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
APCF_Action |
אוקטט אחד |
0x00 – הוספה 0x01 – מחיקה 0x02 – ניקוי מחיקה תמחק את כתובת ה-UUID של השירות שצוינה במסנן שצוין. הפקודה Clear תנקה את כל מזהי ה-UUID של השירות במסנן שצוין. |
APCF_Filter_Index |
אוקטט אחד | אינדקס המסנן (0, max_filter-1) |
APCF_UUID |
2,4,16 octet | ה-UUID של השירות (16 ביט, 32 ביט או 128 ביט) להוספה לרשימה או למחיקה ממנה. |
APCF_UUID_MASK |
2,4,16 octet |
מסכת ה-UUID של השירות (16 ביט, 32 ביט או 128 ביט) שרוצים להוסיף לרשימה.
האורך שלו צריך להיות זהה לאורך של APCF_UUID.
|
אירוע Command Complete (הפקודה הושלמה) ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
אוקטט אחד | 0x03 – מזהה ייחודי של שירות APCF |
APCF_Action |
אוקטט אחד | פקודת הדהוד APCF_Action |
APCF_AvailableSpaces |
אוקטט אחד | מספר הרשומות החינמיות שעדיין זמינות בטבלה Service UUID |
LE_APCF_Command: solicitation_uuid_sub_cmd
משתמשים בפקודת המשנה הזו כדי להוסיף או למחוק UUID של בקשת מידע, או כדי לנקות רשימה של UUID של בקשות מידע לסינון על שבב.
Sub OCF: 0x04
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
APCF_Action |
אוקטט אחד |
0x00 – הוספה 0x01 – מחיקה 0x02 – ניקוי הפעולה 'מחיקה' תמחק את כתובת ה-UUID של הבקשה במסנן שצוין. האפשרות Clear תנקה את כל מזהי ה-UUID של בקשות ההצטרפות במסנן שצוין. |
APCF_Filter_Index |
אוקטט אחד | אינדקס המסנן (0, max_filter-1) |
APCF_UUID |
2,4,16 octet | ה-UUID של הבקשה (16 ביט, 32 ביט או 128 ביט) שרוצים להוסיף לרשימה או למחוק ממנה. |
APCF_UUID_MASK |
2,4,16 octet |
מסכת ה-UUID של בקשת ההצטרפות (16 ביט, 32 ביט או 128 ביט) שרוצים להוסיף לרשימה. האורך שלו צריך להיות זהה לאורך של APCF_UUID.
|
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
אוקטט אחד | 0x04 – מזהה ייחודי אוניברסלי (UUID) של בקשת APCF |
APCF_Action |
1 octet | פקודת הדהוד APCF_Action |
APCF_AvailableSpaces |
1 אוקטט | מספר הרשומות החינמיות שעדיין זמינות בטבלה Solicitation UUID |
LE_APCF_Command: local_name_sub_cmd
פקודת המשנה הזו משמשת להוספה או למחיקה של מחרוזת שם מקומי, או לניקוי של רשימת מחרוזות השמות המקומיים לסינון בתוך השבב.
Sub OCF: 0x05
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
APCF_Action |
אוקטט אחד |
0x00 – הוספה 0x01 – מחיקה 0x02 – ניקוי המחיקה תמחק את מחרוזת השם המקומי שצוינה במסנן שצוין. האפשרות Clear תנקה את כל המחרוזות של השם המקומי במסנן שצוין. |
APCF_Filter_Index |
אוקטט אחד | אינדקס המסנן (0, max_filter-1) |
APCF_LocName_Mandata_or_SerData |
גודל משתנה |
מחרוזת תווים לשם מקומי. הערות:
|
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
1 אוקטט | 0x05 – שם מקומי של APCF |
APCF_Action |
1 octet | פקודת הדהוד APCF_Action |
APCF_AvailableSpaces |
אוקטט אחד | מספר הרשומות החינמיות שעדיין זמינות בטבלה Local name (שם מקומי) |
LE_APCF_Command: manf_data_sub_cmd
משתמשים בפקודת המשנה הזו כדי להוסיף או למחוק מחרוזת נתוני יצרן, או כדי לנקות את רשימת מחרוזות נתוני היצרן לסינון בתוך השבב.
Sub OCF: 0x06
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
APCF_Action |
אוקטט אחד |
0x00 – הוספה 0x01 – מחיקה 0x02 – ניקוי הפעולה Delete תמחק את מחרוזת נתוני היצרן שצוינה במסנן שצוין. האפשרות Clear תנקה את כל מחרוזות הנתונים של היצרן במסנן שצוין. |
APCF_Filter_Index |
אוקטט אחד | מסנן אינדקס (0, max_filter-1) |
APCF_LocName_Mandata_or_SerData |
גודל משתנה |
מחרוזת תווים של נתוני יצרן. הערות:
|
APCF_ManData_Mask |
גודל משתנה |
מסכת נתונים של יצרן שרוצים להוסיף לרשימה. האורך שלו צריך להיות זהה לאורך של APCF_LocName_or_ManData_or_SerData.
|
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
אוקטט אחד | 0x06 – נתוני יצרן של APCF |
APCF_Action |
אוקטט אחד | פקודת הדהוד APCF_Action |
APCF_AvailableSpaces |
1 octet | מספר הרשומות החינמיות שעדיין זמינות בטבלה 'נתוני יצרן' |
LE_APCF_Command: service_data_sub_cmd
משתמשים בפקודת המשנה הזו כדי להוסיף או למחוק מחרוזת של נתוני שירות, או כדי לנקות את רשימת המחרוזות של נתוני השירות לסינון בתוך השבב.
Sub OCF: 0x07
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
APCF_Action |
אוקטט אחד |
0x00 – הוספה 0x01 – מחיקה 0x02 – ניקוי הפעולה 'מחיקה' תמחק את מחרוזת נתוני השירות שצוינה במסנן שצוין. האפשרות Clear תנקה את כל מחרוזות הנתונים של השירות במסנן שצוין. |
APCF_Filter_Index |
אוקטט אחד | מסנן אינדקס (0, max_filter-1) |
APCF_LocName_Mandata_or_SerData |
גודל משתנה |
מחרוזת תווים לנתוני שירות. הערות:
|
APCF_LocName_Mandata_or_SerData_Mask |
גודל משתנה |
מסכת נתוני השירות שרוצים להוסיף לרשימה. האורך שלו צריך להיות זהה לאורך של APCF_LocName_or_ManData_or_SerData.
|
אירוע Command Complete (הפקודה הושלמה) ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
אוקטט אחד | 0x07 – נתוני שירות של APCF |
APCF_Action |
אוקטט אחד | פקודת הדהוד APCF_Action |
APCF_AvailableSpaces |
אוקטט אחד | מספר הרשומות החינמיות שעדיין זמינות בטבלה Service Data (נתוני שירות) |
LE_APCF_Command: ad_type_sub_cmd
משתמשים בפקודת המשנה הזו כדי להוסיף או למחוק סוג של מודעה, או כדי לנקות רשימה של סוגי מודעות לסינון בתוך השבב. משתמשים בפקודה read_extended_features_sub_cmd כדי לבדוק אם הפקודה הזו נתמכת.
אם APCF_AD_DATA_Length הוא 0, מסננים את APCF_AD_TYPE בלי להשוות בין AD Data לבין AD Data Mask.
אם אורך הנתונים של חבילת ה-ADV שהתקבלה גדול מ-AD_DATA_LENGTH, המערכת משווה רק את AD_DATA_LENGTH הבייטים הראשונים של נתוני ה-AD ומתעלמת מהנתונים הנותרים.
Sub OCF: 0x09
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
APCF_Action |
אוקטט אחד |
0x00 – הוספה 0x01 – מחיקה 0x02 – ניקוי מחיקה תמחק את סוג ה-AD שצוין במסנן שצוין. האפשרות Clear תנקה את כל סוגי המודעות במסנן שצוין. |
APCF_Filter_Index |
אוקטט אחד | מסנן אינדקס (0, max_filter-1) |
APCF_AD_TYPE |
אוקטט אחד | סוג המודעה להוספה לרשימה או למחיקה ממנה. התעלמות כש-APCF_Action הוא 0x02 (ניקוי) |
APCF_AD_DATA_Length |
1 octet |
0x00 – לא לסנן את תוכן הנתונים התעלמות כש- APCF_Action הוא 0x02 (ניקוי)
|
APCF_AD_DATA |
גודל משתנה |
גודל משתנה, על סמך APCF_AD_DATA_Lengthהתעלמות כש- APCF_Action הוא 0x02 (ניקוי) |
APCF_AD_DATA_MASK |
גודל משתנה |
גודל משתנה, בהתאם ל-APCF_AD_DATA_Lengthהתעלמות אם APCF_Action הוא 0x02 (ניקוי)האורך שלו צריך להיות זהה ל- APCF_AD_DATA.
|
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
אוקטט אחד | 0x09 – סוג מודעה של APCF |
APCF_Action |
אוקטט אחד | פקודת הדהוד APCF_Action |
APCF_AvailableSpaces |
אוקטט אחד | מספר הכניסות החינמיות שעדיין זמינות בטבלה 'סוג המודעה' |
LE_APCF_Command: read_extended_features_sub_cmd
פקודת המשנה הזו משמשת לקריאת תכונות APCF מורחבות.
Sub OCF: 0xFF
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
| לא רלוונטי | פרמטר פקודה ריק. |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
APCF_opcode |
אוקטט אחד | 0xFF - APCF_Read_Extended_Features |
APCF_extended_features |
2 אוקטטים |
מסיביות ביטים לתכונות מתקדמות נתמכות:
ערך הביט
|
פקודה של מידע על פעילות ובקרה של בקר
המטרה של המידע הזה היא לאפשר לפונקציות גבוהות יותר של מערכת המארח לנתח את כל הפעילויות של כל הרכיבים, כולל בקר ה-BT והמצב המאקרו שלו, בשילוב עם מה שקורה באפליקציות ובמסגרת. כדי לעשות זאת, נדרשים הפרטים הבאים ממערך ה-BT ומבקר ה-BT:
- רשימת פעילויות (activity stack): דיווח על המצב המקרו-תפעולי הנוכחי של הבקר
- קושחה: דיווח על פעילות מצטברת ופרטי אנרגיה
מצבי מאקרו של מחסנית מארח BT, כפי שנקבעו ברמת המשתמש:
- במצב המתנה: [סריקת דף, פרסום LE, סריקת שאילתה, סריקת LE]
- סריקה: [איתור/שאילתה/ניסיון להתחבר]
- פעיל: [קישור ACL פועל, קישור SCO מתבצע, מצב חטטנות]
הפעילויות שהבקר עוקב אחריהן במהלך חייו הן זמן השידור (Tx), זמן הקבלה (Rx), זמן ההמתנה (idle) וסך האנרגיה שנצרכה. הם נמחקים כשקוראים אותם מהמארח.
LE_Get_Controller_Activity_Energy_Info
זוהי פקודה ספציפית לספק.
OCF: 0x159
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
| לא רלוונטי | פרמטרים ריקים של פקודות |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
total_tx_time_ms |
4 אוקטטים | הזמן הכולל של ביצוע העברה |
total_rx_time_ms |
4 אוקטטים | הזמן הכולל של ביצוע מרשם |
total_idle_time_ms |
4 אוקטטים | הזמן הכולל במצב ללא פעילות (מצבי צריכת חשמל נמוכה שאינם שינה) |
total_energy_used |
4 אוקטטים | האנרגיה הכוללת שנעשה בה שימוש [מכפלה של הזרם (mA), המתח (V) והזמן (ms)] |
פקודה של פרמטרים לסריקה של קבוצת LE מורחבת
אפשר להשתמש בפקודה הזו כדי להפעיל חלון סריקה ומרווח גדולים יותר בבקר. לפי מפרט BT Core 5.2, חלון סריקה ומרווח סריקה מוגבלים ל-10.24 שניות, מה שמקשה על אפליקציות להשתמש במרווחי סריקה מעל 10.24 שניות.
הפניה לבסיס: BT Core 5.2 Specification, page 2493 (LE Set Scan Parameters Command)
OCF: 0x15A
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
LE_Ex_Scan_Type |
אוקטט אחד |
0x00 – סריקה פסיבית. לא יישלחו מנות SCAN_REQ (ברירת מחדל).0x01 – סריקה פעילה. יכול להיות שיישלחו מנות SCAN_REQ.
|
LE_Ex_Scan_Interval |
4 אוקטטים |
מוגדר כמרווח הזמן שחל מהרגע שבו הבקר התחיל את הסריקה האחרונה שלו של LE עד שהוא התחיל את הסריקה הבאה של LE. טווח: 0x0004 עד 0x00FFFFFF ברירת מחדל: 0x0010 (10 אלפיות השנייה) זמן = N * 0.625 אלפיות השנייה טווח זמן: 2.5 אלפיות השנייה עד 10442.25 שניות |
LE_Ex_Scan_Window |
4 אוקטטים |
משך הסריקה של LE. הערך של LE_Scan_Window צריך להיות קטן מ-LE_Scan_Interval או שווה לו.
טווח: 0x0004 עד 0xFFFF ברירת מחדל: 0x0010 (10 אלפיות השנייה) זמן = N * 0.625 אלפיות השנייה טווח זמן: 2.5 אלפיות השנייה עד 40.95 שניות |
Own_Address_Type |
1 אוקטט |
0x00 – כתובת ציבורית של המכשיר (ברירת מחדל) 0x01 – כתובת אקראית של המכשיר |
LE_Ex_Scan_Filter_Policy |
0x00 – קבלת כל חבילות הפרסום (ברירת מחדל). חבילות של מודעות ממוקדות שלא מיועדות למכשיר הזה יתעלמו מהן. 0x01 – התעלמות מחבילות פרסום ממכשירים שלא נמצאים ברשימת ההיתרים רשימה בלבד. חבילות של פרסום ממוקד שלא מיועדות למכשיר הזה יתעלמו מהן. |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
קבלת פקודה למידע על תוצאות ניפוי באגים של בקר
המטרה של רכיב המידע הזה היא לאפשר למארח לקבל מידע על ניפוי הבאגים של הבקר, בפורמט בינארי, לצורך עיבוד וניתוח. כך אפשר לנפות באגים בבעיות שמתרחשות בשטח, והמהנדסים מקבלים ערכת כלים לרישום מידע לצורך ניתוח. נאמן מידע יכול לספק את המידע כשמארח מבקש אותו באמצעות האירוע (אירוע משנה של פרטי ניפוי באגים של נאמן מידע) או באופן אוטונומי כשנאמן המידע רוצה בכך. דוגמאות לשימושים אפשריים: דיווח על מידע לגבי מצב הקושחה, מידע על קובץ dump של קריסה, מידע על רישום ביומן וכו'.
OCF: 0x15B
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
| לא רלוונטי | רשימת פרמטרים ריקה של פקודה |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
תמיכה בהורדת עומס של A2DP מהמעבד
התכונה A2DP offload תומכת בהעברה של תהליך קידוד האודיו של A2DP למעבד אודיו שמחובר לבקר ה-BT. סטרימינג של נתוני אודיו מקודדים עובר ישירות ממעבד האודיו לבקר ה-BT בלי מעורבות של מארח ה-BT. המארח של ה-BT עדיין אחראי להגדרה ולשליטה בסשן A2DP. יש שתי גרסאות של הפקודות. הפקודות הקודמות עם Sub OCF 0x01-0x02 תומכות רק בקוֹדֶקים בקוד פתוח. הגרסאות עם Sub-OCF 0x03-0x04 לא תלויות בקודק שהוגדר.
OCF: 0x15D
הפעלת הורדת העומס של A2DP (גרסה קודמת)
Sub OCF: 0x01
משתמשים בפקודה הזו כדי להגדיר את תהליך העברת הנתונים של A2DP וכדי להתחיל את הזרמת הנתונים של A2DP.
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
Codec |
4 אוקטטים |
מציין את סוג הקודק 0x01 – SBC 0x02 – AAC 0x04 – APTX 0x08 – APTX HD 0x10 – LDAC |
Max_Latency |
2 אוקטטים | זמן האחזור המקסימלי המותר (באלפיות השנייה). ערך של אפס משבית את השטיפה. |
SCMS-T_Enable |
2 אוקטטים |
אוקטט 0: דגל שמאפשר הוספה של כותרת SCMS-T.
אוקטט 1: ערך הכותרת SCMS-T, כשהיא מופעלת. |
Sampling_Frequency |
4 אוקטטים |
0x01 – 44,100 Hz 0x02 – 48,000 Hz 0x04 – 88,200 Hz 0x08 – 96,000 Hz |
Bits_Per_Sample |
אוקטט אחד |
0x01 – 16 ביט לדגימה 0x02 – 24 ביט לדגימה 0x04 – 32 ביט לדגימה |
Channel_Mode |
1 octet |
0x01 – מונו 0x02 – סטריאו |
Encoded_Audio_Bitrate |
4 אוקטטים |
קצב העברת הנתונים של האודיו המקודד בסיביות לשנייה. 0x00000000 – קצב העברת הנתונים של האודיו לא צוין או לא נעשה בו שימוש. 0x00000001 - 0x00FFFFFF - קצב העברת הנתונים של אודיו מקודד בסיביות לשנייה. 0x01000000 - 0xFFFFFFFF – שמור. |
Connection_Handle |
2 אוקטטים | ידית החיבור של חיבור A2DP שמגדירים |
L2CAP_Channel_ID |
2 אוקטטים | מזהה הערוץ של L2CAP שבו יש להשתמש לחיבור A2DP הזה |
L2CAP_MTU_Size |
2 אוקטטים | הגודל המקסימלי של L2CAP MTU שמכיל חבילות אודיו מקודדות |
Codec_Information |
32 אוקטטים |
מידע ספציפי על קודק.
קודק SBC:
אפשר לעיין ברכיבי מידע ספציפיים של SBC Codec ב-A2DP v1.3. קודק AAC:
אפשר לעיין ברכיבי מידע ספציפיים של קודק AAC ב-A2DP v1.3 קודק LDAC:
Octet 0-3: מזהה הספק
האוקטט 4-5: מזהה קודק
אוקטט 6: אינדקס קצב העברת נתונים:
Octet 7: LDAC Channel Mode Octet 8-31: שמור כל שאר רכיבי ה-Codec: אוקטט 0-31: שמור |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Sub_Opcode |
1 octet | 0x01 – הפעלת העברה לחומרת A2DP |
הפעלת הורדת העומס של A2DP מהמעבד
Sub OCF: 0x03
משתמשים בפקודה הזו כדי להגדיר את תהליך העברת הנתונים של A2DP וכדי להתחיל את הזרמת הנתונים של A2DP.
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
Connection Handle |
2 אוקטטים | ה-handle של חיבור ה-HCI הפעיל |
L2CAP_Channel_ID |
2 אוקטטים | מזהה של ערוץ L2CAP שנפתח להזרמת A2DP |
Data_Path_Direction |
אוקטט אחד |
0x00 – פלט (AVDTP Source/Merge) 0x01 – קלט (AVDTP Sink/Split) |
Peer_MTU |
2 אוקטטים | הגודל המקסימלי של מנות L2CAP, שנקבע במשא ומתן עם העמית. |
CP_Enable_SCMS_T |
1 octet |
0x00 – השבתה של כותרת הגנה על תוכן SCMS-T 0x01 – הפעלה של כותרת הגנה על תוכן SCMS-T |
CP_Header_SCMS_T |
1 octet |
כשההגדרה SCMS-T Content Protection Header (כותרת להגנה על תוכן SCMS-T) מופעלת (CP_SCMS_T_Enable
מוגדרת ל-0x01), היא מגדירה את ערך הכותרת שקודם לתוכן האודיו (ראו A2DP, סעיף 3.2.1-2) כפי שמוגדר ב-Bluetooth Assigned Numbers (מספרים שהוקצו ל-Bluetooth), סעיף
6.3.2.התעלמות מהערך אם ההגנה על תוכן SCMS-T לא מופעלת. |
Vendor_Specific_Parameters_Length |
אוקטט אחד |
אורך הפרמטרים הספציפיים לספק, בטווח שבין 0 ל-128. הערך 0 משמש כשלא מסופקים פרמטרים נוספים. |
Vendor_Specific_Parameters |
0 עד 128 אוקטטים |
פרמטרים ספציפיים לספק שסופקו על ידי Bluetooth Audio HAL,
CodecParameters.vendorSpecificParameters[].
|
אירוע Command Complete (הפקודה הושלמה) ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Sub_Opcode |
אוקטט אחד | 0x03 – הפעלת העברה לחומרת A2DP |
הפסקת הורדת העומס של A2DP (גרסה קודמת)
Sub OCF: 0x02
הפקודה הזו משמשת לעצירת הזרמת הנתונים של A2DP offload.
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
| לא רלוונטי | רשימת פרמטרים ריקה של פקודה. |
לא הוגדרו פרמטרים לפקודה הזו.
אירוע Command Complete (הפקודה הושלמה) ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Sub_Opcode |
אוקטט אחד | 0x02 – עצירת העברה לחומרת A2DP |
הפסקת הורדת העומס של A2DP
Sub OCF: 0x04
הפקודה הזו משמשת לעצירת הזרמת הנתונים של A2DP offload.
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
Connection Handle |
2 אוקטטים | ה-handle של חיבור ה-HCI הפעיל |
L2CAP_Channel_ID |
2 אוקטטים | מזהה של ערוץ L2CAP שנפתח להזרמת A2DP |
Data_Path_Direction |
אוקטט אחד |
0x00 – פלט (AVDTP Source/Merge) 0x01 – קלט (AVDTP Sink/Split) |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Sub_Opcode |
1 אוקטט | 0x04 – עצירת הורדת העומס של A2DP |
פקודה של דוח איכות Bluetooth
התכונה של פקודת דוח איכות ה-BT מפעילה את המנגנון בבקר ה-Bluetooth כדי לדווח על אירועי איכות ה-Bluetooth למארח. אתם יכולים להפעיל ארבע אפשרויות:
- מצב ניטור איכות: הבקר שולח למארח מעת לעת אירוע משנה של BQR שקשור לאיכות הקישור.
- התקרבות ל-LSTO: אם לא מתקבלות מנות מהמכשיר המחובר ב-BT במשך יותר ממחצית הערך של Link Supervision TimeOut (LSTO), הבקר מדווח על אירוע התקרבות ל-LSTO למארח.
- האודיו ב-A2DP קטוע: כשהבקר מזהה גורמים שגורמים לאודיו קטוע, הבקר מדווח על אירוע של אודיו קטוע ב-A2DP למארח.
- (e)SCO Voice Choppy: כשהבקר מזהה גורמים שגורמים לדיבור מקוטע, הבקר מדווח על אירוע (e)SCO Voice Choppy למארח.
- Root Inflammation: האירוע הזה נשלח מהבקר אל ה-stack כשמתרחשת שגיאה חמורה ב-HAL או בבקר, וצריך להפעיל מחדש את Bluetooth.
- מעקב אחר הודעות LMP/LL: הבקר שולח את הודעת LMP/LL למארח לאחר לחיצת היד עם המכשיר המרוחק.
- מעקב אחר תזמון של Bluetooth Multi-profile/Coex: הבקר שולח למארח את פרטי התזמון שלו לגבי טיפול בפרופילים מרובים של Bluetooth ודו-קיום אלחוטי בפס 2.4GHz.
- מנגנון מידע לניפוי באגים של בקר: כשההגדרה הזו מופעלת, הבקר יכול לדווח באופן אוטונומי על מידע לניפוי באגים באמצעות אירוע המשנה של מידע לניפוי באגים של הבקר למארח.
- LE Audio Choppy: כשהבקר מזהה גורמים שגורמים לאודיו קטוע, הבקר מדווח על אירוע LE Audio Choppy למארח.
-
מצב 'נתוני RF מתקדמים': הבקר מדווח למארח על נתוני ה-RF שלו, ותומך בשני תרחישי שימוש בדיווח:
- דוחות תקופתיים
- טריגרים של אירועים (התחלה או עצירה של סטרימינג וטריגר של אירוע איכות הקישור).
- מנגנון המעקב אחר תקינות הבקר מספק למארח מידע שקשור לתקינות באמצעות שני סוגי אירועים: דוחות תקופתיים ודוחות שמופעלים על ידי אירועים.
- BQR_Report_Action של פקודת דוח איכות Bluetooth: המארח יכול להשתמש בפקודת HCI הזו כדי לקבל שאילתה חד-פעמית למצב ניטור איכות, למצב ניטור אנרגיה או למצב סטטיסטיקה מתקדמת של RF.
OCF: 0x15E
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
BQR_Report_Action |
אוקטט אחד |
פעולה להוספה או למחיקה של דיווח על אירועים איכותיים שהוגדרו בפרמטר BQR_Quality_Event_Mask, או מחיקה של כל האירועים.
0x00 – הוספה
המחיקה תנקה את הדיווח על אירועים ספציפיים שקשורים לאיכות. |
BQR_Quality_Event_Mask |
4 אוקטטים |
מסיכות ביטים לדיווח על אירועי האיכות שנבחרו.
ביט 0: הגדרה להפעלה של מצב מעקב אחר איכות. |
BQR_Minimum_Report_Interval |
2 אוקטטים |
מגדירים את מרווח הזמן המינימלי בין דיווחים על אירועי איכות עבור האירועים שנבחרו. הקושחה של הבקר לא צריכה לדווח על האירוע הבא בתוך מרווח הזמן המוגדר. הגדרת המרווח
צריכה להיות רלוונטית ומיועדת לאירועי האיכות שמוסיפים.
יחידה: אלפיות השנייה |
BQR_Vendor_Specific_Quality_Event_Mask |
4 אוקטטים |
מסיכות ביטים לדיווח על אירועים ספציפיים של איכות הספק שנבחר. הפרמטר הזה תקף רק אם הביט 15 של BQR_Quality_Event_Mask מוגדר.
ביט 0 עד 31: שמור. |
BQR_Vendor_Specific_Trace_Mask |
4 אוקטטים |
מסכות ביטים לדיווח על מעקב ספציפי לספק שנבחר. הפרמטר הזה תקף רק אם הביט 31 של BQR_Quality_Event_Mask מוגדר.
ביט 0 עד 31: שמור. |
Report_interval_multiple |
4 אוקטטים |
המכפיל של BQR_Minimum_Report_Interval. אם הערך הזה הוא >= 1,
הפורמט של BQR Report Interval (מרווח הזמן של דוח BQR) הוא BQR Report Interval = BQR_Minimum_Report_Interval x Report_interval_multiple. הקושחה של הבקר לא יכולה לדווח על האירוע הבא בתוך מרווח הזמן המוגדר. הגדרת המרווח מיועדת במיוחד לאירועי האיכות שנוספו.
יחידה: ms BQR_Report_Interval גדול מהיכולת של בקר, הבקר צריך להחזיר את הזמן המקסימלי של BQR_Report_Interval עם השלמת הפקודה.
|
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Current_Quality_Event_Mask |
4 אוקטטים |
מציין את הגדרת מסכת הביטים הנוכחית. ביט 0: מצב מעקב אחר איכות מופעל. Bit 1: Approaching LSTO event reporting is enabled. Bit 2: הדיווח על אירועים של אודיו מקוטע ב-A2DP מופעל. ביט 3: (e)SCO Voice Choppy event reporting is enabled. Bit 4: דיווח על אירועי דלקת בשורש מופעל. ביט 5: מצב מעקב אחרי צריכת אנרגיה מופעל. Bit 6: הפעלת דיווח על אירועים של אודיו LE מקוטע. ביט 7: אירוע של כשל בחיבור. ביט 8: מוגדר להפעלה של טריגר לאירוע במצב 'סטטיסטיקות מתקדמות של RF'. Bit 9: Set to enable Advance RF Stats periodically report. Bit 10: מוגדר להפעלה של טריגר אירוע של מנגנון מעקב אחר תקינות הבקר. Bit 11: מוגדר להפעלה של מנגנון מעקב אחרי תקינות הבקר, כדי שידווח מדי פעם. ביט 12 עד 14: שמור. Bit 15: דיווח על אירועי איכות ספציפיים לספק מופעל. ביט 16: מעקב אחר הודעות LMP/LL מופעל. Bit 17: Bluetooth Multi-link/Coex scheduling trace is enabled. Bit 18: Controller Debug Information mechanism is enabled. Bit 19: Reserved for offload debug information Bit 20: UART History Dump Event trigger Bit 21 ~ 30: Reserved. ביט 31: מעקב ספציפי לספק מופעל. |
Current_Vendor_Specific_Quality_Event_Mask |
4 אוקטטים | מציין את הגדרת מסכת הביטים הנוכחית. |
Current_Vendor_Specific_Trace_Mask |
4 אוקטטים | מציין את הגדרת מסכת הביטים הנוכחית. |
BQR_Report_interval |
4 אוקטטים | מציין את הגדרת מסכת הביטים הנוכחית. |
Current_Vendor_Specific_Trace_Mask |
4 אוקטטים |
ההגדרה של BQR_Report_interval. הערך צריך להיות הערך המינימלי בין BQR_Minimum_Report_Interval * Report_interval_multiple לבין מרווח התמיכה המקסימלי של הבקר. |
פקודה דינמית למאגר נתונים זמני של אודיו
מאגר האודיו הדינמי מפחית את התקלות באודיו על ידי שינוי גודל מאגר האודיו בבקר ה-Bluetooth בהתאם לתרחישים שונים.
OCF: 0x15F
קבלת יכולת של זמן מאגר נתונים זמני של אודיו
Sub OCF: 0x01
משתמשים בפקודה הזו כדי לקבל את היכולת של זמן מאגר האודיו מבקר ה-Bluetooth.
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
| לא רלוונטי | רשימת פרמטרים ריקה של פקודה |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Dynamic_Audio_Buffer_opcode |
אוקטט אחד | 0x01 – קבלת הפסקה בין פגישות |
Audio_Codec_Type_Supported |
4 אוקטטים |
מסכות ביטים לסוגי הקודקים הנתמכים ביט 0 – SBC ביט 1 – AAC ביט 2 – APTX ביט 3 – APTX HD ביט 4 – LDAC ביטים 5 עד 31 שמורים |
Audio_Codec_Buffer_Default_Time_For_Bit_0 |
2 אוקטטים |
זמן ברירת המחדל של מאגר הנתונים הזמני של סוג הקודק Bit 0 שצוין ב-Audio_Codec_Type_Supported. הערך הזה צריך להיות 0 אם לא נתמך סוג קודק של Bit 0. יחידה: אלפיות השנייה |
Audio_Codec_Buffer_Maximum_Time_For_Bit_0 |
2 אוקטטים |
זמן המאגר המקסימלי של סוג קודק Bit 0 שצוין ב-Audio_Codec_Type_Supported. הערך הזה צריך להיות 0 אם לא נתמך סוג קודק של Bit 0. יחידה: אלפיות השנייה |
Audio_Codec_Buffer_Minimum_Time_For_Bit_0 |
2 אוקטטים |
זמן מאגר הנתונים הזמני המינימלי של סוג הקודק Bit 0 שצוין ב-Audio_Codec_Type_Supported. הערך הזה צריך להיות 0 אם לא נתמך סוג קודק של Bit 0. יחידה: אלפיות השנייה |
Audio_Codec_Buffer_Default_Time_For_Bit_1 |
2 אוקטטים |
זמן ברירת המחדל של מאגר הנתונים הזמני של סוג הקודק Bit 1 שצוין ב-Audio_Codec_Type_Supported. הערך הזה צריך להיות 0 אם לא קיימת תמיכה בסוג קודק Bit 1. יחידה: אלפיות השנייה |
Audio_Codec_Buffer_Maximum_Time_For_Bit_1 |
2 אוקטטים |
זמן המאגר המקסימלי של סוג קודק Bit 1 שצוין ב-Audio_Codec_Type_Supported. הערך הזה צריך להיות 0 אם לא קיימת תמיכה בסוג קודק Bit 1. יחידה: אלפיות השנייה |
Audio_Codec_Buffer_Minimum_Time_For_Bit_1 |
2 אוקטטים |
זמן מאגר מינימלי של סוג קודק Bit 1 שצוין ב-Audio_Codec_Type_Supported. הערך הזה צריך להיות 0 אם לא קיימת תמיכה בסוג קודק Bit 1. יחידה: אלפיות השנייה |
| ...... | ...... | ...... |
Audio_Codec_Buffer_Default_Time_For_Bit_31 |
2 אוקטטים |
זמן ברירת המחדל של מאגר הנתונים הזמני של סוג הקודק Bit 31 שצוין ב-Audio_Codec_Type_Supported. הערך הזה צריך להיות 0 אם לא נתמך סוג קודק של Bit 31. יחידה: אלפיות השנייה |
Audio_Codec_Buffer_Maximum_Time_For_Bit_31 |
2 אוקטטים |
זמן המאגר המקסימלי של סוג קודק Bit 31 שצוין ב-Audio_Codec_Type_Supported. הערך הזה צריך להיות 0 אם לא נתמך סוג קודק של Bit 31. יחידה: אלפיות השנייה |
Audio_Codec_Buffer_Minimum_Time_For_Bit_31 |
2 אוקטטים |
זמן מאגר נתונים זמני מינימלי של סוג הקודק Bit 31 שצוין ב-Audio_Codec_Type_Supported. הערך הזה צריך להיות 0 אם לא נתמך סוג קודק של Bit 31. יחידה: אלפיות השנייה |
הגדרת זמן מאגר הנתונים הזמני של האודיו
Sub OCF: 0x02
משתמשים בפקודה הזו כדי להגדיר את זמן מאגר האודיו לבקר Bluetooth.
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
Audio_Codec_Buffer_Time |
2 אוקטטים |
משך הזמן המבוקש של מאגר האודיו עבור הקודק הנוכחי שנמצא בשימוש. יחידה: אלפיות השנייה |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Dynamic_Audio_Buffer_opcode |
1 אוקטט | 0x02 – הגדרת הפסקה בין פגישות |
Audio_Codec_Buffer_Time |
2 אוקטטים |
משך מאגר האודיו הנוכחי בבקר ה-Bluetooth. יחידה: אלפיות השנייה |
אירוע HCI (ספציפי לספק)
במקרים מסוימים נדרשים אירועי HCI ספציפיים לספק. אפשר לעיין באיור 5.4 בעמוד 1897 של מפרט BT Core 5.2. פרמטר האירוע 0 תמיד יכיל את קוד אירוע המשנה הראשון, שעל פיו יפוענח שאר אירוע ה-HCI.
| פרמטר של אירוע | גודל | מטרה |
|---|---|---|
HCI_vendor_specific_event_code |
1 octet | 0xFF |
sub_event_code |
אוקטט אחד | קוד אירוע המשנה יהיה בגודל אוקטט אחד, הבייט שמיד אחרי אורך הפרמטר בחבילת אירוע ה-HCI. |
אירוע משנה של חריגה מסף האחסון
האירוע הזה מציין שחריגה מסף האחסון.
קוד אירוע משנה = 0x54
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
| ללא |
אירוע משנה של שינוי מצב פרסום מרובה ב-LE
האירוע הזה מציין שמופע של פרסום שינה את המצב שלו. בשלב הזה, האירוע הזה משמש רק כדי לציין איזה מופע של פרסום הופסק כתוצאה מחיבור.
קוד אירוע משנה = 0x55
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
Advertising_instance |
אוקטט אחד |
מזהה את מופע הפרסום הספציפי הערכים התקינים הם 0 עד max_advt_instances-1
|
State_Change_Reason |
אוקטט אחד | 0x00: התקבל חיבור |
Connection_handle |
2 אוקטטים |
מזהה את החיבור שגרם להשבתת המופע advt (0xFFFF אם לא תקין)
|
אירוע משנה של מעקב אחרי פרסום ב-LE
האירוע הזה מציין מתי נמצא מפרסם או מתי הוא לא נמצא.
קוד אירוע משנה = 0x56
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
APCF_Filter_Index |
אוקטט אחד | מסנן אינדקס (0, max_filter-1) |
Advertiser_State |
אוקטט אחד |
0x00: נמצא מפרסם 0x01: המפרסם לא נמצא |
Advt_Info_Present |
אוקטט אחד |
0x00: פרטי המפרסם (Advt_Info) קיימים0x01: פרטי המפרסם ( Advt_Info) לא קיימים
|
Advertiser_Address |
6 אוקטטים | כתובת ציבורית או אקראית |
Advertiser_Address_Type |
אוקטט אחד |
0x00: כתובת ציבורית 0x01: כתובת אקראית |
Advt_Info |
Tx_Pwr[0]: 1 אוקטט RSSI[0]: 1 אוקטט Timestamp[0]: 2 אוקטטים Adv packet_len[0]: 1 אוקטט Adv_packet[0]: Adv_packet_len אוקטטים Scan_data_resp_len[0]: 1 אוקטט Scan_data_resp[0]: Scan_data_resp אוקטטים
|
אירוע משנה של מידע על תוצאות ניפוי באגים של בקר
האירוע הזה משמש את בקר כדי לספק מידע בינארי לניפוי באגים למארח.
קוד אירוע משני = 0x57
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
debug_block_byte_offset_start |
2 אוקטטים | ניפוי באגים של היסט בייטים של בלוק מההתחלה |
last_block |
1 octet |
0x00: יש עוד נתוני ניפוי באגים 0x01: הבלוק הבינארי האחרון; אין עוד נתוני ניפוי באגים |
cur_pay_load_sz |
2 אוקטטים | גודל הבלוק הבינארי באירוע הנוכחי |
Debug_Data |
משתנה | נתוני ניפוי באגים של cur_payload_sz |
אירוע משנה של דוח איכות Bluetooth
האירוע הזה מציין אחד מהמקרים הבאים: התרחש אירוע איכות של Bluetooth, הבקר העלה את מעקב ההודעות של LMP/LL ואת מעקב התזמון של Bluetooth Multi-link/Coex, או שהבקר ביצע dump של נתוני מידע לניפוי באגים.
קוד אירוע משני = 0x58 [Quality_Report_Id = 0x01 ~ 0x04, Link Quality related event]
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
Quality_Report_Id |
אוקטט אחד |
0x01: דיווח על איכות במצב מעקב. 0x02: מתקרב ל-LSTO. 0x03: A2DP Audio Choppy. 0x04: (e)SCO Voice Choppy. 0x05 ~ 0x06: שמור. 0x07: LE Audio קטוע. 0x08: חיבור נכשל. 0x09 עד 0xFF: שמור. |
Packet_Types |
1 octet |
0x01: ID 0x02: NULL 0x03: POLL 0x04: FHS 0x05: HV1 0x06: HV2 0x07: HV3 0x08: DV 0x09: EV3 0x0A: EV4 0x0B: EV5 0x0C: 2-EV3 0x0D: 2-EV5 0x0E: 3-EV3 0x0F: 3-EV5 0x10: DM1 0x11: DH1 0x12: DM3 0x13: DH3 0x14: DM5 0x15: DH5 0x16: AUX1 0x17: 2-DH1 0x18: 2-DH3 0x19: 2-DH5 0x1A: 3-DH1 0x1B: 3-DH3 0x1C: 3-DH5 0x1D ~ 0x50: Reserved 0x51: ISO packet 0x52: 1M PHY 0x53: 2M PHY 0x54: Codec PHY S=2 0x55: Codec PHY S=8 0x56 ~ 0xFF: Reserved |
Connection_Handle |
2 אוקטטים | ACL/(e)SCO/ISO connection handle. |
Connection_Role |
אוקטט אחד |
ביצוע תפקיד לחיבור. 0x00: מרכזי 0x01: היקפי 0x02 עד 0xFF: שמור. |
TX_Power_Level |
אוקטט אחד |
רמת עוצמת השידור הנוכחית של Connection_Handle שצוין.
הערך הזה צריך להיות זהה לערך של בקר שמגיב לפקודת HCI_Read_Transmit_Power_Level HCI. |
RSSI |
אוקטט אחד |
[in dBm]
ערך של אינדיקטור עוצמת האות המתקבל (RSSI) עבור Connection_Handle שצוין. |
SNR |
אוקטט אחד |
[בדציבלים]
ערך יחס האות לרעש (SNR) עבור Connection_Handle שצוין. |
Unused_AFH_Channel_Count |
1 octet |
מציין את מספר הערוצים שלא בשימוש ב-AFH_channel_map. 0x4F עד 0xFF: שמור. |
AFH_Select_Unideal_Channel_Count |
אוקטט אחד |
מציין את מספר הערוצים שמופרעים ושאיכותם ירודה, אבל הם עדיין נבחרים ל-AFH. מספר הערוצים המינימלי שמותר לפי מפרט ה-Bluetooth הוא 20, כך שגם אם יש הפרעות בכל 79 הערוצים והאיכות שלהם נמוכה, הבקר עדיין צריך לבחור לפחות 20 ערוצים ל-AFH. |
LSTO |
2 אוקטטים |
ההגדרה הנוכחית של הזמן הקצוב לתפוגה של הפיקוח על הקישור. Time = N * 0.625 ms Time Range: 0.625 ms to 40.9 s |
Connection_Piconet_Clock |
4 אוקטטים |
שעון Piconet עבור Connection_Handle שצוין. הערך הזה צריך להיות זהה לערך של הפקודה HCI_Read_Clock שהבקר מגיב לה עם הפרמטר Which_Clock של 0x01 (שעון ה-Piconet). יחידה: N * 0.3125 ms (שעון Bluetooth אחד) |
Retransmission_Count |
4 אוקטטים |
מספר השידורים החוזרים מאז האירוע האחרון. הספירה הזו תאופס אחרי הדיווח למארח. |
No_RX_Count |
4 אוקטטים |
אין ספירת RX מאז האירוע האחרון. הספירה גדלה אם לא מתקבל אף חבילת נתונים במשבצת הזמן המתוזמנת, או אם חבילת הנתונים שהתקבלה פגומה. הספירה הזו תאופס אחרי הדיווח למארח. |
NAK_Count |
4 אוקטטים |
מספר ה-NAK (אישור שלילי) מאז האירוע האחרון. הספירה הזו תאופס אחרי הדיווח למארח. |
Last_TX_ACK_Timestamp |
4 אוקטטים |
חותמת הזמן של אישור העסקה האחרון. הוא מבוסס על שעון ה-Bluetooth של
המרכז של ה-piconet (CLK). יחידה: N * 0.3125 ms (שעון Bluetooth אחד) |
Flow_Off_Count |
4 אוקטטים |
מספר הפעמים שהבקר קיבל Flow-off (STOP) מאז האירוע האחרון. הספירה הזו תאופס אחרי הדיווח למארח. |
Last_Flow_On_Timestamp |
4 אוקטטים |
חותמת הזמן של ההעברה האחרונה (GO). הוא מבוסס על שעון ה-Bluetooth של
המרכז של ה-piconet (CLK). יחידה: N * 0.3125 ms (שעון Bluetooth אחד) |
Buffer_Overflow_Bytes |
4 אוקטטים |
[in Byte]
מספר הגלישות מעבר לגבולות המאגר מאז האירוע האחרון. |
Buffer_Underflow_Bytes |
4 אוקטטים |
[in Byte]
מספר המקרים של חוסר בנתונים במאגר הזמני מאז האירוע האחרון. |
bdaddr |
6 אוקטטים | כתובת של מכשיר מרוחק |
cal_failed_item_count |
אוקטט אחד | מספר הפריטים שכיול שלהם נכשל |
TX_Total_Packets |
4 אוקטטים | מספר החבילות שנשלחו. |
TX_UnAcked_Packets |
4 אוקטטים |
מספר החבילות שלא מתקבל אישור לגביהן. הספירה הזו מתאפסת אחרי שהמארח מקבל את הדוח. |
TX_Flushed_Packets |
4 אוקטטים |
מספר החבילות שלא נשלחו על ידי נקודת ה-flush שלו. הספירה הזו מתאפסת אחרי שהמארח מקבל את הדוח. |
TX_Last_Subevent_Packets |
4 אוקטטים |
מספר החבילות ששכבת הקישור מעבירה ב-PDU של נתוני CIS באירוע המשנה האחרון של אירוע CIS. הספירה הזו מתאפסת אחרי שהמארח מקבל את הדוח. הערך הוא אפס אם אין ערך תקין לקישור. |
CRC_Error_Packets |
4 אוקטטים |
מספר החבילות שהתקבלו עם שגיאת CRC מאז האירוע האחרון. הספירה הזו מתאפסת אחרי שהמארח מקבל את הדוח. |
RX_Duplicate_Packets |
4 אוקטטים |
מספר החבילות הכפולות (שידור חוזר) שהתקבלו מאז האירוע האחרון. הספירה הזו מתאפסת אחרי שהמארח מקבל את הדוח. |
RX_Unreceived_Packets |
4 אוקטטים |
מספר החבילות שלא התקבלו זהה לפרמטר של הפקודה LE READ ISO Link Quality (קריאת איכות הקישור ב-ISO LE) (ראו Bluetooth core Specification Version 5.4). מקורות הנתונים המשויכים הם CIS ו-BIS. כשמגדילים את הערך הזה, שכבת הקישור לא מקבלת מטען ייעודי (payload) ספציפי עד לנקודת הניקוי שלה (ב-CIS) או עד לסוף האירוע שהיא משויכת אליו (ב-BIS; ראו Bluetooth core Specification Version 5.4 Vol 6 Part B, Section 4.4.6.6). |
Coex_Info_Mask |
2 אוקטטים |
ביט 0 – CoexInvolvement: מוגדר כדי לציין שקיים חשד לפעילויות של שיתוף פעולה (Coex) כשדוח זה נוצר (לדוגמה, A2DP Chops ו-Approaching LSTO). Bit 1 - WL 2G Radio Active: Set to indicate WLAN 2G Radio is active. Bit 2 - WL 2G Connected: מוגדר כדי לציין שרדיו WLAN 2G פעיל ומחובר. Bit 3 - WL 5G/6G Radio Active: Set to indicate WLAN 5G/6G Radio is active. Bit 4-15 - שמור |
| פרמטר ספציפי לספק | (אורך כולל של הפרמטר – TBD) * אוקטטים | כדי שספק הבקר יקבל פרמטרים ספציפיים יותר לספק. |
קוד אירוע משנה = 0x58 [Quality_Report_Id = 0x05, Root Inflammation event]
האירוע הזה מציין ששכבת ה-HAL של Bluetooth או הבקר נתקלו בשגיאה חמורה, ושמערך הפרוטוקולים של Bluetooth צריך לתעד את המצב הזה ולהפעיל מחדש. הבקר צריך לשלוח את האירוע Root_Inflammation_Event למחסנית Bluetooth לפני שליחת הפרגמנט הראשון של אירועי פרטי הניפוי בכל מקרה.
הפרמטר Error_Code מכיל קוד שגיאה שדווח מ-HAL/Controller, או 0 אם זו שגיאה ספציפית לספק של ערכת השבבים. Vendor_Specific_Error_Code מכיל קוד שגיאה ספציפי של ספק ערכת השבבים מ-HAL/Controller. הערך צריך להיות 0 אם הפרמטר Error_Code לא שווה ל-0. הפרמטרים Error_Code ו-Vendor_Specific_Error_Code לא יכולים להיות שניהם 0.
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
Quality_Report_Id |
אוקטט אחד |
0x00 עד 0x04: שמור. 0x05: דלקת בשורש. 0x06 עד 0xFF: שמור. |
Error_Code |
1 אוקטט |
0x00: קוד שגיאה ספציפי של ספק ערכת השבבים נכלל. 0x01 עד 0xFF: אירעה שגיאה בבקר. רשימה של קודי שגיאה ותיאורים מופיעה במפרט Bluetooth [כרך 2], חלק D, קודי שגיאה. |
Vendor_Specific_Error_Code |
1 אוקטט |
0x00: לא נכלל קוד שגיאה ספציפי של ספק ערכת השבבים. 0x01 עד 0xFF: קוד שגיאה ספציפי לספק של ערכת השבבים. |
| פרמטר ספציפי לספק | (אורך כולל של הפרמטר – 4) * אוקטט | כדי שספק הבקר יקבל פרמטרים ספציפיים יותר לספק. |
קוד אירוע משנה = 0x58 [מזהה דוח איכות = 0x06, אירוע של ניטור אנרגיה]
האירוע הזה מספק תמונת מצב של צריכת החשמל של בקר ה-Bluetooth ומצבי הפעולה שלו במהלך תקופה מסוימת. האירוע הזה עוזר למפתחים ולמהנדסים לנתח את אופן ניהול ההספק של הבקר, לזהות אילו פעילויות צורכות הכי הרבה אנרגיה ולפתור בעיות שקשורות להספק.
הפרמטרים בדוח עוקבים אחרי מדדים חשובים, כולל:
- הצריכה הממוצעת הנוכחית: הזרם הכולל שמשמש את הבקר.
- הזמן שחלף במצבים שונים: הזמן הכולל (באלפיות השנייה) שהבקר מבלה במצב idle (שינה/צריכת חשמל נמוכה) לעומת מצב active (חיבור, שידור או קבלת נתונים).
- ספירת מעברי מצב: מספר הפעמים שהבקר עובר בין מצב לא פעיל למצב פעיל.
- הזמן שחלף במצבי רדיו ספציפיים: מדדים נפרדים לזמן שחלף בשידור (Tx) ובקליטה (Rx) גם בקישורי BR/EDR (Bluetooth Classic) וגם בקישורי LE (Bluetooth Low Energy).
- רמות הספק הממוצעות של השידור: הספק הממוצע (ב-dBm) שמשמש לשידורים בקישורי BR/EDR ו-LE.
- פעילות מפורטת של השרשרת: דוחות על הזמן שחלף במהלך שידור או קבלה פעילים של שרשרות, עם הבחנה בין פעולות של שרשרת אחת לבין פעולות של שתי שרשרות, ובין מגברי הספק פנימיים (iPA) לבין מגברי הספק חיצוניים (ePA).
- זמן פעילות הסריקה: הזמן שבו הבקר מבצע סריקה פעילה של מכשירי BR/EDR ו-LE.
בדיקת הפרמטרים האלה מאפשרת למהנדסים לקבל תובנות לגבי יעילות צריכת החשמל של הבקר ולשפר את הביצועים שלו.
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
Quality_Report_Id |
1 octet | 0x06: מעקב אחר צריכת אנרגיה |
Average_Current_Consumption |
2 אוקטטים | [ב-mA] צריכת הזרם הממוצעת של כל הפעילויות שנצרכות על ידי הבקר |
Idle_Total_Time (שינה) |
4 אוקטטים | [in ms] הזמן הכולל במצב לא פעיל (מצבי חיסכון בסוללה, שינה). |
Idle_Sate_Enter_Count |
4 אוקטטים | מציין כמה פעמים הבקר נכנס למצב לא פעיל. |
Active_Total_Time |
4 אוקטטים | [in ms] הזמן הכולל במצב הפעיל (במהלך שאילתה, החלפת דפים, תנועה של ACL/SCO/eSCO/BIS/CIS, עיבוד של משימה כלשהי). |
Active_State_Enter_Count |
4 אוקטטים | מציין כמה פעמים הבקר נכנס למצבים הפעילים. |
BR_RDR_Tx_Total_Time |
4 אוקטטים | [in ms] סך הזמן במצב Tx(שידור לתנועת ACL/SCO/eSCO) הספציפי ל-BR/EDR. |
BR_RDR_Tx_State_Enter_Count |
4 אוקטטים | הערך מציין כמה פעמים הבקר נכנס למצב שידור ספציפי של BR/EDR. |
BR_RDR_Tx_Average_Power_Level |
1 octets | [in dBm] רמת עוצמת השידור הממוצעת של כל קישורי ה-BR/EDR |
BR_RDR_Rx_Total_Time |
4 אוקטטים | [in ms] הזמן הכולל במצב Rx (קבלת תנועה מ-ACL/SCO/eSCO) הספציפי ל-BR/EDR. |
BR_RDR_Rx_State_Enter_Count |
4 אוקטטים | [in ms] מציין כמה פעמים הבקר נכנס למצב Rx ספציפי של BR/EDR. |
LE_Tx_Total_Time |
4 אוקטטים | [in ms] משך הזמן הכולל במצב LE specific Tx (שידור עבור ACL/BIS/CIS או תנועת פרסום של LE ). |
LE_Tx_State_Enter_Count |
4 אוקטטים | מציין כמה פעמים הבקר נכנס למצב קבלה (Rx) ספציפי של BR/EDR. |
LE_Tx_Average_Power_Level |
1 octets | [in dBm] רמת העוצמה הממוצעת של השידור של כל קישורי ה-LE. |
LE_Rx_Total_Time |
4 אוקטטים | [in ms] משך הזמן הכולל במצב LE specific Rx (קבלת נתונים מ-ACL/BIS/CIS או מתנועת סריקה של LE). |
LE_Rx_State_Enter_Count |
4 אוקטטים | [in ms] מציין כמה פעמים הבקר נכנס למצב קבלה ספציפי של LE |
Report_Time_Duration (זמן כולל) |
4 אוקטטים | [in ms] משך הזמן הכולל לאיסוף מידע שקשור לצריכת חשמל. |
RX_Active_One_Chain_Time |
4 אוקטטים | [in ms] משך הזמן שבו RX פעיל בשרשרת אחת |
RX_Active_Two_Chain_Time |
4 אוקטטים | [in ms] משך הזמן של RX פעיל בשני שרשורים |
TX_iPA_Active_One_Chain_Time |
4 אוקטטים | [in ms] משך הזמן של פעילות TX פנימית בשרשרת אחת |
TX_iPA_Active_Two_Chain_Time |
4 אוקטטים | [in ms] משך הזמן של פעילות TX פנימית בשני שרשורים |
TX_ePA_Active_One_Chain_Time |
4 אוקטטים | [in ms] משך הזמן של פעילות חיצונית של TX בשרשרת אחת |
TX_ePA_Active_Two_Chain_Time |
4 אוקטטים | [in ms] משך הזמן של פעילות TX חיצונית בשני שרשורים |
BREDR_RX_Active_Scan_total_Time |
4 אוקטטים | [באלפיות השנייה] משך הזמן (באלפיות השנייה) של סריקת BR/EDR בזמן פעילות של קבלת נתונים |
LE_RX_Active_Scan_total_Time |
4 אוקטטים | [in ms] Time period (ms) on LE scan RX active time |
קוד אירוע משנה = 0x58 [Quality_Report_Id = 0x09~0x0A, אירוע נתונים סטטיסטיים מתקדמים של RF]
האירוע Bluetooth Advanced RF (תדרי רדיו) Stats מספק מדדי ביצועים מפורטים לגבי התנהגות הרדיו של בקר ה-Bluetooth. יש שתי דרכים להפעלת האירוע:
- לפי טריגר (0x09): דוח חד-פעמי נשלח בתגובה לפקודה ספציפית.
- באמצעות Monitor (0x0A): הבקר שולח דוחות מעת לעת במרווחי זמן קבועים.
הפרמטרים של האירוע הם בעצם מונים של מנות מידע שעוקבים אחרי התנהגויות שונות של רדיו במהלך תקופה מוגדרת.
מדדים מרכזיים והמטרה שלהם
- נתונים סטטיסטיים של עוצמת השידור: מוניטורים שמודדים מנות מידע שנשלחות באמצעות הגדרות שונות של עוצמת השידור, ומבחינים בין מגברי עוצמת שידור פנימיים (iPA) וחיצוניים (ePA) לבין מצבים שונים של גיוון אנטנות (Div) או של עיצוב אלומה (BF). כך אפשר לקבוע אילו הגדרות של עוצמת השידור והאנטנה נמצאות בשימוש הכי תדיר.
- סלי RSSI (Received Signal Strength Indicator): הפרמטרים האלה מסווגים מנות שהתקבלו על סמך עוצמת האות שלהן. הדוח מספק תמונה ברורה של איכות הקישור על ידי ציון מספר המנות בטווחים ספציפיים של RSSI (למשל, פחות מ-90- dBm, 70- עד 75- dBm). מספר גבוה של נקודות בטווחים של קליטה חלשה (לדוגמה, < -90 dBm) מצביע על חיבור גרוע.
- הפרש עוצמת האות המתקבל (RSSI): המדד הזה מודד את ההבדל בעוצמת האות בין שתי האנטנות הקולטות (אם רלוונטי). המונים עוקבים אחרי מספר החבילות עם דלתא של RSSI בטווחים שונים. דלתא גדולה (למשל, >11 dBm) יכול להצביע על הפרעה או על חסימה פיזית, כי אנטנה אחת מקבלת אות חזק בהרבה מהאנטנה השנייה.
- החלפת אנטנות ושידור חוזר: בדוח נספרת התדירות שבה הבקר מחליף בין אנטנות, והוא עוקב אחרי מנות שמשודרות מחדש (ReTX). מספר גבוה של שידורים חוזרים מצביע בדרך כלל על חיבור חלש או לא אמין, שדורש שליחה מחדש של חבילות.
- איכות הערוץ: הפרמטרים האלה מספקים סיכום ברמה גבוהה של תקינות ערוצי תקשורת שונים, ומסווגים אותם כ'טובים', 'בסדר', 'גרועים' או 'גרועים מאוד' על סמך עוצמת האות (RSSI). כך אפשר לקבל סקירה כללית מיידית של סביבת ה-RF.
- תור מאגר זמני של שידור: בקטע הזה אפשר לעקוב אחרי מספר המנות שממתינות במאגר הזמני של השידור של הבקר לסוגים שונים של קישורים, כמו ACL (קישור לוגי אסינכרוני מבוסס-חיבור), LECONN (חיבור LE) ו-LEISOC (איזו-כרוני LE). מספרים גבוהים של מאגרים זמניים יכולים להעיד על צוואר בקבוק או על בעיה בזרימת הנתונים מהמארח לבקר.
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
Quality_Report_Id |
אוקטט אחד | 0x09: Advance RF Stats By Trigger 0x0A: Advance RF Stats By Monitor |
Extension_info |
1 אוקטט | פרטי הגרסה של BQR. 0x01 ל-BQRv6 0x02 ל-BQRv7 |
Report_Time_Period |
4 אוקטטים | תקופת הזמן לאיסוף נתוני הביצועים. יחידה: אלפיות השנייה |
TX_Power_iPA_BF |
4 אוקטטים | מונה מנות של iPA BF |
TX_Power_ePA_BF |
4 אוקטטים | מונה מנות של ePA BF |
TX_Power_iPA_Div |
4 אוקטטים | מונה מנות של ePA Div |
TX_Power_ePA_Div |
4 אוקטטים | מונה מנות של ePA Div |
RSSI_chain_50 |
4 אוקטטים | מונה חבילות של שרשרת RSSI > -50 dBm |
RSSI_chain_50_55 |
4 אוקטטים | מונה מנות של שרשרת RSSI בין -50 dBm לבין >-55 dBm |
RSSI_chain_55_60 |
4 אוקטטים | מונה מנות של שרשרת RSSI בין -55 dBm לבין >-60 dBm |
RSSI_chain_60_65 |
4 אוקטטים | מונה מנות של שרשרת RSSI בין -60 dBm לבין >-65 dBm |
RSSI_chain_65_70 |
4 אוקטטים | מונה מנות של שרשרת RSSI בין -65 dBm לבין >-70 dBm |
RSSI_chain_70_75 |
4 אוקטטים | מונה מנות של שרשרת RSSI בין -70 dBm לבין >-75 dBm |
RSSI_chain_75_80 |
4 אוקטטים | מונה מנות של שרשרת RSSI בין -75 dBm לבין >-80 dBm |
RSSI_chain_80_85 |
4 אוקטטים | מונה מנות של שרשרת RSSI בין -80 dBm לבין >-85 dBm |
RSSI_chain_85_90 |
4 אוקטטים | מונה מנות של שרשרת RSSI בין -85 dBm לבין >-90 dBm |
RSSI_chain_90 |
4 אוקטטים | מונה המנות של שרשרת RSSI < -90 dBm |
RSSI_delta_2 |
4 אוקטטים | מונה מנות של דלתא RSSI < 2 dBm |
RSSI_delta_2_5 |
4 אוקטטים | מונה מנות של דלתא RSSI בין 2dBm ל-5dBm |
RSSI_delta_5_8 |
4 אוקטטים | מונה מנות של דלתא RSSI בין 5 dBm ל-8 dBm |
RSSI_delta_8_11 |
4 אוקטטים | מונה מנות של דלתא RSSI בין 8 dBm ל-11 dBm |
RSSI_delta_11 |
4 אוקטטים | מונה מנות של דלתא RSSI > 11 dBm |
Antenna_Switch_Count |
4 אוקטטים | מונה המנות של אירוע החלפת האנטנה |
ReTX_iPA_BF |
4 אוקטטים | מונה המנות של ReTX_iPA_BF בתקופת הזמן האחרונה |
ReTX_ePA_BF |
4 אוקטטים | מונה מנות של ReTX_ePA_BF בתקופת הזמן האחרונה |
ReTX_iPA_Div |
4 אוקטטים | מונה המנות של ReTX_iPA_Div בתקופת הזמן האחרונה |
ReTX_ePA_Div |
4 אוקטטים | מונה המנות של ReTX_ePA_Div בתקופת הזמן האחרונה |
Channel_count_Good |
1 octets | מספר הערוצים שערך ה-RSSI שלהם נמוך מ-Bin-1 (<-90) |
Channel_count_OK |
1 octets | מספר הערוצים שערך ה-RSSI שלהם נמצא בטווח של Bin-2 (-90~-76) |
Channel_count_Bad |
1 octets | מספר הערוצים שעוצמת האות שלהם (RSSI) נמצאת בטווח של Bin-3 (-76~-50) |
Channel_count_VeryBad |
1 octets | מספר הערוצים שערך ה-RSSI שלהם נכלל בטווח Bin-4 (>-50) |
TX_buffer_Queue_Count |
4 אוקטטים | מונה של סטטוס תור המאגר – מאגר TX של בקר בטווח הזמן האחרון [0:3] ACL_1 [4:7] ACL_2 [8:11] LECONN_1 [12:15] LECONN_2 [16:19] LEISOC_1 [20:23] LEISOC_2 [24:27] LEBroadcast [28:31] rsvd |
קוד אירוע משני = 0x58 [Quality_Report_Id = 0x0B~0x0C, אירוע מעקב אחר תקינות הבקר]
האירוע 'מעקב אחר תקינות בקר Bluetooth' מספק סיכום של הסטטוס התפעולי של הבקר. יש שתי דרכים להפעלת האירוע:
- לפי טריגר (0x09): דוח חד-פעמי נשלח בתגובה לפקודה ספציפית.
- באמצעות Monitor (0x0A): הבקר שולח דוחות מעת לעת במרווחי זמן קבועים.
האירוע 'מעקב אחר תקינות של בקר Bluetooth' הוא כלי אבחון שמספק סיכום של סטטוס הפעולה של הבקר. האירוע הזה הוא חלק ממסגרת דוח איכות ה-Bluetooth (BQR), והוא משמש לניפוי באגים בקישוריות, בניהול צריכת החשמל ובבעיות תזמון. אפשר לשלוח אותו כדוח חד-פעמי או באופן תקופתי כדי לספק מעקב רציף.
מדדים מרכזיים והמטרה שלהם
- HCI Packet Counters: האירוע עוקב אחרי המספר הכולל של החבילות שנשלחו מהמארח לבקר ולהפך. המונים האלה חיוניים לניפוי באגים ב-Host Controller Interface (ממשק בקר מארח) של העברת נתונים (HCI), שהוא ערוץ התקשורת בין מחסנית התוכנה לבין שבב בקר ה-Bluetooth.
- Packet Lengths: האירוע מדווח על האורך של חבילת ה-HCI האחרונה שנשלחה ושהתקבלה. כך אפשר לוודא שהנתונים מועברים בצורה נכונה ושאין בעיות לא צפויות בגודל.
- מספר אותות ההפעלה: הדוח כולל את המספר הכולל של הפעמים שבהן הוצהרו הפינים BT_Wake ו-HOST_Wake. האותות הפיזיים האלה חשובים מאוד לניהול צריכת החשמל, כי הם משמשים להוצאת הישויות הרלוונטיות ממצבי צריכת חשמל נמוכה. מעקב אחרי המספרים האלה עוזר לנפות באגים בבעיות שקשורות להפעלה, כמו התעוררויות לא צפויות או כשלים בכניסה למצב שינה.
- חותמות זמן: האירוע מספק כמה חותמות זמן, כולל הזמן של אות ההפעלה האחרון ושל האיפוס האחרון של HCI. חותמות הזמן האלה עוזרות לפתור בעיות שקשורות לתזמון, ומספקות נקודת התייחסות לזמן שבו התרחשו אירועים מסוימים.
- טיימר Watchdog: דגל ספציפי מציין אם האירוע נוצר כאזהרה מוקדמת לכך שטיימר Watchdog של הבקר עומד לפוג. זו התראה קריטית לגבי קפיאות או תקלות אפשריות בבקר.
- סטטוס הקישור: בדוח מופיע סיכום של המצב הנוכחי של חיבורים פעילים, כולל המספר הכולל של קישורי BR/EDR, LE ו-CIS (Connected Isochronous Stream). הוא גם מציין אם יש קישורי SCO (Synchronous Connection-Oriented) פעילים. המידע הזה מספק תמונת מצב של עומס החיבור הנוכחי של הבקר.
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
Quality_Report_Id |
1 אוקטט | 0xB~0xC 0x0B: דוחות חד-פעמיים או דוחות שמופעלים על ידי אירועים 0x0C: דוחות תקופתיים. |
Packet_Count_Host_to_Controller |
4 אוקטטים | המספר הכולל של חבילות שנשלחו מהמארח לבקר דרך HCI. השדה הזה משמש לניפוי באגים ב-HCI (לדוגמה, UART). התנהגות: המונים מתאפסים כשהבקר מקבל איפוס HCI. |
Packet_Count_Controller_to_Host |
4 אוקטטים | המספר הכולל של מנות HCI Event שנשלחו למארח. השדה הזה משמש למטרות ניפוי באגים ב-HCI (למשל, בעיות ב-UART). התנהגות: המונים מתאפסים כשהבקר מקבל איפוס HCI. |
Last_Packet_Length_Host_to_Controller |
2 אוקטטים | אורך חבילת ה-HCI האחרונה שנשלחה ל-Host UART. הערה: האורך המקסימלי של מנות HCI הוא 2 אוקטט (כולל HCI, ACL, SCO, ISO) |
Last_Packet_Length_Controller_To_host |
2 אוקטטים | האורך של מנת הנתונים האחרונה של HCI שהתקבלה מ-Host UART. הערה: האורך המקסימלי של מנות HCI הוא 2 אוקטט (כולל HCI, ACL, SCO, ISO) |
Total_BT_Wake_Count |
4 אוקטטים | הספירה המצטברת של הצהרות על פינים של BT_Wake לפי ישות המארח. השדה הזה משמש ככלי אבחון לניפוי באגים בבעיות שקשורות להספק. התנהגות: המונים מתאפסים כשהבקר מקבל איפוס HCI. |
Total_HOST_Wake_Count |
4 אוקטטים | חישוב מצטבר של הצהרות על סיכות Host_Wake שהופעלו על ידי הבקר. השדה הזה משמש ככלי אבחון לניפוי באגים בבעיות שקשורות להספק. התנהגות: המונים מתאפסים כשהבקר מקבל איפוס HCI. |
Last_BT_Wake_TimeStamp |
4 אוקטטים | חותמת הזמן האחרונה שבה המארח אישר את פין ההפעלה של ה-BT.השדה הזה מיושם למטרת ניפוי באגים בבעיות שקשורות להספק. |
Last_HOST_Wake_TimeStamp |
4 אוקטטים | חותמת הזמן האחרונה שבה בקר הטען את הפין Host_Wake. השדה הזה משמש לניפוי באגים של בעיות שקשורות להספק. |
Reset_Timestamp |
4 אוקטטים | חותמת זמן שמציינת את השלמת האיפוס האחרון של HCI. השדה הזה משמש אך ורק כדי לפתור בעיות שקשורות לתזמון. היא צריכה לשמש כנקודת ההקלטה הראשונית שביחס אליה מתייחסים לכל הפריטים האחרים. |
Current_Timestamp |
4 אוקטטים | השעה הנוכחית שבה האירוע הזה נוצר. השדה הזה משמש לפתרון בעיות שקשורות להבדלים בתזמון. הוא צריך לשמש כנקודת הטריגר לתיעוד שכל שאר הרכיבים מפנים אליה. |
Is_WatchDog_Timer_About_To_Expire |
4 אוקטטים | דגל שמציין שאירוע הסטטוס הזה נוצר על ידי הבקר כאזהרה מוקדמת על תפוגה של כלב שמירה. חותמת הזמן הנוכחית מציינת את השעה שבה האירוע התרחש. |
Coex_Status_Mask |
2 אוקטטים | ביט 0 – שמור |
Total_Links_BR_EDR_LE_Active |
1 אוקטט | המספר הכולל של קישורי BR/EDR/LE במצב פעיל. |
Total_Links_BR_EDR_Sniff |
1 אוקטט | המספר הכולל של קישורי BR/EDR במצב Sniff/Idle. |
Total_Links_CIS |
1 אוקטט | המספר הכולל של קישורים ב-ISO. |
Is_SCO_Active |
1 אוקטט | אינדיקטור לבדיקה אם קישור ה-SCO מופעל כרגע. |
קוד אירוע משני = 0x58 [Quality_Report_Id = 0x11 ~ 0x13, Log Dump related event]
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
Quality_Report_Id |
אוקטט אחד |
0x00 עד 0x10: שמור. 0x11: מעקב אחר הודעות LMP/LL. 0x12: מעקב אחר תזמון של Bluetooth Multi-link/Coex. 0x13: העתקת נתונים של מידע על תוצאות ניפוי הבאגים של הבקר. 0x14 ~ 0xFF: שמור. |
Connection_Handle |
2 אוקטטים | נקודת אחיזה של החיבור. |
| פרמטר ספציפי לספק | (אורך כולל של הפרמטר – 4) * אוקטט | פורמט ספציפי לספק של מעקב אחר הודעות LMP, מעקב אחר תזמון של Bluetooth Multi-link/Coex ופריקת נתונים של מידע על ניפוי באגים בבקר. |
אירוע משנה של משוב על קישור ISO
קוד אירוע משנה = 0x5C
כשמפעילים את האירוע הזה, חובה ליצור אותו במהלך כל מרווח זמן לפי תקן ISO.
הפעלה
ההפעלה מתבצעת על ידי בחירת קוד הספקData_Path_ID 0x19 בפקודה הרגילה HCI_LE_Setup_ISO_Data_Path.
צריך לאשר את הפקודה HCI_Configure_Data_Path עם הערך Data_Path_ID שמוגדר ל-0x19 והערכים Vendor_Specific_Config_Length ו-0 שמוגדרים ל-0, גם אם לא צפויה פעולה מצד הבקר עם קבלת הפקודה הזו.
נקודת זמן של שליחה
האירוע מתרחש מתחילת מרווח ISO (נקודת עיגון CIG או BIG) ועד למרווח ה-ISO הבא. הבקר מציין את העיכוב בהתחלה בפועל של מרווח הזמן לפי תקן ISO באמצעותAnchor_Point_Delay.
סנכרון הבקר
בתחילת מרווח זמן לפי ISO, בקר ה-StreamSN מחשב את הערך על ידי הגדלת הערך הנוכחי ב-ISO_Interval ÷ SDU_Interval שהוגדר. במרווח הזמן הראשון, הערך מאותחל ל-0.לאחר מכן, לכל מנה בתור FIFO של ISO, חלים התנאים הבאים:
-
הבקר מחשב את ההפרש SNdiff בין שני מספרי הרצף:
SNdiff = (SDUSN - StreamSN + 0x10000) mod 0x10000 - כאשר
(SNdiff + (FT-1) × ISO_Interval ÷ SDU_Interval) mod 0x10000 <= (FT-1) × ISO_Interval ÷ SDU_Interval:
החבילה נמצאת בחלון השידור מחדש. היא הייתה אמורה להיות מתוזמנת לשידור במרווחים הקודמים ועכשיו היא זמינה לשידור חוזר. אם זה לא המקרה (השידור לא תוכנן), המשלוח התקבל באיחור. צריך להעביר את המידע הזה למארח באמצעות התגIn_Status. אפשר להשליך את המנות האלה או לתזמן את השידור שלהן. הבחירה תלויה בהטמעה. - או כשמתרחש
SNdiff < ISO_Interval ÷ SDU_Interval:
החבילה מתוזמנת לשידור מהאירוע הזה עד שתפוג ההמתנה לניקוי המאגר. - או כשמתקיימים התנאים
SNdiff >= ISO_Interval ÷ SDU_IntervalוגםSNdiff <= Max_Forward_Buffers:
החבילה היא עתידית; היא תועבר עם אירוע עוקב. החבילות נשלחות לפי הסדר, ולכן התנאי הזה מסיים את החיפוש של חבילות למרווח הזמן הזה.
המאגרים שבהם המארח משתמש לא מועברים לבקר, אבל הם מוגבלים ל-Max_Forward_Buffers = 16. - או אם אף אחד מהתנאים שלמעלה לא מתקיים:
החבילה מושלכת, הגיע הזמן הקצוב לתפוגה של הניקוי או שהתקבלה חבילה פגומה.
| פרמטר של אירוע משנה | גודל | מטרה |
|---|---|---|
Connection_Handle |
2 אוקטטים |
ה-handle של החיבור ב-CIS או ב-BIS הטווח: 0x0000 עד 0x0EFF |
Sequence_Number |
2 אוקטטים |
מספר הרצף של הזרם, שמנוהל על ידי הבקר. הערך ההתחלתי הוא 0 כשיוצרים את ה-CIS או ה-BIS, והוא גדל במספר ה-SDU במרווח הזמן האיזו-כרוני של ISO, שמוגדר כ- ISO_interval ÷ SDU_Interval,
בכל מרווח זמן של ISO.
|
Anchor_Point_Delay |
2 אוקטטים |
השהיה במיקרו-שניות בין יצירת האירוע לבין נקודת העוגן או תחילת המרווח לפי ISO של BIG או CIG.
חותמת הזמן של נקודת העוגן האפקטיבית מוגדרת לפי:Event generation time - Anchor_Point_Delay
הטווח: 0 עד מרווח ISO במיקרו-שניות |
In_Status |
2 אוקטטים |
מצב המאגר של בקר ISO בתחילת מרווח ISO, כל ביט bi מוגדר כשה-SDU (Sequence_Number + i) mod 0x10000 זמין. אם ה-SDU לא זמין, הוא מזוהה כ-Not received from the host.הערך i נע בין 0 ל- ISO_Interval ÷ SDU_Interval - 1.
לערכים אחרים של i, הביטים מוגדרים כ-0.
|
Tx_Status |
2 אוקטטים |
סטטוס השידור, ביחס ל-SDU עם מספרים סידוריים:(Sequence_Number - Flush_Timeout × ISO_Interval ÷ SDU_Interval + i + 0x10000)
mod 0x10000
כל ביט bi מוגדר כשכל יחידות ה-PDU של יחידת ה-SDU שזוהתה, לפי מספר הרצף שלה, הועברו ואושרו בהצלחה. הערך i נע בין 0 ל- ISO_Interval ÷ SDU_Interval - 1.
לערכים אחרים של i, הביטים מוגדרים כ-0.בקבוצת שידור, תמיד אמורה להתקבל אינדיקציה שהשידור התקבל. |
תמיכה בכמה מפרסמים
היעדים של התמיכה בכמה מפרסמים הם:
-
אפשרות לתמוך בכמה מודעות
(
max_advt_instances) - עוצמות שידור שונות כדי לאפשר טווחים שונים
- תוכן פרסומי שונה
- תשובה מותאמת אישית לכל מפרסם
- פרטיות (לא ניתן למעקב) לכל מפרסם
- ניתן לחיבור
כדי שהמפרט הזה יהיה קרוב לסטנדרטים הקיימים, סיפקנו את הפקודות הבאות שספציפיות לספקים. הם נגזרים מהמפרט של Bluetooth Core 4.1.
LE_Multi_Advt_Command
OCF: 0x154
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
Multi_advt_opcode |
אוקטט אחד |
0x01 – Set_Advt_Param_Multi_Sub_Cmd0x02 – Set_Advt_Data_Multi_Sub_Cmd0x03 – Set_Scan_Resp_Data_Multi_Sub_Cmd0x04 – Set_Random_Addr_Multi_Sub_Cmd0x05 – Set_Advt_Enable_Multi_Sub_Cmd
|
אירוע Command Complete (הפקודה הושלמה) ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Multi_advt_opcode |
1 אוקטט |
0x01 – Set_Advt_Param_Multi_Command0x02 – Set_Advt_Data_Multi_Command0x03 – Set_Scan_Resp_Data_Multi_Command0x04 – Set_Random_Addr_Multi_Command0x05 – Set_Advt_Enable_Multi_Command
|
LE_Multi_Advt_Command: Set_Advt_Param_Multi_Sub_Cmd
הפניה לבסיס: Bluetooth Core 4.1 Specification, page 964 (LE Set Advertising Parameter Command)
Sub OCF: 0x01
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
Advertising_Interval_Min |
לפי מפרט | לפי מפרט |
Advertising_Interval_Max |
לפי מפרט | לפי מפרט |
Advertising_Type |
לפי מפרט | לפי מפרט |
Own_Address_Type |
לפי מפרט | לפי מפרט |
Own_Address |
לפי מפרט | לפי מפרט |
Direct_Address_Type |
לפי מפרט | לפי מפרט |
Direct_Address |
לפי מפרט | לפי מפרט |
Advertising_Channel_Map |
לפי מפרט | לפי מפרט |
Adverstising_Filter_Policy |
לפי מפרט | לפי מפרט |
Advertising_Instance |
1 אוקטט | מציין את תחולת הפרמטרים שלמעלה על מופע |
Tx_power |
אוקטט אחד |
Transmit_Power יחידה – ב-dBm (מספר שלם עם סימן) טווח (-70 עד +20) |
הפרמטר Own_Address יכול להיות כתובת שהוגדרה על ידי המארח בזמן ההגדרה של מופע המודעות המרובות הזה. הפעולה הזו מאפשרת להקצות כתובת פרטית שניתן לפתור אותה בזמן השידור של האות הראשון. הפרסום במופע יימשך ללא קשר לחיבור. מערך ה-BT של המארח יכול להנפיק פקודה להפעלת פרסום במופע, אחרי החיבור.
אירוע Command Complete ייווצר עבור הפקודה הזו, כמו שצוין במפרט Bluetooth Core 4.1, בהתאם לפקודה שלמעלה. הבקר יגיב עם קוד שאינו מציין הצלחה (פרמטר לא תקין) אם מופע הפרסום או הפרמטרים של Tx_Power לא תקינים.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Multi_advt_opcode |
אוקטט אחד | 0x01 [Set_Advt_Param_Multi_Sub_Cmd] |
LE_Multi_Advt_Command: Set_Advt_Data_Multi_Sub_Cmd
הפניה לבסיס: Bluetooth Core 4.1 Specification, page 969 (LE Set Advertising Data Command)
Sub OCF: 0x02
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
Advertising_Data_Length |
לפי מפרט | לפי מפרט |
Advertising_Data |
לפי מפרט | לפי מפרט |
Advertising_Instance |
1 אוקטט | מציין את תחולת הפרמטרים שלמעלה על מופע |
אירוע Command Complete ייווצר עבור הפקודה הזו, כמו שצוין במפרט Bluetooth Core 4.1, בהתאם לפקודה שלמעלה. הבקר יגיב עם קוד שאינו קוד הצלחה אם מופע הפרסום או הפרמטרים של Tx_Power לא תקינים.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Multi_advt_opcode |
1 octet | 0x02 [Set_Advt_Data_Multi_Sub_Cmd] |
LE_Multi_Advt_Command: Set_Scan_Resp_Data_Multi_Sub_Cmd
הפניה לבסיס: Bluetooth Core 4.1 Specification, page 970 (LE Set Scan Response Data Command)
Sub OCF: 0x03
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
Scan_Response_Data_Length |
לפי מפרט | לפי מפרט |
Scan_Response_Data |
לפי מפרט | לפי מפרט |
Advertising_Instance |
1 אוקטט | מציין את תחולת הפרמטרים שלמעלה על מופע |
אירוע Command Complete ייווצר עבור הפקודה הזו, כמו שצוין במפרט Bluetooth Core 4.1, בהתאם לפקודה שלמעלה. הבקר יגיב עם קוד שאינו קוד הצלחה (פרמטר לא תקין) אם מופע הפרסום או הפרמטרים של Tx_Power לא תקינים.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Multi_advt_opcode |
1 octet | 0x03 [Set_Scan_Resp_Data_Multi_Sub_Cmd] |
LE_Multi_Advt_Command: Set_Random_Addr_Multi_Sub_Cmd
הפניה לבסיס: מפרט Bluetooth Core 4.1, דף 963 (פקודת כתובת אקראית של LE Set)
Sub OCF: 0x04
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
| כתובת אקראית | לפי מפרט | לפי מפרט |
Advertising_Instance |
1 אוקטט | מציין את תחולת הפרמטרים שלמעלה על מופע |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Multi_advt_opcode |
1 octet | 0x04 [Set_Random_Addr_Multi_Sub_Cmd] |
LE_Multi_Advt_Command: Set_Advt_Enable_Multi_Sub_Cmd
הפניה לבסיס: Bluetooth Core 4.1 Specification, page 971 (LE Set Advertise Enable Command in that core specification)
OCF: 0x05
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
Advertising_Enable |
1 octet | הערך 1 מציין הפעלה. כל ערך אחר משמעותו השבתה. |
Advertising_Instance |
1 octet | מציין את הרלוונטיות של הפרמטרים שלמעלה למופע. מכונה 0 מייצגת מכונת HCI רגילה. |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Multi_advt_opcode |
אוקטט אחד | 0x05 [Set_Advt_Enable_Multi_Sub_Cmd] |
העברת ההחלטה לגבי כתובת פרטית
התכונה הזו פותרת כתובת פרטית בקושחה או בחומרה של הבקר, ומספקת את היתרונות הבאים:
- השהייה שקשורה למארח בפענוח כתובת פרטית
- חיסכון בחשמל על ידי מניעת הפעלה של המארח
LE_Set_RPA_Timeout
OCF: 0x15C
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
LE_local_IRK |
16 אוקטטים | ה-IRK של המכשיר המקומי ששימש ליצירת כתובות אקראיות שניתנות לזיהוי. |
tRPA_min |
2 אוקטטים |
הזמן הקצוב המינימלי ליצירת RPA בשניות. הבקר צריך ליצור כתובות חדשות שניתנות לפתרון לכל אירועי הפרסום, הסריקה או החיבור שמתרחשים במהלך פסק הזמן הזה או אחריו. טווח תקין: 300-1800 |
tRPA_max |
2 אוקטטים |
הזמן הקצוב המקסימלי ליצירת RPA בשניות. הבקר צריך ליצור כתובות חדשות שניתנות לפתרון לכל אירועי הפרסום, הסריקה או החיבור לפני או במהלך פסק הזמן הזה. טווח ערכים תקין: tRPA_min-1800
|
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד |
הסטטוס של הפקודה. ערכי הסטטוס המומלצים של HCI: 0x00 Success 0x01 Unknown command (if not supported) 0x12 Invalid command parameters (if any parameters are outside the given range) |
LE_RPA_offload_Command
OCF: 0x155
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
RPA_offload_opcode |
אוקטט אחד |
0x1 – הפעלת תכונה ספציפית ללקוח 0x2 – הוספת IRK לרשימה 0x3 – הסרת IRK מהרשימה 0x4 – ניקוי רשימת IRK 0x5 – קריאת רשומה ברשימת IRK |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Event_RPA_offload_opcode |
1 octet |
0x1 – הפעלת תכונה ספציפית ללקוח 0x2 – הוספת IRK לרשימה 0x3 – הסרת IRK מהרשימה 0x4 – ניקוי רשימת IRK 0x5 – קריאת רשומה ברשימת IRK |
LE_RPA_offload: Enable_cust_specific_sub_Command
Sub OCF: 0x01
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
enable_customer_specific_feature_set |
אוקטט אחד |
0x01 – הפעלת התכונה של RPA עם הורדת עומס 0x00 – השבתת התכונה של RPA עם הורדת עומס |
המארח צריך להפעיל את העברת העומס של RPA על סמך יכולת השבב. מידע נוסף מפורט בLE_Get_Vendor_Capabilities_Command.
לכל שבב יכול להיות max_irk_list_sz שונה בקושחה.
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Event_cust_specific_feature_opcode |
1 octet | 0x01 [הפעלת תכונה ספציפית ללקוח] |
LE_RPA_offload: Add_IRK_to_list_sub_Command
Sub OCF: 0x02
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
LE_IRK |
16 אוקטטים | LE IRK (הבייט הראשון LSB) |
Address_Type |
1 octet |
0: כתובת ציבורית 1: כתובת אקראית |
LE_Device_Address |
6 אוקטטים | כתובת ציבורית או אקראית שמשויכת ל-IRK (הבייט הראשון LSB) |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Event_cust_specific_feature_opcode |
אוקטט אחד | 0x02 [Add IRK to the list] |
LE_IrkList_AvailableSpaces |
1 octet | רשומות ברשימת ה-IRL שזמינות אחרי הפעולה הנוכחית |
LE_RPA_offload: Remove_IRK_to_list_sub_Command
Sub OCF: 0x03
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
Address_Type |
אוקטט אחד |
0: כתובת ציבורית 1: כתובת אקראית |
LE_Device_Address |
6 אוקטטים | כתובת ציבורית או אקראית שמשויכת ל-IRK |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Event_cust_specific_feature_opcode |
1 octet | 0x03 [הסרת IRK מהרשימה] |
LE_IrkList_AvailableSpaces |
אוקטט אחד | רשומות ברשימת ה-IRL שזמינות אחרי הפעולה הנוכחית |
LE_RPA_offload: Clear_IRK_list_sub_Command
Sub OCF: 0x04
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
| ללא |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Event_cust_specific_feature_opcode |
אוקטט אחד | 0x04 [Clear IRK List] |
LE_IrkList_AvailableSpaces |
אוקטט אחד |
רשומות ברשימת ה-IRL שזמינות אחרי הפעולה הנוכחית [max_irk_list_sz]
|
LE_RPA_offload: Read_IRK_list_sub_Command
Sub OCF: 0x05
| פרמטר של פקודת משנה | גודל | מטרה |
|---|---|---|
LE_read_IRK_list_entry-index |
אוקטט אחד | אינדקס של רשימת ה-IRK [0, max_irk_list_sz-1] |
אירוע Command Complete ייווצר עבור הפקודה הזו.
| פרמטר החזרה | גודל | מטרה |
|---|---|---|
Status |
אוקטט אחד | הסטטוס Command Complete |
Event_cust_specific_feature_opcode |
1 octet | 0x05 [קריאת רשומה ברשימת IRK] |
LE_Read_IRK_List_entry |
אוקטט אחד | אינדקס של ה-IRK שהמארח רוצה לקרוא בחזרה (גודל רשימת ה-IRK המקסימלי הוא 32) |
LE_IRK |
16 אוקטטים | ערך IRK |
Address_Type |
אוקטט אחד |
0: כתובת ציבורית 1: כתובת אקראית |
LE_Device_Address |
6 אוקטטים | כתובת ציבורית או אקראית שמשויכת ל-IRK |
LE_Resolved_Private_Address |
6 אוקטטים | כתובת פרטית נוכחית שניתן לפתור את הבעיה שלה ב-IRK הזה |
Sniff Offload
התכונה Sniff Offload מעבירה את הניהול של מצב Sniff ממקבץ הפיצ'רים של מארח Bluetooth לבקר Bluetooth. כך בקר יכול לנהל את התזמון של הכניסה למצב Sniff או היציאה ממנו, ולהחיל פרמטרים של Sniff ושל דירוג משנה של Sniff שאפשר להגדיר, בזמן שהמארח שומר על השליטה בבחירת הפרמטרים על סמך שינויים בפעילות של פרופיל Bluetooth.
Sniff Offload States
בקטע הזה מוגדרים המצבים בבקר Bluetooth בהקשר של הפונקציה Sniff Offload. הוגדרו שני מצבים גלובליים כדי לזהות את הסטטוס של בקר Bluetooth ביחס להפעלה של Sniff Offload. הוגדרו שני מצבים ספציפיים לחיבור כדי לזהות את הסטטוס של חיבור BR/EDR כשהבקר של Bluetooth נמצא במצב Sniff Offload Enabled.
מדינות גלובליות
הוגדרו שני מצבים גלובליים כדי לזהות את הסטטוס של בקר Bluetooth ביחס להפעלת Sniff Offload.
מצב השבתה של Sniff Offload
בקר Bluetooth נחשב כברירת מחדל במצב 'העברת נתונים לזיכרון המטמון של Sniff מושבתת'. הבקר של Bluetooth אמור לטפל בפקודות HCI_Sniff_Mode, HCI_Exit_Sniff_Mode ו-HCI_Sniff_Subrating שמונפקות ממארח Bluetooth. בקר ה-Bluetooth צריך גם להעביר את האירועים HCI_Mode_Change ו-HCI_Sniff_Subrating למארח Bluetooth בהתאם למסכת האירועים שהוגדרה על ידי מארח ה-Bluetooth.
מצב ההעברה של Sniff Offload
בקר Bluetooth נחשב במצב 'העברת נתונים ל-Sniff Offload מופעלת' אחרי שהוא מטפל בהצלחה ב-'WriteSniffOffloadEnable' כדי להפעיל את Sniff Offload. במצב הזה, בקר ה-Bluetooth אמור להעביר את האירועים HCI_Mode_Change ו-HCI_Sniff_Subrating למארח Bluetooth, בהתאם להחלטה של פונקציית AND לוגית של מסכת האירועים שהוגדרה על ידי מארח ה-Bluetooth ודגלי דיכוי האירועים.
מצבים ספציפיים של חיבור
כשבקר Bluetooth נמצא במצב 'העברת נתונים ל-Offload מופעלת', כל ACL פעיל יכול להיות באחד משני המצבים שמתוארים בהמשך.
מצב הפרמטר: בהמתנה
רשימת ACL נחשבת במצב 'המתנה לפרמטרים' כשהבקר של Bluetooth נמצא במצב 'העברת נתונים ל-Sniff מופעלת', אבל פקודה ספציפית של ספק WriteSniffOffloadParameters לא הונפקה לפחות פעם אחת על ידי מארח ה-Bluetooth עבור רשימת ה-ACL הנוכחית.
מצב התחלה של בקרה
רשימת ACL נחשבת במצב 'הבקרה הופעלה' כשהבקר של Bluetooth נמצא במצב 'העברת נתונים של Sniff הופעלה', ופקודה ספציפית של ספק בשם WriteSniffOffloadParameters הונפקה לפחות פעם אחת על ידי מארח ה-Bluetooth עבור רשימת ה-ACL הנוכחית.
WriteSniffOffloadEnable
OCF: 0x310
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
Enable_Sniff_Offload |
1 octet | 0x00 : השבתה 0x01 : הפעלה |
Subrating_Max_Latency |
2 אוקטטים | הפרמטר Maximum Latency (זמן האחזור המקסימלי) ישמש לחישוב קצב המשנה המקסימלי של החיפוש שבו המכשיר המרוחק יכול להשתמש. ברירת מחדל: זמן האחזור T*sniff* = N × 0.625 ms (משבצת אחת של פס בסיס) טווח: 0x0002 עד 0xFFFE טווח זמן: 1.25 ms עד 40.9 s |
Subrating_Min_Remote_Timeout |
2 אוקטטים | הזמן הקצוב לתפוגה המינימלי של מצב החיפוש (T*sniff_mode_timeout*) שבו המכשיר המרוחק יכול להשתמש ברירת מחדל: 0x0000 הזמן הקצוב לתפוגה = N × 0.625 ms (משבצת אחת של פס בסיס) טווח: 0x0000 עד 0xFFFE טווח הזמן 0 שניות עד 40.9 שניות |
Subrating_Min_Local_Timeout |
2 אוקטטים | הזמן הקצוב המינימלי למצב סניפר (T*sniff_mode_timeout*) שבו המכשיר המקומי יכול להשתמש. ברירת מחדל: 0x0000 Timeout = N × 0.625 ms (1 Baseband slot) Range: 0x0000 to 0xFFFE Time Range: 0 s to 40.9 s |
Suppress_Mode_Change_Event |
אוקטט אחד | 0x00 : בקר ה-Bluetooth ידווח על אירוע HCI Mode_Change למארח, בכפוף להגדרה שנקבעה בפקודה HCI_Set_Event_Mask.0x01 : בקר ה-Bluetooth לא ידווח על אירוע HCI Mode_Change למארח. |
Suppress_Sniff_Subrating_Event |
1 octet | 0x00 : בקר ה-Bluetooth ידווח על אירוע HCI Sniff_Subrating למארח
בכפוף להגדרה שנקבעה בפקודה HCI_Set_Event_Mask. 0x01 : בקר ה-Bluetooth לא ידווח על אירוע HCI Sniff_Subrating למארח. |
WriteSniffOffloadParameters
OCF: 0x311
| פרמטר של פקודה | גודל | מטרה |
|---|---|---|
Connection_Handle |
2 אוקטטים | נקודת אחיזה לחיבור ACL של BR/EDR (16 ביט). טווח: 0x0000 עד 0x0EFF |
Sniff_Max_Interval |
2 אוקטטים | –טווח מוגדר של Bluetooth SIG, שמשמש בדרך כלל לכניסה למצב Sniff. טווח: 0x0002 עד 0xFFFE; רק ערכים זוגיים תקפים. טווח חובה: 0x0006 עד 0x0540. זמן = N × 0.625 ms. טווח זמן: 1.25 ms עד 40.9 s – מקרים מיוחדים 0x0000 : משמש לבחירת מצב 'העברה פעילה' של Sniff-Offload. 0x0001 : משמש לבחירת מצב 'העדפה פעילה' של Sniff-Offload. |
Sniff_Min_Interval |
2 אוקטטים | טווח: 0x0002 עד 0xFFFE; רק ערכים זוגיים הם חוקיים. טווח חובה: 0x0006 עד 0x0540 זמן = N × 0.625 ms טווח זמן: 1.25 ms עד 40.9 s |
Sniff_Attempts |
2 אוקטטים | מספר משבצות הזמן לקבלת פס בסיס לניסיון לריח. אורך = N × 1.25 ms טווח: 0x0001 עד 0x7FFF טווח זמן: 1.25 ms עד 40.9 s טווח חובה לבקר: 1 עד T*sniff* ÷ 2 |
Sniff_Timeout |
2 אוקטטים | מספר משבצות הזמן לקבלת פס בסיס לזמן קצוב לתפוס מידע. אורך = N × 1.25 ms טווח: 0x0000 עד 0x7FFF טווח זמן: 0 ms עד 40.9 s טווח חובה לבקר: 0 עד 0x0028 |
Link_Inactivity_Timeout |
2 אוקטטים | ערך הזמן הקצוב לתפוגה באלפיות השנייה. הטיימר של Link_Inactivity הופעל או אופס בכל עסקה של HCI-ACL. בסיום הטיימר הזה, הבקר יתחיל את הכניסה למצב Sniff. |
Subrating_Max_Latency |
2 אוקטטים | הפרמטר Maximum Latency (זמן האחזור המקסימלי) ישמש לחישוב קצב המשנה המקסימלי של החיפוש שבו המכשיר המרוחק יכול להשתמש. ברירת מחדל: זמן האחזור T*sniff* = N × 0.625 ms (משבצת אחת של פס בסיס) טווח: 0x0002 עד 0xFFFE טווח זמן: 1.25 ms עד 40.9 s |
Subrating_Min_Remote_Timeout |
2 אוקטטים | הזמן הקצוב לתפוגה המינימלי של מצב החיפוש (T*sniff_mode_timeout*) שבו המכשיר המרוחק יכול להשתמש ברירת מחדל: 0x0000 הזמן הקצוב לתפוגה = N × 0.625 ms (משבצת אחת של פס בסיס) טווח: 0x0000 עד 0xFFFE טווח הזמן 0 שניות עד 40.9 שניות |
Subrating_Min_Local_Timeout |
2 אוקטטים | הזמן הקצוב המינימלי למצב סניפר (T*sniff_mode_timeout*) שבו המכשיר המקומי יכול להשתמש. ברירת מחדל: 0x0000 Timeout = N × 0.625 ms (1 Baseband slot) Range: 0x0000 to 0xFFFE Time Range: 0 s to 40.9 s |
Allow_Exit_Sniff_On_Rx |
אוקטט אחד | דגל לשליטה ביציאה ממצב Sniff בעסקה של HCI-ACL בכיוון הקבלה. 0x00 : Do not exit sniff on Rx. 0x01 : Exit Sniff on Rx Receive-direction HCI-ACL is defined as ACL packet transmission from controller to host over HCI. |
Allow_Exit_Sniff_On_Tx |
אוקטט אחד | דגל לשליטה ביציאה ממצב Sniff בעסקה של HCI-ACL בכיוון השידור. 0x00 : Do not exit sniff on Tx. 0x01 : Exit Sniff on Tx Transmit-direction HCI-ACL is defined as ACL packet transmission from host to controller over HCI. |