单片机与物联网 / 系统课时

安装 Arduino IDE

安装 Arduino IDE

本节完成 Arduino IDE、ESP32 开发板支持包和串口的最小可用配置。完成后,你应该能在 IDE 中看到自己的 ESP32 板型与端口,为下一步编译和烧录程序做好准备。

学习目标

  • 安装并启动 Arduino IDE,确认基础界面可用
  • 通过 Boards Manager 安装 ESP32 开发板支持包
  • 正确选择 ESP32 板型和串口,并处理端口不出现的常见问题

安装并启动 Arduino IDE

从 Arduino 官方下载当前稳定版 Arduino IDE,按操作系统完成安装。Windows 与 macOS 通常使用安装包;Linux 可使用官方提供的 AppImage、压缩包或对应发行方式。首次启动后先确认 IDE 能正常创建空白 Sketch,不必立即修改编译参数。

添加 ESP32 开发板索引

打开 Arduino IDE 的设置或 Preferences,找到 Additional Boards Manager URLs,加入 ESP32 稳定版索引地址:

https://espressif.github.io/arduino-esp32/package_esp32_index.json

如果这里已经有其他地址,不要覆盖原值,按 IDE 支持的方式追加。保存设置前,可以先用下面的命令验证索引地址是否可访问:

bash
curl -L -s -o /dev/null -w "%{http_code}\n" "https://espressif.github.io/arduino-esp32/package_esp32_index.json"

预期输出

text
200

返回 200 说明当前网络能够访问索引。若返回其他状态码或连接超时,先处理代理、DNS 或网络限制,再进入 Boards Manager,否则支持包下载通常也会失败。

安装 ESP32 支持包并选择开发板

打开 Boards Manager,搜索 esp32,安装由 Espressif Systems 提供的 ESP32 平台包。下载内容较多,安装期间不要关闭 IDE。完成后通过顶部开发板选择器或 Tools → Board 选择与你实际板卡匹配的型号。

通用 ESP32 DevKit 常可从 ESP32 Dev Module 起步,但 ESP32-C3、ESP32-S3、ESP32-S2 等芯片应选择对应板型。板型选错可能导致 Flash 大小、USB 模式、启动方式或引脚定义不匹配,因此不要只看“都是 ESP32”就随意选择。

连接串口并验证

用支持数据传输的 USB 线连接开发板,然后在顶部开发板选择器或 Tools → Port 中选择新出现的串口。Windows 常见为 COM<PORT>,Linux 常见为 /dev/ttyUSB<ID> 或 /dev/ttyACM<ID>,macOS 常见为 /dev/cu.*;实际名称以系统为准。

如果端口列表没有变化,先更换确认可传数据的 USB 线和 USB 接口,再检查系统是否识别到 USB 设备。部分开发板使用 CP210x、CH34x、FTDI 等 USB 转串口芯片,可能需要对应驱动;带原生 USB 的 ESP32-S2/S3/C3 板卡则可能以不同设备类型出现。

当 IDE 已安装 ESP32 平台包、板型选择正确且串口可选时,环境准备就完成了。此时不要急着调整 Flash Mode、Partition Scheme 等高级选项,先保持板型默认值,用一个最小程序验证编译和烧录链路。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Arduino IDE

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通