fuchsia.bluetooth.sys

新增:7

PROTOCOLS

存取權

在 fuchsia.bluetooth.sys/access.fidl 中定義

此通訊協定會抽象化藍牙通用存取設定檔中定義的作業模式和程序 (請參閱核心規格 v5.1 第 3 卷第 C 部分)。

本通訊協定下的程序適用於整個系統。在這些程序中扮演主動角色的藍牙控制器,可以使用 HostWatcher 通訊協定進行管理。

基礎管道關閉時,Access 通訊協定執行個體啟動的程序會終止。

連線

使用指定的 id 啟動與對等互連裝置的連線。這個方法會根據對等互連裝置支援的技術,同時連線至 BR/EDR 和 LE 傳輸。

  • 要求 id 要連線的對等互連 ID。
  • 如果無法啟動與對等互連裝置的連線,系統會產生錯誤報告 Error.FAILED。
  • 如果無法辨識 id,則會回報錯誤 Error.PEER_NOT_FOUND。

要求

名稱類型
id fuchsia.bluetooth/PeerId

回應

名稱類型
payload Access_Connect_Result

取消連結

中斷與具有指定 id 的對等互連的所有邏輯連結。包括使用所有 Access 和 fuchsia.bluetooth.le 通訊協定例項啟動的 LE 和 BR/EDR 連結。

  • 要求 id 要中斷連線的對等互連 ID。
  • 如果無法辨識 id,則會回報錯誤 Error.PEER_NOT_FOUND。

要求

名稱類型
id fuchsia.bluetooth/PeerId

回應

名稱類型
payload Access_Disconnect_Result

清除

移除所有繫結資訊,並中斷與指定 id 對等互連的所有現有連結。

  • 要求 id:要忘記的對等互連 ID。
  • 如果無法辨識 id,則會回報錯誤 Error.PEER_NOT_FOUND。

要求

名稱類型
id fuchsia.bluetooth/PeerId

回應

名稱類型
payload Access_Forget_Result

MakeDiscoverable

將系統設為 BR/EDR 傳輸的「一般可探索」模式。主機處於活動狀態時,會定期進入查詢掃描模式,以回應一般查詢。

  • 如果無法進入查詢模式,則 error Reports Error.FAILED。

要求

名稱類型
token server_end:ProcedureToken

回應

名稱類型
payload Access_MakeDiscoverable_Result

配對

使用指定的 options 啟動與遙控器 id 的配對程序。 配對程序完成或中止後,這個呼叫才會完成。 如果找不到具有 id 的已連線對等互連裝置,或配對程序失敗,系統會傳回錯誤。 如果具名對等互連裝置已配對,系統會立即傳回成功值,但如果配對作業是透過 LE 進行,且 PairingOptions.le_security_level 比目前的安全性層級更安全,系統就會嘗試將安全性提升至要求的層級。

配對會透過 options.transport 指示的任何傳輸方式進行。如果該傳輸方式目前未連線,與「Error.PEER_NOT_FOUND」配對就會失敗。目前如果要求 DUAL_MODE,我們會嘗試透過 LE 傳輸配對。

  • 要求 id 要與其配對的對等互連 ID
  • 要求 options:用於這項配對要求的設定選項
  • 錯誤報告 Error.PEER_NOT_FOUND (如果系統無法辨識 id,或對等互連裝置未透過要求的傳輸方式連線)。
  • 如果傳遞的選項格式不正確,則會回報錯誤 Error.INVALID_ARGUMENTS
  • 錯誤報告 Error.FAILED 配對時發生錯誤

要求

名稱類型
id fuchsia.bluetooth/PeerId
options PairingOptions

回應

名稱類型
payload Access_Pair_Result

SetConnectionPolicy

為有效主機設定 BR/EDR 和 LE 連線政策。

  • 如果無法套用所要求的連線政策,則會回報錯誤。
新增:HEAD

要求

名稱類型
payload AccessSetConnectionPolicyRequest

回應

名稱類型
payload Access_SetConnectionPolicy_Result

SetDeviceClass

設定系統處於可探索模式時,鄰近對等互連裝置可看到的本機裝置類別。

  • 要求 device_class 要指派給系統的裝置類別。

要求

名稱類型
device_class fuchsia.bluetooth/DeviceClass

SetLocalName

為藍牙系統指派本機名稱。系統處於可探索模式時,以及在名稱探索程序中,附近的對等互連裝置會看到這個名稱。

  • 要求 name:要指派給系統的完整本機名稱。

要求

名稱類型
name fuchsia.bluetooth/DeviceName

SetPairingDelegate

指派 PairingDelegate 回應磁碟機配對程序。系統會設定委派,使用提供的 I/O 功能判斷配對方法。

一次只能註冊一個 PairingDelegate。關閉 PairingDelegate 會中止與委派項目相關的所有進行中配對程序,並關閉先前為這個 Access 執行個體指派的 PairingDelegate。

  • 要求 input 藍牙輸入能力
  • 要求 output 藍牙輸出能力
  • 要求 delegate PairingDelegate 管道的用戶端。

淘汰 - 這個方法會併入 fuchsia.bluetooth.sys/Pairing 通訊協定。末日光明

如要進一步瞭解遷移作業,請參閱 https://fxbug.dev/42180744。

已淘汰:HEAD 新增:7

