Queries¶

Bluespy supports various query strings, which can be applied to any event and are used to define the columns, for searching and in the API. The queries can all be represented as a string, but may also return an integer or a boolean. The following queries (this list can also be found in Help → Query List) are supported:

Query	Description
`CID`	L2CAP Channel Identifier
`LAP`	Classic Lower Address Part
`T_IFS_before`	Measurement of T_IFS before this packet
`T_IFS_after`	Measurement of T_IFS after this packet
`access_address`	LE Access Address
`access_code`	Access Address or LAP
`advA`	Advertising Address sent in a particular advertising packet
`acked`	Packet was acknowledged (bool)
`aux_pkt`	The auxiliary advertising packet
`aux_pkt_window`	The time window that should contain an auxiliary advertising packet
`broadcast_code`	Broadcast code for encrypted BIG
`broadcast_id`	Broadcast ID for BIG
`broadcast_name`	Broadcast Name for BIG
`central.addr`	Bluetooth address of the central device
`central.irk`	Identity Resolving Key of the central device
`central.localnames`	Discovered names of the central device
`central.vendor_names`	Vendor(s) of the central device
`central_packet_count`	Packet number from central in this LE connection event
`channel`	RF channel of packet
`cie`	CIE: Close Isochronous Event
`connection_handle`	HCI Connection Handle
`cssn`	CSSN: Control Subevent Sequence Number
`cstf`	CSTF: Control Subevent Transmission Flag
`cl.ARQN`	Classic ARQN
`cl.SEQN`	Classic SEQN
`connectable`	Advertising Event/Set is connectable (bool)
`crc`	CRC of packet
`crc_valid`	CRC passed (bool)
`CSIPS_info`	Information regarding Coordinated Sets
`cte`	LE packet has constant tone extension (bool)
`decrypted`	Packet has been successfully decrypted (bool)
`delta_ref`	Time delta to last selected packet
`device_summary`	Information on sender and receiver
`directed`	LE Advertising is a directed type
`duration`	Packet time duration
`dukosi.crc`	CRC
`dukosi.source_id`	Source ID
`dukosi.message_type`	Message Type
`emojis`	A list of symbols concisely expressing essential packet stats
`encrypted`	The packet was encrypted
`errors`	Problems detected in this packet
`event_counter`	LE connection event number or Classic clock
`frequency`	RF frequency
`freq_error_ppm`	RF frequency error (ppm)
`flow_packet`	FLOW (packet-level)
`flow_payload`	FLOW (payload-level)
`handles`	ATT handles
`initA`	Connection Initiator Address
`initiator.addr`	CS Initiator Address
`is_ID`	Packet was a Classic ID packet (bool)
`is_adv`	Packet is LE advertising (bool)
`is_data`	Packet is LE data (bool)
`is_empty`	Packet has no payload (bool)
`is_isoc`	Packet is isochronous (bool)
`is_test`	LE Test packet (bool)
`llid`	LLID
`local_name`	Local name
`lt_addr`	LT Address
`md`	MD: More Data
`media_timestamp`	AVDTP media timestamp
`modulation`	PHY layer modulation scheme
`nacked`	Packet was negatively acknowledged
`nesn`	NESN: Next Expected Sequence Number
`npi`	NPI: Null PDU Indicator
`payload_counters`	Payload Counters
`payload_hex`	Packet payload in hexadecimal format
`payload_length`	Number of payload bytes (integer)
`payload_raw`	Payload as raw bytes
`payload_summary`	Beginning of payload
`peripheral.addr`	Bluetooth address of the peripheral device
`peripheral.irk`	Identity Resolving Key of the peripheral device
`peripheral.localnames`	Discovered names of the peripheral device
`peripheral.vendor_names`	Vendor(s) of the peripheral device
`peripheral_packet_count`	Packet number from peripheral in this LE connection event
`pkt_no`	Baseband packet index in the capture file
`pkt_type`	Baseband packet type
`read_by_type_uuid`	GATT read by type UUID
`receiver.addr`	Bluetooth address of the receiver device
`receiver.irk`	Identity Resolving Key of the receiver device
`receiver.localnames`	Discovered names of the receiver device
`receiver.vendor_names`	Vendor(s) of the receiver device
`rejected`	Packet was rejected by receiver (bool)
`resolvable_set_id`	Resolvable set ID of Coordinated Set member
`rssi`	Received signal strength in dBm at Moreph
`scanA`	Scanner Address
`scannable`	LE Advertising is scannable (bool)
`sender.addr`	Bluetooth address of the sender device
`sender.irk`	Identity Resolving Key of the sender device
`sender.localnames`	Discovered names of the sender device
`sender.vendor_names`	Vendor(s) of the sender device
`service_uuid`	GATT service UUID
`sn`	SN: Sequence Number
`ssrc`	AVDTP SSRC
`status`	Packet status
`summary`	Packet summary
`superior_pkts`	The superior packets of this advertising packet
`sync_pkt`	The SYNC packet pointed to by this advertising packet
`sync_pkt_window`	The time window that should contain a SYNC packet
`sync_pointing_pkts`	The advertising packets pointing to this SYNC packet
`targetA`	The address this advertising packet is targetting
`throughput`	Byte throughput rate
`time`	Packet timestamp
`type`	Kind of packet

