Skip to content

Interactive Session

tools/spp_interactive.py provides an interactive RFCOMM session for sending commands to the headphones and viewing responses in real time.

Terminal window
python tools/spp_interactive.py [channel]

The channel defaults to 14 if not specified.

  • Background receiver thread displays incoming packets asynchronously
  • Timestamped send/receive output with hex dump
  • Packet header parsing with based-connect format detection
CommandDescription
hex <bytes>Send raw hex bytes (e.g., hex 01 02 01 00)
nc <0-10>Send noise cancellation level command
querySend based-connect device query (00 01 01 00)
raw <text>Send ASCII text
quitDisconnect and exit
> hex 01 02 01 00
[SEND] 01 02 01 00
[RECV] 01 02 03 06 00 42 6f 6d 62 61 79 (device name: "Bombay")

The query command sends the based-connect protocol info request (00 01 01 00), which returns the protocol version string. This is useful for verifying the connection is working before sending more complex commands.

The interactive tool is most useful on channels 8 and 9 (QC35-compatible commands) and channel 14 (ff55 protocol). On other channels, commands may not produce responses.