75 lines
2.6 KiB
Groff
75 lines
2.6 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 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)
|