找回密碼
 立即注冊(cè)

QQ登錄

只需一步，快速開始

搜索
查看: 7813|回復(fù): 0
打印 上一主題 下一主題
收起左側(cè)

【零知ESP8266】教程：WiFiScan庫(kù)的使用

[復(fù)制鏈接]
跳轉(zhuǎn)到指定樓層
樓主
本帖最后由 roc2 于 2019-6-19 10:55 編輯

概述：
無(wú)線網(wǎng)絡(luò)提供的WiFi熱點(diǎn)，大部分都開放了SSID廣播（記得之前博主講過(guò)WiFi熱點(diǎn)也可以隱藏的），Scan WiFi的功能就是掃描出所有附近的WiFi熱點(diǎn)的SSID信息，這樣一來(lái)，客戶端就可以根據(jù)需要選擇不同的SSID連入對(duì)應(yīng)的無(wú)線網(wǎng)絡(luò)中。
Scan WiFi庫(kù)提供了兩種方式實(shí)現(xiàn)掃描過(guò)程：
同步掃描：通過(guò)單個(gè)函數(shù)在一次運(yùn)行中完成，需要等待完成所有操作才能繼續(xù)運(yùn)行下面的操作。
異步掃描：把上面的過(guò)程分成幾個(gè)步驟，每個(gè)步驟由一個(gè)單獨(dú)函數(shù)完成，我們可以在掃描過(guò)程中執(zhí)行其他任務(wù)。
ESP8266WiFiScan庫(kù)
ESP8266WiFiScan庫(kù)，大家使用的時(shí)候只需要引入
  1. #include<ESP8266WiFi.h>
復(fù)制代碼
掃描操作方法1.scanNetworks —— 同步掃描周邊有效wifi網(wǎng)絡(luò)函數(shù)說(shuō)明：
  1. /**
  2. * Start scan WiFi networks available
  3. * @param async         run in async mode(是否啟動(dòng)異步掃描)
  4. * @param show_hidden   show hidden networks(是否掃描隱藏網(wǎng)絡(luò))
  5. * @param channel       scan only this channel (0 for all channels)(是否掃描特定通道)
  6. * @param ssid*         scan for only this ssid (NULL for all ssid's)(是否掃描特定的SSID)
  7. * @return Number of discovered networks
  8. */int8_t scanNetworks(bool async = false, bool show_hidden = false, uint8 channel = 0, uint8* ssid = NULL);
復(fù)制代碼
2.scanNetworks(async ) —— 異步掃描周邊有效wifi網(wǎng)絡(luò)
函數(shù)說(shuō)明：
  1. /**
  2. * Start scan WiFi networks available
  3. * @param async         run in async mode(是否啟動(dòng)異步掃描)
  4. * @param show_hidden   show hidden networks(是否掃描隱藏網(wǎng)絡(luò))
  5. * @param channel       scan only this channel (0 for all channels)(是否掃描特定通道)
  6. * @param ssid*         scan for only this ssid (NULL for all ssid's)(是否掃描特定的SSID)
  7. * @return Number of discovered networks
  8. */int8_t scanNetworks(bool async = false, bool show_hidden = false, uint8 channel = 0, uint8* ssid = NULL);
復(fù)制代碼
3.scanNetworksAsync —— 異步掃描周邊wifi網(wǎng)絡(luò)，并回調(diào)結(jié)果
函數(shù)說(shuō)明：
  1. /**
  2. * Starts scanning WiFi networks available in async mode
  3. * @param onComplete    the event handler executed when the scan is done
  4. * @param show_hidden   show hidden networks
  5.   */void scanNetworksAsync(std::function<void(int)> onComplete, bool show_hidden = false);
復(fù)制代碼
4. scanComplete —— 檢測(cè)異步掃描的結(jié)果
函數(shù)說(shuō)明：
  1. /**
  2. * called to get the scan state in Async mode(異步掃描的結(jié)果函數(shù))
  3. * @return scan result or status
  4. *          -1 if scan not find
  5. *          -2 if scan not triggered
  6. */
  7. int8_t scanComplete();
