2020-12-R1 - the Christmas release

Ubertooth 2020-12-R1 Release Notes

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

Changes

Bluetooth classic sniffing and link layer - An entirely new firmware
built specifically for sniffing classic Bluetooth connections. Also contains
code to act as a basic classic Bluetooth device, including l2ping, inquiry
scanning, and page scanning. Check out ubertooth-btbr and the
corresponding firmware/btbr directory. Many thanks to @eti1 for this.

Christmas lights - Check out ubertooth-util -x for a holiday light
display that's sure to put a seasonal smile on your face.

Python 3 - A long time coming, Ubertooth and libbtbb finally support
Python 3. All aspects of this release, including the spectrum analyzer
GUI, should work on all modern distros.

Bug fixes - ubertooth-btle should no longer freeze in areas of
heavy traffic. Time discontinuities in PCAP files are no longer present.
Finally ubertooth-btle's faux slave mode now supports packets longer
than 32 bytes. Thanks to @dor-zusman for the last one.

USB API version - As with the previous release, we are using USB API
versioning to improve the experience of failures due to mismatched
firmware and host code. As of this release, the USB API has been bumped
to 1.07. If the Ubertooth tools complain that your firmware is out of
date, please update your firmware. Updating firmware is simple and
reliable, please follow the instructions on the wiki
https://github.com/greatscottgadgets/ubertooth/wiki/Firmware
A release archive with precompiled firmware is available from
https://github.com/greatscottgadgets/ubertooth/releases/download/2020-12-R1/ubertooth-2020-12-R1.tar.xz

Support

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.

2018-12-R1 - the Uberducky release

Ubertooth 2018-12-R1 Release Notes

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

Changes

Uberducky triggering - Uberducky is a new project built on Ubertooth
hardware that acts like a USB Rubber Ducky. You can use a second
Ubertooth to trigger it to inject keystrokes using the ubertooth-ducky
command. See the Uberducky repo
for more info.

Spectrum Analyzer UI improvements - Thank you Steven Haussmann and
Andrew Browning!

Bug fixes - Improvements to ubertooth-btle's faux slave mode.

USB API version - As with the previous release, we are using USB API
versioning to improve the experience of failures due to mismatched
firmware and host code. As of this release, the USB API has been bumped
to 1.06. If the Ubertooth tools complain that your firmware is out of
date, please update your firmware. Updating firmware is simple and
reliable, please follow the instructions on the wiki
https://github.com/greatscottgadgets/ubertooth/wiki/Firmware
A release archive with precompiled firmware is available from
https://github.com/greatscottgadgets/ubertooth/releases/download/2018-12-R1/ubertooth-2018-12-R1.tar.xz

Support

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.

2018-08-R1: the DEFCON release

Ubertooth 2018-08-R1 - the DEFCON release

Just in time for DEFCON 26, we're excited to share with you Ubertooth 2018-08-R1.
Read on for the details of this awesome, feature-packed release.

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

Changes

New LE sniffing engine - The BLE sniffing engine has been completely
rewritten using interrupts to drive an event-based core. The new
sniffing engine is considerably more robust than previous versions and
should have a higher packet capture rate. This code has received less
testing than previous versions, but in the experience of the author has
been exceptionally stable and is superior to previous versions in almost
every way.

Partial channel map support - As part of the new BLE sniffing
engine, there is now support for partial channel maps when an LE
connection is established as well as support for the Channel Map Update
Link Layer Procedure. This allows capturing connections from virtually
all modern BLE devices.

Connection update support - Support for Connection Update Link Layer
Procedure has been reimplemented as of this update. This was a feature
degradation in 2018-06-R1 but has been fixed.

Improved filtering - LE filtering now applies to all advertising
packets, not just connections. Packets that do not match the filter are
silently dropped. Filters can include a CIDR-style netmask, allowing as
few as 1 or as many as 48 bits to be included in the BD ADDR filter.

No-follow mode - In LE, it is now a first-class operation to only
log advertising packets (inhibit connection following). The previous
mechanism of using a filter of 00:00:00:00:00:00 is no longer
functional, and this new feature should be used instead.

USB API version - As with the previous release, we are using USB API
versioning to improve the experience of failures due to mismatched
firmware and host code. As of this release, the USB API has been bumped
to 1.05. If the Ubertooth tools complain that your firmware is out of
date, please update your firmware. Updating firmware is simple and
reliable, please follow the instructions on the wiki
https://github.com/greatscottgadgets/ubertooth/wiki/Firmware
A release archive with precompiled firmware is available from
https://github.com/greatscottgadgets/ubertooth/releases/download/2018-08-R1/ubertooth-2018-08-R1.tar.xz