要求

名稱類型
input InputCapability
output OutputCapability
delegate client_end:PairingDelegate

StartDiscovery

啟動一般探索程序。所有一般可探索的 BR/EDR、LE 和 BR/EDR/LE 裝置都會顯示在對等互連裝置清單中,您可以呼叫 fuchsia.bluetooth.sys/Access.WatchPeers 觀察這份清單。

  • 如果無法在任一傳輸方式上啟動探索作業,錯誤報告就會顯示 Error.FAILED。

要求

名稱類型
token server_end:ProcedureToken

回應

名稱類型
payload Access_StartDiscovery_Result

WatchPeers

傳回系統已知的所有對等互連裝置 (可連線的藍牙裝置) 清單。第一次呼叫會立即傳送所有已知對等互連的快照,並以 updated 傳回參數的形式傳送。後續呼叫只會在自上次呼叫以來,回報的項目新增、修改或移除一或多個項目時,才會收到回應。

  • 回應 updated 自上次呼叫 WatchPeers() 後新增或更新的對等互連。
  • 自上次呼叫 WatchPeers() 後移除的同層級回應 removed ID。

要求

<EMPTY>

回應

名稱類型
updated vector<Peer>
removed vector<fuchsia.bluetooth/PeerId>

AddressLookup

定義於 fuchsia.bluetooth.sys/address_lookup.fidl

用於尋找對等互連裝置藍牙位址的通訊協定。

新增:HEAD

查詢電話號碼

要求

名稱類型
payload AddressLookupLookupRequest

回應

名稱類型
payload AddressLookup_Lookup_Result

啟動

在 fuchsia.bluetooth.sys/bootstrap.fidl 中定義

用來初始化持續性核心藍牙資料的通訊協定。這項通訊協定會填入資料,決定其他藍牙裝置所看到的這部裝置身分。

只有在核心藍牙主機子系統產生自己的 ID 之前,才能取得這項通訊協定。一旦提交初始資料,這項能力就會停用,即使連接新的藍牙轉接器,也無法再次使用。

由於這項通訊協定涉及隱私權和配對密碼,且可讓裝置承擔其他裝置的藍牙身分,因此只能向可確保資料來源的特殊元件公開。

AddIdentities

將要新增至未填入資料的藍牙堆疊的身分新增至其中。

重複來電時,系統會附加身分。

要求

名稱類型
identities vector<Identity>

提交

將所有新增的啟動程序資料寫入藍牙核心堆疊。無論是否成功,伺服器都會關閉管道。如果成功,系統會傳回訊息,且即使未寫入任何啟動程序資料,堆疊也會視為已初始化。如果任何主機或繫結對等互連資料不足或不一致,則會傳回 INVALID_HOST_IDENTITY,且不會產生任何影響 (用戶端可能會取得其他通訊協定控制代碼,然後重試)。

要求

<EMPTY>

回應

名稱類型
payload Bootstrap_Commit_Result

設定

在 fuchsia.bluetooth.sys/configuration.fidl 中定義

用來設定核心藍牙系統的參數和功能的通訊協定。這些設定會套用至系統已知的所有 bt-host 驅動程式。

這項通訊協定只應向高權限元件公開 (例如測試/資格環境中的藍牙開發人員工具)。

更新

將 settings 中的欄位套用至系統所知的 bt-host 驅動程式。settings 中未列出的任何欄位都會維持不變。

  • 要求 settings 作用中 bt-host 驅動程式的新設定 - 只需要提供已修改的設定。
  • 回應 result 完整填入的表格,其中包含套用新設定後的結果設定。

要求

名稱類型
settings Settings

回應

名稱類型
result Settings

HostWatcher

定義於 fuchsia.bluetooth.sys/host_watcher.fidl

用於觀察及管理系統上的藍牙控制器的通訊協定。

SetActive

將指定 id 的主機設為有效。所有藍牙程序都會透過這個主機傳送。系統會停用先前指派的有效主機,並終止所有待處理程序。

  • error 如果找不到具有 id 的主機,這項作業可能會失敗。

要求

名稱類型
id fuchsia.bluetooth/HostId

回應

名稱類型
payload HostWatcher_SetActive_Result

智慧手錶

取得所有可用藍牙控制器及其狀態的清單。只有在自上次用戶端傳送這則訊息後,這份清單有所變更時,系統才會傳送回應。

要求

<EMPTY>

回應

名稱類型
hosts vector<HostInfo>

配對中

在 fuchsia.bluetooth.sys/pairing.fidl 中定義

允許系統用戶端啟用藍牙配對。

新增:HEAD

SetDelegate

指派 PairingDelegate2 來處理配對程序。系統會根據提供的 I/O 功能判斷使用的方法。

一次只能在全系統中設定 PairingDelegate 或 PairingDelegate2。如果呼叫這個函式時已設定其他委派項目,系統會立即關閉新的委派項目。

關閉 PairingDelegate2 會取消設定配對委派。進行中的配對要求仍可完成,但新要求會視為未設定任何委派項目。

如果未設定任何委派項目,即使對等連線是由本機裝置啟動,所有配對都會遭到拒絕。

  • 要求 input 藍牙輸入能力,請參閱 InputCapability
  • 要求 output 藍牙輸出能力,請參閱 OutputCapability
  • 要求 delegate PairingDelegate2,該要求會接收配對要求

