21ic电子技术开发论坛 › 单片机与嵌入式系统 › 极海MCU › 【APM32F402R Micro-EVB开发板测评】APM32F402R Micro-E ...
返回列表 发新帖我要提问

[APM32F4] 【APM32F402R Micro-EVB开发板测评】APM32F402R Micro-EVB开发板移植RT-Thread教程

[复制链接]
657|9
 楼主| hbzjt2011 发表于 2025-8-1 15:41 | 显示全部楼层 |阅读模式
Micro, Thread, RT-Thread, ev, AD
本帖最后由 hbzjt2011 于 2025-8-2 14:10 编辑

1. 开发板简介
APM32F402R Micro-EVB V1.0开发板是极海半导体推出的基于APM32F402R芯片的评估板。APM32F402R是一款基于ARM Cortex-M4内核的32位微控制器，具有以下特点：
  • ARM Cortex-M4F内核，最高主频128MHz
  • 集成FPU浮点运算单元
  • 丰富的外设接口
  • 工业级温度范围
2. RT-Thread简介
RT-Thread 是一个开源的实时操作系统（RTOS），最初由中国开发者陈祥于2006年创建，专为嵌入式系统设计，具有小巧、稳定、可裁剪、易移植等特点。它支持多种架构（如 ARM Cortex-M/R/A、RISC-V、MIPS、x86 等），广泛应用于物联网、工业控制、智能家居、车载电子等领域。
RT-Thread 的主要特点包括：
  • 内核轻量高效
    RT-Thread 的内核设计精简，典型内核最小占用仅几 KB，适用于资源受限的微控制器。
  • 组件化设计
    系统由内核、驱动框架、中间件和应用层组件构成，用户可按需裁剪和配置，实现高效资源利用。
  • 丰富的软件生态
    拥有 RT-Thread Studio IDE、RT-Thread Smart（类 Linux 系统）、RT-Thread Nano（超轻量内核） 等多个版本，配套的 RT-Thread 软件包管理器（PKG） 支持快速集成网络协议栈（如 TCP/IP、MQTT）、文件系统（如 FAT、LittleFS）、图形界面、设备驱动等。
  • 友好的开发体验
    提供图形化配置工具、完善的文档和活跃的社区支持。兼容 POSIX 部分接口，便于传统软件移植。
  • 支持主流开发环境和芯片平台
    支持 Keil、IAR、GCC 等开发工具链，已移植至 STM32、NXP、TI、Nordic、GD、Geehy、瑞萨、ESP32 等大量主流芯片。



RT-Thread目前已经支持极海的部分芯片和开发板，具体如下：
97378688b3470bdd31.png

3. 移植过程
3.1 开发工具
开发环境
  • IDE: Keil MDK-ARM 5.24及以上版本
  • 调试器: 板载CMSIS DAP Link 调试器
  • 开发板: APM32F402R Micro-EVB V1.0
  • 编译器: ARM Compiler 5.06 或 ARM Compiler 6，以及Env工具（官网下载）

3.2 获取RT-Thread源码下载完整源码
复制
  1. git clone https://github.com/RT-Thread/rt-thread.git

3.3 复制基础工程
从\rt-thread\bsp\apm32目录复制相似MCU工程为apm32f402rb-evalboard
16570688b38be124b0.png
使用Keil打开工程，目录如下，同时更改Device为APM32F402RB，并相应选择对应的调试下载工具
38558688b396378c20.png 78947688b39839d054.png
98516688b3b2a49724.png

接下来检查工程目录下的SConstruct文件中的库文件是否与开发板芯片相对应，如果复制的同系列型号则无需更改
89021688c4752e122e.png

修改\rt-thread\bsp\apm32\libraries\APM32F4xx_Library目录下的SConscript文件，注意将库文件均替换为APM32F402_403_StdPeriphDriver中标准库文件 70366688c6db603087.png

接下来修改board/目录下的KConfig文件，主要修改芯片型号并根据实际情况添加/删除片上外设
26757688c527ec8201.png

修改board/目录下的SConstruct文件
72825688c6d4e17abe.png

在board.h文件中修改Flash和SRAM的大小，分别为128KB和32KB
70795688c5413c314b.png

修改\board\linker_scripts\link.sct文件中的Flash和SRAM大小
31913688c552c37204.png

使用scons --target=mdk5命令重新生成工程文件
11197688c5594e046f.png

9297688c6e3d1df44.png


