ESP32 新手入门:40 元 1 小时,让 Arduino 开发板连上 WiFi 还能被浏览器访问
【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32
一块 40 元出头的 ESP32 开发板,刷好 arduino-esp32 核心库后,1 小时内就能连上你家 WiFi,还能用浏览器打开它烧进去的页面。这篇 ESP32 开发板新手教程,带你从零装好环境到点亮第一块 WiFi 板子。
成品长什么样
烧录成功后你看到的,就是这样的画面:串口监视器里滚出 WiFi 扫描日志,编译、上传、回显一次完成。
它的能力一句话:32 位双核主控 + WiFi + 蓝牙,GPIO 随便用,烧进一块板子就能独立上网。
开工前准备
开工前把东西摆齐,缺一样后面都会卡住。
| 类别 | 名称 | 数量 | 参考价 |
|---|---|---|---|
| 物料 | ESP32-DevKitC-32E 开发板(ESP32-WROOM-32 模块) | 1 块 | 35 元 |
| 物料 | USB 数据线(能传数据,非纯充电线) | 1 根 | 5 元 |
| 工具 | Arduino IDE 2.x(Windows / macOS / Linux 均可) | 1 套 | 免费 |
| 工具 | 任意浏览器(验收用) | 1 个 | 免费 |
合计约 40 元,外加 1 小时整。⚠️ 注意:数据线务必买能传数据的,十几块钱的纯充电线插上只会没反应,这是新手最常卡住的一步。
搭建过程
阶段一:装好 Arduino IDE 并加开发板源
打开 Arduino IDE 2.x,进入 文件 → 首选项(Preferences),在"附加开发板管理器网址(Additional Boards Manager URLs)"一栏填入 ESP32 的包地址,保存。
- IDE 能正常打开,首选项窗口保存成功
- 附加网址栏里已填入 arduino-esp32 的 package 地址
- 系统满足要求(Windows 需 10/11 64 位,不支持 32 位老系统)
阶段二:安装 ESP32 板子包
工具 → 开发板 → 板子管理器,搜索框输入 esp32,选中 espressif 的包点安装。装完回菜单选 ESP32 Dev Module。
- 板子管理器能搜到 esp32(by Espressif)
- 安装完成,菜单里出现 ESP32 Dev Module
- 开发板、端口(COM 或 /dev/tty*)、上传速度 921600 三项已选好
装完包还显示"找不到板子"?多半是没重启 IDE,重启一下再刷菜单就有了。
阶段三:点亮板子,确认串口能回显
把板子用 USB 线连上电脑,打开任意示例草图,点上传。
- 插线后 IDE 工具 → 端口里出现新串口
- 上传日志显示 100% 完成(官方日志:4.6 秒写入约 450KB)
- 串口监视器(115200 波特率)有滚动输出
能看到串口输出,说明烧录链路通了,下面才是重头戏。
阶段四:连上 WiFi,被浏览器打开
新建草图,粘入下面这段,把 ssid 和 password 换成你自己家路由器的,编译上传。
#include <WiFi.h> const char *ssid = "你的WiFi名"; // 换成自家路由器 SSID const char *pwd = "你的WiFi密码"; // 换成自家 WiFi 密码 void setup() { Serial.begin(115200); WiFi.begin(ssid, pwd); // 发起 WiFi 连接(STA 模式) while (WiFi.status() != WL_CONNECTED) { delay(500); } Serial.print("本机IP: "); Serial.println(WiFi.localIP()); // 拿到 IP 后去浏览器输它 } void loop() {}ESP32 作为 STA 接入你家路由器,和手机、电脑处于同一个局域网:
串口里打出本机IP: 192.168.x.x后,把这个 IP 敲进浏览器地址栏,回车。
阶段五:把网页装进板子里
再进一步:用仓库自带的 SimpleWiFiServer 示例(示例代码在 libraries/WiFi/examples/SimpleWiFiServer/),浏览器就能访问板子自己吐出的页面。
- 串口日志显示连接成功并打印 IP
- 浏览器打开该 IP,几秒内出现板子提供的网页
- 刷新 3 次页面都稳定加载,不超时
怎么算做成了
做没做成,用这几项数字说话:
| 验收项 | 合格标准 |
|---|---|
| 首次编译耗时 | 30 秒以内(首次会下载依赖,约 1 分钟) |
| 固件上传耗时 | ≤ 6 秒(1MB 固件约 4.6 秒) |
| WiFi 连接耗时 | 上电后 5 秒内打出本机 IP |
| 网页打开耗时 | 输入 IP 后 3 秒内页面加载完成 |
| 稳定性 | 反复断电重启 5 次,每次都成功联网 |
中途翻车时,对照这张表找原因:
| 故障现象 | 常见原因 | 对策 |
|---|---|---|
| 插上 USB,端口列表里没变化 | 数据线是纯充电线 / 驱动缺失 | 换能传数据的数据线;Windows 下补装 CP210x 或 CH340 驱动 |
| 上传到 90% 报错 | 上传速度过高或 USB 口不稳 | 上传速度降到 115200 重试,或换一个 USB 口 |
| 编译一直转圈不结束 | 首次编译在下载依赖 | 等 1~3 分钟;网络差时检查代理设置 |
| 连不上 WiFi,卡死循环 | 密码错、或路由器是 5GHz 单频 | 核对密码;ESP32-WROOM-32 只支持 2.4GHz 频段 |
| 拿到 IP 但浏览器打不开 | 手机/电脑和板子不在同一局域网 | 确认设备都连着同一个路由器 |
还能玩出什么花样
- 接一个 DHT11 传感器,让网页实时显示温度和湿度
- 改用 AP 热点模式,板子自己发 WiFi,出门无网也能玩
- 用仓库里的 libraries/HTTPUpdate/ 实现 OTA 远程升级,以后刷机不用插线
- 加装 libraries/BLE/ 库,同一块板子同时支持 WiFi 和蓝牙双通道
开始动手
想改代码、找示例,把仓库克隆下来即可:
git clone https://gitcode.com/GitHub_Trending/ar/arduino-esp32环境细节见 官方文档 docs/en/installing.rst,常用库在 libraries/ 目录里。板子都买好了的话,现在就可以把线插上,开始烧第一块 ESP32。
【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考