要求

名稱類型
input InputCapability
output OutputCapability
delegate client_end:PairingDelegate2

SetPairingDelegate

指派 PairingDelegate 回應配對程序。系統會根據提供的 I/O 功能決定配對方法。

系統一次只能設定一個 PairingDelegate,如果呼叫這個函式時已設定其他委派項目,新的委派項目會立即關閉。設定 PairingDelegate 後,如果關閉該委派項目,系統會中止所有進行中的配對程序,且不會接受配對,並取消設定委派項目。

如果未設定 PairingDelegate,即使對等互連是由本機裝置啟動,所有配對都會遭到拒絕。

  • 要求 input 藍牙輸入能力,請參閱 InputCapability
  • 要求 output 藍牙輸出能力,請參閱 OutputCapability
  • 要求 delegate PairingDelegate,該要求會接收配對要求

要求

名稱類型
input InputCapability
output OutputCapability
delegate client_end:PairingDelegate

PairingDelegate

定義於 fuchsia.bluetooth.sys/pairing.fidl

藍牙配對委派項目負責確認或拒絕來自藍牙同層級的配對要求,這些同層級會連線至本機裝置或正在連線至本機裝置。

任何新的配對都會導致呼叫 PairingDelegate.OnPairingRequest,包括將 InputCapability 和 OutputCapability 設為 none 的配對。委派方應有足夠的背景資訊,可判斷是否接受或拒絕配對。

每個系統一次只能設定一位委派人。請參閱fuchsia.bluetooth.sys.Pairing,瞭解如何設定配對委派。

OnLocalKeypress

配對期間,委派項目可以使用 PairingMethod.PASSKEY_ENTRY 傳送這個事件,通知對等互連裝置本機按鍵事件。

傳送本機按鍵事件可讓使用者在輸入密碼金鑰時,有更多時間配對。

只有在收到採用 PASSKEY_ENTRY 方法的 OnPairingRequest,且在該配對要求的回應之前,才應傳送這項要求。

  • 配對要求處於啟用狀態的對等互連要求 id ID
  • 要求 keypress 應傳送的通知類型

回應

名稱類型
id fuchsia.bluetooth/PeerId
keypress PairingKeypress

OnPairingComplete

配對程序完成後,系統會呼叫此方法。這可能是因為作業成功完成或發生錯誤 (例如對等互連取消、逾時或中斷連線)。

  • 要求 id 正在配對的對等互連裝置藍牙 ID。
  • 要求 success 配對成功時為 true,否則為 false。

要求

名稱類型
id fuchsia.bluetooth/PeerId
success bool

OnPairingRequest

呼叫以確認配對。如果 accept 回應為 true,配對程序就會繼續,否則會遭到拒絕。如果配對方法需要密碼,也必須一併提供。 不需要密碼金鑰的配對方法會忽略 entered_passkey 回應。

配對可能會在收到回應前失敗 (通常是因為逾時或對等互連中斷)。發生這種情況時,系統會呼叫 OnPairingComplete 方法。系統會忽略任何回覆。

  • 要求 peer 配對對象的相關資訊
  • 要求 method 方法的配對作業。詳情請參閱 PairingMethod
  • 如果使用 PASSKEY_DISPLAY 或 PASSKEY_COMPARISON,請要求 displayed_passkey 向使用者顯示密碼金鑰。否則沒有意義。
  • 如果接受配對,則回應為 accept true
  • response entered_passkey 使用者輸入的密碼金鑰。除非方法為 PASSKEY_ENTRY,否則會遭到忽略。

要求

名稱類型
peer Peer
method PairingMethod
displayed_passkey uint32

回應

名稱類型
accept bool
entered_passkey uint32

OnRemoteKeypress

配對期間,系統會呼叫此方法,透過 PairingMethod.PASSKEY_DISPLAY 通知對接裝置的按鍵事件。

當使用者在對等裝置上輸入密碼金鑰時,這個事件會將按鍵事件提供給委派,以提供回應式使用者體驗。每次按下按鍵時,系統都會呼叫這個事件一次。

只有在系統傳送 OnPairingRequest 給 id,以及傳送 OnPairingComplete 之間,才會呼叫這個事件。

注意:許多裝置不會傳送這些事件

  • 要求 id 傳送按鍵事件的對等互連 ID。
  • 要求 keypress 收到的事件類型。

要求

名稱類型
id fuchsia.bluetooth/PeerId
keypress PairingKeypress

PairingDelegate2

在 fuchsia.bluetooth.sys/pairing.fidl 中定義

藍牙配對委派項目負責確認或拒絕來自藍牙同層級的配對要求,這些同層級會連線至本機裝置或正在連線至本機裝置。

任何新的配對都會導致呼叫 PairingDelegate.StartRequest,包括將 InputCapability 和 OutputCapability 設為 none 的配對。委派者應具備足夠的背景資訊,可判斷是否接受或拒絕配對。

每個系統一次只能設定一位委派人。請參閱fuchsia.bluetooth.sys.Pairing,瞭解如何設定配對委派。

新增:HEAD

RequestComplete

配對程序完成後,系統會呼叫這個函式。這可能是因為作業已順利完成,或是發生錯誤 (例如對等互連取消、逾時或中斷連線)。

  • 要求 id 正在配對的對等互連裝置藍牙 ID
  • 要求 success 配對成功時為 true,否則為 false