復(fù)制代碼
5.scanDelete —— 從內(nèi)存中刪掉最近掃描結(jié)果
函數(shù)說(shuō)明：
  1. /**
  2. * delete last scan result from RAM(從內(nèi)存中刪除最近的掃描結(jié)果)
  3. */void scanDelete();
復(fù)制代碼
掃描結(jié)果方法1. SSID —— 獲取wifi網(wǎng)絡(luò)名字
函數(shù)說(shuō)明：
  1. /**
  2. * Return the SSID discovered during the network scan.
  3. * @param i     specify from which network item want to get the information
  4. * @return       ssid string of the specified item on the networks scanned list
  5. */String SSID(uint8_t networkItem);
復(fù)制代碼
2.RSSI —— 獲取wifi網(wǎng)絡(luò)信號(hào)強(qiáng)度
函數(shù)說(shuō)明：
  1. /**
  2. * Return the RSSI of the networks discovered during the scanNetworks(信號(hào)強(qiáng)度)
  3. * @param i specify from which network item want to get the information
  4. * @return  signed value of RSSI of the specified item on the networks scanned list
  5. */int32_t RSSI(uint8_t networkItem);
復(fù)制代碼
3. encryptionType —— 獲取wifi網(wǎng)絡(luò)加密方式
函數(shù)說(shuō)明：
  1. /**
  2. * Return the encryption type of the networks discovered during the scanNetworks(加密方式)
  3. * @param i specify from which network item want to get the information
  4. * @return  encryption type (enum wl_enc_type) of the specified item on the networks scanned list
  5. * ............ Values map to 802.11 encryption suites.....................
  6. *    AUTH_OPEN          ---->     ENC_TYPE_WEP  = 5,
  7. *    AUTH_WEP           ---->     ENC_TYPE_TKIP = 2,
  8. *    AUTH_WPA_PSK       ---->     ENC_TYPE_CCMP = 4,
  9. * ........... except these two, 7 and 8 are reserved in 802.11-2007.......
  10. *    AUTH_WPA2_PSK      ---->     ENC_TYPE_NONE = 7,
  11. *    AUTH_WPA_WPA2_PSK  ---->     ENC_TYPE_AUTO = 8
  12. */uint8_t encryptionType(uint8_t networkItem);
復(fù)制代碼
4. BSSID —— 獲取wifi網(wǎng)絡(luò)mac地址
函數(shù)說(shuō)明：
  1. /**
  2. * return MAC / BSSID of scanned wifi (物理地址)
  3. * @param i specify from which network item want to get the information
  4. * @return uint8_t * MAC / BSSID of scanned wifi
  5. */uint8_t * BSSID(uint8_t networkItem);
  6. /**
  7. * return MAC / BSSID of scanned wifi (物理地址)
  8. * @param i specify from which network item want to get the information
  9. * @return uint8_t * MAC / BSSID of scanned wifi
  10. */String BSSIDstr(uint8_t networkItem);
復(fù)制代碼
5.getNetworkInfo —— 獲取整體網(wǎng)絡(luò)信息，名字，信號(hào)強(qiáng)度等
函數(shù)說(shuō)明：
  1. /**
  2. * loads all infos from a scanned wifi in to the ptr parameters
  3. * @param networkItem uint8_t
  4. * @param ssid  const char**
  5. * @param encryptionType uint8_t *
  6. * @param RSSI int32_t *
  7. * @param BSSID uint8_t **
  8. * @param channel int32_t *
  9. * @param isHidden bool *
  10. * @return (true if ok)
  11. */        bool getNetworkInfo(uint8_t networkItem, String &ssid, uint8_t &encryptionType, int32_t &RSSI, uint8_t* &BSSID, int32_t &channel, bool &isHidden);
復(fù)制代碼
6. channel —— 獲取wifi網(wǎng)絡(luò)通道號(hào)
函數(shù)說(shuō)明：
  1. /**
  2. * return channel of scanned wifi(通道號(hào))
  3. */int32_t channel(uint8_t networkItem);
