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

programs/include/Api/Syscall.hpp

@@ -219,6 +219,12 @@ namespace montauk::abi {
     static constexpr uint64_t SYS_DISPLAYSETMODE      = 156;
     static constexpr uint64_t SYS_DISPLAYBRIGHTNESS   = 157;
 
+    // Wi-Fi adapter control
+    static constexpr uint64_t SYS_WIFI_SCAN           = 158;  // (WifiNetwork*, maxCount, timeoutMs) -> count
+    static constexpr uint64_t SYS_WIFI_INFO           = 159;  // (WifiInfo*) -> 0, -1 if absent
+    static constexpr uint64_t SYS_WIFI_CONNECT        = 160;  // (ssid, password) -> 0, <0 on error
+    static constexpr uint64_t SYS_WIFI_DISCONNECT     = 161;  // () -> 0
+
     // Tunable parameters (for SYS_SDR_SETPARAM / SYS_SDR_GETPARAM).
     static constexpr int SDR_PARAM_FREQ        = 0;  // center frequency, Hz
     static constexpr int SDR_PARAM_SAMPLE_RATE = 1;  // sample rate, Hz
@@ -564,6 +570,46 @@ namespace montauk::abi {
         uint32_t _pad2;
     };
 
+    // Wi-Fi security suites reported in WifiNetwork.security.
+    static constexpr uint8_t WIFI_SEC_OPEN = 0;
+    static constexpr uint8_t WIFI_SEC_WEP  = 1;
+    static constexpr uint8_t WIFI_SEC_WPA  = 2;
+    static constexpr uint8_t WIFI_SEC_WPA2 = 3;
+    static constexpr uint8_t WIFI_SEC_WPA3 = 4;
+
+    // Adapter states reported in WifiInfo.state.
+    static constexpr uint8_t WIFI_STATE_ABSENT   = 0;  // no device
+    static constexpr uint8_t WIFI_STATE_DETECTED = 1;  // waiting for firmware load
+    static constexpr uint8_t WIFI_STATE_BOOTING  = 2;
+    static constexpr uint8_t WIFI_STATE_RUNNING  = 3;
+    static constexpr uint8_t WIFI_STATE_ERROR    = 4;
+    static constexpr uint8_t WIFI_STATE_RFKILL   = 5;  // radio disabled in hardware
+
+    // One scanned network (returned by SYS_WIFI_SCAN).
+    struct WifiNetwork {
+        char     ssid[36];        // NUL-terminated; empty for hidden networks
+        uint8_t  bssid[6];
+        uint8_t  channel;
+        int8_t   rssi;            // dBm
+        uint8_t  band;            // 0 = 2.4 GHz, 1 = 5 GHz
+        uint8_t  security;        // WIFI_SEC_*
+        uint16_t beaconInterval;  // TU
+    };
+
+    // Adapter status (returned by SYS_WIFI_INFO).
+    struct WifiInfo {
+        uint8_t  mac[6];
+        uint8_t  present;         // 1 if a supported device was found
+        uint8_t  state;           // WIFI_STATE_*
+        uint8_t  scanning;
+        uint8_t  bands;           // bit0 = 2.4 GHz, bit1 = 5 GHz
+        uint16_t channels;        // usable channels after regulatory filtering
+        char     fwVersion[32];
+        uint64_t rxPackets;
+        uint32_t fwErrors;
+        uint32_t connState;       // 0 idle, >0 connection setup in progress
+    };
+
     struct ThermalInfo {
         char     name[32];          // short zone name (e.g. "THRM", "TZ00")
         int32_t  temperature;       // tenths of degrees Celsius, or -1 if unavailable

programs/include/libc/montauk.h

@@ -181,6 +181,10 @@ extern "C" {
 #define MTK_SYS_DISPLAYMODES       155
 #define MTK_SYS_DISPLAYSETMODE     156
 #define MTK_SYS_DISPLAYBRIGHTNESS  157
+#define MTK_SYS_WIFI_SCAN          158
+#define MTK_SYS_WIFI_INFO          159
+#define MTK_SYS_WIFI_CONNECT       160
+#define MTK_SYS_WIFI_DISCONNECT    161
 /* @SYSCALLS-END */
 
 #define MTK_SOCK_TCP 1

programs/include/montauk/syscall.h

@@ -596,6 +596,27 @@ namespace montauk {
         return (int)syscall1(montauk::abi::SYS_BTINFO, (uint64_t)buf);
     }
 
+    // Wi-Fi. scan() runs a full channel sweep and blocks until it finishes or
+    // timeoutMs elapses, then fills buf with the networks seen; it returns the
+    // number of entries written, or -1 when no adapter is ready.
+    inline int wifi_scan(montauk::abi::WifiNetwork* buf, int maxCount,
+                         uint32_t timeoutMs) {
+        return (int)syscall3(montauk::abi::SYS_WIFI_SCAN, (uint64_t)buf,
+                             (uint64_t)maxCount, (uint64_t)timeoutMs);
+    }
+    inline int wifi_info(montauk::abi::WifiInfo* out) {
+        return (int)syscall1(montauk::abi::SYS_WIFI_INFO, (uint64_t)out);
+    }
+    // Association is groundwork only: open networks bring the firmware
+    // contexts up, encrypted ones are rejected with -2.
+    inline int wifi_connect(const char* ssid, const char* password) {
+        return (int)syscall2(montauk::abi::SYS_WIFI_CONNECT, (uint64_t)ssid,
+                             (uint64_t)password);
+    }
+    inline int wifi_disconnect() {
+        return (int)syscall0(montauk::abi::SYS_WIFI_DISCONNECT);
+    }
+
     // Software-defined radio (Rx). Receivers are identified by index [0, count);
     // open() returns a handle used by the rest of the calls. Samples are read
     // as interleaved 8-bit unsigned I/Q (CU8) from the device's ring buffer.