RT-Thread — 中文社区主导的物联网 RTOS

是什么

RT-Thread 是一个跑在微控制器上的实时操作系统（RTOS）。日常类比：你家路由器、智能手表、扫地机器人里那块小芯片——它没装 Linux（装不下），但又不能像单片机那样只跑一个 while(1) 死循环。RT-Thread 就是塞进去的那个迷你操作系统：能同时跑多个任务、能按优先级抢占、能管文件能联网。

资源占用极小：

最小内核：1.2 KB RAM + 3 KB Flash
完整版本：几十 KB RAM + 几百 KB Flash
对比 Linux：几 MB RAM + 几十 MB Flash 起步

你的任务代码长这样：

void led_thread(void *param) {
    while (1) {
        rt_pin_write(LED_PIN, PIN_HIGH);
        rt_thread_mdelay(500);  // 让出 CPU 500ms
        rt_pin_write(LED_PIN, PIN_LOW);
        rt_thread_mdelay(500);
    }
}

rt_thread_mdelay 不是死等——它主动让出 CPU，让别的线程跑。这是 RTOS 区别于裸机循环的根本。

为什么重要

不理解 RT-Thread 的”中文社区 + 国产 MCU + 组件化”三件套，下面这些事都解释不通：

为什么国产 MCU 厂商（兆易、华大、国民技术、灵动）的板级支持包（BSP）RT-Thread 比 FreeRTOS 还全——本土团队主导的生态优势
为什么 2006 年起步、和 FreeRTOS（2003）/ Zephyr（2016）形成三足鼎立——450+ 软件包 + 近 200 块开发板的厚度
为什么从 1.2 KB 的 Nano 到带 lwIP / 文件系统的 Standard 是连续可调的——三层架构按需裁剪
为什么很多 IoT 教程默认 RT-Thread 而不是 FreeRTOS——中文文档、FinSH 命令行、AT 组件接 4G 模组都开箱即用

核心要点

RT-Thread 的设计可以拆成 三层架构：

内核层：调度器 + 内核对象（线程、信号量、互斥量、邮箱、消息队列、事件、内存池、定时器）。这部分用 C 写得像面向对象——每个对象都有 rt_object_t 父类。
组件层：在内核之上，有 VFS（虚拟文件系统）、网络协议栈（lwIP）、设备 I/O 框架、FinSH 命令行、libc 适配。这一层让 MCU 用起来像小型 Linux——你能 ls、能 cat、能 mount。
软件包层：450+ 个可选包，从 MQTT 客户端到 JerryScript（JavaScript 引擎）到 RTduino（Arduino 兼容层）。用 pkgs --update 像 npm 一样拉。

加起来叫 “可裁剪的 IoT 操作系统”——选 Nano 就只有内核，选 Standard 就一路装到完整 IoT 平台。

实践案例

案例 1：两个线程演示抢占式调度

void high_thread(void *p) { while(1) { rt_kprintf("H\n"); rt_thread_mdelay(100); } }
void low_thread(void *p)  { while(1) { rt_kprintf("L\n"); rt_thread_mdelay(100); } }

int main() {
    rt_thread_t h = rt_thread_create("high", high_thread, NULL, 1024, 5, 10);
    rt_thread_t l = rt_thread_create("low",  low_thread,  NULL, 1024, 10, 10);
    rt_thread_startup(h);
    rt_thread_startup(l);
}

数字 5 和 10 是优先级（数字越小优先级越高）。high 在 mdelay 期间，low 才有机会跑——这就是抢占式调度。

案例 2：FinSH 现场调试

烧录后接串口，敲：

msh > list_thread
thread   pri  status      sp     stack   max used  left tick
high      5  suspend  0x00000080  1024   12%       9
low      10  ready    0x00000050  1024   8%        9
tshell   20  running  0x000000a0  4096   25%       4

不用 GDB、不用 printf 反复编译——FinSH 直接列出所有线程、栈用量、状态。这是 RTOS 自带 shell 相比裸机调试的核心优势。

案例 3：AT 组件 + 4G 模组上云