復(fù)制代碼
7. isHidden —— 判斷wifi網(wǎng)絡(luò)是否是隱藏網(wǎng)絡(luò)
函數(shù)說(shuō)明：
  1. /**
  2. * return if the scanned wifi is Hidden (no SSID)(判斷掃描到的wifi是否是隱藏wifi)
  3. * @param networkItem specify from which network item want to get the information
  4. * @return bool (true == hidden)
  5. */bool isHidden(uint8_t networkItem);
復(fù)制代碼
動(dòng)手操作
多說(shuō)不宜，實(shí)驗(yàn)是檢驗(yàn)真理的唯一標(biāo)準(zhǔn)，下面我們就來(lái)實(shí)際操作一下吧。
打開零知開源開發(fā)工具，新建一個(gè)項(xiàng)目，輸入以下代碼，驗(yàn)證，上傳。

測(cè)試demo：
  1. /**
  2. * Demo：
  3. *    STA模式下，演示同步掃描Scan wifi功能
  4. * @author 云上上云
  5. * @date 2019/06/01
  6. */#include <ESP8266WiFi.h>
  7. //以下三個(gè)定義為調(diào)試定義#define DebugBegin(baud_rate)    Serial.begin(baud_rate)#define DebugPrintln(message)    Serial.println(message)#define DebugPrint(message)    Serial.print(message)
  8. void setup() {  //設(shè)置串口波特率，以便打印信息
  9.   DebugBegin(115200);  //延時(shí)5s 為了演示效果
  10.   delay(5000);  // 我不想別人連接我，只想做個(gè)站點(diǎn)
  11.   WiFi.mode(WIFI_STA);  //斷開連接
  12.   WiFi.disconnect();
  13.   delay(100);
  14.   DebugPrintln("Setup done");
  15. }
  16. void loop() {
  17.   DebugPrintln("scan start");  // 同步掃描，等待返回結(jié)果
  18.   int n = WiFi.scanNetworks();
  19.   DebugPrintln("scan done");  if (n == 0){
  20.     DebugPrintln("no networks found");
  21.   }else{
  22.     DebugPrint(n);
  23.     DebugPrintln(" networks found");    for (int i = 0; i < n; ++i){
  24.       DebugPrint(i + 1);
  25.       DebugPrint(": ");      //打印wifi賬號(hào)
  26.       DebugPrint(WiFi.SSID(i));
  27.       DebugPrint(",");
  28.       DebugPrint(String("Ch:")+WiFi.channel(i));
  29.       DebugPrint(",");
  30.       DebugPrint(WiFi.isHidden(i)?"hide":"show");
  31.       DebugPrint(" (");      //打印wifi信號(hào)強(qiáng)度
  32.       DebugPrint(WiFi.RSSI(i));
  33.       DebugPrint("dBm");
  34.       DebugPrint(")");      //打印wifi加密方式
  35.       DebugPrintln((WiFi.encryptionType(i) == ENC_TYPE_NONE)?"open":"*");
  36.       delay(10);
  37.     }
  38.   }
  39.   DebugPrintln("");  // 延時(shí)5s之后再次掃描
  40.   delay(5000);
  41. }
復(fù)制代碼
測(cè)試結(jié)果（附近潛在的WiFi熱點(diǎn)）：它可以掃描完附件所有WiFi。
更多詳細(xì)資料可到零知實(shí)驗(yàn)室官網(wǎng)免費(fèi)獲取。







分享到:  QQ好友和群QQ好友和群 QQ空間QQ空間 騰訊微博騰訊微博 騰訊朋友騰訊朋友
收藏收藏1 分享淘帖 頂頂 踩踩
回復(fù)

使用道具 舉報(bào)

本版積分規(guī)則

手機(jī)版|小黑屋|51黑電子論壇 |51黑電子論壇6群 QQ 管理員QQ:125739409;技術(shù)交流QQ群281945664

Powered by 單片機(jī)教程網(wǎng)

快速回復(fù) 返回頂部 返回列表