diff --git a/README.md b/README.md index 29a766a9..829e8777 100644 --- a/README.md +++ b/README.md @@ -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). diff --git a/changelog b/changelog index cce1d74a..447b6a63 100644 --- a/changelog +++ b/changelog @@ -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 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 diff --git a/host/cmake/set_release.cmake b/host/cmake/set_release.cmake index 7acac035..39851e86 100644 --- a/host/cmake/set_release.cmake +++ b/host/cmake/set_release.cmake @@ -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 @@ -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) \ No newline at end of file +endif(NOT DEFINED RELEASE_STRING) diff --git a/tools/RELEASENOTES b/tools/RELEASENOTES index 36e103a4..2b4adaad 100644 --- a/tools/RELEASENOTES +++ b/tools/RELEASENOTES @@ -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 -------