ESP32-C3 WiFi 4 스택 — Station·SoftAP·Mesh 구성

#한 줄 요약

“ESP32-C3의 WiFi는 event-driven입니다. esp_wifi_* 호출은 명령일 뿐, 결과는 모두 event handler로 돌아옵니다.” 동기 API로 착각하면 race condition과 reconnect 지옥이 시작됩니다.

ESP32-C3는 802.11 b/g/n을 지원합니다. 2.4 GHz 단일 밴드이고, 1×1 SISO 안테나, 최대 PHY 비율 72.2 Mbps입니다. 실제 애플리케이션 throughput은 TCP 약 20 Mbps, UDP 약 30 Mbps가 한계입니다. 5 GHz도 802.11ac/ax도 없습니다. 대신 대량 보급용 IoT에 충분한 사양을 작은 RAM 풋프린트로 제공합니다.

이번 장에서는 WiFi 스택의 4가지 모드를 차례로 살펴보고, event loop 패턴, WPA2/WPA3 보안, ESP-MESH의 자가 조직 트리, 그리고 provisioning(공장 출하 후 사용자 WiFi 정보를 받는 절차)까지 다룹니다.

#ESP-IDF WiFi 스택 구조

WiFi 스택은 4개 계층입니다.

핵심은 event loop입니다. WiFi 연결 시도, 연결 성공, DHCP 완료, 끊김 같은 모든 상태 변화는 event로 발행됩니다. 애플리케이션은 handler를 등록해 비동기로 반응합니다.

1
#include "esp_wifi.h"
2
#include "esp_event.h"
3
#include "esp_netif.h"
4
#include "nvs_flash.h"
5

6
static void wifi_event_handler(void* arg, esp_event_base_t event_base,
7
                                int32_t event_id, void* event_data)
8
{
9
    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_START) {
10
        esp_wifi_connect();
11
    } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_DISCONNECTED) {
12
        // 재연결 로직. 백오프와 retry 카운트 필수.
13
        esp_wifi_connect();
14
    } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
15
        ip_event_got_ip_t* event = (ip_event_got_ip_t*)event_data;
16
        ESP_LOGI("wifi", "got IP: " IPSTR, IP2STR(&event->ip_info.ip));
17
    }
18
}

WIFI_EVENT는 링크 계층 이벤트(연결·끊김·스캔 완료), IP_EVENT는 네트워크 계층 이벤트(IP 획득·갱신·상실)입니다. 두 베이스를 분리해 등록해야 의미가 분명해집니다.

#Station 모드 — 클라이언트 연결

가장 흔한 모드입니다. 가정용 라우터에 클라이언트로 붙는 시나리오입니다.

1
void wifi_init_sta(void)
2
{
3
    ESP_ERROR_CHECK(nvs_flash_init());
4
    ESP_ERROR_CHECK(esp_netif_init());
5
    ESP_ERROR_CHECK(esp_event_loop_create_default());
6
    esp_netif_create_default_wifi_sta();
7

8
    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
9
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));
10

11
    ESP_ERROR_CHECK(esp_event_handler_instance_register(
12
        WIFI_EVENT, ESP_EVENT_ANY_ID, &wifi_event_handler, NULL, NULL));
13
    ESP_ERROR_CHECK(esp_event_handler_instance_register(
14
        IP_EVENT, IP_EVENT_STA_GOT_IP, &wifi_event_handler, NULL, NULL));
15

16
    wifi_config_t wifi_config = {
17
        .sta = {
18
            .ssid = "MyHomeWiFi",
19
            .password = "supersecret",
20
            .threshold.authmode = WIFI_AUTH_WPA2_PSK,
21
            .pmf_cfg = { .capable = true, .required = false },
22
        },
23
    };
24
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));
25
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config));
26
    ESP_ERROR_CHECK(esp_wifi_start());
27
}

호출 순서가 엄격합니다. nvs_flash_init → esp_netif_init → esp_event_loop_create_default → esp_netif_create_default_wifi_sta → esp_wifi_init → esp_wifi_set_mode → esp_wifi_set_config → esp_wifi_start. 한 단계라도 빠지거나 순서가 바뀌면 ESP_ERR_WIFI_NOT_INIT 또는 ESP_ERR_INVALID_STATE가 반환됩니다.

esp_wifi_start는 연결을 시작하지 않습니다. 오직 드라이버를 켤 뿐입니다. 실제 연결은 WIFI_EVENT_STA_START event를 받은 뒤 esp_wifi_connect를 호출해야 시작됩니다.

#SoftAP 모드 — AP 동작

ESP32-C3가 AP 노릇을 합니다. 폰을 직접 붙여 설정 화면을 띄우는 OOBE(out-of-box experience) 시나리오, 또는 별도 라우터 없이 센서 노드를 모으는 용도입니다.

