ESP32 物联网开发入门：一文带你从点亮 LED 到做出会联网的温湿度计

ESP32 物联网开发入门：一文带你从点亮 LED 到做出会联网的温湿度计

【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32

想玩物联网，又怕被繁琐的底层配置劝退？这篇 ESP32 入门教程会告诉你，借助 Arduino 生态，从零开始把一个想法变成能联网、能采集数据的真实设备，并没有想象中那么难。我们以 arduino-esp32 核心库为地基，沿着一条清晰的实践路线走到底，你会发现"物联网开发教程"里那些听起来高深的名词，其实都能亲手摸到、亲眼看到。文章尽量用大白话讲，遇到概念就当聊天，遇到代码就抄下来跑一遍，效果比干看强十倍。

一块板子凭什么能联网？先认识你的主角

拿到 ESP32 开发板，很多人第一反应是：这不就是个比普通单片机多了两根天线的板子吗？没错，但这两根天线正是它"联网"的底气。它内部其实塞了两颗处理器核心，一颗用来干实时的杂活（比如读按钮、控电机），另一颗专门伺候网络协议栈，互不抢工，这也是它敢自称"物联网开发板"的资本。

除了双核，它还把 WiFi、蓝牙、I2C、SPI、UART 这些通信手段全都集成在一块芯片里。你可以把它想象成一个小型工具箱：需要无线就用 WiFi，需要接传感器就抽 I2C 总线，需要接屏幕就上 SPI。开发时不用再外挂一堆转接芯片，省事不少。

至于它能干什么，范围相当广：智能家居里的开关面板、田间的传感器节点、遥控小车、远程数据采集盒子……凡是"要采集信息 + 要传数据"的场景，基本都是它的主场。选它做入门板还有个额外好处：Arduino 生态里有几千个现成库，很多功能搜一下就能直接调用，不用自己从寄存器开始啃。

开工前的准备：让 Arduino IDE 认识这块板

Arduino IDE 默认并不认识 ESP32，需要手动给它"补课"。整个过程就三步，不需要动命令行，纯界面操作。

先到官网装一个最新版的 Arduino IDE，打开后进入"文件 → 首选项"，找到"附加开发板管理器网址"那一栏，把下面的地址填进去：

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

接着到"工具 → 开发板 → 开发板管理器"，搜索框里输入 esp32，找到对应的包点安装。装完之后，再回到"工具 → 开发板"菜单，就能看到一长串 ESP32 系列型号，挑一个跟你手里板子匹配的就行。

装好后用数据线把板子插上电脑（注意得是能传数据的数据线，有些线只能充电），在"工具 → 端口"里选中新出现的串口，环境就算齐活了。第一次跑通这个小流程，后面所有项目都顺了。

第一个程序：让板上的灯自己"眨眼"

所有嵌入式之旅几乎都是从点灯开始的，这既是仪式感，也是验证"板子、IDE、驱动、上传链路"全通的最快方式。ESP32 上一般有一颗板载 LED，多数挂在 GPIO2，具体位置可以翻一下你的板子型号对应的引脚定义文件，比如 variants 目录下各开发板的 pins_arduino.h 里都写得很清楚。

先看一个最朴素的点灯写法：

const int ledPin = 2; // 板载 LED 的引脚 bool lightOn = false; // 记录当前灯的状态 void setup() { pinMode(ledPin, OUTPUT); // 把引脚设置为输出模式 } void loop() { digitalWrite(ledPin, lightOn); // 按当前状态点亮或熄灭 lightOn = !lightOn; // 翻转状态 delay(500); // 停 500ms 再继续 }

这段代码能跑，但有个小毛病：delay(500)会像堵车一样把整个程序卡住 500ms，卡住期间什么都干不了。入门阶段无所谓，等你要同时处理联网、读传感器、刷屏幕时，就会嫌它碍事了。所以这里直接给你更讲究的写法——用millis()记录时间，让灯自己按节奏翻转，主循环始终畅通：