board.c和board.h文件：
复制
  1. /*
    

  2.  * Copyright (c) 2006-2022, RT-Thread Development Team
    

  3.  *
    

  4.  * SPDX-License-Identifier: Apache-2.0
    

  5.  *
    

  6.  * Change Logs:
    

  7.  * Date           Author       Notes
    

  8.  * 2020-08-20     Abbcc        first version
    

  9.  */
    


  10. 

  11. #include "board.h"
    


  12. 

  13. void apm32_usart_init(void)
    

  14. {
    

  15.     GPIO_Config_T GPIO_ConfigStruct = {0U};
    


  16. 

  17. #ifdef BSP_USING_UART1
    

  18.     RCM_EnableAPB2PeriphClock(RCM_APB2_PERIPH_GPIOA);
    

  19.     RCM_EnableAPB2PeriphClock(RCM_APB2_PERIPH_USART1);
    


  20. 

  21.     GPIO_ConfigStruct.mode = GPIO_MODE_AF_PP;
    

  22.     GPIO_ConfigStruct.pin = GPIO_PIN_9;
    

  23.     GPIO_ConfigStruct.speed = GPIO_SPEED_50MHz;
    

  24.     GPIO_Config(GPIOA, &GPIO_ConfigStruct);
    


  25. 

  26.     GPIO_ConfigStruct.mode = GPIO_MODE_IN_FLOATING;
    

  27.     GPIO_ConfigStruct.pin = GPIO_PIN_10;
    

  28.     GPIO_ConfigStruct.speed = GPIO_SPEED_50MHz;
    

  29.     GPIO_Config(GPIOA, &GPIO_ConfigStruct);
    

  30. #endif
    


  31. 

  32. #ifdef BSP_USING_UART2
    

  33.     RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOA);
    

  34.     RCM_EnableAPB1PeriphClock(RCM_APB1_PERIPH_USART2);
    


  35. 

  36.     GPIO_ConfigStruct.mode = GPIO_MODE_AF;
    

  37.     GPIO_ConfigStruct.pin = GPIO_PIN_2;
    

  38.     GPIO_ConfigStruct.otype = GPIO_OTYPE_PP;
    

  39.     GPIO_ConfigStruct.speed = GPIO_SPEED_50MHz;
    

  40.     GPIO_Config(GPIOA, &GPIO_ConfigStruct);
    

  41.     GPIO_ConfigPinAF(GPIOA, GPIO_PIN_SOURCE_2, GPIO_AF_USART2);
    


  42. 

  43.     GPIO_ConfigStruct.mode = GPIO_MODE_AF;
    

  44.     GPIO_ConfigStruct.pin = GPIO_PIN_3;
    

  45.     GPIO_ConfigStruct.pupd = GPIO_PUPD_UP;
    

  46.     GPIO_ConfigStruct.speed = GPIO_SPEED_50MHz;
    

  47.     GPIO_Config(GPIOA, &GPIO_ConfigStruct);
    

  48.     GPIO_ConfigPinAF(GPIOA, GPIO_PIN_SOURCE_3, GPIO_AF_USART2);
    

  49. #endif
    

  50. }
    


  51. 

  52. void apm32_msp_can_init(void *Instance)
    

  53. {
    

  54. #if defined(BSP_USING_CAN1) || defined(BSP_USING_CAN2)
    

  55.     GPIO_Config_T  GPIO_InitStructure;
    

  56.     CAN_T *CANx = (CAN_T *)Instance;
    


  57. 

  58.     if (CAN1 == CANx)
    

  59.     {
    

  60.         RCM_EnableAPB1PeriphClock(RCM_APB1_PERIPH_CAN1);
    


  61. 

  62.         RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOB);
    


  63. 

  64.         /* PB8: CAN1_RX, PB9: CAN1_TX */
    

  65.         GPIO_InitStructure.pin = GPIO_PIN_8 | GPIO_PIN_9;
    

  66.         GPIO_InitStructure.mode = GPIO_MODE_AF;
    

  67.         GPIO_InitStructure.otype = GPIO_OTYPE_PP;
    

  68.         GPIO_InitStructure.speed = GPIO_SPEED_100MHz;
    

  69.         GPIO_InitStructure.pupd = GPIO_PUPD_UP;
    

  70.         GPIO_Config(GPIOB, &GPIO_InitStructure);
    


  71. 

  72.         GPIO_ConfigPinAF(GPIOB, GPIO_PIN_SOURCE_8, GPIO_AF_CAN1);
    

  73.         GPIO_ConfigPinAF(GPIOB, GPIO_PIN_SOURCE_9, GPIO_AF_CAN1);
    

  74.     }
    

  75.     else if (CAN2 == CANx)
    

  76.     {
    

  77.         /* When using the CAN2 peripheral, the CAN1 clock must be turned on */
    

  78.         RCM_EnableAPB1PeriphClock(RCM_APB1_PERIPH_CAN1);
    

  79.         RCM_EnableAPB1PeriphClock(RCM_APB1_PERIPH_CAN2);
    


  80. 

  81.         RCM_EnableAHB1PeriphClock(RCM_AHB1_PERIPH_GPIOB);
    


  82. 

  83.         /* PB12: CAN2_RX, PB13: CAN2_TX */
    

  84.         GPIO_InitStructure.pin = GPIO_PIN_12 | GPIO_PIN_13;
    

  85.         GPIO_InitStructure.mode = GPIO_MODE_AF;
    

  86.         GPIO_InitStructure.otype = GPIO_OTYPE_PP;
    

  87.         GPIO_InitStructure.speed = GPIO_SPEED_100MHz;
    

  88.         GPIO_InitStructure.pupd = GPIO_PUPD_UP;
    

  89.         GPIO_Config(GPIOB, &GPIO_InitStructure);
    


  90. 

  91.         GPIO_ConfigPinAF(GPIOB, GPIO_PIN_SOURCE_12, GPIO_AF_CAN2);
    

  92.         GPIO_ConfigPinAF(GPIOB, GPIO_PIN_SOURCE_13, GPIO_AF_CAN2);
    

  93.     }
    

  94. #endif
    

  95. }
