.. _蓝牙硬件相关配置:

蓝牙硬件相关配置
======================================

.. _蓝牙发射功率说明:

蓝牙发射功率
#######################

    从V1.1.1 SDK开始，蓝牙初始化的发射功率由宏 **SET_BLE_TX_POWER_LEVEL** 配置。
    
    **注：该宏不仅配置初始化的发射功率，并且配置动态调节时可设置的发射功率最大值(AW30N_v1.2.0开始支持动态调节发射功率)。两个配置流程均包含在蓝牙初始化中执行。**

    其中，发射功率档位对应功率如下表：
        +----------------------+------------------+
        | 支持的发射功率档位   | 对应的发射功率   |
        +======================+==================+
        | 0                    | -30dBm档位       |
        +----------------------+------------------+
        | 1                    | -24dBm档位       |
        +----------------------+------------------+
        | 2                    | -18dBm档位       |
        +----------------------+------------------+
        | 3                    | -12dBm档位       |
        +----------------------+------------------+
        | 4                    | -8dBm档位        |
        +----------------------+------------------+
        | 5                    | -5dBm档位        |
        +----------------------+------------------+
        | 6（默认值）          | 0dBm档位         |
        +----------------------+------------------+
        | 7                    | 4dBm档位         |
        +----------------------+------------------+
        | 8                    | 6dBm档位         |
        +----------------------+------------------+
        | 9                    | 8dBm档位         |
        +----------------------+------------------+

        .. centered:: 表1 AW30N蓝牙发送功率档位配置以及其对应发射功率关系表

        
        .. image:: ble_tx_power_sel_v2.png
            :alt: "蓝牙初始化发射功率“
            :align: center
        .. centered:: 蓝牙初始化发射功率

    **注1：SDK从V1.2.0版本开始加入动态调整蓝牙发射功率功能，用户在使用时首先需要在初始化时配置最大发射功率限制（如上图），如果上图中的配置为4dBm档位时,则无法动态调整至4dBm之上的发射功率。**
    **注2：从V1.4.0版本开始新增了-30dBm与8dBm发射功率档位，所以档位对应的发射功率与旧版本相比有调整，调整后每个档位配置对应发射功率关系如上表。**

^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. _蓝牙发射功率动态调节说明:

蓝牙发射功率函数说明
#############################

void ble_set_fix_pwr(u8 fix)
***************************************
    .. note:: 该函数实现动态调节蓝牙发射功率。但是用户在使用时首先需要在初始化通过bt_max_pwr_set配置最大发射功率限制（最大发射功率限制默认包含在蓝牙初始化应用流程），并且完成蓝牙初始化之后方可调节发射功率。
        
        参数说明：
    
        1. fix： 发射功率(0 ~ max)。
        max 为下图中的 **SET_BLE_TX_POWER_LEVEL** 。
        
        | 0 ： 发射功率约-30dBm；
        | 1 ： 发射功率约-24dBm；
        | 2 ： 发射功率约-18dBm；
        | 3 ： 发射功率约-12dBm；
        | 4 ： 发射功率约-8dBm；
        | 5 ： 发射功率约-5dBm；
        | 6 ： 发射功率约0dBm；
        | 7 ： 发射功率约4dBm；
        | 8 ： 发射功率约6dBm；
        | 9 ： 发射功率约8dBm；

        .. image:: ble_tx_power_sel_v2.png
            :alt: "蓝牙初始化发射功率“
            :align: center
        .. centered:: 蓝牙初始化发射功率
        
^^^^^^^^^^^^^^^^^^^^^^^^^^^


rf_PA控制说明
##########################

    SDK从V1.1.1开始，加入了PA控制功能。用户可在样机上加入PA达到更远的通信距离。其配置方式和函数说明如下：

    .. image:: ble_rf_pa_io_config.png
        :alt: "rf_PA控制配置和控制IO初始化函数“
        :align: center
    .. centered:: rf_PA控制配置和控制IO初始化函数

    用户在使用PA时，需要加入控制IO初始化函数，对讲机应用已默认加入改流程，用户可通过搜索RF_PA_EN宏进行参考。

.. important:: 

    | 用户在使用PA时，需要特别注意使用的PA是否支持蓝牙芯片的发送功率，避免导致PA烧坏！！！！
    | （用户可以查询使用的PA的用户手册或者咨询对应的PA厂商）；


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

PA控制函数说明
##############################

void rf_pa_io_sel(void)
*****************************

    该函数实现PA_IO初始化，可使用任意支持映射的IO(PA、PB和USB_IO)，使用时需要关闭其他IO冲突的功能，初始化之后用户可通过逻辑分析仪或者示波器确认TX和RX口是否在工作。