📌 适用人群：有嵌入式基础（C语言、单片机、OS原理），但没有拿得出手的项目经验

📌 核心思路：找优秀开源项目 → 读代码学规范 → 跑通复现 → 魔改出自己的版本 → 写进简历

📌 为什么要跟开源项目学？因为学生自己写的代码大多"能跑就行"，命名混乱、架构稀碎、没有分层。而优秀开源项目本身就是最好的代码教材。

---

一、为什么一定要跟着开源项目做？

自己从零写	跟着开源项目做
命名随意 a, b, flag1	学到规范命名 uart_rx_buffer
所有代码塞一个 main.c	学到分层架构（HAL → Driver → App）
没有状态机概念	学到事件驱动、状态机设计模式
出 Bug 只会 printf 大法	学到 assert、日志系统、错误码设计
面试说不出"为什么这样设计"	能讲出设计思路和 trade-off

读好代码 → 模仿好代码 → 最终写出好代码。这比自己闷头造轮子高效 10 倍。

---

二、学习路线 + 对应 GitHub 项目

阶段一：RTOS 内核精读（2 周）

目标：理解任务调度、IPC 机制、内存管理，面试最爱问的东西全在这里。

推荐项目：RT-Thread Nano / FreeRTOS

项目	GitHub 地址	推荐理由
RT-Thread Nano	rt-thread/rt-thread （nano 分支）	国产、代码注释全中文、极简内核只有几千行、适合精读
FreeRTOS	FreeRTOS/FreeRTOS-Kernel	工业界用得最多，面试出镜率最高

怎么学：

第 1 步：只看内核，不看 BSP
        重点文件：task.c / queue.c / list.c（FreeRTOS）
                 scheduler.c / ipc/ 目录（RT-Thread）

第 2 步：手动移植到自己的 STM32 板子上
        这个过程会逼你搞懂 PendSV、SysTick、堆栈初始化

第 3 步：写 3 个 demo 验证理解：
        • 多任务 + 优先级抢占
        • 消息队列生产者-消费者
        • 互斥锁解决共享资源竞争

面试怎么说：

“我精读了 FreeRTOS 内核源码，手动移植到 STM32F407 上。过程中发现 PendSV 触发时机与我理解的不同——它不是立即切换，而是在所有中断退出后才触发上下文切换，这样避免了中断中切任务的风险。”

---

阶段二：做一个完整的中间件项目（2~3 周）

目标：体现你不只是"调 API"，而是理解协议栈/组件的内部实现。

方向 A：工业通信 — Modbus 协议栈

项目	GitHub 地址	说明
FreeModbus（armink 增强版）	armink/FreeModbus_Slave-Master-RTT-STM32	支持主从机、适配 RT-Thread + STM32，工业岗面试常问

怎么做成自己的项目：

基础复现：
  - 移植到自己的板子，实现 Modbus RTU 从机
  - PC 用 Modbus Poll 工具读写寄存器，验证通信

你的改造（亮点）：
  - 加入多从机轮询调度（主机模式）
  - 增加 CRC 错误统计 + 自动重传机制
  - 加入超时检测与异常恢复
  - 用逻辑分析仪抓波形，分析 3.5T 帧间隔

方向 B：网络通信 — MQTT 客户端

项目	GitHub 地址	说明
kawaii-mqtt	jiejieTop/kawaii-mqtt	轻量级、纯 C 实现、代码结构清晰、适配多平台
mqttclient	jiejieTop/mqttclient	同作者，更完善的版本，支持 QoS、遗嘱、重连

怎么做成自己的项目：

基础复现：
  - 移植到 STM32 + ESP8266/W5500，连接阿里云 IoT / EMQX

你的改造（亮点）：
  - 实现掉线自动重连 + 消息缓存（离线消息不丢失）
  - 对比 QoS 0/1/2 的实际丢包率（用数据说话）
  - 加入 TLS 加密（mbedTLS 移植）
  - 设计心跳包优化策略：动态调整 keepalive 时间

