ESP32-S3 LD2412 Wi-Fi / ESPHome API 불량 분석 및 대응 기록

ESP32-S3 LD2412 Wi-Fi / ESPHome API 불량 분석 및 대응 기록

1. 대상 장치

ESP32-S3 + LD2412

ESPHome 2026.8.0

Hostname: s3-ld2412-bookroom

IP: 192.168.0.109

ESPHome Native API: TCP 6053

2. 최초 불량 증상

ESPHome 로그 연결 시 아래 오류가 반복 발생했다.

WARNING Can't connect to ESPHome API for s3-ld2412-bookroom @ 192.168.0.109:

[Errno 111] Connect call failed ('192.168.0.109', 6053) (SocketAPIError)

장치 이름과 IP 주소는 정상적으로 확인되지만 API TCP 6053 연결이 거부되는

증상이었다.

3. 정상 연결 시 확인 내용

일시적으로 정상 동작할 때는 다음 로그가 확인되었다.

INFO Successfully connected to s3-ld2412-bookroom @ 192.168.0.109

INFO Successful handshake with s3-ld2412-bookroom @ 192.168.0.109

Wi-Fi 상태도 정상일 때 다음과 같았다.

Connected: YES

IP Address: 192.168.0.109

SSID: '24Gshimss'

Signal strength: -44 dB

Gateway: 192.168.0.1

API도 정상적으로 6053 포트에서 동작했고 Noise encryption도 정상

확인되었다.

4. OTA Rollback 경고

정상 연결 당시 다음 경고도 확인되었다.

OTA rollback detected! Rolled back from partition 'app0'

The device reset before the boot was marked successful

Safe Mode 정보:

Successful after: 60s

Invoke after: 10 attempts

Duration: 300s

초기에는 OTA 이후 정상 부팅 판정 전에 Reset, 펌웨어 crash/watchdog,

Wi-Fi/API 초기화 문제 등을 검토했다.

5. YAML 구성 검토 및 대응

검토 파일: - s3-ld2412-bookroom.yaml - ld2412_1.yaml -

esphome_package.yaml

API / Wi-Fi reboot_timeout

api:

  reboot_timeout: 2min

wifi:

  reboot_timeout: 2min

Safe Mode 정상 부팅 판정 60초보다 긴 2분 설정이므로 60초 이내 Reset의

직접 원인으로 판단하지 않았다.

Wi-Fi 약신호 자동 재부팅

Wi-Fi가 -90 dBm 이하로 5분 지속될 경우 재부팅하는 구성이 있었으나,

실제 정상 연결 시 RSSI는 약 -44 dBm이었으므로 이번 증상과 관계없는

것으로 판단했다.

LD2412 UART DEBUG

LD2412는 256000 baud UART를 사용하고 있었고 RX 데이터를 HEX로 출력하는

DEBUG 구성이 있었다. 정상 운용 시 불필요한 부하를 줄이기 위해 UART raw

HEX DEBUG 제거 및 logger 레벨 감소를 검토했다.

GPIO48 Presence LED

Presence LED는 Enable 스위치와 ld2412_presence가 모두 ON일 때 2초

간격으로 점멸하도록 정리했다.

Enable ON + Presence ON

→ LED ON

→ 300ms

→ LED OFF

→ 약 1.7초

→ 반복

Presence LED Enable 스위치는 필요 시:

restore_mode: ALWAYS_ON

실제 LED 점멸 실행용 pir_led_gpio48_20p는:

restore_mode: ALWAYS_OFF

로 구성하는 방향으로 정리했다.

6. API 접속 불량 재발

이후 [Errno 111]이 한 번이 아니라 계속 반복되었고

Successfully connected 상태로 넘어가지 않는 증상이 발생했다.

이에 따라 단순 API 접속 타이밍 문제가 아니라 다음 가능성을 확인했다.

ESP32 부팅 불안정

반복 Reset

Wi-Fi 동작 불안정

전원 공급 문제

7. 최종 확인된 원인

ESP32 전원 전압 저하

실제 하드웨어 점검 결과 ESP32 쪽 전원 전압이 낮아 Wi-Fi가 정상

동작하지 않는 것으로 확인했다.

동시에 외부에서 공급되는 5V 전원은 정상임을 확인했다.

따라서 단순한 5V 전원 공급기 출력 저하가 아니라 ESP32 보드 내부 또는

ESP32가 실제 사용하는 전원 계통의 전압 저하 문제로 판단했다.

외부 5V

   │

   └── 측정 정상

        ↓

ESP32-S3 보드 전원 회로

        ↓

ESP32 동작 전압 저하

        ↓

Wi-Fi 불안정 / 동작 불가

        ↓

ESPHome API 6053 접속 불가

        ↓

Errno 111 반복

5V가 정상이어도 다음 부분은 추가 점검 대상이다.

ESP32 보드의 3.3V regulator

3.3V rail 전압

배선/PCB 전압 강하

순간 전류 공급 부족

주변 장치 부하

LD2412 및 RGB LED 부하

Wi-Fi 송신 순간 전압 강하

8. 최종 판단

항목                      확인 결과

외부 입력 5V              정상

ESPHome YAML validation   정상

정상 시 Wi-Fi RSSI        약 -44 dBm

정상 시 API 6053          정상

API encryption            정상

불량 시 증상              Errno 111 반복

최종 확인                 ESP32 전원 전압 저하로 Wi-Fi 동작 불량

최종적으로 ESPHome API 설정이나 Wi-Fi 신호 세기 자체가 주원인이

아니라, ESP32 전원 계통의 전압 저하로 Wi-Fi가 정상 동작하지 못하면서 API

6053 접속까지 실패한 것으로 확인했다.

9. 향후 동일 증상 발생 시 점검 순서

ESP32 입력 5V 측정

ESP32 보드 3V3-GND 직접 측정

Wi-Fi 연결/송신 시 3.3V 전압 변동 확인

LD2412를 분리하고 ESP32 단독 테스트

GPIO48 RGB LED 동작을 중지하고 테스트

ESP32 단독 상태에서 API 6053 연결 확인

주변 장치를 하나씩 연결하며 전압 및 Wi-Fi 상태 확인

필요 시 3.3V regulator 및 ESP32-S3 보드 자체 불량 여부 확인

10. 핵심 메모

증상:

ESPHome API 192.168.0.109:6053

Errno 111 Connection refused 반복

초기 대응:

Wi-Fi / API / OTA rollback / YAML / UART DEBUG / LED 구성 검토

하드웨어 확인:

외부 5V 입력 정상

최종 확인:

ESP32 전원 전압 저하

→ Wi-Fi 동작 불량

→ ESPHome API 6053 접속 불가

향후 대응:

3.3V Rail 및 regulator 확인

주변 부하 분리 테스트

LD2412 / RGB LED 단계별 연결 확인