WiFi

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, delete_wifi_connection,
)

Function Reference

Function	Description
`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
`delete_wifi_connection(connection_name)`	Delete a saved WiFi connection

`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:

Parameter	Type	Default	Description
`interface`	`str`	`'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’)

When the scan fails, the dict has an error key and no access_points key. Use result.get('access_points', []) and check result.get('error').

`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:

Parameter	Type	Default	Description
`ssid`	`str`		Network name
`password`	`str`		Network password (empty string for open networks)
`interface`	`str`	`'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:

Parameter	Type	Default	Description
`interface`	`str`	`'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)

`delete_wifi_connection(connection_name)`

Delete a saved WiFi connection by name, which is usually the SSID.

from lager.protocols.wifi import delete_wifi_connection

result = delete_wifi_connection('OfficeNet')
if not result['deleted']:
    print(result.get('error'))  # For example "Connection not found"

Returns: dict with connection (the name), deleted (bool) and, on failure, error

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

Requirement	Description
WiFi Hardware	USB adapter or built-in
Permissions	Root/sudo access required
Supported Security	WPA2, 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

Getting Started

Development

Power & Simulation

Measurement

I/O & Communication

Utilities

Import

Function Reference

`scan_wifi(interface='wlan0')`

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

`get_wifi_status()`

`disconnect_wifi(interface='wlan0')`

`delete_wifi_connection(connection_name)`

Router Internet Access Control

Examples

Scan and Connect

Network Verification Test

Signal Strength Test

Connection Test

Hardware Requirements

Notes

​Import

​Function Reference

​scan_wifi(interface='wlan0')

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

​get_wifi_status()

​disconnect_wifi(interface='wlan0')

​delete_wifi_connection(connection_name)

​Router Internet Access Control

​Examples

​Scan and Connect

​Network Verification Test

​Signal Strength Test

​Connection Test

​Hardware Requirements

​Notes

Import

Function Reference

`scan_wifi(interface='wlan0')`

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

`get_wifi_status()`

`disconnect_wifi(interface='wlan0')`

`delete_wifi_connection(connection_name)`

Router Internet Access Control

Examples

Scan and Connect

Network Verification Test

Signal Strength Test

Connection Test

Hardware Requirements

Notes