RT-Thread移植NUC980实战：从BSP适配到驱动调试全解析

RT-Thread移植NUC980实战：从BSP适配到驱动调试全解析

发布时间：2026/8/19 12:05:56
RT-Thread移植NUC980实战：从BSP适配到驱动调试全解析 1. 从零开始为什么要在NUC980上跑RT-Thread最近在折腾新唐的NUC980系列芯片这玩意儿在工控、物联网网关领域用得挺多性能不错接口也全。但官方给的开发环境要么是裸机要么是Linux对于很多实时性要求高、资源又相对受限的场景来说有点“杀鸡用牛刀”或者“牛刀不好使”的感觉。这时候一个轻量级、高实时性的操作系统就成了刚需RT-Thread自然就进入了视野。RT-ThreadRTT在国内嵌入式圈子的口碑不用多说组件丰富、生态活跃最关键的是它对国产芯片的支持一直很上心。把RT-Thread移植到NUC980上意味着你能在这颗芯片上以一个非常熟悉的、类似Linux的编程体验比如POSIX接口、丰富的软件包去完成那些对实时性和确定性有严格要求任务。比如说你用NUC980做一个高速数据采集器主逻辑跑在RTT上保证实时响应同时通过RTT的AT组件或者LWIP去管理4G模块联网再把数据存到文件系统里整个架构清晰又高效比裸机轮询舒服太多也比全功能Linux更省资源、启动更快。所以这篇东西就是记录我把RT-Thread成功跑到NUC980上的完整过程包括环境搭建、BSP适配、内核启动、驱动调试以及最后跑个多线程小demo验证。过程中踩的坑、绕的路都会详细写出来目标就是让你看完能自己动手复现把RT-Thread用起来。2. 战前准备工具链、源码与硬件环境梳理动手之前先把“弹药”备齐。NUC980是ARM926EJ-S内核所以我们需要针对该内核的交叉编译工具链。RT-Thread官方推荐使用arm-none-eabi-gcc但对于NUC980我们更常用的是新唐官方提供的或者ARM官方针对ARM9的arm-none-eabi-gcc。这里我选择的是ARM官方GNU Arm Embedded Toolchain版本10.3-2021.10比较稳定。2.1 工具链安装与配置去ARM官网下载对应你主机系统Linux x86_64的gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2。解压后把bin目录加到系统PATH里。# 假设解压到 /opt 目录 tar -xjf gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2 -C /opt # 将工具链路径加入环境变量可以写入 ~/.bashrc export PATH/opt/gcc-arm-none-eabi-10.3-2021.10/bin:$PATH验证一下是否安装成功arm-none-eabi-gcc --version应该能看到类似gcc version 10.3.1 20210824 (release) (GNU Arm Embedded Toolchain 10.3-2021.10)的输出。2.2 获取RT-Thread源码RT-Thread的源码托管在Gitee上。我们直接克隆完整仓库里面包含了所有BSP板级支持包。git clone https://gitee.com/rtthread/rt-thread.git cd rt-thread克隆完成后进入rt-thread/bsp目录你会发现一大堆已经支持的开发板目录。我们的目标是在这里为NUC980创建一个新的BSP或者看看有没有现成的。经过一番搜寻目前以我写作时为准官方BSP里还没有直接的NUC980目录所以我们需要“移植”。但别慌我们可以找一个最接近的ARM9 BSP作为模板比如samsung/s3c2440或者nuvoton/nuc970。NUC970是NUC980的前一代相似度极高是最好的起点。2.3 硬件准备与调试手段我手头的硬件是NUC980DK61Y开发板。你需要准备NUC980开发板确认型号不同型号的引脚和外设可能有细微差别。USB转TTL串口线用于连接开发板的调试串口通常是UART0这是最重要的调试信息输出窗口。在NUC980上调试信息默认从UART0打印。J-Link或Nu-Link调试器用于下载程序、单步调试。如果只是跑起来看日志串口就够了。但调试驱动、解决启动问题有个调试器会事半功倍。NUC980支持SWD/JTAG调试。电源确保供电稳定。连接好串口线在电脑上用串口终端软件如minicom,picocom, 或者Windows下的MobaXterm、SecureCRT打开对应串口配置参数通常为115200 8N1波特率1152008数据位无校验1停止位。注意在焊接或连接调试器时务必先断电操作。NUC980的IO电压可能是3.3V确保你的调试器电平匹配。3. BSP移植核心以NUC970 BSP为蓝本进行适配这是最核心的一步。我们的策略是复制一份bsp/nuvoton/nuc970目录重命名为nuc980然后在此基础上修改。3.1 创建新BSP目录并复制基础文件cd rt-thread/bsp cp -r nuvoton/nuc970 nuvoton/nuc980 cd nuvoton/nuc980现在nuc980目录里就有了一个初始框架。接下来是逐项修改。3.2 修改链接脚本与启动文件链接脚本.ld文件定义了代码和数据在内存中的布局。NUC970和NUC980的内存映射Memory Map可能不同必须根据NUC980的数据手册修改。找到链接脚本通常在board/linker_scripts目录下文件名为link.lds或类似。修改内存区域定义打开link.lds你需要根据NUC980的数据手册修改MEMORY部分。关键信息包括内部SRAM的起始地址和大小NUC980的内置SRAM大小和地址可能与NUC970不同。外部内存如DDR的起始地址和大小如果使用如果你的板子接了DDR需要在这里定义。Flash的起始地址和大小用于存放代码。例如NUC980DK61Y有128KB内部SRAM地址可能是0x00000000紧耦合内存TCM或0x20000000。需要仔细核对手册。一个可能的修改示例如下MEMORY { /* 内部SRAM */ SRAM (rwx) : ORIGIN 0x00000000, LENGTH 128K /* 外部DDR2 (假设板载64MB) */ DDR (rwx) : ORIGIN 0x80000000, LENGTH 64M /* SPI NOR Flash (通过内存映射接口XIP访问) */ FLASH (rx) : ORIGIN 0x80000000, LENGTH 16M /* 注意此地址可能与DDR冲突需根据实际硬件二选一或重映射 */ }重要提示这里最容易出错。NUC980的启动方式多样从SPI Flash、NAND Flash、SD卡等芯片上电后最初运行的代码所在地址通常是0x00000000和后续我们程序加载的地址可能不同。对于从SPI Flash XIP就地执行的情况Flash会被映射到某个地址如0x80000000。对于从SD卡启动并拷贝到DDR运行的情况链接地址就是DDR的地址。你必须根据你的具体启动配置来设置ORIGIN。最稳妥的方法是参考新唐官方BSP比如Linux BSP里的链接脚本。修改启动文件启动文件通常是board/startup_gcc.s或startup_ARMCMx.s包含芯片上电后最先执行的汇编代码负责设置堆栈、初始化内存、清零BSS段、最后跳转到C语言的main函数在RT-Thread里是rtthread_startup。NUC980和NUC970同属ARM926EJ-S核心汇编指令集一致但芯片特定的初始化部分可能需要调整尤其是时钟初始化NUC980的时钟树PLL配置可能与NUC970不同。在启动文件的早期可能有一段配置系统主频的汇编。如果这里配置不对后续所有时序都会乱。一个更常见的做法是在启动文件里只做最基本的初始化比如关闭看门狗把复杂的时钟初始化放到C语言的rt_hw_board_init()函数中用更易读的代码去配置寄存器。内存控制器初始化如果使用外部DDR需要在C语言环境中仔细配置汇编阶段很难完成。因此对于启动文件我建议先保持NUC970的版本基本不动只修改那些明显不同的寄存器地址如果文件里有硬编码的地址。把关键的差异留到C代码中去处理。3.3 修改板级配置与驱动框架修改rtconfig.py这个文件是RT-Thread的构建配置脚本。需要修改交叉编译工具链前缀。# 将原来的可能指向nuc970的工具链路径统一改为我们安装的 EXEC_PATH r/opt/gcc-arm-none-eabi-10.3-2021.10/bin # 工具链前缀 PREFIX arm-none-eabi-同时检查里面的CFLAGS、LDFLAGS是否包含了正确的CPU架构选项-mcpuarm926ej-s。修改board/Kconfig这是菜单配置的源文件。把里面所有出现“970”的地方改成“980”并更新芯片描述、默认内存大小等。# 将 config SOC_NUC970 bool select RT_USING_COMPONENTS_INIT select RT_USING_USER_MAIN default y # 改为 config SOC_NUC980 bool select RT_USING_COMPONENTS_INIT select RT_USING_USER_MAIN default y同时修改默认的SRAM和Flash大小配置项。重命名与修改驱动文件drivers目录下的驱动文件如drv_uart.cdrv_gpio.c包含了针对NUC970的寄存器定义和操作函数。我们需要将其适配到NUC980。头文件将包含的NUC970寄存器头文件如nuc970.h或NUC970xx.h替换为NUC980的对应头文件。你需要从新唐官方的NUC980 BSP包通常是标准外设驱动库里找到这些头文件如NUC980.h并拷贝到BSP的libraries目录下。寄存器地址用文本编辑器的查找替换功能将所有NUC970的基地址宏如UART0_BASE替换为NUC980的。这些基地址在芯片头文件里有定义务必核对。例如UART0的基地址可能从0xB8000000变为了0xB0070000。时钟源配置串口、定时器等外设的时钟源配置函数clk_enable_module_clock的参数可能不同需要根据NUC980的用户手册修改。引脚复用配置NUC980的GPIO多路复用寄存器MFP配置方式可能与NUC970有差异。需要仔细阅读NUC980的Datasheet中GPIO章节重写drv_gpio.c中的引脚初始化函数。这个过程比较繁琐但本质是“照葫芦画瓢”。对照NUC970的驱动代码和NUC980的用户手册把寄存器操作一一对应修改过去。4. 内核启动与时钟配置的魔鬼细节BSP文件初步修改完后就可以尝试编译了。但要让内核真正跑起来rt_hw_board_init()这个函数是关键中的关键它由启动文件调用负责板级最底层的初始化。4.1 实现 rt_hw_board_init()这个函数通常在board.c文件中。我们需要按顺序完成以下几件事关闭看门狗防止芯片复位。// 假设WDT寄存器地址定义在NUC980.h中 outpw(REG_WDT_CR, 0); // 禁用看门狗配置系统时钟这是移植成功的第一道坎。NUC980的时钟源外部晶振频率、PLL倍频参数、分频系数必须配置正确才能得到我们想要的系统主频如200MHz, 300MHz。void system_clock_config(void) { // 1. 使能外部高速晶振例如12MHz CLK_EnableXtalRC(CLK_PWRCTL_HXTEN_Msk); while(CLK_GetClockSourceStatus(CLK_CLKSTATUS_HXT_STB_Msk) 0); // 等待稳定 // 2. 设置PLL频率。以生成300MHz的PLL输出为例根据公式计算 // PLL_FOUT FIN * (NF / (NR * NO)) // FIN12MHz, 目标FOUT300MHz, 设定NR2, NF100, NO2 // 则 300 12 * (100 / (2*2)) 12 * 25 300 CLK_SetCoreClock(300000000); // 这个函数需要自己实现内部调用NUC980的PLL配置寄存器 // 3. 选择PLL作为系统时钟源 CLK_SetSysClkSrc(CLK_CLKSEL0_HCLK_S_PLL); }踩坑记录新唐的时钟配置寄存器比较复杂分频、倍频、锁相环使能顺序有严格要求。最稳妥的方法是直接参考新唐官方SDK例如用于裸机或Linux的BSP中的时钟初始化代码将其移植过来。自己从零开始算参数很容易因为某个位没设置对导致锁相环失锁系统根本跑不起来或者频率不对导致串口乱码。初始化内存管理告诉RT-Thread内核可用的内存区域。#ifdef RT_USING_HEAP // 如果使用内部SRAM作为堆空间 rt_system_heap_init((void*)0x00000000, (void*)(0x00000000 128*1024)); // 如果使用外部DDR则传入DDR的起始和结束地址 // rt_system_heap_init((void*)0x80000000, (void*)(0x80000000 64*1024*1024)); #endif初始化硬件定时器为RT-Thread的系统时钟节拍SysTick提供硬件定时器。ARM926EJ-S内核没有内置的SysTick定时器所以我们需要使用芯片的一个通用定时器如Timer0来模拟。void rt_hw_timer_init(void) { // 配置Timer0使其每1ms产生一次中断 // 1. 使能Timer0模块时钟 CLK_EnableModuleClock(TMR0_MODULE); // 2. 选择时钟源例如PCLK/2 CLK_SetModuleClock(TMR0_MODULE, CLK_CLKSEL1_TMR0_S_PCLK, 0); // 3. 初始化定时器结构体设置周期为1ms TIMER_Open(TIMER0, TIMER_PERIODIC_MODE, 1000); // 1000Hz // 4. 设置中断回调函数在函数中调用 rt_tick_increase() TIMER_EnableInt(TIMER0); // 5. 启动定时器 TIMER_Start(TIMER0); }并在中断服务程序ISR中调用rt_tick_increase()。初始化控制台串口这是调试的生命线。确保在rt_hw_board_init()中调用rt_hw_uart_init()并将指定的串口如UART0注册为控制台设备 (rt_console_set_device())。初始化引脚复用如果之前没在驱动层做这里需要初始化调试串口所用引脚的功能设置为UART模式而非GPIO。4.2 解决编译与链接错误第一次编译肯定会报错主要是找不到头文件、未定义的寄存器符号等。# 在bsp/nuvoton/nuc980目录下执行 scons头文件路径错误在rtconfig.py或SConscript文件中确保CPPPATH包含了NUC980头文件所在的目录。未定义符号根据错误信息去NUC970的驱动代码里找到这个符号可能是寄存器宏或函数然后去NUC980的头文件里找到对应的定义修改或添加。如果NUC980的头文件里确实没有那可能是该外设在NUC980上已被移除或改名需要注释掉相关代码或做条件编译。链接地址错误如果链接器报错说某个段如.data,.bss无法放入内存区域说明链接脚本里的内存大小或地址设置不对回头仔细检查。这个过程需要耐心解决一个错误再出现下一个直到scons命令最终生成rtthread.elf、rtthread.bin等文件。5. 下载、调试与第一个“Hello RT-Thread”生成二进制文件后下一步就是把它烧录到芯片里运行。5.1 程序下载到Flash有多种方式取决于你的启动模式由芯片的启动引脚决定和调试工具。通过调试器J-Link/Nu-Link下载到内部SRAM运行这种方式最快适合调试。使用OpenOCD或新唐提供的NuTool工具通过SWD接口将.bin或.elf文件直接加载到SRAM的指定地址即链接脚本中SRAM区域的ORIGIN然后让PC指针跳转到那里执行。优点是无需擦写Flash瞬间完成。缺点是断电后程序丢失。# 使用OpenOCD的示例命令需要编写openocd.cfg配置文件 openocd -f interface/jlink.cfg -f target/nuvoton_nuc980.cfg -c program rtthread.bin 0x00000000 verify reset exit通过调试器下载到SPI NOR Flash如果产品需要脱机运行就需要烧写到外部Flash。这需要调试器支持Flash编程算法。在OpenOCD或IDE如Keil MDK如果使用其进行编译中选择对应的Flash型号如W25Q128JV然后进行编程。程序会被烧写到Flash的起始扇区。芯片上电后如果启动模式设置为从SPI Flash启动内部的ROM引导程序会将Flash前一段代码拷贝到内部SRAM执行或进行XIP。通过USB/UART ISP工具新唐芯片通常支持通过UART0进行ISP在系统编程。使用新唐提供的NuWriter或NuGang工具配合芯片进入ISP模式通常在上电时拉低某个引脚可以通过串口将程序烧写到NAND或SPI Flash中。这种方式不需要调试器。5.2 串口调试与问题排查连接好串口线打开终端软件。给开发板上电。如果一切顺利你应该在串口终端里看到RT-Thread的启动Logo和版本信息以及命令提示符msh 。但第一次成功是小概率事件更常见的是没输出或者输出乱码。完全没有输出检查硬件连接TX/RX线是否接反串口号是否正确波特率是否为115200检查程序是否真的在运行用调试器单步调试看PC指针是否跳转到了rtthread_startup。如果没有检查复位向量表在启动文件里是否正确。检查时钟配置系统时钟没配好CPU根本不工作或者工作频率极低。用调试器查看系统时钟控制寄存器的值与手册对比。检查串口初始化确认rt_hw_uart_init()被成功调用且引脚复用配置正确。可以用调试器在初始化后向UART的发送数据寄存器THR写一个字符看串口是否有数据波形输出用示波器或逻辑分析仪看TX引脚。输出乱码波特率不匹配这是最常见原因。计算一下你的系统时钟和串口波特率分频器设置。确保终端软件的波特率与代码中设置的完全一致。如果时钟配置错了实际波特率就会偏离115200。数据格式问题检查代码和终端是否都是8N1。5.3 运行第一个应用当看到msh 提示符时恭喜你内核已经成功启动了你可以输入内置命令msh list_thread查看当前运行的线程会看到tshell,tidle,timer等。接下来我们创建一个简单的用户线程打印“Hello RT-Thread on NUC980!”。在applications目录下新建一个hello.c#include rtthread.h static void hello_thread_entry(void *parameter) { while (1) { rt_kprintf(Hello RT-Thread on NUC980!\n); rt_thread_mdelay(1000); // 每秒打印一次 } } int hello_init(void) { rt_thread_t tid; tid rt_thread_create(hello, hello_thread_entry, RT_NULL, 512, 10, 10); if (tid ! RT_NULL) { rt_thread_startup(tid); } return 0; } INIT_APP_EXPORT(hello_init); // 使用自动初始化机制系统启动后自动执行hello_init修改applications/SConscript将这个文件加入编译。重新执行scons编译下载程序。上电后除了启动信息你应该会每隔一秒看到Hello RT-Thread on NUC980!的输出。这证明你的移植不仅内核能跑多任务调度也正常工作了。6. 驱动完善与组件集成让板子真正“有用”起来内核跑通只是第一步要让板子能用于实际项目还需要完善驱动并集成必要的软件包。6.1 完善其他基础驱动根据你的项目需求逐步移植或完善其他驱动GPIOdrv_gpio.c应该已经基本可用测试点亮一个LED。硬件定时器除了给系统滴答用的那个其他定时器可以用于精确延时或PWM输出。看门狗产品化需要。ADC/DAC模拟量采集。I2C/SPI连接传感器、存储芯片等。这里要注意NUC980的I2C/SPI控制器与NUC970的差异特别是时钟使能和引脚复用部分。6.2 集成文件系统与日志组件RT-Thread的另一个强大之处在于丰富的组件。我们可以轻松集成文件系统FAT和日志系统ulog。启用FAT文件系统在menuconfig(scons --menuconfig) 中找到以下选项并启用RT-Thread Components - Device Drivers - Using MTD Nor Flash device driversRT-Thread Components - Device Virtual File System - Using device virtual file systemRT-Thread Components - Device Virtual File System - Using FATFS file system在Hardware Drivers Config - On-chip Peripheral Drivers中启用 SPI 和对应的 Flash 驱动如drv_sfud软件包。配置好后需要实现Flash的底层读写接口rt_spi_flash_device_init并调用dfs_mount将Flash分区挂载到目录如/或/SD。这样你就可以在MSH里用ls,cat,mkdir等命令操作文件了。启用ulog日志系统这是网络热词中提到的一个实用功能。在menuconfig中启用RT-Thread Components - Utilities - Enable ulog日志系统。可以进一步配置日志输出级别、后端例如同时输出到控制台和文件。在代码中就可以使用ulog_x()系列宏如LOG_D(这是一条调试信息)来打印日志。通过配置可以将日志实时输出到串口同时异步保存到刚刚挂载的文件系统中非常利于产品现场问题追踪。6.3 网络功能集成如果板子带以太网MACNUC980很多型号集成了以太网MAC。要使用网络需要在menuconfig中启用 lwIP 协议栈。移植以太网PHY驱动。这通常是移植中最复杂的部分之一。你需要在drivers目录下创建drv_eth.c。实现eth_device结构体要求的接口init,open,close,read,write,control。正确初始化NUC980的EMAC控制器包括时钟、引脚、DMA描述符等。实现PHY芯片如LAN8720A的读写函数通过MI接口并完成PHY的复位、自协商等配置。处理好接收中断和发送流程。成功之后就可以使用ping,ifconfig,tcp等网络命令和功能了。7. 移植过程中的典型问题与解决思路在整个移植过程中我遇到了几个有代表性的问题这里总结一下7.1 系统启动后立即进入HardFault现象通过调试器发现程序刚跳转到C入口不久就触发了硬件错误异常。排查检查堆栈指针(SP)初始化在启动文件的最开始是否正确设置了各个模式下的堆栈指针堆栈地址是否在有效的RAM区域内检查向量表重定位如果程序在Flash中运行但链接地址是RAM或者反之需要正确配置向量表偏移寄存器如ARM的VTOR。对于ARM9可能需要手动拷贝向量表。检查内存访问在初始化代码中是否有在内存控制器尤其是DDR控制器初始化之前就访问了外部内存地址这会导致总线错误。确保初始化顺序先初始化时钟再初始化内存控制器最后才访问外部内存。解决使用调试器查看发生HardFault时的PC指针和LR寄存器回溯调用栈。重点关注rt_hw_board_init()中早期的内存操作和函数调用。7.2 线程调度不工作只有空闲线程在运行现象串口有启动信息但创建的用户线程如上面的hello线程从未执行list_thread显示用户线程一直是ready状态。排查系统滴答中断是否正常这是调度器的发动机。在定时器中断服务程序里加一个翻转LED的代码看LED是否以预期频率闪烁。如果不闪说明定时器中断没进来。检查定时器初始化、中断使能、中断向量表配置。中断控制器配置NUC980的中断控制器GIC可能需要额外初始化才能将外设中断如Timer中断路由到CPU。在rt_hw_board_init()中在定时器初始化之前调用一个中断控制器初始化函数。解决确认系统滴答中断每秒触发次数是否正确应该是RT_TICK_PER_SECOND次默认1000次。可以在滴答中断服务程序中打印一个字符来验证。7.3 使用外部DDR时程序运行不稳定现象程序在内部SRAM运行正常但链接到外部DDR后时而能启动时而崩溃数据读写可能出错。排查DDR初始化参数这是最可能的原因。DDR的类型DDR2/DDR3、时序参数CL, tRCD, tRP, tRAS等、刷新率必须严格匹配你板子上使用的DDR颗粒。这些参数通常在板级头文件如board.h中以一组宏定义或结构体形式存在。电源与时钟稳定性DDR控制器和DDR颗粒的供电是否稳定时钟是否干净硬件上可以检查电源纹波。信号完整性对于较高频率的DDR布线长度、等长、端接电阻会影响信号质量。如果硬件设计有瑕疵软件很难弥补。解决最可靠的方法是“抄作业”。找到新唐官方为你的这块开发板提供的Linux或裸机BSP里面一定有经过验证的DDR初始化代码。直接把这部分代码移植过来成功率最高。不要试图自己从零计算时序参数。把RT-Thread移植到一个新的芯片平台就像给它打造一个全新的“家”。这个过程充满了对芯片手册的深度阅读、对现有代码的借鉴修改以及不断的调试验证。当最终在串口终端上看到熟悉的RT-Thread标志和闪烁的命令提示符时那种成就感是实实在在的。对于NUC980来说RT-Thread的加入让它从一个性能强大的裸机或Linux处理器变成了一个在实时性、资源消耗和开发效率上取得更好平衡的嵌入式平台非常适合那些需要复杂逻辑、网络连接和文件存储同时又对任务响应时间有严格要求的应用场景。