Home /Modules/wifi-common/wifi_manager.h

wifi_manager.h

wifi-common/include/sleela_wifi/wifi_manager.h · 110 line(s) · c

#ifndef SLEELA_WIFI_MANAGER_H
#define SLEELA_WIFI_MANAGER_H

#include <stddef.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

#define WIFI_SSID_MAX_BYTES 32u
#define WIFI_BSSID_TEXT_SIZE 18u
#define WIFI_MAX_SCAN_RESULTS 128u
#define WIFI_SIGNAL_PERCENT_MAX 100u
#define WIFI_MIN_PERSONAL_PASSPHRASE_BYTES 8u
#define WIFI_MAX_PERSONAL_PASSPHRASE_BYTES 63u
#define WIFI_RAW_PSK_HEX_BYTES 64u

#define WIFI_DEFAULT_MINIMUM_SECURITY_RANK 4
#define WIFI_DEFAULT_ALLOW_OPEN_NETWORKS 0
#define WIFI_DEFAULT_ALLOW_LEGACY_WEP 0
#define WIFI_DEFAULT_REQUIRE_ENTERPRISE_TLS_VALIDATION 1
#define WIFI_DEFAULT_REQUIRE_PROTECTED_MANAGEMENT_FRAMES 0

typedef enum {
    WIFI_STATUS_OK = 0, WIFI_STATUS_INVALID_ARGUMENT,
    WIFI_STATUS_BACKEND_UNAVAILABLE, WIFI_STATUS_BACKEND_ERROR,
    WIFI_STATUS_BUFFER_TOO_SMALL, WIFI_STATUS_NETWORK_NOT_FOUND,
    WIFI_STATUS_POLICY_BLOCKED, WIFI_STATUS_AUTH_REQUIRED,
    WIFI_STATUS_NOT_CONNECTED
} wifi_status_t;

typedef enum {
    WIFI_SECURITY_UNKNOWN = 0, WIFI_SECURITY_OPEN, WIFI_SECURITY_WEP,
    WIFI_SECURITY_WPA_PERSONAL, WIFI_SECURITY_WPA2_PERSONAL,
    WIFI_SECURITY_WPA3_PERSONAL, WIFI_SECURITY_OWE,
    WIFI_SECURITY_WPA_ENTERPRISE, WIFI_SECURITY_WPA2_ENTERPRISE,
    WIFI_SECURITY_WPA3_ENTERPRISE
} wifi_security_t;

typedef enum {
    WIFI_AUTH_OS_MANAGED = 0, WIFI_AUTH_SAVED_PROFILE,
    WIFI_AUTH_PASSPHRASE, WIFI_AUTH_ENTERPRISE_PASSWORD
} wifi_auth_mode_t;

typedef struct {
    char ssid[WIFI_SSID_MAX_BYTES + 1u];
    char bssid[WIFI_BSSID_TEXT_SIZE];
    unsigned channel;
    unsigned frequency_mhz;
    unsigned signal_percent;
    wifi_security_t security;
    int in_use;
    int protected_management_frames; /* 1=yes, 0=no, -1=unknown */
} wifi_network_t;

typedef struct {
    wifi_auth_mode_t mode;
    const char *profile_name;
    const char *username;
    const char *password; /* never log; caller owns and clears it */
    const char *ca_certificate_file;
    const char *expected_server_name;
} wifi_auth_t;

typedef struct {
    int minimum_security_rank;
    int allow_open_networks;
    int allow_legacy_wep;
    int require_enterprise_tls_validation;
    int require_protected_management_frames;
} wifi_security_policy_t;

typedef struct wifi_backend {
    const char *name;
    wifi_status_t (*scan)(void *context, wifi_network_t *out, size_t capacity, size_t *out_count);
    wifi_status_t (*connect)(void *context, const wifi_network_t *network, const wifi_auth_t *auth);
    wifi_status_t (*disconnect)(void *context);
} wifi_backend_t;

typedef struct wifi_manager {
    const wifi_backend_t *backend;
    void *backend_context;
    wifi_security_policy_t policy;
    wifi_network_t last_scan[WIFI_MAX_SCAN_RESULTS];
    size_t last_scan_count;
    uint64_t scan_generation;
    int initialized;
} wifi_manager_t;

const wifi_backend_t *wifi_backend_default(void);
void wifi_security_policy_default(wifi_security_policy_t *policy);
wifi_status_t wifi_manager_init(wifi_manager_t *manager, const wifi_backend_t *backend,
                                void *backend_context, const wifi_security_policy_t *policy);
wifi_status_t wifi_manager_scan(wifi_manager_t *manager, wifi_network_t *out,
                                size_t capacity, size_t *out_count);
wifi_status_t wifi_manager_select(const wifi_manager_t *manager, size_t index, wifi_network_t *out);
wifi_status_t wifi_manager_connect(wifi_manager_t *manager, const wifi_network_t *selected,
                                   const wifi_auth_t *auth);
wifi_status_t wifi_manager_disconnect(wifi_manager_t *manager);
int wifi_security_rank(wifi_security_t security);
const char *wifi_security_name(wifi_security_t security);
const char *wifi_status_name(wifi_status_t status);
void wifi_secure_zero(void *memory, size_t length);

#ifdef __cplusplus
}
#endif
#endif