RIOT OS 板级支持详解STM32 Nucleo-L476RG 开发板的配置、外设与烧录指南【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT本指南以 RIOT OS 仓库中 boards/nucleo-l476rg/doc.md 为核心系统讲解 STM32 Nucleo-L476RG 开发板在 RIOT 中的板级支持BSP实现。你将掌握该板的 MCU 资源规格、引脚分配、外设UART/SPI/I2C/ADC/PWM/定时器/DMA在源码中的真实映射方式以及如何用nucleo-l476rg板名完成编译烧录并接入 RIOT shell从而在此基础上快速开展物联网应用开发。板级总览面向低功耗场景的 Cortex-M4F 平台Nucleo-L476RG 是 ST 公司 Nucleo 系列中的经典低功耗开发板属于 Nucleo-64 板型家族。RIOT 将它与同系列的其它 64 引脚 Nucleo 板统一放在boards_common_nucleo64分组下因此 boards/common/nucleo64/doc.md 中描述的通用特性LED0/SPI 引脚冲突、ST-Link 虚拟串口等同样适用于本板。RIOT 对该板的正式描述定义在 boards/nucleo-l476rg/doc.md板载 MCU 为STM32L476RG属于 ARM Cortex-M4F 内核带硬件 FPU拥有128 KiB RAM与1 MiB Flash最高主频80 MHz。以下为 RIOT 文档给出的完整 MCU 资源表资源规格MCUSTM32L476RGST Microelectronics内核ARM Cortex-M4F带 FPURAM128 KiBFlash1 MiB最高主频80 MHz定时器16 个2×看门狗、1×SysTick、6×16 位、2×32 位其中 TIM2 为 32 位ADC3 个 12 位最多 16 通道UART6 个3 个 USART、2 个 UART、1 个低功耗 LPUARTSPI3 个I2C3 个RTC1 个CAN1 个供电电压 Vcc1.71 V – 3.6 V从源码角度看板级定义由以下文件共同构成均在 boards/nucleo-l476rg/ 目录下Makefile声明MODULE board并引入$(RIOTBOARD)/common/nucleo的公共构建逻辑Makefile.features声明CPU stm32、CPU_MODEL stm32l476rg及板级外设能力Makefile.include/Makefile.dep分别引入common/nucleo64的公共包含路径与依赖规则Kconfig完成BOARD_NUCLEO_L476RG的 Kconfig 建模include/periph_conf.h板级外设的引脚与时钟映射本指南第三节详述。板级特性声明FEATURES_PROVIDED 揭示的可用外设boards/nucleo-l476rg/Makefile.features 以FEATURES_PROVIDED的形式声明了 RIOT 应用层可以放心启用的外设模块这是评估这块板能做什么的最直接依据CPU stm32 CPU_MODEL stm32l476rg # Put defined MCU peripherals here (in alphabetical order) FEATURES_PROVIDED periph_adc FEATURES_PROVIDED periph_can FEATURES_PROVIDED periph_dma FEATURES_PROVIDED periph_i2c FEATURES_PROVIDED periph_pwm FEATURES_PROVIDED periph_rtc FEATURES_PROVIDED periph_rtt FEATURES_PROVIDED periph_spi FEATURES_PROVIDED periph_timer FEATURES_PROVIDED periph_uart # Put other features for this board (in alphabetical order) FEATURES_PROVIDED riotboot # load the common Makefile.features for Nucleo boards include $(RIOTBOARD)/common/nucleo64/Makefile.features解读这些声明模拟/数字外设periph_adc、periph_dma、periph_pwm、periph_timer、periph_uart、periph_spi、periph_i2c一应俱全覆盖了绝大多数传感器驱动与通信场景时间与低功耗periph_rtc日历时钟与periph_rtt低功耗运行定时器都可用配合 MCU 的 LSE 晶振配置非常适合电池供电的定时唤醒类应用车载/工业通信periph_can表明板载 STM32L476RG 的 CAN 控制器已被 RIOT 驱动启用OTA 能力riotboot特性说明该板支持 RIOT 的 riotboot 引导加载方案可做固件升级。Kconfig 侧则通过 boards/nucleo-l476rg/Kconfig 建立等价模型BOARD_NUCLEO_L476RG选中BOARD_COMMON_NUCLEO64与CPU_MODEL_STM32L476RG同时引入nucleo64公共 Kconfig。这意味着无论走 Makefile 还是 Kconfig 配置路径外设能力保持一致。外设映射源码解析periph_conf.h 中的真实引脚分配boards/nucleo-l476rg/include/periph_conf.h 是本板 BSP 的核心它决定了 RIOT 各外设驱动与 STM32L476RG 硬件的绑定关系。下面逐项剖析其中引脚编号遵循 STM32 的 PA0–PA15、PB0–PB15、PC0–PC15 约定。时钟配置#ifndef CONFIG_BOARD_HAS_LSE #define CONFIG_BOARD_HAS_LSE 1 #endif板级强制启用LSE低速外部晶振通常为 32.768 kHz这是 RTC/RTT 模块获得精确走时的前提也是该板定位低功耗应用的关键配置。DMA 流配置static const dma_conf_t dma_config[] { { .stream 1 }, /* DMA1 Channel 2 - SPI1_RX | USART3_TX */ { .stream 2 }, /* DMA1 Channel 3 - SPI1_TX */ { .stream 3 }, /* DMA1 Channel 4 - USART1_TX */ { .stream 6 }, /* DMA1 Channel 7 - USART2_TX */ };共定义 4 个 DMA 流分别服务 SPI1 接收/发送与 USART1/2/3 的发送方向。启用periph_dma后periph_conf.h 中的 UART 与 SPI 配置会在#ifdef MODULE_PERIPH_DMA分支下自动附加dma/dma_chan字段实现数据搬运不占用 CPU。定时器配置TIM5 32 位static const timer_conf_t timer_config[] { { .dev TIM5, .max 0xffffffff, /* 32 位计数上限 */ .rcc_mask RCC_APB1ENR1_TIM5EN, .bus APB1, .irqn TIM5_IRQn } };RIOT 将TIM532 位定时器用作系统periph_timer设备.max 0xffffffff表示 32 位满量程可提供长达数小时的毫秒级定时跨度而不必担心溢出回绕适合需要长定时的应用。UART 配置与默认终端static const uart_conf_t uart_config[] { { .dev USART2, /* ST-Link VCP 默认串口 */ .rx_pin GPIO_PIN(PORT_A, 3), .tx_pin GPIO_PIN(PORT_A, 2), .rx_af GPIO_AF7, .tx_af GPIO_AF7, .bus APB1, .irqn USART2_IRQn, .clk_src 0, /* 使用 APB 时钟 */ #ifdef MODULE_PERIPH_DMA .dma 3, .dma_chan 2 #endif }, { .dev USART3, /* PC10/PC11 */ .rx_pin GPIO_PIN(PORT_C, 11), .tx_pin GPIO_PIN(PORT_C, 10), ... }, { .dev USART1, /* PA9/PA10 */ .rx_pin GPIO_PIN(PORT_A, 10), .tx_pin GPIO_PIN(PORT_A, 9), ... } };板上共暴露 3 路 UART 给 RIOTUSART2PA2/PA3连接板载 ST-Link 的虚拟串口VCP是RIOT shell 的默认终端详见第五节USART3PC10/PC11与USART1PA9/PA10可分配给外部传感器、GPS、调试日志等用途。PWM 配置TIM2 / TIM3 / TIM8static const pwm_conf_t pwm_config[] { { .dev TIM2, .chan { { .pin GPIO_PIN(PORT_A, 15), .cc_chan 0}, { .pin GPIO_PIN(PORT_B, 3), .cc_chan 1}, { .pin GPIO_PIN(PORT_B, 10), .cc_chan 2}, { .pin GPIO_PIN(PORT_B, 11), .cc_chan 3} }, .af GPIO_AF1, .bus APB1 }, { .dev TIM3, /* 仅 PB4 单通道 */ .chan { { .pin GPIO_PIN(PORT_B, 4), .cc_chan 0 }, { .pin GPIO_UNDEF, ... }, ... }, .af GPIO_AF2, .bus APB1 }, { .dev TIM8, /* PC6-PC9 四通道 */ .chan { { .pin GPIO_PIN(PORT_C, 6), .cc_chan 0}, { .pin GPIO_PIN(PORT_C, 7), .cc_chan 1}, { .pin GPIO_PIN(PORT_C, 8), .cc_chan 2}, { .pin GPIO_PIN(PORT_C, 9), .cc_chan 3} }, .af GPIO_AF3, .bus APB2 } };PWM 资源相当充足TIM2PA15/PB3/PB10/PB11、TIM3PB4、TIM8PC6–PC9合计 9 个可输出通道足以驱动多路舵机、LED 调光或电机控制。未被使用的通道以GPIO_UNDEF占位。SPI 配置SPI1static const spi_conf_t spi_config[] { { .dev SPI1, .mosi_pin GPIO_PIN(PORT_A, 7), .miso_pin GPIO_PIN(PORT_A, 6), .sclk_pin GPIO_PIN(PORT_A, 5), .cs_pin SPI_CS_UNDEF, /* 片选由用户自行管理 */ .mosi_af GPIO_AF5, .miso_af GPIO_AF5, .sclk_af GPIO_AF5, .cs_af GPIO_AF5, .rccmask RCC_APB2ENR_SPI1EN, .apbbus APB2, #ifdef MODULE_PERIPH_DMA .tx_dma 1, .tx_dma_chan 1, .rx_dma 0, .rx_dma_chan 1, #endif } };SPI1 挂载在PA5SCLK/ PA6MISO/ PA7MOSI即 Arduino 排针的 D13/D12/D11 位置兼容常见的 Arduino 扩展板与 SPI 传感器。.cs_pin SPI_CS_UNDEF表示硬件片选由应用自行通过 GPIO 控制这与大多数外设驱动如 mrf24j40、sdcard_spi的用法一致。注意SPI1 的 SCLKPA5恰好与 LED0 冲突详见第五节。ADC 配置与 VBAT 监测static const adc_conf_t adc_config[] { {GPIO_PIN(PORT_A, 0), 0, 5}, /* ADC12_IN5 */ {GPIO_PIN(PORT_A, 1), 0, 6}, /* ADC12_IN6 */ {GPIO_PIN(PORT_A, 4), 1, 9}, /* ADC12_IN9 */ {GPIO_PIN(PORT_B, 0), 1, 15}, /* ADC12_IN15 */ {GPIO_PIN(PORT_C, 1), 2, 2}, /* ADC123_IN2 */ {GPIO_PIN(PORT_C, 0), 2, 1}, /* ADC123_IN1 */ {GPIO_UNDEF, 0, 18}, /* VBAT */ }; #define VBAT_ADC ADC_LINE(6) /** VBAT ADC line */RIOT 为该板定义了6 个外部 ADC 通道 1 个内部 VBAT 通道正好对应 Nucleo 排针的 A0–A5PA0、PA1、PA4、PB0、PC1、PC0三段式(引脚, ADC设备号, ADC通道号)的写法可对照板卡手册中的ADC[X]_IN[Y]标注。特别值得关注的是末尾的VBAT 内部通道它通过 ADC1_IN18 采样且板载分压电路只测到实际 VBAT 的 1/3因此可以测量高于参考电压的供电电压非常适合电池供电应用做电量监测调用VBAT_ADC即可读取该通道。通用板级特性LED、按键与 SAUL 设备通过 boards/common/nucleo64/Makefile.include 引入的公共头文件 boards/common/nucleo64/include/board.h 定义了全系列 Nucleo-64 的板级常量。对于 STM32L476RG不属于特殊分支其值为LED0板载绿色 LEDPA5LED0_PIN_NUM 5LED0_PORT GPIO_PORT_A用户按键 B1BTN0PC13BTN0_PIN GPIO_PIN(PORT_C, 13)默认GPIO_IN_PU上拉输入——按下时接地故 gpio_params.h 中为其设置了SAUL_GPIO_INVERTED标志。公共头文件还为 MRF24J40 802.15.4 模块预留了默认参数SPI0、5 MHz 时钟、CS/INT/RESET 分别映射到 Arduino 引脚 10/7/5不过该板默认未启用仅作为扩展参考。得益于 boards/common/nucleo64/include/gpio_params.h 的 SAUL 映射启动后 RIOT 会自动注册两个可通过saul接口访问的 GPIO 设备LED(green)输出与Button(B1 User)输入可直接被 tests/saul 之类的应用枚举和使用。已知冲突SPI 与 LED0 不能同时使用这是 Nucleo-64 系列的通用注意事项记录在 boards/common/nucleo64/doc.md 中Due to a pin conflict on Nucleo64 boards, you can not use the SPI peripheral and LED0 at the same time.由于 SPI1 的 SCLK 占用 PA5即 LED0 所在引脚在 Makefile 中加入USEMODULE periph_spi时构建系统会打印警告并自动禁用periph_init_led0Warning: Using periph_spi on Nucleo64 boards will disable LED0 due to pin conflicts.该逻辑实现在 boards/common/nucleo64/Makefile.dep检测到periph_spi模块后向DISABLE_MODULE追加periph_init_led0。换言之在启用 SPI 的工程里LED0_*相关 API 将不可用需要改用其它 GPIO 做指示。烧录与 RIOT shell 接入编译烧录RIOT 官方烧录指南guides 目录 中的 STM32 板卡章节说明了 ST 系列的标准烧录流程。Nucleo 板载 ST-Link 调试器make flash会直接通过 ST-Link 完成下载。本板在构建系统中的正式板名是nucleo-l476rg典型用法以 hello-world 为例源码位于 examples/hello-worldmake -C examples/hello-world BOARDnucleo-l476rg flash其中BOARDnucleo-l476rg会命中 boards/nucleo-l476rg/Makefile 及common/nucleo下的烧录规则。此外由于板级声明了riotboot特性还可以搭配 riotboot_serial 通过串口进行固件更新。接入 RIOT shell根据 boards/common/nucleo64/doc.mdRIOT shell 默认通过ST-Link 的虚拟串口VCP提供无需外接 USB 转串口模块。各 Nucleo 变体的 VCP 所连接的 USART 不同对 L476RG 而言从 periph_conf.h 可以看到默认终端为USART2PA2/PA3。串口参数固定为参数值波特率115200数据位8校验无N停止位1即 8N1在宿主机上使用任意串口工具如minicom、screen、picocom连接 ST-Link 枚举出的串口设备即可进入 RIOT shell 与板卡交互例如help查看可用命令、ps查看线程、ifconfig查看网络接口等。应用实践要点小结围绕 boards/nucleo-l476rg/doc.md 与配套源码可归纳出该板在 RIOT 中的开发要点选型定位STM32L476RG 的 Cortex-M4F FPU 与 128 KiB RAM 足以承载 RIOT 的网络栈如 gnrc与部分 ML 推理负载1 MiB Flash 也为riotboot双分区固件留出空间外设充足3 路 UART、SPI1、61 路 ADC含 VBAT 电量监测、9 路 PWM 输出基本覆盖传感器采集、执行器控制、串口调试三大类需求注意引脚冲突启用periph_spi前须确认无需使用 LED0默认终端固定RIOT shell 走 USART2/ST-Link VCP115200-8N1开箱即用深入扩展入口继续阅读 cpu/stm32 下的时钟与clk_conf.h头文件可进一步了解 80 MHz 主频与 HSE/LSE 的时钟树配置细节。若需获取更精细的引脚布局与丝印对应关系可参照板卡手册 UM1724 中的引脚图并在实际接线前核对 periph_conf.h 中每项外设的具体引脚映射。【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考