快速答案:WEMOS D1 R32 是一块 Arduino Uno 外形的 ESP32 开发板(用的是 ESP32-WROOM-32 模块)。它的引脚是 3.3V 的,所以不能直接当 Uno 用。
- 用能传数据的 micro-USB 线。找不到端口?装 CH340 驱动。
- 在 Arduino IDE 安装“esp32 by Espressif Systems”,再选 Tools > Board > esp32 > WEMOS D1 R32。
- 上排插座旁边印的编号(IO26、IO18)就是代码里要写的 GPIO 编号。板载蓝色 LED 是 IO2。
- 开着 WiFi 时,只有 Uno 的 A2 到 A5 插座(IO35、IO34、IO36 和 IO39)能读模拟值。
- 任何引脚都不能接 5V。装扩展板之前,先对照下面的表格检查。
需要的零件
如果学校或 FYP 实验室已经有 Uno 的外壳和扩展板(shield),就选 WEMOS D1 R32,它的插座和这些配件对得上。要在面包板上搭电路的话,30 针 ESP32 DevKit 更合适(ESP32 型号怎么选)。
零件清单:WEMOS D1 R32 第一次上传
Parts list
外接 LED 测试用。电阻包里任何 220 到 330 欧姆的电阻都可以。
板子不附 USB 线,所以清单里加了一条 micro-USB 数据线。板上的排座是母座,公对公杜邦线可以直接插到面包板上。
第 1 步:插上电脑,找到 CH340 端口
WEMOS D1 R32 靠一颗 CH340 USB 转串口芯片和电脑通信。插上线后,红色电源灯会亮,Tools > Port 里会多出一个新端口(Windows 上是 COM 加数字,Mac 上是 /dev/cu. 开头的名称)。
没有新端口?只能充电的线里没有数据线芯,板子会亮,但电脑永远看不到它。线没问题的话,就是缺了 CH340 驱动:Windows 用户到 WCH 的驱动下载页安装,然后重新插线(较新的 macOS 已经内置驱动)。我们的 ESP32 无法识别教程两种情况都有讲。
第 2 步:在 Arduino IDE 选 WEMOS D1 R32,上传 Blink
- 在 Boards Manager(开发板管理器)安装 esp32 by Espressif Systems(Espressif 安装指南)。不是“Arduino ESP32 Boards”,那个只支持 Nano ESP32。
- 选 Tools > Board > esp32 > WEMOS D1 R32,再选你的端口。
- 贴上下面的代码,按 Upload。
// 开发板:Tools > Board > esp32 > WEMOS D1 R32
// 让板载蓝色 LED 闪烁,也可以让印着 IO26 的插座上的外接 LED 一起闪,
// 然后打印三个 Uno 式名称在这块板上代表什么。
const int EXT_LED = 26; // 印着 IO26 的插座(Uno 的 D2 位置)
void setup() {
Serial.begin(115200);
pinMode(LED_BUILTIN, OUTPUT); // 在这块板上 LED_BUILTIN 就是 GPIO2
pinMode(EXT_LED, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
digitalWrite(EXT_LED, HIGH);
delay(500);
digitalWrite(LED_BUILTIN, LOW);
digitalWrite(EXT_LED, LOW);
delay(500);
Serial.printf("D2 = GPIO%d, A0 = GPIO%d, LED_BUILTIN = GPIO%d\n", D2, A0, LED_BUILTIN);
}
不用按任何按钮。CH340 通过两颗晶体管控制 ESP32 的复位脚(EN)和 IO0,IDE 会自动让它进入下载模式。上传后蓝色 LED 应该会闪。打开 Serial Monitor(串口监视器),设成 115200 波特率,会看到 D2 = GPIO26, A0 = GPIO2, LED_BUILTIN = GPIO2。
可选的 LED 测试:红色 LED 压降约 2V,所以串 220 欧姆电阻时电流是 (3.3 − 2) ÷ 220,约 6mA。Espressif ESP32 数据手册写的引脚默认驱动能力是 20mA,6mA 远低于这个值。
| 从 | 接到 |
|---|---|
| 印着 IO26 的插座(上排,从天线那端数第三个) | 220 或 330 欧姆电阻的一只脚,电阻从电阻包里拿(色环怎么读) |
| 电阻的另一只脚,单独插在面包板的一排 | 红色 LED 的长脚(正极) |
| LED 的短脚(负极) | 上排印着 GND 的插座 |

WEMOS D1 R32 引脚图:Uno 位置对应 ESP32 GPIO
WEMOS D1 R32 的每个插座都有三个名字:Uno 上的位置(D2)、旁边印的标签(IO26),还有你在代码里写的名称。IO 编号就是 ESP32 本身的 GPIO 编号,不管选哪个开发板选项都能用:digitalWrite(26, HIGH)。
Uno 式名称就要看你选的开发板选项。每个选项会载入一个文件(pins_arduino.h),写明每个名称对应哪个 GPIO。Espressif 为 WEMOS D1 R32 写的这个文件定义了 D0 到 D13、A0 到 A5 和 LED_BUILTIN。如果选“ESP32 Dev Module”,上面的代码会编译出错,例如 'D2' was not declared in this scope,而且 A0 会变成 GPIO36,也就是这块板的 A4 位置。DevKit 教程用的都是纯 GPIO 编号,所以那些代码在这里也能跑。例外是用到 IO15、IO32 或 IO33 的代码,这几个脚在这块板上只是没焊排座的焊盘。

| Uno 位置 | ESP32 GPIO | 备注 |
|---|---|---|
| 上排 10 个插座,从复位按钮那端数起 | ||
| SCL | IO22 | I2C 时钟 |
| SDA | IO21 | I2C 数据 |
| AREF | RST | 这里是复位线,不是参考电压 |
| GND | GND | |
| D13 | IO18 | SPI SCK |
| D12 | IO19 | SPI MISO |
| D11 | IO23 | SPI MOSI |
| D10 | IO5 | SPI SS。复位时会被读取 |
| D9 | IO13 | |
| D8 | IO12 | 复位时会被读取:必须是低电平 |
| 上排 8 个插座,继续往天线方向 | ||
| D7 | IO14 | |
| D6 | IO27 | |
| D5 | IO16 | |
| D4 | IO17 | |
| D3 | IO25 | |
| D2 | IO26 | LED 测试用的就是这个 |
| D1 | TX (IO1) | USB 串口,和 CH340 共用 |
| D0 | RX (IO3) | USB 串口,和 CH340 共用 |
| 下排 8 个电源插座,从 DC 圆孔插座那端数起 | ||
| Uno 上没用到 | IO0 | 复位时会被读取:低电平就进入下载模式 |
| IOREF | 5V | 看扩展板表格 |
| RESET | RST | |
| 3.3V | 3V3 | |
| 5V | 5V | |
| GND | GND | |
| GND | GND | |
| VIN | VIN | |
| 下排 6 个模拟插座,继续往天线方向 | ||
| A0 | IO2 | 板载蓝色 LED。ADC2。复位时会被读取 |
| A1 | IO4 | ADC2 |
| A2 | IO35 | ADC1,只能输入。有些板子这里印的是 IO36 |
| A3 | IO34 | ADC1,只能输入 |
| A4 | IO36 | ADC1,只能输入。这里印 IO38 的话是印错了:模块根本没有 GPIO38 |
| A5 | IO39 | ADC1,只能输入 |
| 没有排座的焊盘 | ||
| 无 | IO15, IO33, IO32 | 备用引脚。IO32 和 IO33 属于 ADC1,焊上排针后可以当输入或输出 |
| 无 | SD2, SD3, CMD, CLK, SD0, SD1 | 接着模块的 flash 存储器。千万不要用 |
模拟这一排要按位置数。有些板子,还有一张到处被转载的引脚图,把 A2 标成 IO36、A4 标成 IO38,RIOT 的板子文档已经标明这是错的。
Uno 扩展板能用在 D1 R32 上吗?
扩展板插得进 WEMOS D1 R32 的插座,不代表就能用,因为插座背后的芯片不是 Uno 的芯片。
引脚是 3.3V 的。ESP32 数据手册规定,引脚输入最高只能比电源电压高 0.3V,也就是 3.6V。扩展板送来的 5V 比这个上限高出 1.4V,可能永久损坏芯片。
有些引脚在复位时会被读取。在你的程序开始跑之前,ESP32 会先读几个“strapping”(启动配置)引脚,决定怎么启动。IO12(D8 位置)决定 flash 存储器的供电:低电平给 3.3V,高电平给 1.8V。这个模块的 flash 需要 3.3V(Espressif 关于 GPIO12 的说明),芯片内部约 45k 的下拉电阻会把 IO12 拉低。可是扩展板如果在 D8 接了 10k 上拉到 3.3V,就会压过这个下拉:3.3 × 45 ÷ 55 等于 2.7V,高过芯片判定高电平的 2.48V(0.75 × 3.3V)。结果 flash 只拿到 1.8V,程序读不出来,板子看起来像坏了,要拔掉扩展板才会恢复。IO2(A0 位置)会影响上传:进入下载模式时,IO0 和 IO2 在复位那一刻都要是低电平,所以扩展板如果把 A0 拉高,每次上传都会失败。
模拟引脚分成两组。WiFi 驱动本身要用 ADC2 转换器(ESP-IDF ADC 说明),所以开着 WiFi 时,ADC2 的引脚(这里是 A0 和 A1)读不到数值。A2 到 A5 属于 ADC1,照样能读。不过 GPIO34 到 39 没有输出驱动,也没有上拉电阻(ESP-IDF GPIO 页面),只能当输入。
| 扩展板上要检查的 | 在 D1 R32 上会怎样 | 怎么处理 |
|---|---|---|
| 会升到 5V 的信号(5V 传感器的输出、上拉到 5V 的线) | 超过引脚 3.6V 的上限 | 单向输入板子的信号用分压:先串一个 10k,再从引脚接 20k(两个 10k 串联)到 GND。5V × 20 ÷ 30 等于 3.3V。I2C 这种双向线不能用分压:如果模块的数据手册允许,就改用 3V3 给它供电,这样它的上拉电阻就在 3.3V |
| 扩展板上用 5V 供电、接收板子信号的芯片 | 板子的高电平最多只有 3.3V。很多 5V CMOS 芯片要到电源电压的 70%,也就是 3.5V,才算高电平,所以 3.3V 不保证会被当成高电平 | 查芯片数据手册里的输入高电平电压(VIH)。它必须低于 2.64V,这是 ESP32 数据手册保证的最低高电平(0.8 × 3.3V) |
| 任何接到 AREF 的东西 | 这个插座在这块板上是 ESP32 的复位线。被拉低的话芯片会一直卡在复位,接 5V 又超过 3.6V 上限 | AREF 什么都不要接 |
| D8 上有上拉,或者一直是高电平的信号 | 复位时 IO12 是高电平,板子起不来 | D8 留空,不然就别装这块扩展板 |
| 任何会把 A0 拉高,或者驱动 D0 和 D1 的东西 | 上传失败:A0 为高会挡住下载模式,D0 和 D1 是上传本身要用的串口线 | 上传前先拔掉扩展板 |
| 用到 D10 | IO5 也会在复位时被读取,但数据手册只把它列为 SDIO 从机时序用 | 不用处理。它不影响启动和上传 |
| 接在 A0 或 A1 的模拟传感器 | 开着 WiFi 时读不到数值 | 把信号改接到 A2 到 A5 |
| 接在 A2 到 A5 的 LED、蜂鸣器或 I2C(Uno 的 A4 和 A5 也带 I2C,有些扩展板从那里取) | 只能输入的引脚什么都驱动不了,而 I2C 要两个引脚都能把线拉低 | I2C 改用 SDA 和 SCL 插座 |
| 按 IOREF 决定信号电压的扩展板 | Uno 用 IOREF 告诉扩展板自己的逻辑电压。这块板上那个插座接的是 5V,所以相信它的扩展板会把 5V 信号送进 3.3V 的引脚 | 装之前,用万用表量第二个电源插座到 GND 的电压(万用表怎么用)。读到 5V,就表示这块扩展板应该配 5V 的板子 |
| 读取模拟值的 Uno 代码 | Uno 在 5V 范围内给出 0 到 1023。ESP32 在约 3.1V 范围内给出 0 到 4095(Arduino-ESP32 ADC 文档) | 重新换算你的阈值,或者改用 analogReadMilliVolts() |
| 只为 AVR 板子写的库 | 直接写 Uno 寄存器(PORTB、TCCR1A)的代码,编译 ESP32 时会出错 | 选注明支持 ESP32 的库 |
如果扩展板一定要 5V 逻辑,那就换板子:用 Uno R3,同时需要 WiFi 的话就用 Uno R4 WiFi(三款板子对比)。
第 3 步:第一个 WiFi 程序
WEMOS D1 R32 的无线只支持 2.4GHz,看不到只有 5GHz 的网络。学校和大学的 WiFi 如果要输入用户名,或者会跳出登录页面,这个程序也连不上,因为它的 WiFi.begin(ssid, password) 只送出网络名称和一个密码。设成 2.4GHz 的手机热点是最方便的测试网络。iPhone 上要打开“最大兼容性”(Maximise Compatibility)开关。
// 选 "WEMOS D1 R32" 或 "ESP32 Dev Module" 都能用:代码里只用 GPIO 编号。
#include <WiFi.h>
const char* WIFI_SSID = "YourWiFiName"; // 2.4GHz 网络或手机热点
const char* WIFI_PASS = "YourWiFiPassword";
const int LED_PIN = 2; // 板载蓝色 LED(GPIO2,Uno 的 A0 位置)
const int SENSOR_PIN = 35; // Uno 的 A2 位置,属于 ADC1,所以开着 WiFi 也能读
void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
WiFi.mode(WIFI_STA); // station 模式:连上现有的网络
WiFi.begin(WIFI_SSID, WIFI_PASS);
Serial.print("Connecting");
while (WiFi.status() != WL_CONNECTED) {
digitalWrite(LED_PIN, !digitalRead(LED_PIN)); // 连接期间 LED 一直闪
delay(300);
Serial.print(".");
}
digitalWrite(LED_PIN, HIGH); // 连上后 LED 常亮
Serial.println();
Serial.print("Connected. IP address: ");
Serial.println(WiFi.localIP());
Serial.print("Signal (RSSI): ");
Serial.print(WiFi.RSSI());
Serial.println(" dBm");
}
void loop() {
Serial.print("IO35 reads ");
Serial.print(analogReadMilliVolts(SENSOR_PIN));
Serial.println(" mV");
delay(2000);
}
填上你的网络名称和密码,然后上传。连接时蓝色 LED 会一直闪,等 Serial Monitor 显示 IP 地址后就会常亮。如果一直打印点、停不下来,就是名称或密码错了,或者这个网络是板子的无线连不上的。接着 loop 会以毫伏为单位打印 IO35 的读数,这是开着 WiFi 时读 ADC1 引脚。什么都没接的时候,这个数会乱跳,因为引脚没有上拉电阻,是悬空的。用杜邦线把 A2(第三个模拟插座)接到 GND,读数就会掉到很低,证明 A2 就是 GPIO35。

