操作系统嵌入式物联网嵌入式OSRTOS【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址https://gitcode.com/gh_mirrors/rt/rt-thread点击查看免费下载RTduino 是 RT-Thread 的 Arduino 生态兼容层它让开发者可以沿用 Arduino 的pinMode/digitalWrite/Serial/Wire/analogRead等编程习惯直接在 RT-Thread 上运行并复用 Arduino 社区海量第三方库。本文以仓库中 arduino_pinout/README.md 为主体结合 BSP 内 pins_arduino.c、pins_arduino.h、board/Kconfig 等源码完整讲解如何在 RoboMaster C 板上开启 RTduino、Arduino 引脚与 STM32 引脚 / RT-Thread 设备框架的一一映射关系以及基于setup()/loop()的入门编程实战。1 RTduinoRT-Thread 的 Arduino 生态兼容层大疆 STM32F407 Robomaster C 型开发板主控 STM32F407IGH6TR最高主频 168MHz详见 BSP README已完整适配 RTduino 软件包。适配的核心价值体现在两个层面编程习惯无缝衔接开发者可以完全按照 Arduino 的方式编写控制逻辑pinMode、digitalWrite、Serial.begin、Wire、analogRead等无需直接接触 RT-Thread 的设备框架 API生态极大增强Arduino 社区大量现成的传感器库、显示库、通信库可以直接为 RT-Thread 所用弥补了 RT-Thread 原生软件包在某些领域覆盖不足的问题。RTduino 兼容层并不是为每个 BSP 重新实现一套硬件抽象而是通过一份引脚映射表把 Arduino 逻辑引脚号D0~D13、A0~A1桥接到具体的 STM32 GPIO 与 RT-Thread 设备UART、I2C、PWM、ADC。这份映射表就位于本 BSP 的applications/arduino_pinout/目录下是该兼容层能否“即插即用”的关键。2 如何开启针对本 BSP 的 Arduino 生态兼容层在 RT-Thread Env 工具中进入 BSP 目录后敲入menuconfig或者在 RT-Thread Studio IDE 中选择RT-Thread Settings按下述路径勾选Hardware Drivers Config --- Onboard Peripheral Drivers --- [*] Compatible with Arduino Ecosystem (RTduino)勾选后保存退出接着在终端依次执行后续重编译前同样需要先拉取软件包源码pkgs --update # 拉取 RTduino 软件包及依赖的 HAL/CMSIS 库 scons # 直接命令行编译 # 或重新生成 IDE 工程 # scons --targetmdk5 / mdk4 / iar这一配置项对应 board/Kconfig 中的BSP_USING_ARDUINO。从 Kconfig 的select/imply语句可以看到开启 RTduino 并非孤立动作而是会连带自动启用一整套板级驱动依赖Kconfig 依赖项说明select PKG_USING_RTDUINO拉取 RTduino 软件包本身select BSP_USING_GPIOGPIO 驱动RT_USING_PINArduino 数字 IO 的基础select BSP_USING_ADC/BSP_USING_ADC1片上 ADC1供 A0 / A1 内部通道使用select BSP_USING_PWM/PWM1(CH1~CH4)/PWM8(CH1~CH3)定时器 PWM 输出供 D7~D13 使用select RT_USING_I2C/BSP_USING_SOFT_I2C/BSP_USING_SOFT_I2C1软件 I2C 总线swi2c1供 WireD5/D6使用select RTDUINO_USING_WIRE开启 RTduino 的 Wire 接口imply RTDUINO_USING_SERVO建议性开启 Servo 库imply不强制也就是说勾选一个选项后配套的 GPIO、ADC、PWM、软件 I2C 都会被正确配置这正是该 BSP 能做到“开箱即用 Arduino 体验”的原因。同时 Kconfig 中RT_SOFT_I2C1_SCL_PIN_DEFAULT 81、RT_SOFT_I2C1_SDA_PIN_DEFAULT 80两个默认值把软件 I2C 的 SCL/SDA 分别固定到了 PF1 / PF0 引脚对应 pins_arduino.h 中RTDUINO_DEFAULT_IIC_BUS_NAME swi2c1所描述的PF0-SDA PF1-SCL与下文引脚表完全一致。3 Arduino 引脚排布总览本 BSP 的 Arduino 引脚映射如下表来自 arduino_pinout/README.md引脚布局的完整定义见 pins_arduino.c 和 pins_arduino.hArduino 引脚编号STM32 引脚编号5V 容忍备注0 (D0)PH11是板载用户 LEDLED_BUILTIN1 (D1)PB7是Serial-RX默认被 RT-Thread UART 设备框架uart1接管2 (D2)PA9是Serial-TX默认被 RT-Thread UART 设备框架uart1接管3 (D3)PG9是Serial-RX默认被 RT-Thread UART 设备框架uart6接管4 (D4)PG14是Serial-TX默认被 RT-Thread UART 设备框架uart6接管5 (D5)PF1否I2C1-SCL默认被 RT-Thread I2C 设备框架swi2c1接管6 (D6)PF0否I2C1-SDA默认被 RT-Thread I2C 设备框架swi2c1接管7 (D7)PE9是PWM1-CH1默认被 RT-Thread PWM 设备框架pwm1接管8 (D8)PE11是PWM1-CH2默认被 RT-Thread PWM 设备框架pwm1接管9 (D9)PE13是PWM1-CH3默认被 RT-Thread PWM 设备框架pwm1接管10 (D10)PE14是PWM1-CH4默认被 RT-Thread PWM 设备框架pwm1接管11 (D11)PC6是PWM8-CH1默认被 RT-Thread PWM 设备框架pwm8接管12 (D12)PI6是PWM8-CH2默认被 RT-Thread PWM 设备框架pwm8接管13 (D13)PI7是PWM8-CH3默认被 RT-Thread PWM 设备框架pwm8接管14 (A0)--芯片内部温度 ADC默认被 RT-Thread ADC 设备框架adc1接管15 (A1)--芯片内部参考电压 ADC默认被 RT-Thread ADC 设备框架adc1接管引脚表呈现出一个清晰的规律D0~D13是普通数字引脚部分兼具串口 / I2C / PWM 复用功能其中 D1~D4 被串口设备框架接管D5~D6 被 I2C 设备框架接管D7~D13 被 PWM 设备框架接管A0 / A1没有对应的外部 STM32 引脚表中为--因为它们是STM32F4 芯片内部的 ADC 采样通道内部温度传感器与内部参考电压通过adc1设备读取5V 容忍列提醒硬件设计者哪些引脚可以直接连接 5V 电平的外设逻辑D5 / D6PF1 / PF0不支持 5V 容忍外接 5V 器件时需要注意电平匹配或加转换电路。注A0 / A1 的内部通道归属以 arduino_pinout/README.md 的表格与 pins_arduino.c 的源码注释为准A0 对应内部温度传感器、A1 对应内部参考电压。但从实现细节看源码中 A0 传入的是RT_ADC_INTERN_CH_VREF、A1 传入的是RT_ADC_INTERN_CH_TEMPER与注释存在交叉从代码结构推断这可能是历史版本的通道宏与注释未同步所致。实际开发中如需精确区分温度与参考电压通道应以 RT-Thread ADC 框架rtconfig.h中RT_ADC_INTERN_CH_VREF/RT_ADC_INTERN_CH_TEMPER宏定义及目标芯片参考手册为准。4 源码级解析引脚映射表与设备绑定原理4.1 映射表数据结构RTduino 对每个 BSP 的适配核心是 pins_arduino.c 中的pin_map_table[]数组。其条目格式遵循 RTduino 约定/* {Arduino Pin, RT-Thread Pin [, Device Name, Channel]} */ const pin_map_t pin_map_table[] { { D0, GET_PIN(H, 11) }, /* LED_BUILTIN */ { D1, GET_PIN(B, 7), uart1 }, /* Serial-RX */ { D7, GET_PIN(E, 9), pwm1, 1 }, /* PWM */ { A0, RT_NULL, adc1, RT_ADC_INTERN_CH_VREF }, /* ADC, On-Chip */ ... };格式要点源码头注释中亦有明确说明数字引脚Digital pins不能携带设备名与通道号如 D0 只给出GET_PIN(H, 11)模拟 / 复用引脚必须给出设备名与通道号如 PWM 引脚必须写明pwm1与通道号1~4ADC 引脚必须写明adc1与内部通道宏Arduino 引脚编号必须按顺序排列且与 pins_arduino.h 中的宏定义一一对应D0~D13依次为 0~13A014、A115ADC 内部通道用RT_NULL作为引脚号表示没有对应物理 GPIO。GET_PIN(H, 11)是 RT-Thread 的引脚编号宏把 GPIO 端口 H 的第 11 脚换算为统一的引脚编号供 RT-Thread pin 设备框架使用。整体上pin_map_table把「Arduino 逻辑引脚 → RT-Thread pin 设备编号 → RT-Thread 具体设备uart/pwm/adc/i2c」三层关系一次性描述完毕。4.2 头文件中的关键宏pins_arduino.h 除引脚别名外还定义了几个影响运行时行为的宏#define D0 (0) #define D1 (1) /* ... 依次到 */ #define A0 (14) #define A1 (15) #define RTDUINO_PIN_MAX_LIMIT A1 /* pin number max limit check */ #define F_CPU 168000000L /* CPU:168MHz */ #define LED_BUILTIN D0 /* Default Built-in LED */ /* swi2c1 : PF0-SDA PF1-SCL */ #define RTDUINO_DEFAULT_IIC_BUS_NAME swi2c1RTDUINO_PIN_MAX_LIMIT引脚号合法范围的上限检查宏等于A1即允许的最大引脚号为 15F_CPU声明 CPU 主频 168MHz供依赖delayMicroseconds精确延时的库使用与芯片最高主频一致见 BSP READMELED_BUILTINArduino 标准内置 LED 宏映射到 D0PH11板载用户 LEDRTDUINO_DEFAULT_IIC_BUS_NAME指定 RTduino Wire 接口默认挂接的 I2C 总线为软件 I2C 总线swi2c1PF0-SDA、PF1-SCL。4.3 数字引脚背后的“接管”机制引脚表中的 D1~D4、D5~D6、D7~D13 分别被uart1/uart6/swi2c1/pwm1/pwm8设备接管这意味着一件事这些引脚在 RTduino 中不做普通数字 IO 使用而是被直接绑定到对应外设。例如在 Arduino 中调用Serial1.begin(...)时底层实际操作的是 RT-Thread 的uart1设备PB7 / PA9对应 C 板上丝印为 UART2 的 4Pin 调试串口调用Wire库时走的是软件 I2C 总线swi2c1PF0 / PF1调用analogWrite/ Servo 库时走的是定时器 PWM 通道pwm1的 CH1~CH4 与pwm8的 CH1~CH3。这样的设计让 Arduino 风格的库无需关心底层驱动细节由 RTduino 在pin_map_table的指引下自动路由到 RT-Thread 设备框架。如果开发者想把这些引脚改作普通 GPIO 使用就需要在 RT-Thread 侧关闭相应外设接管或修改映射表——但通常不建议这样做保持默认映射即可获得最完整的 Arduino 兼容体验。5 入门编程实战基于 setup() / loop() 点亮板载 LED开启 RTduino 后BSP 会编译 arduino_main.cpp 作为 Arduino 风格入口。编译逻辑见 applications/SConscript只有当PKG_USING_RTDUINO被使能、且未定义RTDUINO_NO_SETUP_LOOP时arduino_main.cpp才会加入构建。该文件就是一个标准的 Arduino 骨架#include Arduino.h void setup(void) { /* put your setup code here, to run once: */ pinMode(LED_BUILTIN, OUTPUT); } void loop(void) { /* put your main code here, to run repeatedly: */ digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN)); delay(100); }setup()在系统启动后执行一次这里把 D0PH11板载 LED配置为输出loop()无限循环执行读取当前 LED 状态取反后写回实现100ms 周期闪烁。将程序编译下载到开发板后即可观察到板载 LED 以约 5Hz 的频率闪烁。这与 BSP 默认工程的闪烁效果见 BSP README 中“运行结果”一节风格一致区别在于这里完全使用 Arduino API 实现。在此基础上你可以在setup()/loop()中继续扩展void setup(void) { pinMode(LED_BUILTIN, OUTPUT); Serial1.begin(115200); /* uart1 (PB7-RX / PA9-TX)C 板丝印 UART2 接口 */ } void loop(void) { digitalWrite(LED_BUILTIN, HIGH); delay(500); digitalWrite(LED_BUILTIN, LOW); delay(500); if (Serial1.available() 0) { Serial1.write(Serial1.read()); /* 串口回显 */ } }提示需要先通过 menuconfig 确保对应外设UART、PWM、ADC、I2C已在「On-chip Peripheral Drivers」中开启BSP_USING_ARDUINO虽然会自动select大部分驱动但个别如BSP_USING_UART6仍需按需手动确认默认关闭见 board/Kconfig。修改配置后记得重新执行pkgs --update与scons --targetmdk5等命令重新生成工程。6 适配文件与构建结构速览与 RTduino 兼容相关的文件都集中在 BSP 内便于后续查阅或二次适配文件仓库根目录相对路径作用applications/arduino_pinout/README.md本指南对应的原始文档开启方法与完整引脚表applications/arduino_pinout/pins_arduino.hArduino 引脚别名、LED_BUILTIN、F_CPU、默认 I2C 总线名applications/arduino_pinout/pins_arduino.cpin_map_table[]引脚映射表实现applications/arduino_pinout/SConscript将pins_arduino编入RTduino-pinout组依赖PKG_USING_RTDUINOapplications/arduino_main.cppArduino 风格的setup()/loop()入口示例applications/SConscript按PKG_USING_RTDUINO决定是否编译arduino_main.cppboard/KconfigBSP_USING_ARDUINO配置项及其驱动依赖声明其中 SConscript 的依赖条件写得很明确group DefineGroup(RTduino-pinout, src, depend [PKG_USING_RTDUINO], CPPPATH inc)即只有在使能 RTduino 软件包后引脚映射源文件才会参与编译——这与第 2 节的开启步骤完全闭环。7 小结开启方式menuconfig / RT-Thread Settings 中勾选Hardware Drivers Config → Onboard Peripheral Drivers → Compatible with Arduino Ecosystem (RTduino)随后pkgs --update并重新编译引脚体系D0~D13 A0~A1 共 16 个 Arduino 引脚D0 为板载 LEDLED_BUILTIND1~D4 绑定串口D5~D6 绑定软件 I2CD7~D13 绑定 PWMA0 / A1 为芯片内部 ADC 通道适配源码pin_map_table[]在 pins_arduino.c 中定义了全部引脚映射与设备绑定头文件 pins_arduino.h 提供别名与运行时常量开发模式直接编写 arduino_main.cpp 式的setup()/loop()代码即可在 RT-Thread 上获得 Arduino 生态的开发体验。对 RoboMaster 竞赛队伍而言这意味着你可以一边享受 RT-Thread 的线程、IPC、设备框架等 RTOS 能力一边用 Arduino 社区成熟的传感器 / 执行器库快速搭建控制逻辑两者通过 RTduino 引脚映射表无缝衔接。赞分享操作系统嵌入式物联网嵌入式OSRTOS【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址https://gitcode.com/gh_mirrors/rt/rt-thread点击查看免费下载相关推荐Escrcpy 设备控制完全指南scrcpy 设备操作命令与 Android 设置项深入解析Escrcpy 设备控制完全指南scrcpy 设备操作命令与 Android 设置项深入解析 本指南以 docs/zhHans/reference/scrcp操作系统嵌入式物联网嵌入式OSRTOSSTM32F401 Nucleo 的 RT-Thread Arduino 生态兼容指南RTduino 引脚映射与通信实战STM32F401 Nucleo 的 RT Thread Arduino 生态兼容指南RTduino 引脚映射与通信实战 本文基于 RT Thread 仓库中操作系统嵌入式物联网嵌入式OSRTOSRT-Thread ra6m3-hmi-board 的 Arduino 生态兼容RTduino配置与引脚映射实战指南RT Thread ra6m3 hmi board 的 Arduino 生态兼容RTduino配置与引脚映射实战指南 本文以 ra6m3 hmi board操作系统嵌入式物联网嵌入式OSRTOS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考