ubertooth-util - Man Page

general purpose Ubertooth utility


ubertooth-util [-abcdefghijk-ellemenop-qrstuvwxyZ]


ubertooth-util(1) is a catch-all tool for doing generally useful things with, to, and about Ubertooth. To get firmware revision and compile information, run:

ubertooth-util -vV

To fully reset Ubertooth, run:

ubertooth-util -r

Other options are available for modifying LED states, setting channel, and performing miscellaneous radio-related actions. Refer to the [Options][] section for full details.

The utility also includes a simple range test tool for use with two Uberteeth. Refer to [Range Test][] for full details.


Common options:

Radio options:

Range test:


Range Test

Using two Uberteeth it is possible to perform a range test. One Ubertooth acts as a repeated by running:

ubertooth-util -e

A second Ubertooth (the sender) initiates the range test by running:

ubertooth-util -n

During the range test the sender Ubertooth will transmit data packets at increasing power level, listening for repeats from the repeater Ubertooth. The receiving Ubertooth will validate that the received data was not corrupted in flight.

The range test results can be displayed on the sender Ubertooth's system by running:

ubertooth-util -m

Note that the range test transmits the Cortex M3 microcontroller's serial number. If you do not wish to broadcast that information wirelessly, do not use the range test functionality.

See Also

ubertooth(7): overview of Project Ubertooth


This manual page was written by Mike Ryan.

Referenced By


March 2017 Project Ubertooth