1
void wifi_init_softap(void)
2
{
3
    esp_netif_create_default_wifi_ap();
4

5
    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
6
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));
7

8
    wifi_config_t wifi_config = {
9
        .ap = {
10
            .ssid = "ESP32-C3-Setup",
11
            .ssid_len = strlen("ESP32-C3-Setup"),
12
            .password = "configme",
13
            .max_connection = 4,
14
            .authmode = WIFI_AUTH_WPA2_PSK,
15
            .channel = 6,
16
        },
17
    };
18
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_AP));
19
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_AP, &wifi_config));
20
    ESP_ERROR_CHECK(esp_wifi_start());
21
}

기본 제약은 동시 클라이언트 10대 이하, DHCP server 자동 활성화, IP 대역 192.168.4.1/24입니다. 채널은 1·6·11이 안전합니다. 한 SoftAP가 너무 많은 클라이언트를 받으면 처리량이 급격히 떨어집니다. C3는 단일 코어에 RAM도 작아 4~6대가 현실적 한계입니다.

#Station+AP 동시 모드 — 브리지

가장 유용한 시나리오 중 하나입니다. 기존 라우터에 붙으면서 동시에 자체 AP도 운영합니다. provisioning, mesh root, range extender에 쓰입니다.

1
ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_APSTA));
2
ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &sta_config));
3
ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_AP,  &ap_config));

주의할 점은 두 인터페이스가 같은 채널을 써야 한다는 것입니다. ESP32-C3 라디오는 하나뿐이라, STA가 6번 채널에 연결되면 AP도 자동으로 6번으로 끌려갑니다. AP 채널을 따로 지정해도 무시됩니다.

#WPA2-Personal vs WPA3-Personal

C3는 WPA3-Personal과 WPA2/WPA3 Mixed까지 지원합니다.

WPA3로 갈 때는 *PMF(Protected Management Frames)*가 필수입니다. pmf_cfg.required = true로 켜야 합니다. WPA2/WPA3 mixed에서는 capable = true, required = false로 두는 것이 호환성 최대입니다.

1
wifi_config_t wifi_config = {
2
    .sta = {
3
        .ssid = "MyWiFi",
4
        .password = "secret",
5
        .threshold.authmode = WIFI_AUTH_WPA2_WPA3_PSK,
6
        .pmf_cfg = { .capable = true, .required = false },
7
        .sae_pwe_h2e = WPA3_SAE_PWE_HASH_TO_ELEMENT,
8
    },
9
};

WPA2-Enterprise는 esp_wifi_sta_wpa2_ent_* 별도 API를 호출합니다. 사내 인증서(CA, client cert, private key)를 PEM으로 임베드하거나 NVS에 저장합니다.

#ESP-MESH — 자가 조직 트리 네트워크

ESP-MESH는 *root → layer 1 → layer 2 → …*의 트리입니다. 최대 6 layer까지 확장됩니다. mesh 안에서는 각 노드가 동시에 station(부모에게)·SoftAP(자식에게) 두 역할을 합니다.

root만 외부 라우터에 붙습니다. 그 아래는 내부 mesh 트래픽만 흐릅니다. 노드가 떨어져 나가면 자동으로 부모를 재선출합니다. 한국에서는 공장 IoT 센서 네트워크나 대규모 LED 조명 제어에 쓰입니다.

1
mesh_cfg_t mesh_cfg = MESH_INIT_CONFIG_DEFAULT();
2
memcpy(mesh_cfg.mesh_id.addr, MESH_ID, 6);
3
mesh_cfg.channel = 0;          // 0이면 root가 채널을 결정
4
mesh_cfg.router.ssid_len = strlen(ROUTER_SSID);
5
memcpy(mesh_cfg.router.ssid, ROUTER_SSID, mesh_cfg.router.ssid_len);
6
memcpy(mesh_cfg.router.password, ROUTER_PASS, strlen(ROUTER_PASS));
7
mesh_cfg.mesh_ap.max_connection = 6;
8
memcpy(mesh_cfg.mesh_ap.password, MESH_AP_PASS, strlen(MESH_AP_PASS));
9

10
ESP_ERROR_CHECK(esp_mesh_set_config(&mesh_cfg));
11
ESP_ERROR_CHECK(esp_mesh_start());

mesh는 대역폭이 layer마다 절반으로 떨어집니다. layer 3쯤 가면 throughput이 1 Mbps 이하로 내려갑니다. 고대역 application에는 부적합하고, 주기적 small payload에 적합합니다.

#Provisioning — 사용자 WiFi 정보 받기

공장 출하 단계에서는 어느 라우터에 붙을지 알 수 없습니다. 사용자가 처음 켤 때 알려 줘야 합니다. ESP-IDF는 wifi_provisioning 컴포넌트를 제공합니다.

