aboutsummaryrefslogtreecommitdiff
path: root/inc/bluetooth/gap/gap_le_rf.h
diff options
context:
space:
mode:
Diffstat (limited to 'inc/bluetooth/gap/gap_le_rf.h')
-rw-r--r--inc/bluetooth/gap/gap_le_rf.h656
1 files changed, 656 insertions, 0 deletions
diff --git a/inc/bluetooth/gap/gap_le_rf.h b/inc/bluetooth/gap/gap_le_rf.h
new file mode 100644
index 0000000..4467c56
--- /dev/null
+++ b/inc/bluetooth/gap/gap_le_rf.h
@@ -0,0 +1,656 @@
+/**
+*********************************************************************************************************
+* 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 */
generated by cgit v1.2.3 (git 2.25.1) at 2024-06-06 07:47:05 +0000