fOIl12Cm6 – ESP32

如果你刚拿到一块 ESP32 开发板，却不知道从哪里开始，这篇教程就是为你准备的。本文将用最通俗的语言，带你认识 ESP32、搭建开发环境、点亮第一盏灯，并完成 GPIO 和 Wi-Fi 入门实验。读完之后，你就能独立动手做自己的物联网小项目了。

一、ESP32 是什么，适合做什么项目

ESP32 是乐鑫科技推出的一款低成本、低功耗的微控制器芯片，常被做成开发板，例如 ESP32-DevKitC、ESP32-WROOM-32 开发板等。它把处理器、Wi-Fi、蓝牙和丰富的外设集成在一颗芯片里，只需一根 USB 数据线，就能开始编程和联网。

ESP32 非常适合以下项目：智能家居开关、温湿度监测、环境数据采集、远程浇花、门禁提醒、天气预报屏、智能小车、蓝牙遥控、简易 Web 控制面板，以及各种物联网原型验证。只要项目需要联网、采集传感器数据或控制外设，ESP32 往往都是性价比很高的选择。

二、主要特性与参数简介

不同型号的 ESP32 参数略有差异，下面以常见的 ESP32 双核版本为例介绍：

处理器：双核 Tensilica Xtensa LX6，主频最高约 240MHz，两个核心可以分工处理任务。
无线连接：内置 2.4GHz Wi-Fi，支持 Station、AP 以及 AP+Station 模式；同时支持经典蓝牙和低功耗蓝牙 BLE。
GPIO：通用输入输出引脚丰富，多数开发板引出 30 个左右引脚，可用于按键、LED、继电器、传感器等。
ADC 与 DAC：内置多路 12 位 ADC，可读取模拟电压，例如光敏电阻、滑动变阻器；部分型号还提供 DAC 输出。
其他外设：支持 UART、SPI、I2C、PWM、触摸传感、定时器和看门狗等。
存储与供电：通常板载 4MB 闪存，工作电压 3.3V，通过 USB 供电，开发板上一般自带稳压和 USB 转串口芯片。

需要注意：ESP32 的 GPIO 是 3.3V 逻辑电平，不能直接接入 5V 信号，否则可能损坏芯片。接线前请先查阅所用开发板的引脚图。

三、开发环境搭建：以 Arduino IDE 为主

Arduino IDE 上手简单、例程丰富，是初学者的首选。下面是安装 ESP32 开发板支持包的步骤：

下载并安装 Arduino IDE，建议使用较新的 2.x 版本。
用 USB 数据线连接 ESP32 开发板和电脑，安装 USB 转串口驱动。常见的芯片是 CP2102 或 CH340，驱动不对时电脑可能认不出端口。
打开 Arduino IDE，依次点击“文件 > 首选项”，在“附加开发板管理器网址”中添加 ESP32 的开发板管理器地址：https://espressif.github.io/arduino-esp32/package_esp32_index.json
依次点击“工具 > 开发板 > 开发板管理器”，搜索 ESP32，安装 esp32 开发板支持包。
依次点击“工具 > 开发板”，选择与你手头开发板对应的型号，例如 ESP32 Dev Module。
在“工具 > 端口”中选择开发板对应的串口，Windows 下一般显示为 COM 口，macOS 或 Linux 下一般显示为 /dev/ttyUSB 或 /dev/cu 开头的设备。

安装完成后，打开“文件 > 示例 > 01.Basics > Blink”测试一下，如果能编译，说明环境基本就绪。

四、第一个程序：点亮板载 LED（Blink）

几乎所有单片机教程的第一个程序都是 Blink：让 LED 一亮一灭地闪烁。很多 ESP32 开发板的板载 LED 接在 GPIO 2 上，如果你的板子不同，请先查看引脚图，把数字 2 改成实际引脚。

// 点亮板载 LED：LED 每隔 1 秒亮灭一次
void setup() {
  pinMode(2, OUTPUT); // 把 GPIO 2 设置为输出模式
}
void loop() {
  digitalWrite(2, HIGH); // 输出高电平，点亮 LED
  delay(1000); // 延时 1000 毫秒，即 1 秒
  digitalWrite(2, LOW); // 输出低电平，熄灭 LED
  delay(1000); // 再延时 1 秒
}

