概要
简单而言就是找出空间中存在的所有WiFi信号，就像我们用手机打开WiFi功能后可以浏览附近的可用WiFi。要将手机连接到热点，通常需要打开Wi-Fi设置应用程序，列出可用的网络，然后选择所需的热点。然后输入密码（或不输入密码），可以使用ESP进行相同的操作。扫描类实现了扫描和列出范围内的可用网络的功能。
而扫描网络需要数百毫秒才能完成。当我们触发扫描功能，等待完成并提供结果时，这可以通过一次运行来完成-所有这些都由一个功能完成。另一种选择是将其分为多个步骤，每个步骤由一个单独的功能完成。这样，我们可以在扫描过程中执行其他任务。这称为异步扫描。
API分析
1.1、启动扫描
/**
* Start scan WiFi networks available
* @param async run in async mode
* @param show_hidden show hidden networks
* @return Number of discovered networks
*/
int16_t WiFiScanClass::scanNetworks(bool async, bool show_hidden, bool passive, uint32_t max_ms_per_chan, uint8_t channel)
asysnc 如果设置为 true 则扫描将在后台开始，并且功能将退出而无需等待结果。要检查结果，可以使用 scanComplete 下面介绍的单独功能。
show_hidden 将其设置true为包含在具有隐藏 SSID 的扫描结果网络中。
1.2、异步扫描进度查看
/**
* called to get the scan state in Async mode
* @return scan result or status
* -1 if scan not fin
* -2 if scan not triggered
*/
int16_t WiFiScanClass::scanComplete()
扫描完成功能返回发现的网络数。
如果未完成扫描，则返回值<0，如下所示：扫描仍在进行中：-1 尚未触发扫描：-2
1.3、各类信息查看
String SSID(uint8_t networkItem); // 网络名称
wifi_auth_mode_t encryptionType(uint8_t networkItem); // 查看加密
int32_t RSSI(uint8_t networkItem); // 信号强度
uint8_t * BSSID(uint8_t networkItem); // 描期间发现的网络的MAC地址的另一个名称。
String BSSIDstr(uint8_t networkItem);
int32_t channel(uint8_t networkItem);
1.4、所有网络信息
/**
* loads all infos from a scanned wifi in to the ptr parameters
* @param networkItem uint8_t
* @param ssid const char**
* @param encryptionType uint8_t *
* @param RSSI int32_t *
* @param BSSID uint8_t **
* @param channel int32_t *
* @return (true if ok)
*/
bool WiFiScanClass::getNetworkInfo(uint8_t i, String &ssid, uint8_t &encType, int32_t &rssi, uint8_t* &bssid, int32_t &channel)
该networkItem是网络的从零开始的索引扫描时发现的。所有其他输入参数均通过引用传递给函数。因此，将使用为特定的检索到的实际值更新它们networkItem。函数本身返回boolean true或false确认信息检索是否成功。
示例：
int n = WiFi.scanNetworks(false, true);
String ssid;
uint8_t encryptionType;
int32_t RSSI;
uint8_t* BSSID;
int32_t channel;
bool isHidden;
for (int i = 0; i < n; i++)
{
WiFi.getNetworkInfo(i, ssid, encryptionType, RSSI, BSSID, channel, isHidden);
Serial.printf("%d: %s, Ch:%d (%ddBm) %s %s\n", i + 1, ssid.c_str(), channel, RSSI, encryptionType == ENC_TYPE_NONE ? "open" : "", isHidden ? "hidden" : "");
}
例子1（同步扫描）
#include "WiFi.h"
void setup()
{
Serial.begin(9600);
// 设置为STA模式，并且断开连接
WiFi.mode(WIFI_STA);
WiFi.disconnect();
delay(100);
Serial.println("Setup done");
}
void loop()
{
Serial.println("scan start");
// WiFi.scanNetworks 会返回扫描得到的信号数
int n = WiFi.scanNetworks();
Serial.println("scan done");
if (n == 0) {
Serial.println("no networks found");
} else {
Serial.print(n);
Serial.println(" networks found");
for (int i = 0; i < n; ++i) {
// 输出各类信息
Serial.print(i + 1);
Serial.print(": ");
Serial.print(WiFi.SSID(i));
Serial.print(" (");
Serial.print(WiFi.RSSI(i));
Serial.print(")");
Serial.println((WiFi.encryptionType(i) == WIFI_AUTH_OPEN)?" ":"*");
delay(10);
}
}
Serial.println("");
delay(5000);
}
运行结果：
例子2（异步扫描）
通过上下两个程序的比较可知，异步扫描时程序仍然在跑，而不是等待扫描结果出来再继续。
#include <Arduino.h>
#include "WiFi.h"
void setup()
{
Serial.begin(9600);
WiFi.mode(WIFI_STA);
WiFi.disconnect();
delay(100);
Serial.println("Setup done");
Serial.println("scan start");
WiFi.scanNetworks(true,true);
}
void loop()
{
if(WiFi.scanComplete()>0){
int n = WiFi.scanComplete();
Serial.println("scan done");
if (n == 0) {
Serial.println("no networks found");
} else {
Serial.print(n);
Serial.println(" networks found");
for (int i = 0; i < n; ++i) {
// Print SSID and RSSI for each network found
Serial.print(i + 1);
Serial.print(": ");
Serial.print(WiFi.SSID(i));
Serial.print(" (");
Serial.print(WiFi.RSSI(i));
Serial.print(")");
Serial.println((WiFi.encryptionType(i) == WIFI_AUTH_OPEN)?" ":"*");
delay(10);
}
}
Serial.println("");
WiFi.scanDelete();
WiFi.scanNetworks(true,true);
}
Serial.println("scan wait");
delay(500);
}
运行结果：
评论区