wifi.h

Go to the documentation of this file.

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

// CONSTANTS

#ifndef HW_WIFI_SSID_MAX_LENGTH
#define HW_WIFI_SSID_MAX_LENGTH 32
#endif

// 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_status = (1 << 7),       
} 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;

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 *userdata);

// LIFECYCLE

hw_wifi_t *hw_wifi_init_client(const char *country_code,
                               hw_wifi_callback_t callback, void *userdata);

hw_wifi_t *hw_wifi_init_accesspoint(const char *country_code,
                                    const char *ssid, const char *password,
                                    hw_wifi_auth_t auth);

hw_wifi_t *hw_wifi_init_device(const char *device, hw_wifi_callback_t callback,
                               void *userdata);

void hw_wifi_deinit(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);