114 lines
3.5 KiB
C
114 lines
3.5 KiB
C
//
|
|
// Created by shinys on 25. 7. 10.
|
|
//
|
|
|
|
#ifndef WIFI_H
|
|
#define WIFI_H
|
|
#include "esp_err.h"
|
|
#include "esp_netif_types.h"
|
|
#include "esp_wifi_types_generic.h"
|
|
|
|
/**
|
|
* @brief Initializes the Wi-Fi driver, network interfaces, and event handlers.
|
|
*/
|
|
void wifi_init(void);
|
|
|
|
/**
|
|
* @brief Converts a Wi-Fi authentication mode enum to its string representation.
|
|
* @param mode The Wi-Fi authentication mode.
|
|
* @return A string describing the authentication mode.
|
|
*/
|
|
const char* auth_mode_str(wifi_auth_mode_t mode);
|
|
|
|
/**
|
|
* @brief Converts a Wi-Fi disconnection reason enum to its string representation.
|
|
* @param reason The reason for disconnection.
|
|
* @return A string describing the reason.
|
|
*/
|
|
const char* wifi_reason_str(wifi_err_reason_t reason);
|
|
|
|
/**
|
|
* @brief Connects the device to the configured Wi-Fi AP in STA mode.
|
|
* @return ESP_OK on success, or an error code on failure.
|
|
*/
|
|
esp_err_t wifi_connect(void);
|
|
|
|
/**
|
|
* @brief Disconnects the device from the current Wi-Fi AP in STA mode.
|
|
* @return ESP_OK on success, or an error code on failure.
|
|
*/
|
|
esp_err_t wifi_disconnect(void);
|
|
|
|
/**
|
|
* @brief Scans for available Wi-Fi access points.
|
|
* @param ap_records A pointer to store the found AP records.
|
|
* @param count A pointer to store the number of found APs.
|
|
*/
|
|
void wifi_scan_aps(wifi_ap_record_t** ap_records, uint16_t* count);
|
|
|
|
/**
|
|
* @brief Gets information about the currently connected access point.
|
|
* @param ap_info A pointer to a structure to store the AP information.
|
|
* @return ESP_OK on success, or an error code on failure.
|
|
*/
|
|
esp_err_t wifi_get_current_ap_info(wifi_ap_record_t* ap_info);
|
|
|
|
/**
|
|
* @brief Gets the current IP information for the STA interface.
|
|
* @param ip_info A pointer to a structure to store the IP information.
|
|
* @return ESP_OK on success, or an error code on failure.
|
|
*/
|
|
esp_err_t wifi_get_current_ip_info(esp_netif_ip_info_t* ip_info);
|
|
|
|
/**
|
|
* @brief Gets the DNS server information for the STA interface.
|
|
* @param type The type of DNS server (main, backup, fallback).
|
|
* @param dns_info A pointer to a structure to store the DNS information.
|
|
* @return ESP_OK on success, or an error code on failure.
|
|
*/
|
|
esp_err_t wifi_get_dns_info(esp_netif_dns_type_t type, esp_netif_dns_info_t* dns_info);
|
|
|
|
/**
|
|
* @brief Configures the STA interface to use DHCP.
|
|
* @return ESP_OK on success, or an error code on failure.
|
|
*/
|
|
esp_err_t wifi_use_dhcp(void);
|
|
|
|
/**
|
|
* @brief Configures the STA interface to use a static IP address.
|
|
* @param ip The static IP address.
|
|
* @param gw The gateway address.
|
|
* @param netmask The subnet mask.
|
|
* @param dns1 The primary DNS server.
|
|
* @param dns2 The secondary DNS server (optional).
|
|
* @return ESP_OK on success, or an error code on failure.
|
|
*/
|
|
esp_err_t wifi_use_static(const char* ip, const char* gw, const char* netmask, const char* dns1, const char* dns2);
|
|
|
|
/**
|
|
* @brief Switches the Wi-Fi operating mode (e.g., sta, apsta).
|
|
* @param mode The target Wi-Fi mode as a string ("sta" or "apsta").
|
|
* @return ESP_OK on success, or an error code on failure.
|
|
*/
|
|
esp_err_t wifi_switch_mode(const char* mode);
|
|
|
|
/**
|
|
* @brief Initializes the SNTP service for time synchronization.
|
|
*/
|
|
void initialize_sntp(void);
|
|
|
|
/**
|
|
* @brief Starts the SNTP time synchronization process.
|
|
*/
|
|
void sync_time();
|
|
|
|
/**
|
|
* @brief Sets the SSID and password for the STA mode, saves them to NVS, and connects to the AP.
|
|
* @param ssid The SSID of the access point.
|
|
* @param password The password of the access point.
|
|
* @return ESP_OK on success, or an error code on failure.
|
|
*/
|
|
esp_err_t wifi_sta_set_ap(const char* ssid, const char* password);
|
|
|
|
#endif // WIFI_H
|