Minor fixes
Fork of BLE_API by
Embed:
(wiki syntax)
Show/hide line numbers
GapAdvertisingData.h
00001 /* mbed Microcontroller Library 00002 * Copyright (c) 2006-2013 ARM Limited 00003 * 00004 * Licensed under the Apache License, Version 2.0 (the "License"); 00005 * you may not use this file except in compliance with the License. 00006 * You may obtain a copy of the License at 00007 * 00008 * http://www.apache.org/licenses/LICENSE-2.0 00009 * 00010 * Unless required by applicable law or agreed to in writing, software 00011 * distributed under the License is distributed on an "AS IS" BASIS, 00012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 00013 * See the License for the specific language governing permissions and 00014 * limitations under the License. 00015 */ 00016 00017 #ifndef __GAP_ADVERTISING_DATA_H__ 00018 #define __GAP_ADVERTISING_DATA_H__ 00019 00020 #include <stdint.h> 00021 #include <string.h> 00022 00023 #include "blecommon.h" 00024 00025 #define GAP_ADVERTISING_DATA_MAX_PAYLOAD (31) 00026 00027 /**************************************************************************/ 00028 /*! 00029 \brief 00030 This class provides several helper functions to generate properly 00031 formatted GAP Advertising and Scan Response data payloads 00032 00033 \note 00034 See Bluetooth Specification 4.0 (Vol. 3), Part C, Section 11 and 18 00035 for further information on Advertising and Scan Response data. 00036 00037 \par Advertising and Scan Response Payloads 00038 Advertising data and Scan Response data are organized around a set of 00039 data types called 'AD types' in Bluetooth 4.0 (see the Bluetooth Core 00040 Specification v4.0, Vol. 3, Part C, Sections 11 and 18). 00041 00042 \par 00043 Each AD type has it's own standardized 'assigned number', as defined 00044 by the Bluetooth SIG: 00045 https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile 00046 00047 \par 00048 For convenience sake, all appropriate AD types have been encapsulated 00049 into GapAdvertisingData::DataType. 00050 00051 \par 00052 Before the AD Types and their payload (if any) can be inserted into 00053 the Advertising or Scan Response frames, they need to be formatted as 00054 follows: 00055 00056 \li \c Record length (1 byte) 00057 \li \c AD Type (1 byte) 00058 \li \c AD payload (optional, only present if record length > 1) 00059 00060 \par 00061 This class takes care of properly formatting the payload, performs 00062 some basic checks on the payload length, and tries to avoid common 00063 errors like adding an exclusive AD field twice in the Advertising 00064 or Scan Response payload. 00065 00066 \par EXAMPLE 00067 00068 \code 00069 00070 // ToDo 00071 00072 \endcode 00073 */ 00074 /**************************************************************************/ 00075 class GapAdvertisingData 00076 { 00077 public: 00078 /**********************************************************************/ 00079 /*! 00080 \brief 00081 A list of Advertising Data types commonly used by peripherals. 00082 These AD types are used to describe the capabilities of the 00083 peripheral, and get inserted inside the advertising or scan 00084 response payloads. 00085 00086 \par Source 00087 \li \c Bluetooth Core Specification 4.0 (Vol. 3), Part C, Section 11, 18 00088 \li \c https://www.bluetooth.org/en-us/specification/assigned-numbers/generic-access-profile 00089 */ 00090 /**********************************************************************/ 00091 enum DataType { 00092 FLAGS = 0x01, /**< \ref *Flags */ 00093 INCOMPLETE_LIST_16BIT_SERVICE_IDS = 0x02, /**< Incomplete list of 16-bit Service IDs */ 00094 COMPLETE_LIST_16BIT_SERVICE_IDS = 0x03, /**< Complete list of 16-bit Service IDs */ 00095 INCOMPLETE_LIST_32BIT_SERVICE_IDS = 0x04, /**< Incomplete list of 32-bit Service IDs (not relevant for Bluetooth 4.0) */ 00096 COMPLETE_LIST_32BIT_SERVICE_IDS = 0x05, /**< Complete list of 32-bit Service IDs (not relevant for Bluetooth 4.0) */ 00097 INCOMPLETE_LIST_128BIT_SERVICE_IDS = 0x06, /**< Incomplete list of 128-bit Service IDs */ 00098 COMPLETE_LIST_128BIT_SERVICE_IDS = 0x07, /**< Complete list of 128-bit Service IDs */ 00099 SHORTENED_LOCAL_NAME = 0x08, /**< Shortened Local Name */ 00100 COMPLETE_LOCAL_NAME = 0x09, /**< Complete Local Name */ 00101 TX_POWER_LEVEL = 0x0A, /**< TX Power Level (in dBm) */ 00102 DEVICE_ID = 0x10, /**< Device ID */ 00103 SLAVE_CONNECTION_INTERVAL_RANGE = 0x12, /**< Slave Connection Interval Range */ 00104 SERVICE_DATA = 0x16, /**< Service Data */ 00105 APPEARANCE = 0x19, /**< \ref Appearance */ 00106 ADVERTISING_INTERVAL = 0x1A, /**< Advertising Interval */ 00107 MANUFACTURER_SPECIFIC_DATA = 0xFF /**< Manufacturer Specific Data */ 00108 }; 00109 00110 /**********************************************************************/ 00111 /*! 00112 \brief 00113 A list of values for the FLAGS AD Type 00114 00115 \note 00116 You can use more than one value in the FLAGS AD Type (ex. 00117 LE_GENERAL_DISCOVERABLE and BREDR_NOT_SUPPORTED). 00118 00119 \par Source 00120 \li \c Bluetooth Core Specification 4.0 (Vol. 3), Part C, Section 18.1 00121 */ 00122 /**********************************************************************/ 00123 enum Flags { 00124 LE_LIMITED_DISCOVERABLE = 0x01, /**< *Peripheral device is discoverable for a limited period of time */ 00125 LE_GENERAL_DISCOVERABLE = 0x02, /**< Peripheral device is discoverable at any moment */ 00126 BREDR_NOT_SUPPORTED = 0x04, /**< Peripheral device is LE only */ 00127 SIMULTANEOUS_LE_BREDR_C = 0x08, /**< Not relevant - central mode only */ 00128 SIMULTANEOUS_LE_BREDR_H = 0x10 /**< Not relevant - central mode only */ 00129 }; 00130 00131 /**********************************************************************/ 00132 /*! 00133 \brief 00134 A list of values for the APPEARANCE AD Type, which describes the 00135 physical shape or appearance of the device 00136 00137 \par Source 00138 \li \c Bluetooth Core Specification Supplement, Part A, Section 1.12 00139 \li \c Bluetooth Core Specification 4.0 (Vol. 3), Part C, Section 12.2 00140 \li \c https://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.gap.appearance.xml 00141 */ 00142 /**********************************************************************/ 00143 enum Appearance { 00144 UNKNOWN = 0, /**< Unknown of unspecified appearance type */ 00145 GENERIC_PHONE = 64, /**< Generic Phone */ 00146 GENERIC_COMPUTER = 128, /**< Generic Computer */ 00147 GENERIC_WATCH = 192, /**< Generic Watch */ 00148 WATCH_SPORTS_WATCH = 193, /**< Sports Watch */ 00149 GENERIC_CLOCK = 256, /**< Generic Clock */ 00150 GENERIC_DISPLAY = 320, /**< Generic Display */ 00151 GENERIC_REMOTE_CONTROL = 384, /**< Generic Remote Control */ 00152 GENERIC_EYE_GLASSES = 448, /**< Generic Eye Glasses */ 00153 GENERIC_TAG = 512, /**< Generic Tag */ 00154 GENERIC_KEYRING = 576, /**< Generic Keyring */ 00155 GENERIC_MEDIA_PLAYER = 640, /**< Generic Media Player */ 00156 GENERIC_BARCODE_SCANNER = 704, /**< Generic Barcode Scanner */ 00157 GENERIC_THERMOMETER = 768, /**< Generic Thermometer */ 00158 THERMOMETER_EAR = 769, /**< Ear Thermometer */ 00159 GENERIC_HEART_RATE_SENSOR = 832, /**< Generic Heart Rate Sensor */ 00160 HEART_RATE_SENSOR_HEART_RATE_BELT = 833, /**< Belt Heart Rate Sensor */ 00161 GENERIC_BLOOD_PRESSURE = 896, /**< Generic Blood Pressure */ 00162 BLOOD_PRESSURE_ARM = 897, /**< Arm Blood Pressure */ 00163 BLOOD_PRESSURE_WRIST = 898, /**< Wrist Blood Pressure */ 00164 HUMAN_INTERFACE_DEVICE_HID = 960, /**< Human Interface Device (HID) */ 00165 KEYBOARD = 961, /**< Keyboard */ 00166 MOUSE = 962, /**< Mouse */ 00167 JOYSTICK = 963, /**< Joystick */ 00168 GAMEPAD = 964, /**< Gamepad */ 00169 DIGITIZER_TABLET = 965, /**< Digitizer Tablet */ 00170 CARD_READER = 966, /**< Card Read */ 00171 DIGITAL_PEN = 967, /**< Digital Pen */ 00172 BARCODE_SCANNER = 968, /**< Barcode Scanner */ 00173 GENERIC_GLUCOSE_METER = 1024, /**< Generic Glucose Meter */ 00174 GENERIC_RUNNING_WALKING_SENSOR = 1088, /**< Generic Running/Walking Sensor */ 00175 RUNNING_WALKING_SENSOR_IN_SHOE = 1089, /**< In Shoe Running/Walking Sensor */ 00176 RUNNING_WALKING_SENSOR_ON_SHOE = 1090, /**< On Shoe Running/Walking Sensor */ 00177 RUNNING_WALKING_SENSOR_ON_HIP = 1091, /**< On Hip Running/Walking Sensor */ 00178 GENERIC_CYCLING = 1152, /**< Generic Cycling */ 00179 CYCLING_CYCLING_COMPUTER = 1153, /**< Cycling Computer */ 00180 CYCLING_SPEED_SENSOR = 1154, /**< Cycling Speed Senspr */ 00181 CYCLING_CADENCE_SENSOR = 1155, /**< Cycling Cadence Sensor */ 00182 CYCLING_POWER_SENSOR = 1156, /**< Cycling Power Sensor */ 00183 CYCLING_SPEED_AND_CADENCE_SENSOR = 1157, /**< Cycling Speed and Cadence Sensor */ 00184 PULSE_OXIMETER_GENERIC = 3136, /**< Generic Pulse Oximeter */ 00185 PULSE_OXIMETER_FINGERTIP = 3137, /**< Fingertip Pulse Oximeter */ 00186 PULSE_OXIMETER_WRIST_WORN = 3138, /**< Wrist Worn Pulse Oximeter */ 00187 OUTDOOR_GENERIC = 5184, /**< Generic Outdoor */ 00188 OUTDOOR_LOCATION_DISPLAY_DEVICE = 5185, /**< Outdoor Location Display Device */ 00189 OUTDOOR_LOCATION_AND_NAVIGATION_DISPLAY_DEVICE = 5186, /**< Outdoor Location and Navigation Display Device */ 00190 OUTDOOR_LOCATION_POD = 5187, /**< Outdoor Location Pod */ 00191 OUTDOOR_LOCATION_AND_NAVIGATION_POD = 5188 /**< Outdoor Location and Navigation Pod */ 00192 }; 00193 00194 GapAdvertisingData(void) : _payload(), _payloadLen(0), _appearance(GENERIC_TAG) { 00195 /* empty */ 00196 } 00197 00198 /** 00199 * Adds advertising data based on the specified AD type (see DataType) 00200 * 00201 * @param advDataType The Advertising 'DataType' to add 00202 * @param payload Pointer to the payload contents 00203 * @param len Size of the payload in bytes 00204 * 00205 * @return BLE_ERROR_BUFFER_OVERFLOW if the specified data would cause the 00206 * advertising buffer to overflow, else BLE_ERROR_NONE. 00207 */ 00208 ble_error_t addData(DataType advDataType, const uint8_t *payload, uint8_t len) 00209 { 00210 /* ToDo: Check if an AD type already exists and if the existing */ 00211 /* value is exclusive or not (flags, etc.) */ 00212 00213 /* Make sure we don't exceed the 31 byte payload limit */ 00214 if (_payloadLen + len + 2 > GAP_ADVERTISING_DATA_MAX_PAYLOAD) { 00215 return BLE_ERROR_BUFFER_OVERFLOW; 00216 } 00217 00218 /* Field length */ 00219 memset(&_payload[_payloadLen], len + 1, 1); 00220 _payloadLen++; 00221 00222 /* Field ID */ 00223 memset(&_payload[_payloadLen], (uint8_t)advDataType, 1); 00224 _payloadLen++; 00225 00226 /* Payload */ 00227 memcpy(&_payload[_payloadLen], payload, len); 00228 _payloadLen += len; 00229 00230 return BLE_ERROR_NONE; 00231 } 00232 00233 /** 00234 * Helper function to add APPEARANCE data to the advertising payload 00235 * 00236 * @param appearance 00237 * The APPEARANCE value to add 00238 * 00239 * @return BLE_ERROR_BUFFER_OVERFLOW if the specified data would cause the 00240 * advertising buffer to overflow, else BLE_ERROR_NONE. 00241 */ 00242 ble_error_t addAppearance(Appearance appearance = GENERIC_TAG) { 00243 _appearance = appearance; 00244 return addData(GapAdvertisingData::APPEARANCE, (uint8_t *)&appearance, 2); 00245 } 00246 00247 /** 00248 * Helper function to add FLAGS data to the advertising payload. 00249 * @param flags 00250 * LE_LIMITED_DISCOVERABLE 00251 * The peripheral is discoverable for a limited period of time. 00252 * LE_GENERAL_DISCOVERABLE 00253 * The peripheral is permanently discoverable. 00254 * BREDR_NOT_SUPPORTED 00255 * This peripheral is a Bluetooth Low Energy only device (no EDR support). 00256 * 00257 * @return BLE_ERROR_BUFFER_OVERFLOW if the specified data would cause the 00258 * advertising buffer to overflow, else BLE_ERROR_NONE. 00259 */ 00260 ble_error_t addFlags(uint8_t flags = LE_GENERAL_DISCOVERABLE) { 00261 return addData(GapAdvertisingData::FLAGS, &flags, 1); 00262 } 00263 00264 /** 00265 * Helper function to add TX_POWER_LEVEL data to the advertising payload 00266 * 00267 * @return BLE_ERROR_BUFFER_OVERFLOW if the specified data would cause the 00268 * advertising buffer to overflow, else BLE_ERROR_NONE. 00269 */ 00270 ble_error_t addTxPower(int8_t txPower) { 00271 /* ToDo: Basic error checking to make sure txPower is in range */ 00272 return addData(GapAdvertisingData::TX_POWER_LEVEL, (uint8_t *)&txPower, 1); 00273 } 00274 00275 /** 00276 * Clears the payload and resets the payload length counter 00277 */ 00278 void clear(void) { 00279 memset(&_payload, 0, GAP_ADVERTISING_DATA_MAX_PAYLOAD); 00280 _payloadLen = 0; 00281 } 00282 00283 /** 00284 * Returns a pointer to the the current payload 00285 */ 00286 const uint8_t *getPayload(void) const { 00287 return (_payloadLen > 0) ? _payload : NULL; 00288 } 00289 00290 /** 00291 * Returns the current payload length (0..31 bytes) 00292 */ 00293 uint8_t getPayloadLen(void) const { 00294 return _payloadLen; 00295 } 00296 00297 /** 00298 * Returns the 16-bit appearance value for this device 00299 */ 00300 uint16_t getAppearance(void) const { 00301 return (uint16_t)_appearance; 00302 } 00303 00304 private: 00305 uint8_t _payload[GAP_ADVERTISING_DATA_MAX_PAYLOAD]; 00306 uint8_t _payloadLen; 00307 uint16_t _appearance; 00308 }; 00309 00310 #endif // ifndef __GAP_ADVERTISING_DATA_H__
Generated on Wed Jul 13 2022 00:39:21 by 1.7.2