ht_xushuai/Realtek
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Realtek/inc/bluetooth/gap/gap_le_rf.h

657 lines
26 KiB
C
Raw Normal View History

第一次提交瑞昱
2025-11-25 10:21:47 +08:00
/**
*********************************************************************************************************
* Copyright(c) 2016, Realtek Semiconductor Corporation. All rights reserved.
*********************************************************************************************************
* @file gap_le_rf.h
* @brief Head file for GAP RF
* @details
* @author
* @date 2020-06-18
* @version v0.8
* *********************************************************************************************************
*/
/*============================================================================*
* Define to prevent recursive inclusion
*============================================================================*/
#ifndef GAP_LE_RF_H
#define GAP_LE_RF_H
#ifdef __cplusplus
extern "C"
{
#endif
/*============================================================================*
* Header Files
*============================================================================*/
#include "upperstack_config.h"
#include "gap_le.h"
/** @addtogroup GAP GAP Module
* @{
*/
/** @addtogroup GAP_LE GAP LE Module
* @{
*/
/** @addtogroup GAP_LE_RF GAP LE RF Module
* @{
*/
/*============================================================================*
* Macros
*============================================================================*/
/** @defgroup GAP_LE_RF_Exported_Macros GAP LE Rf Exported Macros
* @{
*/
/** @defgroup GAP_LE_RF_MSG_Types GAP LE RF Msg Types
* @{
*/
#define GAP_MSG_LE_RF_INFO 0xD1
/** End of GAP_LE_RF_MSG_Types
* @}
*/
/** @defgroup GAP_LE_RF_MSG_Opcodes GAP LE RF Msg Opcodes
* @{
*/
#define GAP_LE_RF_READ_RF_PATH_COMPENSATION 0x0000 //!<Response msg opcode for le_rf_read_rf_path_compensation
#define GAP_LE_RF_WRITE_RF_PATH_COMPENSATION 0x0001 //!<Response msg opcode for le_rf_write_rf_path_compensation
#define GAP_LE_RF_ENHANCED_READ_TRANSMIT_POWER_LEVEL 0x0010 //!<Response msg opcode for le_rf_enhanced_read_transmit_power_level
#define GAP_LE_RF_READ_REMOTE_TRANSMIT_POWER_LEVEL 0x0011 //!<Response msg opcode for le_rf_read_remote_transmit_power_level
#define GAP_LE_RF_SET_TRANSMIT_POWER_REPORTING_ENABLE 0x0012 //!<Response msg opcode for le_rf_set_transmit_power_reporting_enable
#define GAP_LE_RF_TRANSMIT_POWER_REPORTING_INFO 0x0013 //!<Notification msg opcode for le transmit power reporting
#define GAP_LE_RF_SET_PATH_LOSS_REPORTING_PARAMS 0x0020 //!<Response msg opcode for le_rf_set_path_loss_reporting_params
#define GAP_LE_RF_SET_PATH_LOSS_REPORTING_ENABLE 0x0021 //!<Response msg opcode for le_rf_set_path_loss_reporting_enable
#define GAP_LE_RF_PATH_LOSS_THRESHOLD_INFO 0x0022 //!<Notification msg opcode for le path loss threshold
/**
* @}
*/
/** @defgroup GAP_LE_RF_TRANSMIT_POWER_LEVEL_FLAG_BITS LE transmit power level flag Bits
* @{
*/
#define GAP_LE_RF_TRANSMIT_POWER_LEVEL_FLAG_MIN_BIT 0x01 /**< Transmit power level is at minimum level. */
#define GAP_LE_RF_TRANSMIT_POWER_LEVEL_FLAG_MAX_BIT 0x02 /**< Transmit power level is at maximum level. */
/**
* @}
*/
/** End of GAP_LE_RF_Exported_Macros
* @}
*/
/*============================================================================*
* Types
*============================================================================*/
/** @defgroup GAP_LE_RF_Exported_Types GAP LE RF Exported Types
* @brief
* @{
*/
typedef enum
{
GAP_LE_RF_POWER_CONTROL_PHYS_1M = 0x01, /**< LE 1M PHY */
GAP_LE_RF_POWER_CONTROL_PHYS_2M = 0x02, /**< LE 2M PHY */
GAP_LE_RF_POWER_CONTROL_PHYS_CODED_S8 = 0x03, /**< LE Coded PHY with S=8 data coding */
GAP_LE_RF_POWER_CONTROL_PHYS_CODED_S2 = 0x04, /**< LE Coded PHY with S=2 data coding */
} T_GAP_LE_RF_POWER_CONTROL_PHYS_TYPE;
/** @defgroup GAP_LE_RF_CB_Msg_Exported_Types GAP RF Callback Msg Exported Types
* @{
*/
typedef struct
{
uint16_t cause;
} T_LE_RF_CAUSE;
#if F_BT_LE_5_0_RF_PATH_SUPPORT
/** @brief Response for read rf path compensation.*/
typedef struct
{
uint16_t cause;
int16_t rf_tx_path_comp_value;
/**< Range: -128.0 dB (0xFB00) to 128.0 dB (0x0500) Units: 0.1 dB */
int16_t rf_rx_path_comp_value;
/**< Range: -128.0 dB (0xFB00) to 128.0 dB (0x0500) Units: 0.1 dB */
} T_LE_RF_READ_RF_PATH_COMPENSATION_RSP;
#endif
#if F_BT_LE_5_2_POWER_CONTROL_SUPPORT
/** @brief Response for enhanced read transmit power level.*/
typedef struct
{
uint8_t conn_id;
uint16_t cause;
T_GAP_LE_RF_POWER_CONTROL_PHYS_TYPE phy;
int8_t cur_tx_power_level;
/**< Current transmit power level Range: -127 to 20 Units: dBm
Note: 0x7F Current transmit power level is unavailable */
int8_t max_tx_power_level;
/**< Maximum transmit power level Range: -127 to 20 Units: dBm */
} T_LE_RF_ENHANCED_READ_TRANSMIT_POWER_LEVEL_RSP;
typedef struct
{
uint16_t cause;
uint8_t conn_id;
} T_LE_RF_READ_REMOTE_TRANSMIT_POWER_LEVEL_RSP;
/** @brief Response for set transmit power reporting enable.*/
typedef struct
{
uint8_t conn_id;
uint16_t cause;
} T_LE_RF_SET_TRANSMIT_POWER_REPORTING_ENABLE_RSP;
/** @brief Information for transmit power reporting.*/
typedef struct
{
uint8_t conn_id;
uint16_t cause;
uint8_t reason;
/**< 0x00: Local transmit power changed
0x01: Remote transmit power changed
0x02: le read remote transmit power level command completed */
T_GAP_LE_RF_POWER_CONTROL_PHYS_TYPE phy;
int8_t tx_power_level;
/**< Transmit power level Range: -127 to 20 Units: dBm
Note: 0x7E Remote device is not managing power levels on this PHY.
0x7F Transmit power level is not available */
uint8_t tx_power_level_flag;
/**< @ref GAP_LE_RF_TRANSMIT_POWER_LEVEL_FLAG_BITS*/
int8_t delta;/**< Change in transmit power level Units: dB
positive indicates increased power, negative indicates
decreased power, zero indicates unchanged*/
} T_LE_RF_TRANSMIT_POWER_REPORTING_INFO;
#endif
#if F_BT_LE_5_2_PATH_LOSS_MONITORING_SUPPORT
/** @brief Response for set path loss reporting params rsp.*/
typedef struct
{
uint8_t conn_id;
uint16_t cause;
} T_LE_RF_SET_PATH_LOSS_REPORTING_PARAMS_RSP;
/** @brief Response for set path loss reporting enable rsp.*/
typedef struct
{
uint8_t conn_id;
uint16_t cause;
} T_LE_RF_SET_PATH_LOSS_REPORTING_ENABLE_RSP;
/** @brief Information for path loss threshold.*/
typedef struct
{
uint8_t conn_id;
uint8_t current_path_loss; /**< Current path loss Units: dB
always zero or positive
Note: 0xFF Unavailable */
uint8_t zone_entered;/**< 0x00: Entered low zone
0x01: Entered middle zone
0x02: Entered high zone */
} T_LE_RF_PATH_LOSS_THRESHOLD_INFO;
#endif
/** @brief GAP RF Callback Data*/
typedef union
{
T_LE_RF_CAUSE le_rf_cause;
#if F_BT_LE_5_0_RF_PATH_SUPPORT
T_LE_RF_READ_RF_PATH_COMPENSATION_RSP *p_le_rf_read_rf_path_compensation_rsp;
#endif
#if F_BT_LE_5_2_POWER_CONTROL_SUPPORT
T_LE_RF_ENHANCED_READ_TRANSMIT_POWER_LEVEL_RSP *p_le_rf_enhanced_read_transmit_power_level_rsp;
T_LE_RF_READ_REMOTE_TRANSMIT_POWER_LEVEL_RSP *p_le_rf_read_remote_transmit_power_level_rsp;
T_LE_RF_SET_TRANSMIT_POWER_REPORTING_ENABLE_RSP *p_le_rf_set_transmit_power_reporting_enable_rsp;
T_LE_RF_TRANSMIT_POWER_REPORTING_INFO *p_le_rf_transmit_power_reporting_info;
#endif
#if F_BT_LE_5_2_PATH_LOSS_MONITORING_SUPPORT
T_LE_RF_SET_PATH_LOSS_REPORTING_PARAMS_RSP *p_le_rf_set_path_loss_reporting_params_rsp;
T_LE_RF_SET_PATH_LOSS_REPORTING_ENABLE_RSP *p_le_rf_set_path_loss_reporting_enable_rsp;
T_LE_RF_PATH_LOSS_THRESHOLD_INFO *p_le_rf_path_loss_threshold_info;
#endif
} T_GAP_LE_RF_CB_DATA;
typedef struct
{
uint16_t opcode;
T_GAP_LE_RF_CB_DATA data;
} T_GAP_LE_RF_CB;
/** End of GAP_LE_RF_Exported_Types
* @}
*/
/*============================================================================*
* Functions
*============================================================================*/
/** @defgroup GAP_LE_RF_Exported_Functions GAP LE RF Exported Functions
* @brief
* @{
*/
#if F_BT_LE_5_0_RF_PATH_SUPPORT
/**
* @brief Read the RF path compensation Values parameter used in the Tx power level and RSSI calculation.
* Read result will be returned by @ref app_gap_callback with cb_type @ref GAP_MSG_LE_RF_INFO with
* opcode @ref GAP_LE_RF_READ_RF_PATH_COMPENSATION.
*
* @retval GAP_CAUSE_SUCCESS: Send request success.
* @retval GAP_CAUSE_SEND_REQ_FAILED: Send request fail.
*
* <b>Example usage</b>
* \code{.c}
void test(void)
{
T_GAP_CAUSE cause;
cause = le_rf_read_rf_path_compensation();
}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
T_GAP_LE_RF_CB *p_le_rf_cb = NULL;
switch (cb_type)
{
...
case GAP_MSG_LE_RF_INFO:
APP_PRINT_INFO0("GAP_MSG_LE_RF_INFO");
p_le_rf_cb = (T_GAP_LE_RF_CB *)p_data->p_le_cb_data;
switch (p_le_rf_cb->opcode)
{
...
#if F_BT_LE_5_0_RF_PATH_SUPPORT
case GAP_LE_RF_READ_RF_PATH_COMPENSATION:
APP_PRINT_INFO3("GAP_LE_RF_READ_RF_PATH_COMPENSATION:cause 0x%x, rf tx path comp value %d, rf rx path comp value %d",
p_le_rf_cb->data.p_le_rf_read_rf_path_compensation_rsp->cause,
p_le_rf_cb->data.p_le_rf_read_rf_path_compensation_rsp->rf_tx_path_comp_value,
p_le_rf_cb->data.p_le_rf_read_rf_path_compensation_rsp->rf_rx_path_comp_value);
break;
#endif
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_rf_read_rf_path_compensation(void);
/**
* @brief Indicate the RF path gain or loss between the RF transceiver and the antenna contributed
* by intermediate components.
*
* @param[in] rf_tx_path_comp_value RF Tx Path Compensation
Range: -128.0 dB (0xFB00) to 128.0 dB (0x0500)
Units: 0.1 dB
* @param[in] rf_rx_path_comp_value RF Rx Path Compensation
Range: -128.0 dB (0xFB00) to 128.0 dB (0x0500)
Units: 0.1 dB
* @retval GAP_CAUSE_SUCCESS: Send request success.
* @retval GAP_CAUSE_SEND_REQ_FAILED: Send request fail.
*
* <b>Example usage</b>
* \code{.c}
void test(void)
{
T_GAP_CAUSE cause;
cause = le_rf_write_rf_path_compensation(rf_tx_path_comp_value,
rf_rx_path_comp_value);
}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
T_GAP_LE_RF_CB *p_le_rf_cb = NULL;
switch (cb_type)
{
...
case GAP_MSG_LE_RF_INFO:
APP_PRINT_INFO0("GAP_MSG_LE_RF_INFO");
p_le_rf_cb = (T_GAP_LE_RF_CB *)p_data->p_le_cb_data;
switch (p_le_rf_cb->opcode)
{
...
#if F_BT_LE_5_0_RF_PATH_SUPPORT
case GAP_LE_RF_WRITE_RF_PATH_COMPENSATION:
APP_PRINT_INFO1("GAP_LE_RF_WRITE_RF_PATH_COMPENSATION:cause 0x%x",
p_le_rf_cb->data.le_rf_cause.cause);
break;
#endif
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_rf_write_rf_path_compensation(int16_t rf_tx_path_comp_value,
int16_t rf_rx_path_comp_value);
#endif
#if F_BT_LE_5_2_POWER_CONTROL_SUPPORT
/**
* @brief Read the current and maximum transmit power levels of the local Controller on the ACL connection and the PHY.
* Read result will be returned by @ref app_gap_callback with cb_type @ref GAP_MSG_LE_RF_INFO with
* opcode @ref GAP_LE_RF_ENHANCED_READ_TRANSMIT_POWER_LEVEL.
*
* @param[in] conn_id Connection ID
* @param[in] phy phy physical: @ref T_GAP_LE_RF_POWER_CONTROL_PHYS_TYPE.
* @retval GAP_CAUSE_SUCCESS: Send request success.
* @retval GAP_CAUSE_SEND_REQ_FAILED: Send request fail.
* @retval GAP_CAUSE_NON_CONN: Set request sent fail.
*
* <b>Example usage</b>
* \code{.c}
void test(void)
{
T_GAP_CAUSE cause;
uint8_t conn_id;
cause = le_rf_enhanced_read_transmit_power_level(conn_id, phy);
}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
T_GAP_LE_RF_CB *p_le_rf_cb = NULL;
switch (cb_type)
{
...
case GAP_MSG_LE_RF_INFO:
APP_PRINT_INFO0("GAP_MSG_LE_RF_INFO");
p_le_rf_cb = (T_GAP_LE_RF_CB *)p_data->p_le_cb_data;
switch (p_le_rf_cb->opcode)
{
...
#if F_BT_LE_5_2_POWER_CONTROL_SUPPORT
case GAP_LE_RF_ENHANCED_READ_TRANSMIT_POWER_LEVEL:
APP_PRINT_INFO5("GAP_LE_RF_ENHANCED_READ_TRANSMIT_POWER_LEVEL:conn id %d, cause 0x%x, phy %d, cur trans power level %d, max trans power level %d",
p_le_rf_cb->data.p_le_rf_enhanced_read_transmit_power_level_rsp->conn_id,
p_le_rf_cb->data.p_le_rf_enhanced_read_transmit_power_level_rsp->cause,
p_le_rf_cb->data.p_le_rf_enhanced_read_transmit_power_level_rsp->phy,
p_le_rf_cb->data.p_le_rf_enhanced_read_transmit_power_level_rsp->cur_tx_power_level,
p_le_rf_cb->data.p_le_rf_enhanced_read_transmit_power_level_rsp->max_tx_power_level);
break;
#endif
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_rf_enhanced_read_transmit_power_level(uint8_t conn_id,
T_GAP_LE_RF_POWER_CONTROL_PHYS_TYPE phy);
/**
* @brief Read the transmit power level used by the remote Controller on the ACL connection and the PHY.
* Read result will be returned by @ref app_gap_callback with cb_type @ref GAP_MSG_LE_RF_INFO with
* opcode @ref GAP_LE_RF_TRANSMIT_POWER_REPORTING_INFO.
*
* @param[in] conn_id Connection ID
* @param[in] phy phy physical: @ref T_GAP_LE_RF_POWER_CONTROL_PHYS_TYPE.
* @retval GAP_CAUSE_SUCCESS: Send request success.
* @retval GAP_CAUSE_SEND_REQ_FAILED: Send request fail.
* @retval GAP_CAUSE_NON_CONN: Set request sent fail.
*
* <b>Example usage</b>
* \code{.c}
void test(void)
{
T_GAP_CAUSE cause;
uint8_t conn_id;
cause = le_rf_read_remote_transmit_power_level(conn_id, phy);
}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
T_GAP_LE_RF_CB *p_le_rf_cb = NULL;
switch (cb_type)
{
...
case GAP_MSG_LE_RF_INFO:
APP_PRINT_INFO0("GAP_MSG_LE_RF_INFO");
p_le_rf_cb = (T_GAP_LE_RF_CB *)p_data->p_le_cb_data;
switch (p_le_rf_cb->opcode)
{
...
#if F_BT_LE_5_2_POWER_CONTROL_SUPPORT
case GAP_LE_RF_READ_REMOTE_TRANSMIT_POWER_LEVEL:
APP_PRINT_INFO2("GAP_LE_RF_SET_TRANSMIT_POWER_REPORTING_ENABLE:conn id %d, cause 0x%x",
p_le_rf_cb->data.p_le_rf_read_remote_transmit_power_level_rsp->conn_id,
p_le_rf_cb->data.p_le_rf_read_remote_transmit_power_level_rsp->cause);
break;
case GAP_LE_RF_TRANSMIT_POWER_REPORTING_INFO:
APP_PRINT_INFO7("GAP_LE_RF_TRANSMIT_POWER_REPORTING_INFO:conn id %d, cause 0x%x, reason 0x%x, phy %d, transmit power level %d, transmit power level flag %d, delta %d",
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->conn_id,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->cause,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->reason,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->phy,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->tx_power_level,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->tx_power_level_flag,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->delta);
break;
#endif
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_rf_read_remote_transmit_power_level(uint8_t conn_id,
T_GAP_LE_RF_POWER_CONTROL_PHYS_TYPE phy);
/**
* @brief Enable or disable the reporting to the local Host of transmit power level changes
* in the local and remote Controllers for the ACL connection.
*
* @param[in] conn_id Connection ID
* @param[in] local_enable enable or disable local transmit power reports
* @param[in] remote_enable enable or disable remote transmit power reports
* @retval GAP_CAUSE_SUCCESS: Send request success.
* @retval GAP_CAUSE_SEND_REQ_FAILED: Send request fail.
* @retval GAP_CAUSE_NON_CONN: Set request sent fail.
*
* <b>Example usage</b>
* \code{.c}
void test(void)
{
T_GAP_CAUSE cause;
uint8_t conn_id;
cause = le_rf_set_transmit_power_reporting_enable(conn_id, local_enable, remote_enable);
}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
T_GAP_LE_RF_CB *p_le_rf_cb = NULL;
switch (cb_type)
{
...
case GAP_MSG_LE_RF_INFO:
APP_PRINT_INFO0("GAP_MSG_LE_RF_INFO");
p_le_rf_cb = (T_GAP_LE_RF_CB *)p_data->p_le_cb_data;
switch (p_le_rf_cb->opcode)
{
...
#if F_BT_LE_5_2_POWER_CONTROL_SUPPORT
case GAP_LE_RF_SET_TRANSMIT_POWER_REPORTING_ENABLE:
APP_PRINT_INFO2("GAP_LE_RF_SET_TRANSMIT_POWER_REPORTING_ENABLE:conn id %d, cause 0x%x",
p_le_rf_cb->data.p_le_rf_set_transmit_power_reporting_enable_rsp->conn_id,
p_le_rf_cb->data.p_le_rf_set_transmit_power_reporting_enable_rsp->cause);
break;
case GAP_LE_RF_TRANSMIT_POWER_REPORTING_INFO:
APP_PRINT_INFO7("GAP_LE_RF_TRANSMIT_POWER_REPORTING_INFO:conn id %d, cause 0x%x, reason 0x%x, phy %d, transmit power level %d, transmit power level flag %d, delta %d",
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->conn_id,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->cause,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->reason,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->phy,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->tx_power_level,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->tx_power_level_flag,
p_le_rf_cb->data.p_le_rf_transmit_power_reporting_info->delta);
break;
#endif
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_rf_set_transmit_power_reporting_enable(uint8_t conn_id, uint8_t local_enable,
uint8_t remote_enable);
#endif
#if F_BT_LE_5_2_PATH_LOSS_MONITORING_SUPPORT
/**
* @brief Set the path loss threshold reporting parameters for the ACL connection
*
* @param[in] conn_id Connection ID
* @param[in] high_threshold High threshold for the path loss
Units: dB
0xFF: High Threshold unused
* @param[in] high_hysteresis Hysteresis value for the high threshold
Units: dB
* @param[in] low_threshold Low threshold for the path loss
Units: dB
* @param[in] low_hysteresis Hysteresis value for the low threshold
Units: dB
* @param[in] min_time_spent Minimum time in number of connection events to be observed once the
path crosses the threshold before an event is generated.
* @retval GAP_CAUSE_SUCCESS: Send request success.
* @retval GAP_CAUSE_SEND_REQ_FAILED: Send request fail.
* @retval GAP_CAUSE_NON_CONN: Set request sent fail.
*
* <b>Example usage</b>
* \code{.c}
void test(void)
{
T_GAP_CAUSE cause;
uint8_t conn_id;
cause = le_rf_set_path_loss_reporting_params(conn_id, high_threshold, high_hysteresis,
low_threshold, low_hysteresis, min_time_spent);
}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
T_GAP_LE_RF_CB *p_le_rf_cb = NULL;
switch (cb_type)
{
...
case GAP_MSG_LE_RF_INFO:
APP_PRINT_INFO0("GAP_MSG_LE_RF_INFO");
p_le_rf_cb = (T_GAP_LE_RF_CB *)p_data->p_le_cb_data;
switch (p_le_rf_cb->opcode)
{
...
#if F_BT_LE_5_2_PATH_LOSS_MONITORING_SUPPORT
case GAP_LE_RF_SET_PATH_LOSS_REPORTING_PARAMS:
APP_PRINT_INFO2("GAP_LE_RF_SET_PATH_LOSS_REPORTING_PARAMS:conn id %d, cause 0x%x",
p_le_rf_cb->data.p_le_rf_set_path_loss_reporting_params_rsp->conn_id,
p_le_rf_cb->data.p_le_rf_set_path_loss_reporting_params_rsp->cause);
break;
#endif
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_rf_set_path_loss_reporting_params(uint8_t conn_id, uint8_t high_threshold,
uint8_t high_hysteresis, uint8_t low_threshold,
uint8_t low_hysteresis, uint16_t min_time_spent);
/**
* @brief Enable or disable path loss reporting.
*
* @param[in] conn_id Connection ID
* @param[in] enable enable or disable path loss reporting
* @retval GAP_CAUSE_SUCCESS: Send request success.
* @retval GAP_CAUSE_SEND_REQ_FAILED: Send request fail.
* @retval GAP_CAUSE_NON_CONN: Set request sent fail.
*
* <b>Example usage</b>
* \code{.c}
void test(void)
{
T_GAP_CAUSE cause;
uint8_t conn_id;
cause = le_rf_set_path_loss_reporting_enable(conn_id, enable);
}
T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
T_APP_RESULT result = APP_RESULT_SUCCESS;
T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;
T_GAP_LE_RF_CB *p_le_rf_cb = NULL;
switch (cb_type)
{
...
case GAP_MSG_LE_RF_INFO:
APP_PRINT_INFO0("GAP_MSG_LE_RF_INFO");
p_le_rf_cb = (T_GAP_LE_RF_CB *)p_data->p_le_cb_data;
switch (p_le_rf_cb->opcode)
{
...
#if F_BT_LE_5_2_PATH_LOSS_MONITORING_SUPPORT
case GAP_LE_RF_SET_PATH_LOSS_REPORTING_ENABLE:
APP_PRINT_INFO2("GAP_LE_RF_SET_PATH_LOSS_REPORTING_ENABLE:conn id %d, cause 0x%x",
p_le_rf_cb->data.p_le_rf_set_path_loss_reporting_enable_rsp->conn_id,
p_le_rf_cb->data.p_le_rf_set_path_loss_reporting_enable_rsp->cause);
break;
case GAP_LE_RF_PATH_LOSS_THRESHOLD_INFO:
APP_PRINT_INFO3("GAP_LE_RF_PATH_LOSS_THRESHOLD_INFO:conn id %d, current path loss %d, zone entered %d",
p_le_rf_cb->data.p_le_rf_path_loss_threshold_info->conn_id,
p_le_rf_cb->data.p_le_rf_path_loss_threshold_info->current_path_loss,
p_le_rf_cb->data.p_le_rf_path_loss_threshold_info->zone_entered);
break;
#endif
...
}
...
}
* \endcode
*/
T_GAP_CAUSE le_rf_set_path_loss_reporting_enable(uint8_t conn_id, uint8_t enable);
#endif
#ifdef __cplusplus
}
#endif
#endif /* GAP_LE_RF_H */
Reference in New Issue Copy Permalink