Arduino UNO R3 dev

README: English | 中文

Arduino UNO R3 dev
- Introduction
- Example
- TODO
- More
- Q&A
- How To Contribute?
- Contributors ✨

开源不易，为项目点个star:star:吧！

Introduction

该仓库为笔者的Arduino在学习中的资料整理，网上有很多很不错的开源项目和资料，笔者做的只是把这些内容整合起来，希望可以对大家的学习有所帮助。

需要注意的是，在本文档中，笔者使用的芯片为Arduino UNO R3 改进版(**特色版本)，R3改进版和原版的区别大家有兴趣可以查一下，两种控制器在实际开发中是没有区别的。

Example

如果你有一些项目可以根据现有的开源代码作为基础开发，那么你大可以将现有的例程进行修改，修改为自己需要的例程，以下例程为笔者在各种开源的项目基础上改进得到的自己需要的demo，现将这些例程开源，希望对大家有所帮助。

TODO

如果你想要学习更多的内容，你需要更多地实战、优质的学习资料和接触开源项目，以下是一些笔者学习arduino的一些参考。

Awesome-arduino - 里面汇总了各种arduino的常用库、硬件资源以及开源项目，含金量极高
arduino library - arduino IDE官方库，Serial等常用的函数库都在这里有例程讲解，没有什么是比看官方的例程更有效的学习方法了！
太极创客 - 学习arduino和esp8266都可以参考这个团队的资料，他们整理的十分全面，感谢！
arduino 硬件资料/原理图
arduino数据手册pdf版本

Q&A

零基础小白怎么快速上手Arduino？

如果你是零基础的小白，我推荐从视频教程太极创客b站入门教程开始入门学起。

IDE该如何选择，用Arduino好还是platformio好？

对于新手来说，arduino IDE已经足够了，且大多数时候使用arduino IDE开发都是很舒服的。但是platformio编译速度很快，相关开源环境也比较完善，如果熟悉了使用platformio，你会再也不想用arduino IDE进行开发，但是用platformio需要科学上网，有的时候初始化要很久，真的很头疼！

没有开源项目经历，我该如何参与贡献代码？

我们非常欢迎没有经验开源经验的小白在此贡献代码，TODO展示了该项目的一些待办事宜，我们非常欢迎大家参与TODO的贡献,详细可以参考How To Contribute?

git commit message要怎么写？

参考https://zhuanlan.zhihu.com/p/400870942

How To Contribute?

为了便于大家参与贡献，我将项目计划做了一些整理，主要参考TODO,因为该项目为基础性项目，所以每个部分都比较容易参与进来，适合初入开源项目的小白，欢迎大家参与贡献。

不仅是TODO的部分，demo中的bug、文档修改、提issue，甚至是错别字的修改，都可以视为一次修改，不要小瞧自己的力量。issue中会存放一些当前存在的问题，欢迎大家解决问题提供pr，如果你发现了问题，也欢迎你提出issue！

如果你想对本项目做出贡献，提交pr(pull request)，那么你可以先把该项目进行fork 或者 git clone到本地（推荐先fork 到自己仓库，然后再clone到本地，在本地新建一个your-branch分支继承main分支进行操作编辑，在your-branch修改对应文档或代码，markdown的图片可以存放在/doc/images/下，修改完成后commit你的修改内容，然后把你your-branch分支下的修改内容push到你的github仓库，最后，在github的仓库中New pull request，提交你分支的修改内容至author的仓库，等待author进一步review，如果authormerge了你的代码，即视为贡献代码！