/** * Copyright (c) 2014 - 2018, Nordic Semiconductor ASA * * All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, * are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, this * list of conditions and the following disclaimer. * * 2. Redistributions in binary form, except as embedded into a Nordic * Semiconductor ASA integrated circuit in a product or a software update for * such product, must reproduce the above copyright notice, this list of * conditions and the following disclaimer in the documentation and/or other * materials provided with the distribution. * * 3. Neither the name of Nordic Semiconductor ASA nor the names of its * contributors may be used to endorse or promote products derived from this * software without specific prior written permission. * * 4. This software, with or without modification, must only be used with a * Nordic Semiconductor ASA integrated circuit. * * 5. Any software provided in binary form under this license must not be reverse * engineered, decompiled, modified and/or disassembled. * * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * */ #ifndef _CONN_MW_BLE_GAP_H #define _CONN_MW_BLE_GAP_H #include #ifdef __cplusplus extern "C" { #endif /** * @addtogroup sercon_mw_s132_ble_gap GAP Middleware command handlers * @{ * @ingroup sercon_mw_s132 */ #if defined(NRF_SD_BLE_API_VERSION) && (NRF_SD_BLE_API_VERSION <= 5) /**@brief Handles @ref sd_ble_gap_adv_data_set command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_adv_data_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); #endif /**@brief Handles @ref sd_ble_gap_adv_start command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_adv_start(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_adv_stop command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_adv_stop(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_conn_param_update command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_conn_param_update(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_disconnect command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_disconnect(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_tx_power_set command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_tx_power_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_appearance_set command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_appearance_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_appearance_get command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_appearance_get(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_ppcp_set command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_ppcp_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_ppcp_get command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_ppcp_get(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_device_name_get command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_device_name_get(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_device_name_set command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_device_name_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_authenticate command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_authenticate(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_sec_params_reply command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_sec_params_reply(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_auth_key_reply command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_auth_key_reply(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_sec_info_reply command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_sec_info_reply(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_conn_sec_get command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_conn_sec_get(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_rssi_start command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_rssi_start(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_rssi_stop command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_rssi_stop(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_rssi_get command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_rssi_get(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_connect command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_connect(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_connect_cancel command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_connect_cancel(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_scan_start command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_scan_start(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_scan_stop command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_scan_stop(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_encrypt command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_encrypt(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_keypress_notify command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_keypress_notify(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_lesc_dhkey_reply command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_lesc_dhkey_reply(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_lesc_oob_data_set command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_lesc_oob_data_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_lesc_oob_data_get command and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_lesc_oob_data_get(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Allocates instance in m_conn_keys_table[] for storage of encryption keys. * * @param[in] conn_handle Connection handle. * @param[out] p_index Pointer to the index of allocated instance. * * @retval NRF_SUCCESS Success. * @retval NRF_ERROR_NO_MEM No free instance available. */ uint32_t conn_mw_ble_gap_sec_context_create(uint16_t conn_handle, uint32_t *p_index); /**@brief Releases the instance identified by a connection handle. * * @param[in] conn_handle Connection handle. * @retval NRF_SUCCESS Success. * @retval NRF_ERROR_NOT_FOUND Instance with the @p conn_handle not found. */ uint32_t conn_mw_ble_gap_sec_context_destroy(uint16_t conn_handle); /**@brief Finds index of instance identified by a connection handle in m_conn_keys_table[]. * * @param[in] conn_handle Connection handle. * @param[out] p_index Pointer to the index of the context instance. * * @retval NRF_SUCCESS Success. * @retval NRF_ERROR_NOT_FOUND Instance with the @p conn_handle not found. */ uint32_t conn_mw_ble_gap_sec_context_find(uint16_t conn_handle, uint32_t *p_index); /**@brief Handles @ref sd_ble_gap_addr_set command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_addr_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_addr_get command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_addr_get(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_privacy_set command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_privacy_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_privacy_get command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_privacy_get(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_whitelist_set command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_whitelist_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_device_identities_set command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_device_identities_set(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_phy_update command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ #if NRF_SD_BLE_API_VERSION >= 5 uint32_t conn_mw_ble_gap_phy_update(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); #endif #ifdef __cplusplus } #endif #if NRF_SD_BLE_API_VERSION >= 4 /**@brief Handles @ref sd_ble_gap_data_length_update command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_data_length_update(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_adv_set_configure command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_adv_set_configure(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_qos_channel_survey_start command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_qos_channel_survey_start(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); /**@brief Handles @ref sd_ble_gap_qos_channel_survey_stop command request and prepares response. * * @param[in] p_rx_buf Pointer to input buffer. * @param[in] rx_buf_len Size of @p p_rx_buf. * @param[out] p_tx_buf Pointer to output buffer. * @param[in,out] p_tx_buf_len \c in: Size of \p p_tx_buf buffer. * \c out: Length of valid data in \p p_tx_buf. * * @retval NRF_SUCCESS Handler success. * @retval NRF_ERROR_NULL Handler failure. NULL pointer supplied. * @retval NRF_ERROR_INVALID_LENGTH Handler failure. Incorrect buffer length. * @retval NRF_ERROR_INVALID_PARAM Handler failure. Invalid operation type. */ uint32_t conn_mw_ble_gap_qos_channel_survey_stop(uint8_t const * const p_rx_buf, uint32_t rx_buf_len, uint8_t * const p_tx_buf, uint32_t * const p_tx_buf_len); #endif #endif //_CONN_MW_BLE_GAP_H /** @} */