人機互動要求

主機控制器介面 (HCI) 用於與藍牙控制器互動。

本文檔提供了藍牙 (BT) 和藍牙低功耗 (BLE) HCI 要求清單。目的是讓主機 BT 堆疊供應商和 BT 控制器供應商符合這些平台要求，以便使用下述功能集。

本文檔將藍牙核心 5.2 規格稱為「規格」。藍牙核心 5.2 規格以及其他採用的文件可在藍牙 SIG 網站上取得。

整體設計概述

晶片能力及配置

作為一個開放平台，Android 擁有軟體版本、OEM、供應商以及平台和晶片功能的矩陣。

為了管理不斷變化的環境並管理遷移，本文檔描述了允許 BT 控制器公開其功能（超出標準藍牙核心 5.2 規範）的設計理念。然後，主機 BT 堆疊可以使用這些功能來確定要啟用哪些功能。

支援開放標準

Android 的目標之一是在藍牙規範獲得批准後支援開放標準。如果下面描述的功能在未來藍牙規範的標準 HCI 方法中可用，我們將傾向於將該方法設為預設方法。

供應商特定的功能

供應商特定命令： LE_Get_Vendor_Capabilities_Command

操作碼命令欄位 (OCF)：0x153

將為此命令產生命令完成事件。

掃描結果批量處理

設計目標是增強藍牙 LE 掃描回應事件通知傳送到主機的方式，以節省主機的電量。

透過減少控制器通知主機應用處理器掃描結果的頻率，主機應用處理器可以更長時間地保持空閒/睡眠狀態。這減少了主機的功耗。 LE_Get_Vendor_Capabilities_Command的回傳參數total_scan_results_storage表示晶片儲存掃描結果的能力。

此功能重點在於藍牙控制器中 LE 掃描結果儲存設施的管理和配置。記憶體用於臨時批次廣告資料以及掃描控制器接收的資料和元數據，以便稍後傳送到主機。

韌體應支援兩種類型的批次處理，可以同時進行：

• 被截斷。包含以下資訊元素：{MAC、TX Power、RSSI、Timestamp}
• 滿的。包含以下資訊元素：{MAC、TX Power、RSSI、時間戳記、進階資料、掃描回應}

LE_Batch_Scan_Command

OCF：0x156

將為此命令產生命令完成事件。啟用客戶特定功能不會啟動掃描。

LE_Batch_Scan_Command：啟用客戶特定功能

子 OCF：0x01

將為此命令產生命令完成事件。

LE_Batch_Scan_Command：設定批次掃描儲存參數子命令

子 OCF：0x02

將為此命令產生命令完成事件。

LE_Batch_Scan_Command：設定批次掃描參數子命令

子 OCF：0x03

如果啟用，此子命令將開始批次掃描。在截斷掃描中，結果以截斷形式存儲，其中截斷樣式的唯一鍵 = { BD_ADDR, scan_interval}。這意味著每個掃描間隔僅記錄一個BD_ADDR will 。截斷模式要保留的記錄如下：{ BD_ADDR , Tx Power, RSSI, Timestamp}

啟用完整模式時，將使用主動掃描並記錄掃描回應。完整樣式唯一金鑰 = {MAC，廣告資料包}，與掃描間隔無關。完整模式要保留的記錄是{ BD_ADDR , Tx Power, RSSI, Timestamp, Ad packet, Scan Response}。在完整樣式中，當在不同的掃描間隔內多次看到相同的 AD 封包時，僅記錄一次。然而，在截斷模式下，我們感興趣的是不同掃描間隔內BA_ADDR的可見性（每個掃描間隔一次）。 RSSI 是掃描間隔內唯一廣告的所有重複項的平均值。

將為此命令產生命令完成事件。

LE_Batch_Scan_Command：讀取批次掃描結果子命令

子 OCF：0x04

將為此命令產生命令完成事件。當主機發出此命令時，控制器中的所有結果可能無法容納在一個命令完成事件中。主機將迭代發出此命令，直到命令完成事件中的對應結果指示記錄數為0，這表示控制器沒有更多記錄可以與主機通訊。每個命令完成事件只能包含一種資料類型（完整或截斷）的多個記錄。

控制器和主機時間參考不同步。時間戳的單位是50ms。時間戳記的值是基於主機給定Read_Batch_Scan_Results_Sub_cmd時的值。如果韌體中的指令到達時間為T_c ，則韌體中取得時間戳記的實際時間為T_fw 。報告時間將為：( T_c - T_fw )。 T_c和T_fw在韌體時域中。這讓主機可以計算事件發生的時間。

廣告包內容過濾器

使用此選項可啟用/停用/設定控制器中的廣告封包內容過濾器 (APCF)。 APCF 過濾控制器中的廣告報告，但不過濾定期廣告。

LE_APCF_指令

OCF：0x157