离开电脑时,可以用 USB 充电器或充电宝给板子供电,也可以把我们的 9V 2A 电源适配器插进 DC 圆孔插座。这个插座后面接的是 5V 稳压器,所以输入电压要高过 5V。9V 在板子 5 到 12V 的额定范围内(Handson Technology 数据手册,DC 圆孔电源怎么选)。下一个项目:ESP32 网页控制继电器。
这块板上传失败怎么办
WEMOS D1 R32 没有可以按住的 BOOT 按钮。按顺序试下面几招。
- 拔掉所有扩展板和杜邦线,这样就排除了把 A0 拉高或驱动 D0、D1 的东西。
- 把 Tools > Upload Speed 从 921600 改成 115200。每个位的时间会长八倍,质量一般的线也传得过。
- 还是卡在“Connecting…”?那就手动进入下载模式。复位时 IO0 是低电平,芯片就会进入下载模式,而 IO0 是下排第一个插座,在 DC 圆孔插座那一端。先数两遍:从 IO0 数起,第二个和第五个插座是 5V,超过引脚 3.6V 的上限。用杜邦线把 IO0 接到 GND(第六或第七个插座),按一下复位,再按 Upload。完成后拔掉杜邦线,再按一下复位,不然板子会一直停在下载模式。
常见问题
WEMOS D1 R32 和 Arduino Uno 一样吗?
不一样。外形和插座位置相同,但芯片是带 WiFi 和蓝牙的 ESP32,引脚工作在 3.3V。装 5V 扩展板之前要先检查。
WEMOS D1 R32 有 BOOT 按钮吗?
没有,只有一个复位按钮。上传会靠 CH340 的自动复位电路自己开始。如果上传开始不了,就用杜邦线把 IO0 接到 GND,按一下复位再上传,然后拔掉杜邦线,再按一下复位。
WEMOS D1 R32 能用 5V 传感器吗?
可以。用 5V 插座给传感器供电,再把它的输出分压:先串一个 10k,再从引脚接两个串联的 10k 到 GND。这样 5V 就变成引脚能承受的 3.3V。
最后更新:2026 年 11 月。有问题?WhatsApp 联系我们。



WEMOS R32 Development Board ESP32 WiFi + Bluetooth Module Dual Core MCU Arduino Compatible
Data Cable Type-A Type-C MicroUSB Type-B 0.5m 1m 30cm 0.3m 100cm Data Transfer Upload Code - MicroUSB CABLE (1.0M)
MB102 Breadboard 170 400 830 Holes Breadboard Donut Board Arduino Prototype Multi Color - BREADBOARD (400 HOLES)
40pcs Dupont Wire 10cm 20cm 30cm for Breadboard DIY Experiment Jumper Wire Breadboard wire - DUPONT WIRE M-M 20CM
Round Head LED 3mm / 5mm / 8mm - Red/Yellow/Blue/Green/White - 5mm LED (RED)
400 pcs 1/4W Resistor Pack Resistor Kit 20 Common Value with 20 each