逐行讲解：setup() 只在上电或复位后运行一次，适合做初始化；pinMode(2, OUTPUT) 把引脚设为输出；loop() 会不断重复运行；digitalWrite(2, HIGH) 输出高电平点亮 LED，LOW 则熄灭；delay(1000) 让程序暂停 1 秒。点击上传后，如果 LED 开始有规律地闪烁，恭喜你，第一个程序成功了。

五、GPIO 数字输入输出入门示例

学会输出之后，再学输入就很自然了。下面用一个按键控制 LED：按键按下时点亮 LED，松开时熄灭。接线方法是：按键一端接 GPIO 15，另一端接 GND，并利用芯片内部上拉电阻，这样不用外接电阻也能稳定读取。

// 按键控制 LED：按下点亮，松开熄灭
const int ledPin = 2;
const int buttonPin = 15;
void setup() {
  pinMode(ledPin, OUTPUT);
  pinMode(buttonPin, INPUT_PULLUP);
}
void loop() {
  int state = digitalRead(buttonPin);
  if (state == LOW) {
    digitalWrite(ledPin, HIGH);
  } else {
    digitalWrite(ledPin, LOW);
  }
}

这个例子说明了 GPIO 的两个基本用法：digitalWrite() 输出高低电平，digitalRead() 读取高低电平。掌握这两个函数，你就可以控制继电器、蜂鸣器，读取按键、人体红外传感器等数字信号了。

六、Wi-Fi 入门示例：连接 Wi-Fi 并输出 IP 地址

ESP32 最大的优势之一就是自带 Wi-Fi。下面这个程序会连接你家的 Wi-Fi，并在串口监视器中打印出开发板获得的 IP 地址。请把代码中的 Wi-Fi 名称和密码换成你自己的，上传后把串口监视器波特率设为 115200 查看结果。

#include <WiFi.h>
const char* ssid = "你的WiFi名称";
const char* password = "你的WiFi密码";
void setup() {
  Serial.begin(115200);
  WiFi.begin(ssid, password);
  Serial.print("正在连接 Wi-Fi");
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  Serial.println();
  Serial.println("Wi-Fi 已连接！");
  Serial.print("IP 地址：");
  Serial.println(WiFi.localIP());
}
void loop() {
}

拿到 IP 地址后，你就迈出了物联网的第一步。接下来可以尝试把这个 IP 输入浏览器，配合 Web Server 例子做一个网页开关；也可以把温湿度数据上传到云平台，在手机上远程查看。

七、常见问题与排错

电脑认不出开发板：先换一根能传数据的 USB 线，再检查 CP2102 或 CH340 驱动是否安装成功，设备管理器或系统报告里应能看到串口设备。
端口选错：上传前确认“工具 > 端口”选的是 ESP32 的串口，而不是蓝牙串口或其他设备；插拔开发板后端口列表会变化，可以对照确认。
上传失败、提示连接超时：部分开发板上传时需要按住 BOOT 键，看到开始上传后再松开；也可以尝试降低上传速度，或先按一下开发板上的复位键 EN。
程序上传成功但没有反应：检查引脚号是否与开发板实际接线一致，板载 LED 不一定都在 GPIO 2 上；同时确认串口监视器波特率与 Serial.begin() 一致。
Wi-Fi 连不上：确认 Wi-Fi 是 2.4GHz 频段，ESP32 不支持 5GHz；检查名称和密码是否有空格或中文标点；路由器离开发板不要太远。
引脚不能用：有些引脚在启动时有特殊用途，例如 GPIO 0、2、12、15 等，接线时应优先查阅引脚图，避开启动相关的限制。

八、进阶学习方向

掌握 Blink、GPIO 和 Wi-Fi 之后，可以按兴趣继续深入：

MQTT：用 MQTT 协议把 ESP32 接入 Home Assistant、云平台或手机 App，实现远程控制和消息推送。
Web Server：在 ESP32 上搭建简易网页服务器，用手机浏览器开关灯、查看传感器数据。
传感器：接入 DHT11、DHT22、DS18B20、光敏电阻、超声波测距等传感器，做温湿度计、环境监测站。
ESP-IDF：乐鑫官方开发框架，功能更强大、更接近底层，适合想深入学习 FreeRTOS、多任务和系统开发的读者。

建议的学习路线是：先把每个小例子亲手跑通，再把它们组合起来，例如“按键 + LED + Wi-Fi + 传感器”做成一个完整的小项目。遇到问题时，先看串口打印，再查官方文档和例程，大多数问题都能一步步定位解决。祝你玩得开心，做出属于自己的第一个 ESP32 作品！

作者： fOIl12Cm6

ESP32 开发板入门教程