Join Wi-Fi

Wi-Fi Provisioning

How a production unit receives its SSID. Required to ship.

Join Wi-Fi First-time Wi-Fi setupPhone connects in ESP32 Wi-Fi parts

Official path: examples/provisioning/wifi_prov_mgr

01 Overview

Official manager can carry credentials over BLE or SoftAP.

  • Use when: boxed devices that must join a home or factory AP.
  • Skip when: lab units with hardcoded passwords.

02 Hardware

  • BLE provisioning needs a BLE chip (not S2).
  • Include a reset-to-provision button.

03 Software flow

1. Start prov manager, pick transport.

2. Phone sends SSID/password.

3. Save to NVS; later boots auto-join.

4. Allow re-entry on failure.

04 Core points

  • No provisioning, no shippable Wi-Fi product.
  • Custom work: App protocol, reset, share with GATT.

中文

连上 Wi-Fi

Wi-Fi Provisioning 配网

量产设备第一次如何把 SSID 交给芯片。出货必做。

连上 Wi-Fi 第一次配网被手机连接 ESP32 Wi-Fi parts

官方路径: examples/provisioning/wifi_prov_mgr

01 项目概述

官方配网管理器，可用 BLE 或 SoftAP 把 Wi-Fi 凭据送进设备。

  • 适用： 消费/工商业设备开箱联网。
  • 不适用： 实验室写死密码的样机。

02 项目硬件描述

  • BLE 配网需要 BLE 芯片（S2 无 BLE）。
  • 建议有重置配网键。

03 项目软件流程描述

1. 启动 prov manager，选传输（BLE/SoftAP）。

2. 手机 App 送 SSID/密码。

3. 成功写入 NVS，以后冷启动自连。

4. 失败要可重新进入配网。

04 项目核心点

  • 没有配网就没有可出货的 Wi-Fi 产品。
  • 可定制： App 协议、重置逻辑、与 GATT 共用。