要求

名稱類型
id fuchsia.bluetooth/PeerId
success bool

StartRequest

開始與 peer 配對時呼叫。配對程序會使用 PairingRequest 通訊協定繼續進行。

配對的屬性會提供在 info 中,指出預期在本機進行的互動類型。

不同對等互連裝置可同時有多個作用中要求,且要求可超出此通訊協定的存留時間。如果捨棄要求通訊協定,系統會自動拒絕配對。

所有欄位一律會顯示。

要求

名稱類型
payload PairingDelegate2StartRequestRequest

PairingRequest

在 fuchsia.bluetooth.sys/pairing.fidl 中定義

配對進行中時,這個通訊協定會處於啟用狀態,並透過 PairingDelegate.StartRequest 提供給 PairingDelegate。如果配對程序提早完成但未成功,伺服器會使用墓誌銘關閉這個通訊協定:

  • ZX_ERR_UNAVAILABLE - 藍牙同層裝置已中斷連線
  • ZX_ERR_NOT_SUPPORTED - 系統不應提供密碼金鑰,但您提供了
  • ZX_ERR_BAD_STATE - 傳送按鍵時未使用 PairingProperties.passkey_entry
  • ZX_ERR_TIMED_OUT - 未偵測到任何活動,配對已停止
新增:HEAD

接受

接受配對要求。如果使用 PairingProperties.passkey_entry 方法,則必須輸入 entered_passkey,否則系統會忽略。

要求

名稱類型
payload PairingRequestAcceptRequest

Keypress

用於傳達本機按鍵事件,以更新遠端對等互連裝置的配對進度。這個方法的回覆應做為流量控制之用。

要求

名稱類型
keypress PairingKeypress

回應

<EMPTY>

OnComplete

配對完成時傳送一次,就在通訊協定關閉之前。系統也會使用 PairingDelegate.RequestComplete 呼叫,將成功值和 PeerId 一併傳送至委派。

回應

名稱類型
success bool

OnKeypress

配對方法為 passkey_display 時傳送。可用於更新 UI,指出已收到按鍵。

回應

名稱類型
keypress PairingKeypress

拒絕

拒絕配對要求。 關閉這個通訊協定也會拒絕配對要求。

要求

<EMPTY>

ProcedureToken

在 fuchsia.bluetooth.sys/access.fidl 中定義

代表有效程序。支援這項通訊協定的控制代碼效期,與所附加程序的活動相關。具體來說:

  1. 關閉權杖控制代碼會終止所連結的程序。
  2. 系統會關閉權杖控制代碼,表示程序已在內部終止。

STRUCTS

Access_Connect_Response

定義於 fuchsia.bluetooth.sys/access.fidl

<EMPTY>

Access_Disconnect_Response

定義於 fuchsia.bluetooth.sys/access.fidl

<EMPTY>

Access_Forget_Response

定義於 fuchsia.bluetooth.sys/access.fidl

<EMPTY>

Access_MakeDiscoverable_Response

定義於 fuchsia.bluetooth.sys/access.fidl

<EMPTY>

Access_Pair_Response

定義於 fuchsia.bluetooth.sys/access.fidl

<EMPTY>

Access_SetConnectionPolicy_Response

定義於 fuchsia.bluetooth.sys/access.fidl

<EMPTY>

Access_StartDiscovery_Response

定義於 fuchsia.bluetooth.sys/access.fidl

<EMPTY>

AddressLookup_Lookup_Response

定義於 fuchsia.bluetooth.sys/address_lookup.fidl

欄位類型說明預設
bd_addr fuchsia.bluetooth/Address 無預設值

Bootstrap_Commit_Response

定義於 fuchsia.bluetooth.sys/bootstrap.fidl

<EMPTY>

定義於 fuchsia.bluetooth.sys/pairing.fidl

<EMPTY>

HostWatcher_SetActive_Response

定義於 fuchsia.bluetooth.sys/host_watcher.fidl

<EMPTY>

鍵

在 fuchsia.bluetooth.sys/identity.fidl 中定義

代表 128 位元的密鑰。

欄位類型說明預設
value array<uint8, 16> 無預設值

LeConnectionParameters

在 fuchsia.bluetooth.sys/identity.fidl 中定義

對等互連裝置偏好的 LE 連線參數。

欄位類型說明預設
connection_interval uint16 無預設值
connection_latency uint16 無預設值
supervision_timeout uint16 無預設值

Ltk

在 fuchsia.bluetooth.sys/identity.fidl 中定義

代表用於連結加密的 LE 長期對等互連金鑰。如果使用 LE 安全連線配對進行分配,ediv 和 rand 欄位會是零。

欄位類型說明預設
key PeerKey 無預設值
ediv uint16 無預設值
rand uint64 無預設值

PasskeyEntry

定義於 fuchsia.bluetooth.sys/pairing.fidl

<EMPTY>

PeerKey

在 fuchsia.bluetooth.sys/identity.fidl 中定義

代表從對等互連閘道收到的金鑰。

欄位類型說明預設
security SecurityProperties

這個連結的安全屬性,金鑰是在這個連結下收到。

無預設值
data Key

金鑰的內容。

無預設值