方向 C：文件系统 — FAT / LittleFS

项目	GitHub 地址	说明
littlefs	littlefs-project/littlefs	ARM 官方出品，掉电安全、磨损均衡，代码精简

怎么做成自己的项目：

基础复现：
  - 移植到 STM32 + SPI Flash（W25Q128）

你的改造（亮点）：
  - 对比 FatFS vs LittleFS：写入速度、掉电恢复、Flash 寿命
  - 模拟掉电测试（随机断电 1000 次，验证数据完整性）
  - 实现简单的日志系统：循环写入 + 按时间戳检索

---

阶段三：做一个系统级项目（3~4 周）

目标：体现架构设计能力，能画出系统框图，讲清楚模块间如何协作。

方向 A：嵌入式物联网网关（RTOS 方向）

参考项目	GitHub 地址	说明
RT-Thread IoT 生态	RT-Thread/IoT_Board	潘多拉开发板配套，完整 IoT demo
soft-and-hard	alwxkxk/soft-and-hard	从硬件到服务器到前端，全栈物联网教程

项目架构设计：

┌─────────────────────────────────────────┐
│              Application Layer           │
│   (数据解析、业务逻辑、报警策略)          │
├─────────────────────────────────────────┤
│            Middleware Layer              │
│   MQTT Client │ Modbus Master │ CJSON   │
├─────────────────────────────────────────┤
│              OS Layer (RT-Thread)        │
│   Task │ MsgQueue │ Semaphore │ Timer   │
├─────────────────────────────────────────┤
│              Driver Layer (HAL)          │
│   UART │ SPI │ GPIO │ Flash │ Watchdog  │
├─────────────────────────────────────────┤
│              Hardware                    │
│   STM32F407 │ ESP8266 │ RS485 │ Sensor  │
└─────────────────────────────────────────┘

你的亮点：

1. 分层架构设计，驱动层与应用层解耦（更换硬件只需改 Driver）
2. OTA 远程升级：A/B 分区 + 版本校验 + 失败回滚
3. 看门狗 + 异常恢复：任务死机自动重启
4. 低功耗管理：空闲时进入 Stop 模式，有数据时唤醒

方向 B：Linux 应用层项目（Linux 岗方向）

参考项目	GitHub 地址	说明
mjpg-streamer	jacksonliam/mjpg-streamer	嵌入式 Linux 视频推流，代码成熟、插件架构
tinyhttpd	EZLippi/Tinyhttpd	500 行实现 HTTP 服务器，精读经典

基于 mjpg-streamer 改造的项目：

项目名：基于 Linux 的智能视频监控系统

功能：
  - V4L2 摄像头采集 + MJPEG 推流
  - 帧差法运动检测 → 触发抓图 → 保存到 LittleFS
  - 多线程架构：采集线程 + 检测线程 + 推流线程
  - 线程间用环形缓冲区 + 读写锁同步

代码学习重点：
  - mjpg-streamer 的插件架构（input_xxx.so / output_xxx.so）
  - V4L2 的 MMAP 零拷贝采集方式
  - 多线程同步与生产者-消费者模型

---

三、代码规范速成（读开源项目时注意这些）

从上面这些项目中，你会反复看到这些规范，把它们内化：

命名规范

// ❌ 学生常见写法
int a, b, flag;
void func1(void);

// ✅ 开源项目写法
static uint16_t s_uart_rx_count;          // s_ 前缀表示 static
void mqtt_client_connect(mqtt_client_t *client);  // 模块名_动作
#define MQTT_MAX_RETRY_COUNT  (3U)        // 全大写 + 模块前缀

错误处理

// ❌ 学生写法：不处理错误
HAL_UART_Transmit(&huart1, data, len, 100);

// ✅ 开源项目写法
hal_status_t ret = HAL_UART_Transmit(&huart1, data, len, 100);
if (ret != HAL_OK) {
    LOG_E("uart tx failed, ret=%d", ret);
    return -ERR_UART_TX;
}