const int ledPin = 2; unsigned long lastFlip = 0; // 上一次翻转的时刻 bool lightOn = false; void setup() { pinMode(ledPin, OUTPUT); } void loop() { unsigned long now = millis(); if (now - lastFlip >= 500) { // 距离上次翻转过了 500ms 才动手 lastFlip = now; lightOn = !lightOn; digitalWrite(ledPin, lightOn); } // 想在这里做别的事？随便写，不会被灯拖住 }

点一下上传按钮，看到板上的灯有节奏地闪起来，恭喜，你和这块板子之间已经建立了初步信任。后面所有复杂功能，都是在这个基础上一点点叠加出来的。

真正联网：Station、AP 和混合模式怎么选

灯会闪了，接下来就是 ESP32 最让人心动的一环——连 WiFi。别急着写代码，先搞清楚它有几种"上网姿势"，选错了会走弯路。

Station 模式是最常用的：板子作为客户端，老老实实连到家里/办公室的路由器上，拿到一个 IP 地址，然后就能去访问服务器、上报数据。做物联网设备十有八九用这种模式。

AP 模式则反过来：板子自己开一个热点，手机或电脑连到它创建的网络里。这种模式通常用于设备第一次上电时的配网页面——没有路由器可用，设备先自建网络让你设置参数。

Station + AP 混合模式就是两个都要：一边连路由器上网，一边开热点给别的设备临时接入，适合做中继或者本地调试面板。

下面是一段用 Station 模式联网的示例，顺便演示了断线自动重连的思路：

#include <WiFi.h> const char* ssid = "你家的网络名"; const char* pass = "对应的密码"; void setup() { Serial.begin(115200); WiFi.begin(ssid, pass); // 发起连接 } void loop() { if (WiFi.status() == WL_CONNECTED) { if (!WiFi.localIP().toString().equals("0.0.0.0")) { static bool once = false; if (!once) { once = true; Serial.print("已上线，我的地址是："); Serial.println(WiFi.localIP()); } } } else { Serial.print("."); delay(500); // 没连上就等一会儿再试 } // 联网成功后的业务逻辑放这里 }

WiFi.begin本身是异步的，连接要花时间，所以主循环里要不断查询WiFi.status()判断是否就绪。看到串口打印出 IP 地址的那一刻，你就拥有了一个真正"在网"的设备。想了解更多联网细节，可以翻翻 arduino-esp32 的 libraries/WiFi 目录，里面有不少现成示例。

接上传感器：用一条 I2C 总线串起所有外设

联网是为了传数据，而数据来自传感器。ESP32 把传感器接进来的主流方式之一就是 I2C：一条 SDA 数据线、一条 SCL 时钟线，就能同时挂十几个设备，每个设备有自己的地址，互不干扰。这就像一条公交线路，每个站点（传感器）有自己唯一的站名（地址），数据在线上按站停靠。

ESP32 上 I2C 的默认引脚一般是 GPIO21（SDA）和 GPIO22（SCL），不过很多开发板为了兼容 Arduino 生态也做了引脚重映射，具体以你板子的引脚图为准。接线时记得三个原则：电源线（VCC、GND）别接反，SDA 对 SDA、SCL 对 SCL 别交叉，多个传感器共地。用 Arduino 自带的 Wire 库就能开始通信：

#include <Wire.h> void setup() { Wire.begin(); // 默认 SDA=21, SCL=22 Serial.begin(115200); } void loop() { Wire.beginTransmission(0x3C); // 目标传感器地址，比如某款 OLED Wire.write(0x80); // 发送指令字节 Wire.endTransmission(); delay(1000); }

实际项目里你一般不会从零写 I2C 协议，而是直接装对应的传感器库，比如温湿度库、气压库、显示库，它们内部已经把 Wire 封装好了。你要做的只是"接线 + 装库 + 调两行 API"，这也是 Arduino 生态最值钱的地方。接线不清楚的，可以对照项目 docs 下的示意图（比如 docs/_static/arduino_i2c_master.png）逐步检查。

让程序更抗造：非阻塞写法与双核分工

传感器接进来、WiFi 也连上了，程序开始变复杂，这时候两个"高级姿势"就该登场了。

