Extracting CHANGES.mdv2.8.1

1 files changed, 226 insertions, 0 deletions

diff --git a/CHANGES.md b/CHANGES.md
new file mode 100644
index 00000000..b3167b6a
--- /dev/null
+++ b/CHANGES.md
@@ -0,0 +1,226 @@
+# Direct-BT LE and BREDR Library
+
+[Original document location](https://jausoft.com/cgit/direct_bt.git/about/).
+
+## Changes
+
+**2.8.1 *Direct-BT* Maturity (Bluetooth LE)**
+
+**2.8.0**
+* Misc cleanup and adoption of jaulib v0.14.0
+* Support Ubuntu 22.04 and 20.04
+* C++: Shorten `is*Set()` -> `is_set()`, fix test requiring all bits set to `bit == ( mask & bit )`
+* Fix bringup tests (C++, Java): They run w/o elevated permissions, hence don't toggle state and require nothing
+
+**2.7.0**
+* `AdapterstatusListener::deviceFound()` is only called if not already connected and if initially found.
+* Use `noexcept` where possible
+  - `BTGattHandler::send*()`
+  - `BTGattHandler::GattServerHandler`, `BTGattChar`,  `BTGattDesc`
+* BTManager is passed as `shared_ptr<BTManager>`, aligning with JNI lifecycle
+* AdapterStatusListener, BTGattCharListener: Adopt full Java/Native link via DBTNativeDownlink and JavaUplink, clean API, impl and lifecycle
+* Robustness of JNI
+  - Passing `trial.org.direct_bt.TestDBTProvokeClientServer_i470` w/o crash
+  - Use `std::shared_ptr<T>` instead of a `naked pointer` for sane lifcycle, see new `shared_ptr_ref<T>`.
+
+**2.6.5**
+* Fix several memory leaks and uninitialized fields using valgrind analysis (native and w/ JVM)
+  - BTGattHandler::disconnect(): Check weak BTDevice before using resources
+  - BTGattHandler::l2capReaderEndLocked(): Remove off-thread BTDevice::disconnect() on io-error, use BT host's disconnect (simplify tear down)
+  - BTGattHandler's l2capReader data race (use after free)
+* Trial `TestDBClientServer1*` test changes
+  - Split tests into NoEnc, SC0 and SC1 classes
+  - Have client/server adapter names unique, allowing multi-machine testing in one room
+* Bump jaulib v0.8.0
+* BTAdapter Server: Offload waiting for L2CAP client connection to BTDevice::processL2CAPSetup() dedicated thread
+* [L2CAP, HCI]Comm: Hold external interrupted delegate from `service_runner` for complete interrupted() query
+* WIP: BTAdapter::startDiscovery(): Retry up to `MAX_BACKGROUND_DISCOVERY_RETRY` (3), mitigating failure to start discovery
+* BTDevice::notifyLEFeature(): Remove HCIStatusCode param and only call with SUCCESS status code
+* Fix and [document default connection paramter](doc/Connection_Parameter.md), leaning to the higher performance side
+* Resolve legacy security (SC 0) BlueZ/Kernel Mgmt LTK role of `master` or `initiator` field
+
+**2.6.3**
+* Have trial `TestDBClientServer1*` test in both client/server directions, legacy and secure connections (SC)
+* Fix BTAdapter's server mode key handling
+* Have failed pairing issue disconnect, posting indicative reason
+* Use global `inline constexpr` instead of `#define` macros
+* Bump jaulib v0.7.14
+
+**2.6.2**
+* Adopt jaulib detailed git version info: Using post-tag `VERSION_COMMITS` and `VERSION_SHA1_SHORT`. `VERSION_LONG` reflects post-tag and dirty.
+* Bump jaulib v0.7.12-1
+* Added *online* unit testing using actual BT adapter, testing *client* with *server* functionality.
+* BTAdapter/HCIHandler: Fix advertising state: Active until either disabled or connected.
+* DBTAdapter: Fix removeAllStatusListener(): Re-add internal listener to maintain functionality.
+* GATT Server enhancements, incl new DBGattServer::Mode and `dbt_repeater00` implementation.
+* BTDevice::getGattServices(): MTU and remote GATT Services shall be processed from here at request only, moved from BTDevice::connectGATT().
+* jaulib v0.7.11 fixes 
+* JNI `DBGatt[Server|Service|Char]_ctorImpl()` fix for 32-bit platforms
+* BlueZ/Linux >= 5.13 (?) Bug Workaround on 'set_local_name(..)'
+
+**2.5.4**
+* Fixing clang++ 11.0.1 and g++ 8.3.0 compilation issues
+* Refine BTAdapter API on commands in powerd-off state only: `setName()`, `setSecureConnections()`, `setDefaultConnParam()`
+* Proper definition of `BTDevice::getName()`
+* Expose refined EInfoReport via `BTDevice::getEIR()` and use it in `BTAdapter::startAdvertising()`
+* Add `DBGattServer::Listener::write[Char|Desc]ValueDone()` callback
+* Add and use `[BTAdapter|BTManager]::setDefaultConnParam(..)` essential in server mode
+* Consolidated `BTDevice::setConnSecurity*(..)` and added `BTAdapter::setServerConnSecurity(...)`
+* Server fixes GATT sendNotification/Indication, `BTDevice::connectGATT()`, `AttReadNRsp`.
+* Server adding proper `AttErrorRsp` replies and supporting `AttFindByTypeValueReq/Rsp`.
+* Server: Using L2CapServer socket/accept services while in advertising mode.
+* Reuse `jau::service_runner`, replacing code duplication 
+* Enhance SMP and key managment, LTK validation
+* jaulib v0.7.9 fixes 
+
+**2.5.2**
+
+* jaulib v0.7.5 fixes 
+
+**2.5.1**
+
+* `BTAdapter::pausing_discovery_devices`: Use `std::weak_ptr<BTDevice>` list
+* Add `BTAdapter::removeDevicePausingDiscovery()` and `getCurrentDiscoveryPolicy()`
+* DBTAdapter.cxx: Fix AdapterStatusListener.discoveringChanged(..) signature
+* Add BTObject::checkValid() implementation overriding jau:JavaUplink, to actually validate whether instance is still valid.
+
+**2.5.0**
+
+* Added *DiscoveryPolicy*, allowing fine tuned discovery keep-alive policy
+  and covering HCI host OS's implied discovery turn-off when connected (BlueZ/Linux).
+  API change of `BTAdapter::startDiscovery(..)` and `AdapterStatusListener::discoveringChanged(..)`
+* BTDevice::connectGATT(): Discover GATT services and parse GenericAccess ASAP before `AdapterStatusListener::deviceReady()`
+* SMPKeyBin::createAndWrite(..): Drop 'overwrite' argument as we shall set `overwrite = PairingMode::PRE_PAIRED != device.getPairingMode()`
+* Fix *PRE_PAIRED* mode for !SC (legacy): Master needs to upload init LTK 1st, then responder LTK (regression)
+* Robustness: Reader-Callback Shutdown after 8s and use SC atomic for state
+* BTAdapter::startDiscovery(..): Add 'bool filter_dup=true' as last parameter
+* Unlock mutex before `notify_all` to avoid pessimistic re-block of notified `wait()` thread
+
+**2.4.0**
+
+* Completed Java support for LE slave/server (*peripheral*) mode incl *GATT-Server*.
+* Add `BTAdapter's Slave Peripheral SMP Key Management`
+  - Full SMP key persistence in *peripheral* mode
+* Reshape *SMPKeyBin* design: Set and upload from BTDevice (split functionality), v5.
+* BTDevice::unpair() is now issued directly by *Direct-BT*
+  to have a consistent and stable security workflow:
+  - when a BTRole::Slave BTDevice is discovered, see AdapterStatusListener::deviceFound().
+  - when a BTRole::Slave BTDevice is disconnected, see AdapterStatusListener::deviceDisconnected().
+  - when a BTRole::Master BTDevice gets connected, see AdapterStatusListener::deviceConnected().
+* LE slave/server mode (*peripheral*): 1st Milestone
+  - BTRole separation implemented and tested
+  - Advertising implemented and tested
+  - GATT Server implemented and tested
+  - Slave / Server SMP Security implemented and testing
+* SMPKeyBin v4, added localAddress (adapter) to filename + bin-fmt.
+* Simplified `SMP*Key` class names and `set[Default|Connected]LE_PHY()` args.
+* Added EUI48 endian conversion when passing/receiving to Bluetooth
+* Passed validation of [multiple BT5 adapter](doc/adapter/adapter.md).
+* Fixed `EInfoReport::read_[ext_]ad_reports()` multiple reports 
+* Added Link-Key support in our SMP processing and SMPKeyBin, supporting non-legacy SC.
+* Aligned `BTGatt* findGatt*()` methods across Java/C++
+* Moved `EUI48`, `EUI48Sub` (C++/Java) and `uuid_t`, `Octets` (C++) to `jaulib` for general use.
+* Added BTRole and GATTRole for full master/client and slave/server support.
+* Added BTAdapter advertising support
+* Only use and program selected BTAdapter via BTAdapter::initialize() (required now)
+  - Supports using multiple applications, each using one adapter, or
+  - One application using multiple adapter for different tasks and BTRole
+
+**2.3.0**
+
+* Removal of *TinyB*
+
+**2.2.14**
+
+* Bluetooth 5.0 Support
+  - Using HCI extended scanning and connecting if supported (old API may not work on new adapter)
+  - Parsing and translating extended and enhanced event types, etc
+  - TODO: User selection of `LE_2M` and `L2_CODED`, ... ???
+
+**2.2.13**
+
+* Revised API: BTGattChar::addCharListener(..) in C++ and Java for a more intuitive use.
+* Fix EUI48Sub::scanEUI48Sub(..): Fail on missing expected colon, i.e. after each two digits
+* Fix JNIAdapterStatusListener::deviceConnected(..): NewObject(.., deviceClazzCtor, ..) used wrong argument order
+
+**2.2.11**
+
+* Fix EUI48 unit test and refine on application permissions for launching applications 
+* Make `BTDeviceRegistry` and `BTSecurityRegistry` universal
+* Move `BTDeviceRegistry` and `BTSecurityRegistry` to `direct_bt` library (from examples)
+* EUI48Sub: Complement with `hash_code()`, `clear()`, `indexOf()`, `contains()`, ...
+* SMPKeyBin: Tighten constraints, `readAndApply(..)` must validate `minSecLevel`.
+* `BTAdapter::mgmtEvDeviceFoundHCI(..)`: Clarify code path, covering name change via AD EIR.
+* Passthrough all paramter `BTAdapter::startDiscovery(..)` -> `HCIHandler::le_set_scan_param(..)`: Add `le_scan_active` and `filter_policy`. 
+  Active scanning is used to gather device name in discovery mode (AD EIR).
+* Add `-dbt_debug` argument for AD EIR `direct_bt.debug.hci.scan_ad_eir` and parse EIR GAPFlags
+* Fix BTGattHandler: Gather all Descriptors from all Characteristics (only queried 1st Char.)
+* SMPKeyBin's base filename compatibility with FAT32 Long Filename (LFN)
+
+**2.2.5**
+
+* Complete SMPKeyBin user API: Convenient static 'one shot' entries + support no-encryption case
+* Fix leaked AdapterStatusListener
+* Fixed HCIHandler and l2cap related issues
+* Unified free function to_string(..) and member toString()
+* Tested key regeneration use-case: Pairing failure (bad key), key removal and auto security negotiation.
+* Adding SMPKeyBin file removal support.
+* Tested negative passkey/boolean input, requested via auto security negotiation. 
+* Using negative passkey response via `setPairingPasskey(passkey = 0)` for performance.
+
+**2.2.4**
+
+* Providing full featured `SMPKeyBin` for LTK, CSRK and secure connection param setup persistence and upload.
+* Added Auto Security mode, negotiating the security setup with any device.
+* Bugfixes in HCIHandler and ACL/SMP packet processing.
+* Enhanced robusteness of underlying C++ API and implementation.
+
+**2.2.00**
+
+* Kicked off junit testing for Java implementation
+* Adding *direct_bt-fat.jar* (fat jar) bootstrapping its contained native libraries using merged-in `jaulib`.
+* Java API renaming, incl package: *org.tinyb* to *org.direct_bt*.
+* Completing SMP/Security implementation (WIP)
+* Replaced std::vector and jau::cow_vector with jau::darray and jau::cow_darray
+
+**2.1.33**
+
+* Added AdapterStatusListener callback methods devicePairingState(..) and deviceReady(..), supporting security/pairing. 
+* Added support for *LE Secure Connections* and *LE legacy pairing* utilizing SMP and BlueZ/Kernel features.
+* Exposing BTSecurityLevel and SMPIOCapability for connection oriented security setup on BlueZ/Kernel, see DBTDevice and BluetoothDevice.
+* Covering SMP over L2CAP messaging via SMPPDUMsg types and retrieval via HCI/ACL/L2CAP on BlueZ/Kernel
+
+**2.1.30**
+
+* Use read lock-free jau::cow_vector for all callback-lists, avoiding locks in callback iteration
+* Passed GCC all warnings, compile clean
+* Passed GCC sanitizer runtime checks
+* Using extracted *Jau C++ Support Library*, enhanced encapsulation
+* Passed valgrind's memcheck, helgrind and drd validating no memory leak nor data race or deadlock using dbt_scanner10
+* Added native de-mangled backtrace support using *libunwind* and and *abi::__cxa_demangle*
+* Reaching robust implementation state of *Direct-BT*, including recovery from L2CAP transmission breakdown on Raspberry Pi.
+* Resolved race conditions on rapid device discovery and connect, using one thread per device.
+* API documentation with examples
+* Tested on GNU/Linux x86_64, arm32 and arm64 with native and Java examples.
+* Tested on Bluetooth Adapter: Intel, CSR and Raspberry Pi
+* Almost removed non-standard *Linux/BlueZ-Mngr* kernel dependency using the universal HCI protocol, remaining portion configures the adapter.
+
+**2.0.0**
+
+* Java D-Bus implementation details of package 'tinyb' moved to *tinyb.dbus*.
+* The *tinyb.jar* jar file has been renamed to *tinyb2.jar*, avoiding conflicts.
+* General interfaces matching the original implementation and following [BlueZ API](http://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/device-api.txt)
+were created in package *org.tinyb*.
+* Class *org.tinyb.BluetoothFactory* provides a factory to instantiate the initial root *org.tinyb.BluetoothManager*, either using the original D-Bus implementation or an alternative implementation.
+* C++ namespace and implementation kept unchanged.
+
+**0.5.0**
+
+* Added notifications API
+* Capitalized RSSI and UUID properly in Java
+* Added JNI Helper classes for managing lifetime of JNIEnv and Global Refences
+
+**0.4.0**
+
+* Added asynchronous methods for discovering BluetoothObjects
+