Network Class Reference

Static class providing Wi-Fi and network control on the Pico W. More...

#include <Network.h>

Collaboration diagram for Network:

Static Public Member Functions
static bool	initialize ()
	Start Wi-Fi with resilience, retrying connection if it fails.
static bool	startWifiWithResilience ()
	Start Wi-Fi with resilience, retrying connection if it fails.
static bool	checkAndReconnect ()
	Attempt to connect to Wi-Fi with retries.
static bool	tryConnect (int attempts)
	Try to connect to Wi-Fi network.
static bool	restart_wifi ()
	Restart the Wi-Fi interface.
static void	wifi_deinit ()
	Deinitialize the CYW43 Wi-Fi stack.
static int	getLinkStatus (int lastStatus)
	Get the current link status from the Wi-Fi interface.
static bool	isConnected ()
	Check whether the device is connected to Wi-Fi.
static char *	getIpAddress ()
	Get the IP address.

Static Private Attributes
static bool	wifiConnected = false
	Make the Wi-Fi connection in station mode Requires WIFI_SSID and WIFI_PASSWORD to be set in the environment.
static bool	wifiInitialized = false

Detailed Description

Definition at line 26 of file Network.h.

Member Function Documentation

checkAndReconnect()

bool Network::checkAndReconnect ( )

static

This method will try to connect to the Wi-Fi network defined by WIFI_SSID and WIFI_PASSWORD. It will retry up to a maximum number of attempts defined by WIFI_MAX_RETRIES.

Parameters

attempts

Number of connection attempts to make.

Returns

true if connected, false otherwise.

Definition at line 84 of file Network.cpp.

{
    if (isConnected() && getLinkStatus(CYW43_LINK_UP) == CYW43_LINK_UP)
    {
        return true; // Already connected
    }
 
    printf("[Network] Connection lost. Attempting reconnect...\n");
 
    cyw43_arch_enable_sta_mode(); // do not re-init or deinit
    return tryConnect(1);         // One-shot reconnect attempt
}

References getLinkStatus(), isConnected(), and tryConnect().

Referenced by FrameworkManager::poll().

Here is the call graph for this function:

Here is the caller graph for this function:

getIpAddress()

static char * Network::getIpAddress ( )

inlinestatic

Returns

true if connected and has IP

Definition at line 98 of file Network.h.

        {
            return ip4addr_ntoa(netif_ip4_addr(netif_list));
        }

getLinkStatus()

int Network::getLinkStatus ( int  lastStatus )

static

Get the current link status from the Wi-Fi interface.

Returns

int CYW43_LINK_UP, CYW43_LINK_DOWN, etc.

Returns

int CYW43_LINK_UP, CYW43_LINK_DOWN, etc.

Definition at line 173 of file Network.cpp.

{
 
    int status = cyw43_tcpip_link_status(&cyw43_state, CYW43_ITF_STA);
    switch (status)
    {
    case CYW43_LINK_UP:
        printf("\n[Network] Link is up\n");
        break;
 
    case CYW43_LINK_NOIP:
        if (lastStatus == CYW43_LINK_NOIP)
        {
            printf(".");
        }
        else
        {
            printf("\n[Network] Acquiring IP address ");
        }
        break;
 
    case CYW43_LINK_JOIN:
        if (lastStatus == CYW43_LINK_JOIN)
        {
            printf(".");
        }
        else
        {
            printf("\n[Network] Joining network ");
        }
        break;
 
    case CYW43_LINK_DOWN:
        printf("\n[Network] Link is down\n");
        break;
    }
    return status;
}

Referenced by checkAndReconnect(), and tryConnect().

Here is the caller graph for this function:

initialize()

bool Network::initialize ( )

static

Uses a static method to handle retries and connection status.

Returns

true if Wi-Fi started successfully, false otherwise.

Definition at line 41 of file Network.cpp.

{
    if (cyw43_arch_init())
    {
        printf("[Network] Failed to initialise Wi-Fi\n");
        return false;
    }
 
    cyw43_arch_gpio_put(CYW43_WL_GPIO_LED_PIN, 0); // LED off during startup
    cyw43_arch_enable_sta_mode();
    wifiInitialized = true;
    printf("[Network] Wi-Fi initialized successfully.\n");
    cyw43_arch_gpio_put(CYW43_WL_GPIO_LED_PIN, 1); // LED on after startup
    return true;
}

References wifiInitialized.

Referenced by FrameworkManager::onStart(), and startWifiWithResilience().

Here is the caller graph for this function:

isConnected()

bool Network::isConnected ( )

static

Check whether the device is connected to Wi-Fi.

Returns

true if connected

Returns

true if connected

Definition at line 144 of file Network.cpp.

