ESP32连接Adafruit指纹传感器串口监视器无输出问题排查

我尝试将Adafruit型指纹传感器连接到DOIT ESP32 Devkit V1开发板，已调用Serial.begin(9600)并添加了调试打印语句，但串口监视器始终无任何内容。

硬件配置信息 #

• 开发板：DOIT ESP32 Devkit V1
• 端口：COM6（识别为“Silicon Labs CP210x USB to UART Bridge”）
• 接线方式：
  • 3.3V → VCC
  • GND → GND
  • GPIO16（RX2）→ 传感器TX
  • GPIO17（TX2）→ 传感器RX

使用的代码 #

#include <Adafruit_Fingerprint.h>
#include <HardwareSerial.h>

#if (defined(__AVR__) || defined(ESP8266)) && !defined(__AVR_ATmega2560__)
HardwareSerial mySerial(2);
#else
#define mySerial Serial1
#endif

Adafruit_Fingerprint finger = Adafruit_Fingerprint(&mySerial);

void setup()
{
  Serial.begin(9600);
  Serial.println("התחלתי את setup");

  delay(100);
  Serial.println("\n\nAdafruit finger detect test");
  mySerial.begin(57600, SERIAL_8N1, 16, 17);
  finger.begin(57600);
  delay(5);
  if (finger.verifyPassword()) {
    Serial.println("Found fingerprint sensor!");
  } else {
    Serial.println("Did not find fingerprint sensor :(");
    while (1) { delay(1); }
  }

  Serial.println(F("Reading sensor parameters"));
  finger.getParameters();
  Serial.print(F("Status: 0x")); Serial.println(finger.status_reg, HEX);
  Serial.print(F("Sys ID: 0x")); Serial.println(finger.system_id, HEX);
  Serial.print(F("Capacity: ")); Serial.println(finger.capacity);
  Serial.print(F("Security level: ")); Serial.println(finger.security_level);
  Serial.print(F("Device address: ")); Serial.println(finger.device_addr, HEX);
  Serial.print(F("Packet len: ")); Serial.println(finger.packet_len);
  Serial.print(F("Baud rate: ")); Serial.println(finger.baud_rate);

  finger.getTemplateCount();

  if (finger.templateCount == 0) {
    Serial.print("Sensor doesn't contain any fingerprint data. Please run the 'enroll' example.");
  }
  else {
    Serial.println("Waiting for valid finger...");
      Serial.print("Sensor contains "); Serial.print(finger.templateCount); Serial.println(" templates");
  }
}

void loop()
{
  getFingerprintID();
  delay(50);
}

uint8_t getFingerprintID() {
  uint8_t p = finger.getImage();
  switch (p) {
    case FINGERPRINT_OK:
      Serial.println("Image taken");
      break;
    case FINGERPRINT_NOFINGER:
      Serial.println("No finger detected");
      return p;
    case FINGERPRINT_PACKETRECIEVEERR:
      Serial.println("Communication error");
      return p;
    case FINGERPRINT_IMAGEFAIL:
      Serial.println("Imaging error");
      return p;
    default:
      Serial.println("Unknown error");
      return p;
  }

  p = finger.image2Tz();
  switch (p) {
    case FINGERPRINT_OK:
      Serial.println("Image converted");
      break;
    case FINGERPRINT_IMAGEMESS:
      Serial.println("Image too messy");
      return p;
    case FINGERPRINT_PACKETRECIEVEERR:
      Serial.println("Communication error");
      return p;
    case FINGERPRINT_FEATUREFAIL:
      Serial.println("Could not find fingerprint features");
      return p;
    case FINGERPRINT_INVALIDIMAGE:
      Serial.println("Could not find fingerprint features");
      return p;
    default:
      Serial.println("Unknown error");
      return p;
  }

  p = finger.fingerSearch();
  if (p == FINGERPRINT_OK) {
    Serial.println("Found a print match!");
  } else if (p == FINGERPRINT_PACKETRECIEVEERR) {
    Serial.println("Communication error");
    return p;
  } else if (p == FINGERPRINT_NOTFOUND) {
    Serial.println("Did not find a match");
    return p;
  } else {
    Serial.println("Unknown error");
    return p;
  }

  Serial.print("Found ID #"); Serial.print(finger.fingerID);
  Serial.print(" with confidence of "); Serial.println(finger.confidence);

  return finger.fingerID;
}

int getFingerprintIDez() {
  uint8_t p = finger.getImage();
  if (p != FINGERPRINT_OK)  return -1;

  p = finger.image2Tz();
  if (p != FINGERPRINT_OK)  return -1;

  p = finger.fingerFastSearch();
  if (p != FINGERPRINT_OK)  return -1;

  Serial.print("Found ID #"); Serial.print(finger.fingerID);
  Serial.print(" with confidence of "); Serial.println(finger.confidence);
  return finger.fingerID;
}

可能的原因及解决方法 #

• 串口监视器波特率不匹配：代码中Serial.begin(9600)，需确保串口监视器右下角的波特率设置为9600，两者必须一致才能正常接收输出。
• ESP32 USB串口初始化延迟不足：ESP32的USB串口（Serial）初始化需要一定时间，在Serial.begin(9600)后增加delay(1000)，再执行打印语句，给串口足够的初始化时间。
• 条件编译导致的串口实例冲突：ESP32不属于__AVR__或ESP8266，会进入else分支将mySerial定义为Serial1，但后续又手动指定引脚初始化，可能引发冲突。建议直接去掉条件编译分支，直接初始化HardwareSerial mySerial(2);（ESP32的UART2对应引脚16(RX)、17(TX)），避免定义混乱。
• 电源供电不足：指纹传感器工作需要稳定的3.3V供电，若ESP32的3.3V引脚输出电流不足，可能导致传感器异常甚至系统卡死。尝试用外部3.3V电源给传感器供电，注意GND需与ESP32共地。
• 接线错误或虚接：再次确认RX/TX交叉连接是否正确（ESP32 RX接传感器TX，ESP32 TX接传感器RX），同时检查GND连接是否牢固，虚接会导致供电或通信异常。
• CP210x驱动异常：即使系统识别了端口，驱动可能存在问题。尝试卸载并重新安装Silicon Labs CP210x驱动，或更换USB端口连接。
• 简化代码排查串口基础功能：先注释掉所有指纹传感器相关代码，只保留串口测试代码：

  void setup() {
    Serial.begin(9600);
    delay(1000);
    Serial.println("Serial Test OK");
  }
  void loop() {}
  

  如果这个测试代码能正常输出，再逐步添加指纹传感器代码，定位具体问题点。

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