VS Code中ESP32 GPIO电平无法正常检测（Arduino IDE可正常工作）

架构老林

2026-7-19

问题

我正在开发一个以ESP-32/C驱动的门磁传感器为核心的项目，目前仅需验证C代码能否正确识别门磁传感器的GPIO输出高低电平。但无论传感器是否处于接触状态，程序始终仅检测到GPIO输出为LOW(0)。而在Arduino IDE中使用其库编写类似代码时，可正常工作。

已完成以下排查：

测试所有硬件：ESP32、面包板、跳线及门磁传感器均工作正常。
在Arduino IDE中使用ESP32/Arduino开发库测试代码，功能符合预期。
在VS Code中编写C++闪烁程序，确认引脚配置及开发环境无问题，程序可正常运行。

以上排查让我认为问题出在代码本身，但我无法确定具体哪部分代码导致无法识别GPIO电平变化。

代码如下：

#include "driver/gpio.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"

#define DOOR_PIN GPIO_NUM_19                                //GPIO 19 -> DOOR_PIN                          //GPIO 13 -> LED_PIN
#define LOG_LEVEL_LOCAL ESP_LOG_VERBOSE        
#define LOG_TAG "MAIN"

extern "C" void app_main(void)
{
    int count = 0;
    esp_rom_gpio_pad_select_gpio(DOOR_PIN);                 //Set up DOOR_PIN for IO              
    gpio_set_direction(DOOR_PIN, GPIO_MODE_OUTPUT);         //Set up DOOR_PIN as output pin     
    while(true)    
    {
        int DOOR_PIN_LEVEL = gpio_get_level(DOOR_PIN);
        if(DOOR_PIN_LEVEL == 1){                            
            ESP_LOGI(LOG_TAG, "High");                      //(Door sensors touching)
        }
        else{                 
            ESP_LOGI(LOG_TAG, "Low");                       //(Door sensors not touching)
        }
    }
}

解决方案

你的代码核心错误在于将连接门磁传感器的GPIO引脚设置成了输出模式，门磁传感器是向ESP32输入电平信号的外设，必须配置为输入模式才能正常读取信号。

另外，门磁传感器多为无源触点类型（常开/常闭），触点断开时GPIO引脚会处于浮空状态，导致电平读取不稳定。Arduino IDE的pinMode(pin, INPUT_PULLUP)默认启用内部上拉电阻，所以能正常检测，但ESP-IDF需要手动配置上拉/下拉电阻。

修改后的代码如下：

#include "driver/gpio.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"

#define DOOR_PIN GPIO_NUM_19
#define LOG_LEVEL_LOCAL ESP_LOG_VERBOSE        
#define LOG_TAG "MAIN"

extern "C" void app_main(void)
{
    // 选择GPIO引脚
    esp_rom_gpio_pad_select_gpio(DOOR_PIN);
    // 配置为输入模式，并启用内部上拉电阻（根据门磁类型调整上拉/下拉）
    gpio_set_direction(DOOR_PIN, GPIO_MODE_INPUT);
    gpio_set_pull_mode(DOOR_PIN, GPIO_PULLUP_ONLY);

    while(true)    
    {
        int door_pin_level = gpio_get_level(DOOR_PIN);
        if(door_pin_level == 1){                            
            ESP_LOGI(LOG_TAG, "门磁接触");
        }
        else{                 
            ESP_LOGI(LOG_TAG, "门磁断开");
        }
        // 增加短延时，避免日志刷屏，同时符合FreeRTOS调度要求
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}

关键修改点：

将GPIO_MODE_OUTPUT改为GPIO_MODE_INPUT，把引脚切换为输入模式，才能读取外部传感器的电平信号。
添加gpio_set_pull_mode(DOOR_PIN, GPIO_PULLUP_ONLY)启用内部上拉电阻，防止引脚浮空导致的电平误判。如果门磁是常闭型，可改为GPIO_PULLDOWN_ONLY，根据实际硬件接线调整。
增加vTaskDelay避免日志输出过于频繁，同时避免任务长期占用CPU影响系统调度。

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