Microbug / BLE_API

Minor temporary patch to allow DFU packet callback

Fork of BLE_API by Bluetooth Low Energy

services/URIBeacon2Service.h@173:05c4b1cea65f, 2014-11-28 (annotated)

Committer:
rgrover1
Date:
Fri Nov 28 14:11:22 2014 +0000
Revision:
173:05c4b1cea65f
Parent:
172:fb95afa93697
Child:
174:5ae7781362b6
Synchronized with git rev d45e2b31

Author: Rohit Grover

add comment block for setFlags.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 171:6092e61690dc 1 /* mbed Microcontroller Library
rgrover1 171:6092e61690dc 2 * Copyright (c) 2006-2013 ARM Limited
rgrover1 171:6092e61690dc 3 *
rgrover1 171:6092e61690dc 4 * Licensed under the Apache License, Version 2.0 (the "License");
rgrover1 171:6092e61690dc 5 * you may not use this file except in compliance with the License.
rgrover1 171:6092e61690dc 6 * You may obtain a copy of the License at
rgrover1 171:6092e61690dc 7 *
rgrover1 171:6092e61690dc 8 * http://www.apache.org/licenses/LICENSE-2.0
rgrover1 171:6092e61690dc 9 *
rgrover1 171:6092e61690dc 10 * Unless required by applicable law or agreed to in writing, software
rgrover1 171:6092e61690dc 11 * distributed under the License is distributed on an "AS IS" BASIS,
rgrover1 171:6092e61690dc 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rgrover1 171:6092e61690dc 13 * See the License for the specific language governing permissions and
rgrover1 171:6092e61690dc 14 * limitations under the License.
rgrover1 171:6092e61690dc 15 */
rgrover1 171:6092e61690dc 16
rgrover1 171:6092e61690dc 17 #ifndef __BLE_URI_BEACON_2_SERVICE_H__
rgrover1 171:6092e61690dc 18 #define __BLE_URI_BEACON_2_SERVICE_H__
rgrover1 171:6092e61690dc 19
rgrover1 171:6092e61690dc 20 #include "BLEDevice.h"
rgrover1 171:6092e61690dc 21
rgrover1 171:6092e61690dc 22 #define UUID_INITIALIZER_LIST(FIRST, SECOND) { \
rgrover1 171:6092e61690dc 23 0xee, 0x0c, FIRST, SECOND, 0x87, 0x86, 0x40, 0xba, \
rgrover1 171:6092e61690dc 24 0xab, 0x96, 0x99, 0xb9, 0x1a, 0xc9, 0x81, 0xd8, \
rgrover1 171:6092e61690dc 25 }
rgrover1 171:6092e61690dc 26 const uint8_t URIBeacon2ControlServiceUUID[] = UUID_INITIALIZER_LIST(0x20, 0x80);
rgrover1 171:6092e61690dc 27 const uint8_t lockedStateCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x81);
rgrover1 171:6092e61690dc 28 const uint8_t uriDataCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x84);
rgrover1 171:6092e61690dc 29 const uint8_t flagsCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x85);
rgrover1 171:6092e61690dc 30 const uint8_t txPowerCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x86);
rgrover1 171:6092e61690dc 31 const uint8_t beaconPeriodCharUUID[] = UUID_INITIALIZER_LIST(0x20, 0x88);
rgrover1 171:6092e61690dc 32
rgrover1 171:6092e61690dc 33 class URIBeacon2Service {
rgrover1 171:6092e61690dc 34 public:
rgrover1 172:fb95afa93697 35 /**
rgrover1 172:fb95afa93697 36 * @param[ref] ble
rgrover1 172:fb95afa93697 37 * BLEDevice object for the underlying controller.
rgrover1 172:fb95afa93697 38 * @param[in] urldata
rgrover1 172:fb95afa93697 39 * URI as a null-terminated string.
rgrover1 172:fb95afa93697 40 * @param[in] flagsIn
rgrover1 172:fb95afa93697 41 * UriBeacon Flags.
rgrover1 172:fb95afa93697 42 * @param[in] txPowerIn
rgrover1 172:fb95afa93697 43 * UriBeacon Tx Power Level.
rgrover1 172:fb95afa93697 44 * @param[in] beaconPeriodIn
rgrover1 172:fb95afa93697 45 * The period in milliseconds that a UriBeacon packet is
rgrover1 172:fb95afa93697 46 * transmitted. A value of zero disables UriBeacon
rgrover1 172:fb95afa93697 47 * transmissions.
rgrover1 172:fb95afa93697 48 */
rgrover1 171:6092e61690dc 49 URIBeacon2Service(BLEDevice &ble_, const char *urldata, uint8_t flagsIn = 0, uint8_t txPowerIn = 0, uint16_t beaconPeriodIn = 1000) :
rgrover1 171:6092e61690dc 50 ble(ble_), payloadIndex(0), serviceDataPayload(),
rgrover1 171:6092e61690dc 51 lockedState(false),
rgrover1 171:6092e61690dc 52 uriDataLength(0),
rgrover1 171:6092e61690dc 53 uriDataValue(),
rgrover1 171:6092e61690dc 54 flags(flagsIn),
rgrover1 171:6092e61690dc 55 power(txPowerIn),
rgrover1 171:6092e61690dc 56 beaconPeriod(Gap::MSEC_TO_ADVERTISEMENT_DURATION_UNITS(beaconPeriodIn)),
rgrover1 171:6092e61690dc 57 lockedStateChar(lockedStateCharUUID, (uint8_t *)&lockedState, 1, 1, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ),
rgrover1 171:6092e61690dc 58 uriDataChar(uriDataCharUUID,
rgrover1 171:6092e61690dc 59 uriDataValue,
rgrover1 171:6092e61690dc 60 MAX_SIZE_URI_DATA_CHAR_VALUE,
rgrover1 171:6092e61690dc 61 MAX_SIZE_URI_DATA_CHAR_VALUE,
rgrover1 171:6092e61690dc 62 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE_WITHOUT_RESPONSE),
rgrover1 171:6092e61690dc 63 flagsChar(flagsCharUUID, &flags, 1, 1, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE),
rgrover1 171:6092e61690dc 64 // txPowerChar(txPowerCharUUID, &power, 1, 1, GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE)
rgrover1 171:6092e61690dc 65 beaconPeriodChar(beaconPeriodCharUUID, (uint8_t *)&beaconPeriod, 2, 2,
rgrover1 171:6092e61690dc 66 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE)
rgrover1 171:6092e61690dc 67 {
rgrover1 171:6092e61690dc 68 if ((urldata == NULL) || ((uriDataLength = strlen(urldata)) == 0)) {
rgrover1 171:6092e61690dc 69 return;
rgrover1 171:6092e61690dc 70 }
rgrover1 171:6092e61690dc 71 strncpy(reinterpret_cast<char *>(uriDataValue), urldata, MAX_SIZE_URI_DATA_CHAR_VALUE);
rgrover1 171:6092e61690dc 72
rgrover1 171:6092e61690dc 73 setup();
rgrover1 171:6092e61690dc 74
rgrover1 171:6092e61690dc 75 static bool serviceAdded = false; /* We should only ever need to add the heart rate service once. */
rgrover1 171:6092e61690dc 76 if (serviceAdded) {
rgrover1 171:6092e61690dc 77 return;
rgrover1 171:6092e61690dc 78 }
rgrover1 171:6092e61690dc 79
rgrover1 171:6092e61690dc 80 GattCharacteristic *charTable[] = {&lockedStateChar, &uriDataChar, &flagsChar, &beaconPeriodChar};
rgrover1 171:6092e61690dc 81 GattService beaconControlService(URIBeacon2ControlServiceUUID, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
rgrover1 171:6092e61690dc 82
rgrover1 171:6092e61690dc 83 ble.addService(beaconControlService);
rgrover1 171:6092e61690dc 84 serviceAdded = true;
rgrover1 171:6092e61690dc 85
rgrover1 171:6092e61690dc 86 ble.onDataWritten(this, &URIBeacon2Service::onDataWritten);
rgrover1 171:6092e61690dc 87 }
rgrover1 171:6092e61690dc 88
rgrover1 173:05c4b1cea65f 89 /**
rgrover1 173:05c4b1cea65f 90 * Update flags of the URIBeacon dynamically.
rgrover1 173:05c4b1cea65f 91 *
rgrover1 173:05c4b1cea65f 92 * @param[in] flagsIn
rgrover1 173:05c4b1cea65f 93 *
rgrover1 173:05c4b1cea65f 94 * ### UriBeacon Flags
rgrover1 173:05c4b1cea65f 95 * Bit | Description
rgrover1 173:05c4b1cea65f 96 * :---- | :----------
rgrover1 173:05c4b1cea65f 97 * 0 | Invisible Hint
rgrover1 173:05c4b1cea65f 98 * 1..7 | Reserved for future use. Must be zero.
rgrover1 173:05c4b1cea65f 99 *
rgrover1 173:05c4b1cea65f 100 * The `Invisible Hint` flag is a command for the user-agent that tells
rgrover1 173:05c4b1cea65f 101 * it not to access or display the UriBeacon. This is a guideline only,
rgrover1 173:05c4b1cea65f 102 * and is not a blocking method. User agents may, with user approval,
rgrover1 173:05c4b1cea65f 103 * display invisible beacons.
rgrover1 173:05c4b1cea65f 104 */
rgrover1 171:6092e61690dc 105 void setFlags(uint8_t flagsIn) {
rgrover1 171:6092e61690dc 106 flags = flagsIn;
rgrover1 171:6092e61690dc 107 setup();
rgrover1 171:6092e61690dc 108 }
rgrover1 171:6092e61690dc 109
rgrover1 171:6092e61690dc 110 void setTxPower(uint8_t txPowerIn) {
rgrover1 171:6092e61690dc 111 power = txPowerIn;
rgrover1 171:6092e61690dc 112 setup();
rgrover1 171:6092e61690dc 113 }
rgrover1 171:6092e61690dc 114
rgrover1 171:6092e61690dc 115 void setBeaconPeriod(uint16_t beaconPeriodIn) {
rgrover1 171:6092e61690dc 116 beaconPeriod = beaconPeriodIn;
rgrover1 171:6092e61690dc 117 setup();
rgrover1 171:6092e61690dc 118 }
rgrover1 171:6092e61690dc 119
rgrover1 171:6092e61690dc 120 protected:
rgrover1 171:6092e61690dc 121 /**
rgrover1 171:6092e61690dc 122 * This callback allows the DFU service to receive the initial trigger to
rgrover1 171:6092e61690dc 123 * handover control to the bootloader; but first the application is given a
rgrover1 171:6092e61690dc 124 * chance to clean up.
rgrover1 171:6092e61690dc 125 */
rgrover1 171:6092e61690dc 126 virtual void onDataWritten(const GattCharacteristicWriteCBParams *params) {
rgrover1 171:6092e61690dc 127 if (params->charHandle == uriDataChar.getValueAttribute().getHandle()) {
rgrover1 171:6092e61690dc 128 if (lockedState) { /* When locked, the device isn't allowed to update the uriData characteristic. */
rgrover1 171:6092e61690dc 129 /* Restore GATT database with previous value. */
rgrover1 171:6092e61690dc 130 ble.updateCharacteristicValue(uriDataChar.getValueAttribute().getHandle(), uriDataValue, uriDataLength);
rgrover1 171:6092e61690dc 131 return;
rgrover1 171:6092e61690dc 132 }
rgrover1 171:6092e61690dc 133
rgrover1 171:6092e61690dc 134 /* We don't handle very large writes at the moment. */
rgrover1 171:6092e61690dc 135 if ((params->offset != 0) || (params->len > MAX_SIZE_URI_DATA_CHAR_VALUE)) {
rgrover1 171:6092e61690dc 136 return;
rgrover1 171:6092e61690dc 137 }
rgrover1 171:6092e61690dc 138
rgrover1 171:6092e61690dc 139 uriDataLength = params->len;
rgrover1 171:6092e61690dc 140 memcpy(uriDataValue, params->data, uriDataLength);
rgrover1 171:6092e61690dc 141 } else if (params->charHandle == flagsChar.getValueAttribute().getHandle()) {
rgrover1 171:6092e61690dc 142 if (lockedState) { /* When locked, the device isn't allowed to update the flags characteristic. */
rgrover1 171:6092e61690dc 143 /* Restore GATT database with previous value. */
rgrover1 171:6092e61690dc 144 ble.updateCharacteristicValue(flagsChar.getValueAttribute().getHandle(), &flags, 1 /* size */);
rgrover1 171:6092e61690dc 145 return;
rgrover1 171:6092e61690dc 146 } else {
rgrover1 171:6092e61690dc 147 flags = *(params->data);
rgrover1 171:6092e61690dc 148 }
rgrover1 171:6092e61690dc 149 } else if (params->charHandle == beaconPeriodChar.getValueAttribute().getHandle()) {
rgrover1 171:6092e61690dc 150 if (lockedState) { /* When locked, the device isn't allowed to update the flags characteristic. */
rgrover1 171:6092e61690dc 151 /* Restore GATT database with previous value. */
rgrover1 171:6092e61690dc 152 ble.updateCharacteristicValue(beaconPeriodChar.getValueAttribute().getHandle(), (uint8_t *)&beaconPeriod, 2 /* size */);
rgrover1 171:6092e61690dc 153 return;
rgrover1 171:6092e61690dc 154 } else {
rgrover1 171:6092e61690dc 155 beaconPeriod = *((uint16_t *)(params->data));
rgrover1 171:6092e61690dc 156 }
rgrover1 171:6092e61690dc 157 }
rgrover1 171:6092e61690dc 158 setup();
rgrover1 171:6092e61690dc 159 ble.setAdvertisingPayload();
rgrover1 171:6092e61690dc 160 }
rgrover1 171:6092e61690dc 161
rgrover1 171:6092e61690dc 162 /**
rgrover1 171:6092e61690dc 163 * For debugging only.
rgrover1 171:6092e61690dc 164 */
rgrover1 171:6092e61690dc 165 void dumpEncodedSeviceData() const {
rgrover1 171:6092e61690dc 166 printf("encoded: '");
rgrover1 171:6092e61690dc 167 for (unsigned i = 0; i < payloadIndex; i++) {
rgrover1 171:6092e61690dc 168 printf(" %02x", serviceDataPayload[i]);
rgrover1 171:6092e61690dc 169 }
rgrover1 171:6092e61690dc 170 printf("'\r\n");
rgrover1 171:6092e61690dc 171 }
rgrover1 171:6092e61690dc 172
rgrover1 171:6092e61690dc 173 private:
rgrover1 171:6092e61690dc 174 void setup(void) {
rgrover1 171:6092e61690dc 175 const uint8_t BEACON_UUID[] = {0xD8, 0xFE};
rgrover1 171:6092e61690dc 176
rgrover1 171:6092e61690dc 177 payloadIndex = 0;
rgrover1 171:6092e61690dc 178 serviceDataPayload[payloadIndex++] = BEACON_UUID[0];
rgrover1 171:6092e61690dc 179 serviceDataPayload[payloadIndex++] = BEACON_UUID[1];
rgrover1 171:6092e61690dc 180 serviceDataPayload[payloadIndex++] = flags;
rgrover1 171:6092e61690dc 181 serviceDataPayload[payloadIndex++] = power;
rgrover1 171:6092e61690dc 182
rgrover1 171:6092e61690dc 183 const char *urlData = reinterpret_cast<char *>(uriDataValue);
rgrover1 171:6092e61690dc 184 size_t sizeofURLData = uriDataLength;
rgrover1 171:6092e61690dc 185 size_t encodedBytes = encodeURISchemePrefix(urlData, sizeofURLData) + encodeURI(urlData, sizeofURLData);
rgrover1 171:6092e61690dc 186
rgrover1 171:6092e61690dc 187 ble.clearAdvertisingPayload();
rgrover1 171:6092e61690dc 188 ble.accumulateAdvertisingPayload(GapAdvertisingData::COMPLETE_LIST_16BIT_SERVICE_IDS, BEACON_UUID, sizeof(BEACON_UUID));
rgrover1 171:6092e61690dc 189 ble.accumulateAdvertisingPayload(GapAdvertisingData::SERVICE_DATA, serviceDataPayload, encodedBytes + 4);
rgrover1 171:6092e61690dc 190
rgrover1 171:6092e61690dc 191 ble.setAdvertisingInterval(beaconPeriod);
rgrover1 171:6092e61690dc 192 ble.setTxPower(power);
rgrover1 171:6092e61690dc 193 }
rgrover1 171:6092e61690dc 194
rgrover1 171:6092e61690dc 195 size_t encodeURISchemePrefix(const char *&urldata, size_t &sizeofURLData) {
rgrover1 171:6092e61690dc 196 const char *prefixes[] = {
rgrover1 171:6092e61690dc 197 "http://www.",
rgrover1 171:6092e61690dc 198 "https://www.",
rgrover1 171:6092e61690dc 199 "http://",
rgrover1 171:6092e61690dc 200 "https://",
rgrover1 171:6092e61690dc 201 "urn:uuid:"
rgrover1 171:6092e61690dc 202 };
rgrover1 171:6092e61690dc 203
rgrover1 171:6092e61690dc 204 size_t encodedBytes = 0;
rgrover1 171:6092e61690dc 205 const size_t NUM_PREFIXES = sizeof(prefixes) / sizeof(char *);
rgrover1 171:6092e61690dc 206 for (unsigned i = 0; i < NUM_PREFIXES; i++) {
rgrover1 171:6092e61690dc 207 size_t prefixLen = strlen(prefixes[i]);
rgrover1 171:6092e61690dc 208 if (strncmp(urldata, prefixes[i], prefixLen) == 0) {
rgrover1 171:6092e61690dc 209 serviceDataPayload[payloadIndex++] = i;
rgrover1 171:6092e61690dc 210 encodedBytes = 1;
rgrover1 171:6092e61690dc 211
rgrover1 171:6092e61690dc 212 urldata += prefixLen;
rgrover1 171:6092e61690dc 213 sizeofURLData -= prefixLen;
rgrover1 171:6092e61690dc 214 break;
rgrover1 171:6092e61690dc 215 }
rgrover1 171:6092e61690dc 216 }
rgrover1 171:6092e61690dc 217
rgrover1 171:6092e61690dc 218 return encodedBytes;
rgrover1 171:6092e61690dc 219 }
rgrover1 171:6092e61690dc 220
rgrover1 171:6092e61690dc 221 size_t encodeURI(const char *urldata, size_t sizeofURLData) {
rgrover1 171:6092e61690dc 222 const char *suffixes[] = {
rgrover1 171:6092e61690dc 223 ".com/",
rgrover1 171:6092e61690dc 224 ".org/",
rgrover1 171:6092e61690dc 225 ".edu/",
rgrover1 171:6092e61690dc 226 ".net/",
rgrover1 171:6092e61690dc 227 ".info/",
rgrover1 171:6092e61690dc 228 ".biz/",
rgrover1 171:6092e61690dc 229 ".gov/",
rgrover1 171:6092e61690dc 230 ".com",
rgrover1 171:6092e61690dc 231 ".org",
rgrover1 171:6092e61690dc 232 ".edu",
rgrover1 171:6092e61690dc 233 ".net",
rgrover1 171:6092e61690dc 234 ".info",
rgrover1 171:6092e61690dc 235 ".biz",
rgrover1 171:6092e61690dc 236 ".gov"
rgrover1 171:6092e61690dc 237 };
rgrover1 171:6092e61690dc 238 const size_t NUM_SUFFIXES = sizeof(suffixes) / sizeof(char *);
rgrover1 171:6092e61690dc 239
rgrover1 171:6092e61690dc 240 size_t encodedBytes = 0;
rgrover1 171:6092e61690dc 241 while (sizeofURLData && (payloadIndex < MAX_SIZEOF_SERVICE_DATA_PAYLOAD)) {
rgrover1 171:6092e61690dc 242 /* check for suffix match */
rgrover1 171:6092e61690dc 243 unsigned i;
rgrover1 171:6092e61690dc 244 for (i = 0; i < NUM_SUFFIXES; i++) {
rgrover1 171:6092e61690dc 245 size_t suffixLen = strlen(suffixes[i]);
rgrover1 171:6092e61690dc 246 if ((suffixLen == 0) || (sizeofURLData < suffixLen)) {
rgrover1 171:6092e61690dc 247 continue;
rgrover1 171:6092e61690dc 248 }
rgrover1 171:6092e61690dc 249
rgrover1 171:6092e61690dc 250 if (strncmp(urldata, suffixes[i], suffixLen) == 0) {
rgrover1 171:6092e61690dc 251 serviceDataPayload[payloadIndex++] = i;
rgrover1 171:6092e61690dc 252 ++encodedBytes;
rgrover1 171:6092e61690dc 253 urldata += suffixLen;
rgrover1 171:6092e61690dc 254 sizeofURLData -= suffixLen;
rgrover1 171:6092e61690dc 255 break; /* from the for loop for checking against suffixes */
rgrover1 171:6092e61690dc 256 }
rgrover1 171:6092e61690dc 257 }
rgrover1 171:6092e61690dc 258 /* This is the default case where we've got an ordinary character which doesn't match a suffix. */
rgrover1 171:6092e61690dc 259 if (i == NUM_SUFFIXES) {
rgrover1 171:6092e61690dc 260 serviceDataPayload[payloadIndex++] = *urldata;
rgrover1 171:6092e61690dc 261 ++encodedBytes;
rgrover1 171:6092e61690dc 262 ++urldata;
rgrover1 171:6092e61690dc 263 --sizeofURLData;
rgrover1 171:6092e61690dc 264 }
rgrover1 171:6092e61690dc 265 }
rgrover1 171:6092e61690dc 266
rgrover1 171:6092e61690dc 267 return encodedBytes;
rgrover1 171:6092e61690dc 268 }
rgrover1 171:6092e61690dc 269
rgrover1 171:6092e61690dc 270 private:
rgrover1 171:6092e61690dc 271 static const size_t MAX_SIZEOF_SERVICE_DATA_PAYLOAD = 27;
rgrover1 171:6092e61690dc 272 static const size_t MAX_SIZE_URI_DATA_CHAR_VALUE = 48;
rgrover1 171:6092e61690dc 273
rgrover1 171:6092e61690dc 274 private:
rgrover1 171:6092e61690dc 275 BLEDevice &ble;
rgrover1 171:6092e61690dc 276
rgrover1 171:6092e61690dc 277 size_t payloadIndex;
rgrover1 171:6092e61690dc 278 uint8_t serviceDataPayload[MAX_SIZEOF_SERVICE_DATA_PAYLOAD];
rgrover1 171:6092e61690dc 279 bool lockedState;
rgrover1 171:6092e61690dc 280 uint16_t uriDataLength;
rgrover1 171:6092e61690dc 281 uint8_t uriDataValue[MAX_SIZE_URI_DATA_CHAR_VALUE];
rgrover1 171:6092e61690dc 282 uint8_t flags;
rgrover1 171:6092e61690dc 283 uint8_t power;
rgrover1 171:6092e61690dc 284 uint16_t beaconPeriod;
rgrover1 171:6092e61690dc 285
rgrover1 171:6092e61690dc 286 GattCharacteristic lockedStateChar;
rgrover1 171:6092e61690dc 287 GattCharacteristic uriDataChar;
rgrover1 171:6092e61690dc 288 GattCharacteristic flagsChar;
rgrover1 171:6092e61690dc 289 // GattCharacteristic txPowerChar;
rgrover1 171:6092e61690dc 290 GattCharacteristic beaconPeriodChar;
rgrover1 171:6092e61690dc 291 };
rgrover1 171:6092e61690dc 292
rgrover1 171:6092e61690dc 293 #endif /* #ifndef __BLE_URI_BEACON_2_SERVICE_H__*/