复制
  1. /*
    

  2.  * Copyright (c) 2006-2022, RT-Thread Development Team
    

  3.  *
    

  4.  * SPDX-License-Identifier: Apache-2.0
    

  5.  *
    

  6.  * Change Logs:
    

  7.  * Date           Author         Notes
    

  8.  * 2022-03-28     Abbcc          first version
    

  9.  */
    


  10. 

  11. #ifndef __BOARD_H__
    

  12. #define __BOARD_H__
    


  13. 

  14. #include <rtthread.h>
    

  15. #include <apm32f402_403.h>
    


  16. 

  17. #include "apm32f402_403_gpio.h"
    

  18. #include "apm32f402_403_rcm.h"
    

  19. #include "apm32f402_403_misc.h"
    

  20. #include "apm32f402_403_rcm.h"
    

  21. #include "apm32f402_403_eint.h"
    

  22. #include "apm32f402_403_usart.h"
    


  23. 

  24. #if defined(RT_USING_ADC)
    

  25.     #include "apm32f402_403_adc.h"
    

  26. #endif
    

  27. #if defined(RT_USING_DAC)
    

  28.     #include "apm32f402_403_dac.h"
    

  29. #endif
    

  30. #if defined(RT_USING_RTC)
    

  31.     #include "apm32f402_403_rtc.h"
    

  32.     #include "apm32f402_403_pmu.h"
    

  33. #endif
    

  34. #if defined(RT_USING_SPI)
    

  35.     #include "apm32f402_403_spi.h"
    

  36. #endif
    

  37. #if defined(RT_USING_HWTIMER) || defined(RT_USING_PWM)
    

  38.     #include "apm32f402_403_tmr.h"
    

  39. #endif
    

  40. #if defined(RT_USING_WDT)
    

  41.     #include "apm32f402_403_iwdt.h"
    

  42.     #include "apm32f402_403_wwdt.h"
    

  43. #endif
    

  44. #if defined(RT_USING_CAN)
    

  45.     #include "apm32f402_403_can.h"
    

  46. #endif
    


  47. 

  48. #include "drv_common.h"
    

  49. #include "drv_gpio.h"
    


  50. 

  51. #ifdef __cplusplus
    

  52. extern "C" {
    

  53. #endif
    


  54. 

  55. #define APM32_FLASH_START_ADRESS     ((uint32_t)0x08000000)
    

  56. #define APM32_FLASH_SIZE             (128 * 1024)
    

  57. #define APM32_FLASH_END_ADDRESS      ((uint32_t)(APM32_FLASH_START_ADRESS + APM32_FLASH_SIZE))
    


  58. 

  59. /* Internal SRAM memory size[Kbytes] <6-128>, Default: 128 */
    

  60. #define APM32_SRAM_SIZE      32
    

  61. #define APM32_SRAM_END       (0x20000000 + APM32_SRAM_SIZE * 1024)
    


  62. 

  63. #if defined(__ARMCC_VERSION)
    

  64. extern int Image$RW_IRAM1$ZI$Limit;
    

  65. #define HEAP_BEGIN      ((void *)&Image$RW_IRAM1$ZI$Limit)
    

  66. #elif __ICCARM__
    

  67. #pragma section="CSTACK"
    

  68. #define HEAP_BEGIN      (__segment_end("CSTACK"))
    

  69. #else
    

  70. extern int __bss_end;
    

  71. #define HEAP_BEGIN      ((void *)&__bss_end)
    

  72. #endif
    


  73. 

  74. #define HEAP_END        APM32_SRAM_END
    


  75. 

  76. void SystemClock_Config(void);
    


  77. 

  78. void apm32_usart_init(void);
    


  79. 

  80. #ifdef __cplusplus
    

  81. }
    

  82. #endif
    


  83. 

  84. #endif /* __BOARD_H__ */