状态机设计

// ✅ RT-Thread / MQTT 客户端中常见的状态机模式
typedef enum {
    STATE_IDLE,
    STATE_CONNECTING,
    STATE_CONNECTED,
    STATE_DISCONNECTED,
    STATE_RECONNECTING,
} client_state_t;

// 每个状态有对应的处理函数
static state_handler_t s_state_table[] = {
    [STATE_IDLE]          = handle_idle,
    [STATE_CONNECTING]    = handle_connecting,
    [STATE_CONNECTED]     = handle_connected,
    [STATE_DISCONNECTED]  = handle_disconnected,
    [STATE_RECONNECTING]  = handle_reconnecting,
};

---

四、项目写进简历的模板

## 基于 RT-Thread 的物联网数据网关

**项目时间：** 2026.04 - 2026.06
**技术栈：** STM32F407 / RT-Thread / MQTT / Modbus RTU / SPI Flash / LittleFS
**项目来源：** 基于 RT-Thread 开源生态，独立完成移植与二次开发

**项目描述：**
设计并实现一套嵌入式物联网网关，通过 RS485 Modbus 采集多个传感器
节点数据，经解析处理后通过 MQTT 协议上报阿里云 IoT 平台，支持远程
配置、OTA 升级与异常自恢复。

**个人职责：**
• 完成 RT-Thread 在 STM32F407 上的移植与裁剪，Flash 占用优化至 48KB
• 移植并改造 FreeModbus 主机协议栈，实现 8 从机轮询采集，通信成功率 99.5%
• 基于 kawaii-mqtt 实现 MQTT 客户端，支持 QoS1 + 掉线缓存 + 自动重连
• 设计 A/B 分区 OTA 方案，支持差分升级与失败自动回滚
• 实现分级日志系统，存储于 LittleFS，支持串口 + 远程两种查看方式

**技术难点与解决方案：**
• Modbus 轮询 8 从机时超时率高达 15%
  → 分析发现帧间隔不满足 3.5T 规范，用硬件定时器精确控制帧间隔
  → 增加自适应超时算法（根据历史响应时间动态调整），超时率降至 0.5%
• MQTT 在弱网环境频繁断连
  → 实现指数退避重连策略 + 本地 Flash 消息缓存队列
  → 重连后自动补发缓存消息，实测断网 30 分钟数据零丢失

---

五、8 周执行计划

周次	任务	核心产出
1	精读 FreeRTOS / RT-Thread Nano 内核源码	手写笔记：任务调度、IPC 原理
2	手动移植 RTOS 到 STM32，写 3 个 IPC demo	代码上传 GitHub
3	选择一个中间件项目（Modbus/MQTT/LittleFS），读源码	画出模块架构图
4~5	移植 + 跑通 + 魔改出自己的版本	项目一完成
6~7	做系统级项目（IoT 网关 / Linux 监控）	项目二完成
8	整理简历 + 准备每个项目的面试话术 + 模拟面试	简历定稿 + 投递

---

六、最后几句大实话

1. 不要 clone 下来跑通就完事了。 跑通只是第一步，读懂设计思路、能讲出为什么这么写，才算学到了。

2. 改造 > 复现。 面试官问"这是你写的吗"，你说"我基于开源项目做了 XX 改造"——这完全没问题，开源本来就是拿来用的，关键是你能讲清楚改了什么、为什么改。

3. 写博客记录过程。 每个项目写 2~3 篇博客（移植踩坑 / 源码分析 / 性能优化），面试时直接甩链接，说服力拉满。

4. 代码传 GitHub。 commit 记录就是你最好的"项目真实性证明"。保持有意义的 commit message，别一次性全 push 上去。

5. 少而精 > 多而浅。 两个吃透的项目，吊打五个浅尝辄止的项目。

---

🎯 记住：开源项目是你最好的老师，面试官是你最好的检验者。

把一个开源项目从"跑通"到"吃透"到"魔改"到"面试讲清楚"——这个过程本身就是最好的学习。