Join Wi-Fi

Wi-Fi Station join

Join an existing router and get an IP. Almost every cloud product starts here.

Join Wi-Fi Join a router ESP32 / S2 / S3 / C3 / C6 (Wi-Fi parts)

Official path: examples/wifi/getting_started/station

01 Overview

The chip runs as STA and joins an AP. This sits under almost every ESP32 cloud product.

Use when: the site already has Wi-Fi.
Skip when: no router (SoftAP / provisioning) or phone-only control (BLE).
Official proves: SSID/password, printed IP, retries then fail log.
Official does not: provisioning UI, encrypted storage, antenna certification.

1. Init NVS.

2. Register STA events including GOT_IP.

3. Load SSID/password, start WIFI_MODE_STA.

4. State machine: init → auth → assoc → run.

5. Products wait for GOT_IP before MQTT/HTTP; never ship hardcoded credentials.

中文

连上 Wi-Fi

设备加入现有路由器并拿到 IP。上网产品几乎都从这里开始。

连上 Wi-Fi 加入路由器 ESP32 / S2 / S3 / C3 / C6 (Wi-Fi parts)

官方路径: examples/wifi/getting_started/station

设备作为 STA 连接 AP。几乎所有要上云的 ESP32 产品都经过这一步。

1. 初始化 NVS（Wi-Fi 驱动依赖）。

2. 注册 STA 事件：开始连接、GOT_IP、断开。

3. menuconfig 写入 SSID/密码，启动 WIFI_MODE_STA。

4. 状态：init → auth → assoc → run。

5. 产品必须等 GOT_IP 再开 MQTT/HTTP；SSID 不能写死出货。