Wednesday, May 21, 2014

Ubertooth Mac Installation Notes

Installation notes for the Ubertooth Bluetooth test tool on Mac OS X 10.9.3.

Installation was strait forward with a glitch or two from the description described on the Ubertooth site, so I've documented the process here for my own notes.

Project site:

Note the wiki:

Getting started URL:

With some help from the troubleshooting guide, here:

Get PySide & QT if you want to run the spectrum analyzer demo:

Install Brew the Mac package manager if you don't yet have it:

ruby -e "$(curl -fsSL"

Brew installation failed, so I (hesitatingly) changed /usr/local permissions:
sudo chowbn -R j2:admin /usr/local
Install prerequisites:
brew install libusb wget cmake
...including PyUSB:
wget -O pyusb-1.0.0b1.tar.gz
tar xvf pyusb-1.0.0b1.tar.gz
cd pyusb-1.0.0b1
sudo python install
The next step of installing libbtbb failed because a missing package:
brew install pkg-config
then libbtbb still couldn't install correctly, because of the failed partial installation. Uninstalling, didn't work, but manually removing the files from /usr/local/lib and the header file btbb.h in /usr/local/include. worked.

I was then able to install libbtbb:
wget -O libbtbb-2014-02-R2.tar.gz
tar xf libbtbb-2014-02-R2.tar.gz
cd libbtbb-2014-02-R2
mkdir build
cd build
cmake ..
sudo make install
Then, I was able to continue with the installation as described on Ubertooth site:
wget -O ubertooth-2014-02-R2.tar.gz
tar xf ubertooth-2014-02-R2.tar.gz
cd ubertooth-2014-02-R2/host
mkdir build
cd build
cmake ..
sudo make install
Then upgrade firmware of device. Mine shipped with a previous version of the firmware. So using the firmware provided in the source tree, and following these directions, this worked for me.

$ubertooth-util -v
    Firmware revision: 2012-10-R1

$cd ubertooth-2014-02-R2/ubertooth-one-firmware-bin

$ ubertooth-dfu --write bluetooth_rxtx.dfu
    Checking firmware signature
    No DFU devices found - attempting to find Ubertooth devices

    1) Found 'Ubertooth One' with USB ID: 1d50:6002

    Select a device to flash (default:1, exit:0):
    Write complete
$ ubertooth-dfu --detach
    Detached$ ubertooth-util -v
    Firmware revision: 2014-02-R2
$ ubertooth-util -V
    ubertooth 2014-02-R2 (dominicgs@mercury) Thu Feb 20 13:28:01 GMT 2014


  1. CMake Error at CMakeLists.txt:24 (find_package):
    By not providing "FindBTBB.cmake" in CMAKE_MODULE_PATH this project has
    asked CMake to find a package configuration file provided by "BTBB", but
    CMake did not find one.

    Could not find a package configuration file provided by "BTBB" with any of
    the following names:


    Add the installation prefix of "BTBB" to CMAKE_PREFIX_PATH or set
    "BTBB_DIR" to a directory containing one of the above files. If "BTBB"
    provides a separate development package or SDK, be sure it has been

  2. Thanks for posting these notes, John! I found these notes very helpful; you saved me a ton of troubleshooting time during my own build.

    Did you run into a problem further on with the BTBB PATH variable assignments? Know how to get past this one by any chance? I've tried a couple things, but it seems more difficult than a simple Unix $PATH extension.

  3. internet recovery how to update efi firmware bios for Mac
    This an answer