SecurityProperties

定義於 fuchsia.bluetooth.sys/identity.fidl

欄位類型說明預設
authenticated bool 無預設值
secure_connections bool 無預設值
encryption_key_size uint8 無預設值

ENUMS

BondableMode strict

類型:uint32

定義於 fuchsia.bluetooth.sys/pairing_options.fidl

裝置是否應在配對程序中建立藍牙連線。 如核心規格 v5.2 | 第 3 卷第 C 部分第 4.3 節所述

名稱值說明
1

裝置會在與對等互連裝置配對時建立連結

2

與對等裝置配對時,裝置不會建立連結

BootstrapError strict

類型:uint32

定義於 fuchsia.bluetooth.sys/bootstrap.fidl

名稱值說明
1
2

BrEdrSecurityMode strict

類型:uint32

在 fuchsia.bluetooth.sys/security_mode.fidl 中定義

藍牙裝置的 BR/EDR 安全模式決定了裝置可能的安全屬性。安全性模式不會對裝置連線目前的安全性屬性做出具體保證,而是會限制允許的安全性屬性。詳情請參閱核心規格 5.4 版第 3 卷第 C 部分 5.2.2。

新增:14

名稱值說明
1

在 BR/EDR 安全模式 4 中,系統會使用配對裝置之間最低公分母演算法,驗證及加密通訊內容。請注意,如果系統不支援安全連線,這表示使用的金鑰產生、驗證和加密演算法可能比安全連線弱。

2

在「僅限安全連線」模式下,裝置會拒絕不支援安全連線的連線,並強制使用較長的密鑰長度。

SC Only 模式也會嘗試強制使用者確認預期的對等互連裝置。沒有螢幕的裝置 (例如耳機) 通常不支援 SC,原因就在於此。

錯誤 strict

類型:uint32

定義於 fuchsia.bluetooth.sys/access.fidl

名稱值說明
1

無法執行這項操作。

2

找不到指定給這項作業的對等互連。

3

作業時間限制已過期。

4

作業已取消。

5

作業已在進行中。

6

不支援這項作業。

7

作業獲得的引數集無效。

InputCapability strict

類型:uint32

在 fuchsia.bluetooth.sys/pairing.fidl 中定義

輸入配對交易所的功能。 這些值應根據本機系統輸入配對要求回應的能力設定。詳情請參閱第 3 卷第 C 部分的表 5.3。

名稱值說明
1

沒有可用的使用者輸入方法,無法對配對要求回覆「是」或「否」。注意:設定這項設定後,大多數配對都會被視為未經驗證,容易遭受中間人攻擊。

2

使用者可以回覆「是」或「否」來回應要求。

3

使用者可透過鍵盤 (或其他 UI) 輸入數字代碼,並表示已完成或取消。

LeSecurityMode strict

類型:uint32

在 fuchsia.bluetooth.sys/security_mode.fidl 中定義

BLE 裝置的 LE 安全模式會決定裝置可能具備的安全屬性。 安全模式不會對裝置連線目前的安全性屬性做出具體保證,而是會限制允許的安全性屬性。詳情請參閱核心規格 5.2 版第 3 卷第 C 部分 10.2 節。

名稱值說明
1

在 LE 安全模式 1 中,通訊會透過加密機制保護,而以 BLE 為基礎的服務可能會針對加密金鑰的驗證、金鑰大小或安全連線保護措施,指定不同的需求。

2

在「僅限安全連線」模式下,所有安全通訊都必須使用 128 位元、經過驗證,以及 LE 安全連線產生的加密金鑰。如果裝置因系統限制而無法滿足這些加密金鑰屬性,凡是涉及這類裝置的連線,都無法確保連結安全。這個模式不會禁止未加密的通訊,只會對所有加密通訊強制執行更嚴格的政策。

LookupError flexible

類型:uint32

定義於 fuchsia.bluetooth.sys/address_lookup.fidl

新增:HEAD

名稱值說明
0
1

OutputCapability strict

類型:uint32

在 fuchsia.bluetooth.sys/pairing.fidl 中定義

配對交換的輸出功能。 這些值應根據本機系統向發起或接受藍牙配對的使用者顯示資訊的能力設定。詳情請參閱第 3 卷第 C 部分的表 5.4。

名稱值說明
1

沒有可配對的螢幕。

2

顯示器可顯示至少六位數的小數。

PairingKeypress strict

類型:uint32

在 fuchsia.bluetooth.sys/pairing.fidl 中定義

用於向對等互連裝置傳達密碼金鑰輸入進度。您可以利用各種按鍵類型,自訂傳送給配對要求者的訊息。

名稱值說明
1

使用者輸入了單一數字。

2

使用者已清除單一數字。

3

使用者已清除所有密碼金鑰。

4

使用者已輸入密碼金鑰。

PairingMethod strict

類型:uint32

在 fuchsia.bluetooth.sys/pairing.fidl 中定義

Security Manager 配對方法所需的不同型別。 藍牙 SIG 對不同裝置功能有不同的要求。

名稱值說明
1

系統會要求使用者接受或拒絕配對。 這是最基本的方法,即使兩部裝置都不支援輸入或輸出,系統也會要求委派者確認任何未由使用者意圖啟動的配對。

2

這部裝置會向使用者顯示 6 位數的數字密碼金鑰,使用者必須在對等裝置上輸入該密碼金鑰。

