aboutsummaryrefslogtreecommitdiffstats
path: root/java/jau/direct_bt/DBTGattDesc.java
diff options
context:
space:
mode:
Diffstat (limited to 'java/jau/direct_bt/DBTGattDesc.java')
-rw-r--r--java/jau/direct_bt/DBTGattDesc.java171
1 files changed, 171 insertions, 0 deletions
diff --git a/java/jau/direct_bt/DBTGattDesc.java b/java/jau/direct_bt/DBTGattDesc.java
new file mode 100644
index 00000000..7c080e39
--- /dev/null
+++ b/java/jau/direct_bt/DBTGattDesc.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 jau.direct_bt;
+
+import java.lang.ref.WeakReference;
+import java.util.Arrays;
+
+import org.direct_bt.BTException;
+import org.direct_bt.BTGattDesc;
+import org.direct_bt.BTNotification;
+import org.direct_bt.BTType;
+
+public class DBTGattDesc extends DBTObject implements BTGattDesc
+{
+ /** Descriptor's characteristic weak back-reference */
+ final WeakReference<DBTGattChar> 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 BTNotification<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 */ DBTGattDesc(final long nativeInstance, final DBTGattChar characteristic,
+ final String type_uuid, final short handle, final byte[] value)
+ {
+ super(nativeInstance, handle /* hash */);
+ this.wbr_characteristic = new WeakReference<DBTGattChar>(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 DBTGattDesc)) {
+ return false;
+ }
+ final DBTGattDesc other = (DBTGattDesc)obj;
+ return handle == other.handle; /** unique attribute handles */
+ }
+
+ @Override
+ public String getUUID() { return type_uuid; }
+
+ @Override
+ public BTType getBluetoothType() { return class_type(); }
+
+ static BTType class_type() { return BTType.GATT_DESCRIPTOR; }
+
+ @Override
+ public final BTGattDesc clone()
+ { throw new UnsupportedOperationException(); } // FIXME
+
+ @Override
+ public final DBTGattChar 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 BTException {
+ final boolean res = writeValueImpl(value);
+ if( res ) {
+ updateCachedValue(value, false);
+ }
+ return res;
+ }
+
+ @Override
+ public final synchronized void enableValueNotifications(final BTNotification<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 BTException;
+
+ @Override
+ protected native void deleteImpl(long nativeInstance);
+}