概述

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

硬件準備

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

視頻教學

[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)模塊用于管理多個進程之間共享的訪問權限和資源同步。
開啟HSEM如下。

配置IPCC

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

配置RTC

啟動RF

開啟藍牙

開啟串口調試

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

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

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

串口配置如下。

開啟CFG_HW_USART1_ENABLED。

關閉MX_USART1_UART_Init函數的生成。

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

開啟DMA。

開啟中斷。

啟用串口1的tx的DMA。

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

啟動串口1調試跟蹤。

啟用應用程序中的跟蹤 。

配置藍牙參數

配置為自定義模板。

命名設備名

配置BLE GATT

配置SVC

設置工程信息

工程文件設置

Keil工程配置

代碼配置

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

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

UTIL_SEQ_Run(UTIL_SEQ_DEFAULT)函數應該在應用程序的while循環中，啟動任務調度。

/* 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這樣一個對數單位來表示功率，而不是直接使用線性單位如瓦或毫瓦呢？原因是無線通信中的信號強度可以在非常寬的范圍內變化，使用對數單位可以更清晰、更簡單地描述這些變化。

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

ACI_HAL_SET_TX_POWER_LEVEL

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

在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循環中執行如下操作，在等待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 重新設置, result: 0x%x n", ret);
					}
					else
					{
						printf("Success: aci_hal_set_tx_power_level 重新設置n");
					}			
			}
			HAL_Delay(1);		
		}	
  }
  /* USER CODE END 3 */

結果演示

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

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