Want to take your software engineering career to the next level? Join the mailing list for career tips & advice Click here

ubertooth

Software, firmware and hardware designs for Ubertooth

Subscribe to updates I use ubertooth


Statistics on ubertooth

Number of watchers on Github 773
Number of open issues 78
Average time to close an issue 13 days
Main language KiCad
Average time to merge a PR 3 days
Open pull requests 6+
Closed pull requests 7+
Last commit over 2 years ago
Repo Created about 7 years ago
Repo Last Updated over 2 years ago
Size 6.76 MB
Organization / Authorgreatscottgadgets
Latest Release2017-03-R2
Contributors25
Page Updated
Do you use ubertooth? Leave a review!
View open issues (78)
View ubertooth activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Software engineers: It's time to get promoted. Starting NOW! Subscribe to my mailing list and I will equip you with tools, tips and actionable advice to grow in your career.
Evaluating ubertooth for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Ubertooth

Project Ubertooth is an open source wireless development platform suitable for Bluetooth experimentation. Ubertooth ships with a capable BLE (Bluetooth Smart) sniffer and can sniff some data from Basic Rate (BR) Bluetooth Classic connections.

The latest release is 2017-03-R2. The latest firmware build can be found on the release page.

This release is paired with libbtbb 2017-03-R2.

Instructions for flashing the firmware can be found on the corresponding Wiki page. Instructions for building libbrbb can be found on the corresponding Wiki page.

History

The first hardware revision is called Ubertooth Zero and was demonstrated at ToorCon 12 on October 24th, 2010. Ubertooth Zero has been superseded.

The current hardware revision is called Ubertooth One and was demonstrated at ShmooCon 7 on January 29th, 2011.

More Info

Additional documentation can be found in README files within the various subdirectories and on the web site in the web directory or at the URL below.

project site

Ubertooth GitHub

Contributors

  • Michael Ossmann
  • Dominic Spill
  • Mike Ryan
  • Will Code
  • Jared Boone
  • Many others
ubertooth open issues Ask a question     (View All Issues)
  • almost 4 years Sniffer does not return to correct channel in ubertooth-btle -f
  • almost 4 years Client plugin not showing as option in Kismet
  • almost 4 years Ubertooth-blte -I (interfere command)
  • almost 4 years ubertooth-rx LAPs do not match addresses in bluetoothctl scans
  • almost 4 years USB packet buffer overflow
  • almost 4 years Unable to sniff from hm10
  • about 4 years cb_rx clock trimming
  • about 4 years cb_rx of ubertooth_callback.c
  • about 4 years ubertooth-rx: no more than a few packets are decoded after CLK is calculated
  • about 4 years (BLE) Transmitting data larger than 16-byte in le_transmit() does not work correctly
  • about 4 years uh oh, full_usb_buf not emptied
  • about 4 years Kismet not capturing packets
  • about 4 years Ubertooth Writing Wrong Times into PCAP files
  • about 4 years Unable to sniff the pairing request of the mobile devices having BT version of 4.0
  • about 4 years Facing problem with capturing traffic of ble with wireshark
  • about 4 years Little Firmware errors...
  • about 4 years Ubertooth-scan
  • about 4 years Gerber files
  • about 4 years Wireshark complains pcapbtbb file is Malformed
  • about 4 years USB_claim_interface_error -6
  • over 4 years Improve handling of firmware version mismatch
  • over 4 years Bluetooth BLE Capture errors
  • over 4 years Error with Ubertooth One #121a
  • over 4 years Writting my own code
  • over 4 years Hopping sequence calculated causes RAM leak in Kismet
  • over 4 years ubertooth-rx PCAPNG bug
  • over 4 years uap confidence issues
  • over 4 years 2015-10-R1 Ubertooth-rx captures too few packets
  • over 4 years ubertooth-follow libUSB Error: Timeout: (-7)
  • over 4 years Getting RSSI with ubertooth-btle
ubertooth open pull requests (View All Pulls)
  • Added manually created BOM with prices from mouser and updated components
  • Fix the bug that prevents ubertooth-rx from following
  • BLE adv channel
  • make ubertooth-follow use the new modular design
  • rssi: calculate signal and noise in firmware
  • Added hint in README for library not found issue
