104 lines
3.7 KiB
Groff
104 lines
3.7 KiB
Groff
.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)
|