Nordic Semiconductor / nrf51-sdk

Nordic nrf51 sdk sources. Mirrored from https://github.com/ARMmbed/nrf51-sdk.

Dependents:   nRF51822 nRF51822

source/nordic_sdk/components/ble/common/ble_srv_common.h@19:47192cb9def7, 2016-04-07 (annotated)

Committer:
vcoubard
Date:
Thu Apr 07 17:37:40 2016 +0100
Revision:
19:47192cb9def7
Parent:
10:233fefd8162b
Child:
20:a90c48eb1d30
Synchronized with git rev 9251259f

Author: Liyou Zhou

Copy over coresponding files from nordic-sdk 9.0.0

Who changed what in which revision?

UserRevisionLine numberNew contents of line
vcoubard 19:47192cb9def7 1 /* Copyright (c) 2012 Nordic Semiconductor. All Rights Reserved.
vcoubard 19:47192cb9def7 2 *
vcoubard 19:47192cb9def7 3 * The information contained herein is property of Nordic Semiconductor ASA.
vcoubard 19:47192cb9def7 4 * Terms and conditions of usage are described in detail in NORDIC
vcoubard 19:47192cb9def7 5 * SEMICONDUCTOR STANDARD SOFTWARE LICENSE AGREEMENT.
vcoubard 19:47192cb9def7 6 *
vcoubard 19:47192cb9def7 7 * Licensees are granted free, non-transferable use of the information. NO
vcoubard 19:47192cb9def7 8 * WARRANTY of ANY KIND is provided. This heading must NOT be removed from
vcoubard 19:47192cb9def7 9 * the file.
vcoubard 19:47192cb9def7 10 *
Vincent Coubard 0:f2542974c862 11 */
Vincent Coubard 0:f2542974c862 12
Vincent Coubard 0:f2542974c862 13 /** @file
Vincent Coubard 0:f2542974c862 14 *
Vincent Coubard 0:f2542974c862 15 * @defgroup ble_sdk_srv_common Common service definitions
Vincent Coubard 0:f2542974c862 16 * @{
Vincent Coubard 0:f2542974c862 17 * @ingroup ble_sdk_srv
vcoubard 19:47192cb9def7 18 * @brief Constants, type definitions, and functions that are common to all services.
Vincent Coubard 0:f2542974c862 19 */
Vincent Coubard 0:f2542974c862 20
Vincent Coubard 0:f2542974c862 21 #ifndef BLE_SRV_COMMON_H__
Vincent Coubard 0:f2542974c862 22 #define BLE_SRV_COMMON_H__
Vincent Coubard 0:f2542974c862 23
Vincent Coubard 0:f2542974c862 24 #include <stdint.h>
Vincent Coubard 0:f2542974c862 25 #include <stdbool.h>
Vincent Coubard 0:f2542974c862 26 #include "ble_types.h"
Vincent Coubard 0:f2542974c862 27 #include "app_util.h"
vcoubard 19:47192cb9def7 28 #include "ble.h"
Vincent Coubard 0:f2542974c862 29 #include "ble_gap.h"
Vincent Coubard 0:f2542974c862 30 #include "ble_gatt.h"
Vincent Coubard 0:f2542974c862 31
Vincent Coubard 0:f2542974c862 32 /** @defgroup UUID_SERVICES Service UUID definitions
Vincent Coubard 0:f2542974c862 33 * @{ */
Vincent Coubard 0:f2542974c862 34 #define BLE_UUID_ALERT_NOTIFICATION_SERVICE 0x1811 /**< Alert Notification service UUID. */
Vincent Coubard 0:f2542974c862 35 #define BLE_UUID_BATTERY_SERVICE 0x180F /**< Battery service UUID. */
Vincent Coubard 0:f2542974c862 36 #define BLE_UUID_BLOOD_PRESSURE_SERVICE 0x1810 /**< Blood Pressure service UUID. */
Vincent Coubard 0:f2542974c862 37 #define BLE_UUID_CURRENT_TIME_SERVICE 0x1805 /**< Current Time service UUID. */
Vincent Coubard 0:f2542974c862 38 #define BLE_UUID_CYCLING_SPEED_AND_CADENCE 0x1816 /**< Cycling Speed and Cadence service UUID. */
Vincent Coubard 0:f2542974c862 39 #define BLE_UUID_DEVICE_INFORMATION_SERVICE 0x180A /**< Device Information service UUID. */
Vincent Coubard 0:f2542974c862 40 #define BLE_UUID_GLUCOSE_SERVICE 0x1808 /**< Glucose service UUID. */
Vincent Coubard 0:f2542974c862 41 #define BLE_UUID_HEALTH_THERMOMETER_SERVICE 0x1809 /**< Health Thermometer service UUID. */
Vincent Coubard 0:f2542974c862 42 #define BLE_UUID_HEART_RATE_SERVICE 0x180D /**< Heart Rate service UUID. */
Vincent Coubard 0:f2542974c862 43 #define BLE_UUID_HUMAN_INTERFACE_DEVICE_SERVICE 0x1812 /**< Human Interface Device service UUID. */
Vincent Coubard 0:f2542974c862 44 #define BLE_UUID_IMMEDIATE_ALERT_SERVICE 0x1802 /**< Immediate Alert service UUID. */
Vincent Coubard 0:f2542974c862 45 #define BLE_UUID_LINK_LOSS_SERVICE 0x1803 /**< Link Loss service UUID. */
Vincent Coubard 0:f2542974c862 46 #define BLE_UUID_NEXT_DST_CHANGE_SERVICE 0x1807 /**< Next Dst Change service UUID. */
Vincent Coubard 0:f2542974c862 47 #define BLE_UUID_PHONE_ALERT_STATUS_SERVICE 0x180E /**< Phone Alert Status service UUID. */
Vincent Coubard 0:f2542974c862 48 #define BLE_UUID_REFERENCE_TIME_UPDATE_SERVICE 0x1806 /**< Reference Time Update service UUID. */
Vincent Coubard 0:f2542974c862 49 #define BLE_UUID_RUNNING_SPEED_AND_CADENCE 0x1814 /**< Running Speed and Cadence service UUID. */
Vincent Coubard 0:f2542974c862 50 #define BLE_UUID_SCAN_PARAMETERS_SERVICE 0x1813 /**< Scan Parameters service UUID. */
Vincent Coubard 0:f2542974c862 51 #define BLE_UUID_TX_POWER_SERVICE 0x1804 /**< TX Power service UUID. */
Vincent Coubard 0:f2542974c862 52 /** @} */
Vincent Coubard 0:f2542974c862 53
Vincent Coubard 0:f2542974c862 54 /** @defgroup UUID_CHARACTERISTICS Characteristic UUID definitions
Vincent Coubard 0:f2542974c862 55 * @{ */
Vincent Coubard 0:f2542974c862 56 #define BLE_UUID_BATTERY_LEVEL_STATE_CHAR 0x2A1B /**< Battery Level State characteristic UUID. */
Vincent Coubard 0:f2542974c862 57 #define BLE_UUID_BATTERY_POWER_STATE_CHAR 0x2A1A /**< Battery Power State characteristic UUID. */
Vincent Coubard 0:f2542974c862 58 #define BLE_UUID_REMOVABLE_CHAR 0x2A3A /**< Removable characteristic UUID. */
Vincent Coubard 0:f2542974c862 59 #define BLE_UUID_SERVICE_REQUIRED_CHAR 0x2A3B /**< Service Required characteristic UUID. */
Vincent Coubard 0:f2542974c862 60 #define BLE_UUID_ALERT_CATEGORY_ID_CHAR 0x2A43 /**< Alert Category Id characteristic UUID. */
Vincent Coubard 0:f2542974c862 61 #define BLE_UUID_ALERT_CATEGORY_ID_BIT_MASK_CHAR 0x2A42 /**< Alert Category Id Bit Mask characteristic UUID. */
Vincent Coubard 0:f2542974c862 62 #define BLE_UUID_ALERT_LEVEL_CHAR 0x2A06 /**< Alert Level characteristic UUID. */
Vincent Coubard 0:f2542974c862 63 #define BLE_UUID_ALERT_NOTIFICATION_CONTROL_POINT_CHAR 0x2A44 /**< Alert Notification Control Point characteristic UUID. */
Vincent Coubard 0:f2542974c862 64 #define BLE_UUID_ALERT_STATUS_CHAR 0x2A3F /**< Alert Status characteristic UUID. */
Vincent Coubard 0:f2542974c862 65 #define BLE_UUID_BATTERY_LEVEL_CHAR 0x2A19 /**< Battery Level characteristic UUID. */
Vincent Coubard 0:f2542974c862 66 #define BLE_UUID_BLOOD_PRESSURE_FEATURE_CHAR 0x2A49 /**< Blood Pressure Feature characteristic UUID. */
Vincent Coubard 0:f2542974c862 67 #define BLE_UUID_BLOOD_PRESSURE_MEASUREMENT_CHAR 0x2A35 /**< Blood Pressure Measurement characteristic UUID. */
Vincent Coubard 0:f2542974c862 68 #define BLE_UUID_BODY_SENSOR_LOCATION_CHAR 0x2A38 /**< Body Sensor Location characteristic UUID. */
Vincent Coubard 0:f2542974c862 69 #define BLE_UUID_BOOT_KEYBOARD_INPUT_REPORT_CHAR 0x2A22 /**< Boot Keyboard Input Report characteristic UUID. */
Vincent Coubard 0:f2542974c862 70 #define BLE_UUID_BOOT_KEYBOARD_OUTPUT_REPORT_CHAR 0x2A32 /**< Boot Keyboard Output Report characteristic UUID. */
Vincent Coubard 0:f2542974c862 71 #define BLE_UUID_BOOT_MOUSE_INPUT_REPORT_CHAR 0x2A33 /**< Boot Mouse Input Report characteristic UUID. */
Vincent Coubard 0:f2542974c862 72 #define BLE_UUID_CURRENT_TIME_CHAR 0x2A2B /**< Current Time characteristic UUID. */
Vincent Coubard 0:f2542974c862 73 #define BLE_UUID_DATE_TIME_CHAR 0x2A08 /**< Date Time characteristic UUID. */
Vincent Coubard 0:f2542974c862 74 #define BLE_UUID_DAY_DATE_TIME_CHAR 0x2A0A /**< Day Date Time characteristic UUID. */
Vincent Coubard 0:f2542974c862 75 #define BLE_UUID_DAY_OF_WEEK_CHAR 0x2A09 /**< Day Of Week characteristic UUID. */
Vincent Coubard 0:f2542974c862 76 #define BLE_UUID_DST_OFFSET_CHAR 0x2A0D /**< Dst Offset characteristic UUID. */
Vincent Coubard 0:f2542974c862 77 #define BLE_UUID_EXACT_TIME_256_CHAR 0x2A0C /**< Exact Time 256 characteristic UUID. */
Vincent Coubard 0:f2542974c862 78 #define BLE_UUID_FIRMWARE_REVISION_STRING_CHAR 0x2A26 /**< Firmware Revision String characteristic UUID. */
Vincent Coubard 0:f2542974c862 79 #define BLE_UUID_GLUCOSE_FEATURE_CHAR 0x2A51 /**< Glucose Feature characteristic UUID. */
Vincent Coubard 0:f2542974c862 80 #define BLE_UUID_GLUCOSE_MEASUREMENT_CHAR 0x2A18 /**< Glucose Measurement characteristic UUID. */
Vincent Coubard 0:f2542974c862 81 #define BLE_UUID_GLUCOSE_MEASUREMENT_CONTEXT_CHAR 0x2A34 /**< Glucose Measurement Context characteristic UUID. */
Vincent Coubard 0:f2542974c862 82 #define BLE_UUID_HARDWARE_REVISION_STRING_CHAR 0x2A27 /**< Hardware Revision String characteristic UUID. */
Vincent Coubard 0:f2542974c862 83 #define BLE_UUID_HEART_RATE_CONTROL_POINT_CHAR 0x2A39 /**< Heart Rate Control Point characteristic UUID. */
Vincent Coubard 0:f2542974c862 84 #define BLE_UUID_HEART_RATE_MEASUREMENT_CHAR 0x2A37 /**< Heart Rate Measurement characteristic UUID. */
Vincent Coubard 0:f2542974c862 85 #define BLE_UUID_HID_CONTROL_POINT_CHAR 0x2A4C /**< Hid Control Point characteristic UUID. */
Vincent Coubard 0:f2542974c862 86 #define BLE_UUID_HID_INFORMATION_CHAR 0x2A4A /**< Hid Information characteristic UUID. */
Vincent Coubard 0:f2542974c862 87 #define BLE_UUID_IEEE_REGULATORY_CERTIFICATION_DATA_LIST_CHAR 0x2A2A /**< IEEE Regulatory Certification Data List characteristic UUID. */
Vincent Coubard 0:f2542974c862 88 #define BLE_UUID_INTERMEDIATE_CUFF_PRESSURE_CHAR 0x2A36 /**< Intermediate Cuff Pressure characteristic UUID. */
Vincent Coubard 0:f2542974c862 89 #define BLE_UUID_INTERMEDIATE_TEMPERATURE_CHAR 0x2A1E /**< Intermediate Temperature characteristic UUID. */
Vincent Coubard 0:f2542974c862 90 #define BLE_UUID_LOCAL_TIME_INFORMATION_CHAR 0x2A0F /**< Local Time Information characteristic UUID. */
Vincent Coubard 0:f2542974c862 91 #define BLE_UUID_MANUFACTURER_NAME_STRING_CHAR 0x2A29 /**< Manufacturer Name String characteristic UUID. */
Vincent Coubard 0:f2542974c862 92 #define BLE_UUID_MEASUREMENT_INTERVAL_CHAR 0x2A21 /**< Measurement Interval characteristic UUID. */
Vincent Coubard 0:f2542974c862 93 #define BLE_UUID_MODEL_NUMBER_STRING_CHAR 0x2A24 /**< Model Number String characteristic UUID. */
Vincent Coubard 0:f2542974c862 94 #define BLE_UUID_UNREAD_ALERT_CHAR 0x2A45 /**< Unread Alert characteristic UUID. */
Vincent Coubard 0:f2542974c862 95 #define BLE_UUID_NEW_ALERT_CHAR 0x2A46 /**< New Alert characteristic UUID. */
Vincent Coubard 0:f2542974c862 96 #define BLE_UUID_PNP_ID_CHAR 0x2A50 /**< PNP Id characteristic UUID. */
Vincent Coubard 0:f2542974c862 97 #define BLE_UUID_PROTOCOL_MODE_CHAR 0x2A4E /**< Protocol Mode characteristic UUID. */
Vincent Coubard 0:f2542974c862 98 #define BLE_UUID_RECORD_ACCESS_CONTROL_POINT_CHAR 0x2A52 /**< Record Access Control Point characteristic UUID. */
Vincent Coubard 0:f2542974c862 99 #define BLE_UUID_REFERENCE_TIME_INFORMATION_CHAR 0x2A14 /**< Reference Time Information characteristic UUID. */
Vincent Coubard 0:f2542974c862 100 #define BLE_UUID_REPORT_CHAR 0x2A4D /**< Report characteristic UUID. */
Vincent Coubard 0:f2542974c862 101 #define BLE_UUID_REPORT_MAP_CHAR 0x2A4B /**< Report Map characteristic UUID. */
Vincent Coubard 0:f2542974c862 102 #define BLE_UUID_RINGER_CONTROL_POINT_CHAR 0x2A40 /**< Ringer Control Point characteristic UUID. */
Vincent Coubard 0:f2542974c862 103 #define BLE_UUID_RINGER_SETTING_CHAR 0x2A41 /**< Ringer Setting characteristic UUID. */
Vincent Coubard 0:f2542974c862 104 #define BLE_UUID_SCAN_INTERVAL_WINDOW_CHAR 0x2A4F /**< Scan Interval Window characteristic UUID. */
Vincent Coubard 0:f2542974c862 105 #define BLE_UUID_SCAN_REFRESH_CHAR 0x2A31 /**< Scan Refresh characteristic UUID. */
Vincent Coubard 0:f2542974c862 106 #define BLE_UUID_SERIAL_NUMBER_STRING_CHAR 0x2A25 /**< Serial Number String characteristic UUID. */
Vincent Coubard 0:f2542974c862 107 #define BLE_UUID_SOFTWARE_REVISION_STRING_CHAR 0x2A28 /**< Software Revision String characteristic UUID. */
Vincent Coubard 0:f2542974c862 108 #define BLE_UUID_SUPPORTED_NEW_ALERT_CATEGORY_CHAR 0x2A47 /**< Supported New Alert Category characteristic UUID. */
Vincent Coubard 0:f2542974c862 109 #define BLE_UUID_SUPPORTED_UNREAD_ALERT_CATEGORY_CHAR 0x2A48 /**< Supported Unread Alert Category characteristic UUID. */
Vincent Coubard 0:f2542974c862 110 #define BLE_UUID_SYSTEM_ID_CHAR 0x2A23 /**< System Id characteristic UUID. */
Vincent Coubard 0:f2542974c862 111 #define BLE_UUID_TEMPERATURE_MEASUREMENT_CHAR 0x2A1C /**< Temperature Measurement characteristic UUID. */
Vincent Coubard 0:f2542974c862 112 #define BLE_UUID_TEMPERATURE_TYPE_CHAR 0x2A1D /**< Temperature Type characteristic UUID. */
Vincent Coubard 0:f2542974c862 113 #define BLE_UUID_TIME_ACCURACY_CHAR 0x2A12 /**< Time Accuracy characteristic UUID. */
Vincent Coubard 0:f2542974c862 114 #define BLE_UUID_TIME_SOURCE_CHAR 0x2A13 /**< Time Source characteristic UUID. */
Vincent Coubard 0:f2542974c862 115 #define BLE_UUID_TIME_UPDATE_CONTROL_POINT_CHAR 0x2A16 /**< Time Update Control Point characteristic UUID. */
Vincent Coubard 0:f2542974c862 116 #define BLE_UUID_TIME_UPDATE_STATE_CHAR 0x2A17 /**< Time Update State characteristic UUID. */
Vincent Coubard 0:f2542974c862 117 #define BLE_UUID_TIME_WITH_DST_CHAR 0x2A11 /**< Time With Dst characteristic UUID. */
Vincent Coubard 0:f2542974c862 118 #define BLE_UUID_TIME_ZONE_CHAR 0x2A0E /**< Time Zone characteristic UUID. */
Vincent Coubard 0:f2542974c862 119 #define BLE_UUID_TX_POWER_LEVEL_CHAR 0x2A07 /**< TX Power Level characteristic UUID. */
Vincent Coubard 0:f2542974c862 120 #define BLE_UUID_CSC_FEATURE_CHAR 0x2A5C /**< Cycling Speed and Cadence Feature characteristic UUID. */
Vincent Coubard 0:f2542974c862 121 #define BLE_UUID_CSC_MEASUREMENT_CHAR 0x2A5B /**< Cycling Speed and Cadence Measurement characteristic UUID. */
Vincent Coubard 0:f2542974c862 122 #define BLE_UUID_RSC_FEATURE_CHAR 0x2A54 /**< Running Speed and Cadence Feature characteristic UUID. */
Vincent Coubard 0:f2542974c862 123 #define BLE_UUID_SC_CTRLPT_CHAR 0x2A55 /**< Speed and Cadence Control Point UUID. */
Vincent Coubard 0:f2542974c862 124 #define BLE_UUID_RSC_MEASUREMENT_CHAR 0x2A53 /**< Running Speed and Cadence Measurement characteristic UUID. */
Vincent Coubard 0:f2542974c862 125 #define BLE_UUID_SENSOR_LOCATION_CHAR 0x2A5D /**< Sensor Location characteristic UUID. */
Vincent Coubard 0:f2542974c862 126 #define BLE_UUID_EXTERNAL_REPORT_REF_DESCR 0x2907 /**< External Report Reference descriptor UUID. */
Vincent Coubard 0:f2542974c862 127 #define BLE_UUID_REPORT_REF_DESCR 0x2908 /**< Report Reference descriptor UUID. */
Vincent Coubard 0:f2542974c862 128 /** @} */
Vincent Coubard 0:f2542974c862 129
Vincent Coubard 0:f2542974c862 130 /** @defgroup ALERT_LEVEL_VALUES Definitions for the Alert Level characteristic values
Vincent Coubard 0:f2542974c862 131 * @{ */
Vincent Coubard 0:f2542974c862 132 #define BLE_CHAR_ALERT_LEVEL_NO_ALERT 0x00 /**< No Alert. */
Vincent Coubard 0:f2542974c862 133 #define BLE_CHAR_ALERT_LEVEL_MILD_ALERT 0x01 /**< Mild Alert. */
Vincent Coubard 0:f2542974c862 134 #define BLE_CHAR_ALERT_LEVEL_HIGH_ALERT 0x02 /**< High Alert. */
Vincent Coubard 0:f2542974c862 135 /** @} */
Vincent Coubard 0:f2542974c862 136
Vincent Coubard 0:f2542974c862 137 #define BLE_SRV_ENCODED_REPORT_REF_LEN 2 /**< The length of an encoded Report Reference Descriptor. */
Vincent Coubard 0:f2542974c862 138 #define BLE_CCCD_VALUE_LEN 2 /**< The length of a CCCD value. */
Vincent Coubard 0:f2542974c862 139
vcoubard 19:47192cb9def7 140 /**@brief Type definition for error handler function that will be called in case of an error in
Vincent Coubard 0:f2542974c862 141 * a service or a service library module. */
Vincent Coubard 0:f2542974c862 142 typedef void (*ble_srv_error_handler_t) (uint32_t nrf_error);
Vincent Coubard 0:f2542974c862 143
vcoubard 19:47192cb9def7 144
Vincent Coubard 0:f2542974c862 145 /**@brief Value of a Report Reference descriptor.
Vincent Coubard 0:f2542974c862 146 *
vcoubard 19:47192cb9def7 147 * @details This is mapping information that maps the parent characteristic to the Report ID(s) and
Vincent Coubard 0:f2542974c862 148 * Report Type(s) defined within a Report Map characteristic.
Vincent Coubard 0:f2542974c862 149 */
Vincent Coubard 0:f2542974c862 150 typedef struct
Vincent Coubard 0:f2542974c862 151 {
vcoubard 19:47192cb9def7 152 uint8_t report_id; /**< Non-zero value if there is more than one instance of the same Report Type */
vcoubard 19:47192cb9def7 153 uint8_t report_type; /**< Type of Report characteristic (see @ref BLE_HIDS_REPORT_TYPE) */
Vincent Coubard 0:f2542974c862 154 } ble_srv_report_ref_t;
Vincent Coubard 0:f2542974c862 155
Vincent Coubard 0:f2542974c862 156 /**@brief UTF-8 string data type.
Vincent Coubard 0:f2542974c862 157 *
Vincent Coubard 0:f2542974c862 158 * @note The type can only hold a pointer to the string data (i.e. not the actual data).
Vincent Coubard 0:f2542974c862 159 */
Vincent Coubard 0:f2542974c862 160 typedef struct
Vincent Coubard 0:f2542974c862 161 {
Vincent Coubard 0:f2542974c862 162 uint16_t length; /**< String length. */
Vincent Coubard 0:f2542974c862 163 uint8_t * p_str; /**< String data. */
Vincent Coubard 0:f2542974c862 164 } ble_srv_utf8_str_t;
Vincent Coubard 0:f2542974c862 165
vcoubard 19:47192cb9def7 166
Vincent Coubard 0:f2542974c862 167 /**@brief Security settings structure.
Vincent Coubard 0:f2542974c862 168 * @details This structure contains the security options needed during initialization of the
Vincent Coubard 0:f2542974c862 169 * service.
Vincent Coubard 0:f2542974c862 170 */
Vincent Coubard 0:f2542974c862 171 typedef struct
Vincent Coubard 0:f2542974c862 172 {
Vincent Coubard 0:f2542974c862 173 ble_gap_conn_sec_mode_t read_perm; /**< Read permissions. */
Vincent Coubard 0:f2542974c862 174 ble_gap_conn_sec_mode_t write_perm; /**< Write permissions. */
Vincent Coubard 0:f2542974c862 175 } ble_srv_security_mode_t;
Vincent Coubard 0:f2542974c862 176
Vincent Coubard 0:f2542974c862 177 /**@brief Security settings structure.
Vincent Coubard 0:f2542974c862 178 * @details This structure contains the security options needed during initialization of the
vcoubard 19:47192cb9def7 179 * service. It can be used when the characteristics contains cccd.
Vincent Coubard 0:f2542974c862 180 */
Vincent Coubard 0:f2542974c862 181 typedef struct
Vincent Coubard 0:f2542974c862 182 {
vcoubard 19:47192cb9def7 183 ble_gap_conn_sec_mode_t cccd_write_perm; /**< Write permissions for Client Characteristic Configuration Descriptor. */
Vincent Coubard 0:f2542974c862 184 ble_gap_conn_sec_mode_t read_perm; /**< Read permissions. */
Vincent Coubard 0:f2542974c862 185 ble_gap_conn_sec_mode_t write_perm; /**< Write permissions. */
Vincent Coubard 0:f2542974c862 186 } ble_srv_cccd_security_mode_t;
Vincent Coubard 0:f2542974c862 187
Vincent Coubard 0:f2542974c862 188 /**@brief Function for decoding a CCCD value, and then testing if notification is
Vincent Coubard 0:f2542974c862 189 * enabled.
Vincent Coubard 0:f2542974c862 190 *
Vincent Coubard 0:f2542974c862 191 * @param[in] p_encoded_data Buffer where the encoded CCCD is stored.
Vincent Coubard 0:f2542974c862 192 *
vcoubard 19:47192cb9def7 193 * @retval TRUE If notification is enabled.
vcoubard 19:47192cb9def7 194 * @retval FALSE Otherwise.
Vincent Coubard 0:f2542974c862 195 */
Vincent Coubard 0:f2542974c862 196 static __INLINE bool ble_srv_is_notification_enabled(uint8_t * p_encoded_data)
Vincent Coubard 0:f2542974c862 197 {
Vincent Coubard 0:f2542974c862 198 uint16_t cccd_value = uint16_decode(p_encoded_data);
Vincent Coubard 0:f2542974c862 199 return ((cccd_value & BLE_GATT_HVX_NOTIFICATION) != 0);
Vincent Coubard 0:f2542974c862 200 }
Vincent Coubard 0:f2542974c862 201
Vincent Coubard 0:f2542974c862 202 /**@brief Function for decoding a CCCD value, and then testing if indication is
Vincent Coubard 0:f2542974c862 203 * enabled.
Vincent Coubard 0:f2542974c862 204 *
Vincent Coubard 0:f2542974c862 205 * @param[in] p_encoded_data Buffer where the encoded CCCD is stored.
Vincent Coubard 0:f2542974c862 206 *
vcoubard 19:47192cb9def7 207 * @retval TRUE If indication is enabled.
vcoubard 19:47192cb9def7 208 * @retval FALSE Otherwise.
Vincent Coubard 0:f2542974c862 209 */
Vincent Coubard 0:f2542974c862 210 static __INLINE bool ble_srv_is_indication_enabled(uint8_t * p_encoded_data)
Vincent Coubard 0:f2542974c862 211 {
Vincent Coubard 0:f2542974c862 212 uint16_t cccd_value = uint16_decode(p_encoded_data);
Vincent Coubard 0:f2542974c862 213 return ((cccd_value & BLE_GATT_HVX_INDICATION) != 0);
Vincent Coubard 0:f2542974c862 214 }
Vincent Coubard 0:f2542974c862 215
Vincent Coubard 0:f2542974c862 216 /**@brief Function for encoding a Report Reference Descriptor.
Vincent Coubard 0:f2542974c862 217 *
Vincent Coubard 0:f2542974c862 218 * @param[in] p_encoded_buffer The buffer of the encoded data.
Vincent Coubard 0:f2542974c862 219 * @param[in] p_report_ref Report Reference value to be encoded.
Vincent Coubard 0:f2542974c862 220 *
Vincent Coubard 0:f2542974c862 221 * @return Length of the encoded data.
Vincent Coubard 0:f2542974c862 222 */
Vincent Coubard 0:f2542974c862 223 uint8_t ble_srv_report_ref_encode(uint8_t * p_encoded_buffer,
Vincent Coubard 0:f2542974c862 224 const ble_srv_report_ref_t * p_report_ref);
Vincent Coubard 0:f2542974c862 225
vcoubard 19:47192cb9def7 226 /**@brief Function for making a UTF-8 structure refer to an ASCII string.
Vincent Coubard 0:f2542974c862 227 *
Vincent Coubard 0:f2542974c862 228 * @param[out] p_utf8 UTF-8 structure to be set.
Vincent Coubard 0:f2542974c862 229 * @param[in] p_ascii ASCII string to be referred to.
Vincent Coubard 0:f2542974c862 230 */
Vincent Coubard 0:f2542974c862 231 void ble_srv_ascii_to_utf8(ble_srv_utf8_str_t * p_utf8, char * p_ascii);
Vincent Coubard 0:f2542974c862 232
vcoubard 19:47192cb9def7 233
vcoubard 19:47192cb9def7 234 /**@brief Security Access enumeration.
vcoubard 19:47192cb9def7 235 * @details This enumeration gives the possible requirements for accessing a characteristic value.
vcoubard 19:47192cb9def7 236 */
vcoubard 19:47192cb9def7 237 typedef enum
vcoubard 19:47192cb9def7 238 {
vcoubard 19:47192cb9def7 239 SEC_NO_ACCESS = 0, /**< Not possible to access. */
vcoubard 19:47192cb9def7 240 SEC_OPEN = 1, /**< Access open. */
vcoubard 19:47192cb9def7 241 SEC_JUST_WORKS = 2, /**< Access possible with 'Just Works' security at least. */
vcoubard 19:47192cb9def7 242 SEC_MITM = 3, /**< Access possible with 'MITM' security at least. */
vcoubard 19:47192cb9def7 243 SEC_SIGNED = 4, /**< Access possible with 'signed' security at least. */
vcoubard 19:47192cb9def7 244 SEC_SIGNED_MITM = 5 /**< Access possible with 'signed and MITM' security at least. */
vcoubard 19:47192cb9def7 245 }security_req_t;
vcoubard 19:47192cb9def7 246
vcoubard 19:47192cb9def7 247
vcoubard 19:47192cb9def7 248 /**@brief Add characteristic parameters structure.
vcoubard 19:47192cb9def7 249 * @details This structure contains the parameters needed to use the @ref characteristic_add function.
vcoubard 19:47192cb9def7 250 */
vcoubard 19:47192cb9def7 251 typedef struct
vcoubard 19:47192cb9def7 252 {
vcoubard 19:47192cb9def7 253 uint16_t uuid; /**< Characteristic UUID (16 bits UUIDs).*/
vcoubard 19:47192cb9def7 254 uint8_t uuid_type; /**< Base UUID. If 0, the Bluetooth SIG UUID will be used. Otherwise, this should be a value returned by @ref sd_ble_uuid_vs_add when adding the base UUID.*/
vcoubard 19:47192cb9def7 255 uint16_t max_len; /**< Maximum length of the characteristic value.*/
vcoubard 19:47192cb9def7 256 uint16_t init_len; /**< Initial length of the characteristic value.*/
vcoubard 19:47192cb9def7 257 uint8_t * p_init_value; /**< Initial encoded value of the characteristic.*/
vcoubard 19:47192cb9def7 258 bool is_var_len; /**< Indicates if the characteristic value has variable length.*/
vcoubard 19:47192cb9def7 259 ble_gatt_char_props_t char_props; /**< Characteristic properties.*/
vcoubard 19:47192cb9def7 260 bool is_defered_read; /**< Indicate if deferred read operations are supported.*/
vcoubard 19:47192cb9def7 261 bool is_defered_write; /**< Indicate if deferred write operations are supported.*/
vcoubard 19:47192cb9def7 262 security_req_t read_access; /**< Security requirement for reading the characteristic value.*/
vcoubard 19:47192cb9def7 263 security_req_t write_access; /**< Security requirement for writing the characteristic value.*/
vcoubard 19:47192cb9def7 264 security_req_t cccd_write_access; /**< Security requirement for writing the characteristic's CCCD.*/
vcoubard 19:47192cb9def7 265 bool is_value_local; /**< Indicate if the content of the characteristic is to be stored locally or in the stack.*/
vcoubard 19:47192cb9def7 266 } ble_add_char_params_t;
vcoubard 19:47192cb9def7 267
vcoubard 19:47192cb9def7 268
vcoubard 19:47192cb9def7 269 /**@brief Function for adding a characteristic to a given service.
vcoubard 19:47192cb9def7 270 *
vcoubard 19:47192cb9def7 271 * If no pointer is given for the initial value,
vcoubard 19:47192cb9def7 272 * the initial length parameter will be ignored and the initial length will be 0.
vcoubard 19:47192cb9def7 273 *
vcoubard 19:47192cb9def7 274 * @param[in] service_handle Handle of the service to which the characteristic is to be added.
vcoubard 19:47192cb9def7 275 * @param[in] p_char_props Information needed to add the characteristic.
vcoubard 19:47192cb9def7 276 * @param[out] p_char_handle Handle of the added characteristic.
vcoubard 19:47192cb9def7 277 *
vcoubard 19:47192cb9def7 278 * @retval NRF_SUCCESS If the characteristic was added successfully. Otherwise, an error code is returned.
vcoubard 19:47192cb9def7 279 */
vcoubard 19:47192cb9def7 280 uint32_t characteristic_add(uint16_t service_handle,
vcoubard 19:47192cb9def7 281 ble_add_char_params_t * p_char_props,
vcoubard 19:47192cb9def7 282 ble_gatts_char_handles_t * p_char_handle);
vcoubard 19:47192cb9def7 283
vcoubard 19:47192cb9def7 284
Vincent Coubard 0:f2542974c862 285 #endif // BLE_SRV_COMMON_H__
Vincent Coubard 0:f2542974c862 286
vcoubard 1:ebc0e0ef0a11 287 /** @} */