Zuolan MCU Peripheral

项目简介

本项目汇集了常用外设的代码示例（如 DHT11、DS18B20、MPU6050 等），旨在帮助开发者快速上手这些外设的开发与使用。

仓库说明
本仓库中的 ./libdriver 资源来源于 libdriver 开源项目。
注意：本仓库仅供分享与学习，部分代码暂未完善（如以 mcu 开头的模块如 OLED、ESP01S 等），但代码可正常运行，仅部分例程与接口未适配。

---

仓库说明

1. 资源来源声明
   本仓库中的 ./libdriver 资源来源于 libdriver 开源项目，所有相关代码的知识产权归原项目所有。我们在此基础上进行了适配与扩展，仅供学习与交流使用。

2. 使用限制声明

   • 本仓库的内容仅供个人学习、研究及非商业用途。
   • 请勿将本仓库中的代码用于任何违法用途。
   • 开发者在使用本项目时，请遵守相关开源协议的约定。

3. 代码完善情况

   • 部分模块尚未完全适配（例如以 mcu 开头的模块如 OLED、ESP01S 等），尽管代码能够正常运行，但相关例程和接口可能不够完善或缺乏完整测试。
   • 如果您在使用过程中发现问题，欢迎通过 Issue 或 Pull Request 提出反馈与改进建议。

4. 无任何保证

   • 本项目按“现状”提供，不对代码的准确性、稳定性或适用性作出任何形式的保证。
   • 使用本代码所导致的任何问题或损失，开发者需自行承担相关责任。

5. 二次开发说明

   • 欢迎基于本项目进行二次开发，但请遵守原始开源项目的许可协议（如 MIT License 等）。
   • 请注明本项目及原始项目的来源，以尊重原作者的劳动成果。

6. 法律与协议约束
   在您下载、使用、分发本项目时，即表明您已知晓并接受以上声明。如不接受，请勿下载或使用本项目的任何部分。

---

软件架构

本项目采用模块化设计，每个外设的代码均独立封装为模块，具有以下优势：

• 易于单独使用：每个模块可单独应用于项目。
• 便于集成开发：开发者可以快速集成多个模块，实现更多功能。

---

安装教程

1. 克隆仓库

您可以从 GitHub 或 Gitee 获取本项目：

# 克隆自 GitHub
git clone [email protected]:zuoliangyu/zuolan_mcu_peripheral.git

# 克隆自 Gitee
git clone [email protected]:zuo-lan/zuolan_mcu_peripheral.git

2. 编译外设模块

根据需要选择并编译对应的外设模块，即可快速上手。

---

贡献指南

欢迎任何形式的贡献！以下是贡献步骤：

1. Fork 本仓库
2. 创建一个新的分支（命名格式：Feat_xxx）
3. 提交代码至新分支
4. 提交 Pull Request，我们会尽快审核并合并您的代码

---

项目特性

• 多语言支持
  使用不同的 Readme_XXX.md 文件支持多语言文档，例如 Readme_en.md（英文版）、Readme_zh.md（中文版）等。

• 了解优秀开源项目

  • Gitee 官方博客：blog.gitee.com
  • 推荐开源项目：Gitee Explore
  • 最有价值开源项目（GVP）：Gitee GVP

• 官方资源

  • Gitee 使用手册：使用手册
  • Gitee 封面人物：会员风采

---

如果本项目对您有所帮助，欢迎 Star 支持我们！
您的鼓励是我们持续更新的动力！

---