wifi.h

Go to the documentation of this file.

#pragma once
#include <stdbool.h>
#include <stdint.h>

// GLOBALS

#define HW_WIFI_SSID_MAX_LENGTH 32

// TYPES

typedef enum {
  hw_wifi_auth_open = (1 << 0),      
  hw_wifi_auth_wep = (1 << 1),       
  hw_wifi_auth_wpa_tkip = (1 << 2),  
  hw_wifi_auth_wpa_aes = (1 << 3),   
  hw_wifi_auth_wpa2_tkip = (1 << 4), 
  hw_wifi_auth_wpa2_aes = (1 << 5),  
  hw_wifi_auth_wpa3_sae = (1 << 6),  
  hw_wifi_auth_enterprise = (1 << 7) 
} hw_wifi_auth_t;

typedef enum {
  hw_wifi_event_scan = (1 << 0),         
  hw_wifi_event_joining = (1 << 1),      
  hw_wifi_event_connected = (1 << 2),    
  hw_wifi_event_disconnected = (1 << 3), 
  hw_wifi_event_badauth =
      (1 << 4), 
  hw_wifi_event_notfound = (1 << 5), 
  hw_wifi_event_error = (1 << 6)     
} hw_wifi_event_t;

typedef struct {
  char ssid[HW_WIFI_SSID_MAX_LENGTH +
            1];        
  uint8_t bssid[6];    
  hw_wifi_auth_t auth; 
  uint8_t channel;     
  int16_t rssi;        
} hw_wifi_network_t;

// Opaque Wi‑Fi handle type
typedef struct hw_wifi_t hw_wifi_t;

typedef void (*hw_wifi_callback_t)(hw_wifi_t *wifi, hw_wifi_event_t event,
                                   const hw_wifi_network_t *network,
                                   void *user_data);

// LIFECYCLE

hw_wifi_t *hw_wifi_init(const char *country_code, hw_wifi_callback_t callback,
                        void *user_data);

bool hw_wifi_valid(hw_wifi_t *wifi);

void hw_wifi_finalize(hw_wifi_t *wifi);

// METHODS

bool hw_wifi_scan(hw_wifi_t *wifi);

bool hw_wifi_connect(hw_wifi_t *wifi, const hw_wifi_network_t *network,
                     const char *password);

bool hw_wifi_disconnect(hw_wifi_t *wifi);