mirror of
https://github.com/0xFEEDC0DE64/arduino-esp32.git
synced 2025-07-02 13:30:59 +02:00
d977359e34
Summary The examples demonstrate how to create a WPA2 Enterprise connection, but it requires using various direct esp_idf functions. This patch is intended to create another overloaded version of the WiFi.begin() function that allows a user to create a WPA2 Enterprise connection in much the same way as different kinds of connections. My only question for the core maintainers is whether I should leave those #ifdef's in there. I added them so that it was easy to disable all the code I added via defines from my platformio.ini file, but they technically aren't necessary. Impact This should make it easier for novice users to create WPA2 Enterprise connections. For my university, I didn't need a root certificate or the client certificate or client key, so I haven't been able to debug those scenarios, but I built the begin functions to allow any one of those to be used, if needed. I can confirm that eduroam-style WPA2 Enterprise networks that only require authentication with a username and password works as expected.
113 lines
3.5 KiB
C++
113 lines
3.5 KiB
C++
/*
|
|
ESP8266WiFiSTA.h - esp8266 Wifi support.
|
|
Based on WiFi.h from Ardiono WiFi shield library.
|
|
Copyright (c) 2011-2014 Arduino. All right reserved.
|
|
Modified by Ivan Grokhotkov, December 2014
|
|
Reworked by Markus Sattler, December 2015
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef ESP32WIFISTA_H_
|
|
#define ESP32WIFISTA_H_
|
|
|
|
|
|
#include "WiFiType.h"
|
|
#include "WiFiGeneric.h"
|
|
#ifdef ESP_IDF_VERSION_MAJOR
|
|
#include "esp_event.h"
|
|
#endif
|
|
|
|
typedef enum {
|
|
WPA2_AUTH_TLS = 0,
|
|
WPA2_AUTH_PEAP = 1,
|
|
WPA2_AUTH_TTLS = 2
|
|
} wpa2_auth_method_t;
|
|
|
|
class WiFiSTAClass
|
|
{
|
|
// ----------------------------------------------------------------------------------------------
|
|
// ---------------------------------------- STA function ----------------------------------------
|
|
// ----------------------------------------------------------------------------------------------
|
|
|
|
public:
|
|
|
|
wl_status_t begin(const char* wpa2_ssid, wpa2_auth_method_t method, const char* wpa2_identity=NULL, const char* wpa2_username=NULL, const char *wpa2_password=NULL, const char* ca_pem=NULL, const char* client_crt=NULL, const char* client_key=NULL, int32_t channel=0, const uint8_t* bssid=0, bool connect=true);
|
|
wl_status_t begin(const char* ssid, const char *passphrase = NULL, int32_t channel = 0, const uint8_t* bssid = NULL, bool connect = true);
|
|
wl_status_t begin(char* ssid, char *passphrase = NULL, int32_t channel = 0, const uint8_t* bssid = NULL, bool connect = true);
|
|
wl_status_t begin();
|
|
|
|
bool config(IPAddress local_ip, IPAddress gateway, IPAddress subnet, IPAddress dns1 = (uint32_t)0x00000000, IPAddress dns2 = (uint32_t)0x00000000);
|
|
|
|
bool reconnect();
|
|
bool disconnect(bool wifioff = false, bool eraseap = false);
|
|
|
|
bool isConnected();
|
|
|
|
bool setAutoConnect(bool autoConnect);
|
|
bool getAutoConnect();
|
|
|
|
bool setAutoReconnect(bool autoReconnect);
|
|
bool getAutoReconnect();
|
|
|
|
uint8_t waitForConnectResult(unsigned long timeoutLength = 60000);
|
|
|
|
// STA network info
|
|
IPAddress localIP();
|
|
|
|
uint8_t * macAddress(uint8_t* mac);
|
|
String macAddress();
|
|
|
|
IPAddress subnetMask();
|
|
IPAddress gatewayIP();
|
|
IPAddress dnsIP(uint8_t dns_no = 0);
|
|
|
|
IPAddress broadcastIP();
|
|
IPAddress networkID();
|
|
uint8_t subnetCIDR();
|
|
|
|
bool enableIpV6();
|
|
IPv6Address localIPv6();
|
|
|
|
// STA WiFi info
|
|
static wl_status_t status();
|
|
String SSID() const;
|
|
String psk() const;
|
|
|
|
uint8_t * BSSID();
|
|
String BSSIDstr();
|
|
|
|
int8_t RSSI();
|
|
|
|
static void _setStatus(wl_status_t status);
|
|
|
|
protected:
|
|
static bool _useStaticIp;
|
|
static bool _autoReconnect;
|
|
|
|
public:
|
|
bool beginSmartConfig(smartconfig_type_t type = SC_TYPE_ESPTOUCH, char* crypt_key = NULL);
|
|
bool stopSmartConfig();
|
|
bool smartConfigDone();
|
|
|
|
static bool _smartConfigDone;
|
|
protected:
|
|
static bool _smartConfigStarted;
|
|
|
|
};
|
|
|
|
|
|
#endif /* ESP32WIFISTA_H_ */
|