-
Notifications
You must be signed in to change notification settings - Fork 3
/
cy_ble_hts.h
248 lines (199 loc) · 11 KB
/
cy_ble_hts.h
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
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
/***************************************************************************//**
* \file cy_ble_hts.h
* \version 3.60
*
* \brief
* Contains the function prototypes and constants for Health Thermometer service.
*
********************************************************************************
* \copyright
* Copyright 2017-2021, Cypress Semiconductor Corporation. All rights reserved.
* You may use this file only in accordance with the license, terms, conditions,
* disclaimers, and limitations in the end user license agreement accompanying
* the software package with which this file was provided.
*******************************************************************************/
#ifndef CY_BLE_HTS_H
#define CY_BLE_HTS_H
#include "cy_ble.h"
#if defined(CY_IP_MXBLESS)
/* C binding of definitions if building with C++ compiler */
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/*******************************************************************************
* API Constants
*******************************************************************************/
/* Valid Range descriptor length */
#define CY_BLE_HTS_VRD_LEN (0x04u)
/* Health Thermometer measurement flag bits */
#define CY_BLE_HTS_MEAS_FLAG_TEMP_UNITS_BIT (0x01u << 0u)
#define CY_BLE_HTS_MEAS_FLAG_TIME_STAMP_BIT (0x01u << 1u)
#define CY_BLE_HTS_MEAS_FLAG_TEMP_TYPE_BIT (0x01u << 2u)
/*******************************************************************************
* Data Types
*******************************************************************************/
/**
* \addtogroup group_ble_service_api_HTS_definitions
* \{
*/
/** HTS Characteristic indexes */
typedef enum
{
CY_BLE_HTS_TEMP_MEASURE, /**< Temperature Measurement Characteristic index */
CY_BLE_HTS_TEMP_TYPE, /**< Temperature Type Characteristic index */
CY_BLE_HTS_INTERM_TEMP, /**< Intermediate Temperature Characteristic index*/
CY_BLE_HTS_MEASURE_INTERVAL, /**< Measurement Interval Characteristic index */
CY_BLE_HTS_CHAR_COUNT /**< Total Count of HTS Characteristics */
} cy_en_ble_hts_char_index_t;
/** HTS Characteristic Descriptors indexes */
typedef enum
{
CY_BLE_HTS_CCCD, /**< Client Characteristic Configuration descriptor index */
CY_BLE_HTS_VRD, /**< Valid Range descriptor index */
CY_BLE_HTS_DESCR_COUNT /**< Total Count of Descriptors */
} cy_en_ble_hts_descr_index_t;
/** HTS Characteristic with descriptors */
typedef struct
{
cy_ble_gatt_db_attr_handle_t charHandle; /**< Handle of Characteristic Value */
cy_ble_gatt_db_attr_handle_t descrHandle[CY_BLE_HTS_DESCR_COUNT]; /**< Handle of Descriptor */
} cy_stc_ble_htss_char_t;
/** Structure with Health Thermometer Service attribute handles */
typedef struct
{
/** Health Thermometer Service Handle */
cy_ble_gatt_db_attr_handle_t serviceHandle;
/** Health Thermometer Service Characteristic handles */
cy_stc_ble_htss_char_t charInfo[CY_BLE_HTS_CHAR_COUNT];
} cy_stc_ble_htss_t;
/** HTS Characteristic with descriptors */
typedef struct
{
cy_ble_gatt_db_attr_handle_t descrHandle[CY_BLE_HTS_DESCR_COUNT]; /**< Handle of Descriptor */
cy_ble_gatt_db_attr_handle_t valueHandle; /**< Handle of Report Characteristic value */
cy_ble_gatt_db_attr_handle_t endHandle; /**< End handle of Characteristic */
uint8_t properties; /**< Properties for Value Field */
} cy_stc_ble_htsc_char_t;
/** Structure with Discovered Attributes Information of Health Thermometer Service */
typedef struct
{
/** Characteristics handles array */
cy_stc_ble_htsc_char_t charInfo[CY_BLE_HTS_CHAR_COUNT];
} cy_stc_ble_htsc_t;
/** HTS Characteristic Value parameter structure */
typedef struct
{
cy_stc_ble_conn_handle_t connHandle; /**< Peer Device Handle */
cy_en_ble_hts_char_index_t charIndex; /**< Index of Service Characteristic */
cy_stc_ble_gatt_value_t *value; /**< Characteristic Value */
} cy_stc_ble_hts_char_value_t;
/** HTS Characteristic descriptor value parameter structure */
typedef struct
{
cy_stc_ble_conn_handle_t connHandle; /**< Peer Device Handle */
cy_en_ble_hts_char_index_t charIndex; /**< Index of Service Characteristic */
cy_en_ble_hts_descr_index_t descrIndex; /**< Index of Descriptor */
cy_stc_ble_gatt_value_t *value; /**< Characteristic Value */
} cy_stc_ble_hts_descr_value_t;
/** The IEEE-11073 FLOAT-Type is defined as a 32-bit value
* with a 24-bit mantissa and an 8-bit exponent. */
typedef struct
{
int8_t exponent; /**< Base 10 exponent */
int32_t mantissa; /**< Mantissa, should be using only 24 bits */
} cy_ble_hts_float32;
/** Temperature Type measurement indicates where the temperature was measured */
typedef enum
{
CY_BLE_HTS_TEMP_TYPE_ARMPIT = 0x01u, /**< Armpit */
CY_BLE_HTS_TEMP_TYPE_BODY, /**< Body (general) */
CY_BLE_HTS_TEMP_TYPE_EAR, /**< Ear (usually ear lobe) */
CY_BLE_HTS_TEMP_TYPE_FINGER, /**< Finger */
CY_BLE_HTS_TEMP_TYPE_GI_TRACT, /**< Gastro-intestinal Tract */
CY_BLE_HTS_TEMP_TYPE_MOUTH, /**< Mouth */
CY_BLE_HTS_TEMP_TYPE_RECTUM, /**< Rectum */
CY_BLE_HTS_TEMP_TYPE_TOE, /**< Toe */
CY_BLE_HTS_TEMP_TYPE_TYMPANUM /**< Tympanum (ear drum) */
} cy_stc_ble_hts_temp_type_t;
/** Service configuration structure (server) */
typedef struct
{
/** Service GATT DB Handles structure */
const cy_stc_ble_htss_t *attrInfo;
} cy_stc_ble_htss_config_t;
/** Service Configuration structure (client) */
typedef struct
{
/** Structure with Discovered Attributes Information */
cy_stc_ble_htsc_t *attrInfo;
/** The Discovery Service index */
uint8_t serviceDiscIdx;
} cy_stc_ble_htsc_config_t;
/** \} */
/*******************************************************************************
* Function Prototypes
*******************************************************************************/
/**
* \addtogroup group_ble_service_api_HTS_server_client
* \{
*/
cy_en_ble_api_result_t Cy_BLE_HTSS_Init(const cy_stc_ble_htss_config_t *config);
cy_en_ble_api_result_t Cy_BLE_HTSC_Init(const cy_stc_ble_htsc_config_t *config);
void Cy_BLE_HTS_RegisterAttrCallback(cy_ble_callback_t callbackFunc);
/** \} */
/**
* \addtogroup group_ble_service_api_HTS_server
* \{
*/
cy_en_ble_api_result_t Cy_BLE_HTSS_SetCharacteristicValue(cy_en_ble_hts_char_index_t charIndex, uint8_t attrSize,
uint8_t *attrValue);
cy_en_ble_api_result_t Cy_BLE_HTSS_GetCharacteristicValue(cy_en_ble_hts_char_index_t charIndex, uint8_t attrSize,
uint8_t *attrValue);
cy_en_ble_api_result_t Cy_BLE_HTSS_SetCharacteristicDescriptor(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex,
cy_en_ble_hts_descr_index_t descrIndex, uint8_t attrSize,
uint8_t *attrValue);
cy_en_ble_api_result_t Cy_BLE_HTSS_GetCharacteristicDescriptor(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex,
cy_en_ble_hts_descr_index_t descrIndex, uint8_t attrSize,
uint8_t *attrValue);
cy_en_ble_api_result_t Cy_BLE_HTSS_SendNotification(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex, uint8_t attrSize,
uint8_t *attrValue);
cy_en_ble_api_result_t Cy_BLE_HTSS_SendIndication(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex, uint8_t attrSize,
uint8_t *attrValue);
/** \} */
/**
* \addtogroup group_ble_service_api_HTS_client
* \{
*/
cy_en_ble_api_result_t Cy_BLE_HTSC_SetCharacteristicValue(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex, uint8_t attrSize,
uint8_t *attrValue);
cy_en_ble_api_result_t Cy_BLE_HTSC_GetCharacteristicValue(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex);
cy_en_ble_api_result_t Cy_BLE_HTSC_SetCharacteristicDescriptor(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex,
cy_en_ble_hts_descr_index_t descrIndex, uint8_t attrSize,
uint8_t *attrValue);
cy_en_ble_api_result_t Cy_BLE_HTSC_GetCharacteristicDescriptor(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex,
cy_en_ble_hts_descr_index_t descrIndex);
/** \} */
cy_ble_gatt_db_attr_handle_t Cy_BLE_HTSC_GetCharacteristicDescriptorHandle(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex,
cy_en_ble_hts_descr_index_t descrIndex);
cy_ble_gatt_db_attr_handle_t Cy_BLE_HTSC_GetCharacteristicValueHandle(cy_stc_ble_conn_handle_t connHandle,
cy_en_ble_hts_char_index_t charIndex);
/*******************************************************************************
* External Data references
*******************************************************************************/
extern const cy_stc_ble_htss_config_t *cy_ble_htssConfigPtr;
extern const cy_stc_ble_htsc_config_t *cy_ble_htscConfigPtr;
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* CY_IP_MXBLESS */
#endif /* CY_BLE_HTS_H */
/* [] END OF FILE */