# embedded-linux-tutorials

**Repository Path**: Linke7/embedded-linux-tutorials

## Basic Information

- **Project Name**: embedded-linux-tutorials
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 嵌入式 Linux 开发教程集

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Platform](https://img.shields.io/badge/Platform-Linux-blue.svg)](https://www.kernel.org/)
[![Language](https://img.shields.io/badge/Language-中文-red.svg)](README.md)

一个面向嵌入式 Linux 开发者的实用教程集合，涵盖从基础工具到内核开发的完整学习路径。

## 📚 教程目录

### 🔧 基础工具

- **[Git 推送完整指南](tutorials/git_basics/git_push_guide.md)**
  - Git 安装和配置
  - 推送到 GitHub/Gitee
  - 常见问题解决
  - SSH 协议配置

### 💡 硬件控制

- **[Linux LED 控制原理详解](tutorials/led_control/linux_led_control_guide.md)**
  - LED 子系统架构
  - sysfs 接口操作
  - 触发器机制
  - 内核驱动原理
  - 实用脚本：[关闭 LED 闪烁](tutorials/led_control/disable_leds.sh)

### 📁 文件系统

- **[FatFs 移植教程](tutorials/fatfs_porting/fatfs_porting_guide.md)**
  - FatFs 架构介绍
  - 移植步骤详解
  - 底层接口实现
  - 包含完整源码

### 🐧 Linux 内核学习

完整的 Linux 内核学习路径，特别适合从 RT-Thread 转向 Linux 的开发者：

1. **[RT-Thread 到 Linux 迁移指南](tutorials/linux_learning/rtthread_to_linux_guide.md)** (30 分钟)
   - 核心概念对比
   - 第一个内核模块
   - 快速上手指南

2. **[驱动开发对比](tutorials/linux_learning/driver_comparison.md)** (1 小时)
   - RT-Thread vs Linux 驱动对比
   - 开发复杂度分析
   - 使用场景选择

3. **[Linux 内核学习路径](tutorials/linux_learning/linux_kernel_learning_path.md)** (15 小时)
   - 10 个阶段系统学习
   - 从 Hello World 到内核裁剪
   - 完整代码示例和 Makefile
   - 字符设备、GPIO、中断、设备树、平台驱动

## 🚀 快速开始

### 克隆仓库

```bash
# HTTPS
git clone https://gitee.com/Linke7/embedded-linux-tutorials.git

# SSH
git clone git@gitee.com:Linke7/embedded-linux-tutorials.git

cd embedded-linux-tutorials
```

### 查看教程

```bash
# 查看教程总索引
cat tutorials/README.md

# 查看具体教程
cat tutorials/git_basics/git_push_guide.md
cat tutorials/led_control/linux_led_control_guide.md
cat tutorials/linux_learning/linux_kernel_learning_path.md
```

### 运行脚本

```bash
# 关闭 LED 闪烁（需要 root 权限）
cd tutorials/led_control
sudo ./disable_leds.sh
```

## 📖 学习路线推荐

### 初学者路线

1. **Git 基础** → [Git 推送指南](tutorials/git_basics/git_push_guide.md)
2. **硬件控制入门** → [LED 控制教程](tutorials/led_control/linux_led_control_guide.md)
3. **快速上手 Linux** → [RT-Thread 到 Linux 迁移指南](tutorials/linux_learning/rtthread_to_linux_guide.md)
4. **系统学习** → [Linux 内核学习路径](tutorials/linux_learning/linux_kernel_learning_path.md)

### RT-Thread 开发者路线

1. [RT-Thread 到 Linux 迁移指南](tutorials/linux_learning/rtthread_to_linux_guide.md) (30 分钟)
2. [驱动开发对比](tutorials/linux_learning/driver_comparison.md) (1 小时)
3. [Linux 内核学习路径](tutorials/linux_learning/linux_kernel_learning_path.md) (15 小时)

### 文件系统开发者路线

1. [FatFs 移植教程](tutorials/fatfs_porting/fatfs_porting_guide.md)
2. 实践：移植 FatFs 到你的项目

## 🛠️ 开发环境

本教程基于以下环境开发和测试：

- **硬件平台**: 香橙派 5 Pro (RK3588S)
- **操作系统**: Linux (Armbian/Ubuntu)
- **架构**: ARM64
- **内核版本**: 5.10+

大部分教程适用于其他 Linux 平台，具体兼容性请参考各教程说明。

## 📂 项目结构

```
embedded-linux-tutorials/
├── README.md                    # 本文件
├── PROJECT_STRUCTURE.md         # 详细项目结构说明
├── .gitignore                   # Git 忽略规则
├── tutorials/                   # 教程目录
│   ├── README.md               # 教程总索引
│   ├── CONTRIBUTING.md         # 贡献指南
│   ├── git_basics/             # Git 基础教程
│   ├── led_control/            # LED 控制教程
│   ├── fatfs_porting/          # FatFs 移植教程
│   └── linux_learning/         # Linux 内核学习系列
│       ├── README.md           # 学习路线图
│       ├── rtthread_to_linux_guide.md
│       ├── driver_comparison.md
│       ├── linux_kernel_learning_path.md
│       └── kernel_workspace/   # 学习工作区
└── .kiro/                      # AI 助手配置
    └── steering/               # 教程管理规则
```

## 🤝 贡献指南

欢迎贡献新的教程或改进现有内容！

### 如何贡献

1. Fork 本仓库
2. 创建特性分支：`git checkout -b feature/new-tutorial`
3. 提交更改：`git commit -m "feat: 添加新教程"`
4. 推送到分支：`git push origin feature/new-tutorial`
5. 提交 Pull Request

### 贡献规范

- 查看 [贡献指南](tutorials/CONTRIBUTING.md)
- 遵循现有的文档格式
- 提供清晰的代码示例
- 更新 `tutorials/README.md` 索引

## 📝 文档规范

- 所有教程使用 Markdown 格式
- 代码示例包含完整的注释
- 提供实际运行的命令和输出
- 包含常见问题和解决方案

## 🔗 相关资源

### 官方文档

- [Linux 内核文档](https://www.kernel.org/doc/html/latest/)
- [Git 官方文档](https://git-scm.com/doc)
- [FatFs 官方网站](http://elm-chan.org/fsw/ff/)

### 学习资源

- [Linux 内核之旅](https://kerneltravel.net/)
- [蜗窝科技](http://www.wowotech.net/)
- [Linux 设备驱动程序](https://lwn.net/Kernel/LDD3/)

### 社区

- [Linux 内核邮件列表](https://lkml.org/)
- [RT-Thread 社区](https://www.rt-thread.org/)

## 📊 教程统计

| 类别 | 教程数量 | 预计学习时间 |
|------|---------|-------------|
| Git 基础 | 1 | 1 小时 |
| 硬件控制 | 1 | 2 小时 |
| 文件系统 | 1 | 3 小时 |
| Linux 内核 | 3 | 16.5 小时 |
| **总计** | **6** | **22.5 小时** |

## 🎯 学习目标

完成本教程集后，你将能够：

- ✅ 熟练使用 Git 进行版本控制
- ✅ 理解 Linux 设备驱动开发流程
- ✅ 掌握 sysfs、设备树等内核机制
- ✅ 编写字符设备、平台驱动等常见驱动
- ✅ 移植和定制文件系统
- ✅ 进行内核调试和性能优化
- ✅ 从 RT-Thread 平滑过渡到 Linux

## 📅 更新日志

- **2026-03-14**: 创建仓库，添加初始教程
  - Git 推送完整指南
  - LED 控制原理详解
  - FatFs 移植教程
  - Linux 内核学习系列（3 篇）

## 📄 许可证

本项目采用 [MIT 许可证](LICENSE)。

## 👤 作者

- **Linke7** - [Gitee](https://gitee.com/Linke7) | [GitHub](https://github.com/Linke7)

## 💬 反馈与支持

如果你有任何问题或建议：

- 提交 [Issue](https://gitee.com/Linke7/embedded-linux-tutorials/issues)
- 发起 [Pull Request](https://gitee.com/Linke7/embedded-linux-tutorials/pulls)
- 在教程中留言讨论

---

⭐ 如果这个项目对你有帮助，欢迎 Star 支持！

📖 持续更新中，敬请关注...