Skip to main content
Manage WiFi network connections on Lager Boxes. WiFi operations are box-level functions — they manage the box’s own wireless interface, not a test net on a PCB.

​
Import

from lager.protocols.wifi import scan_wifi, connect_to_wifi, get_wifi_status, disconnect_wifi

​
Function Reference

FunctionDescription
scan_wifi(interface)Scan for available WiFi networks
connect_to_wifi(ssid, password, interface)Connect to a WiFi network
get_wifi_status()Get current WiFi connection status
disconnect_wifi(interface)Disconnect from WiFi network

​
scan_wifi(interface='wlan0')

Scan for available WiFi networks. 
from lager.protocols.wifi import scan_wifi

result = scan_wifi()
networks = result.get('access_points', [])

for network in networks:
    print(f"{network['ssid']}: {network['strength']}%")
Parameters:
ParameterTypeDefaultDescription
interfacestr'wlan0'Network interface to scan on
Returns: dict with key access_points containing a list of network dicts, each with:
  • ssid - Network name
  • strength - Signal strength as percentage (0-100)
  • security - Security type (‘Open’ or ‘Secured’)

​
connect_to_wifi(ssid, password, interface='wlan0')

Connect to a WiFi network. 
from lager.protocols.wifi import connect_to_wifi

result = connect_to_wifi('MyNetwork', 'secret123')

if result['success']:
    print(f"Connected: {result['message']}")
else:
    print(f"Failed: {result['error']}")
Parameters:
ParameterTypeDefaultDescription
ssidstrNetwork name
passwordstrNetwork password (empty string for open networks)
interfacestr'wlan0'Network interface to use
Returns: dict with keys:
  • success - Boolean indicating connection success
  • message - Success message (when success is True)
  • error - Error message (when success is False)

​
get_wifi_status()

Get current WiFi connection status for all interfaces. 
from lager.protocols.wifi import get_wifi_status

interfaces = get_wifi_status()

for name, info in interfaces.items():
    print(f"{name}: {info['state']} - {info['ssid']}")
Returns: dict keyed by interface name, each value containing:
  • interface - Interface name
  • ssid - Connected network name or ‘Not Connected’
  • state - ‘Connected’ or ‘Disconnected’

​
disconnect_wifi(interface='wlan0')

Disconnect from the current WiFi network. 
from lager.protocols.wifi import disconnect_wifi

result = disconnect_wifi()

if result['success']:
    print(f"Disconnected: {result['message']}")
else:
    print(f"Failed: {result['error']}")
Parameters:
ParameterTypeDefaultDescription
interfacestr'wlan0'Network interface to disconnect
Returns: dict with keys:
  • success - Boolean indicating disconnect success
  • message - Success message (when success is True)
  • error - Error message (when success is False)

​
Router Internet Access Control

The Wifi net type controls internet access via an Asus router’s parental control feature. This is a separate concern from box-level WiFi management — it blocks/unblocks a device’s internet access by MAC address. 
from lager import Net, NetType

# Requires a wifi net configured with router credentials
wifi = Net.get('wifi1', type=NetType.Wifi)

wifi.disable()   # Block internet access (parental control)
wifi.enable()    # Restore internet access

​
Examples

​
Scan and Connect

from lager.protocols.wifi import scan_wifi, connect_to_wifi, get_wifi_status
import time

# Scan for networks
result = scan_wifi()
networks = result.get('access_points', [])

# Find target network
for network in networks:
    if network['ssid'] == 'TestNetwork':
        print(f"Found: {network['strength']}% signal")
        break

# Connect
result = connect_to_wifi('TestNetwork', 'password123')

if result['success']:
    print(f"Connection successful: {result['message']}")
else:
    print(f"Connection failed: {result['error']}")

# Wait for connection to stabilize
time.sleep(5)

# Verify status
interfaces = get_wifi_status()
for name, info in interfaces.items():
    if info['state'] == 'Connected':
        print(f"Connected to {info['ssid']} on {name}")

​
Network Verification Test

from lager.protocols.wifi import scan_wifi

def verify_network_visible(expected_ssid):
    result = scan_wifi()
    networks = result.get('access_points', [])
    ssids = [n['ssid'] for n in networks]

    if expected_ssid in ssids:
        print(f"PASS: {expected_ssid} is visible")
        return True
    else:
        print(f"FAIL: {expected_ssid} not found")
        return False

​
Signal Strength Test

from lager.protocols.wifi import scan_wifi

def check_signal_strength(ssid, min_strength=50):
    """Check if signal strength meets minimum threshold (0-100%)"""
    result = scan_wifi()
    networks = result.get('access_points', [])

    for network in networks:
        if network['ssid'] == ssid:
            strength = network['strength']
            if strength >= min_strength:
                print(f"PASS: {ssid} signal {strength}%")
                return True
            else:
                print(f"FAIL: {ssid} signal {strength}% below {min_strength}%")
                return False

    print(f"FAIL: {ssid} not found")
    return False

​
Connection Test

from lager.protocols.wifi import connect_to_wifi, get_wifi_status
import time

def test_wifi_connection(ssid, password):
    result = connect_to_wifi(ssid, password)

    if not result['success']:
        print(f"FAIL: Connection error - {result['error']}")
        return False

    time.sleep(5)

    interfaces = get_wifi_status()
    for name, info in interfaces.items():
        if info['state'] == 'Connected' and info['ssid'] == ssid:
            print(f"PASS: Connected to {ssid}")
            return True

    print(f"FAIL: Not connected to {ssid}")
    return False

​
Hardware Requirements

RequirementDescription
WiFi HardwareUSB adapter or built-in
PermissionsRoot/sudo access required
Supported SecurityWPA2, WPA3, Open

​
Notes

  • Lager Box must have WiFi hardware
  • Root/sudo access required for most operations
  • WPA2/WPA3 networks supported
  • Open networks require empty password string ('')
  • Interface defaults to ‘wlan0’
  • get_wifi_status() takes no parameters and returns all interfaces
  • Router management (enable/disable) requires Asus router with parental control and a configured wifi net