aboutsummaryrefslogtreecommitdiffstats
path: root/java/jau/direct_bt/DBTGattDescriptor.java
diff options
context:
space:
mode:
Diffstat (limited to 'java/jau/direct_bt/DBTGattDescriptor.java')
-rw-r--r--java/jau/direct_bt/DBTGattDescriptor.java171
1 files changed, 171 insertions, 0 deletions
diff --git a/java/jau/direct_bt/DBTGattDescriptor.java b/java/jau/direct_bt/DBTGattDescriptor.java
new file mode 100644
index 00000000..bef26e91
--- /dev/null
+++ b/java/jau/direct_bt/DBTGattDescriptor.java
@@ -0,0 +1,171 @@
+/**
+ * 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 direct_bt.tinyb;
+
+import java.lang.ref.WeakReference;
+import java.util.Arrays;
+
+import org.tinyb.BluetoothException;
+import org.tinyb.BluetoothGattDescriptor;
+import org.tinyb.BluetoothNotification;
+import org.tinyb.BluetoothType;
+
+public class DBTGattDescriptor extends DBTObject implements BluetoothGattDescriptor
+{
+ /** Descriptor's characteristic weak back-reference */
+ final WeakReference<DBTGattCharacteristic> wbr_characteristic;
+
+ /** Type of Descriptor */
+ private final String type_uuid;
+
+ /**
+ * Characteristic Descriptor Handle
+ * <p>
+ * Attribute handles are unique for each device (server) (BT Core Spec v5.2: Vol 3, Part F Protocol..: 3.2.2 Attribute Handle).
+ * </p>
+ */
+ private final short handle;
+
+ private byte[] cachedValue;
+ private BluetoothNotification<byte[]> valueNotificationCB = null;
+
+ private boolean updateCachedValue(final byte[] value, final boolean notify) {
+ boolean valueChanged = false;
+ if( null == cachedValue || cachedValue.length != value.length ) {
+ cachedValue = new byte[value.length];
+ valueChanged = true;
+ } else if( !Arrays.equals(value, cachedValue) ) {
+ valueChanged = true;
+ }
+ if( valueChanged ) {
+ System.arraycopy(value, 0, cachedValue, 0, value.length);
+ if( notify && null != valueNotificationCB ) {
+ valueNotificationCB.run(cachedValue);
+ }
+ }
+ return valueChanged;
+ }
+
+ /* pp */ DBTGattDescriptor(final long nativeInstance, final DBTGattCharacteristic characteristic,
+ final String type_uuid, final short handle, final byte[] value)
+ {
+ super(nativeInstance, handle /* hash */);
+ this.wbr_characteristic = new WeakReference<DBTGattCharacteristic>(characteristic);
+ this.type_uuid = type_uuid;
+ this.handle = handle;
+ this.cachedValue = value;
+ }
+
+ @Override
+ public synchronized void close() {
+ if( !isValid() ) {
+ return;
+ }
+ disableValueNotifications();
+ super.close();
+ }
+
+ @Override
+ public boolean equals(final Object obj)
+ {
+ if (obj == null || !(obj instanceof DBTGattDescriptor)) {
+ return false;
+ }
+ final DBTGattDescriptor other = (DBTGattDescriptor)obj;
+ return handle == other.handle; /** unique attribute handles */
+ }
+
+ @Override
+ public String getUUID() { return type_uuid; }
+
+ @Override
+ public BluetoothType getBluetoothType() { return class_type(); }
+
+ static BluetoothType class_type() { return BluetoothType.GATT_DESCRIPTOR; }
+
+ @Override
+ public final BluetoothGattDescriptor clone()
+ { throw new UnsupportedOperationException(); } // FIXME
+
+ @Override
+ public final DBTGattCharacteristic getCharacteristic() { return wbr_characteristic.get(); }
+
+ @Override
+ public final byte[] getValue() { return cachedValue; }
+
+ @Override
+ public final byte[] readValue() {
+ final byte[] value = readValueImpl();
+ updateCachedValue(value, true);
+ return cachedValue;
+ }
+
+ @Override
+ public final boolean writeValue(final byte[] value) throws BluetoothException {
+ final boolean res = writeValueImpl(value);
+ if( res ) {
+ updateCachedValue(value, false);
+ }
+ return res;
+ }
+
+ @Override
+ public final synchronized void enableValueNotifications(final BluetoothNotification<byte[]> callback) {
+ valueNotificationCB = callback;
+ }
+
+ @Override
+ public final synchronized void disableValueNotifications() {
+ valueNotificationCB = null;
+ }
+
+ /**
+ * Characteristic Descriptor Handle
+ * <p>
+ * Attribute handles are unique for each device (server) (BT Core Spec v5.2: Vol 3, Part F Protocol..: 3.2.2 Attribute Handle).
+ * </p>
+ */
+ public final short getHandle() { return handle; }
+
+ @Override
+ public final String toString() {
+ if( !isValid() ) {
+ return "Descriptor" + "\u271D" + "[uuid "+getUUID()+", handle 0x"+Integer.toHexString(handle)+"]";
+ }
+ return toStringImpl();
+ }
+
+ /* Native method calls: */
+
+ private native String toStringImpl();
+
+ private native byte[] readValueImpl();
+
+ private native boolean writeValueImpl(byte[] argValue) throws BluetoothException;
+
+ @Override
+ protected native void deleteImpl(long nativeInstance);
+}