Bluetooth Low Energy command line tool for macOS.

• Scan BLE devices
• Establish a serial TTY connection to a BLE device
• (more planned is planned, but this is v0.3)

mint install mickeyl/core-bluetooth-tool

brew tap mickeyl/formulae
brew install core-bluetooth-tool

Since this application uses Bluetooth, you need to grant Bluetooth access to your favorite terminal emulator before running core-bluetooth-tool. Otherwise, the application will be halted by the OS.

Scan all BLE devices in vincinity (no longer works with macOS Monterey thanks to Apple):

core-bluetooth-tool scan

Scan all BLE devices in vincinity providing a certain service, e.g. with a UUID of FFF0:

core-bluetooth-tool scan fff0

Establish a serial bridge to the first BLE device providing a serial communication service, e.g., with a UUID of FFF0:

core-bluetooth-tool bridge fff0

Establish a serial bridge to a concrete BLE device providing a serial communication service, e.g., with a UUID of FFF0:

core-bluetooth-tool bridge fff0 F890A301-A464-D37C-AAFB-9374B546F7FE

For my work on car diagnosis apps like OBD2 Expert, I have been writing a lot of code to communicate with various kinds of serial OBD2 adapters. The most common technologies here are USB (ftdi232), WiFi, and Bluetooth 3.x (rfcomm), and – more recently – Bluetooth Low Energy (BLE).

While (of course) I have code that interacts with such devices, it's always important to be able to directly communicate with an adapter. This is no problem with USB, WiFi, and Bluetooth 3.x communication, as we have tools like minicom, picocom, and ncat to our disposal.

For Bluetooth Low Energy devices though, this has always been kind of a hassle. In contrast to Bluetooth 3.x, there is no serial port available. That's why I wrote the bridge subcommand, which opens a pseudo tty and allows you to use a terminal program to seamlessly interact with the device.

And while I was there, I figured I'd extend this to facilitate more tools.

I want to extend this tool in order to handle all the common tasks typically associated with Bluetooth Low Energy devices, such as

• scanning and printing services
• scanning and printing characteristics
• scanning and printing descriptors
• trigger bonding (by reading from an encrypted characteristic)
• subscribing to a characteristic and continously printing the output
• reading and writing to/from a characteristic

It would also be nice to have kind of a readline-based REPL, where you directly interact with one device. I could even imagine an ncurses-alike interface (such as htop is presenting) for showing the signal strength of devices in vincinity.

Please use under the terms of the MIT license. As always, I welcome any form of contribution.