RT-Thread-【RSOC26】冷梦奇第一天学习笔记RT-Thread问答社区

【RSOC26】冷梦奇第一天学习笔记

发布于 2026-08-17 20:14:05 浏览：24 订阅该版

[tocm]

# 【RSOC26】RT-Thread 大学生夏令营 Day1 学习总结：环境搭建与 STM32F407 Hello World 实战

> 作者：冷梦奇（第 1 组）| 日期：2026-08-17 | 内核版本：RT-Thread 4.1.1
>
> 本文是 2026 RT-Thread 大学生夏令营 Day1 的学习总结，主要覆盖 RT-Thread 生态认知、RT-Thread Studio + STM32F407 环境搭建、Markdown 笔记规范、Git/Fork/PR 开源协作流程，并附完整可复现的 Hello World 实战记录。

---

## 一、夏令营整体安排

本次夏令营采用**双周学习模式**：

- **第一周（学习周）**：上午 9:00–12:00 授课，下午 14:00 起实操/作业
- **第二周（项目周）**：学员分组完成项目任务
- 每日开课前线上签到；硬件为星火 1 号开发板
- 产出要求：每日作业提交至 Git 仓库（PR 方式），第二周根据项目任务筛选/分组

---

## 二、RT-Thread 生态与三条核心产品线

RT-Thread 是国产自研 RTOS，发展近 20 年，GitHub **12.2k stars**，国内活跃开源社区。内核已迭代至 **V5.3.0**。

| 版本 | 定位 | 关键特性 | 协议/适用 |
|---|---|---|---|
| **Nano 版** | 极简内核 | 实时内核 + 线程同步通信机制 + 最小实体（线程/时钟/中断/内存管理） | Apache 协议开源 |
| **标准版** | 中等规模 | 基于 POSIX API，丰富组件（日志、网络协议栈、IoT 协议）+ 中间件，高度可定制 | 生态完整、组件丰富 |
| **Smart 版** | 复杂应用 | 面向带 MMU 设备，混合微内核架构，内核态/用户态分离 | 带 MMU 设备、注重安全 |

---

## 三、开发环境搭建（RT-Thread Studio + STM32F407）

### 3.1 准备步骤

1. 安装 **RT-Thread Studio**，替换 `app.asar` 完成破解
2. 打开 **SDK Manager** 统一下载 **RT-Thread 4.1.0** 源码 + **STM32F4** 芯片支持包
3. 设备管理器中确认 **ST-Link** 驱动识别正常
4. 基于 **STM32F407** 创建标准版内核工程，串口波特率配置为 **115200**
5. 编译生成 `.elf` / `.bin`，ST-Link 下载至开发板
6. 启动终端查看启动日志，演示断点调试

### 3.2 STM32F407 Hello World 实战（已完成）

#### 工程信息

| 项 | 值 |
|---|---|
| 工程名 | `01_hello_rtt` |
| 内核版本 | RT-Thread 4.1.1（`build Aug 17 2026 11:23:12`） |
| 板级芯片 | STM32F407 |
| IDE | RT-Thread Studio |

#### 串口配置

| 参数 | 值 |
|---|---|
| 串行端口 | COM5 |
| 波特率 | 115200 |
| 数据位 | 8 |
| 校验位 | None |
| 停止位 | 1 |
| 编码 | UTF-8 |

#### 关键代码（`applications/main.c`）

```c
/*
 * Copyright (c) 2006-2026, RT-Thread Development Team
 * SPDX-License-Identifier: Apache-2.0
 * Change Logs:
 * Date           Author       Notes
 * 2026-08-17     RT-Thread    first version
 */

#include <rtthread.h>

#define DBG_TAG "main"
#define DBG_LVL DBG_LOG

#include <rtdbg.h>

int main(void)
{
    int count = 1;

rt_kprintf("hello RSOC2026!\n");

while (count++)
    {
        LOG_D("Hello RT-Thread!");
        rt_thread_mdelay(1000);
    }

return RT_EOK;
}
```

#### 终端启动输出

```
 \ | /
- RT -     Thread Operating System
 / | \     4.1.1 build Aug 17 2026 11:23:12
  2006 - 2022 Copyright by RT-Thread team
hello RSOC2026!
[D/main] Hello RT-Thread!
msh />
```

#### msh 内存查询（`msh />free`）

```
msh />free
total    : 125816
used     : 7076
maximum  : 7076
available: 118740
```

主循环以 `rt_thread_mdelay(1000)` 每秒持续打印 `[D/main] Hello RT-Thread!`；`msh` 交互正常，`help` 命令可列出 `list_thread` / `list_sem` / `list_event` / `list_mutex` / `list_mailbox` / `list_msgqueue` / `list_mempool` / `list_timer` 等 RT-Thread shell 工具。

---

## 四、Markdown 笔记规范

- 基础语法：标题 `#`、代码块 ` ``` `、表格、加粗 `**`、图片 `![]()`
- **图片管理**：建议保存到 `./figures` 目录，避免项目迁移时资源丢失
- 笔记统一 Markdown 格式，提交至指定 Git 仓库

---

## 五、Git 与开源协作流程

### 5.1 环境配置

- 安装 Git（可汉化；汉化失败默认英文即可）
- 全局身份设置：

```bash
git config --global user.name "YourName"
git config --global user.email "your@email.com"
```

- 生成 **SSH 密钥对**，将公钥添加到 Gitee/GitHub 平台账户 → 实现免密认证

### 5.2 核心指令

```bash
git init              # 初始化仓库
git clone <url>       # 克隆远端仓库
git pull              # 拉取最新代码
git add <file>        # 加入暂存区
git commit -m "..."   # 提交到本地仓库
git push              # 推送到远端仓库
git checkout -b day1  # 创建并切换分支（日常开发禁直接操作 master）
```

### 5.3 Fork 协作模式

1. **Fork** 上游仓库到个人账户，形成独立开发副本
2. 在个人 Fork 中创建功能分支（如 `day1` / `day2`），**严禁直接修改 master**
3. 推送后通过平台创建 **PR**，指定 Reviewer（小组长 / 导师）
4. 同步上游：

```bash
git remote add upstream <upstream_url>
git fetch upstream
git pull upstream main
```

5. 冲突解决：合并上游代码或手动解决

### 5.4 角色职责

- **学员**：提交 PR
- **小组长**：审核并合并组员 PR
- **导师**：审核小组长 PR，处理跨组复杂问题

---

## 六、Day1 总结与 Day2 展望

### 6.1 已完成项

- [x] RT-Thread Studio 安装与破解
- [x] RT-Thread 4.1.0 源码 + STM32F4 支持包下载
- [x] STM32F407 Hello World 工程创建、编译、下载、调试
- [x] Git 环境配置 + SSH 免密连通
- [x] 模板 PR 与 Day1 作业/笔记 PR 准备

### 6.2 Day2 预期

- 内核基础：线程、调度、信号量、互斥锁、消息队列
- 组件初识：Pin 设备、I2C、SPI、UART 设备驱动框架
- 进阶实操：基于 RT-Thread 标准版的多任务编程

---

## 七、参考资源

- RT-Thread 官网：https://www.rt-thread.org/
- RT-Thread 文档中心：https://www.rt-thread.org/document/site/
- RT-Thread 社区论坛：https://club.rt-thread.org/
- GitHub 仓库：https://github.com/RT-Thread/rt-thread

---

> 本文是 2026 RT-Thread 大学生夏令营 Day1 的学习总结，欢迎各位同学/工程师交流指正。
> 系列文章会持续更新，Day2 见。