概述

隨著無線通信技術(shù)的不斷進步，能夠精確地控制射頻（RF）信號的功率變得越來越重要。調(diào)整射頻功率不僅可以影響設(shè)備的通信距離和覆蓋范圍，還可以優(yōu)化電池的使用壽命和減少可能的射頻干擾。ACI_HAL_SET_TX_POWER_LEVEL指令提供了一種方法，使工程師和開發(fā)者能夠在ST的藍牙設(shè)備上動態(tài)地調(diào)整射頻發(fā)射功率。本文將詳細介紹如何使用這一指令，以及調(diào)整功率級別可能帶來的影響和應(yīng)用場景。
最近在弄ST的課程，需要樣片的可以加群申請：615061293 。

硬件準備

首先需要準備一個開發(fā)板，這里我準備的是WB55RG 的開發(fā)板：

視頻教學(xué)

[https://www.bilibili.com/video/BV1XF411D7bC/]

樣品申請

[https://www.wjx.top/vm/OhcKxJk.aspx#]

源碼下載

[https://download.csdn.net/download/qq_24312945/88351255](

選擇芯片型號

配置時鐘源

HSE與LSE分別為外部高速時鐘和低速時鐘，在本文中使用外置的時鐘源，故都選擇Crystal/Ceramic Resonator選項，如下所示：

配置時鐘樹

RTC時鐘配置

RFWKP時鐘配置

查看開啟STM32_WPAN條件

可以看到，需要開啟RF、RTC、RCC、IPCC、HSEM。

配置HSEM

硬件信號量(HSEM)模塊用于管理多個進程之間共享的訪問權(quán)限和資源同步。
開啟HSEM如下。

配置IPCC

通信控制器(IPCC)模塊的主要用于cpu之間的信號消息交換。
開啟如下所示。

配置RTC

啟動RF

開啟藍牙

開啟串口調(diào)試

CFG_HW_USART1_ENABLED允許開發(fā)者選擇是否使用USART1作為跟蹤輸出的通道，并且這個配置只在特定的設(shè)置下可用。這樣的配置通常用于嵌入式系統(tǒng)的調(diào)試，使得開發(fā)者可以實時查看設(shè)備的狀態(tài)和輸出信息。

CFG_HW_USART1_ENABLED這是一個配置標志，當(dāng)設(shè)置為啟用時，USART1會被用作輸出跟蹤的通道。當(dāng)禁用時，USART1不會用于這個目的。
僅當(dāng)USART1由CubeMX用戶界面配置時，此特定的硬件配置才可用：這意味著只有在使用ST的CubeMX工具配置USART1時，才可以使用CFG_HW_USART1_ENABLED這一特定的配置選項。

查看原理圖可以的是PA9和PA10與CH340鏈接在一起，且為串口打印端口。

串口配置如下。

開啟CFG_HW_USART1_ENABLED。

關(guān)閉MX_USART1_UART_Init函數(shù)的生成。

CFG_HW_USART1_DMA_TX_SUPPORTED允許開發(fā)者啟用USART1的DMA發(fā)送功能。啟用此功能可以提高USART1發(fā)送數(shù)據(jù)時的效率，但在配置上可能需要更多的步驟和注意事項。
當(dāng)其被設(shè)置為啟用時，USART1將使用DMA來進行數(shù)據(jù)發(fā)送（TX）。DMA允許數(shù)據(jù)從內(nèi)存直接發(fā)送到外設(shè)（在這種情況下是USART1），而不需要CPU的干預(yù)，從而提高效率和數(shù)據(jù)傳輸速度。

開啟DMA。

開啟中斷。

啟用串口1的tx的DMA。

若無法開啟可以重新打開BLE配置。

啟動串口1調(diào)試跟蹤。

啟用應(yīng)用程序中的跟蹤 。

配置藍牙參數(shù)

配置為自定義模板。

命名設(shè)備名

配置BLE GATT

配置SVC

設(shè)置工程信息

工程文件設(shè)置

Keil工程配置

代碼配置

在main.c中添加如下頭文件。

/* USER CODE BEGIN Includes */
#include "stm32_seq.h"
/* USER CODE END Includes */

UTIL_SEQ_Run(UTIL_SEQ_DEFAULT)函數(shù)應(yīng)該在應(yīng)用程序的while循環(huán)中，啟動任務(wù)調(diào)度。

/* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */
    MX_APPE_Process();

    /* USER CODE BEGIN 3 */
		UTIL_SEQ_Run(UTIL_SEQ_DEFAULT);
  }
  /* USER CODE END 3 */
}

在app_entry.c中添加初始化 APPD_Init()。

void MX_APPE_Init( void )
{
  System_Init( );       /**< System initialization */

  SystemPower_Config(); /**< Configure the system Power Mode */

  HW_TS_Init(hw_ts_InitMode_Full, &hrtc); /**< Initialize the TimerServer */

/* USER CODE BEGIN APPE_Init_1 */
    APPD_Init();
/* USER CODE END APPE_Init_1 */
  appe_Tl_Init();	/* Initialize all transport layers */

  /**
   * From now, the application is waiting for the ready event ( VS_HCI_C2_Ready )
   * received on the system channel before starting the Stack
   * This system event is received with APPE_SysUserEvtRx()
   */
/* USER CODE BEGIN APPE_Init_2 */

/* USER CODE END APPE_Init_2 */
   return;
}

射頻功率

dBm是一種衡量功率的單位，特別用于描述射頻 (RF) 和微波信號的功率。dBm表示相對于1毫瓦的功率水平。所以，0 dBm表示1毫瓦的功率；負值表示小于1毫瓦的功率，而正值表示大于1毫瓦的功率。

為什么我們使用dBm這樣一個對數(shù)單位來表示功率，而不是直接使用線性單位如瓦或毫瓦呢？原因是無線通信中的信號強度可以在非常寬的范圍內(nèi)變化，使用對數(shù)單位可以更清晰、更簡單地描述這些變化。

以下是一個簡化的解釋：
如果一個設(shè)備發(fā)出1毫瓦的功率，這被表示為0 dBm。
如果功率是1毫瓦的10倍，即10毫瓦，那么它是10 dBm。
如果功率是1毫瓦的1/10，即0.1毫瓦，那么它是-10 dBm。
因此，在您提供的列表中，負的dBm值表示功率小于1毫瓦，而正的dBm值表示功率大于1毫瓦。這樣的表示方法使得工程師能夠輕松地對比和處理各種功率水平，尤其是在涉及射頻設(shè)計和分析的情況下。

ACI_HAL_SET_TX_POWER_LEVEL

該指令用于設(shè)置設(shè)備的 TX 功率級別。通過控制確定 IC 引腳的輸出功率水平（dBm）的 PA_LEVEL。當(dāng)系統(tǒng)啟動
或重啟時，會使用默認的發(fā)送功率水平，其最大值為 6 dBm。一旦發(fā)出該指令，會立即更改輸出功率，無論是否正
在進行藍牙通信。例如，為了進行調(diào)試，可將設(shè)備設(shè)置為一直廣播，并使用該指令監(jiān)聽信號強度變化。系統(tǒng)會保留
從指令接收的最新發(fā)送功率水平，即第二個指令覆蓋之前的發(fā)送功率水平。在收到另一條設(shè)置發(fā)送功率的指令或系
統(tǒng)重啟前，將維持新的發(fā)送功率水平。

在STM32CUBEMX中可以先修改功率。

我們查看app_ble.c文件中也有該初始化操作。
串口打印也有該指令的配置。

在app_conf.h中有CFG_TX_POWER功率定義。

在main.c文件中，添加頭文件。

/* USER CODE BEGIN Includes */
#include "stm32_seq.h"

#include "ble_hal_aci.h"
/* USER CODE END Includes */

定義變量。

/* USER CODE BEGIN 2 */
	tBleStatus ret = BLE_STATUS_INVALID_PARAMS;
	uint32_t a=0;
  /* USER CODE END 2 */

while循環(huán)中執(zhí)行如下操作，在等待5s后修改天線功率。

/* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */
    MX_APPE_Process();

    /* USER CODE BEGIN 3 */
		UTIL_SEQ_Run(UTIL_SEQ_DEFAULT);
		if(a< 5000)
		{
				a++;
			if(a==5000)
			{
					/**
					 * Set TX Power.
					 */
					ret = aci_hal_set_tx_power_level(1, 0x1F);
					if (ret != BLE_STATUS_SUCCESS)
					{
						printf("Fail   : aci_hal_set_tx_power_level 重新設(shè)置, result: 0x%x n", ret);
					}
					else
					{
						printf("Success: aci_hal_set_tx_power_level 重新設(shè)置n");
					}			
			}
			HAL_Delay(1);		
		}	
  }
  /* USER CODE END 3 */

結(jié)果演示

在低功率下藍牙信號如下所示。

修改位高功率下如下所示。