RT-Thread 在 N32G45XCL-STB(N32G455 评估板)上的 BSP 移植与快速上手指南
RT-Thread 在 N32G45XCL-STB(N32G455 评估板)上的 BSP 移植与快速上手指南
N32G45XCL-STB 是国民技术推出的 N32G455 系列评估板,本指南以 RT-Thread 仓库中 bsp/n32/n32gxx_lxx/n32g45xcl-stb 板级支持包(BSP)为核心,系统介绍其硬件资源、外设驱动支持、IO 映射关系,以及基于 MDK5 / IAR / GCC 的编译下载与验证流程。读完本文,你将掌握如何将 RT-Thread 内核在该评估板上跑起来、点亮板载 LED,并通过串口进入 msh 命令行,同时理解 BSP 中板级初始化、时钟与堆内存配置的底层实现。
简介
N32G45XCL-STB 是国民技术推出的一款 N32G455 系列评估板,其搭载的 MCU 主要资源参数如下:
| 硬件 | 描述 |
|---|---|
| 芯片型号 | N32G455CCL7 |
| CPU | ARM Cortex M4 |
| 主频 | 144M |
| 片内SRAM | 144K |
| 片内FLASH | 256K |
上述资源参数与板级支持包中的实际配置一致:在 board/board.h 中,FLASH 起始地址为 0x08000000、大小为 256 * 1024 字节,SRAM 大小定义为 144K(N32_SRAM_SIZE (144)),堆区终点为 0x20000000 + 144 * 1024。BSP 目录下的 N32G45x_Firmware_Library 提供了该芯片对应的 CMSIS 器件头文件、标准外设驱动库(n32g45x_std_periph_driver)与 USB FS 驱动,是板级驱动实现的基础。
编译说明
N32G45XCL-STB 板级包支持 MDK5、IAR 和 GCC 三种开发环境,官方已测试的版本如下:
| IDE/编译器 | 已测试版本 |
|---|---|
| MDK5 | V5.34 |
| IAR | V8.50 |
| GCC | GCC 6.2.1 20161205 (release) |
三种环境对应的工具链配置集中在 rtconfig.py 中:
- GCC:交叉编译前缀为
arm-none-eabi-,CPU 为 cortex-m4,启用硬件浮点-mfpu=fpv4-sp-d16 -mfloat-abi=hard,链接脚本使用board/linker_scripts/link.lds,编译产物为rtthread.bin; - MDK5(armcc):使用
--cpu Cortex-M4.fp,以散列文件board\linker_scripts\link.sct进行链接,产物为rtthread.bin; - IAR(iccarm):使用
--cpu=Cortex-M4 --fpu=VFPv4_sp,链接配置为board/linker_scripts/link.icf。
三种链接脚本(.lds / .sct / .icf)均位于 board/linker_scripts 目录。GCC 工具链的路径可通过环境变量 RTT_EXEC_PATH 覆盖,交叉工具链则通过 RTT_CC 选择(默认 gcc)。
板载资源
- MCU:N32G455CCL7,主频 144MHz,256KB FLASH
- 常用外设
- LED:3个,LED1 (PA8),LED2(PB4),LED3(PB5)
- 按键:5个,RESET(NRST),WAKEUP(PA0),KEY1(PA4),KEY2(PA5),KEY3(PA6)
- 常用接口:USB 接口(J3)
- 调试接口: 板载的 CMSIS-DAP SWD 下载(J4),JLINK
其中 LED3 连接在 PB5 引脚上,这与示例程序 applications/main.c 中 #define LED3_PIN GET_PIN(B, 5) 的定义一致,板级驱动 drv_gpio.c(位于 bsp/n32/n32gxx_lxx/libraries/n32_drivers)通过 RT-Thread PIN 设备框架将 GET_PIN(B, 5) 解析为具体的 GPIO 编号。
外设支持
本 BSP 目前对外设驱动的支持情况如下:
| 驱动 | 支持情况 | 备注 |
|---|---|---|
| UART | 支持 | USART1/2/3, UART4/5/6 |
| GPIO | 支持 | PA0, PA1... PE15 ---> PIN: 0, 1...79 |
| I2C | 支持 | 软件I2C |
| SPI | 支持 | SPI1/2/3 |
| ADC | 支持 | ADC1/2/3/4 |
| CAN | 支持 | CAN1/2 |
| DAC | 支持 | DAC1/2 |
| CLOCK_TIMER | 支持 | TIMER1/2/3/4/5/6/7/8 |
| WDT | 支持 | IWDG |
| RTC | 支持 | 时钟源支持LSE/LSI/HSE |
这些驱动对应 bsp/n32/n32gxx_lxx/libraries/n32_drivers 目录下的 drv_usart.c、drv_gpio.c、drv_i2c.c、drv_spi.c、drv_adc.c、drv_can.c、drv_dac.c、drv_rtc.c、drv_timer.c、drv_wdt.c 等源文件,均基于 RT-Thread 设备驱动框架实现。驱动是否编译进固件由 board/Kconfig 中的配置开关决定:
BSP_USING_GPIO(默认开启,自动选中RT_USING_PIN);BSP_USING_UART(默认开启,可分别勾选 USART1 ~ UART6,默认仅启用 USART1);BSP_USING_SPI(默认关闭,可启用 SPI1/2/3);BSP_USING_SOFT_I2C(默认关闭,可配置软件 I2C1 的 SCL/SDA 引脚号);BSP_USING_RTC(默认关闭,时钟源可选 LSE / HSE / LSI 三种);BSP_USING_WDT、BSP_USING_CLOCK_TIMER(TIMER1~8)、BSP_USING_ADC(ADC1~4)、BSP_USING_DAC(DAC1/2)、BSP_USING_CAN(CAN1/2)、BSP_USING_PWM(TIM1~3 各通道,并支持引脚重映射选择)均默认关闭,可按需开启。
当前 rtconfig.h 已启用的驱动包括 GPIO、USART1、串口(RT_USING_SERIAL)、CAN、软件 I2C、ADC、DAC、RTC、SPI、WDT、PIN 等,内核节拍为 RT_TICK_PER_SECOND 1000,控制台设备名为 "usart1",即默认串口打印通过 USART1 输出。
IO在板级支持包中的映射情况
以下为 BSP 中已经定义的 IO 复用映射关系,开发者可直接按此接线使用:
| IO号 | 板级包中的定义 |
|---|---|
| PA9 | USART1_TX |
| PA10 | USART1_RX |
| PA2 | USART2_TX | | PA3 | USART2_RX |
| PB10 | USART3_TX | | PB11 | USART3_RX |
| PA13 | UART4_TX | | PA14 | UART4_RX |
| PB13 | UART5_TX | | PB14 | UART5_RX |
| PB0 | UART6_TX | | PB1 | UART6_RX |
| PA4 | SPI1_NSS | | PA5 | SPI1_SCK | | PA6 | SPI1_MISO | | PA7 | SPI1_MOSI |
| PB12 | SPI2_NSS | | PB13 | SPI2_SCK | | PB14 | SPI2_MISO | | PB15 | SPI2_MOSI |
| PA15 | SPI3_NSS | | PB3 | SPI3_SCK | | PB4 | SPI3_MISO | | PB5 | SPI3_MOSI |
| PA1 | ADC1_IN2 | | PA3 | ADC1_IN4 |
| PA4 | ADC2_IN1 | | PA5 | ADC2_IN2 |
| PB11 | ADC3_IN1 | | PB13 | ADC3_IN5 |
| PB14 | ADC4_IN4 | | PB15 | ADC4_IN5 |
| PA4 | DAC_OUT1 | | PA5 | DAC_OUT2 |
| PB8 | CAN1_RX | | PB9 | CAN1_TX |
| PB12 | CAN2_RX | | PB13 | CAN2_TX |
使用说明
本章节是为刚接触 RT-Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上,看到实验效果。
快速上手
本 BSP 为开发者提供 MDK5 工程、IAR 工程,并且支持 GCC 开发环境。下面以 MDK5 开发环境为例,介绍如何将系统运行起来。
硬件连接
使用数据线连接开发板到 PC,打开电源开关。
编译下载
双击工程根目录下的 project.uvprojx 文件,打开 MDK5 工程,编译并下载程序到开发板。调试接口为板载的 CMSIS-DAP SWD 下载口(J4),也可使用 JLINK。
运行结果
下载程序成功之后,系统会自动运行,观察开发板上 LED 的运行效果,LED3 会周期性闪烁。
连接开发板对应串口到 PC,在终端工具里打开相应的串口(115200-8-1-N),复位设备后,在串口上可以看到 RT-Thread 的输出信息:
\ | /
- RT - Thread Operating System
/ | \ 4.1.1 build Apr 24 2022 17:24:22
2006 - 2022 Copyright by RT-Thread team
msh >
看到 msh > 提示符即表示系统已成功启动,此时可以输入 RT-Thread 内置命令(如 list_thread、list_device、ps 等)进行交互验证。
示例程序源码解读
LED3 周期性闪烁的效果来自 applications/main.c,核心逻辑如下:
#define LED3_PIN GET_PIN(B, 5)
int main(void)
{
/* set LED3 pin mode to output */
rt_pin_mode(LED3_PIN, PIN_MODE_OUTPUT);
while (1)
{
rt_pin_write(LED3_PIN, PIN_HIGH);
rt_thread_mdelay(500);
rt_pin_write(LED3_PIN, PIN_LOW);
rt_thread_mdelay(500);
}
}
程序通过 RT-Thread PIN 设备接口将 PB5 配置为推挽输出,然后每 500ms 翻转一次电平,实现 LED3 的 1Hz 周期闪烁。
板级初始化流程
BSP 的启动依赖 board/board.c 中的 rt_hw_board_init():
NVIC_Configuration():将中断向量表设置在0x08000000(FLASH)或0x20000000(RAM,需定义VECT_TAB_RAM);SysTick_Config(SystemCoreClock / RT_TICK_PER_SECOND):按RT_TICK_PER_SECOND(默认 1000)配置系统节拍定时器,其中断服务函数SysTick_Handler()调用rt_tick_increase()驱动内核时钟;rt_components_board_init():执行板级初始化(由INIT_BOARD_EXPORT导出);rt_system_heap_init(HEAP_BEGIN, HEAP_END):初始化系统堆内存,堆区从编译器生成的 ZI 段结尾(ARMCC 为Image$$RW_IRAM1$$ZI$$Limit,GCC 为__bss_end)延伸到 SRAM 末尾。
注意事项
暂无。
联系人信息
维护人:
该 BSP 由国民技术(Nations)维护,仓库中还提供了 N32G43x、N32L40x、N32L43x、N32G4FR、N32WB452 等系列的同族板级支持包,分布于 bsp/n32 目录下,可供移植参考。
