RT-Thread 第1课时：RT-Thread 概述与开发环境搭建（超详细实操版）

哈喽大家好 今天开启 RT-Thread 系统学习的第一站也是最基础、最关键的一步——了解 RT-Thread 是什么以及如何搭建一套能直接上手实操的开发环境。本博客全程保姆级讲解从理论到实操每一步都附细节说明新手也能轻松跟上建议收藏备用先说明一下前置基础新手必看需要熟练掌握 C 语言指针、结构体、函数指针是核心后续内核学习会频繁用到了解基础的嵌入式硬件知识比如知道 MCU 是什么、GPIO 怎么用如果用过 STM32 开发会更顺畅没有也没关系跟着步骤走就能搞定。一、理论基础认识 RT-Thread搞懂它再动手在搭建环境前我们先搞清楚 RT-Thread 到底是什么为什么要学它以及它有哪些优势避免盲目上手。1.1 RT-Thread 简介RT-Thread 诞生于 2006 年是一款以开源、中立、社区化为核心理念发展起来的国产物联网操作系统IoT OS主要采用 C 语言编写代码风格浅显易懂具备极强的可移植性能够快速适配多种主流微控制器MCU及通信模组。它不是简单的实时内核而是一套“内核中间件软件生态”的完整物联网操作系统既能满足资源受限的低端 MCU 需求也能适配功能复杂的高端物联网设备。和我们可能听过的 FreeRTOS、uC/OS 相比RT-Thread 最大的优势就是“国产化、生态全、易上手”而且完全开源免费商用对于国内开发者来说文档、社区支持更便捷后期项目落地也更有优势。1.2 RT-Thread 多版本特性重点区分按需选择RT-Thread 提供多个版本适配不同的硬件场景我们入门阶段重点掌握前两个版本即可Nano 版专为资源极度受限的 MCU 设计最小配置仅需 3KB Flash 1.2KB RAM只有内核、shellmsh、设备驱动三大功能以 Keil5 的 pack 形式发布适合 8/16 位或低端 32 位 MCU也是我们入门实操的首选版本[3]。标准版面向功能丰富的物联网设备支持图形界面、网络协议栈、智能语音等高级功能可通过在线软件包管理工具实现“搭积木式”快速开发适合复杂项目开发。Smart 版面向高端嵌入式设备如 Cortex-A 系列支持虚拟内存、多进程适合需要运行复杂应用的场景入门阶段暂不涉及。1.3 RT-Thread 核心优势为什么选它结合入门场景重点说 4 个核心优势新手能直观感受到它的便捷低资源占用Nano 版极致精简普通 32 位 MCU如 STM32F103完全能轻松运行不用纠结硬件配置。高度可裁剪通过配置文件就能开启/关闭功能按需裁剪后固件大小可灵活调整适配不同资源的硬件。生态丰富官方及社区已贡献 450 软件包覆盖传感器驱动、云平台接入、AI 推理等后期开发项目可直接复用大幅缩短开发周期。易上手有专属的 RT-Thread Studio 开发工具集成了编译、下载、调试等功能图形化配置比用 Keil 手动配置更高效新手友好[4]。1.4 RT-Thread 架构分层快速了解内部结构RT-Thread 整体分为三层从下到上依次是内核层、组件层、软件包层不用深入钻研先有个整体认知即可内核层核心中的核心包含多线程调度、信号量、邮箱、内存管理、定时器等基础功能还有 libcpu 与 BSP板级支持包提供芯片和硬件平台的底层支持。组件层基于内核构建的上层模块比如 FinSH 命令行、虚拟文件系统、网络协议栈、设备驱动框架等都是我们后续会逐步学习的内容。软件包层面向不同应用领域的通用软件组件比如传感器驱动、MQTT 协议、GUI 界面等可通过工具一键下载使用不用重复造轮子。1.5 应用场景知道学了能用来做什么RT-Thread 的应用场景非常广泛主要集中在三大领域后期我们的实战项目也会贴合这些场景工业控制比如智能控制器、PLC、工业网关等消费电子比如智能手表、智能家居设备、可穿戴设备等物联网比如物联网节点、智能传感器、网关设备等。二、实操演练搭建 RT-Thread 开发环境核心环节一步都不能错实操是本课时的重点我们以“RT-Thread Studio推荐”为主Keil MDK Env 工具为辅全程以 STM32F103 开发板为例STM32L475 操作流程一致一步步完成环境搭建最终实现 LED 闪烁验证环境是否可用。准备工具电脑Windows 系统建议 Win10/11、STM32F103 开发板、USB 数据线用于下载程序、串口线可选后续调试用。2.1 安装 RT-Thread Studio推荐新手首选RT-Thread Studio 是官方推出的专属 IDE集成了 SDK、编译工具、调试工具不用手动配置安装步骤简单具体如下下载安装包进入 RT-Thread 官方网站https://www.rt-thread.org/找到“工具”→“RT-Thread Studio”下载对应 Windows 版本的安装包建议下载最新稳定版。开始安装双击下载好的安装包点击“接受”许可协议选择安装路径重点路径不能包含中文和空格比如 D:\RT-Thread Studio避免后续编译报错。后续配置指定开始菜单文件夹点击“安装”等待进度条完成安装结束后点击“完成”软件会自动启动。首次登录第一次启动需要登录 RT-Thread 账号没有的话注册一个免费登录一次后后续会自动记住支持第三方账号登录登录后即可正常使用。注意事项Windows 10/11 系统建议用管理员权限运行安装程序避免出现权限不足导致的安装失败或功能异常问题。2.2 安装 STM32 芯片支持包关键步骤缺一不可RT-Thread Studio 默认不自带 STM32 芯片支持包需要我们手动安装否则无法新建 STM32 相关项目步骤如下打开 RT-Thread Studio点击顶部菜单栏“工具”→“SDK 管理器”。在 SDK 管理器中找到“STM32”分类勾选“STM32F1 系列”如果用的是 STM32L475就勾选 STM32L4 系列点击“下载并安装”等待安装完成安装过程需要联网耐心等待。安装完成后重启 RT-Thread Studio芯片支持包即可生效。2.3 新建第一个 RT-Thread 项目Nano 版最简工程环境和芯片支持包都安装完成后我们新建一个 Nano 版最简工程这是入门的第一个项目步骤如下打开 RT-Thread Studio点击顶部“文件”→“新建”→“RT-Thread 项目”。项目配置项目名称自定义比如 rtthread_nano_led建议英文不要包含中文和空格项目类型选择“RT-Thread Nano 项目”芯片选择选择自己的开发板型号比如 STM32F103C8T6其他默认即可点击“完成”等待项目创建首次创建会下载相关依赖联网即可。项目创建完成后左侧“项目管理器”中会显示项目目录重点关注 3 个核心文件夹rt-threadRT-Thread Nano 内核源码包含内核核心功能board板级支持包包含开发板相关的配置比如 GPIO 定义src我们自己编写的应用代码后续的 LED 闪烁代码就写在这里。2.4 编写代码实现 LED 闪烁验证环境项目创建完成后我们编写简单的 LED 闪烁代码通过这个小程序验证开发环境是否搭建成功步骤如下打开 src 文件夹下的 main.c 文件删除默认的示例代码编写如下代码注释详细新手可直接复制注意修改 GPIO 引脚为自己开发板的 LED 引脚#include rtthread.h#include rtdevice.h#include board.h// 定义 LED 引脚以 STM32F103C8T6 为例LED 接 PA5#define LED_PIN GET_PIN(A, 5)int main(void){// 初始化 LED 引脚为输出模式rt_pin_mode(LED_PIN, PIN_MODE_OUTPUT);while (1){rt_pin_write(LED_PIN, PIN_LOW); // LED 点亮rt_thread_mdelay(500); // 延时 500msrt_pin_write(LED_PIN, PIN_HIGH); // LED 熄灭rt_thread_mdelay(500); // 延时 500ms}}代码说明GET_PIN(A,5)RT-Thread 提供的引脚定义宏简化 GPIO 配置A 代表端口 A5 代表引脚 5rt_pin_mode()配置引脚模式这里设置为输出模式rt_pin_write()控制引脚电平PIN_LOW 为低电平点亮 LEDPIN_HIGH 为高电平熄灭 LEDrt_thread_mdelay()RT-Thread 提供的延时函数单位是 ms和我们平时用的 delay 函数类似。2.5 编译、下载程序关键一步看结果代码编写完成后我们进行编译和下载步骤如下编译程序点击顶部菜单栏“构建”→“构建项目”或者直接点击工具栏的“锤子”图标开始编译。编译成功后底部“控制台”会显示“构建成功”如果报错大概率是引脚定义错误或芯片支持包未安装成功检查并修改即可。连接开发板用 USB 数据线将开发板连接到电脑确保电脑能识别到开发板如果识别不到安装对应的 USB 转串口驱动。下载程序点击顶部菜单栏“运行”→“下载”或者点击工具栏的“下载”图标选择下载方式默认是 Serial 串口下载波特率默认 115200无需修改点击“确定”开始下载。验证结果下载完成后开发板上的 LED 会开始闪烁每隔 500ms 亮灭一次说明开发环境搭建成功恭喜你完成了 RT-Thread 的第一步实操2.6 补充Keil MDK Env 工具安装可选进阶备用如果习惯用 Keil MDK 开发也可以搭建 Keil Env 工具的环境步骤简要说明详细步骤后续补充安装 Keil MDK下载 Keil MDK5 版本安装完成后安装 STM32F1 芯片支持包和 RT-Thread Studio 安装芯片支持包类似。安装 Env 工具从 RT-Thread 官方网站下载 Env 工具解压后即可使用无需安装它主要用于配置 RT-Thread 项目、下载软件包等。新建项目在 Keil 中新建 STM32 项目通过 Env 工具配置 RT-Thread Nano 内核添加内核源码后续编译、下载流程和普通 Keil 项目一致。新手建议先熟悉 RT-Thread Studio操作更简单后期再尝试 Keil Env 工具。三、课后任务巩固练习加深印象实操完成后完成以下 2 个课后任务巩固本课时的知识点为后续学习打下基础熟悉 RT-Thread Studio 界面重点熟悉“项目管理器”“代码编辑器”“编译配置”“控制台”这 4 个部分尝试修改项目配置比如修改项目名称、调整编译选项了解每个功能的作用。修改 LED 闪烁频率在刚才的代码中修改 rt_thread_mdelay() 的参数比如改为 1000ms、200ms重新编译、下载观察 LED 闪烁频率的变化理解延时函数的使用同时尝试修改 LED 引脚实现不同引脚的 LED 闪烁。四、常见问题排查新手必看避坑指南搭建环境过程中新手可能会遇到一些问题这里整理了 3 个最常见的问题及解决方案帮你快速避坑问题 1编译报错提示“未找到芯片支持包” 解决方案重新打开 SDK 管理器确认对应系列的芯片支持包已安装安装完成后重启 RT-Thread Studio。问题 2下载失败提示“未识别到开发板” 解决方案检查 USB 数据线是否连接正常安装对应的 USB 转串口驱动确认开发板电源已开启。问题 3下载成功后LED 不闪烁 解决方案检查 LED 引脚定义是否正确确认自己开发板的 LED 接的是哪个引脚检查代码中的引脚配置是否正确重新编译下载。五、总结本课时我们完成了 RT-Thread 的入门第一步了解了 RT-Thread 的基本概念、多版本特性、核心优势和架构重点搭建了 RT-Thread Studio 开发环境编写了第一个 LED 闪烁程序验证了环境的可用性。其实 RT-Thread 入门并不难重点是先搞定环境搭建后续的内核学习、驱动开发都是在这个基础上逐步深入的。下一节课我们会讲解 RT-Thread 的启动流程和工程结构进一步熟悉 RT-Thread 项目的组成。如果觉得本文对你有帮助欢迎点赞收藏关注后续会持续更新rt-thread 新手实战教程陪你从入门到精通日常深耕嵌入式、物联网、协议开发相关技术有技术答疑、项目合作、毕设指导需求均可私信私聊