PROTOCOLS
Control
Defined in fuchsia.bluetooth.control/control.fidl
Primary Bluetooth control service to access bluetooth
IsBluetoothAvailable
Returns whether or not Bluetooth is currently available on the system.
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
available |
bool
|
SetPairingDelegate
Registers a delegate to handle pairing requests.
Indicate the capability type of the PairingDelegate using in and out.
If your input/output capability is variable, call this function when it
changes to update.
Setting a pairing delegate closes the previously assigned pairing Delegate.
To disable pairing, set delegate to null.
Request
| Name | Type |
|---|---|
delegate |
PairingDelegate?
|
Response
| Name | Type |
|---|---|
success |
bool
|
GetAdapters
Returns information about all local adapters that are known to the system.
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
adapters |
vector<AdapterInfo>?
|
SetActiveAdapter
Sets the local adapter with the given identifier to act as the backing
adapter for all Bluetooth interfaces.
Request
| Name | Type |
|---|---|
identifier |
string
|
Response
| Name | Type |
|---|---|
status |
fuchsia.bluetooth/Status
|
GetActiveAdapterInfo
Returns information on the current active adapter, if it exists.
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
adapter |
AdapterInfo?
|
RequestDiscovery
If discovery is true, active discovery is requested.
When requesting discovery, general discovery for BR/EDR and LE will be
active and newly discovered devices will be reported via
RemoteDeviceDelegate.OnDeviceUpdate().
Discovery may be active when not reqested.
If an error occurs when starting discovery, it is reflected in status.
Request
| Name | Type |
|---|---|
discovery |
bool
|
Response
| Name | Type |
|---|---|
status |
fuchsia.bluetooth/Status
|
GetKnownRemoteDevices
Retrieve the set of known remote devices. Note: These devices are not guaranteed to still be reachable.
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
devices |
vector<RemoteDevice>
|
SetName
Sets the public Bluetooth name for this device, or resets to the default
name if name is not present.
Request
| Name | Type |
|---|---|
name |
string?
|
Response
| Name | Type |
|---|---|
status |
fuchsia.bluetooth/Status
|
SetDeviceClass
Set the Device Class for the active Bluetooth adapter. Values are defined in https://www.bluetooth.com/specifications/assigned-numbers/baseband
Request
| Name | Type |
|---|---|
device_class |
DeviceClass
|
Response
| Name | Type |
|---|---|
status |
fuchsia.bluetooth/Status
|
SetDiscoverable
Set the discoverability of this device.
Request
| Name | Type |
|---|---|
discoverable |
bool
|
Response
| Name | Type |
|---|---|
status |
fuchsia.bluetooth/Status
|
Connect
Attempt to connect to the remote device_id.
Request
| Name | Type |
|---|---|
device_id |
string
|
Response
| Name | Type |
|---|---|
status |
fuchsia.bluetooth/Status
|
Disconnect
Disconnect a previously-connected device. Note: This does not remove a device bond, see Control::Forget.
Request
| Name | Type |
|---|---|
device_id |
string
|
Response
| Name | Type |
|---|---|
status |
fuchsia.bluetooth/Status
|
Forget
Forgets device_id completely, removing all bonding information.
This will disconnect a device if it is connected.
Request
| Name | Type |
|---|---|
device_id |
string
|
Response
| Name | Type |
|---|---|
status |
fuchsia.bluetooth/Status
|
SetIOCapabilities
Set local IO Capabilities to use during pairing.
Request
| Name | Type |
|---|---|
input |
InputCapabilityType
|
output |
OutputCapabilityType
|
OnActiveAdapterChanged
Sent when the active adapter has been updated. If active_adapter is
null, then no adapter is currently active.
Response
| Name | Type |
|---|---|
adapter |
AdapterInfo?
|
OnAdapterUpdated
Sent when an adapter has been updated.
Response
| Name | Type |
|---|---|
adapter |
AdapterInfo
|
OnAdapterRemoved
Sent when an adapter with the given identifier has been removed from
the system.
Response
| Name | Type |
|---|---|
identifier |
string
|
OnDeviceUpdated
Sent when a peer is updated.
Response
| Name | Type |
|---|---|
device |
RemoteDevice
|
OnDeviceRemoved
Sent when a peer is removed.
Response
| Name | Type |
|---|---|
identifier |
string
|
PairingDelegate
Defined in fuchsia.bluetooth.control/pairing_delegate.fidl
OnPairingRequest
Request
| Name | Type |
|---|---|
device |
RemoteDevice
|
method |
PairingMethod
|
displayed_passkey |
string?
|
Response
| Name | Type |
|---|---|
accept |
bool
|
entered_passkey |
string?
|
OnPairingComplete
Request
| Name | Type |
|---|---|
device_id |
string
|
status |
fuchsia.bluetooth/Status
|
OnRemoteKeypress
Request
| Name | Type |
|---|---|
device_id |
string
|
keypress |
PairingKeypressType
|
OnLocalKeypress
Response
| Name | Type |
|---|---|
device_id |
string
|
keypress |
PairingKeypressType
|
STRUCTS
SecurityProperties
Defined in fuchsia.bluetooth.control/bonding.fidl
| Name | Type | Description | Default |
|---|---|---|---|
authenticated |
bool
|
No default | |
secure_connections |
bool
|
No default | |
encryption_key_size |
uint8
|
No default |
RemoteKey
Defined in fuchsia.bluetooth.control/bonding.fidl
| Name | Type | Description | Default |
|---|---|---|---|
security_properties |
SecurityProperties
|
No default | |
value |
uint8[16]
|
No default |
LocalKey
Defined in fuchsia.bluetooth.control/bonding.fidl
| Name | Type | Description | Default |
|---|---|---|---|
value |
uint8[16]
|
No default |
LTK
Defined in fuchsia.bluetooth.control/bonding.fidl
| Name | Type | Description | Default |
|---|---|---|---|
key |
RemoteKey
|
No default | |
key_size |
uint8
|
No default | |
ediv |
uint16
|
No default | |
rand |
uint64
|
No default |
LEConnectionParameters
Defined in fuchsia.bluetooth.control/bonding.fidl
| Name | Type | Description | Default |
|---|---|---|---|
connection_interval |
uint16
|
No default | |
connection_latency |
uint16
|
No default | |
supervision_timeout |
uint16
|
No default |
LEData
Defined in fuchsia.bluetooth.control/bonding.fidl
| Name | Type | Description | Default |
|---|---|---|---|
address |
string
|
No default | |
address_type |
AddressType
|
No default | |
connection_parameters |
LEConnectionParameters?
|
No default | |
services |
vector<string>
|
No default | |
ltk |
LTK?
|
No default | |
irk |
RemoteKey?
|
No default | |
csrk |
RemoteKey?
|
No default |
BREDRData
Defined in fuchsia.bluetooth.control/bonding.fidl
| Name | Type | Description | Default |
|---|---|---|---|
address |
string
|
No default | |
piconet_leader |
bool
|
No default | |
services |
vector<string>
|
No default | |
link_key |
LTK?
|
No default |
BondingData
Defined in fuchsia.bluetooth.control/bonding.fidl
| Name | Type | Description | Default |
|---|---|---|---|
identifier |
string
|
No default | |
local_address |
string
|
No default | |
name |
string?
|
No default | |
le |
LEData?
|
No default | |
bredr |
BREDRData?
|
No default |
HostData
Defined in fuchsia.bluetooth.control/bonding.fidl
Represents persistent local host data.
| Name | Type | Description | Default |
|---|---|---|---|
irk |
LocalKey?
|
The local Identity Resolving Key used by a bt-host device to generate Resolvable Private Addresses when privacy is enabled. NOTE: This key is distributed to LE peers during pairing procedures. The client must take care to assign an IRK that consistent with the local bt-host identity. | No default |
AdapterInfo
Defined in fuchsia.bluetooth.control/control.fidl
Bluetooth controller and its associated host-subsystem state that is present on the current platform.
| Name | Type | Description | Default |
|---|---|---|---|
identifier |
string
|
UUID that uniquely identifies this adapter on the current system. | No default |
technology |
TechnologyType
|
The Bluetooth technologies that are supported by this adapter. | No default |
address |
string
|
Public Bluetooth device address which can be displayed to the user. | No default |
state |
AdapterState?
|
The current adapter state. This field is only present when an AdapterInfo is obtained via the Control and ControlDelegate interfaces. If present, all optional members of `state` will also be present. | No default |
AdapterState
Defined in fuchsia.bluetooth.control/control.fidl
Contains static global information about a local Bluetooth adapter, including its current state. Each adapter instance represents a physical
| Name | Type | Description | Default |
|---|---|---|---|
local_name |
string?
|
No default | |
discoverable |
fuchsia.bluetooth/Bool?
|
No default | |
discovering |
fuchsia.bluetooth/Bool?
|
No default | |
local_service_uuids |
vector<string>?
|
No default |
DeviceClass
Defined in fuchsia.bluetooth.control/control.fidl
Device Class represents the Major and Minor Device Class and Service Class of an adapter Values are defined in https://www.bluetooth.com/specifications/assigned-numbers/baseband
| Name | Type | Description | Default |
|---|---|---|---|
value |
uint32
|
No default |
RemoteDevice
Defined in fuchsia.bluetooth.control/remote_device.fidl
| Name | Type | Description | Default |
|---|---|---|---|
identifier |
string
|
No default | |
address |
string
|
No default | |
technology |
TechnologyType
|
No default | |
name |
string?
|
No default | |
appearance |
Appearance
|
No default | |
rssi |
fuchsia.bluetooth/Int8?
|
No default | |
tx_power |
fuchsia.bluetooth/Int8?
|
No default | |
connected |
bool
|
No default | |
bonded |
bool
|
No default | |
service_uuids |
vector<string>
|
No default |
ENUMS
AddressType
Type: uint8
Defined in fuchsia.bluetooth.control/bonding.fidl
| Name | Value | Description |
|---|---|---|
LE_PUBLIC |
0 |
|
LE_RANDOM |
1 |
|
BREDR |
2 |
InputCapabilityType
Type: uint32
Defined in fuchsia.bluetooth.control/pairing_delegate.fidl
| Name | Value | Description |
|---|---|---|
NONE |
0 |
|
CONFIRMATION |
1 |
|
KEYBOARD |
2 |
OutputCapabilityType
Type: uint32
Defined in fuchsia.bluetooth.control/pairing_delegate.fidl
| Name | Value | Description |
|---|---|---|
NONE |
0 |
|
DISPLAY |
1 |
PairingMethod
Type: uint32
Defined in fuchsia.bluetooth.control/pairing_delegate.fidl
| Name | Value | Description |
|---|---|---|
CONSENT |
0 |
|
PASSKEY_DISPLAY |
1 |
|
PASSKEY_COMPARISON |
2 |
|
PASSKEY_ENTRY |
3 |
PairingKeypressType
Type: uint32
Defined in fuchsia.bluetooth.control/pairing_delegate.fidl
| Name | Value | Description |
|---|---|---|
DIGIT_ENTERED |
0 |
|
DIGIT_ERASED |
1 |
|
PASSKEY_CLEARED |
2 |
|
PASSKEY_ENTERED |
3 |
Appearance
Type: uint32
Defined in fuchsia.bluetooth.control/remote_device.fidl
| Name | Value | Description |
|---|---|---|
UNKNOWN |
0 |
|
PHONE |
64 |
|
COMPUTER |
128 |
|
WATCH |
192 |
|
WATCH_SPORTS |
193 |
|
CLOCK |
256 |
|
DISPLAY |
320 |
|
REMOTE_CONTROL |
384 |
|
EYE_GLASSES |
448 |
|
TAG |
512 |
|
KEYRING |
576 |
|
MEDIA_PLAYER |
640 |
|
BARCODE_SCANNER |
704 |
|
THERMOMETER |
768 |
|
THERMOMETER_EAR |
769 |
|
HEART_RATE_SENSOR |
832 |
|
HEART_RATE_SENSOR_BELT |
833 |
|
BLOOD_PRESSURE |
896 |
|
BLOOD_PRESSURE_ARM |
897 |
|
BLOOD_PRESSURE_WRIST |
898 |
|
HID |
960 |
|
HID_KEYBOARD |
961 |
|
HID_MOUSE |
962 |
|
HID_JOYSTICK |
963 |
|
HID_GAMEPAD |
964 |
|
HID_DIGITIZER_TABLET |
965 |
|
HID_CARD_READER |
966 |
|
HID_DIGITAL_PEN |
967 |
|
HID_BARCODE_SCANNER |
968 |
|
GLUCOSE_METER |
1024 |
|
RUNNING_WALKING_SENSOR |
1088 |
|
RUNNING_WALKING_SENSOR_IN_SHOE |
1089 |
|
RUNNING_WALKING_SENSOR_ON_SHOE |
1090 |
|
RUNNING_WALKING_SENSOR_ON_HIP |
1091 |
|
CYCLING |
1152 |
|
CYCLING_COMPUTER |
1153 |
|
CYCLING_SPEED_SENSOR |
1154 |
|
CYCLING_CADENCE_SENSOR |
1155 |
|
CYCLING_POWER_SENSOR |
1156 |
|
CYCLING_SPEED_AND_CADENCE_SENSOR |
1157 |
|
PULSE_OXIMETER |
3136 |
|
PULSE_OXIMETER_FINGERTIP |
3137 |
|
PULSE_OXIMETER_WRIST |
3138 |
|
WEIGHT_SCALE |
3200 |
|
PERSONAL_MOBILITY |
3264 |
|
PERSONAL_MOBILITY_WHEELCHAIR |
3265 |
|
PERSONAL_MOBILITY_SCOOTER |
3266 |
|
GLUCOSE_MONITOR |
3328 |
|
SPORTS_ACTIVITY |
5184 |
|
SPORTS_ACTIVITY_LOCATION_DISPLAY |
5185 |
|
SPORTS_ACTIVITY_LOCATION_AND_NAV_DISPLAY |
5186 |
|
SPORTS_ACTIVITY_LOCATION_POD |
5187 |
|
SPORTS_ACTIVITY_LOCATION_AND_NAV_POD |
5188 |
TechnologyType
Type: uint32
Defined in fuchsia.bluetooth.control/remote_device.fidl
| Name | Value | Description |
|---|---|---|
LOW_ENERGY |
0 |
|
CLASSIC |
1 |
|
DUAL_MODE |
2 |