demo1984s 的个人博客
记录精彩的程序人生
Arduino 1.8、Arduino IDE 2.0上配置ESP8266/ESP32开发板开发环境
写在前面
偶然一个机会接触到了合宙系列 MCU 开发板，最开始使用 LUA 开发，随着越来越多接触到 ESP32C3 ，也开始摸索 Arduino 开发，新手入门还是折腾了一下，以此文方便其他朋友。
相关安装软件包：
Arduino IDE 安装
官网有介绍各种操作环境下的安装，比较简单，就是下载安装包点击安装，不作赘述。详细见原文 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 已经禁止了这些插件，好像是基于安全问题，对应的文章找不到了，后续找到再更新文章。
Arduino 安装 ESP8266 开发板环境
ESP8266 官方 GitHub 上有介绍 GitHub - arduino/esp8266: ESP8266 core for Arduino，这里附上访问更快的国内镜像地址 https://gitcode.net/mirrors/esp8266/arduino，日常安装一般有以下两种方式：
- 通过开发板管理器安装
- 手动安装
- 下载项目源代码 zip 包/Clone 项目源代码到本地
- Windows 一键安装包
开发板管理器安装
官方介绍可见原文 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 为例）：
1Library
2|_Arduino15
3 |_packages
4 |_esp8266
5 |_hardware
6 |_esp8266
7 |_3.1.2
8 |_...（以下省略）
手动安装
下载源代码 zip 包/Clone 项目源代码安装
可选安装到 Arduino IDE 的安装文件夹下或者 Arduino 项目文件夹下，这里介绍安装到 Arduino 项目文件夹下的方式。
https://gitcode.net/mirrors/esp8266/arduino
这种安装方式，“其他开发板管理器地址”留空即可，官方说明里面写了要卸载通过开发版管理器安装的版本。首先打开“首选项”，找到“项目文件夹地址”对应的目录。
在“项目文件夹地址”对应的目录下建立目录“hardware/esp8266com”（hardware 是 Arduino IDE 可以识别的目录，不可以用其他的名字；esp8266com 这个目录名字可以随便用一个），然后将下载回来的 zip 文件解压改名为 esp8266，将 esp8266 这个文件夹复制或者剪切到 esp8266com 目录下，完整的目录结构如下：
1Documents
2|_Anrduio
3 |_hardware
4 |_esp8266com
5 |_esp8266
6 |_bootloaders
7 |_cores
8 |_doc
9 |_libraries
10 |_package
11 |_tests
12 |_tools
13 |_variants
14 |_boards.txt
15 |_keywords.txt
16 |_platform.txt
17 |_programmers.txt
18 |_LICENSE
19 |_package.json
20 |_ISSUE_TEMPLATE.md
21 |_POLICY.md
22 |_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
Windows 一键安装包
网上对应的安装包名称如下图所示，下载后点击运行安装即可。(从文章最后一部分“附录”获取）
Arduino 安装 ESP32 开发板环境
可以参考 ESP8266 的安装方式，ESP32 安装官方说明 https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html
开发板管理器地址，二选一即可
- 开发版 https://espressif.github.io/arduino-esp32/package_esp32_dev_index.json
- 稳定版 https://espressif.github.io/arduino-esp32/package_esp32_index.json
源代码 zip 文件下载，GitHub 的国内镜像加速站
https://gitcode.net/mirrors/espressif/arduino-esp32
MicroPython
在小黄鱼上挂了几个 Arduino 入门学下项目的代码链接，有鱼友问到有没有 python，这里先 mark 以下，后续研究一下。
Quick reference for the ESP32 — MicroPython latest documentation
标题：Arduino 1.8、Arduino IDE 2.0上配置ESP8266/ESP32开发板开发环境
作者：demo1984s
地址：http://www.demo1984s.com/articles/2023/04/21/1682090884562.html