3

這部裝置會向使用者顯示 6 位數的數字密碼金鑰,該密碼金鑰也會顯示在對等裝置上。使用者必須比較密碼金鑰,如果相符,請接受配對。

PASSKEY_ENTRY

4

系統會要求使用者在這部裝置上輸入 6 位數的密碼金鑰,該密碼金鑰是透過對等裝置傳送。

PairingSecurityLevel strict

類型:uint32

定義於 fuchsia.bluetooth.sys/pairing_options.fidl

配對所需的安全性等級 - 對應於第 3 卷第 H 部分第 2.3.1 節中「安全管理員通訊協定」定義的安全性等級

名稱值說明
1

加密但未受 MITM 保護 (未經驗證)

2

以 MITM 防護 (已驗證) 加密,但這個安全等級無法完全防範被動竊聽者

TechnologyType strict

類型:uint32

定義於 fuchsia.bluetooth.sys/peer.fidl

名稱值說明
1
2
3

TABLES

AccessSetConnectionPolicyRequest resource

定義於 fuchsia.bluetooth.sys/access.fidl

序數欄位類型說明
suppress_bredr_connections server_end:ProcedureToken

透過 BR/EDR 傳輸層抑制所有新連線。當 ProcedureToken 保持開啟時,有效主機將停用頁面掃描。 注意:系統會維持無法連線的狀態,直到所有 fuchsia.bluetooth.sys/Access 用戶端捨棄權杖為止。

AddressLookupLookupRequest

定義於 fuchsia.bluetooth.sys/address_lookup.fidl

序數欄位類型說明
peer_id fuchsia.bluetooth/PeerId

BondingData

在 fuchsia.bluetooth.sys/identity.fidl 中定義

代表單一對等互連的繫結資料。

序數欄位類型說明
identifier fuchsia.bluetooth/PeerId

可明確識別這個對等互連的 ID。

local_address fuchsia.bluetooth/Address

與這個繫結相關聯的本機藍牙身分位址。

name fuchsia.bluetooth/DeviceName

同儕的姓名 (如已知)。

address fuchsia.bluetooth/Address

對等互連的身分位址。

le_bond LeBondData

當這個對等互連裝置在 LE 傳輸上配對時,會出現繫結資料。

bredr_bond BredrBondData

在 BR/EDR 傳輸上配對此對等互連裝置時,存在的繫結資料。

device_class fuchsia.bluetooth/DeviceClass

對等互連裝置的裝置類別 (如已知)。

新增:30

BredrBondData

定義於 fuchsia.bluetooth.sys/identity.fidl

序數欄位類型說明
role_preference fuchsia.bluetooth/ConnectionRole

對等互連裝置偏好的微網角色。這取決於角色切換程序。從對等互連裝置呼叫及連線時,系統不會自動設定這個旗標。如果沒有這項屬性,表示同儕尚未表達偏好設定。

services vector<fuchsia.bluetooth/Uuid>:65535

從 EIR 資料或 SDP 取得的已知服務 UUID。

HostData

在 fuchsia.bluetooth.sys/identity.fidl 中定義

代表永久性本機主機資料。

序數欄位類型說明
irk LocalKey

bt-host 裝置在本機使用的身分解析金鑰,可在啟用隱私權時產生可解析的私人位址。

如果主機未使用 LE 隱私權,或僅使用無法解析的私人位址,則可能不會顯示這項資訊。

注意:這個金鑰會在配對程序期間分配給 LE 對等互連裝置。用戶端必須注意指派的 IRK 是否與本機 bt-host ID 一致。

HostInfo

定義於 fuchsia.bluetooth.sys/host_watcher.fidl

藍牙控制器及其相關聯主機子系統狀態的資訊。

序數欄位類型說明
id fuchsia.bluetooth/HostId

可明確識別目前系統上的主機。

這個欄位一律會顯示。

technology TechnologyType

這個轉接器支援的藍牙技術。

這個欄位一律會顯示。

active bool

指出這是否為有效主機。系統有一個作用中的主機,負責處理所有藍牙程序。

local_name fuchsia.bluetooth/DeviceName

這個主機的本機名稱。這個名稱會向處於可探索模式的主機顯示。

discoverable bool

本機介面卡目前是否可透過 BR/EDR 和 LE 實體通道偵測到。

discovering bool

目前是否正在執行裝置探索作業。

addresses vector<fuchsia.bluetooth/Address>

與主機相關聯的位址 (LE 和/或 BR/EDR)。

系統一律會先回報公開地址。

這個欄位一律會顯示。

新增:11

身分識別

在 fuchsia.bluetooth.sys/identity.fidl 中定義

代表單一主機子系統執行個體的持續性設定。這項資訊用於身分識別 (查詢、查詢回應和廣告),以及繫結密鑰回呼 (加密與這個身分相關聯的對等互連連結資料)。

用於繫結的每個 BR/EDR BD_ADDR 和低功耗公開身分位址,都應有自己的 Identity 執行個體,其中包含對應的對等互連。

每個支援 LE 隱私權的 Identity 執行個體都應具有與其繫結對等互連裝置所分配的 IRK 一致的 IRK。

序數欄位類型說明
host HostData
bonds vector<BondingData>

