feat: intel wi-fi (AX211) driver with network scanning

2026-08-06 08:36:10 +02:00
parent 75d92d560c
commit a01e63c717
21 changed files with 5649 additions and 4 deletions
@@ -0,0 +1,74 @@
+.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)