文章目录
准备工作
VSCode
CubeMX
PlatformIO
下载VSCode
官网下载
安装后打开,如图所示(页面默认是英文,可以安装中文插件):
安装中文插件
点击左边拓展,搜索栏搜索Chinese,点击Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code,再点击install,重启软件即可。
安装PlatformIO插件
与安装中文插件步骤一样,先搜索platformio,点击外星人头像的插件,进入安装。
下载CubeMX
官网下载
进入软件打开Help,点击Manage embedded software packages,下载F4的资源包。
创建工程
安装STM32平台
打开VScode,点击左侧外星人头像进入PlatformIO插件,点击open进入主页面。
首次使用为了支持STM32需要安装STM32平台:点击Platforms,在搜索栏搜索STM32,点击install(因为我已经安装过了,此处显示uninstall)。
创建新工程-PlatformIO
创建工程可能会占据一些时间,当创建完成后,左边文件区会显示下图样式:
创建新工程-CubeMX(基于LED闪烁)
打开CubeMX,点击主页的ACCESS TO MCU SELECTOR
搜索栏搜索并选择STM32F407ZG,最后点击Start project。
设置输出引脚:直接单击右侧芯片引脚PF9,PF10(我开发板LED1,LED2引脚)设置为输出,推挽,上拉模式,并设置默认输出分别为高,低电平
设置时钟:点击左侧RCC,两个选项都设置为外部晶振。
配置时钟:点击最上方的Clock Configuration
生成代码:
- 先创建工程名,和platformIO工程里面名字一模一样;
- 工程位置:选择platformIO工程中位置,但是要去掉工程名字,如我的位置里面只写到Projects,Template_Hal工程在Projects里面;
- 选择工具链:Makefile;
- 点击右上方GENERATE CODE.
此时,已经距离成功一大半了。
修改工程
打开PlatformIO。
使用Core/Src替换src(将Core/Src移动到主文件夹即可替换):
结果:
打开main.c文件,在while循环里面添加LED闪烁代码:
HAL_Delay(1000);
HAL_GPIO_TogglePin(GPIOF, GPIO_PIN_9);
HAL_GPIO_TogglePin(GPIOF, GPIO_PIN_10);
HAL_Delay(1000);
HAL_GPIO_TogglePin(GPIOF, GPIO_PIN_9);
HAL_GPIO_TogglePin(GPIOF, GPIO_PIN_10);
修改platformio.in:
; PlatformIO Project Configuration File
;
; Build options: build flags, source filter
; Upload options: custom upload port, speed and extra flags
; Library options: dependencies, extra library storages
; Advanced options: extra scripting
;
; Please visit documentation for the other options and examples
; https://docs.platformio.org/page/projectconf.html
[env:black_f407zg]
platform = ststm32
board = black_f407zg
framework = stm32cube
upload_protocol = stlink ; 上传工具
debug_tool = stlink ; 调试工具
build_flags = ; Build options
-Isrc
-ICore/Inc
-ICore/Src
-IDrivers/STM32F4xx_HAL_Driver/Inc
-IDrivers/STM32F4xx_HAL_Driver/Src
相关参数参考PlatformIO官网手册
upload_protocol和debug_protocol选择烧录器:stlink或者jlink。
build_flags选项”-I“参数为头文件,此处放我们移植过来文件的位置。
编译,烧录,还可以debug,完工。
补充
为了可以支持正点原子的代码,可以在上述工作基础上做些修改(主要是为了使用System文件):
将正点原子的HAL库函数移植过来(以跑马灯为例):
正点原子库:
将正点原子工程中的HARDWARE,SYSTEM文件夹复制到PlatformIO工程的Src文件夹中:
修改Template/src/SYSTEM/sys/sys.c文件中四个函数:
老的:
//THUMB指令不支持汇编内联
//采用如下方法实现执行汇编指令WFI
__asm void WFI_SET(void)
{
WFI;
}
//关闭所有中断(但是不包括fault和NMI中断)
__asm void INTX_DISABLE(void)
{
CPSID I
BX LR
}
//开启所有中断
__asm void INTX_ENABLE(void)
{
CPSIE I
BX LR
}
//设置栈顶地址
//addr:栈顶地址
__asm void MSR_MSP(u32 addr)
{
MSR MSP, r0 //set Main Stack value
BX r14
}
新的:
void WFI_SET(void)
{
__ASM volatile("WFI");
}
void INTX_DISABLE(void)
{
__ASM volatile("CPSID I");
__ASM volatile("BX LR ");
}
void INTX_ENABLE(void)
{
__ASM volatile("CPSIE I");
__ASM volatile("BX LR");
}
void MSR_MSP(u32 addr)
{
__ASM volatile("MSR MSP, r0");
__ASM volatile("BX r14");
}
修改工程配置文件PlatformIO.ini:
[env:black_f407zg]
platform = ststm32
board = black_f407zg
framework = stm32cube
upload_protocol = stlink ; 上传工具
debug_tool = stlink ; 调试工具
build_flags = ; Build options
-Isrc
-ICore/Inc
-IDrivers/STM32F4xx_HAL_Driver/Inc
-IDrivers/STM32F4xx_HAL_Driver/Src
-ISrc/HARDWARE/LED
-ISrc/SYSTEM/delay
-ISrc/SYSTEM/sys
-ISrc/SYSTEM/usart
-D STM32F407xx ; 定义全局宏
-D USE_HAL_DRIVER
相关参数参考PlatformIO官网手册
upload_protocol和debug_protocol选择烧录器:stlink或者jlink。
build_flags选项”-I“参数为头文件,此处放我们移植过来文件的位置,”-D“为宏定义。
STM32F407xx和USE_HAL_DRIVER相当于Keil工程中的宏定义(图片仅供参考)(其实加不加这两个都无所谓,因为建立工程时已经后台加上去了):
其中STM32F407xx这个参数不确定的话看芯片型号,然后在stm32f4xx.h文件中查找:
最后,为了支持所有库的使用,去Core文件夹内的stm32f4xx_hal_conf.h进行修改(将多有模块宏定义使能):LEGACY也可以使能,但注意在platformio.ini文件加入库文件。
#define HAL_MODULE_ENABLED
#define HAL_ADC_MODULE_ENABLED
#define HAL_CAN_MODULE_ENABLED
/* #define HAL_CAN_LEGACY_MODULE_ENABLED */
#define HAL_CRC_MODULE_ENABLED
#define HAL_CEC_MODULE_ENABLED
#define HAL_CRYP_MODULE_ENABLED
#define HAL_DAC_MODULE_ENABLED
#define HAL_DCMI_MODULE_ENABLED
#define HAL_DMA_MODULE_ENABLED
#define HAL_DMA2D_MODULE_ENABLED
#define HAL_ETH_MODULE_ENABLED
#define HAL_FLASH_MODULE_ENABLED
#define HAL_NAND_MODULE_ENABLED
#define HAL_NOR_MODULE_ENABLED
#define HAL_PCCARD_MODULE_ENABLED
#define HAL_SRAM_MODULE_ENABLED
#define HAL_SDRAM_MODULE_ENABLED
#define HAL_HASH_MODULE_ENABLED
#define HAL_GPIO_MODULE_ENABLED
#define HAL_EXTI_MODULE_ENABLED
#define HAL_I2C_MODULE_ENABLED
#define HAL_SMBUS_MODULE_ENABLED
#define HAL_I2S_MODULE_ENABLED
#define HAL_IWDG_MODULE_ENABLED
#define HAL_LTDC_MODULE_ENABLED
#define HAL_DSI_MODULE_ENABLED
#define HAL_PWR_MODULE_ENABLED
#define HAL_QSPI_MODULE_ENABLED
#define HAL_RCC_MODULE_ENABLED
#define HAL_RNG_MODULE_ENABLED
#define HAL_RTC_MODULE_ENABLED
#define HAL_SAI_MODULE_ENABLED
#define HAL_SD_MODULE_ENABLED
#define HAL_SPI_MODULE_ENABLED
#define HAL_TIM_MODULE_ENABLED
#define HAL_UART_MODULE_ENABLED
#define HAL_USART_MODULE_ENABLED
#define HAL_IRDA_MODULE_ENABLED
#define HAL_SMARTCARD_MODULE_ENABLED
#define HAL_WWDG_MODULE_ENABLED
#define HAL_CORTEX_MODULE_ENABLED
#define HAL_PCD_MODULE_ENABLED
#define HAL_HCD_MODULE_ENABLED
#define HAL_FMPI2C_MODULE_ENABLED
#define HAL_FMPSMBUS_MODULE_ENABLED
#define HAL_SPDIFRX_MODULE_ENABLED
#define HAL_DFSDM_MODULE_ENABLED
#define HAL_LPTIM_MODULE_ENABLED
#define HAL_MMC_MODULE_ENABLED
最后,把main文件复制过来,即可使用。
参考文章
STM32HAL:PlateformIO配合CubeMX开发应用
使用PlatformIO+CubeMX+HAL开发STM32
VSCode 使用 PlatformIO 插件开发基于 HAL 库的 STM32项目
使用PlatformIO+CubeMX+HAL开发STM32
【STM32CubeMX】+使用教程
【STM32】系统时钟RCC详解(超详细,超全面)