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 傳輸的「一般可探索」模式。主機處於活動狀態時,會定期進入查詢掃描模式,以回應一般查詢。
- 要求
tokenfuchsia.bluetooth.sys/ProcedureToken,在可探索模式工作階段有效期間保持有效。注意:在所有 fuchsia.bluetooth.sys/Access 用戶端捨棄權杖前,系統可能仍可供探索。
- 如果無法進入查詢模式,則 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 連線政策。
- 如果無法套用所要求的連線政策,則會回報錯誤。
要求
| 名稱 | 類型 |
|---|---|
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藍牙輸出能力 - 要求
delegatePairingDelegate 管道的用戶端。
淘汰 - 這個方法會併入 fuchsia.bluetooth.sys/Pairing 通訊協定。末日光明
如要進一步瞭解遷移作業,請參閱 https://fxbug.dev/42180744。
要求
| 名稱 | 類型 |
|---|---|
input |
InputCapability
|
output |
OutputCapability
|
delegate |
client_end:PairingDelegate
|
StartDiscovery
啟動一般探索程序。所有一般可探索的 BR/EDR、LE 和 BR/EDR/LE 裝置都會顯示在對等互連裝置清單中,您可以呼叫 fuchsia.bluetooth.sys/Access.WatchPeers 觀察這份清單。
- 要求
tokenfuchsia.bluetooth.sys/ProcedureToken,在探索期間保持有效。注意:無線電會持續執行探索作業,直到所有 fuchsia.bluetooth.sys/Access 都捨棄權杖為止。
- 如果無法在任一傳輸方式上啟動探索作業,錯誤報告就會顯示 Error.FAILED。
要求
| 名稱 | 類型 |
|---|---|
token |
server_end:ProcedureToken
|
回應
| 名稱 | 類型 |
|---|---|
payload |
Access_StartDiscovery_Result
|
WatchPeers
傳回系統已知的所有對等互連裝置 (可連線的藍牙裝置) 清單。第一次呼叫會立即傳送所有已知對等互連的快照,並以 updated 傳回參數的形式傳送。後續呼叫只會在自上次呼叫以來,回報的項目新增、修改或移除一或多個項目時,才會收到回應。
- 回應
updated自上次呼叫 WatchPeers() 後新增或更新的對等互連。 - 自上次呼叫 WatchPeers() 後移除的同層級回應
removedID。
要求
<EMPTY>
回應
| 名稱 | 類型 |
|---|---|
updated |
vector<Peer>
|
removed |
vector<fuchsia.bluetooth/PeerId>
|
AddressLookup
定義於 fuchsia.bluetooth.sys/address_lookup.fidl
用於尋找對等互連裝置藍牙位址的通訊協定。
查詢電話號碼
要求
| 名稱 | 類型 |
|---|---|
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 中定義
允許系統用戶端啟用藍牙配對。
SetDelegate
指派 PairingDelegate2 來處理配對程序。系統會根據提供的 I/O 功能判斷使用的方法。
一次只能在全系統中設定 PairingDelegate 或 PairingDelegate2。如果呼叫這個函式時已設定其他委派項目,系統會立即關閉新的委派項目。
關閉 PairingDelegate2 會取消設定配對委派。進行中的配對要求仍可完成,但新要求會視為未設定任何委派項目。
如果未設定任何委派項目,即使對等連線是由本機裝置啟動,所有配對都會遭到拒絕。
- 要求
input藍牙輸入能力,請參閱InputCapability - 要求
output藍牙輸出能力,請參閱OutputCapability - 要求
delegatePairingDelegate2,該要求會接收配對要求
要求
| 名稱 | 類型 |
|---|---|
input |
InputCapability
|
output |
OutputCapability
|
delegate |
client_end:PairingDelegate2
|
SetPairingDelegate
指派 PairingDelegate 回應配對程序。系統會根據提供的 I/O 功能決定配對方法。
系統一次只能設定一個 PairingDelegate,如果呼叫這個函式時已設定其他委派項目,新的委派項目會立即關閉。設定 PairingDelegate 後,如果關閉該委派項目,系統會中止所有進行中的配對程序,且不會接受配對,並取消設定委派項目。
如果未設定 PairingDelegate,即使對等互連是由本機裝置啟動,所有配對都會遭到拒絕。
- 要求
input藍牙輸入能力,請參閱InputCapability - 要求
output藍牙輸出能力,請參閱OutputCapability - 要求
delegatePairingDelegate,該要求會接收配對要求
要求
| 名稱 | 類型 |
|---|---|
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,且在該配對要求的回應之前,才應傳送這項要求。
- 配對要求處於啟用狀態的對等互連要求
idID - 要求
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向使用者顯示密碼金鑰。否則沒有意義。
- 如果接受配對,則回應為
accepttrue - 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,瞭解如何設定配對委派。
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 - 未偵測到任何活動,配對已停止
接受
接受配對要求。如果使用 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 中定義
代表有效程序。支援這項通訊協定的控制代碼效期,與所附加程序的活動相關。具體來說:
- 關閉權杖控制代碼會終止所連結的程序。
- 系統會關閉權杖控制代碼,表示程序已在內部終止。
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 |
裝置會在與對等互連裝置配對時建立連結 |
NON_BONDABLE |
2 |
與對等裝置配對時,裝置不會建立連結 |
BootstrapError strict
類型:uint32
定義於 fuchsia.bluetooth.sys/bootstrap.fidl
| 名稱 | 值 | 說明 |
|---|---|---|
INVALID_HOST_IDENTITY |
1 |
|
WRITE_FAILURE |
2 |
BrEdrSecurityMode strict
類型:uint32
在 fuchsia.bluetooth.sys/security_mode.fidl 中定義
藍牙裝置的 BR/EDR 安全模式決定了裝置可能的安全屬性。安全性模式不會對裝置連線目前的安全性屬性做出具體保證,而是會限制允許的安全性屬性。詳情請參閱核心規格 5.4 版第 3 卷第 C 部分 5.2.2。
| 名稱 | 值 | 說明 |
|---|---|---|
MODE_4 |
1 |
在 BR/EDR 安全模式 4 中,系統會使用配對裝置之間最低公分母演算法,驗證及加密通訊內容。請注意,如果系統不支援安全連線,這表示使用的金鑰產生、驗證和加密演算法可能比安全連線弱。 |
SECURE_CONNECTIONS_ONLY |
2 |
在「僅限安全連線」模式下,裝置會拒絕不支援安全連線的連線,並強制使用較長的密鑰長度。 SC Only 模式也會嘗試強制使用者確認預期的對等互連裝置。沒有螢幕的裝置 (例如耳機) 通常不支援 SC,原因就在於此。 |
錯誤 strict
類型:uint32
定義於 fuchsia.bluetooth.sys/access.fidl
| 名稱 | 值 | 說明 |
|---|---|---|
失敗 |
1 |
無法執行這項操作。 |
PEER_NOT_FOUND |
2 |
找不到指定給這項作業的對等互連。 |
TIMED_OUT |
3 |
作業時間限制已過期。 |
已取消 |
4 |
作業已取消。 |
IN_PROGRESS |
5 |
作業已在進行中。 |
NOT_SUPPORTED |
6 |
不支援這項作業。 |
INVALID_ARGUMENTS |
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 節。
| 名稱 | 值 | 說明 |
|---|---|---|
MODE_1 |
1 |
在 LE 安全模式 1 中,通訊會透過加密機制保護,而以 BLE 為基礎的服務可能會針對加密金鑰的驗證、金鑰大小或安全連線保護措施,指定不同的需求。 |
SECURE_CONNECTIONS_ONLY |
2 |
在「僅限安全連線」模式下,所有安全通訊都必須使用 128 位元、經過驗證,以及 LE 安全連線產生的加密金鑰。如果裝置因系統限制而無法滿足這些加密金鑰屬性,凡是涉及這類裝置的連線,都無法確保連結安全。這個模式不會禁止未加密的通訊,只會對所有加密通訊強制執行更嚴格的政策。 |
LookupError flexible
類型:uint32
定義於 fuchsia.bluetooth.sys/address_lookup.fidl
| 名稱 | 值 | 說明 |
|---|---|---|
NOT_FOUND |
0 |
|
MISSING_ARGUMENT |
1 |
OutputCapability strict
類型:uint32
在 fuchsia.bluetooth.sys/pairing.fidl 中定義
配對交換的輸出功能。 這些值應根據本機系統向發起或接受藍牙配對的使用者顯示資訊的能力設定。詳情請參閱第 3 卷第 C 部分的表 5.4。
| 名稱 | 值 | 說明 |
|---|---|---|
無 |
1 |
沒有可配對的螢幕。 |
顯示形式 |
2 |
顯示器可顯示至少六位數的小數。 |
PairingKeypress strict
類型:uint32
在 fuchsia.bluetooth.sys/pairing.fidl 中定義
用於向對等互連裝置傳達密碼金鑰輸入進度。您可以利用各種按鍵類型,自訂傳送給配對要求者的訊息。
| 名稱 | 值 | 說明 |
|---|---|---|
DIGIT_ENTERED |
1 |
使用者輸入了單一數字。 |
DIGIT_ERASED |
2 |
使用者已清除單一數字。 |
PASSKEY_CLEARED |
3 |
使用者已清除所有密碼金鑰。 |
PASSKEY_ENTERED |
4 |
使用者已輸入密碼金鑰。 |
PairingMethod strict
類型:uint32
在 fuchsia.bluetooth.sys/pairing.fidl 中定義
Security Manager 配對方法所需的不同型別。 藍牙 SIG 對不同裝置功能有不同的要求。
| 名稱 | 值 | 說明 |
|---|---|---|
同意聲明 |
1 |
系統會要求使用者接受或拒絕配對。 這是最基本的方法,即使兩部裝置都不支援輸入或輸出,系統也會要求委派者確認任何未由使用者意圖啟動的配對。 |
PASSKEY_DISPLAY |
2 |
這部裝置會向使用者顯示 6 位數的數字密碼金鑰,使用者必須在對等裝置上輸入該密碼金鑰。 |
PASSKEY_COMPARISON |
3 |
這部裝置會向使用者顯示 6 位數的數字密碼金鑰,該密碼金鑰也會顯示在對等裝置上。使用者必須比較密碼金鑰,如果相符,請接受配對。 |
PASSKEY_ENTRY |
4 |
系統會要求使用者在這部裝置上輸入 6 位數的密碼金鑰,該密碼金鑰是透過對等裝置傳送。 |
PairingSecurityLevel strict
類型:uint32
定義於 fuchsia.bluetooth.sys/pairing_options.fidl
配對所需的安全性等級 - 對應於第 3 卷第 H 部分第 2.3.1 節中「安全管理員通訊協定」定義的安全性等級
| 名稱 | 值 | 說明 |
|---|---|---|
ENCRYPTED |
1 |
加密但未受 MITM 保護 (未經驗證) |
已驗證 |
2 |
以 MITM 防護 (已驗證) 加密,但這個安全等級無法完全防範被動竊聽者 |
TechnologyType strict
類型:uint32
定義於 fuchsia.bluetooth.sys/peer.fidl
| 名稱 | 值 | 說明 |
|---|---|---|
LOW_ENERGY |
1 |
|
傳統版 |
2 |
|
DUAL_MODE |
3 |
TABLES
AccessSetConnectionPolicyRequest resource
定義於 fuchsia.bluetooth.sys/access.fidl
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
suppress_bredr_connections |
server_end:ProcedureToken
|
透過 BR/EDR 傳輸層抑制所有新連線。當 |
AddressLookupLookupRequest
定義於 fuchsia.bluetooth.sys/address_lookup.fidl
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
peer_id |
fuchsia.bluetooth/PeerId
|
BondingData
在 fuchsia.bluetooth.sys/identity.fidl 中定義
代表單一對等互連的繫結資料。
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
identifier |
fuchsia.bluetooth/PeerId
|
可明確識別這個對等互連的 ID。 |
2 |
local_address |
fuchsia.bluetooth/Address
|
與這個繫結相關聯的本機藍牙身分位址。 |
3 |
name |
fuchsia.bluetooth/DeviceName
|
同儕的姓名 (如已知)。 |
6 |
address |
fuchsia.bluetooth/Address
|
對等互連的身分位址。 |
7 |
le_bond |
LeBondData
|
當這個對等互連裝置在 LE 傳輸上配對時,會出現繫結資料。 |
8 |
bredr_bond |
BredrBondData
|
在 BR/EDR 傳輸上配對此對等互連裝置時,存在的繫結資料。 |
9 |
device_class |
fuchsia.bluetooth/DeviceClass
|
對等互連裝置的裝置類別 (如已知)。 新增:30
|
BredrBondData
定義於 fuchsia.bluetooth.sys/identity.fidl
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
role_preference |
fuchsia.bluetooth/ConnectionRole
|
對等互連裝置偏好的微網角色。這取決於角色切換程序。從對等互連裝置呼叫及連線時,系統不會自動設定這個旗標。如果沒有這項屬性,表示同儕尚未表達偏好設定。 |
2 |
services |
vector<fuchsia.bluetooth/Uuid>:65535
|
從 EIR 資料或 SDP 取得的已知服務 UUID。 |
3 |
link_key |
PeerKey
|
半永久 BR/EDR 金鑰。Present if link was paired with Secure Simple Pairing or stronger. |
HostData
在 fuchsia.bluetooth.sys/identity.fidl 中定義
代表永久性本機主機資料。
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
irk |
LocalKey
|
bt-host 裝置在本機使用的身分解析金鑰,可在啟用隱私權時產生可解析的私人位址。 如果主機未使用 LE 隱私權,或僅使用無法解析的私人位址,則可能不會顯示這項資訊。 注意:這個金鑰會在配對程序期間分配給 LE 對等互連裝置。用戶端必須注意指派的 IRK 是否與本機 bt-host ID 一致。 |
HostInfo
定義於 fuchsia.bluetooth.sys/host_watcher.fidl
藍牙控制器及其相關聯主機子系統狀態的資訊。
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
id |
fuchsia.bluetooth/HostId
|
可明確識別目前系統上的主機。 這個欄位一律會顯示。 |
2 |
technology |
TechnologyType
|
這個轉接器支援的藍牙技術。 這個欄位一律會顯示。 |
4 |
active |
bool
|
指出這是否為有效主機。系統有一個作用中的主機,負責處理所有藍牙程序。 |
5 |
local_name |
fuchsia.bluetooth/DeviceName
|
這個主機的本機名稱。這個名稱會向處於可探索模式的主機顯示。 |
6 |
discoverable |
bool
|
本機介面卡目前是否可透過 BR/EDR 和 LE 實體通道偵測到。 |
7 |
discovering |
bool
|
目前是否正在執行裝置探索作業。 |
8 |
addresses |
vector<fuchsia.bluetooth/Address>
|
與主機相關聯的位址 (LE 和/或 BR/EDR)。 系統一律會先回報公開地址。 這個欄位一律會顯示。 新增:11
|
身分識別
在 fuchsia.bluetooth.sys/identity.fidl 中定義
代表單一主機子系統執行個體的持續性設定。這項資訊用於身分識別 (查詢、查詢回應和廣告),以及繫結密鑰回呼 (加密與這個身分相關聯的對等互連連結資料)。
用於繫結的每個 BR/EDR BD_ADDR 和低功耗公開身分位址,都應有自己的 Identity 執行個體,其中包含對應的對等互連。
每個支援 LE 隱私權的 Identity 執行個體都應具有與其繫結對等互連裝置所分配的 IRK 一致的 IRK。
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
host |
HostData
|
|
2 |
bonds |
vector<BondingData>
|
使用公開身分位址的所有債券都必須包含相同的本機位址。 |
LeBondData
定義於 fuchsia.bluetooth.sys/identity.fidl
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
connection_parameters |
LeConnectionParameters
|
對等互連裝置偏好的連線參數 (如有)。 |
2 |
services |
vector<fuchsia.bluetooth/Uuid>:65535
|
已知的 GATT 服務 UUID。 |
3 |
irk |
PeerKey
|
用於產生及解析隨機地址的 Identity Resolving RemoteKey。 |
4 |
csrk |
PeerKey
|
連線簽章會解析用於資料簽署的 RemoteKey,但不會加密。 |
5 |
peer_ltk |
Ltk
|
當對等互連裝置處於 LE 周邊裝置角色時,用於加密連線的 LE 長期金鑰。 在舊版配對 ( |
6 |
local_ltk |
Ltk
|
LE 長期金鑰,用於在對等互連裝置處於 LE Central 角色時加密連線。 在舊版配對 ( |
PairingDelegate2StartRequestRequest resource
定義於 fuchsia.bluetooth.sys/pairing.fidl
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
peer |
Peer
|
提出要求的對等互連。 |
2 |
info |
PairingProperties
|
配對的屬性。 |
3 |
request |
client_end:PairingRequest
|
用於完成配對程序的通訊協定。 |
PairingOptions
定義於 fuchsia.bluetooth.sys/pairing_options.fidl
可讓呼叫端更精細地控管配對程序的參數。這個表格的所有欄位都是選填,即使未設定任何欄位,配對仍可成功。
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
le_security_level |
PairingSecurityLevel
|
僅適用於執法單位。如有這項屬性,則會決定要配對的 Security Manager 安全層級。如未提供,系統會解讀為 PairingSecurityLevel.AUTHENTICATED。 |
2 |
bondable_mode |
BondableMode
|
如果傳輸方式為 LOW_ENERGY 或 DUAL_MODE,裝置在配對期間是否應建立繫結。如果沒有,則解讀為可繫結模式。 如果傳輸方式為 CLASSIC,則不得使用這個選項,否則值必須為 BONDABLE。 CLASSIC 傳輸模式目前不支援 NON_BONDABLE 模式 |
3 |
transport |
TechnologyType
|
如果傳輸方式為 LOW_ENERGY,請指出您希望透過 LE 傳輸方式配對。如果傳輸方式為 CLASSIC,請指出您希望透過 Br/Edr 傳輸方式配對。 如果傳輸方式為 DUAL_MODE,表示您希望透過兩種傳輸方式配對。如果不存在,則解讀為 TechnologyType.DUAL_MODE |
PairingRequestAcceptRequest
定義於 fuchsia.bluetooth.sys/pairing.fidl
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
entered_passkey |
uint32
|
對等節點
定義於 fuchsia.bluetooth.sys/peer.fidl
代表遠端 BR/EDR、LE 或雙模式 BR/EDR/LE 對等互連裝置。
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
id |
fuchsia.bluetooth/PeerId
|
在目前系統中,這個對等互連的專屬 ID。 這個欄位一律會顯示。 |
2 |
address |
fuchsia.bluetooth/Address
|
用來識別這個對等互連裝置的藍牙裝置位址。如果 這個欄位一律會顯示。 注意:用戶端應使用 |
3 |
technology |
TechnologyType
|
這個對等互連裝置支援的藍牙技術。 這個欄位一律會顯示。 |
4 |
connected |
bool
|
與這個對等互連裝置之間是否存在 BR/EDR 和/或 LE 連線。 這個欄位一律會顯示。 |
5 |
bonded |
bool
|
這個對等互連是否已繫結。 這個欄位一律會顯示。 |
6 |
name |
fuchsia.bluetooth/DeviceName
|
同儕的姓名 (如已知)。 |
7 |
appearance |
fuchsia.bluetooth/Appearance
|
LE 外觀屬性。如果對等互連裝置支援 LE,且外觀資訊是透過廣告和/或 GATT 取得,則會顯示這項資訊。 |
8 |
device_class |
fuchsia.bluetooth/DeviceClass
|
這部裝置的裝置類別 (如已知)。 |
9 |
rssi |
int8
|
這個對等互連裝置最近一次取得的廣告信號強度。如有,請提供。 |
10 |
tx_power |
int8
|
這個對等互連裝置最近一次取得的傳輸功率。如有,請提供。 |
11 |
services |
vector<fuchsia.bluetooth/Uuid>:65535
|
這個對等互連裝置上可用的服務 UUID 清單。 這是舊版欄位,不應做為新程式碼的依據。 已淘汰 |
12 |
le_services |
vector<fuchsia.bluetooth/Uuid>:65535
|
已知可透過 LE 傳輸方式使用的服務 UUID 清單。 如果技術為 CLASSIC,則一律不會出現。 |
13 |
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。
| 序數 | 欄位 | 類型 | 說明 |
|---|---|---|---|
1 |
le_privacy |
bool
|
如果設為 True,則啟用 LE Privacy 功能;如果設為 False,則停用這項功能。如果沒有,則目前的值會維持不變。啟用後,所有會廣播本機裝置位址的 BLE 程序 (主動掃描、連線啟動和廣告) 都會使用可解析的私人位址類型。停用時,這些程序會顯示指派給控制器的本機公開身分位址。 強烈建議在產品上啟用這項功能。 |
2 |
le_background_scan |
bool
|
如果為 true,則啟用低功耗背景掃描功能;如果為 false,則停用這項功能。如果沒有,則目前值維持不變。啟用後,系統會持續進行被動掃描,並與處於「可連線」或「導向可連線」模式的配對裝置建立連線。 |
3 |
bredr_connectable_mode |
bool
|
如果為 true,則啟用 BR/EDR 可連線模式;如果為 false,則停用。如果沒有,則目前值維持不變。啟用後,bt-host 裝置會進入 BR/EDR 頁面掃描模式,並接受連線。 |
4 |
le_security_mode |
LeSecurityMode
|
如有此值,則設定主機子系統的 LE 安全模式;如無此值,則維持目前的值不變。詳情請參閱 BT Core Spec v5.2 Vol. 3 Part C 10.2。如果存在且設為「僅傳送安全性連線的 Cookie」模式,系統會中斷任何不符合「僅傳送安全性連線的 Cookie」模式要求的有效連線。 |
5 |
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 | 類型 | 說明 |
|---|---|---|---|
1 |
response |
Access_Connect_Response
|
|
2 |
err |
Error
|
Access_Disconnect_Result strict
在 fuchsia.bluetooth.sys/access.fidl 中定義
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
Access_Disconnect_Response
|
|
2 |
err |
Error
|
Access_Forget_Result strict
在 fuchsia.bluetooth.sys/access.fidl 中定義
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
Access_Forget_Response
|
|
2 |
err |
Error
|
Access_MakeDiscoverable_Result strict
在 fuchsia.bluetooth.sys/access.fidl 中定義
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
Access_MakeDiscoverable_Response
|
|
2 |
err |
Error
|
Access_Pair_Result strict
在 fuchsia.bluetooth.sys/access.fidl 中定義
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
Access_Pair_Response
|
|
2 |
err |
Error
|
Access_SetConnectionPolicy_Result strict
在 fuchsia.bluetooth.sys/access.fidl 中定義
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
Access_SetConnectionPolicy_Response
|
|
2 |
err |
Error
|
Access_StartDiscovery_Result strict
在 fuchsia.bluetooth.sys/access.fidl 中定義
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
Access_StartDiscovery_Response
|
|
2 |
err |
Error
|
AddressLookup_Lookup_Result strict
定義於 fuchsia.bluetooth.sys/address_lookup.fidl
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
AddressLookup_Lookup_Response
|
|
2 |
err |
LookupError
|
|
3 |
framework_err |
internal
|
Bootstrap_Commit_Result strict
在 fuchsia.bluetooth.sys/bootstrap.fidl 中定義
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
Bootstrap_Commit_Response
|
|
2 |
err |
BootstrapError
|
HostWatcher_SetActive_Result strict
定義於 fuchsia.bluetooth.sys/host_watcher.fidl
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
response |
HostWatcher_SetActive_Response
|
|
2 |
err |
zx/Status
|
PairingProperties flexible
定義於 fuchsia.bluetooth.sys/pairing.fidl
| 序數 | Variant | 類型 | 說明 |
|---|---|---|---|
1 |
consent |
Consent
|
系統會要求使用者接受或拒絕配對。 這是最基本的方法,即使兩部裝置都不支援輸入或輸出,系統也會要求委派者確認任何未由使用者意圖啟動的配對。 |
2 |
passkey_display |
uint32
|
這部裝置會向使用者顯示 6 位數的數字密碼金鑰,使用者必須在對等裝置上輸入該密碼金鑰。系統會提供要顯示的密碼金鑰。 |
3 |
passkey_confirmation |
uint32
|
這部裝置會向使用者顯示 6 位數的數字密碼金鑰,對等互連裝置也會顯示這組密碼金鑰。使用者必須比較密碼金鑰,如果相符,請接受配對。 系統會提供要顯示的密碼金鑰。 |
4 |
passkey_entry |
PasskeyEntry
|
系統會要求使用者在這部裝置上輸入 6 位數的密碼金鑰,該密碼金鑰是透過對等裝置傳送。 |
常數
| 名稱 | 值 | 類型 | 說明 |
|---|---|---|---|
| MAX_PEER_SERVICES |
65535
|
uint16 |
每個傳輸方式可探索的服務數量上限。目前設為用來存取服務的有效 16 位元控制代碼或 PSM 數量。 |
ALIASES
| 名稱 | 值 | 說明 |
|---|---|---|
| LocalKey |
fuchsia.bluetooth.sys/Key |
代表在本機產生的金鑰,會分配到一或多個債券。 |