關鍵字：.extSettings，文件結構，BSP

目錄預覽

1.前言

2..extSetting文件的作用

3.使用實例

4.小結

01 前言

在閱讀UM1718文檔的時候，發現CubeMX有個比較好的功能，可以用“.extSettings"文件一次，后續不管使用哪個IDE（只要是CubeMX支持的），都不需要再手動配置文件結構或包含頭文件路徑了，并且可以保持對各個IDE（只包括CubeMX支持的）配置的一致性，減少工作量。也有客戶詢問怎么添加工程文件的問題，考慮到可能有些同學不太了解這個功能，所以本文對這個功能進行介紹。

02

.extSettings文件的作用

".extSettings"文件是對CubeMX配置的補充，是在CubeMX配置的基礎上進行的額外配置，不是替換CubeMX的配置，這點需要注意。

總體來說，".extSettings"文件中的配置包含三部分，分別是[ProjectFiles]，[Groups]和[Others]，下面分別對這三個部分的功能進行介紹。

2.1. [ProjectFiles]

[ProjectFiles]這個部分主要是用來包含一些目錄，例如頭文件存放的目錄。

語法：HeaderPath=;

示例：HeaderPath=../BSP/STM32H735G-DK

說明：這里的路徑是相對于“*.cproject”或 “*.project”文件（如果生成的是CubeIDE的工程代碼的話）的相對路徑。如果生成的是其他IDE的工程代碼，則這個路徑是相對于其他工程文件的相對路徑，例如“*.eww”文件（IAR）或“*.uvprojx”文件（KEIL）

效果：在".extSettings"文件中添加示例中的內容，重新生成代碼后，效果如圖1，紅框部分是通過".extSettings"文件包含的目錄，可以看到已經被包含到工程中。

圖1 配置[ProjectFiles]后CubeIDE工程包含的目錄

2.2. [Groups]

這個部分主要是用來在工程中創建文件組并且將文件添加到文件組中，用來組織工程的文件結構。

語法：=;

示例：Drivers/BSP/STM32H735G-DK=.. /BSP/STM32H735G-DK /stm32h735g_discovery.c;

說明：是工程中的文件組名（若不存在則會自動創建）；是文件路徑。示例中語句的作用是，嵌套創建“Drivers/BSP/STM32H735G-DK”這個文件組（可以多級嵌套創建），并且將“stm32h735g_discovery.c”文件添加進這個文件組中。可以在一個文件組中添加多個文件，只要多個之間通過分號（“；”）隔開即可。

效果：在".extSettings"文件中添加示例中的內容，重新生成代碼后，效果如圖2。

圖2 配置[Groups]后CubeIDE工程的文件結構

2.3. [Others]

[Others]這個部分主要是用來使能一些HAL模板和添加一些預處理定義語句。

2.3.1. 添加HAL模板

語法：HALModule=;;

示例：HALModule=SPI;ADC;

效果：在".extSettings"文件中添加示例中的內容，重新生成代碼后，如果使用H7系列的芯片創建的工程，則會自動在“stm32h7xx_hal_conf.h”文件（如果是其他系列的芯片的話，名字會略有區別）中添加”HAL_SPI_MODULE_ENABLED"和“HAL_ADC_MODULE_ENABLED"這兩個宏定義，作用是在這個文件中包含SPI與ADC的頭文件。如圖3所示：

圖3 配置[Other]的HALModule后HAL的配置文件中自動添加的內容

2.3.2. 添加預處理定義語句

語法：Define=;

示例：Define=TEST_STM32H735G_DEMO

效果：在".extSettings"文件中添加示例中的內容，重新生成代碼后，可以看到".extSettings"文件中配置的預定義語句已經被添加到工程中了。

圖4 配置[Other]的Define后自動在工程中添加的預處理語句

03 使用實例

下面的實例基于STM32H735G-DK板，使用“STM32Cube_FW_H7_V1.10.0”中的BSP驅動。要達到的目的是使板子上的LED1每隔0.5S切換一次亮/滅狀態。下面是實現的步驟：

3.1.1. 創建CubeMX配置文件

使用STM32CubeMX創建STM32H735IGK6（STM32H735G-DK）的工程，其他配置都使用默認值即可，并保存這個配置文件。如圖5所示：

圖5 保存CubeMX產生的配置文件

3.1.2. 添加BSP文件

將“STM32Cube_FW_H7_V1.10.0/Drivers”路徑下的“BSP”目錄及其文件都復制到工程目錄下（這里是復制到.ioc文件相同目錄下，您也可以根據自己需要復制到其他地方，只要在".extSettings"文件中包含即可）。如圖6所示：

圖6 復制“BSP”到工程目錄下

修改BSP中 “stm32h735g_discovery_conf_template.h"文件的文件名，修改為“stm32h735g_discovery_conf.h”

圖7 添加BSP的配置文件

3.1.3. 創建.extSettings文件

在.ioc文件同級目錄下創建".extSettings"文件。如下圖所示：

圖8 添加.extSettings文件

注意：.extSettings文件一定要放在.ioc文件的同一目錄下

3.1.4. 修改.extSettings文件的內容

（1）因為要對GPIO進行操作，BSP文件是基于HAL庫的，所以需要使用GPIO的HAL庫（避免GPIO模塊尚未使能，這里使能GPIO模塊）。在[Others]部分需要添加的內容為：HALModule=GPIO

（2）添加BSP中需要包含的目錄。所以在[ProjectFiles]中需要添加的內容為：HeaderPath=../BSP/STM32H735G-DK

（3）將BSP中的文件添加到工程中，因為只需要操作LED，所以需要添加“stm32h735g_discovery.c”文件即可，并創建文件組“STM32H735G-DK”。所以在[Groups]中需要添加的內容為：Drivers/BSP/STM32H735G-DK=../BSP/STM32H735G-DK /stm32h735g_discovery.c；

綜合上面三點，在.extSettings文件中需要添加的內容為：

3.1.5. 使用CubeMX生成適用不同IDE的工程代碼

使用CubeMX生成代碼（GENERAGE CODE），分別生成CubeIDE，IAR和KEIL的工程代碼。

圖9 使用CubeMX生成代碼

生成代碼后，可以看到不同IDE的工程文件結構如下圖：

圖10 STM32CubeIDE

圖11 IAR

圖12 KEIL

可以從上面圖中看到，“stm32h735g_discovery.c”文件已經被添加到工程中，BSP的目錄也已經被包含到工程中。

3.1.6. 添加代碼實現功能

1.包含“stm32h735g_discovery.h”頭文件。

圖13 包含“stm32h735g_discovery.h”

2.使用BSP初始化LED1的配置。

圖14 使用BSP初始化LED1的配置

3.添加LED1的翻轉操作。

圖15 添加LED的翻轉操作

結果：使用這三種IDE進行編譯下載后都可以實現LED1每隔0.5S切換亮/滅狀態的操作。

04 小結

使用".extSettings"文件配置工程的文件機構，可以做到一次配置，多種平臺可用的效果，并可以保持配置的一致性。

注意：".extSettings"文件一定要放在.ioc文件相同的目錄下

完整內容請點擊“閱讀原文”下載原文檔。

訂閱號

關注STM32

視頻號

B站賬號

▽點擊“閱讀原文”，可下載原文檔