ESP32 芯片有 48 个引脚，具有多种功能。并非所有 ESP32 开发板中的所有引脚都暴露出来，有些引脚无法使用。

关于如何使用 ESP32 GPIO 有很多问题。您应该使用什么引脚？您应该避免在项目中使用哪些引脚？这篇文章旨在成为 ESP32 GPIO 的简单易懂的参考指南。

下图显示了 ESP-WROOM-32 引脚排列。如果您使用ESP32 裸芯片构建定制板，可以将其用作参考：

注意：并非所有开发板都可以访问所有 GPIO，但无论您使用哪种开发板，每个特定 GPIO 都以相同的方式工作。如果您刚刚开始使用 ESP32，我们建议您阅读我们的指南：ESP32 开发板入门。

ESP32 外设

ESP32 外设包括：

18 个模数转换器 (ADC) 通道
3个SPI接口
3个UART接口
2个I2C接口
16个PWM输出通道
2 个数模转换器 (DAC)
2个I2S接口
10 个电容感应 GPIO

ADC（模数转换器）和DAC（数模转换器）功能被分配给特定的静态引脚。但是，您可以决定哪些引脚是 UART、I2C、SPI、PWM 等 - 您只需在代码中分配它们即可。由于 ESP32 芯片的多路复用功能，这是可能的。

虽然您可以在软件上定义引脚属性，但默认分配的引脚如下图所示（这是具有36 个引脚的ESP32 DEVKIT V1 DOIT 板的示例- 引脚位置可能会根据制造商而变化）。

 

此外，还有一些具有特定功能的引脚，这些功能使其适合或不适合特定项目。下表显示了哪些引脚最适合用作输入、输出以及哪些引脚需要小心。

以绿色突出显示的引脚可以使用。以黄色突出显示的可以使用，但您需要注意，因为它们可能主要在启动时出现意外行为。不建议将红色突出显示的引脚用作输入或输出。

GPIO	Input	Output	Notes
0	pulled up	OK	outputs PWM signal at boot, must be LOW to enter flashing mode
1	TX pin	OK	debug output at boot
2	OK	OK	connected to on-board LED, must be left floating or LOW to enter flashing mode
3	OK	RX pin	HIGH at boot
4	OK	OK
5	OK	OK	outputs PWM signal at boot, strapping pin
6	x	x	connected to the integrated SPI flash
7	x	x	connected to the integrated SPI flash
8	x	x	connected to the integrated SPI flash
9	x	x	connected to the integrated SPI flash
10	x	x	connected to the integrated SPI flash
11	x	x	connected to the integrated SPI flash
12	OK	OK	boot fails if pulled high, strapping pin
13	OK	OK
14	OK	OK	outputs PWM signal at boot
15	OK	OK	outputs PWM signal at boot, strapping pin
16	OK	OK
17	OK	OK
18	OK	OK
19	OK	OK
21	OK	OK
22	OK	OK
23	OK	OK
25	OK	OK
26	OK	OK
27	OK	OK
32	OK	OK
33	OK	OK
34	OK		input only
35	OK		input only
36	OK		input only
39	OK		input only

继续阅读有关 ESP32 GPIO 及其功能的更详细和深入的分析。

仅输入引脚

GPIO 34 至 39 是 GPI – 仅输入引脚。这些引脚没有内部上拉或下拉电阻。它们不能用作输出，因此只能将这些引脚用作输入：

• 通用输入输出口34
• 通用输入输出口35
• 通用输入输出口36
• 通用输入输出口39

ESP-WROOM-32 上集成的 SPI 闪存

某些 ESP32 开发板中暴露了 GPIO 6 至 GPIO 11。不过，这些引脚连接到 ESP-WROOM-32 芯片上的集成 SPI Flash，不建议用于其他用途。因此，不要在您的项目中使用这些引脚：

• GPIO 6（SCK/CLK）
• GPIO 7（SDO/SD0）
• GPIO 8（SDI/SD1）
• GPIO 9 (SHD/SD2)
• GPIO 10（SWP/SD3）
• GPIO 11（CSC/CMD）

电容式触摸 GPIO

ESP32 有 10 个内部电容式触摸传感器。它们可以感知任何带有电荷的物体的变化，比如人类皮肤。因此，他们可以检测用手指触摸 GPIO 时引起的变化。这些引脚可以轻松集成到电容垫中并取代机械按钮。电容式触摸引脚还可用于将ESP32 从深度睡眠中唤醒。

这些内部触摸传感器连接到这些 GPIO：

• T0（GPIO 4）
• T1（GPIO 0）
• T2（GPIO 2）
• T3（GPIO 15）
• T4（GPIO 13）
• T5（GPIO 12）
• T6（GPIO 14）
• T7（GPIO 27）
• T8（GPIO 33）
• T9（GPIO 32）

 

模数转换器 (ADC)

ESP32 具有 18 x 12 位 ADC 输入通道（而ESP8266 只有 1x 10 位 ADC）。这些是可用作 ADC 的 GPIO 和各自的通道：

• ADC1_CH0（GPIO 36）
• ADC1_CH1（GPIO 37）
• ADC1_CH2（GPIO 38）
• ADC1_CH3（GPIO 39）
• ADC1_CH4（GPIO 32）
• ADC1_CH5（GPIO 33）
• ADC1_CH6（GPIO 34）
• ADC1_CH7（GPIO 35）
• ADC2_CH0（GPIO 4）
• ADC2_CH1（GPIO 0）
• ADC2_CH2（GPIO 2）
• ADC2_CH3（GPIO 15）
• ADC2_CH4（GPIO 13）
• ADC2_CH5（GPIO 12）
• ADC2_CH6（GPIO 14）
• ADC2_CH7（GPIO 27）
• ADC2_CH8（GPIO 25）
• ADC2_CH9（GPIO 26）