{
    return wifiConnected;
}

References wifiConnected.

Referenced by checkAndReconnect(), and PicoModel::restoreState().

Here is the caller graph for this function:

restart_wifi()

bool Network::restart_wifi ( )

static

This method will deinitialize and reinitialize the Wi-Fi stack.

Returns

true if Wi-Fi restarted successfully, false otherwise.

Definition at line 149 of file Network.cpp.

{
    printf("[Network] Forcing Wi-Fi restart...\n");
 
    cyw43_arch_deinit();
    wifiConnected = false;
 
    return startWifiWithResilience();
}

References startWifiWithResilience(), and wifiConnected.

Referenced by FrameworkManager::poll().

Here is the call graph for this function:

Here is the caller graph for this function:

startWifiWithResilience()

bool Network::startWifiWithResilience ( )

static

Uses a static method to handle retries and connection status.

Returns

true if Wi-Fi started successfully, false otherwise.

Definition at line 63 of file Network.cpp.

{
    if (!wifiInitialized)
    {
        if (!initialize())
        {
            return false;
        }
        wifiInitialized = true;
    }
 
    bool success = tryConnect(WIFI_MAX_RETRIES);
 
    if (!success)
    {
        cyw43_arch_deinit(); // Only on total failure
    }
 
    return success;
}

References initialize(), tryConnect(), WIFI_MAX_RETRIES, and wifiInitialized.

Referenced by FrameworkManager::onStart(), and restart_wifi().

Here is the call graph for this function:

Here is the caller graph for this function:

tryConnect()

bool Network::tryConnect ( int  attempts )

static

This method will attempt to connect to the Wi-Fi network defined by WIFI_SSID and WIFI_PASSWORD. It will retry up to a maximum number of attempts defined by WIFI_MAX_RETRIES.

Parameters

attempts

Number of connection attempts to make.

Returns

true if connected, false otherwise.

Definition at line 97 of file Network.cpp.

{
    cyw43_arch_gpio_put(CYW43_WL_GPIO_LED_PIN, 0); // LED during all connect attempts
 
    uint32_t pm;
    cyw43_wifi_get_pm(&cyw43_state, &pm);
    cyw43_wifi_pm(&cyw43_state, CYW43_DEFAULT_PM & ~0xf); // disable power mgmt during connect
 
    for (int i = 0; i < attempts; ++i)
    {
        printf("\n\n[Network] Connecting to WiFi SSID: %s (attempt %d)\n", WIFI_SSID, i + 1);
 
        if (cyw43_arch_wifi_connect_async(WIFI_SSID, WIFI_PASSWORD, CYW43_AUTH_WPA2_MIXED_PSK) != 0)
        {
            printf("[Network] Failed to initiate connection.\n");
            vTaskDelay(pdMS_TO_TICKS(WIFI_RETRY_TIMEOUT_MS));
            continue;
        }
 
        int status = 0;
        int waitMs = 0;
        do
        {
            status = Network::getLinkStatus(status);
            vTaskDelay(pdMS_TO_TICKS(1000));
            waitMs += 1000;
        } while (status != CYW43_LINK_UP && waitMs < WIFI_RETRY_TIMEOUT_MS);
 
        if (status == CYW43_LINK_UP)
        {
            wifiConnected = true;
            printf("[Network] Connected to Wi-Fi network at %s\n", ip4addr_ntoa(netif_ip4_addr(netif_list)));
            cyw43_wifi_pm(&cyw43_state, pm);
            return true;
        }
 
        printf("[Network] Attempt %d failed.\n", i + 1);
    }
 
    wifiConnected = false;
    cyw43_wifi_pm(&cyw43_state, pm);
    return false;
}

References getLinkStatus(), WIFI_RETRY_TIMEOUT_MS, and wifiConnected.

Referenced by checkAndReconnect(), and startWifiWithResilience().

Here is the call graph for this function:

Here is the caller graph for this function:

wifi_deinit()

void Network::wifi_deinit ( )

static

Deinitialize the CYW43 Wi-Fi stack.

Definition at line 160 of file Network.cpp.

{
    cyw43_arch_deinit();
}

Member Data Documentation

wifiConnected

bool Network::wifiConnected = false

staticprivate

Make the Wi-Fi connection in station mode Requires WIFI_SSID and WIFI_PASSWORD to be set in the environment.

Definition at line 104 of file Network.h.

Referenced by isConnected(), restart_wifi(), and tryConnect().

wifiInitialized

bool Network::wifiInitialized = false

staticprivate

Definition at line 105 of file Network.h.

Referenced by initialize(), and startWifiWithResilience().

---

The documentation for this class was generated from the following files:

• Network.h
• Network.cpp