
给项目加个"触摸开关",很多人的第一反应是去买 TTP223 这类电容触摸模块。其实 ESP32 芯片内部就带了 10 路电容触摸传感器,和 GPIO 直接复用,一根杜邦线、一小片锡箔就能当按键,硬件成本为零。Random Nerd Tutorials 的 ESP32 Touch Pins 教程把这条路径走得很完整,本篇照它的骨架整理成中文实操记录。
整体分三步走:先认引脚,再用 touchRead() 读原始值,然后标定阈值,最后做出"摸一下锡箔、LED 点亮"的小电路。代码全部来自库自带例程,逐字符照抄即可复现。
触摸引脚在哪:T0 到 T9 对应 GPIO
ESP32 的触摸传感器编号是 T0 到 T9 共 10 路,和普通 GPIO 复用。对照源文的引脚高亮图与官方 pinout,对应关系如下表,接线前先把要用的脚在这张表上找出来。
| 触摸编号 | GPIO | 触摸编号 | GPIO |
|---|---|---|---|
| T0 | GPIO4 | T5 | GPIO12 |
| T1 | GPIO0 | T6 | GPIO14 |
| T2 | GPIO2 | T7 | GPIO27 |
| T3 | GPIO15 | T8 | GPIO33 |
| T4 | GPIO13 | T9 | GPIO32 |
有两处要留神。其一,T1 对应 GPIO0,源文用的 30 引脚 DOIT DEVKIT V1 板把这个脚省掉了,36 引脚版才有;其二,写代码时传触摸编号(T0)和 GPIO 编号(4)都可以,touchRead() 两种写法都认。
顺带说下原理:这类脚测的是电容变化,任何能存电荷的东西靠近都会让读数漂移,人体皮肤的效果最明显。所以裸引脚、杜邦线头、锡箔贴片都能当电极用,这也是它顶替机械按键的底气。
第一步:touchRead 读出原始值
前提是 Arduino IDE 里已经装好 ESP32 板卡支持包,安装方法官方另有专文,这里不展开。装好后在 File > Examples > ESP32 > Touch 里打开 TouchRead 例程,代码如下:
// ESP32 Touch Test
// Just test touch pin - Touch0 is T0 which is on GPIO 4.
void setup() {
Serial.begin(115200);
delay(1000); // give me time to bring up serial monitor
Serial.println("ESP32 Touch Test");
}
void loop() {
Serial.println(touchRead(4)); // get value of Touch 0 pin = GPIO 4
delay(1000);
}选对板型和 COM 口上传,串口监视器开到 115200 波特率,每秒会刷出一个读数。往 GPIO4 插一根杜邦线,手指捏住线头的金属部分,读数会明显往下掉——触摸时数值下降,这个趋势就是后面判断按没按的依据。

注意这串读数是未校准的原始值,不同板子的绝对值不一样,别去纠结别人为什么是 70 你是 90,要看的是变化趋势。觉得数字刷屏不直观,关掉串口监视器,换 Tools > Serial Plotter 看曲线,手指按下去的下降尖峰会画得很清楚。
第二步:锡箔贴片标定阈值
裸线头面积太小,摸起来不方便,实际做按键一般会贴一块电极。剪一小片铝箔包在杜邦线头外面就行,触摸面积变大,触发也更稳。

接下来标定阈值,这一步别偷懒——读数跟环境、电极大小都有关,直接搬别人的阈值不一定适用。标法很简单:先空载跑着代码记下平时的读数,再手指按上去记按压时的读数。源文实测是空载 70 以上、按压掉到 10 以下,中间隔得很开,于是阈值取 20。
你换板子、换电极以后,空载值和按压值都会变,照这个流程重测一遍再定阈值。阈值卡在两个值之间偏下的位置,留出余量防误触。
第三步:接 LED,摸一下就亮
器件清单:ESP32 DOIT DEVKIT V1 一块、5mm LED 一颗、330 欧姆电阻一颗、面包板和杜邦线若干。LED 正极经电阻接 GPIO16,负极接 GND;触摸端还是 GPIO4 上那片锡箔。接线照下面的示意图来:

完整代码如下,只有阈值那一行需要按自己的标定值改:
// set pin numbers
const int touchPin = 4;
const int ledPin = 16;
// change with your threshold value
const int threshold = 20;
// variable for storing the touch pin value
int touchValue;
void setup(){
Serial.begin(115200);
delay(1000); // give me time to bring up serial monitor
// initialize the LED pin as an output:
pinMode (ledPin, OUTPUT);
}
void loop(){
// read the state of the pushbutton value:
touchValue = touchRead(touchPin);
Serial.print(touchValue);
// check if the touchValue is below the threshold
// if it is, set ledPin to HIGH
if(touchValue < threshold){
// turn LED on
digitalWrite(ledPin, HIGH);
Serial.println(" - LED on");
}
else{
// turn LED off
digitalWrite(ledPin, LOW);
Serial.println(" - LED off");
}
delay(500);
}逻辑一句话:touchRead 的读数低于阈值就拉高 GPIO16,串口尾巴跟着打 " - LED on" 和 " - LED off"。delay(500) 顺带做了软件消抖,防止读数在阈值附近来回横跳,把 LED 闪成频闪灯。
容易翻车的几个点
一是老版本 arduino-esp32 内核里 T8、T9 的引脚映射是反的:想用 GPIO32 得写 T8,想用 GPIO33 得写 T9,源文明确提过这个坑。烧录前先确认板卡包版本,遇到"明明接的 32 脚、触摸却没反应",先查这里。
二是引脚规划。T0 到 T9 都是复用脚,一旦被安排去做 SPI、I2C 之类的负载,这路触摸就废了。画 PCB 或者做引脚分配时,先把触摸需求排进去。
三是电极别贪大。引线太长、锡箔面积太大,空载读数会整体下漂,阈值就卡不准了。从小贴片起步,边加面积边看串口读数,够用就好。
四是走线环境。触摸脚旁边有电源线、高频信号线经过,读数会跟着抖,布线时尽量让电极离这些线远一点。
顺带一提,这 10 路触摸还能作为 ESP32 深睡眠的唤醒源,属于另一个话题,这篇不展开。
收个尾
整套下来,硬件成本就是一根杜邦线加一片锡箔,代码是库里现成的。touchRead 加阈值判断是最简触控按键;想做成触摸开关灯,就加一个状态翻转;想区分短按长按,就记按下时长。先把例程跑通再改,比从零写省事得多。











这个 touchRead 的玩法我早就在别的板子上眼馋过,没想到 ESP32 把电容触摸直接做到了片上,10 路引脚复用,连模块都省了。按这篇的思路标阈值那段最实在——空载 70 往上、按压掉到 10 以下,两个值隔得够开,阈值取中间偏下才好卡。我以前用 TTP223 模块调灵敏度电位器调到怀疑人生,片上方案直接串口看原始值,心里有底多了。回头剪片锡箔贴到外壳内侧,做个隐藏式触控灯开关正合适。
T8、T9 映射反那个坑我踩过,接的 GPIO32 死活没反应,最后发现得写 T8,白查了一晚上才定位到内核版本。
串口绘图仪看曲线那段好,调阈值本来就该看趋势,不是盯着绝对值较劲。
锡箔加杜邦线就能当电极,成本基本忽略不计,学生党做课程设计正好用得上。