Skip to content

Commit

Permalink
release: 2018-06-R1 -- new BLE sniffing engine
Browse files Browse the repository at this point in the history
  • Loading branch information
mikeryan committed Jun 26, 2018
1 parent 5441b44 commit 630c4d9
Show file tree
Hide file tree
Showing 4 changed files with 46 additions and 24 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@ 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](https://github.com/greatscottgadgets/ubertooth/releases/tag/2017-03-R2).
The latest release is [2018-06-R1](https://github.com/greatscottgadgets/ubertooth/releases/tag/2018-06-R1).
The latest firmware build can be found on the release page.

This release is paired with [libbtbb 2017-03-R2](https://github.com/greatscottgadgets/libbtbb/releases/tag/2017-03-R2).
This release is paired with [libbtbb 2018-06-R1](https://github.com/greatscottgadgets/libbtbb/releases/tag/2018-06-R1).

Instructions for flashing the firmware can be found [on the corresponding Wiki page](https://github.com/greatscottgadgets/ubertooth/wiki/Firmware).
Instructions for building libbrbb can be found [on the corresponding Wiki page](https://github.com/greatscottgadgets/ubertooth/wiki/Build-Guide).
Expand Down
11 changes: 11 additions & 0 deletions changelog
Original file line number Diff line number Diff line change
@@ -1,3 +1,14 @@
ubertooth (2018-06-R1) unstable; urgency=low
* Brand new LE sniffing engine
* Support for partial channel maps and channel map updates during connection
* Support for connection updates has been lost, but will be re-added in a
future release
* Packet filtering with ubertooth-btle -t will filter advertising packets in
addition to connections
* USB API version bumped to 1.03

-- Mike Ryan <[email protected]> 26 Jun 2018 13:05:00 -0700

ubertooth (2017-03-R2) unstable; urgency=low
* USB API versioning - We have added USB API versioning to improve the
experience of failures due to mismatched firmware and host code. You may
Expand Down
4 changes: 2 additions & 2 deletions host/cmake/set_release.cmake
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
# tagged

if(NOT DEFINED RELEASE_STRING)
set(LATEST_RELEASE "2017-03-R2")
set(LATEST_RELEASE "2018-06-R1")

execute_process(
COMMAND git log -n 1 --format=%h
Expand All @@ -32,4 +32,4 @@ if(NOT DEFINED RELEASE_STRING)
endif()
set(RELEASE_STRING "git-${GIT_VERSION}${DIRTY_FLAG}")
endif (GIT_EXIT_ERROR)
endif(NOT DEFINED RELEASE_STRING)
endif(NOT DEFINED RELEASE_STRING)
51 changes: 31 additions & 20 deletions tools/RELEASENOTES
Original file line number Diff line number Diff line change
@@ -1,31 +1,42 @@
Ubertooth 2017-03-R2 Release Notes
Ubertooth 2018-06-R1 Release Notes
==============================
The Ubertooth host utilities in this release require libbtbb-2017-03-R2
(https://github.com/greatscottgadgets/libbtbb/releases/tag/2017-03-R2) or
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
-------
**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
https://github.com/greatscottgadgets/ubertooth/wiki/Firmware
A release archive with precompiled firmware is available from
https://github.com/greatscottgadgets/ubertooth/releases/download/2017-03-R2/ubertooth-2017-03-R2.tar.xz

**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.
**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.

**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.
**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.

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.
**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
-------
Expand Down

0 comments on commit 630c4d9

Please sign in to comment.