使用公開身分位址的所有債券都必須包含相同的本機位址。

LeBondData

定義於 fuchsia.bluetooth.sys/identity.fidl

序數欄位類型說明
connection_parameters LeConnectionParameters

對等互連裝置偏好的連線參數 (如有)。

services vector<fuchsia.bluetooth/Uuid>:65535

已知的 GATT 服務 UUID。

irk PeerKey

用於產生及解析隨機地址的 Identity Resolving RemoteKey。

csrk PeerKey

連線簽章會解析用於資料簽署的 RemoteKey,但不會加密。

peer_ltk Ltk

當對等互連裝置處於 LE 周邊裝置角色時,用於加密連線的 LE 長期金鑰。

在舊版配對 (peer_ltk.security.secure_connections 為 false) 中,這個金鑰對應於對等互連裝置發布的金鑰。在安全連線配對中,只有一個 LTK,且 peer_ltk 與 local_ltk 相同。

local_ltk Ltk

LE 長期金鑰,用於在對等互連裝置處於 LE Central 角色時加密連線。

在舊版配對 (local_ltk.security.secure_connections 為 false) 中,這個金鑰對應於本機裝置發布的金鑰。在安全連線配對中,只有一個 LTK,且 local_ltk 與 peer_ltk 相同。

PairingDelegate2StartRequestRequest resource

定義於 fuchsia.bluetooth.sys/pairing.fidl

序數欄位類型說明
peer Peer

提出要求的對等互連。

info PairingProperties

配對的屬性。

request client_end:PairingRequest

用於完成配對程序的通訊協定。

PairingOptions

定義於 fuchsia.bluetooth.sys/pairing_options.fidl

可讓呼叫端更精細地控管配對程序的參數。這個表格的所有欄位都是選填,即使未設定任何欄位,配對仍可成功。

序數欄位類型說明
le_security_level PairingSecurityLevel

僅適用於執法單位。如有這項屬性,則會決定要配對的 Security Manager 安全層級。如未提供,系統會解讀為 PairingSecurityLevel.AUTHENTICATED。

bondable_mode BondableMode

如果傳輸方式為 LOW_ENERGY 或 DUAL_MODE,裝置在配對期間是否應建立繫結。如果沒有,則解讀為可繫結模式。

如果傳輸方式為 CLASSIC,則不得使用這個選項,否則值必須為 BONDABLE。 CLASSIC 傳輸模式目前不支援 NON_BONDABLE 模式

transport TechnologyType

如果傳輸方式為 LOW_ENERGY,請指出您希望透過 LE 傳輸方式配對。如果傳輸方式為 CLASSIC,請指出您希望透過 Br/Edr 傳輸方式配對。 如果傳輸方式為 DUAL_MODE,表示您希望透過兩種傳輸方式配對。如果不存在,則解讀為 TechnologyType.DUAL_MODE

PairingRequestAcceptRequest

定義於 fuchsia.bluetooth.sys/pairing.fidl

序數欄位類型說明
entered_passkey uint32

對等節點

定義於 fuchsia.bluetooth.sys/peer.fidl

代表遠端 BR/EDR、LE 或雙模式 BR/EDR/LE 對等互連裝置。

序數欄位類型說明
id fuchsia.bluetooth/PeerId

在目前系統中,這個對等互連的專屬 ID。

這個欄位一律會顯示。

address fuchsia.bluetooth/Address

用來識別這個對等互連裝置的藍牙裝置位址。如果 name 無法使用,用戶端應向使用者顯示這個欄位。

這個欄位一律會顯示。

注意:用戶端應使用 identifier 欄位追蹤對等互連,而非對等互連的位址。

technology TechnologyType

這個對等互連裝置支援的藍牙技術。

這個欄位一律會顯示。

connected bool

與這個對等互連裝置之間是否存在 BR/EDR 和/或 LE 連線。

這個欄位一律會顯示。

bonded bool

這個對等互連是否已繫結。

這個欄位一律會顯示。

name fuchsia.bluetooth/DeviceName

同儕的姓名 (如已知)。

appearance fuchsia.bluetooth/Appearance

LE 外觀屬性。如果對等互連裝置支援 LE,且外觀資訊是透過廣告和/或 GATT 取得,則會顯示這項資訊。

device_class fuchsia.bluetooth/DeviceClass

這部裝置的裝置類別 (如已知)。

rssi int8

這個對等互連裝置最近一次取得的廣告信號強度。如有,請提供。

tx_power int8

這個對等互連裝置最近一次取得的傳輸功率。如有,請提供。

services vector<fuchsia.bluetooth/Uuid>:65535

這個對等互連裝置上可用的服務 UUID 清單。

這是舊版欄位,不應做為新程式碼的依據。

已淘汰

le_services vector<fuchsia.bluetooth/Uuid>:65535

已知可透過 LE 傳輸方式使用的服務 UUID 清單。

如果技術為 CLASSIC,則一律不會出現。

bredr_services vector<fuchsia.bluetooth/Uuid>:65535

先前在 BR/EDR 傳輸上探索到的服務 UUID 快取清單。 如果後續搜尋找不到服務,即使對等互連裝置中斷連線,服務也不會移除。

如果技術為 LOW_ENERGY,則一律不會顯示。

這是舊版欄位,不應做為新程式碼的依據。

已淘汰

