A wrapper library that uses wpa_cli for connecting a Raspberry Pi to Wi-Fi.

$ npm i @hi-brylle/rpi-wifi-connection

import RpiWiFiConnection from '@hi-brylle/rpi-wifi-connection';
let wifi = new RpiWiFiConnection() // "wlan0" default network interface

Type returned when scanning for available networks.

interface WiFiNetwork {
    bssid: string,
    frequency: number,
    signal_level: number,
    ssid: string
}

Type returned when querying for networks previously connected to.

interface ConfiguredNetwork {
    id: number,
    ssid: string
}

Returns a singleton list containing the sole SSID if device is connected or empty list if not connected.

Returns a list of WifiNetwork or empty list if nothing is detected.

Returns a list of ConfiguredNetwork or empty list if the RPi has never connected to a Wi-Fi network.

Attempts connection with ssid and password input. Doesn't return anything. Use get_status() to check whether connection attempt succeeded.

Remove previously configured network from the RPi to prevent it from auto-connecting to that network in the future.

Auto-connect to a previously configured network. If ssid input doesn't belong to the list returned by get_configured_networks(), nothing happens. Use get_status() to check whether connection attempt succeeded.

Disconnect from Wi-Fi.

Reconnect to Wi-Fi. Effects may not be immediate so call get_status() to check connection status or call scan_networks() to query all available networks after some timeout.