注意：使用 Wi-Fi 时不能使用 ADC2 引脚。因此，如果您使用 Wi-Fi 并且无法从 ADC2 GPIO 获取值，则可以考虑改用 ADC1 GPIO。那应该可以解决你的问题。

ADC 输入通道具有 12 位分辨率。这意味着您可以获得范围从0到4095的模拟读数，其中0对应0V，4095对应3.3V。您还可以在代码和 ADC 范围上设置通道分辨率。

ESP32 ADC 引脚不具有线性行为。您可能无法区分 0 和 0.1V，或 3.2 和 3.3V。使用 ADC 引脚时需要记住这一点。您将得到类似于下图所示的行为。

数模转换器 (DAC)

ESP32 上有 2 x 8 位 DAC 通道，用于将数字信号转换为模拟电压信号输出。这些是 DAC 通道：

• DAC1（GPIO25）
• DAC2（GPIO26）

RTC GPIO

ESP32 上有 RTC GPIO 支持。当 ESP32 处于深度睡眠状态时，可以使用路由到 RTC 低功耗子系统的 GPIO。当超低功耗 (ULP) 协处理器运行时，这些 RTC GPIO 可用于将 ESP32 从深度睡眠状态唤醒。以下 GPIO 可用作外部唤醒源.

• RTC_GPIO0 (GPIO36)
• RTC_GPIO3（GPIO39）
• RTC_GPIO4（GPIO34）
• RTC_GPIO5（GPIO35）
• RTC_GPIO6 (GPIO25)
• RTC_GPIO7 (GPIO26)
• RTC_GPIO8 (GPIO33)
• RTC_GPIO9（GPIO32）
• RTC_GPIO10（GPIO4）
• RTC_GPIO11（GPIO0）
• RTC_GPIO12（GPIO2）
• RTC_GPIO13（GPIO15）
• RTC_GPIO14（GPIO13）
• RTC_GPIO15（GPIO12）
• RTC_GPIO16（GPIO14）
• RTC_GPIO17 (GPIO27)

脉宽调制

ESP32 LED PWM 控制器具有 16 个独立通道，可配置为生成具有不同属性的 PWM 信号。所有可用作输出的引脚均可用作 PWM 引脚（GPIO 34 至 39 不能生成 PWM）。

要设置 PWM 信号，您需要在代码中定义这些参数：

• 信号的频率；
• 占空比;
• 脉宽调制通道；
• 您要输出信号的 GPIO。

I2C

ESP32 有两个 I2C 通道，任何引脚都可以设置为 SDA 或 SCL。当将 ESP32 与 Arduino IDE 结合使用时，默认的 I2C 引脚为：

• GPIO 21（SDA）
• GPIO 22（SCL）

如果在使用wire库时想使用其他引脚，只需调用：

Wire.begin(SDA, SCL);

SPI

默认情况下，SPI 的引脚映射为：

SPI	莫西	味噌	时钟脉冲	CS
VSPI	通用输入输出口23	通用输入输出口19	通用输入输出口18	通用输入输出口5
HSPI	通用输入输出口13	通用输入输出口12	通用输入输出口14	通用输入输出口15

 

中断

所有 GPIO 均可配置为中断。

捆扎别针

ESP32 芯片有以下捆扎引脚：

• GPIO 0（必须为低电平才能进入启动模式）
• GPIO 2（启动期间必须悬空或为低电平）
• 通用输入输出口4
• GPIO 5（启动期间必须为高电平）
• GPIO 12（启动期间必须为低电平）
• GPIO 15（启动期间必须为高电平）

这些用于将 ESP32 置于引导加载程序或闪存模式。在大多数内置 USB/串口的开发板上，您无需担心这些引脚的状态。该板将引脚置于正确的状态以进行闪烁或启动模式。

但是，如果您有外设连接到这些引脚，则在尝试上传新代码、使用新固件刷新 ESP32 或重置开发板时可能会遇到困难。如果您有一些外设连接到捆绑引脚，并且您在上传代码或刷新 ESP32 时遇到问题，可能是因为这些外设阻止了 ESP32 进入正确的模式。

启动时引脚为高电平

一些 GPIO 在启动或复位时将其状态更改为高电平或输出 PWM 信号。这意味着，如果您有连接到这些 GPIO 的输出，则当 ESP32 重置或启动时，您可能会得到意外的结果。

• 通用输入输出口1
• 通用输入输出口3
• 通用输入输出口5
• GPIO 6 至 GPIO 11（连接至 ESP32 集成 SPI 闪存 – 不建议使用）。
• 通用输入输出口14
• 通用输入输出口15

启用（EN）

使能 (EN) 是 3.3V 稳压器的使能引脚。它被拉高，因此连接到地以禁用 3.3V 稳压器。例如，这意味着您可以使用连接到按钮的该引脚来重新启动 ESP32。

GPIO 电流消耗

根据 ESP32 数据表中的“推荐工作条件”部分，每个 GPIO 消耗的绝对最大电流为 40mA。

ESP32 内置霍尔效应传感器

ESP32 还具有内置霍尔效应传感器，可检测周围磁场的变化。