1. ESP32-S3 시스템 아키텍처

mindmap
  root((ESP32-S3))
    Connectivity(통신망)
      WiFi[WiFi 802.11 b/g/n]
      Bluetooth[BLE 5.0 / Mesh]
      ESPNOW[ESP-NOW]
      Protocols[HTTP / MQTT / WebServer]
    CoreSystem(핵심 시스템)
      DualCore[Dual-Core LX7]
      AI_Accelerator[Vector Instructions / PIE]
      Memory[SRAM / PSRAM Support]
      Power[Deep Sleep / RTC]
    Storage(데이터 저장)
      NVS[Preferences / EEPROM]
      FileSystem[LittleFS / SPIFFS]
      External[SD / SD_MMC]
    Peripherals(주변 장치)
      HighSpeed[USB OTG / JTAG]
      Audio[I2S / DAC]
      Control[PWM / RMT / MCPWM]
      Standard_IO[UART / SPI / I2C]
      Analog[ADC / Touch Sensor]

2. 상세 분류표 (Standard Modules)

분류	모듈명 (Header)	주요 기능 및 특징
Network	`WiFi.h`	스테이션/AP 모드, Wi-Fi 연결 관리
Network	`HTTPClient.h`	REST API 통신 (GET, POST 등)
Network	`ESPAsyncWebServer.h`	비동기 웹서버 (고성능 대시보드)
Network	`PubSubClient.h`	MQTT 프로토콜 기반 IoT 데이터 전송
System	`FreeRTOS.h`	멀티태스킹(Task) 및 세마포어 제어
System	`Preferences.h`	Key-Value 방식의 영구 설정값 저장
System	`Update.h`	OTA (Over-The-Air) 무선 펌웨어 업데이트
S3 Special	`USB.h`	Native USB OTG 제어 (HID, CDC)
S3 Special	`esp_nn.h`	AI 가속기(PIE) 활용 신경망 연산
I/O	`Wire.h` / `SPI.h`	I2C 센서 및 SPI 디스플레이/SD카드
I/O	`LEDC.h`	하드웨어 PWM 제어 (LED, 팬 속도)
I/O	`driver/rmt.h`	WS2812B(NeoPixel) 및 적외선 제어

3. 라이브러리 레이어 구조 (Design Pattern)

graph TD
    UserApp[User Application] --> LibAPI[Library Interface — MyLib.h]
    LibAPI --> Logic[Business Logic — MyLib.cpp]

    subgraph ESP32_S3_SDK["ESP32-S3 SDK"]
        Logic --> NetStack[Network: WiFi / MQTT]
        Logic --> HWDriver[HW: I2C / SPI / RMT]
        Logic --> Storage[Storage: LittleFS / NVS]
    end

    NetStack --> ESP_IDF[ESP-IDF Framework]
    HWDriver --> ESP_IDF
    Storage --> ESP_IDF

4. 라이브러리 구현 팁

S3 전용 매크로 사용

CONFIG_IDF_TARGET_ESP32S3 를 사용하여 S3만의 특화 기능을 분기 처리하세요.

#ifdef CONFIG_IDF_TARGET_ESP32S3
  // S3 전용 코드 (PIE 가속기, USB OTG 등)
#endif

PSRAM 활용

큰 버퍼가 필요한 경우 ps_malloc() 을 사용하여 외부 RAM을 활용하도록 설계하세요.

uint8_t* buf = (uint8_t*) ps_malloc(1024 * 1024); // 1MB PSRAM 할당

비동기 처리

네트워크 모듈 사용 시 FreeRTOS의 큐(Queue)나 태스크(Task)를 사용하여 메인 루프 지연을 방지하세요.

QueueHandle_t mqttQueue = xQueueCreate(10, sizeof(MqttMessage));

xTaskCreate([](void* param) {
    MqttMessage msg;
    while (true) {
        if (xQueueReceive(mqttQueue, &msg, portMAX_DELAY)) {
            client.publish(msg.topic, msg.payload);
        }
    }
}, "mqttTask", 4096, nullptr, 1, nullptr);

SmartFactory.

ESP32-S3 Module & Library Architecture Guide