at_client_init("uart3", 1024);     // 通过 UART3 跟 EC20 模组对话
at_obj_exec_cmd(client, resp, "AT+CGATT?");  // 查 GPRS 是否附着

AT 组件帮你解析 URC（模组主动上报）、超时重发、状态机管理。配合 lwIP 跑 MQTT，从 MCU 到云就这一条链路。把 IoT 协议栈在 KB 级 RAM 上跑通的关键拼图。

踩过的坑

Nano 和 Standard 混为一谈：Nano 只有内核，没 FinSH / 没文件系统 / 没网络。初学者跟着 Standard 教程操作 Nano，会发现 list_thread 命令不存在——选错版本。
不看 BSP README 直接抄示例：每块开发板的时钟树、Flash 大小、外设引脚都不同。把 STM32F4 的代码直接搬到 STM32L0，SystemClock_Config 不匹配会启动失败甚至砖板。
中断里调阻塞 API：rt_mutex_take / rt_thread_mdelay 在 ISR 调用直接断言挂掉。中断上下文只能用非阻塞接口——信号量 release、邮箱 send 这种”通知后立即返回”的。
线程栈给小了：默认示例栈 512~1024 B，调用 printf 或文件操作时容易溢出。开 RT_USING_OVERFLOW_CHECK 会在切换时检查栈底魔数；保险起见调到 2KB+。

适用 vs 不适用场景

适用：

KB 级到几 MB RAM 的 MCU（ARM Cortex-M、RISC-V、国产 MCU）
需要硬实时响应（响应延迟微秒级）+ 多任务并发
IoT 设备、智能家居、可穿戴、工控、消费电子
中文团队首次接触 RTOS——文档、社区、教程都在中文世界

不适用：

需要完整 POSIX / 进程隔离 / 用户空间 → 用 Linux
单一裸机循环就够（如最简单的 LED 控制器）→ RTOS 反而引入额外开销
跨大陆社区协作的开源项目 → FreeRTOS / Zephyr 的英文生态更厚
安全认证刚性场景（车规 ASIL-D 等）→ 用经过严格认证的商业 RTOS

历史小故事（可跳过）

2006 年：熊谱翔在中国发起 RT-Thread，定位极简内核（后来叫 Nano）
2014 年：扩展为带组件 + 软件包生态的 Standard 版
2016 年：Zephyr 由 Linux 基金会发起，与 FreeRTOS / RT-Thread 形成三足鼎立
2018 年：上海睿赛德电子科技成立，商业化运营 + 维护开源版
2020 年代：成为少数源自中国、在国际嵌入式社区获得广泛认可的开源 RTOS

学到什么

操作系统不一定要”大”——1.2 KB 的内核已经足够跑抢占式多任务
组件化让”小内核”也能演化成完整平台——三层架构是把”小”和”全”调和起来的关键
本土生态优势：板级支持包（BSP）的覆盖度本质是社区跟厂商的距离
RTOS vs 裸机：抢占式调度 + 同步原语，让”多任务”从纸上谈兵变成几十行就能写出来

关联

risc-i-1981 —— RISC-V 是其精神继承者，RT-Thread 在 RISC-V MCU 上的支持是国产路线核心
mips-1981 —— RT-Thread 早期就支持 MIPS32 架构（龙芯等国产 CPU）
big-little-2011 —— ARM 的大小核架构，RT-Thread Smart 版本探索 AMP 多核场景
sqlite —— 同样体现”嵌入式 = 一个库链进去”的极简哲学

反向链接

big-little-2011 —— big.LITTLE — 让一颗芯片同时装快核和省电核
buildroot —— Buildroot — 用 Make 给嵌入式板子烤一张完整 Linux 镜像
mips-1981 —— MIPS 1981 — 让编译器自己安排流水线，CPU 就不用管
openthread —— OpenThread — Google 开源的 Thread mesh 网络协议栈
risc-i-1981 —— RISC I — 砍掉 90% 指令反而让 CPU 跑得更快
sqlite —— SQLite — 嵌入式 SQL 数据库