1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
/**
* Author: Sven Gothel <sgothel@jausoft.com>
* Copyright (c) 2021 Gothel Software e.K.
* Copyright (c) 2021 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 org.direct_bt;
import java.util.List;
/**
* Representing a Gatt Service object from the ::GATTRole::Server perspective.
*
* A list of shared DBGattService instances are passed at DBGattServer construction
* and are retrievable via DBGattServer::getServices().
*
* See [Direct-BT Overview](namespaceorg_1_1direct__bt.html#details).
*
* BT Core Spec v5.2: Vol 3, Part G GATT: 3.1 Service Definition
*
* Includes a complete [Primary] Service Declaration
* including its list of Characteristic Declarations,
* which also may include its client config if available.
*
* @since 2.4.0
*/
public final class DBGattService implements AutoCloseable
{
private volatile long nativeInstance;
/* pp */ long getNativeInstance() { return nativeInstance; }
/**
* Selected standard GATT service service numbers in UUID16 format as defined.
*/
public static class UUID16 {
/** This service contains generic information about the device. This is a mandatory service. */
public static String GENERIC_ACCESS = "1800";
/** The service allows receiving indications of changed services. This is a mandatory service. */
public static String GENERIC_ATTRIBUTE = "1801";
/** This service exposes a control point to change the peripheral alert behavior. */
public static String IMMEDIATE_ALERT = "1802";
/** The service defines behavior on the device when a link is lost between two devices. */
public static String LINK_LOSS = "1803";
/** This service exposes temperature and other data from a thermometer intended for healthcare and fitness applications. */
public static String HEALTH_THERMOMETER = "1809";
/** This service exposes manufacturer and/or vendor information about a device. */
public static String DEVICE_INFORMATION = "180a";
/** This service exposes the state of a battery within a device. */
public static String BATTERY_SERVICE = "180f";
};
/**
* Indicate whether this service is a primary service.
*/
public final boolean primary;
/**
* Service start 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 native short getHandle();
/**
* Service end handle, inclusive.
* <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 native short getEndHandle();
private final String type;
/** Service type UUID (lower-case) */
public String getType() { return type; }
/* pp */ final List<DBGattChar> characteristics;
/** List of Characteristic Declarations. */
public final List<DBGattChar> getCharacteristics() { return characteristics; }
public DBGattService(final boolean primary_,
final String type_,
final List<DBGattChar> characteristics_)
{
primary = primary_;
type = type_;
characteristics = characteristics_;
final long[] nativeCharacteristics = new long[characteristics_.size()];
for(int i=0; i < nativeCharacteristics.length; i++) {
nativeCharacteristics[i] = characteristics_.get(i).getNativeInstance();
}
nativeInstance = ctorImpl(primary_, type_, nativeCharacteristics);
}
private native long ctorImpl(final boolean primary, final String type,
final long[] characteristics);
@Override
public void close() {
final long handle;
synchronized( this ) {
handle = nativeInstance;
nativeInstance = 0;
}
if( 0 != handle ) {
dtorImpl(handle);
}
}
private static native void dtorImpl(final long nativeInstance);
@Override
public void finalize() {
close();
}
public DBGattChar findGattChar(final String char_uuid) {
for(final DBGattChar c : characteristics) {
if( char_uuid.equals( c.getValueType() ) ) {
return c;
}
}
return null;
}
public DBGattChar findGattCharByValueHandle(final short char_value_handle) {
for(final DBGattChar c : characteristics) {
if( char_value_handle == c.getValueHandle() ) {
return c;
}
}
return null;
}
@Override
public boolean equals(final Object other) {
if( this == other ) {
return true;
}
if( !(other instanceof DBGattService) ) {
return false;
}
final DBGattService o = (DBGattService)other;
return getHandle() == o.getHandle() && getEndHandle() == o.getEndHandle(); /** unique attribute handles */
}
@Override
public native String toString();
}
|