將為此命令產生命令完成事件。

LE_APCF_Command：Enable_sub_cmd

子 OCF：0x00

將為此命令產生命令完成事件。

LE_APCF_Command：set_filtering_parameters_sub_cmd

此子指令用於新增或刪除濾波器規格或清除片上濾波器的濾波器清單。

子 OCF：0x01

RSSI 值必須使用 2 的補碼來表示負值。

主機應能夠配置多個過濾器，並將APCF_Application_Address_type設定為 0x02（對於所有廣播位址）以管理各種過濾器組合。

過濾、批次和報告是相互關聯的概念。每個廣告和相關的掃描回應都必須一個接一個地通過所有過濾器。因此，結果操作（ delivery_mode ）與過濾密切相關。交付模式有以下幾種： report_immediately 、 batch和onFound 。 OnLost值與OnFound相關，因為當遺失時它將出現在OnFound之後。

此處理流程描述了概念模型：

當接收到廣告（或掃描回應）幀時，它將按串行順序應用於所有過濾器。廣告可能會導致基於一個過濾器的立即報告以及由於不同的過濾器操作而導致的相同過濾器的大量報告。

RSSI 等級閾值（高和低）能夠控制訊框何時對過濾器處理可見，即使控制器接收到有效資料包也是如此。如果交付模式設定為立即或批次，則將考慮訊框的 RSSI 以進行進一步的控制器處理。不同的應用程式需要不同的報告和批次行為。這允許多個應用程式同時在韌體中直接報告和/或批次結果。例如，當一個應用程式啟用批量掃描，隨後另一個應用程式發出常規 LE 掃描時，就會出現這樣的情況。在發出大量掃描之前，框架/應用程式會設定適當的過濾器。稍後，當第二個應用程式發出定期掃描時，先前的批次將繼續。然而，由於定期掃描，它類似於在概念上添加空過濾器（以及所有現有過濾器）以及 LE 掃描命令。啟動時，LE 掃描指令參數優先。當常規 LE 掃描被停用時，控制器將恢復到先前的批次掃描（如果有）。

OnFound交付模式基於配置的篩選器。觸發過濾器操作成功的組合被視為要追蹤onLost實體。對應的事件是 LE Advt 追蹤子事件。

過濾器的OnFound/OnLost轉換（如果啟用）將如下所示：

將為此命令產生命令完成事件。

LE_APCF_Command：廣播_位址_子_cmd

此子指令用於新增或刪除廣告主地址或清除片上過濾的廣告商地址清單。

子 OCF：0x02

將為此命令產生命令完成事件。

LE_APCF_Command：service_uuid_sub_cmd

此子指令用於新增或刪除服務 UUID 或清除片上過濾的服務 UUID 清單。

子 OCF：0x03

將為此命令產生命令完成事件。

LE_APCF_Command：solicititation_uuid_sub_cmd

此子指令用於新增或刪除請求 UUID 或清除片上過濾的請求 UUID 清單。

子 OCF：0x04

將為此命令產生命令完成事件。

LE_APCF_Command：local_name_sub_cmd

此子指令用於新增或刪除本機名稱字串或清除片內篩選的本機名稱字串清單。

子 OCF：0x05

將為此命令產生命令完成事件。

LE_APCF_指令：manf_data_sub_cmd

此子指令用於新增或刪除製造商資料字串或清除片上過濾的製造商資料字串清單。

子 OCF：0x06

將為此命令產生命令完成事件。

LE_APCF_Command：service_data_sub_cmd

此子命令用於新增或刪除服務資料字串或清除片上過濾的服務資料字串清單。

子 OCF：0x07

將為此命令產生命令完成事件。

LE_APCF_Command：ad_type_sub_cmd

此子指令用於新增或刪除 AD 類型或清除片上過濾的 AD 類型清單。使用read_extended_features_sub_cmd檢查是否支援該指令。

子 OCF：0x09

將為此命令產生命令完成事件。

LE_APCF_Command：讀取擴充功能_子_cmd

此子命令用於讀取擴充 APCF 功能。

子 OCF：0xFF

將為此命令產生命令完成事件。

控制器活動和能量資訊命令

此資訊的目的是讓更高的主機系統功能結合應用程式和框架中發生的情況來分析所有元件的整體活動，包括 BT 控制器及其宏觀狀態。為此，BT 堆疊和控制器需要以下資訊：

• BT堆疊：報告控制器目前的巨集操作狀態
• 韌體：報告匯總活動和能源訊息

BT 主機堆疊巨集狀態，在使用者層級決定：

• 空閒：[頁面掃描、LE advt、查詢掃描]
• 掃描：[尋呼/查詢/嘗試連線]
• 活動：[ACL 連結打開，SCO 連結正在進行，嗅探模式]

控制器在其生命週期內追蹤的活動包括發送時間、接收時間、空閒時間和總能耗。從主機讀取時它們被清除。