main.c文件：
复制
  1. /*
    

  2.  * Copyright (c) 2006-2022, RT-Thread Development Team
    

  3.  *
    

  4.  * SPDX-License-Identifier: Apache-2.0
    

  5.  *
    

  6.  * Change Logs:
    

  7.  * Date           Author       Notes
    

  8.  * 2020-08-20     Abbcc        first version
    

  9.  */
    


  10. 

  11. #include <rtthread.h>
    

  12. #include <rtdevice.h>
    

  13. #include <board.h>
    


  14. 

  15. /* defined the LED2 pin: PB6 */
    

  16. #define LED2_PIN    GET_PIN(B, 6)
    


  17. 

  18. int main(void)
    

  19. {
    

  20.     uint32_t sysclock = 0;
    

  21.     /* set LED2 pin mode to output */
    

  22.     rt_pin_mode(LED2_PIN, PIN_MODE_OUTPUT);
    

  23.     /* Print system clock */
    

  24.     sysclock = RCM_ReadSYSCLKFreq();
    

  25.     rt_kprintf("System Clock: %d\n", sysclock);
    


  26. 

  27.     while (1)
    

  28.     {
    

  29.         rt_pin_write(LED2_PIN, PIN_HIGH);
    

  30.         rt_thread_mdelay(500);
    

  31.         rt_pin_write(LED2_PIN, PIN_LOW);
    

  32.         rt_thread_mdelay(500);
    

  33.     }
    

  34. }
注意：drv_gpio和drv_usart中的时钟设置，以及GPIO的设置需要根据APM32F402进行相应的修改。

最后编译下载程序，可以看到打印输出和LED2交替闪烁。
65127688c704c172a6.png
回复

收藏 举报

相关帖子
绝影孤狼 发表于 2025-8-3 09:15 | 显示全部楼层
这个教程很详细，对于新手来说非常友好。按照步骤操作，应该能够顺利完成RT-Thread的移植。
回复

收藏 举报

迷雾隐者 发表于 2025-8-4 15:57 | 显示全部楼层
非常详细的教程，跟着步骤操作应该可以顺利完成RT-Thread的移植。
回复

收藏 举报

作业粉碎机 发表于 2025-8-6 16:33 | 显示全部楼层
这个教程很详细，对于想要在APM32F402R上运行RT-Thread的开发者来说非常有帮助。按照步骤操作，应该能够顺利完成移植。
回复

收藏 举报

梦境摆渡人 发表于 2025-8-7 20:46 | 显示全部楼层
这个教程非常详细，对于想要在APM32F402R Micro-EVB开发板上使用RT-Thread的朋友来说很有帮助。
回复

收藏 举报

复古留声机 发表于 2025-8-7 22:09 | 显示全部楼层
这个教程很详细，对于想要在APM32F402R上运行RT-Thread的开发者来说很有帮助。按照步骤操作，应该能够顺利移植。
回复

收藏 举报

HeartbeatEcho 发表于 2025-9-5 23:28 | 显示全部楼层
这个应该可以直接复用吧！
不需要再新建一个型号出来
回复

收藏 举报

 楼主| hbzjt2011 发表于 2025-9-6 11:07 | 显示全部楼层
HeartbeatEcho 发表于 2025-9-5 23:28
这个应该可以直接复用吧！
不需要再新建一个型号出来

还是有必要的，很多东西不太一样，可以自己尝试一下
回复

收藏 举报

风暴之眸 发表于 2025-9-6 13:12 | 显示全部楼层
移植完成RT-Thread就可以玩多任务了。
官方支持了，应用起来也放心多了
回复

收藏 举报

HeartbeatEcho 发表于 2025-9-13 20:01 | 显示全部楼层
别提了。上次自己动手实验的时候，使用它的那个工程生成脚本死活出来了。
唉，也不知道哪里出现的问题
回复

收藏 举报

返回列表 发新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 注册

本版积分规则

hbzjt2011
个人签名：欢迎参与LabVIEW版块的讨论学习！ 点我一键即达

344

主题

2941

帖子

45

粉丝
快速回复 在线客服 返回列表 返回顶部