Join Wi-Fi

Wi-Fi SoftAP hotspot

The device hosts its own hotspot for phone-based provisioning or local control.

Join Wi-Fi Device hotspot ESP32 Wi-Fi parts

Official path: examples/wifi/getting_started/softAP

01 Overview

ESP32 operates as an access point. Suitable for first-time setup or environments without a router.

Use when: out-of-box setup, factory floor LAN.
Avoid when: the device is already on the customer's router and only needs cloud access.
Officially verified: SSID broadcast and STA association.
Not implemented by the official example: captive portal, auto-shutdown, AP+STA coexistence policy.

Module and antenna requirements are the same as in Station mode.
Multiple connected clients increase current draw and heat; ensure adequate 3.3V rail margin.

1. Set WIFI_MODE_AP with SSID, channel, and max client count.

2. DHCP assigns addresses to phones.

3. Products typically add an HTTP server for a configuration page.

4. After provisioning, switch to STA or APSTA — do not leave an open hotspot running indefinitely.

An open hotspot is a security risk. At minimum, require a password and a timeout.
Choose a channel with minimal interference.
Customization options: captive portal, AP+STA mode, hotspot shutdown policy.

中文

连上 Wi-Fi

设备自建热点，手机连接后用于配网或本地控制。

连上 Wi-Fi 设备开热点 ESP32 Wi-Fi parts

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

ESP32 作为 AP 运行。适用于首次配网或现场无路由器场景。

1. 设置 WIFI_MODE_AP，配置 SSID、信道、最大连接数。

2. DHCP 为手机分配地址。

3. 产品通常需额外运行 HTTP Server 提供配网页面。

4. 配网完成后应切换至 STA 或 APSTA，避免长期开放热点。