fuchsia.bluetooth.snoop

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

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

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.