.TH WIFI 1
.SH NAME
    wifi - scan for wireless networks and inspect the Wi-Fi adapter

.SH SYNOPSIS
    wifi [scan [seconds]]
    wifi info
    wifi debug
    wifi connect <ssid> [passphrase]
    wifi disconnect

.SH DESCRIPTION
    Drives the Intel Wi-Fi adapter. With no arguments, runs a five
    second scan and lists the networks found, strongest signal first.

    The driver supports Intel AX210-family devices whose RF type is
    GF (marketed as AX211), which is what the bundled firmware image
    covers. Other Intel wireless parts are left unclaimed.

.SH COMMANDS
    scan [seconds]
        Sweep every regulatory-permitted channel and report the
        networks seen. The duration is clamped to 1-20 seconds and
        defaults to 5.

    info
        Adapter status: MAC address, firmware version, supported
        bands, usable channel count and whether a scan is running.

    debug
        Everything info prints, plus RX/error counters, a scan with
        per-BSS detail (BSSID, channel, RSSI, security) and band and
        security tallies. Use this when a scan finds nothing.

    connect <ssid> [passphrase]
        Brings the firmware contexts (PHY, MAC, binding, station) up
        for a network from the last scan. The 802.11 authentication
        and association exchange is not implemented, so this does not
        produce a usable link; encrypted networks are refused outright.

    disconnect
        Tears those contexts back down.

.SH OUTPUT
    SSID                             SIGNAL  RSSI  CH   BAND    SECURITY
    -------------------------------------------------------------------
    homenet                          [####]  -42     6  2.4GHz  WPA2
    homenet-5g                       [###.]  -61    44  5GHz    WPA3
    guest                            [##..]  -74    11  2.4GHz  open

.SH FIRMWARE
    The adapter needs firmware from the ramdisk:

        0:/os/firmware/intel/iwlwifi-so-a0-gf-a0-<api>.ucode
        0:/os/firmware/intel/iwlwifi-so-a0-gf-a0.pnvm

    Loading happens shortly after boot, off the boot-critical path,
    so "wifi info" may briefly report "detected (firmware not loaded
    yet)". The PNVM file carries regulatory data; without it the
    firmware falls back to conservative built-in limits.

.SH DIAGNOSTICS
    no supported Wi-Fi adapter found
        No matching device, or its RF type is not GF.

    radio disabled (RF-kill)
        The hardware kill switch is off. No scanning is possible.

    error
        Firmware load or configuration failed; klog(1) has the
        detail under the WiFi and WiFi-FW tags.

.SH SEE ALSO
    ifconfig(1), klog(1), dhcp(1), syscalls(2)