.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 status
    wifi disconnect
    wifi saved
    wifi forget <ssid>

.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]
        Joins a network from the last scan: open, or WPA2/WPA3-PSK
        with CCMP or GCMP. Blocks until the link is up or the attempt
        fails, and says which it was. A passphrase given here is
        remembered in 0:/config/wifi.toml; given only an SSID, the
        remembered one is used. Run dhcp(1) afterwards for an address.

    status
        The network currently joined, with signal and cipher.

    disconnect
        Leaves the network and tears the firmware contexts down.

    saved
        Lists the networks in 0:/config/wifi.toml and whether the
        desktop rejoins them by itself at startup.

    forget <ssid>
        Removes a network from 0:/config/wifi.toml.

.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 SAVED NETWORKS
    0:/config/wifi.toml holds the networks the system may rejoin
    without being asked, as [network.<n>] tables of ssid and psk, and
    a wifi.autoconnect flag. The desktop writes it when "Remember this
    network" is ticked, and reads it after the automatic scan it runs
    at startup. Passphrases are stored as typed; anyone who can read
    0:/config can read them.

.SH GRAPHICAL USE
    The desktop panel carries a Wi-Fi icon whenever a supported
    adapter is present, separate from the Ethernet one. Its menu lists
    the networks in range, asks for a passphrase when one is needed,
    and shows the address once the link is up. The Network app has the
    same list under its Wi-Fi tab, along with Forget.

.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)