6c283553f9
When no WiFi credentials are configured or connection fails, the device automatically starts a soft AP (MimiClaw-XXXX) with a captive portal. Users can configure WiFi, LLM, Telegram, Feishu, Proxy and Search settings via a mobile-friendly web page, then the device restarts and connects with the new credentials. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
62 lines
1.3 KiB
C
62 lines
1.3 KiB
C
#pragma once
|
|
|
|
#include "esp_err.h"
|
|
#include "esp_event.h"
|
|
#include "freertos/FreeRTOS.h"
|
|
#include "freertos/event_groups.h"
|
|
|
|
#define WIFI_CONNECTED_BIT BIT0
|
|
#define WIFI_FAIL_BIT BIT1
|
|
|
|
/**
|
|
* Initialize WiFi subsystem (STA mode).
|
|
*/
|
|
esp_err_t wifi_manager_init(void);
|
|
|
|
/**
|
|
* Start WiFi connection. Non-blocking, fires events.
|
|
*/
|
|
esp_err_t wifi_manager_start(void);
|
|
|
|
/**
|
|
* Block until WiFi is connected or failed.
|
|
* @param timeout_ms Max time to wait (portMAX_DELAY for forever)
|
|
* @return ESP_OK if connected, ESP_ERR_TIMEOUT otherwise
|
|
*/
|
|
esp_err_t wifi_manager_wait_connected(uint32_t timeout_ms);
|
|
|
|
/**
|
|
* Check if WiFi is currently connected.
|
|
*/
|
|
bool wifi_manager_is_connected(void);
|
|
|
|
/**
|
|
* Get the current IP address string (or "0.0.0.0" if not connected).
|
|
*/
|
|
const char *wifi_manager_get_ip(void);
|
|
|
|
/**
|
|
* Save WiFi credentials to NVS.
|
|
*/
|
|
esp_err_t wifi_manager_set_credentials(const char *ssid, const char *password);
|
|
|
|
/**
|
|
* Get the event group for WiFi state (WIFI_CONNECTED_BIT / WIFI_FAIL_BIT).
|
|
*/
|
|
EventGroupHandle_t wifi_manager_get_event_group(void);
|
|
|
|
/**
|
|
* Scan and print nearby APs.
|
|
*/
|
|
void wifi_manager_scan_and_print(void);
|
|
|
|
/**
|
|
* Check if WiFi credentials exist (NVS or build-time secrets).
|
|
*/
|
|
bool wifi_manager_has_credentials(void);
|
|
|
|
/**
|
|
* Stop WiFi (for mode switching during onboarding).
|
|
*/
|
|
esp_err_t wifi_manager_stop(void);
|