LE_Get_Controller_Activity_Energy_Info

這是供應商特定的命令。

OCF：0x159

將為此命令產生命令完成事件。

LE擴充設定掃描參數指令

此命令可用於在控制器中啟用更大的掃描視窗和間隔。根據 BT Core 5.2 規範，掃描視窗和間隔的上限為 10.24 秒，這阻礙了應用程式的掃描間隔超過 10.24 秒。

基礎參考：BT Core 5.2 規範，第 2493 頁（LE 設定掃描參數指令）

OCF：0x15A

將為此命令產生命令完成事件。

取得控制器偵錯資訊命令

此資訊元素的目的是由主機以二進位形式取得控制器偵錯訊息，以進行後處理和分析。這有助於調試現場問題，並為工程師提供了記錄資訊以進行分析的工具包。當主機透過事件（控制器偵錯資訊子事件）請求時，控制器可以提供訊息，或在控制器需要時自主提供資訊。範例用途可以是報告韌體狀態資訊、故障轉儲資訊、日誌記錄資訊等。

OCF：0x15B

將為此命令產生命令完成事件。

A2DP 硬體卸載支援

A2DP 卸載功能支援將 A2DP 音訊編碼過程卸載到連接到 BT 控制器的音訊處理器。編碼的音訊資料流直接從音訊處理器傳遞到 BT 控制器，無需 BT 主機的參與。 BT主機仍然負責A2DP會話的配置和控制。有兩個版本的命令可用。 Sub OCF 0x01-0x02 的舊指令僅支援開源編解碼器。具有 Sub-OCF 0x02-0x03 的版本與配置的編解碼器無關。

OCF：0x15D

啟動 A2DP 卸載（舊版）

子 OCF：0x01

使用此命令可設定 A2DP 卸載進程並啟動 A2DP 流。

將為此命令產生命令完成事件。

啟動 A2DP 卸載

子 OCF：0x03

使用此命令可設定 A2DP 卸載進程並啟動 A2DP 流。

將為此命令產生命令完成事件。

停止 A2DP 卸載（舊版）

子 OCF：0x02

此指令用於停止 A2DP Offload 串流。

沒有為此命令定義參數。

將為此命令產生命令完成事件。

停止 A2DP 卸載

子 OCF：0x04

此指令用於停止 A2DP Offload 串流。

該命令將產生一個命令完成事件。

藍牙品質報告命令

BT品質報告指令功能啟動了藍牙控制器中的機制，向主機報告藍牙品質事件。您可以啟用四個選項：

• 品質監視模式：控制器會定期向主機發送連結品質相關的BQR子事件。
• 接近LSTO：如果未從連接的BT設備收到資料包的時間超過連結監督逾時（LSTO）值，則控制器向主機報告了接近的LSTO事件。
• A2DP音訊斷斷續續：當控制器偵測到引起斷斷續續音訊的​​因素時，控制器向主機報告了A2DP音訊波動事件。
• （e）SCO語音斷斷續續：當控制器偵測到引起波動聲音的因素時，控制器向主機報告了（e）SCO語音斷斷續續事件。
• 根部發炎：當HAL或控制器遇到致命錯誤並且需要重新啟動藍牙時，控制器將其發送到堆疊。
• LMP/LL訊息追蹤：控制器將使用遠端設備的LMP/LL訊息握手傳送到主機。
• 藍牙多人/COEX調度追蹤：控制器將其調度資訊發送有關處理多個藍牙設定檔和2.4 GHz頻段中的無線共存的資訊。
• 控制器偵錯資訊機制：啟用時，控制器可以自主透過控制器偵錯資訊的偵錯記錄資訊向主機報告。

OCF：0x15E

該命令將產生一個命令完成事件。

動態音訊緩衝區命令

動態音訊緩衝區透過基於各種情況更改藍牙控制器中的音訊緩衝區大小來減少音訊故障。

OCF：0x15F

取得音訊緩衝時間功能

子OCF：0x01

使用此命令從藍牙控制器中取得音訊緩衝時間功能。

該命令將產生一個命令完成事件。

設定音訊緩衝區時間

子OCF：0x02

使用此命令將音訊緩衝時間設定為藍牙控制器。

該命令將產生一個命令完成事件。

HCI事件（特定於供應商）

在某些情況下，需要特定於供應商的HCI事件。請參閱BT Core 5.2規範的第1897頁的圖5.4。事件參數0將始終包含第一個子事件代碼，基於HCI事件的其餘部分被解碼。

儲存閾值違反子事件

此事件表明儲存閾值已被違反。

子事件代碼= 0x54

LE多自動國家變化子事件

此事件表示廣告實例已改變了狀態。目前，此事件僅用於指示由於連線而停止了哪些廣告實例。

子事件代碼= 0x55

