qwf_wifi_SavedNetwork_t

Updated: April 19, 2023

Data for a Saved Network

Synopsis:

#include <qwf/qwf_wifi.h>
typedef struct qwf_wifi_SavedNetwork_s {
    uint16_t networkId;
    qwf_wifi_Ssid_t ssid;
    int signalLevel;
    qwf_wifi_FrequencyBand_e frequencyBand;
    bool available;
    bool enabled;
    bool connected;
    qwf_wifi_SecurityProtocol_e supportedProtocols;
    uint16_t priority;
    char bssid[QWF_WIFI_MAX_BSSID_LEN+1];
    qwf_wifi_BgScanInfo_t bgScanData;
} qwf_wifi_SavedNetwork_t;

Data:

uint16_t networkId

ID of the Saved Network

qwf_wifi_Ssid_t ssid

SSID of the network's Access Point, as a NULL-terminated string

int signalLevel

Most recent signal level (if the network is available)

qwf_wifi_FrequencyBand_e frequencyBand

Frequency band used by the Saved Network

bool available

Whether this network is “available” (i.e., found in the latest scan results)

bool enabled

Whether this network is “enabled” (i.e., ready to be connected to)

bool connected

Whether this network is the currently connected Wi-Fi network

qwf_wifi_SecurityProtocol_e supportedProtocols

Security protocols supported by the Access Point, as a bitmask of qwf_wifi_SecurityProtocol_e flags

uint16_t priority

Priority of the Saved Network (within an ESS). A lower value means a higher priority, with 1 being the highest priority and 0 meaning the priority isn't used in network selection.

char bssid[QWF_WIFI_MAX_BSSID_LEN+1]

BSSID address of the network to select within the ESS, as a NULL-terminated string

qwf_wifi_BgScanInfo_t bgScanData

Background scanning information (see qwf_wifi_BgScanInfo_t)

Library:

qwf_interface

Description:

This structure type stores data for Saved Network entries. An array of these structures is written by qwf_wifi_GetSavedNetworks(). The contents of each structure remain valid until the function is called again.