RT-Thread 在 STM32F412ZG 上的实战：NUCLEO-F412ZG 开发板 BSP 使用与驱动开发指南

操作系统嵌入式物联网嵌入式OSRTOS【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址https://gitcode.com/gh_mirrors/rt/rt-thread点击查看免费下载导读本文以 RT-Thread 官方维护的 NUCLEO-F412ZG 开发板 BSP 为切入点系统讲解如何在基于 STM32F412ZGArm Cortex-M4、主频 100 MHz、1 MB Flash / 256 KB SRAM的 STM32 Nucleo-144 开发板上快速跑通 RT-Thread 操作系统并通过 ENV 工具开启 GPIO、UART、ADC、PWM、I2C、SPI、USB Device 等更多片上外设以及 RTduino Arduino 生态兼容层。读完本文你将掌握从硬件连接、工程编译下载到 menuconfig 外设配置、工程再生成、FinSH 控制台验证的完整 BSP 使用链路并理解其底层时钟配置与驱动注册机制。1. BSP 与开发板概览1.1 什么是 STM32F412ZG BSPbsp/stm32/stm32f412-st-nucleo/是 RT-Thread 开发团队为意法半导体 NUCLEO-F412ZG 开发板提供的板级支持包Board Support Package。它把 RT-Thread 内核与 STM32F4 HAL 库、CMSIS 库、链接脚本、启动代码和板载外设驱动整合在一起使开发者无需从零移植即可直接获得可编译、可运行、可裁剪的 RT-Thread 工程。BSP 根目录结构如下目录 / 文件说明applications/main.c应用入口默认演示 LED2PB7周期闪烁board/board.c板级初始化与系统时钟配置SystemClock_Configboard/board.hFlash/SRAM 地址宏、堆区HEAP边界定义board/Kconfig外设驱动配置菜单板载外设 / 片上外设 / 扩展模块board/CubeMX_Config/STM32CubeMX 工程与 HAL MSP/中断文件board/linker_scripts/GCC.lds、IAR.icf、MDK.sct链接脚本project.uvprojx/project.ewp/project.ewwMDK5 / IAR 工程rtconfig.h默认内核与驱动配置由 menuconfig 生成rtconfig.py编译选项脚本被 SConscript 引用1.2 开发板核心资源MCUSTM32F412ZGArm Cortex-M4带单精度 FPU、DSP 指令、MPU最高 100 MHz1024 KB FLASH、256 KB RAM。板载外设3 个 LEDLD1 通信灯、LD2 用户灯、LD3 电源灯、USER 与 RESET 两个按键、USB虚拟串口 / 大容量存储 / 调试三合一、板载 ST-LINK/V2-1 调试器、32.768 kHz 晶振、ST Zio兼容 Arduino UNO V3与 ST morpho 扩展接口。通信与模拟外设4×USART、5×SPI/I2S、4×I2C、SDIO、USB OTG FS、2×CAN、1×12-bit 2.4 MSPS ADC最多 16 通道、16 通道通用 DMA、最多 17 个定时器、真随机数发生器、CRC 校验单元、96-bit 唯一 ID、低功耗 RTC。该 MCU 属于 STM32 Dynamic Efficiency™ 产品线支持 Batch Acquisition ModeBAM可在批量采集数据时进一步降低功耗。这些特性详见 STM32F412ZG BSP 介绍 与 STM32_Nucleo-144_BSP_Introduction。1.3 外设支持现状本 BSP 默认使能的外设如下摘自 Kconfig 与 rtconfig.h片上外设默认支持情况备注GPIO支持默认开启PA0~PH1 映射为 PIN 0~63通过 RT-Thread PIN 设备驱动框架访问UART支持默认开启UART2、UART3默认控制台为 uart3RT_CONSOLE_DEVICE_NAME uart3On-chip Flash支持片上 Flash 驱动默认关闭需在 menuconfig 中开启BSP_USING_ON_CHIP_FLASHUSB Device支持OTG FS 作为 USB 设备默认关闭需开启BSP_USING_USBDADC / PWM / TIM / I2C / SPI支持默认关闭通过 menuconfig 逐项使能2. 快速上手让 RT-Thread 在 NUCLEO-F412ZG 上跑起来2.1 准备环境与依赖BSP 依赖 STM32F4 HAL 库与 CMSIS 库这两者通过 RT-Thread 软件包机制拉取。编译前务必先在 BSP 目录打开 ENV 工具执行pkgs --update该命令会根据rtconfig.h中记录的PKG_USING_STM32F4_HAL_DRIVER、PKG_USING_STM32F4_CMSIS_DRIVER、PKG_USING_CMSIS_CORE等配置下载对应版本的 HAL/CMSIS 源码包否则工程无法通过编译。2.2 硬件连接使用 Type-A 转 Micro-B USB 线连接开发板与 PC为开发板供电。上电后红色 LED LD3PWR与 LD1COM点亮表示供电与 ST-LINK 通信正常。2.3 编译下载以 MDK5 为例双击bsp/stm32/stm32f412-st-nucleo/project.uvprojx打开 MDK5 工程注意打开的是project.uvprojx而非template.uvprojx模板工程。点击 Options for TargetDebug 页选择 ST-LINK Debugger点击 SettingsPort 选择 SWSerial WireFlash Download 勾选 Reset and Run。编译并下载程序到开发板。工程默认使用 ST-LINK 下载点击下载按钮即可。除 MDK5 外本 BSP 还提供 IAR 工程project.ewp/project.eww并支持 GCC 开发环境。2.4 运行结果验证下载成功后系统自动运行红色 LD3、LD1 常亮蓝色 LD2 周期闪烁。LED 点灯逻辑位于 applications/main.c#define LED2_PIN GET_PIN(B, 7) int main(void) { /* set LED0 pin mode to output */ rt_pin_mode(LED2_PIN, PIN_MODE_OUTPUT); while (1) { rt_pin_write(LED2_PIN, PIN_HIGH); rt_thread_mdelay(500); rt_pin_write(LED2_PIN, PIN_LOW); rt_thread_mdelay(500); } }默认控制台绑定 USB 虚拟 COM 端口内部连接 USART3。在终端工具中打开对应串口波特率 115200、8 数据位、1 停止位、无校验即 115200-8-1-N复位开发板即可看到 RT-Thread 启动信息\ | / - RT - Thread Operating System / | \ 4.0.2 build Oct 20 2019 2006 - 2019 Copyright by rt-thread team msh msh 即 RT-Thread FinSH 命令行MSH 模式提示符可输入help、list_device、list_thread等命令进行交互。2.5 时钟配置的底层支撑BSP 之所以能跑在 100 MHz 主频依赖 board/board.c 中的SystemClock_Config()以 HSE旁路模式开发板 ST-LINK 提供 8 MHz 时钟为 PLL 源PLLM8、PLLN384、PLLP4得到 96 MHz SYSCLK实际按 CubeMX 配置生成Flash 等待周期为 3APB1 二分频、APB2 一分频并配置 48 MHz 时钟CLK48CLKSOURCE_PLLQ供 USB OTG 使用。该函数由 RT-Thread 系统启动流程在板级初始化阶段调用。3. 进阶使用用 ENV 工具开启更多外设BSP 默认只开启了 GPIO 与 UART3外加 UART2。如需 SPI、I2C、ADC、PWM、USB Device 等高级功能需使用 ENV 工具配置步骤如下在 BSP 目录bsp/stm32/stm32f412-st-nucleo/下打开 ENV 工具输入menuconfig配置工程保存后退出输入pkgs --update更新软件包输入scons --targetmdk5或mdk4/iarGCC 环境可省略 target重新生成工程。更完整的图文流程参见 STM32 系列 BSP 外设驱动使用教程其中以开启 SPI Flash 驱动为例展示了menuconfig→pkgs --update→scons --targetmdk5 -s→ 编译下载 →list_device验证的完整链路。3.1 配置菜单结构board/Kconfig 定义了三级驱动配置菜单Onboard Peripheral Drivers板载外设BSP_USING_STLINK_TO_USARTST-LINK 虚拟串口即 uart3默认开启、BSP_USING_ARDUINORTduino 兼容默认关闭。On-chip Peripheral Drivers片上外设GPIO、UARTUART2/UART3含 DMA 与缓冲区大小配置、ADCADC1、PWMPWM1/PWM4/PWM14 及其通道、TIMTIM6、软件 I2Cswi2c1可配置 SCL/SDA 引脚、SPISPI1含 TX/RX DMA、片上 Flash、USB DeviceOTGFS。Board extended module Drivers扩展模块当前为空用于挂载扩展板驱动。3.2 常用外设配置项速查配置项含义默认值BSP_USING_STLINK_TO_USART使能 ST-LINK 虚拟串口uart3yBSP_USING_UART2/BSP_USING_UART3使能 UART2 / UART3yBSP_UARTx_RX_USING_DMA/BSP_UARTx_TX_USING_DMA串口 RX/TX DMA依赖RT_SERIAL_USING_DMAnBSP_UARTx_RX_BUFSIZE串口 RX 缓冲区大小Serial V2范围 64~65535256BSP_UARTx_DMA_PING_BUFSIZE串口 RX DMA ping-pong 缓冲区范围 32~6553564BSP_USING_ADC1使能 ADC11×12-bit最多 16 通道nBSP_USING_PWM1/4/14及_CHx使能定时器输出 PWM 及对应通道nBSP_USING_TIM6使能 TIM6软件定时器节拍辅助nBSP_USING_SOFT_I2C1与RT_SOFT_I2C1_SCL/SDA_PIN软件 I2C 总线及引脚号默认 24/25nBSP_USING_SPI1与BSP_SPI1_TX/RX_USING_DMASPI1 总线及 DMA 收发nBSP_USING_ON_CHIP_FLASH片上 Flash 驱动nBSP_USING_USBDOTG FS 作为 USB 设备自动选中RT_USING_USB_DEVICEn注意UART 的 DMA 选项依赖RT_SERIAL_USING_DMA在RT_USING_SERIAL_V1与RT_USING_SERIAL_V2两种串口框架下可配置项略有差异V2 提供独立的 TX/RX 缓冲区大小配置。3.3 配置生效后的工程组织执行scons --targetmdk5后SCons 构建脚本会根据rtconfig.h中的宏自动挑选 HAL 驱动源文件如drv_gpio.c、drv_usart.c、drv_spi.c、drv_i2c.c、drv_adc.c、drv_pwm.c等位于 bsp/stm32/libraries/ 下加入工程。因此每开启一个外设重新生成工程后对应驱动文件即被编译进来并通过 RT-Thread 设备框架注册为同名设备开发者可直接使用统一的设备操作 API。4. RTduino兼容 Arduino 生态NUCLEO-F412ZG BSP 还支持 RTduino——RT-Thread 的 Arduino 生态兼容层。开启方式Hardware Drivers Config --- Onboard Peripheral Drivers --- [*] Compatible with Arduino Ecosystem (RTduino)开启后BSP_USING_ARDUINO会自动联动开启 ST-LINK 虚拟串口、GPIO、ADC1、TIM6、PWM1/4/14含通道、软件 I2C1、SPI1含 DMA等配置并引入RT_USING_I2C、RT_USING_SPI等内核依赖。应用可使用 Arduino 的setup()/loop()编程模型默认示例 arduino_main.cpp 演示了 LED_BUILTIN 的点灯逻辑void setup(void) { pinMode(LED_BUILTIN, OUTPUT); } void loop(void) { digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN)); delay(100); }引脚映射遵循 Arduino UNO 布局详见 arduino_pinout 说明 与 pins_arduino.c关键映射如下Arduino PinSTM32 Pin默认被接管设备D0 / D1SerialPG9 / PG14RT-Thread UART 设备D3 / D5 / D6PE13 / PE11 / PE9PWM1-CH3 / CH2 / CH1D9 / D10PD15 / PD14PWM4-CH4 / CH3D11PA7PWM14-CH1D14 / D15I2CPB9 / PB8RT-Thread I2C 设备WireD16 / D17 / D18 / D19PC13 / PB0 / PB7 / PB14USER 按键 / 3 个用户 LEDA0~A5PA3 / PC0 / PC3 / PC1 / PC4 / PC5ADC1-CH3 / CH10 / CH13 / CH11 / CH14 / CH15A6 / A7片内内部电压传感器CH17/ 内部温度传感器CH16注意同一硬件定时器的 4 个 PWM 通道只能输出同一频率因此不要同时用同一个定时器驱动 PWManalogWrite和舵机否则可能导致舵机驱动失败。使用 SPI 后D10、D11 的 PWM 功能会被不可逆地切换为 SPI 功能。5. 常见问题与排查建议编译报错缺少 HAL 头文件未执行pkgs --update拉取 STM32F4 HAL 与 CMSIS 软件包。请先在 BSP 目录执行该命令。下载失败确认 MDK 调试器选择 ST-LINK、SW 端口连接正常并勾选 Reset and Run也可换用 IAR 工程或 GCC 工具链对比排查。串口无输出确认终端参数为 115200-8-1-N且打开的是虚拟 COM 端口对应 uart3复位开发板后应看到启动 LOG。配置后外设未生效修改 menuconfig 后必须依次执行pkgs --update与scons --targetmdk5重新生成工程否则驱动文件不会进入编译。6. 参考资料STM32F412ZG BSP 说明英文原版STM32 Nucleo-144 BSP 使用介绍STM32 系列 BSP 外设驱动使用教程STM32F412ZG 芯片数据手册与资源ST 官方外部资料仅供芯片级参考本 BSP 由 RT-Thread 社区维护flybreak、Meco Man 等仓库中该目录同时提供 中文版 README两者内容互为补充可对照阅读。赞分享操作系统嵌入式物联网嵌入式OSRTOS【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址https://gitcode.com/gh_mirrors/rt/rt-thread点击查看免费下载相关推荐RT-Thread 在 STM32F072-Nucleo 开发板上的 BSP 使用指南RT Thread 在 STM32F072 Nucleo 开发板上的 BSP 使用指南 导读 本指南围绕 RT Thread 官方提供的 NUCLEO F072操作系统嵌入式物联网嵌入式OSRTOSRT-Thread 在 NUCLEO-H503RB 开发板上的 BSP 移植与使用指南RT Thread 在 NUCLEO H503RB 开发板上的 BSP 移植与使用指南 本篇指南以 RT Thread 仓库中 bsp/stm32/stm32h操作系统嵌入式物联网嵌入式OSRTOSRT-Thread 的 NUCLEO-F412ZG BSP 板级支持包详解从快速上手到外设驱动开发RT Thread 的 NUCLEO F412ZG BSP 板级支持包详解从快速上手到外设驱动开发 导读 本文以 RT Thread 开源仓库中的 NUCLE操作系统嵌入式物联网嵌入式OSRTOS上一篇Ariakit Heading 组件基于 WAI-ARIA 的自动标题层级与无障碍导航指南下一篇G-Helper完整指南如何用轻量级工具释放华硕笔记本的隐藏性能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考