PROTOCOLS
Snoop
Defined in fuchsia.bluetooth.snoop/snooper.fidl
Interface to receive packets recorded as received or transmitted for a Bluetooth host.
Packets are received by the client as datagrams through the fidl channel as OnPacket
events.
Start
Subscribe to receive packets from the server. Packets that have been recorded are sent first.
If follow is true, the channel stays open and packets are sent to the client as
the snoop server receives them. If follow is false, the channel is closed by the server
when all recorded packets have been sent.
A host_device name may be provided; if so, only events from that host are sent to the client.
If host_device is absent, the client is sent events from all host devices.
Errors:
Start can only be called once per connection. After the first request, subsequent requests
always return an error.
host_device values that are not recognized by the server return an error.
Request
| Name | Type |
|---|---|
follow |
bool
|
host_device |
string?
|
Response
| Name | Type |
|---|---|
status |
fuchsia.bluetooth/Status
|
OnPacket
An event containing a packet that the client has registered interest in receiving and the
host_device which generated the packet.
Response
| Name | Type |
|---|---|
host_device |
string
|
packet |
SnoopPacket
|
STRUCTS
Timestamp
Defined in fuchsia.bluetooth.snoop/snooper.fidl
Timestamp represents the number of seconds and nanoseconds since the Unix epoch.
| Name | Type | Description | Default |
|---|---|---|---|
subsec_nanos |
uint32
|
Valid values for `subsec_nanos` can be greater than 10^9-1. Therefore the total seconds elapsed since the epoch is defined by the value of `seconds` plus `subsec_nanos` / 10^9 - the value of `seconds` alone may not be sufficient. It is invalid for the carry from `subsec_nanos` to overflow the `seconds` field. A client or server should reject such data as malformed. | No default |
seconds |
uint64
|
No default |
SnoopPacket
Defined in fuchsia.bluetooth.snoop/snooper.fidl
| Name | Type | Description | Default |
|---|---|---|---|
is_received |
bool
|
true if this packet is sent from the controller to the host. | No default |
type |
PacketType
|
No default | |
timestamp |
Timestamp
|
Timestamp that the bt-snoop service received the packet from a snoop channel as measured by the host system. | No default |
original_len |
uint32
|
Original length of the packet before truncation. | No default |
payload |
vector<uint8>
|
Payload sent over the HCI. | No default |
ENUMS
PacketType
Type: uint32
Defined in fuchsia.bluetooth.snoop/snooper.fidl
Messages coming through the Host Controller Interface can be one of three types.
| Name | Value | Description |
|---|---|---|
CMD |
0 |
Command sent from the host to the controller. |
EVENT |
1 |
Event sent from the controller to the host. |
DATA |
2 |
Data sent from the controller to the host. |