1
wifi_prov_mgr_config_t config = {
2
    .scheme = wifi_prov_scheme_ble,
3
    .scheme_event_handler = WIFI_PROV_SCHEME_BLE_EVENT_HANDLER_FREE_BTDM,
4
};
5
ESP_ERROR_CHECK(wifi_prov_mgr_init(config));
6

7
const char *pop = "abcd1234";  // proof of possession
8
ESP_ERROR_CHECK(wifi_prov_mgr_start_provisioning(
9
    WIFI_PROV_SECURITY_1, pop, "PROV_C3", NULL));

WIFI_PROV_SECURITY_1은 X25519 키 교환 + AES-CTR, _SECURITY_2는 SRP6a + AES-GCM입니다. 양산 제품에서는 Security 2 + 디바이스별 username/password를 권장합니다. PoP(proof of possession)는 제품 라벨에 인쇄된 코드가 흔한 패턴입니다.

#전력 절약 — Modem Sleep와 DTIM

연결 상태에서 지속 전류를 줄이는 핵심은 modem sleep입니다. STA가 AP에 DTIM beacon만 듣는다는 약속을 보내고, 그 사이는 라디오를 끕니다.

1
ESP_ERROR_CHECK(esp_wifi_set_ps(WIFI_PS_MIN_MODEM));
2
// WIFI_PS_MIN_MODEM — DTIM마다 깸 (기본)
3
// WIFI_PS_MAX_MODEM — 사용자 지정 listen_interval마다 깸
4
// WIFI_PS_NONE      — 절전 끔

DTIM은 AP가 broadcast 전에 알려 주는 beacon 주기입니다. 가정용 라우터는 보통 DTIM=1 또는 3입니다. listen_interval을 DTIM의 배수로 키우면 깨는 빈도가 N배 감소하지만, broadcast packet을 놓칠 위험도 늘어납니다.

#처리량의 현실

C3 데이터시트가 약속하는 PHY 비율은 72.2 Mbps입니다. 애플리케이션에서 실제로 나오는 throughput은 훨씬 낮습니다.

이유는 여러 가지입니다. C3는 1×1 SISO라 MIMO 이득이 없고, 2.4 GHz는 간섭이 심하며, IDF의 LwIP 구현이 zero-copy가 아니라 사본을 한 번 더 만들기 때문입니다. 벌크 전송이 주된 application이면 ESP32-S3(2×2 듀얼 코어)나 ESP32-C6(WiFi 6) 쪽이 적합합니다.

#자주 하는 실수와 troubleshooting

가장 흔한 함정은 reconnect 폭주입니다. WIFI_EVENT_STA_DISCONNECTED 핸들러에서 바로 esp_wifi_connect를 호출하면, AP가 다운된 상태에서 초당 수십 회 재시도가 발생합니다. 백오프(1s → 2s → 4s → 8s)와 최대 retry count를 반드시 둡니다.

#정리

• ESP32-C3의 WiFi는 event-driven입니다. esp_wifi_* 호출은 명령일 뿐 결과는 event handler로 옵니다.
• 모드는 4가지입니다. STA, SoftAP, APSTA, NULL. APSTA는 라디오 하나라서 채널이 통일됩니다.
• 보안은 WPA2-Personal이 기본, WPA2/WPA3 Mixed가 권장입니다. WPA3는 PMF가 필수입니다.
• ESP-MESH는 최대 6 layer의 트리이고 root만 외부 라우터에 붙습니다. 대역폭은 layer마다 절반으로 줍니다.
• Provisioning은 BLE 방식이 양산에 가장 깔끔합니다. PoP는 제품 라벨 코드가 표준입니다.
• Modem sleep + DTIM listen_interval로 STA 평균 전류를 15 mA → 1.5 mA까지 끌어내릴 수 있습니다.
• 실제 throughput은 TCP 약 20 Mbps, UDP 약 30 Mbps가 최선입니다. C3는 IoT용이지 벌크 전송용이 아닙니다.
• reconnect 폭주는 신규 펌웨어의 1순위 버그입니다. 백오프와 retry count는 처음부터 박아 두는 것이 안전합니다.

#다음 편

Ch 8: BLE 5.0 — GAP·GATT·Coded PHY에서는 또 다른 무선 인터페이스인 Bluetooth Low Energy 5.0을 다룹니다. NimBLE 스택, GATT 서비스 설계, Coded PHY로 4배 거리 확장하기까지 살펴봅니다.

#관련 항목

• Ch 6: ADC·터치 센서
• Ch 8: BLE 5.0 — GAP·GATT·Coded PHY
• Ch 9: ESP-IDF — 빌드 시스템과 컴포넌트 구조
• Ch 12: 전력 관리 — Modem/Light/Deep Sleep — modem sleep 이어집니다
• Industrial Ethernet Ch 8: TSN — 유선 결정성과의 대비
• 원문 — ESP-IDF WiFi API Reference
• 원문 — ESP-MESH Programming Guide