- ap_ssid and ap_password on /api/network: empty name uses led-XXXXXX, a password of 8-63 characters makes the access point WPA2, empty is open; the password is never sent back (ap_password_set) - a running access point restarts when its name or password changes - /api/status reports ap_on; the web page gets the fields Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
36 lines
1.1 KiB
C++
36 lines
1.1 KiB
C++
/*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
#pragma once
|
|
|
|
#include <cstddef>
|
|
#include <cstdint>
|
|
|
|
#include "esp_err.h"
|
|
#include "esp_wifi_types.h"
|
|
#include "settings.h"
|
|
|
|
/** @brief Start Wi-Fi (AP `led-XXXXXX` plus an optional client), and mDNS. Needs NVS. */
|
|
esp_err_t net_start(void);
|
|
|
|
/** @brief Fill buf with the AP SSID, e.g. "led-A1B2C3". */
|
|
void net_ap_ssid(char *buf, size_t len);
|
|
|
|
/** @brief True while the access point is running. */
|
|
bool net_ap_on(void);
|
|
|
|
/** @brief Client link state and its IPv4 address ("" if not connected). */
|
|
bool net_sta_status(char *ip, size_t ip_len);
|
|
|
|
/** @brief Save credentials, then connect the client with them. */
|
|
esp_err_t net_sta_connect(const wifi_creds_t *c);
|
|
|
|
/**
|
|
* @brief Save network settings and apply them: mDNS name, static or DHCP client address.
|
|
* A connected or configured client reconnects so the new address takes effect.
|
|
*/
|
|
esp_err_t net_save_network(const net_cfg_t *c);
|
|
|
|
/** @brief Scan for networks. On entry *count is the array size; on exit, the number found. */
|
|
esp_err_t net_scan(wifi_ap_record_t *recs, uint16_t *count);
|