In the API, some special queries can also be applied to devices, connections and audio streams.

Device Queries¶

Query	Description
`addresses`	Addresses
`first_pkt_time`	Time of the device's first packet
`identity_address`	Identity Address (LE and Dual Mode devices only)
`irk`	IRK (LE and Dual Mode devices only)
`last_pkt_time`	Time of the packet's last packet
`mean_rssi`	Average signal strength (dBm)
`rx_packets`	Number of packets received
`summary`	Summary string
`total_packets`	Total number of packets
`type`	Type of Device (Low-Energy, Classic, or Dual Mode)

Connection Queries¶

Query	Description
`address`	Connection Address
`central_address`	Address of the central device
`central_packet_count`	Number of packets from the central device
`crc_failed_pkt_count`	Number of packets which fail CRC checks
`first_packet_time`	Time of the first packet
`last_packet_time`	Time of the last packet
`mean_rssi_central`	Average signal strength from the central to peripheral devices
`mean_rssi_peripheral`	Average signal strength from the peripheral to central devices
`peripheral_address`	Address of the peripheral device
`peripheral_packet_count`	Number of packets from the peripheral device
`summary`	Summary string
`termination_time`	Termination time
`total_packets`	Total number of packets
`type`	Type of connection
`undecryptable_pkt_count`	Number of encrypted packets

Audiostream Queries¶

Query	Description
`address`	Address
`big_seed_aa`	(BIS only) Seed AA of the BIS's BIG
`bis_id`	(BIS only) ID of the BIS
`broadcast_name`	(BIS only) Broadcast Name
`central_packet_count`	Number of packets from the central device
`cig_id`	(CIS only) ID of the CIS's CIG
`cis_id`	(CIS only) ID of the CIS
`first_pkt_time`	Time of the first packet
`is_bidirectional`	Is the stream bidirectional
`is_silent`	(BIS only) Is silent
`is_silent_central`	Is silent from the central device
`is_silent_peripheral`	Is silent from the peripheral device
`last_pkt_time`	Time of the last packet
`mean_rssi`	(BIS only) Average signal strength
`mean_rssi_central`	Average signal strength from the central device
`mean_rssi_peripheral`	Average signal strength from the peripheral device
`media_timestamp`	(AVDTP only) Media timestamp
`peripheral_packet_count`	Number of packets from the peripheral device
`ssrc`	(AVDTP only) SSRC
`summary`	Summary string
`termination_time`	Termination time
`total_bytes`	Total number of bytes
`total_packets`	Total number of packets
`type`	Type of Audio Stream