arduino/esp8266
1
0
Fork 0
mirror of https://github.com/esp8266/Arduino.git synced 2025-07-30 16:24:09 +03:00
Code Activity

Update WiFi scan docs (#8685)

Browse Source
This commit is contained in:
Max Prokhorov
2022-10-10 18:08:06 +03:00
committed by GitHub
parent 5c22dbc163
commit 7b2c627ed4
2 changed files with 32 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
doc/esp8266wifi/scan-class.rst
View File

@ -236,3 +236,29 @@ The ``networkItem`` is a zero based index of network discovered during scan. All
6: UPC Wi-Free, Ch:11 (-79dBm)
For code samples please refer to separate section with `examples <scan-examples.rst>`__ dedicated specifically to the Scan Class.
getScanInfoByIndex
^^^^^^^^^^^^^^^^^^
Similar to the ``getNetworkInfo``, but instead returns a pointer to the Nth ``bss_info`` structure which is internally used by the NONOS SDK.
.. code:: cpp
WiFi.getScanInfoByIndex(networkItem)
The ``networkItem`` is a zero based index of network discovered during scan. Function will return ``nullptr`` when ``networkItem`` is greater than the number of networks in the scan result or when there are no scan results available.
.. code:: cpp
auto n = WiFi.scanNetworks(false, true);
if (n <= 0) {
// scan failed or there are no results
return;
}
for (int i = 0; i < n; i++)
const auto* info = WiFi.getScanInfoByIndex(i)
// ... use the raw data from the bss_info structure ...
}
See ``tools/sdk/include/user_interface.h`` for all available fields and `examples <scan-examples.rst>`__.