# ESP32 Serial Logger v2.0

UART2 시리얼 모니터링 + SD카드 로깅 + WiFi 웹 인터페이스 + DS3231 RTC

## 하드웨어
- **보드:** ESP-WROOM-32D DevKitC V4
- **RTC:** DS3231 모듈 (I2C, ±2ppm 정밀도)
- **SD카드:** SPI 방식 MicroSD 모듈

## 핀 연결
```
ESP32                     대상장치 (UART)
  GPIO17 (TX) ──────────── RX
  GPIO16 (RX) ──────────── TX
  GND ──────────────────── GND

ESP32                     SD Card Module (VSPI)
  GPIO18  ────────────────  SCLK
  GPIO19  ────────────────  MISO
  GPIO23  ────────────────  MOSI
  GPIO5   ────────────────  CS
  3.3V    ────────────────  VCC
  GND     ────────────────  GND

ESP32                     DS3231 RTC Module (SoftWire I2C)
  GPIO25  ────────────────  SDA
  GPIO26  ────────────────  SCL
  3.3V    ────────────────  VCC
  GND     ────────────────  GND
```

> SoftWire 사용으로 임의 GPIO에 DS3231 연결 가능. GPIO 6~11은 SPI Flash 전용.

## Arduino IDE 설정

| 설정 | 값 |
|---|---|
| Board | ESP32 Dev Module |
| Upload Speed | 921600 |
| CPU Frequency | 240MHz (WiFi/BT) |
| Flash Frequency | 80MHz |
| Flash Mode | QIO |
| Flash Size | 4MB (32Mb) |
| Partition Scheme | Huge APP (3MB No OTA/1MB SPIFFS) |
| PSRAM | Disabled |

## 필수 라이브러리

| 라이브러리 | 설치 |
|---|---|
| WebSockets by Markus Sattler (Links2004) | Library Manager |
| ArduinoJson v6.x | Library Manager |
| SoftWire by Steve Marple | Library Manager → "SoftWire" |
| AsyncDelay by Steve Marple | Library Manager (SoftWire 의존) |
| SD, SPI | 설치 불필요 (내장) |

## 시간 동기화 전략 (장기 로깅용)

```
시간 우선순위:
  1. NTP (STA 모드, 1시간마다 자동 보정)
  2. 브라우저 시간 (WebSocket 접속 시 자동 전송)
  3. DS3231 RTC (부팅 즉시 + 60초마다 드리프트 보정)
```

### 동작 흐름
1. 부팅 → DS3231에서 시간 읽어 시스템 시계 즉시 설정
2. 핸드폰 접속 → 브라우저 시간 → 시스템 시계 + DS3231 동시 설정
3. WiFi 끊김/장기 방치 → 60초마다 DS3231 → 시스템 시계 보정
4. STA 모드 → NTP 성공 시 RTC도 자동 업데이트

## FreeRTOS 태스크 구조
```
Core 1: SerialRX(Pri:5), SerialTX(Pri:4)
Core 0: SDLog(Pri:3), WebBroadcast(Pri:2), RTC(Pri:1), NTP(Pri:1)
Loop:   server.handleClient()
```

## 로그 파일
- 경로: /logs/LOG_YYYYMMDD_HHMMSS.csv
- 형식: "Timestamp","Direction","Data"