ESP32启用WiFi.h后MQ传感器输出0值，未启用时功能正常

问题现象 #

• 基于ESP32 Wroom32、MQ系列（含MQ07）气体传感器、SR04超声波传感器的IoT项目
• 未启用WiFi连接代码时，传感器数据读取正常，串口打印、状态指示灯工作正常
• 启用setup()中的WiFi.h连接代码后，MQ传感器输出值变为0，SR04传感器工作异常

核心原因分析 #

1. GPIO引脚冲突：ESP32的WiFi模块会占用部分核心引脚（如SPI Flash专用引脚GPIO6-11、UART0引脚GPIO1/3，以及射频相关引脚），若传感器使用了这些引脚，会被WiFi功能抢占导致异常。
2. ADC资源冲突：MQ传感器依赖ADC采样，ESP32的ADC2通道在WiFi启用时会被占用，若MQ传感器接在ADC2引脚，会无法正常采样。
3. 供电波动：WiFi启动时会产生200-300mA的峰值电流，若电源供电能力不足，会导致传感器供电电压下降，无法正常工作。
4. 任务阻塞：传统阻塞式WiFi连接代码（如while(WiFi.status()!=WL_CONNECTED)）会长时间占用CPU，导致传感器读取任务无法执行。

分步修复方案 #

1. 检查并调整引脚映射 #

• 避免将传感器引脚分配到ESP32 WiFi核心占用的引脚：
  • 禁止使用GPIO6-11（SPI Flash专用引脚）
  • 优先使用ADC1通道引脚（GPIO32-39），ADC2通道引脚（GPIO0、2、4、12-15）在WiFi启用时无法使用
  • SR04的TRIG/ECHO引脚避开GPIO1、3（UART0默认引脚）
• 示例调整：将MQ传感器从ADC2的GPIO34更换到ADC1的GPIO36，SR04引脚更换为GPIO23（TRIG）、GPIO22（ECHO）

2. 优化电源供电 #

• 使用输出电流≥500mA的电源模块供电
• 在传感器电源引脚并联100nF陶瓷滤波电容，抑制电源波动
• 若采用电池供电，确保电池容量≥1000mAh，避免电压骤降

3. 修改WiFi连接逻辑为非阻塞模式 #

避免在setup()中使用阻塞循环等待WiFi连接，改为在loop()中定期检查连接状态，释放CPU资源给传感器读取任务：

void setup() {
  Serial.begin(115200);
  // 先初始化传感器，避免WiFi启动影响
  initMQSensor();
  initSR04();
  // 启动WiFi连接
  WiFi.begin(ssid, password);
}

void loop() {
  // 非阻塞式WiFi重连逻辑
  static unsigned long lastReconnectAttempt = 0;
  if (WiFi.status() != WL_CONNECTED && millis() - lastReconnectAttempt > 5000) {
    WiFi.reconnect();
    lastReconnectAttempt = millis();
    Serial.println("Reconnecting to WiFi...");
  }

  // 定期读取传感器数据（每1秒一次）
  static unsigned long lastSensorRead = 0;
  if (millis() - lastSensorRead > 1000) {
    readMQData();
    readSR04Data();
    lastSensorRead = millis();
  }
}

4. 提升传感器采样稳定性 #

• 对MQ传感器的ADC采样进行多次读取取平均值：

float readMQValue() {
  int sum = 0;
  for(int i=0; i<10; i++){
    sum += analogRead(MQ_PIN);
    delay(10);
  }
  return sum / 10.0;
}

• 为SR04传感器增加读取超时判断，避免因信号异常导致程序阻塞：

float readSR04Distance() {
  digitalWrite(TRIG_PIN, LOW);
  delayMicroseconds(2);
  digitalWrite(TRIG_PIN, HIGH);
  delayMicroseconds(10);
  digitalWrite(TRIG_PIN, LOW);
  
  unsigned long duration = pulseIn(ECHO_PIN, HIGH, 30000); // 设置30ms超时
  if(duration == 0) return -1; // 返回异常标记
  return duration * 0.034 / 2;
}

内容的提问来源于stack exchange，提问作者ashutosh7i