ESP32-Scan扫描

概要

简单而言就是找出空间中存在的所有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);
}

运行结果：