Join Wi-Fi

Wi-Fi Scan

List nearby APs and RSSI. Used for channel choice and provisioning lists.

Join Wi-Fi Scan networks ESP32 Wi-Fi parts

Official path: examples/wifi/scan

01 Overview

Scan prints SSID, RSSI and auth mode. Provisioning UIs are built on this.

  • Use when: showing networks before join, or hunting interference.
  • Skip when: already joined and not changing network.

02 Hardware

  • No extra parts. Antenna placement changes RSSI a lot.
  • A metal housing scans differently than a bare module — measure the full unit.

03 Software flow

1. Init Wi-Fi and start scan.

2. Read AP records in the callback.

3. Products filter hidden SSIDs, sort by RSSI, and avoid blocking the main task.

04 Core points

  • RSSI is comparative, not a rangefinder.
  • A scan can interrupt the current link.
  • Custom work: list protocol for the phone UI, scan window.

中文

连上 Wi-Fi

Wi-Fi Scan 扫网

列出周围热点和信号，用来选信道、做配网列表。

连上 Wi-Fi 扫描附近网络 ESP32 Wi-Fi parts

官方路径: examples/wifi/scan

01 项目概述

扫描周边 AP，打印 SSID、RSSI、认证类型。配网 App 的列表通常来自这里。

  • 适用： 配网前展示网络、现场干扰排查。
  • 不适用： 已经连上且不需要换网。

02 项目硬件描述

  • 无需额外器件；天线位置会明显改变 RSSI 读数。
  • 金属壳里扫到的列表和裸板不同，要以整机实测为准。

03 项目软件流程描述

1. 初始化 Wi-Fi，发起 scan。

2. 回调里拿到 AP 记录。

3. 产品要过滤隐藏网、按 RSSI 排序、避免阻塞主任务。

04 项目核心点

  • RSSI 只能比较，不能当距离计。
  • 扫描会打断当前连接。 已在线产品要选空闲时扫。
  • 可定制： 配网列表 UI 协议、扫描窗口。