le廣告追蹤子事件

此事件指示何時找到或遺失廣告商。

子事件代碼= 0x56

控制器偵錯資訊子事件

控制器使用此事件將二進位偵錯資訊提供給主機。

子事件代碼= 0x57

藍牙品質報告子事件

此事件指示以下一個：發生藍牙品質事件，控制器上傳了LMP/LL訊息追蹤和藍牙多連結/COEX調度追蹤，或控制器轉儲的偵錯資訊資料。

子事件代碼= 0x58 [Quality_report_id = 0x01〜0x04，連結品質相關事件]

子事件代碼= 0x58 [Quality_report_id = 0x05，根發炎事件]

此事件顯示藍牙HAL或控制器遇到了致命的錯誤，需要藍牙堆疊來記錄這種情況並重新啟動。控制器必須在發送偵錯訊息事件的第一個片段之前，必須將root_inflammation_event傳送到藍牙堆疊。

error_code參數包含從HAL/控制器報告的錯誤代碼，如果是晶片組供應商特定的錯誤，則包含0。 vendor_specific_error_code包含來自HAL/控制器的晶片組供應商特定的錯誤代碼。如果參數error_code不是0，則應設定為0。

子事件代碼= 0x58 [Quality_report_id = 0x11〜0x13，日誌轉儲相關事件]

多縱向器支援

多主縱向支持的目標如下：

• 能夠支援多個廣告（ max_advt_instances ）
• 不同的發射功率以允許不同的範圍
• 不同的廣告內容
• 每位廣告客戶的個人化回應
• 每個廣告商的隱私（不可追蹤）
• 可連接

為了使此規範接近現有標準，提供了以下特定於供應商的命令。它們源自藍牙核心4.1規格。

le_multi_advt_command

OCF：0x154

該命令將產生一個命令完成事件。

le_multi_advt_command：set_advt_param_multi_sub_cmd

基本參考：藍牙核心4.1規格，第964頁（LE SET廣告參數指令）

子OCF：0x01

在設定此多主題實例時， Own_Address參數可以是主機配置的位址。這提供了在第一個信標傳輸時擁有可分解的私人地址的能力。實例的廣告將繼續，無論連線連線為何。主機BT堆疊可以發出命令，以在實例，貼文連線上啟動廣告。

依照上述命令，將為藍牙核心4.1規範中指定的該命令產生一個命令完成事件。如果廣告實例或Tx_Power參數無效，則控制器將使用非成功（無效參數）代碼回應。

le_multi_advt_command：set_advt_data_multi_sub_cmd

基本參考：藍牙核心4.1規格，第969頁（le設定廣告資料指令）

子OCF：0x02

依照上述命令，將為藍牙核心4.1規範中指定的該命令產生一個命令完成事件。如果廣告實例或Tx_Power參數無效，則控制器將使用非成功代碼回應。

le_multi_advt_command：set_scan_resp_data_multi_sub_cmd

基本參考：藍牙核心4.1規格，第970頁（LE SET掃描回應資料指令）

子OCF：0x03

依照上述命令，將為藍牙核心4.1規範中指定的該命令產生一個命令完成事件。如果廣告實例或Tx_Power參數無效，則控制器將使用非成功代碼（無效參數）回應。

le_multi_advt_command：set_random_addr_multi_sub_cmd

基本參考：藍牙核心4.1規格，第963頁（LE設定隨機位址指令）

子OCF：0x04

該命令將產生一個命令完成事件。

le_multi_advt_command：set_advt_enable_multi_sub_cmd

基本參考：藍牙核心4.1規範，第971頁（LE設定廣告啟用指令中的指令）

OCF：0x05

該命令將產生一個命令完成事件。

私人地址的卸載分辨率

此功能在控制器韌體或硬體中解決了一個私人地址，該地址提供以下好處：

• 與主人涉及的潛伏期解決私人地址
• 透過避免喚醒主機來節省電源

le_set_rpa_timeout

OCF：0x15c

le_rpa_offload_command

OCF：0x155

該命令將產生一個命令完成事件。

le_rpa_offload：enable_cust_specific_sub_command

子OCF：0x01

基於晶片功能，主機必須啟用RPA卸載。請參閱LE_Get_Vendor_Capabilities_Command 。每個晶片在韌體中可以有不同的max_irk_list_sz 。

該命令將產生一個命令完成事件。

le_rpa_offload：add_irk_to_list_sub_command

子OCF：0x02

該命令將產生一個命令完成事件。

le_rpa_offload：remove_irk_to_list_sub_command

子OCF：0x03

該命令將產生一個命令完成事件。

le_rpa_offload：clear_irk_list_sub_command

子OCF：0x04

該命令將產生一個命令完成事件。

le_rpa_offload：read_irk_list_sub_command

子OCF：0x05

該命令將產生一個命令完成事件。