1 /** 2 ****************************************************************************** 3 * 4 * @file ble_prf_utils.h 5 * 6 * @brief Profile/Service Utilities API 7 * 8 ****************************************************************************** 9 * @attention 10 #####Copyright (c) 2019 GOODIX 11 All rights reserved. 12 13 Redistribution and use in source and binary forms, with or without 14 modification, are permitted provided that the following conditions are met: 15 * Redistributions of source code must retain the above copyright 16 notice, this list of conditions and the following disclaimer. 17 * Redistributions in binary form must reproduce the above copyright 18 notice, this list of conditions and the following disclaimer in the 19 documentation and/or other materials provided with the distribution. 20 * Neither the name of GOODIX nor the names of its contributors may be used 21 to endorse or promote products derived from this software without 22 specific prior written permission. 23 24 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 25 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 26 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 27 ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE 28 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 29 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 30 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 31 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 32 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 33 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 34 POSSIBILITY OF SUCH DAMAGE. 35 ***************************************************************************************** 36 */ 37 38 /** 39 * @addtogroup BLE_SRV BLE Services 40 * @{ 41 * @brief Definitions and prototypes for the BLE Service interface. 42 */ 43 44 /** 45 * @defgroup BLE_PRF_UTILS Profile/Service Utilities 46 * @{ 47 * @brief Definitions and prototypes for the Profile/Service Utilities interface. 48 * 49 */ 50 51 #ifndef __BLE_PRF_UTILS_H__ 52 #define __BLE_PRF_UTILS_H__ 53 54 #include <stdbool.h> 55 #include "ble_prf_types.h" 56 57 /** 58 * @defgroup BLE_PRF_UTILS_FUNCTION Functions 59 * @{ 60 */ 61 /** 62 ***************************************************************************************** 63 * @brief Pack Characteristic Presentation Format descriptor value to a buffer. 64 * 65 * @param[out] p_packed_val: Pointer to the packed buffer. 66 * @param[in] p_char_pres_fmt: Pointer to the structure of Characteristic Presentation 67 * Format value. See @ref prf_char_pres_fmt_t. 68 ***************************************************************************************** 69 */ 70 void prf_pack_char_pres_fmt(uint8_t *p_packed_val, const prf_char_pres_fmt_t *p_char_pres_fmt); 71 72 /** 73 ***************************************************************************************** 74 * @brief Unpack the data in a buffer to the structure of Characteristic Presentation 75 * Format descriptor value. 76 * 77 * @param[in] p_packed_val: Pointer to the packed buffer. 78 * @param[out] p_char_pres_fmt: Pointer to the structure of Characteristic Presentation 79 * Format value. See @ref prf_char_pres_fmt_t. 80 ***************************************************************************************** 81 */ 82 void prf_unpack_char_pres_fmt(const uint8_t *p_packed_val, prf_char_pres_fmt_t *p_char_pres_fmt); 83 84 /** 85 ***************************************************************************************** 86 * @brief Pack the value in date-time structure to a buffer. 87 * 88 * @param[out] p_packed_val: Pointer to a packed buffer. 89 * @param[in] p_date_time: Pointer to the date-time structure, see @ref prf_date_time_t. 90 * 91 * @return The size of packed value. 92 ***************************************************************************************** 93 */ 94 uint8_t prf_pack_date_time(uint8_t *p_packed_val, const prf_date_time_t *p_date_time); 95 96 /** 97 ***************************************************************************************** 98 * @brief Unpack the data in buffer to the date-time structure. 99 * 100 * @param[in] p_packed_val: Pointer to the packed buffer. 101 * @param[out] p_date_time: Pointer to date-time structure, see @ref prf_date_time_t. 102 * 103 * @return The size of packed value 104 ***************************************************************************************** 105 */ 106 uint8_t prf_unpack_date_time(const uint8_t *p_packed_val, prf_date_time_t *p_date_time); 107 108 /** 109 ***************************************************************************************** 110 * @brief Find the attribute index by handle. 111 * 112 * @param[in] handle: The handle of a characteristic in BLE Stack database. 113 * @param[in] start_hdl: The start handle of a service in BLE Stack database. 114 * @param[in] char_nb: The number of the characteristics in a service's attribute table. 115 * @param[in] p_char_mask: Pointer to the mask of characteristics which are added 116 * into BLE Stack database from the service's attribute table. 117 * 118 * @return The handle's index in the service's attribute table. 119 ***************************************************************************************** 120 */ 121 uint8_t prf_find_idx_by_handle(uint16_t handle, uint16_t start_hdl, 122 uint8_t char_nb, uint8_t *p_char_mask); 123 124 /** 125 ***************************************************************************************** 126 * @brief Find the attribute handle by index. 127 * 128 * @param[in] idx: The attribute index in the service's attribute table. 129 * @param[in] start_hdl: The start handle value in the database. 130 * @param[in] p_char_mask: Pointer to the mask of characteristics which are added 131 * into BLE Stack database from the service's attribute table. 132 * 133 * @return The handle of the attribute with the index in BLE Stack database. 134 ***************************************************************************************** 135 */ 136 uint16_t prf_find_handle_by_idx(uint8_t idx, uint16_t start_hdl, uint8_t *p_char_mask); 137 138 /** 139 ***************************************************************************************** 140 * @brief Check if a CCCD value is valid. 141 * 142 * @param[in] cccd_value: The CCCD value to be checked. 143 * 144 * @return True if valid, otherwise false. 145 **************************************************************************************** 146 */ 147 bool prf_is_cccd_value_valid(uint16_t cccd_value); 148 149 /** 150 ***************************************************************************************** 151 * @brief Check if a CCCD value is notification enabled. 152 * 153 * @param[in] cccd_value: The CCCD value to be checked. 154 * 155 * @return true if enabled, otherwise false. 156 **************************************************************************************** 157 */ 158 bool prf_is_notification_enabled(uint16_t cccd_value); 159 160 /** 161 ***************************************************************************************** 162 * @brief Check if a CCCD value is indication enabled. 163 * 164 * @param[in] cccd_value: The CCCD value to be checked 165 * 166 * @return true if enabled, otherwise false. 167 ***************************************************************************************** 168 */ 169 bool prf_is_indication_enabled(uint16_t cccd_value); 170 /** @} */ 171 172 #endif /* _BLE_PRF_UTILS_H_ */ 173 /** @} */ 174 /** @} */ 175 176