ESP32가 시리얼 모니터를 열 때마다 리셋되는 이유와 해결

왜 포트를 열기만 해도 리셋될까

ESP32 개발보드(DevKitC 등)에는 USB-시리얼 변환 칩(CP2102, CH340 등)이 있고, 이 칩의 DTR·RTS 핀이 트랜지스터 두 개를 거쳐 ESP32 의 EN(리셋)과 IO0(부팅 모드)에 연결돼 있습니다. 업로드 도구가 이 두 신호로 '다운로드 모드 진입 → 리셋'을 자동으로 해 주기 때문에, 버튼을 누르지 않아도 펌웨어가 올라가는 것입니다.

문제는 업로드 도구만 이 신호를 쓰는 게 아니라는 점입니다. 대부분의 터미널 프로그램과 드라이버는 포트를 열 때 DTR·RTS 를 켜거나 끕니다. 회로는 그 신호가 업로드용인지 모니터용인지 구분하지 못하므로, 똑같이 리셋을 겁니다.

회로는 두 신호가 서로 다를 때만 반응하도록 짜여 있습니다. 업로드 도구가 널리 쓰는 자동 부트로더 회로 기준으로 정리하면 다음과 같습니다.

도구별 해결법

PlatformIO

platformio.ini 에 두 줄을 추가하면 모니터가 포트를 열 때 신호를 내리지 않습니다. 업로드에는 영향이 없습니다 — 업로드는 별도로 신호를 제어합니다.

[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
monitor_dtr = 0
monitor_rts = 0

ESP-IDF

idf.py monitor 는 부팅 로그부터 보여 주려고 시작할 때 일부러 보드를 리셋합니다. 이미 돌고 있는 보드에 리셋 없이 붙으려면 최근 버전에서 --no-reset 옵션을 씁니다.

idf.py -p COM5 monitor --no-reset

파이썬 pyserial

포트를 연 뒤에 신호를 끄면 이미 늦습니다. 포트 객체를 먼저 만들고, 신호 값을 정한 다음에 open() 해야 합니다.

import serial

ser = serial.Serial()        # 아직 열지 않음
ser.port = "COM5"
ser.baudrate = 115200
ser.dtr = False              # 열기 전에 정한다
ser.rts = False
ser.open()

while True:
    line = ser.readline()
    if line:
        print(line.decode(errors="replace"), end="")

Arduino IDE

Arduino IDE 의 시리얼 모니터에는 보통 이 신호를 끄는 옵션이 없습니다. 리셋 없이 보고 싶다면 위의 PlatformIO 나 DTR 을 직접 끌 수 있는 터미널 프로그램을 쓰는 편이 빠릅니다.

전용 시리얼 터미널

DTR 을 끄고 연결하는 옵션이 있는 터미널이라면 그걸로 끝납니다. CNTerminal 은 화면의 DTR 토글을 끈 상태로 포트를 열면 ESP32 가 리셋되지 않아, 이미 돌고 있는 보드의 로그를 그대로 이어 볼 수 있습니다.

'waiting for download' 에서 멈췄을 때

모니터를 열었더니 아래 메시지만 나오고 프로그램이 시작되지 않는 경우가 있습니다.

rst:0x1 (POWERON_RESET),boot:0x3 (DOWNLOAD_BOOT(UART0/UART1/SDIO_REI_REO_V2))
waiting for download

DOWNLOAD_BOOT 는 리셋 순간 IO0 가 LOW 였다는 뜻입니다. 칩은 펌웨어를 실행하지 않고 새 펌웨어를 받을 준비만 한 채 기다립니다. 표의 네 번째 줄(DTR 0, RTS 1) 상태로 리셋이 풀린 경우입니다.

1. 1모니터를 닫고 보드의 EN(RST) 버튼을 한 번 누릅니다. 신호가 풀린 상태에서 리셋되므로 정상 실행됩니다.
2. 2위 도구별 설정으로 RTS 를 끈 채 모니터를 엽니다.
3. 3GPIO0 에 버튼·센서 같은 외부 회로를 연결했다면, 부팅 순간 LOW 로 잡히지 않는지 확인합니다.

반대로 리셋이 필요할 때도 있습니다

부팅 직후 출력되는 로그(크래시 원인, 초기화 메시지)를 보고 싶다면 자동 리셋은 오히려 편한 기능입니다. 그럴 때는 설정을 기본값으로 두거나, 신호를 끈 채 모니터를 연 다음 EN 버튼을 직접 한 번 누르면 됩니다. 상황에 따라 켜고 끄는 것이 정답입니다.

자주 묻는 질문