設定

在 fuchsia.bluetooth.sys/configuration.fidl 中定義

代表可供設定的藍牙主機子系統參數。藍牙系統初始化時,每個參數都會設為預設值。各項參數的預設值位於 //src/connectivity/bluetooth/core/bt-gap/config/default.js。

序數欄位類型說明
le_privacy bool

如果設為 True,則啟用 LE Privacy 功能;如果設為 False,則停用這項功能。如果沒有,則目前的值會維持不變。啟用後,所有會廣播本機裝置位址的 BLE 程序 (主動掃描、連線啟動和廣告) 都會使用可解析的私人位址類型。停用時,這些程序會顯示指派給控制器的本機公開身分位址。

強烈建議在產品上啟用這項功能。

le_background_scan bool

如果為 true,則啟用低功耗背景掃描功能;如果為 false,則停用這項功能。如果沒有,則目前值維持不變。啟用後,系統會持續進行被動掃描,並與處於「可連線」或「導向可連線」模式的配對裝置建立連線。

bredr_connectable_mode bool

如果為 true,則啟用 BR/EDR 可連線模式;如果為 false,則停用。如果沒有,則目前值維持不變。啟用後,bt-host 裝置會進入 BR/EDR 頁面掃描模式,並接受連線。

le_security_mode LeSecurityMode

如有此值,則設定主機子系統的 LE 安全模式;如無此值,則維持目前的值不變。詳情請參閱 BT Core Spec v5.2 Vol. 3 Part C 10.2。如果存在且設為「僅傳送安全性連線的 Cookie」模式,系統會中斷任何不符合「僅傳送安全性連線的 Cookie」模式要求的有效連線。

bredr_security_mode BrEdrSecurityMode

如果存在,則設定主機子系統的 BR/EDR 安全模式,如果不存在,則維持目前的值不變。詳情請參閱 BT Core Spec v5.2 Vol. 3 Part C 5.2.2。如果存在且設為「僅傳送安全性連線的 Cookie」模式,系統會中斷任何不符合「僅傳送安全性連線的 Cookie」模式要求的有效連線。

新增:14

工會

Access_Connect_Result strict

在 fuchsia.bluetooth.sys/access.fidl 中定義

序數Variant類型說明
response Access_Connect_Response
err Error

Access_Disconnect_Result strict

在 fuchsia.bluetooth.sys/access.fidl 中定義

序數Variant類型說明
response Access_Disconnect_Response
err Error

Access_Forget_Result strict

在 fuchsia.bluetooth.sys/access.fidl 中定義

序數Variant類型說明
response Access_Forget_Response
err Error

Access_MakeDiscoverable_Result strict

在 fuchsia.bluetooth.sys/access.fidl 中定義

序數Variant類型說明
response Access_MakeDiscoverable_Response
err Error

Access_Pair_Result strict

在 fuchsia.bluetooth.sys/access.fidl 中定義

序數Variant類型說明
response Access_Pair_Response
err Error

Access_SetConnectionPolicy_Result strict

在 fuchsia.bluetooth.sys/access.fidl 中定義

序數Variant類型說明
response Access_SetConnectionPolicy_Response
err Error

Access_StartDiscovery_Result strict

在 fuchsia.bluetooth.sys/access.fidl 中定義

序數Variant類型說明
response Access_StartDiscovery_Response
err Error

AddressLookup_Lookup_Result strict

定義於 fuchsia.bluetooth.sys/address_lookup.fidl

序數Variant類型說明
response AddressLookup_Lookup_Response
err LookupError
framework_err internal

Bootstrap_Commit_Result strict

在 fuchsia.bluetooth.sys/bootstrap.fidl 中定義

序數Variant類型說明
response Bootstrap_Commit_Response
err BootstrapError

HostWatcher_SetActive_Result strict

定義於 fuchsia.bluetooth.sys/host_watcher.fidl

序數Variant類型說明
response HostWatcher_SetActive_Response
err zx/Status

PairingProperties flexible

定義於 fuchsia.bluetooth.sys/pairing.fidl

新增:HEAD
序數Variant類型說明
consent Consent

系統會要求使用者接受或拒絕配對。 這是最基本的方法,即使兩部裝置都不支援輸入或輸出,系統也會要求委派者確認任何未由使用者意圖啟動的配對。

passkey_display uint32

這部裝置會向使用者顯示 6 位數的數字密碼金鑰,使用者必須在對等裝置上輸入該密碼金鑰。系統會提供要顯示的密碼金鑰。

passkey_confirmation uint32

這部裝置會向使用者顯示 6 位數的數字密碼金鑰,對等互連裝置也會顯示這組密碼金鑰。使用者必須比較密碼金鑰,如果相符,請接受配對。 系統會提供要顯示的密碼金鑰。

4

passkey_entry PasskeyEntry

系統會要求使用者在這部裝置上輸入 6 位數的密碼金鑰,該密碼金鑰是透過對等裝置傳送。

常數

名稱值類型說明
MAX_PEER_SERVICES 65535 uint16

每個傳輸方式可探索的服務數量上限。目前設為用來存取服務的有效 16 位元控制代碼或 PSM 數量。

ALIASES

名稱值說明
LocalKey fuchsia.bluetooth.sys/Key

代表在本機產生的金鑰,會分配到一或多個債券。