C++ tinyb_hci: Working HCIScanner showing AD packets, demonstrating new HCI classes

See scripts/build-x86_64.sh and README.md for build instructions.
See scripts/run-hci_scanner.sh to start new HCI scanner (C++).

New HCI C++ implementation redised in libtinyb_hci.so w/o GLIB/DBus dependencies,
but 'libbluetooth.so' dependency.

Following Class datastructures are complete:

- HCIUtil: Exception types, uint128_t and endian conversions

- General UUID interface and its efficient UUID16, UUID32 + UUID128 implementation.
  Conversion 'toString', respecting endianess,
  and UUID* -> UUID128 conversion.

  Requird member comparison operations due to using interface

- HCIAdapter with its opened HCISession,
  as well as its discovered HCIDevices

- HCIAdapter discover includes multiple advertising AD records,
  up to 25 according to the spec.

- HCIAdapter parses full AD segment. TODO: Handle few more AD types

API/Impl Details:

- Datastructures utilize 'vector<shares_ptr<T>>' collections.

- Most attributes are specified 'const' -> immutable for efficancy

- Convenient collection access member operations

- etc ..

RESULTS:

- Fast AD scanning of multiple devices w/ UUID and RSSI

- Proper integration into tinyb project

TODO:

- Handle few more AD types

- Test multiple parallel HCISession from HCIAdapter

- HCIAdapter.connect()

- Represent GATT Service, Characteristics and Description

- Catch up with the Java binding step by step

1 files changed, 231 insertions, 0 deletions

diff --git a/java/tinyb/hci/HCIDevice.java b/java/tinyb/hci/HCIDevice.java
new file mode 100644
index 00000000..b9a41a53
--- /dev/null
+++ b/java/tinyb/hci/HCIDevice.java
@@ -0,0 +1,231 @@
+/**
+ * Author: Sven Gothel <[email protected]>
+ * Copyright (c) 2020 Gothel Software e.K.
+ * Copyright (c) 2020 ZAFENA AB
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package tinyb.hci;
+
+import java.util.List;
+import java.util.Map;
+
+import org.tinyb.BluetoothDevice;
+import org.tinyb.BluetoothException;
+import org.tinyb.BluetoothGattService;
+import org.tinyb.BluetoothManager;
+import org.tinyb.BluetoothNotification;
+import org.tinyb.BluetoothType;
+
+import tinyb.dbus.DBusObject;
+
+public class HCIDevice extends HCIObject implements BluetoothDevice
+{
+    private final HCIAdapter adapter;
+    private final String address;
+    private final String name;
+
+    /* pp */ HCIDevice(final HCIAdapter adptr, final String address, final String name)
+    {
+        super(compHash(address, name));
+        this.adapter = adptr;
+        this.address = address;
+        this.name = name;
+    }
+
+    @Override
+    public boolean equals(final Object obj)
+    {
+        if (obj == null || !(obj instanceof HCIDevice)) {
+            return false;
+        }
+        final HCIDevice other = (HCIDevice)obj;
+        return address.equals(other.address) && name.equals(other.name);
+    }
+
+    @Override
+    public String getAddress() { return address; }
+
+    @Override
+    public String getName() { return name; }
+
+    @Override
+    public BluetoothType getBluetoothType() { return class_type(); }
+
+    @Override
+    public native HCIDevice clone();
+
+    static BluetoothType class_type() { return BluetoothType.DEVICE; }
+
+    @Override
+    public BluetoothGattService find(final String UUID, final long timeoutMS) {
+        final BluetoothManager manager = HCIManager.getBluetoothManager();
+        return (BluetoothGattService) manager.find(BluetoothType.GATT_SERVICE,
+                null, UUID, this, timeoutMS);
+    }
+
+    @Override
+    public BluetoothGattService find(final String UUID) {
+        return find(UUID, 0);
+    }
+
+    /* D-Bus method calls: */
+
+    @Override
+    public native boolean disconnect() throws BluetoothException;
+
+    @Override
+    public native boolean connect() throws BluetoothException;
+
+    @Override
+    public native boolean connectProfile(String arg_UUID) throws BluetoothException;
+
+    @Override
+    public native boolean disconnectProfile(String arg_UUID) throws BluetoothException;
+
+    @Override
+    public boolean pair() throws BluetoothException
+    { throw new UnsupportedOperationException(); } // FIXME
+
+     @Override
+    public native boolean remove() throws BluetoothException;
+
+    @Override
+    public boolean cancelPairing() throws BluetoothException
+    { throw new UnsupportedOperationException(); } // FIXME
+
+    @Override
+    public native List<BluetoothGattService> getServices();
+
+    /* D-Bus property accessors: */
+
+    @Override
+    public String getAlias() { return null; } // FIXME
+
+    @Override
+    public void setAlias(final String value)
+    { throw new UnsupportedOperationException(); } // FIXME
+
+    @Override
+    public native int getBluetoothClass();
+
+    @Override
+    public native short getAppearance();
+
+    @Override
+    public native String getIcon();
+
+    @Override
+    public native boolean getPaired();
+
+    @Override
+    public native void enablePairedNotifications(BluetoothNotification<Boolean> callback);
+
+    @Override
+    public native void disablePairedNotifications();
+
+    @Override
+    public native boolean getTrusted();
+
+    @Override
+    public native void enableTrustedNotifications(BluetoothNotification<Boolean> callback);
+
+    @Override
+    public native void disableTrustedNotifications();
+
+    @Override
+    public native void setTrusted(boolean value);
+
+    @Override
+    public native boolean getBlocked();
+
+    @Override
+    public native void enableBlockedNotifications(BluetoothNotification<Boolean> callback);
+
+    @Override
+    public native void disableBlockedNotifications();
+
+    @Override
+    public native void setBlocked(boolean value);
+
+    @Override
+    public native boolean getLegacyPairing();
+
+    @Override
+    public native short getRSSI();
+
+    @Override
+    public native void enableRSSINotifications(BluetoothNotification<Short> callback);
+
+    @Override
+    public native void disableRSSINotifications();
+
+    @Override
+    public native boolean getConnected();
+
+    @Override
+    public native void enableConnectedNotifications(BluetoothNotification<Boolean> callback);
+
+     @Override
+    public native void disableConnectedNotifications();
+
+    @Override
+    public native String[] getUUIDs();
+
+    @Override
+    public native String getModalias();
+
+    @Override
+    public native HCIAdapter getAdapter();
+
+    @Override
+    public native Map<Short, byte[]> getManufacturerData();
+
+    @Override
+    public native void enableManufacturerDataNotifications(BluetoothNotification<Map<Short, byte[]> > callback);
+
+    @Override
+    public native void disableManufacturerDataNotifications();
+
+
+    @Override
+    public native Map<String, byte[]> getServiceData();
+
+    @Override
+    public native void enableServiceDataNotifications(BluetoothNotification<Map<String, byte[]> > callback);
+
+    @Override
+    public native void disableServiceDataNotifications();
+
+    @Override
+    public native short getTxPower ();
+
+    @Override
+    public native boolean getServicesResolved ();
+
+    @Override
+    public native void enableServicesResolvedNotifications(BluetoothNotification<Boolean> callback);
+
+    @Override
+    public native void disableServicesResolvedNotifications();
+
+    private native void delete();
+}