Support

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.

2018-06-R1 -- new BLE sniffing core

Ubertooth 2018-06-R1 Release Notes

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

Changes

New LE sniffing engine - The BLE sniffing engine has been completely
rewritten using interrupts to drive an event-based core. The new
sniffing engine is considerably more robust than previous versions and
should have a higher packet capture rate. This code has received less
testing than previous versions, but in the experience of the author has
been exceptionally stable and is superior to previous versions in almost
every way.

Partial channel map support - As part of the new BLE sniffing
engine, there is now support for partial channel maps when an LE
connection is established as well as support for the Channel Map Update
Link Layer Procedure. This allows capturing connections from virtually
all modern BLE devices.

Feature degradation - Support for Connection Update Link Layer
Procedure has been lost as of this update. This is a relatively rare
occurrence, and it will be added in an upcoming release once it has been
fully debugged. If you encounter a device that uses this feature, please
file a bug on the project as it will help with our implementation
testing.

USB API version - As with the previous release, we are using USB API
versioning to improve the experience of failures due to mismatched
firmware and host code. As of this release, the USB API has been bumped
to 1.03. If the Ubertooth tools complain that your firmware is out of
date, please update your firmware. Updating firmware is simple and
reliable, please follow the instructions on the wiki
https://github.com/greatscottgadgets/ubertooth/wiki/Firmware
A release archive with precompiled firmware is available from
https://github.com/greatscottgadgets/ubertooth/releases/download/2018-06-R1/ubertooth-2018-06-R1.tar.xz

Support

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.

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

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

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.

2015-09-R2

Ubertooth 2015-09-R2 Release Notes

The Ubertooth host utilities in this release require libbtbb-2015-09-R2 or greater.

These are just the highlights, for a complete list of changes since the
previous release, see the git commit log.

• Basic Rate Bluetooth Improvements
  • Stability has improved in performance constrained environments
  • The "uh oh, buffer not emptied" issue no longer causes the tools to loop
    indefinitely
  • AFH support has greatly improved, UAP and CLK values are now found more
    quickly when AFH is used
• Basic Rate PCAP support
  • ubertooth-rx and ubertooth-follow support a new PCAP file format
  • The new PCAP format is also supported with a new Wireshark plugin: btbredr
  • The PCAP format is still in the early stages, but we hope to have the plugin
    included in Wireshark later this year
  • The older btbb format is still produced by the Kismet plugins, they will
    be migrated over to the new format in the next release
• Bluetooth Smart (BLE) Improvements
  • Improved packet reception
  • Promiscuous sniffing mode is more reliable
  • Promiscuous sniffing reports the recovered parameters to the host
• Skateboard Hacking
  • Support for interfering with connections of BLE enabled skateboards
  • ubertooth-ego targets Yuneec E-go (not Bluetooth)
  • Always hack safely and responsibly!

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.

2015-09-R1

Ubertooth 2015-09-R1 Release Notes

The Ubertooth host utilities in this release require libbtbb-2015-09-R1 or greater.

These are just the highlights, for a complete list of changes since the
previous release, see the git commit log.

• Basic Rate Bluetooth Improvements
  • Stability has improved in performance constrained environments
  • The "uh oh, buffer not emptied" issue no longer causes the tools to loop
    indefinitely
  • AFH support has greatly improved, UAP and CLK values are now found more
    quickly when AFH is used
• Basic Rate PCAP support
  • ubertooth-rx and ubertooth-follow support a new PCAP file format
  • The new PCAP format is also supported with a new Wireshark plugin: btbredr
  • The PCAP format is still in the early stages, but we hope to have the plugin
    included in Wireshark later this year
  • The older btbb format is still produced by the Kismet plugins, they will
    be migrated over to the new format in the next release
• Bluetooth Smart (BLE) Improvements
  • Improved packet reception
  • Promiscuous sniffing mode is more reliable
  • Promiscuous sniffing reports the recovered parameters to the host
• Skateboard Hacking
  • Support for interfering with connections of BLE enabled skateboards
  • ubertooth-ego targets Yuneec E-go (not Bluetooth)
  • Always hack safely and responsibly!

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.

2014-04-R1

This is a minor build system change for package maintainers. There are no code changes from 2014-02-R2.