ubertooth list of languages used
ubertooth latest release notes
2017-03-R2 2017-03-R2

Ubertooth 2017-03-R2 Release Notes

The Ubertooth host utilities in this release require libbtbb-2017-03-R2 or greater.

Changes

USB API versioning - We have added USB API versioning to improve the experience of failures due to mismatched firmware and host code. You may find that Ubertooth tools complain that your firmware is out of date. Updating firmware is simple and reliable, please follow the instructions on the wiki. A release archive with precompiled firmware is available.

Documentation - We have man pages! All of the Ubertooth tools have had a refresh of their arguments and we have written documentation for each tool which will be installed in the form of man pages. Thanks to Mike Ryan for driving this.

Basic Rate PCAP output - the pcap file produced by the Ubertooth tools should all be read by the latest Wireshark versions without the need to install plugins.

Kismet plugins - Kismet is currently under heavy development and it has not been possible to continue tracking the master branch. The legacy Kismet plugins should continue to work, but we will wait to track git master until development has stabalised.

This release rolls up a lot of bug fixes, code tidying efforts, and small enhancements, for a complete list of changes since the previous release, see the git commit log.

Support

Build instructions are available from the wiki

As always, support is available via the Ubertooth-general mailing list or IRC. Issues can also be reported via the GitHub issue tracker and pull requests are always welcome.

Checksums

sha256sum ubertooth-2017-03-R2.tar.xz fbf83fc0129cb9a4e2df614b19fce8ea73419d1a01831142987d25148a9bcd00

sha512sum ubertooth-2017-03-R2.tar.xz 4806a6ac664ec9b78964caeb47f87a60db8f664c529e6e58bc1e5db4d858eaaa1ae51f0293f4a5227a102e556caf1611e97f6675147af4bc34e23646049e8571

2017-03-R1 2017-03-R1

Ubertooth 2017-03-R1 Release Notes

The Ubertooth host utilities in this release require libbtbb-2017-03-R1 or greater.

Changes

USB API versioning - We have added USB API versioning to improve the experience of failures due to mismatched firmware and host code. You may find that Ubertooth tools complain that your firmware is out of date. Updating firmware is simple and reliable, please follow the instructions on the wiki. A release archive with precompiled firmware is available.

Basic Rate PCAP output - the pcap file produced by the Ubertooth tools should all be read by the latest Wireshark versions without the need to install plugins.

Kismet plugins - Kismet is currently under heavy development and it has not been possible to continue tracking the master branch. The legacy Kismet plugins should continue to work, but we will wait to track git master until development has stabalised.

This release rolls up a lot of bug fixes, code tidying efforts, and small enhancements, for a complete list of changes since the previous release, see the git commit log.

Support

Build instructions are available from the wiki

As always, support is available via the Ubertooth-general mailing list or IRC. Issues can also be reported via the GitHub issue tracker and pull requests are always welcome.

Checksums

sha256sum ubertooth-2017-03-R1.tar.xz 76ace37e3920c0216b13aa7c0a4c094864262f1054f5ac406beafde954a37726

sha512sum ubertooth-2017-03-R1.tar.xz 546cc84b2c322e48c7a9da5c507b213d7fe6e8c1fefde0404f9bbc1f24675ace7fc831f941f362eca2cf3abefe1d9ba51cb12dd8b7407a59b7560fba8864b268

2015-10-R1 2015-10-R1

Ubertooth 2015-10-R1 Release Notes

The Ubertooth host utilities in this release require libbtbb-2015-10-R1 (https://github.com/greatscottgadgets/libbtbb/releases/tag/2015-10-R1) or greater.

This is a minor bugfix and update release, for a complete list of changes since the previous release, see the git commit log.

  • Update ubertooth-scan to provide more consistent output
  • It is now possible to build receive only firmware
  • Host code versioning is more reliable
  • Python tools now support Python 3. Thanks Hannes!

Build instructions are available from the wiki https://github.com/greatscottgadgets/ubertooth/wiki/Build-Guide

As always, support is available via the Ubertooth-general mailing list or IRC. Issues can also be reported via the GitHub issue tracker and pull requests are always welcome.

Other projects in KiCad