开源不易,为项目点个star:star:吧!
该仓库为笔者的Arduino在学习中的资料整理,网上有很多很不错的开源项目和资料,笔者做的只是把这些内容整合起来,希望可以对大家的学习有所帮助。
需要注意的是,在本文档中,笔者使用的芯片为Arduino UNO R3 改进版(中国特色版本),R3改进版和原版的区别大家有兴趣可以查一下,两种控制器在实际开发中是没有区别的。
如果你有一些项目可以根据现有的开源代码作为基础开发,那么你大可以将现有的例程进行修改,修改为自己需要的例程,以下例程为笔者在各种开源的项目基础上改进得到的自己需要的demo,现将这些例程开源,希望对大家有所帮助。
- 英文文档的编写
- 更多的demo
- 参与贡献相关md的完善
- 丰富文档的内容
- 补充更多的Q&A
- 减少demo中的外链
如果你想要学习更多的内容,你需要更多地实战、优质的学习资料和接触开源项目,以下是一些笔者学习arduino的一些参考。
-
Awesome-arduino - 里面汇总了各种arduino的常用库、硬件资源以及开源项目,含金量极高
-
arduino library - arduino IDE官方库,Serial等常用的函数库都在这里有例程讲解,没有什么是比看官方的例程更有效的学习方法了!
-
太极创客 - 学习arduino和esp8266都可以参考这个团队的资料,他们整理的十分全面,感谢!
- 零基础小白怎么快速上手Arduino?
如果你是零基础的小白,我推荐从视频教程太极创客b站入门教程开始入门学起。
- IDE该如何选择,用Arduino好还是platformio好?
对于新手来说,arduino IDE已经足够了,且大多数时候使用arduino IDE开发都是很舒服的。但是platformio编译速度很快,相关开源环境也比较完善,如果熟悉了使用platformio,你会再也不想用arduino IDE进行开发,但是用platformio需要科学上网,有的时候初始化要很久,真的很头疼!
- 没有开源项目经历,我该如何参与贡献代码?
我们非常欢迎没有经验开源经验的小白在此贡献代码,TODO展示了该项目的一些待办事宜,我们非常欢迎大家参与TODO的贡献,详细可以参考How To Contribute?
- git commit message要怎么写?
为了便于大家参与贡献,我将项目计划做了一些整理,主要参考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
了你的代码,即视为贡献代码!
需要注意的是,在大多数情况下,fork下来的main分支一般需要和author的main分支保持同步,这就要求你最好不要在main分支上随意改动。
Thanks goes to these wonderful people (emoji key):
Zeeland 📖 |
This project follows the all-contributors specification. Contributions of any kind welcome!