bluer-tools

Crates.iobluer-tools
lib.rsbluer-tools
version0.17.2
sourcesrc
created_at2021-07-06 09:58:40.311661
updated_at2024-06-13 11:11:24.437652
descriptionBlueR tools: swiss army knife for GATT services, L2CAP and RFCOMM sockets on Linux
homepage
repositoryhttps://github.com/bluez/bluer
max_upload_size
id419378
size160,835
Sebastian Urban (surban)

documentation

README

BlueR tools — swiss army knife for GATT services, L2CAP and RFCOMM sockets on Linux

crates.io page BSD-2-Clause license

This crate provides tools for Bluetooth on Linux building on the functionality of the BlueR crate. A running Bluetooth daemon (BlueZ) is required.

The following command line tools are included:

  • bluadv: Send Bluetooth LE advertisements.

  • blumon: Scans for and monitors Bluetooth devices similar to top.

  • gattcat: Swiss army knife for Bluetooth LE GATT services.

    • discovers Bluetooth LE devices and their services
    • pairing
    • resolves all well-known UUIDs and manufacturer ids
    • performs all possible operations on GATT services
    • connects (via notify and write) to a remote GATT service
    • serves (via notify and write) a local program over a GATT service
    • implements the Nordic UART service (NUS) as client and server
  • l2cat: netcat-like for Bluetooth classic (BR/EDR) and LE L2CAP sockets.

    • connects to remote L2CAP PSMs
    • listens on local L2CAP PSMs and accepts connections
    • serves a local program on an L2CAP PSM
    • speed tests
  • rfcat: netcat-like for Bluetooth RFCOMM sockets.

    • connects to remote RFCOMM channels
    • listens on local RFCOMM channels
    • serves a local program on an RFCOMM channel
    • resolve and publish SDP records
    • speed tests

Each tool supports the --help option for detailed usage information.

Installation

First, install D-Bus and Bluetooth libraries on your system. On Debian this can be achieved by running

sudo apt install libdbus-1-dev

Then, run the following command to install BlueR tools

cargo install bluer-tools

If you do not have Cargo on your system, you can use rustup for installing it.

Commit count: 500

cargo fmt