ESP32触摸传感实操:touchRead做触控按键

2026-11-17 20:31:41 14阅读 所属项目:ESP32 开发板

ESP32 触摸引脚高亮 pinout 图

给项目加个"触摸开关",很多人的第一反应是去买 TTP223 这类电容触摸模块。其实 ESP32 芯片内部就带了 10 路电容触摸传感器,和 GPIO 直接复用,一根杜邦线、一小片锡箔就能当按键,硬件成本为零。Random Nerd Tutorials 的 ESP32 Touch Pins 教程把这条路径走得很完整,本篇照它的骨架整理成中文实操记录。

整体分三步走:先认引脚,再用 touchRead() 读原始值,然后标定阈值,最后做出"摸一下锡箔、LED 点亮"的小电路。代码全部来自库自带例程,逐字符照抄即可复现。

触摸引脚在哪:T0 到 T9 对应 GPIO

ESP32 的触摸传感器编号是 T0 到 T9 共 10 路,和普通 GPIO 复用。对照源文的引脚高亮图与官方 pinout,对应关系如下表,接线前先把要用的脚在这张表上找出来。

触摸编号GPIO触摸编号GPIO
T0GPIO4T5GPIO12
T1GPIO0T6GPIO14
T2GPIO2T7GPIO27
T3GPIO15T8GPIO33
T4GPIO13T9GPIO32

有两处要留神。其一,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 插一根杜邦线,手指捏住线头的金属部分,读数会明显往下掉——触摸时数值下降,这个趋势就是后面判断按没按的依据。

ESP32 GPIO4 接杜邦线做触摸测试

注意这串读数是未校准的原始值,不同板子的绝对值不一样,别去纠结别人为什么是 70 你是 90,要看的是变化趋势。觉得数字刷屏不直观,关掉串口监视器,换 Tools > Serial Plotter 看曲线,手指按下去的下降尖峰会画得很清楚。

第二步:锡箔贴片标定阈值

裸线头面积太小,摸起来不方便,实际做按键一般会贴一块电极。剪一小片铝箔包在杜邦线头外面就行,触摸面积变大,触发也更稳。

GPIO4 锡箔贴片与串口读数下降

接下来标定阈值,这一步别偷懒——读数跟环境、电极大小都有关,直接搬别人的阈值不一定适用。标法很简单:先空载跑着代码记下平时的读数,再手指按上去记按压时的读数。源文实测是空载 70 以上、按压掉到 10 以下,中间隔得很开,于是阈值取 20。

你换板子、换电极以后,空载值和按压值都会变,照这个流程重测一遍再定阈值。阈值卡在两个值之间偏下的位置,留出余量防误触。

第三步:接 LED,摸一下就亮

器件清单:ESP32 DOIT DEVKIT V1 一块、5mm LED 一颗、330 欧姆电阻一颗、面包板和杜邦线若干。LED 正极经电阻接 GPIO16,负极接 GND;触摸端还是 GPIO4 上那片锡箔。接线照下面的示意图来:

ESP32 触摸点灯接线图 GPIO4 触摸 GPIO16 接 LED

完整代码如下,只有阈值那一行需要按自己的标定值改:

// 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 加阈值判断是最简触控按键;想做成触摸开关灯,就加一个状态翻转;想区分短按长按,就记按下时长。先把例程跑通再改,比从零写省事得多。


作者:固件烧录仔
链接:https://www.aiddithome.com/p/af1793091c0e2.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
锡点
1楼 · 6小时前

这个 touchRead 的玩法我早就在别的板子上眼馋过,没想到 ESP32 把电容触摸直接做到了片上,10 路引脚复用,连模块都省了。按这篇的思路标阈值那段最实在——空载 70 往上、按压掉到 10 以下,两个值隔得够开,阈值取中间偏下才好卡。我以前用 TTP223 模块调灵敏度电位器调到怀疑人生,片上方案直接串口看原始值,心里有底多了。回头剪片锡箔贴到外壳内侧,做个隐藏式触控灯开关正合适。

探头看一眼
2楼 · 6小时前

T8、T9 映射反那个坑我踩过,接的 GPIO32 死活没反应,最后发现得写 T8,白查了一晚上才定位到内核版本。

刷着刷着入坑了
3楼 · 6小时前

串口绘图仪看曲线那段好,调阈值本来就该看趋势,不是盯着绝对值较劲。

隔壁工位的好奇宝
4楼 · 6小时前

锡箔加杜邦线就能当电极,成本基本忽略不计,学生党做课程设计正好用得上。