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

【RSOC26】第一天学习笔记

发布于 2026-08-18 00:00:47 浏览：18 订阅该版

[tocm]

## 【RSOC26】第一天学习笔记

记录人：许伟威
日期：`2026.08.17`

---

## 一、环境搭建

### 1.1 软件安装

| 软件                 | 版本/说明             | 用途                       |
| -------------------- | --------------------- | -------------------------- |
| RT-Thread Studio     | 2.3.0+（最新 2.3.6）  | 一站式 IDE，集成工具链/Env |
| RT-Thread 标准版源码 | 4.0.3（默认）或 4.1.1 | 内核源码                   |
| STM32F4 芯片支持包   | 通过 SDK Manager 下载 | 芯片 BSP                   |
| Git                  | 最新版                | 版本控制                   |
| TortoiseGit          | 可选                  | 图形化 Git 辅助工具        |
| Typora               | + 破解补丁            | Markdown 编辑器            |
| STLink 驱动/升级工具 | STLinkUpgrade         | 板卡调试下载               |
| 串口调试助手         | 可选（正点原子等）    | 串口终端                   |

### 1.2 SDK Manager 配置

1. 打开 RT-Thread Studio → **SDK Manager**
2. 厂商过滤选择 **STM32**
3. 下载 **RT-Thread Source Code 4.0.3**（或 4.1.1）
4. 下载 **STM32F4 Chip Support Package**

![SDK Manager 配置](./figures/sdk_manager.png)

### 1.3 硬件连接

- 星火1号 Type-C 接 **DEBUG 口** → 按蓝色电源键
- 设备管理器确认出现 **STLink Debug**（通用串行总线设备）
- 若 STLink 版本过旧 → 用 `STLinkUpgrade` 升级固件
- 串口波特率：**115200**

![设备管理器中的 STLink](./figures/stlink_device.png)

---

## 二、工程创建与验证

### 2.1 QEMU 仿真工程（第一个任务）

1. `文件 → 新建 → RT-Thread 项目 → 基于开发板 → QEMU VExpress-A9`
2. 编译 → 调试/下载 → 终端输出 `hello rt-thread`

```c
/* 终端输出 */
hello rt-thread
```

### 2.2 星火1号实体板工程（第三个任务）

| 配置项     | 值            |
| ---------- | ------------- |
| 基于       | 芯片          |
| 厂商       | STM32         |
| 系列       | F4            |
| 芯片       | STM32F407VG   |
| 内核版本   | 4.0.3（统一） |
| 控制台串口 | 默认 UART     |
| 调试器     | STLink        |

在 `main.c` 第一行添加：

```c
rt_kprintf("Hello SOC 2026!\n");
```

验证步骤：编译 → 下载 → 串口终端（115200）→ 看到 RT-Thread Logo + `Hello SOC 2026!`。

- 输入 `Tab` 查看 FinSH 命令列表
- 输入 `ps` 查看线程

---

## 三、Markdown 语法

### 3.1 常用语法速查

![image-20260817234608310](../../../../../../../AppData/Roaming/Typora/typora-user-images/image-20260817234608310.png)

---

## 四、Git/Gitee 操作

### 4.1 账户与密钥配置

```bash
git config --global user.name "你的名字（英文）"
git config --global user.email "你的Gitee注册邮箱"

ssh-keygen -t rsa -C "你的邮箱"        # 一路回车
cat ~/.ssh/id_rsa.pub                   # 复制公钥
```

> 将公钥粘贴到 Gitee：右上角头像 → 设置 → SSH 公钥 → 粘贴 → 确定

```bash
ssh -T git@gitee.com                    # 看到 successfully 即成功
```

> ⚠️ **注意**：笔记截图时给公钥打码，**不要上传私钥**。

### 4.2 常用命令

| 命令                              | 作用           |
| --------------------------------- | -------------- |
| `git init`                        | 初始化仓库     |
| `git clone <url>`                 | 克隆远程仓库   |
| `git pull origin master`          | 拉取最新代码   |
| `git add <file>` / `git add .`    | 添加到暂存区   |
| `git commit -m "message"`         | 提交到本地仓库 |
| `git push origin <branch>`        | 推送到远程分支 |
| `git checkout -b <branch>`        | 新建并切换分支 |
| `git switch <branch>`             | 切换分支       |
| `git remote set-url origin <url>` | 修改远程地址   |
| `git remote -v`                   | 查看远程信息   |

---

![da39e2388c9b5e77f4e951e7f88fd5ad](E:/微信聊天存储/xwechat_files/wxid_ds3zka5of66g22_fa36/temp/RWTemp/2026-08/9e20f478899dc29eb19741386f9343c8/da39e2388c9b5e77f4e951e7f88fd5ad.png)

**git配置**

![ad9521e82a38e867704822a9c2d47c77](E:/微信聊天存储/xwechat_files/wxid_ds3zka5of66g22_fa36/temp/RWTemp/2026-08/9e20f478899dc29eb19741386f9343c8/ad9521e82a38e867704822a9c2d47c77.png)

上面是gitee测试连接

## 五、PR 提交流程

### 5.1 完整流程

1. 在 Gitee 网页 **Fork** 上游夏令营仓库
2. `git clone` 自己的 Fork 到本地
3. `git checkout -b day1`（新建分支，**不要用 master 直接提交**）
4. 在对应组别目录下新建个人目录，放入笔记和作业
5. `git add .` → `git commit -m "docs: init day1 template"` → `git push origin day1`
6. Gitee 网页 → 新建 Pull Request → 源分支 `day1` → 目标分支 `master`（上游仓库）
7. 审查人员选择：组员选小组长，小组长选导师
8. 审查通过后合并（建议勾选"合并后删除提交分支"）
9. 合并后切回 master → `git pull` 同步最新

### 5.2 冲突解决

冲突原因：Fork 时主仓库已更新，分支基于旧版本。

```bash
# Fork 页面点「同步」
git switch master
git pull
git switch day1
git merge master      # 手动解决冲突
git push origin day1  # 重新 push
```

---

## 八、常见问题与避坑

| 坑点                      | 解决方案                                              |
| :------------------------ | ----------------------------------------------------- |
| Studio 找不到 SDK Manager | 重新安装或下载 4.1.1 版本源码                         |
| STLink 无法识别           | 升级固件（STLinkUpgrade）或重装驱动                   |
| 串口终端无输出            | 确认端口号 + 波特率 115200 + 板子已通                 |
| PR 冲突                   | 先同步上游 → pull 最新 → merge → 解决冲突 → 重新 push |
| 分支名重复                | 每次用不同名（day1、day1-v2、day2...）                |
| 直接提交到 master         | 必须新建分支再提 PR，master 受保护                    |