第一个是前面提到的非阻塞思想。把所有delay换成"记时间 + 判断差值"的模式，让主循环永远在空转，网络回调、传感器读取、UI 刷新才有机会见缝插针地执行。别小看这个习惯，等你要做多传感器采集时，它能帮你少掉很多头发。

第二个是双核分工。ESP32 的两个核心可以各干各的：把网络收发这类任务固定在一个核，把传感器读取、IO 控制放在另一个核，用 FreeRTOS 的任务机制来编排。arduino-esp32 底层已经把 FreeRTOS 集成好了，你可以在代码里直接用xTaskCreatePinnedToCore之类的接口派活。初期不要求会用，但心里要有这张地图：实时控制走一个核，通信协议走另一个核，系统才不会互相拖后腿。

想省电？三种休眠模式按需取用

做电池供电的设备时，功耗是绕不开的话题。ESP32 的省电手段分三档，按需选用：

• 轻度睡眠：CPU 暂停，外设还在工作，醒来快，适合周期性干活的场景。
• 深度睡眠：主芯片大部分断电，只剩 RTC 和超低功耗协处理器在值班，适合"睡几个小时醒来采一次数"的传感器节点。
• 休眠模式：功耗压到最低，靠外部中断或定时器唤醒，适合极端省电的设计。

esp_sleep_enable_timer_wakeup(30 * 1000000); // 30 秒后自动醒来 esp_deep_sleep_start(); // 进入深度睡眠

配合两个思路效果更好：一是 CPU 频率够用就调低，比如setCpuFrequencyMhz(80)；二是用不到的模块（蓝牙、WiFi、外设）及时关闭。一块 18650 电池带着传感器隔几分钟醒一次，撑几个月不是梦。

卡壳了别慌：高频问题自查清单

新手遇到问题，九成是下面几类，挨个排查基本能解决：

板子插上没反应 / 上传失败？先换一根确定能传数据的数据线；再检查 CH340/CP2102 这类串口驱动装没装；上传时按住 BOOT 键再点上传，看到进度条再松手；最后确认"工具 → 端口"里选的串口和实际插入的是同一个。

WiFi 老是断线重连？先看信号强度，板子离路由器太远果断挪近；必要时用WiFi.setTxPower(WIFI_POWER_19_5dBm)调高发射功率；代码里加上"断线自动重连"逻辑（前面示例就是）；如果 DHCP 不稳，可以给设备设静态 IP。

程序能编译但行为怪怪的？打开串口监视器看打印信息，八成能定位到问题；检查是不是引脚冲突，比如某个引脚同时被两个外设占用；再看电源够不够，传感器多了 3.3V 稳压可能撑不住；程序崩溃的话，用在线异常解码工具分析栈信息，一般都能揪出元凶。

下一步怎么走：从小白到能接项目的路线图

到这里，你手里已经有一套完整的最小闭环：板子认识你了、会点灯了、能联网了、能读传感器了。接下来按这个节奏进阶：

• 打基础：把 GPIO 输入输出、串口打印、PWM、ADC 这几样基本功过一遍，做几个小实验练手。
• 拼功能：把 WiFi 和传感器组合起来，做一个"温湿度定时上报"的小项目，走通数据链路的全流程。
• 上难度：引入 FreeRTOS 多任务、低功耗设计，做电池供电、能长时间独立运行的设备。
• 玩深度：研究 MQTT/HTTP/WebSocket 协议，参与开源项目，甚至给 arduino-esp32 提交自己的改进。

官方资料都摊开在项目里：完整的 API 文档在 docs/en/ 目录，各功能模块的示例代码在 libraries/ 下的每个子目录里，照着读、照着抄、改着玩，就是最快的成长方式。想要最新源码，可以直接克隆仓库到本地慢慢研究：

git clone https://gitcode.com/GitHub_Trending/ar/arduino-esp32

每个玩物联网的人，都是从第一颗闪起来的 LED 开始的。今天你已经点亮了它，接下来的路就是不断加传感器、加功能、加想法。把文章里这段最小闭环跑通，再把你自己的第一个小设备做出来，你会发现：原来"物联网"离你只有一块板子加一个下午的距离。现在就打开 IDE 试试吧 🚀

【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32