demo1984s 的个人博客

偶然一个机会接触到了合宙系列MCU开发板,最开始使用 LUA 开发,随着越来越多接触到 ESP32C3 ,也开始摸索 Arduino 开发,新手入门还是折腾了一下,以此文方便其他朋友。
相关安装软件包:
官网有介绍各种操作环境下的安装,比较简单,就是下载安装包点击安装,不作赘述。详细见原文 Getting Started with Arduino products | Arduino。

网上比较多网文写得比较早,部分是基于Arduino IDE 1(图标圆形,名字Arduino)写的,部分是基于Arduino IDE 2(图标方形,名字Arduino IDE)写的,两个版本比较大的区别是1是Java语言开发的,2是基于Eletron,另外IDE安装目录结构也会有不同,新手会不好理解。可进入下载页面Software | Arduino 自行选择版本下载。

1有个好处是可以使用文件上传插件(arduino-esp32fs-plugin、arduino-esp8266fs-plugin),上传到开发板的Flash存储里面。2已经禁止了这些插件,好像是基于安全问题,对应的文章找不到了,后续找到再更新文章。

ESP8266官方GitHub上有介绍 GitHub - arduino/esp8266: ESP8266 core for Arduino,这里附上访问更快的国内镜像地址 https://gitcode.net/mirrors/esp8266/arduino,日常安装一般有以下两种方式:
官方介绍可见原文Installing — ESP8266 Arduino Core 3.1.2-11-g57fa6cdc documentation (arduino-esp8266.readthedocs.io),简单转成中文说明如下内容。
打开“首选项”菜单,在“其他开发板管理器地址”填入以下地址
https://arduino.esp8266.com/stable/package_esp8266com_index.json

依次打开“工具 - 开发板 - 开发板管理器”

在新打开的界面搜索“ESP8266”进行安装

安装结束后无需重启IDE即可使用,可以看到有两个ESP8266,带括号说明的那个即是接下来要说的源代码zip包安装方式。

ESP8266安装后完整的目录机构如下(以Mac OS为例):
Library
|_Arduino15
|_packages
|_esp8266
|_hardware
|_esp8266
|_3.1.2
|_...(以下省略)
可选安装到Arduino IDE的安装文件夹下或者Arduino项目文件夹下,这里介绍安装到Arduino项目文件夹下的方式。
https://gitcode.net/mirrors/esp8266/arduino

这种安装方式,“其他开发板管理器地址”留空即可,官方说明里面写了要卸载通过开发版管理器安装的版本。首先打开“首选项”,找到“项目文件夹地址”对应的目录。

在“项目文件夹地址”对应的目录下建立目录“hardware/esp8266com”(hardware是Arduino IDE可以识别的目录,不可以用其他的名字;esp8266com这个目录名字可以随便用一个),然后将下载回来的zip文件解压改名为esp8266,将 esp8266 这个文件夹复制或者剪切到 esp8266com 目录下,完整的目录结构如下:
Documents
|_Anrduio
|_hardware
|_esp8266com
|_esp8266
|_bootloaders
|_cores
|_doc
|_libraries
|_package
|_tests
|_tools
|_variants
|_boards.txt
|_keywords.txt
|_platform.txt
|_programmers.txt
|_LICENSE
|_package.json
|_ISSUE_TEMPLATE.md
|_POLICY.md
|_README.md
重启Arduino IDE,打开“工具”菜单,可以看到已安装成功,而且还带有括号说明“在项目文件夹中”。

而通过“开发板管理器”安装的方式则不会有这个括号说明,实际上可以同时两种方式安装,一般不建议,容易搞混。
Clone项目对大部分新手来说不适用,官方介绍可见原文Installing — ESP8266 Arduino Core 3.1.2-11-g57fa6cdc documentation (arduino-esp8266.readthedocs.io),简单转成中文说明如下内容。
安装方式与下载zip包大同小异,通过命令行或者GUI工具把项目Clone到esp8266com目录下,例如命令行:
demo1984s@MyLaptop ~/Documents/Arduino/hardware/esp8266com git clone git@gitcode.net:mirrors/esp8266/arduino.git esp8266
下载完成后,还需要进入 esp8266 目录更新工具:
demo1984s@MyLaptop ~/Documents/Arduino/hardware/esp8266com cd esp8266/tools
demo1984s@MyLaptop ~/Documents/Arduino/hardware/esp8266com/esp8266/tools python3 get.py
网上对应的安装包名称如下图所示,下载后点击运行安装即可。(从文章最后一部分“附录”获取)

可以参考ESP8266的安装方式,ESP32安装官方说明https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html
开发板管理器地址,二选一即可
源代码zip文件下载,GitHub的国内镜像加速站
https://gitcode.net/mirrors/espressif/arduino-esp32
在小黄鱼上挂了几个 Arduino 入门学下项目的代码链接,有鱼友问到有没有python,这里先mark以下,后续研究一下。
Quick reference for the ESP32 — MicroPython latest documentation