ESP32 实战教程：用 MCP23017 扩展 16 路 GPIO 并管理中断

本文按实际动手顺序整理。示例中的 GPIO、地址和参数需要根据手中的开发板、模块版本和负载规格调整；涉及市电、机械运动、大电流或人体数据时，必须把硬件保护和使用边界放在代码之前。

一、项目目标与应用场景

ESP32 的 GPIO 看起来不少，但屏幕、SPI、串口和启动绑带脚一占，真正能安心使用的引脚会迅速缩水。MCP23017 用一条 I2C 总线换来 16 路数字输入输出，还提供内部上拉、极性设置和中断捕获，适合按钮面板、继电器状态采集和大量指示灯。它不是单纯的“引脚变多器”，而是一个需要认真配置寄存器和中断策略的小型 IO 子系统。

这篇教程不把“模块亮了、串口有数字”当作终点，而是继续处理供电、边界条件、数据有效性和故障恢复。先跑通最小链路，再做标定与状态机，最后接入网页或自动控制，排错时会省下大量来回拆线的时间。

二、硬件准备与接线

准备 ESP32、MCP23017 模块、若干按键、LED 与限流电阻。SDA、SCL 接 I2C，总线保持合适上拉；A0～A2 决定设备地址，不能悬空。RESET 应保持确定电平。LED 电流受芯片单脚和总电流限制，不能把 16 路都当作大功率输出；继电器线圈仍需驱动管、续流二极管和独立电源。INTA 或 INTB 可接到 ESP32 的中断输入。

接线前断电，用万用表确认电源极性和电压。首次实验只接一个外设，保留串口日志；功能验证后再增加屏幕、网络和执行器。把开发板型号、GPIO、模块地址、供电来源与库版本写进实验记录，避免换板以后对着“默认引脚”四个字发呆。

三、工作原理

MCP23017 把 16 路分成 A、B 两个 8 位端口。IODIR 决定输入输出，GPPU 打开弱上拉，GPIO 读取当前电平，OLAT 保存输出锁存值。中断可以按电平变化或与默认值比较触发，INTCAP 会保存触发瞬间的端口快照。读取 GPIO 或 INTCAP 后中断条件被清除，因此中断服务程序只应通知任务，寄存器读取放在普通任务中完成。

建议把程序拆成驱动层、数据层、业务层和展示层。驱动层只负责与外设通信；数据层保存原始值、单位和有效状态；业务层执行阈值、限位与超时；展示层读取快照，不直接操纵硬件。这样网页断线或存储变慢时，核心控制仍能保持稳定。

四、首次验证与标定

先只连接一个 LED，验证输出高低与模块逻辑电平；再接一个按键，开启内部上拉并确认按下为低。随后扫描 I2C 地址，把 A0～A2 的实际状态写进实验表。最后接入 INT，连续快速按键，确认程序能读到捕获值且不会遗漏。多模块时逐块更换地址验证，避免所有板都保持默认地址。

标定时保存原始值，不要只留下一个最终系数。原始证据能帮助判断后来出现的偏差来自传感器、机械、电源还是算法。更换模块、安装位置、负载或外壳后，都应重新进行关键测试。

五、最小代码骨架

下面代码用于验证核心路径，不代表所有库版本都使用完全相同的接口。安装对应库后，先核对示例与当前 Arduino-ESP32 版本：

#include <Wire.h>
#include <Adafruit_MCP23X17.h>

Adafruit_MCP23X17 mcp;
volatile bool ioPending = false;
void IRAM_ATTR onMcpInt() { ioPending = true; }

void setup() {
  Serial.begin(115200);
  Wire.begin(21, 22);
  if (!mcp.begin_I2C(0x20)) while (true) delay(1000);
  mcp.pinMode(0, INPUT_PULLUP);
  mcp.pinMode(8, OUTPUT);
  mcp.setupInterruptPin(0, FALLING);
  pinMode(27, INPUT_PULLUP);
  attachInterrupt(27, onMcpInt, FALLING);
}

