RT-Thread 在 N32G45XCL-STB(N32G455 评估板)上的 BSP 移植与快速上手指南

原创2026-09-23 18:13:052,483 阅读
文章标签:操作系统嵌入式OSRTOS物联网系统编程嵌入式

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

N32G45XCL-STB 评估板实物图

其中 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():

  1. NVIC_Configuration():将中断向量表设置在 0x08000000(FLASH)或 0x20000000(RAM,需定义 VECT_TAB_RAM);
  2. SysTick_Config(SystemCoreClock / RT_TICK_PER_SECOND):按 RT_TICK_PER_SECOND(默认 1000)配置系统节拍定时器,其中断服务函数 SysTick_Handler() 调用 rt_tick_increase() 驱动内核时钟;
  3. rt_components_board_init():执行板级初始化(由 INIT_BOARD_EXPORT 导出);
  4. 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 目录下,可供移植参考。

登录后查看全文
rt-thread