void loop() {
  if (!ioPending) return;
  ioPending = false;
  uint16_t state = mcp.readGPIOAB();
  mcp.digitalWrite(8, bitRead(state, 0) ? LOW : HIGH);
  Serial.printf("GPIO=0x%04X\n", state);
}

启动日志至少输出固件版本、初始化结果、关键参数和第一笔有效数据。失败时不要只写 error，应附上接口、地址或错误码。没有观测点的程序一旦罢工，开发者只能围着它进行气氛分析。

六、数据与状态设计

按键事件应包含端口位、变化方向、时间戳和去抖后的稳定状态。多个输入同时变化时，以整个 16 位快照比较前后差异，而不是只猜测某一个按键。输出则维护 shadow 值，批量写寄存器，避免逐脚更新时出现中间状态。

数据结构建议同时保留 raw、value、unit、valid、timestamp 和 error。显示层只消费快照，不能为了刷新页面主动触发一次耗时采样；控制输出也不能由网页直接越过状态机修改。

七、常见问题与排错

地址脚悬空、缺少上拉、LED 超流和在 ISR 中直接访问 I2C 是常见问题。INT 可以配置为开漏或推挽，极性也可改变，ESP32 输入模式必须匹配。总线卡死时不要无限重试，应记录超时并重新初始化；安全相关输出不能只依赖一颗扩展芯片。

排错顺序建议固定：先检查电源和公共地，再确认引脚、地址和通信参数；随后运行库自带最小示例，打印原始值；最后恢复滤波、页面和自动控制。每次只修改一个变量，并保留失败输出。偶然跑通不是定位问题，只是问题暂时去喝水了。

八、工程化与安全边界

把端口用途做成表格：方向、默认值、是否反相、去抖时间和安全态。开机先写安全输出，再开放控制。多任务项目通过单一 IO 服务管理 MCP23017，其他任务提交命令或订阅事件，避免同时读写寄存器。

配置保存到 NVS 时加入范围校验、默认值和版本迁移。网络请求设置超时与退避，日志限制容量并分级。执行器必须有最大持续时间、启动安全态和本地停止方式。软件重启不能成为唯一保护，关键风险应由硬件限流、保险、限位或隔离承担。

九、完整测试清单

冷启动、复位和断电恢复后，输出是否处于明确安全状态；
拔掉外设、接错地址、输入越界时，程序是否记录错误并继续运行；
连续运行两小时后，内存、温度、供电和通信错误是否稳定；
网络断开、浏览器关闭或服务器重启时，本地功能是否仍然可用；
阈值附近反复变化时，是否有迟滞、去抖或速率限制；
更换同型号模块后，校准与配置是否仍然适用；
故障解除后，系统是自动恢复、等待确认，还是进入安全锁定；
日志是否足以解释最后一次状态变化来自哪里。

测试不能只拍一张成功截图。至少要覆盖冷启动、连续运行、外设拔插、供电波动、输入越界、通信超时和网络中断。每次测试记录原始数据、处理结果、错误码、固件版本和接线变更。真正有价值的学习日志，不只是告诉读者成功时长什么样，也要告诉读者失败时先看哪里。

十、扩展方向

可做 16 键控制面板、机柜门状态采集、设备测试夹具或大量继电器反馈。多颗 MCP23017 通过地址脚共存时，还要计算总线负载和轮询周期；数量继续增长时，应考虑分布式节点而不是无限延长 I2C。

扩展时一次增加一层：新硬件先独立验证，新算法先离线检查，新网络功能先模拟断线。把每次成功与失败都写进记录，文章会从“接线说明”逐渐变成真正能复用的工程笔记。

十一、总结

这个项目的重点不只是调用一个库，而是建立从电气连接、原始数据、业务状态到异常恢复的完整链路。能运行是第一步，能验证、能排错、能安全退化才算完成。实际制作后，建议继续补上实物接线照片、串口截图、关键参数和一次真实故障记录。

参考资料

打赏

如果这篇学习记录对你有帮助，欢迎扫码支持后续整理。

打赏支持：王庆岩

posted on 2026-10-10 22:45 潇洒石头阅读(19) 评论(0) 收藏举报

刷新页面返回顶部