From 275cb2d398b964edf61ed6a208d127f4270a6f84 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Tue, 8 Oct 2019 15:33:40 +0900
Subject: [PATCH 01/25] Support the Config New with static IP

---
 src/AutoConnect.cpp           | 186 ++++++++++++++++++++++++++--------
 src/AutoConnect.h             |  17 +++-
 src/AutoConnectCredential.cpp | 159 ++++++++++++++++++++++-------
 src/AutoConnectCredential.h   |  61 +++++++----
 src/AutoConnectPage.cpp       | 100 ++++++++++++++----
 src/AutoConnectPage.h         |  10 +-
 6 files changed, 400 insertions(+), 133 deletions(-)

diff --git a/src/AutoConnect.cpp b/src/AutoConnect.cpp
index 7bebde1..9de0f0b 100644
--- a/src/AutoConnect.cpp
+++ b/src/AutoConnect.cpp
@@ -2,8 +2,8 @@
  *  AutoConnect class implementation.
  *  @file   AutoConnect.cpp
  *  @author hieromon@gmail.com
- *  @version    1.0.6
- *  @date   2019-09-17
+ *  @version    1.1.0
+ *  @date   2019-10-08
  *  @copyright  MIT license.
  */
 
@@ -53,7 +53,7 @@ void AutoConnect::_initialize(void) {
   _menuTitle = _apConfig.title;
   _connectTimeout = AUTOCONNECT_TIMEOUT;
   _scanCount = 0;
-  memset(&_credential, 0x00, sizeof(struct station_config));
+  memset(&_credential, 0x00, sizeof(station_config_t));
 #ifdef ARDUINO_ARCH_ESP32
   _disconnectEventId = -1;  // The member available for ESP32 only
 #endif
@@ -111,22 +111,14 @@ bool AutoConnect::begin(const char* ssid, const char* passphrase, unsigned long
       _ticker->start(AUTOCONNECT_FLICKER_PERIODDC, (uint8_t)AUTOCONNECT_FLICKER_WIDTHDC);
   }
 
-  // Advance configuration for STA mode.
-#ifdef AC_DEBUG
-  String staip_s = _apConfig.staip.toString();
-  String staGateway_s = _apConfig.staGateway.toString();
-  String staNetmask_s = _apConfig.staNetmask.toString();
-  String dns1_s = _apConfig.dns1.toString();
-  String dns2_s = _apConfig.dns2.toString();
-  AC_DBG("WiFi.config(IP=%s, Gateway=%s, Subnetmask=%s, DNS1=%s, DNS2=%s)\n", staip_s.c_str(), staGateway_s.c_str(), staNetmask_s.c_str(), dns1_s.c_str(), dns2_s.c_str());
-#endif
-  if (!WiFi.config(_apConfig.staip, _apConfig.staGateway, _apConfig.staNetmask, _apConfig.dns1, _apConfig.dns2)) {
-    AC_DBG("failed\n");
-    return false;
+  // Advance configuration for STA mode. Restore previous configuration of STA.
+  station_config_t  current;
+  if (_getConfigSTA(&current)) {
+    AC_DBG("Current:%.32s\n", current.ssid);
+    _loadAvailCredential(reinterpret_cast<const char*>(current.ssid));
   }
-#ifdef ARDUINO_ARCH_ESP8266
-  AC_DBG("DHCP client(%s)\n", wifi_station_dhcpc_status() == DHCP_STOPPED ? "STOPPED" : "STARTED");
-#endif
+  if (!_configSTA(_apConfig.staip, _apConfig.staGateway, _apConfig.staNetmask, _apConfig.dns1, _apConfig.dns2))
+    return false;
 
   // If the portal is requested promptly skip the first WiFi.begin and
   // immediately start the portal.
@@ -150,16 +142,17 @@ bool AutoConnect::begin(const char* ssid, const char* passphrase, unsigned long
   // Reconnect with a valid credential as the autoReconnect option is enabled.
   if (!cs && _apConfig.autoReconnect && (ssid == nullptr && passphrase == nullptr)) {
     // Load a valid credential.
-    if (_loadAvailCredential()) {
+    if (_loadAvailCredential(nullptr)) {
       // Try to reconnect with a stored credential.
-      char  ssid_c[sizeof(station_config::ssid) + 1];
-      char  password_c[sizeof(station_config::password) + 1];
+      char  ssid_c[sizeof(station_config_t::ssid) + sizeof('\0')];
+      char  password_c[sizeof(station_config_t::password) + sizeof('\0')];
       *ssid_c = '\0';
-      strncat(ssid_c, reinterpret_cast<const char*>(_credential.ssid), sizeof(ssid_c) - 1);
+      strncat(ssid_c, reinterpret_cast<const char*>(_credential.ssid), sizeof(ssid_c) - sizeof('\0'));
       *password_c = '\0';
-      strncat(password_c, reinterpret_cast<const char*>(_credential.password), sizeof(password_c) - 1);
+      strncat(password_c, reinterpret_cast<const char*>(_credential.password), sizeof(password_c) - sizeof('\0'));
       AC_DBG("autoReconnect loaded SSID:%s\n", ssid_c);
       const char* psk = strlen(password_c) ? password_c : nullptr;
+      _configSTA(IPAddress(_credential.config.sta.ip), IPAddress(_credential.config.sta.gateway), IPAddress(_credential.config.sta.netmask), IPAddress(_credential.config.sta.dns1), IPAddress(_credential.config.sta.dns2));
       WiFi.begin(ssid_c, psk);
       AC_DBG("WiFi.begin(%s%s%s)\n", ssid_c, psk == nullptr ? "" : ",", psk == nullptr ? "" : psk);
       cs = _waitForConnect(_connectTimeout) == WL_CONNECTED;
@@ -191,7 +184,7 @@ bool AutoConnect::begin(const char* ssid, const char* passphrase, unsigned long
 
       // Connection unsuccessful, launch the captive portal.
 #if defined(ARDUINO_ARCH_ESP8266)
-      if (!(_apConfig.apip == IPAddress(0, 0, 0, 0) || _apConfig.gateway == IPAddress(0, 0, 0, 0) || _apConfig.netmask == IPAddress(0, 0, 0, 0))) {
+      if (!_apConfig.apip && !_apConfig.gateway && !_apConfig.netmask) {
         _config();
       }
 #endif
@@ -199,13 +192,13 @@ bool AutoConnect::begin(const char* ssid, const char* passphrase, unsigned long
       do {
         delay(100);
         yield();
-      } while (WiFi.softAPIP() == IPAddress(0, 0, 0, 0));
+      } while (!WiFi.softAPIP());
 #if defined(ARDUINO_ARCH_ESP32)
-      if (!(_apConfig.apip == IPAddress(0, 0, 0, 0) || _apConfig.gateway == IPAddress(0, 0, 0, 0) || _apConfig.netmask == IPAddress(0, 0, 0, 0))) {
+      if (!(static_cast<uint32_t>(_apConfig.apip) == 0U || static_cast<uint32_t>(_apConfig.gateway) == 0U || static_cast<uint32_t>(_apConfig.netmask) == 0U)) {
         _config();
       }
 #endif
-      if (_apConfig.apip != IPAddress(0, 0, 0, 0)) {
+      if (_apConfig.apip) {
         do {
           delay(100);
           yield();
@@ -312,6 +305,63 @@ bool AutoConnect::_config(void) {
   return rc;
 }
 
+/**
+ *  Advance configuration for STA mode.
+ *  @param  ip       IP address
+ *  @param  gateway  Gateway address
+ *  @param  netmask  Netmask
+ *  @param  dns1     Primary DNS address
+ *  @param  dns2     Secondary DNS address
+ *  @return true     Station successfully configured
+ *  @return false    WiFi.config failed
+ */
+bool AutoConnect::_configSTA(const IPAddress& ip, const IPAddress& gateway, const IPAddress& netmask, const IPAddress& dns1, const IPAddress& dns2) {
+  bool  rc;
+
+  AC_DBG("WiFi.config(IP=%s, Gateway=%s, Subnetmask=%s, DNS1=%s, DNS2=%s)\n", ip.toString().c_str(), gateway.toString().c_str(), netmask.toString().c_str(), dns1.toString().c_str(), dns2.toString().c_str());
+  if (!(rc = WiFi.config(ip, gateway, netmask, dns1, dns2)))
+    AC_DBG("failed\n");
+#ifdef ARDUINO_ARCH_ESP8266
+  AC_DBG("DHCP client(%s)\n", wifi_station_dhcpc_status() == DHCP_STOPPED ? "STOPPED" : "STARTED");
+#endif
+  return rc;
+}
+
+/**
+ *  Obtains the currently established AP connection to determine if the
+ *  station configuration needs to run before the first WiFi.begin.
+ *  Get the SSID of the currently connected AP stored in the ESP module
+ *  by using the SDK API natively.
+ *  AutoConnect::begin retrieves the IP configuration from the stored
+ *  credentials of AutoConnectCredential based on that SSID and executes
+ *  WiFi.config before WiFi.begin.
+ *  @param  config  Station configuration stored in the ESP module.
+ *  @return true    The config parameter has obtained configuration.
+ *  @return false   Station configuration does not exist.
+ */
+bool AutoConnect::_getConfigSTA(station_config_t* config) {
+  bool  rc;
+  uint8_t*  ssid;
+  uint8_t*  bssid;
+
+#if defined(ARDUINO_ARCH_ESP8266)
+  struct station_config current;
+  ssid = current.ssid;
+  bssid = current.bssid;
+  rc = wifi_station_get_config(&current);
+#elif defined(ARDUINO_ARCH_ESP32)
+  wifi_config_t current;
+  ssid = current.sta.ssid;
+  bssid = current.sta.bssid;
+  rc = (esp_wifi_get_config(WIFI_IF_STA, &current) == ESP_OK);
+#endif
+  if (rc) {
+    memcpy(config->ssid, ssid, sizeof(station_config_t::ssid));
+    memcpy(config->bssid, bssid, sizeof(station_config_t::bssid));
+  }
+  return rc;
+}
+
 /**
  *  Put a user site's home URI.
  *  The URI specified by home is linked from "HOME" in the AutoConnect
@@ -469,10 +519,13 @@ void AutoConnect::handleRequest(void) {
     if (WiFi.status() == WL_CONNECTED)
       _disconnectWiFi(true);
 
+    // Leave current AP, reconfigure station
+    _configSTA(_apConfig.staip, _apConfig.staGateway, _apConfig.staNetmask, _apConfig.dns1, _apConfig.dns2);
+
     // An attempt to establish a new AP.
     int32_t ch = _connectCh == 0 ? _apConfig.channel : _connectCh;
-    char ssid_c[sizeof(station_config::ssid) + 1];
-    char password_c[sizeof(station_config::password) + 1];
+    char ssid_c[sizeof(station_config_t::ssid) + 1];
+    char password_c[sizeof(station_config_t::password) + 1];
     *ssid_c = '\0';
     strncat(ssid_c, reinterpret_cast<const char*>(_credential.ssid), sizeof(ssid_c) - 1);
     *password_c = '\0';
@@ -481,7 +534,7 @@ void AutoConnect::handleRequest(void) {
     WiFi.begin(ssid_c, password_c, ch);
     if (_waitForConnect(_connectTimeout) == WL_CONNECTED) {
       if (WiFi.BSSID() != NULL) {
-        memcpy(_credential.bssid, WiFi.BSSID(), sizeof(station_config::bssid));
+        memcpy(_credential.bssid, WiFi.BSSID(), sizeof(station_config_t::bssid));
         _currentHostIP = WiFi.localIP();
         _redirectURI = String(F(AUTOCONNECT_URI_SUCCESS));
 
@@ -592,26 +645,40 @@ void AutoConnect::onNotFound(WebServerClass::THandlerFunction fn) {
 
 /**
  *  Load stored credentials that match nearby WLANs.
+ *  @param  ssid  SSID which should be loaded. If nullptr is assigned, search SSID with WiFi.scan.
  *  @return true  A matched credential of BSSID was loaded.
  */
-bool AutoConnect::_loadAvailCredential(void) {
+bool AutoConnect::_loadAvailCredential(const char* ssid) {
   AutoConnectCredential credential(_apConfig.boundaryOffset);
 
   if (credential.entries() > 0) {
     // Scan the vicinity only when the saved credentials are existing.
-    WiFi.scanDelete();
-    int8_t  nn = WiFi.scanNetworks(false, true);
-    AC_DBG("%d network(s) found\n", (int)nn);
-    if (nn > 0) {
-      // Determine valid credentials by BSSID.
-      for (uint8_t i = 0; i < credential.entries(); i++) {
-        credential.load(i, &_credential);
-        for (uint8_t n = 0; n < nn; n++) {
-          if (!memcmp(_credential.bssid, WiFi.BSSID(n), sizeof(station_config::bssid)))
-            return true;
+    if (!ssid) {
+      WiFi.scanDelete();
+      int8_t  nn = WiFi.scanNetworks(false, true);
+      AC_DBG("%d network(s) found\n", (int)nn);
+      if (nn > 0) {
+        // Determine valid credentials by BSSID.
+        for (uint8_t i = 0; i < credential.entries(); i++) {
+          credential.load(i, &_credential);
+          for (uint8_t n = 0; n < nn; n++) {
+            if (!memcmp(_credential.bssid, WiFi.BSSID(n), sizeof(station_config_t::bssid)))
+              return true;
+          }
         }
       }
     }
+    else if (strlen(ssid))
+      if (credential.load(ssid, &_credential) >= 0) {
+        if (_credential.dhcp == STA_STATIC) {
+          _apConfig.staip = static_cast<IPAddress>(_credential.config.sta.ip);
+          _apConfig.staGateway = static_cast<IPAddress>(_credential.config.sta.gateway);
+          _apConfig.staNetmask = static_cast<IPAddress>(_credential.config.sta.netmask);
+          _apConfig.dns1 = static_cast<IPAddress>(_credential.config.sta.dns1);
+          _apConfig.dns2 = static_cast<IPAddress>(_credential.config.sta.dns2);
+        }
+        return true;
+      }
   }
   return false;
 }
@@ -738,11 +805,14 @@ String AutoConnect::_induceConnect(PageArgument& args) {
   if (args.hasArg(String(F(AUTOCONNECT_PARAMID_CRED)))) {
     // Read from EEPROM
     AutoConnectCredential credential(_apConfig.boundaryOffset);
-    struct station_config entry;
+    station_config_t entry;
     credential.load(args.arg(String(F(AUTOCONNECT_PARAMID_CRED))).c_str(), &entry);
     strncpy(reinterpret_cast<char*>(_credential.ssid), reinterpret_cast<const char*>(entry.ssid), sizeof(_credential.ssid));
     strncpy(reinterpret_cast<char*>(_credential.password), reinterpret_cast<const char*>(entry.password), sizeof(_credential.password));
-    AC_DBG("Credential loaded:%.*s\n", sizeof(station_config::ssid), _credential.ssid);
+#ifdef AC_DEBUG
+    IPAddress staip = IPAddress(_credential.config.sta.ip);
+    AC_DBG("Credential loaded:%.*s(%s)\n", sizeof(station_config_t::ssid), reinterpret_cast<const char*>(_credential.ssid), _credential.dhcp == STA_DHCP ? "DHCP" : staip.toString().c_str());
+#endif
   }
   else {
     AC_DBG("Queried SSID:%s\n", args.arg(AUTOCONNECT_PARAMID_SSID).c_str());
@@ -755,12 +825,39 @@ String AutoConnect::_induceConnect(PageArgument& args) {
   _connectCh = 0;
   for (uint8_t nn = 0; nn < _scanCount; nn++) {
     String  ssid = WiFi.SSID(nn);
-    if (!strncmp(ssid.c_str(), reinterpret_cast<const char*>(_credential.ssid), sizeof(station_config::ssid))) {
+    if (!strncmp(ssid.c_str(), reinterpret_cast<const char*>(_credential.ssid), sizeof(station_config_t::ssid))) {
       _connectCh = WiFi.channel(nn);
       break;
     }
   }
 
+  // Static IP detection
+  _credential.config.sta.ip = _credential.config.sta.gateway = _credential.config.sta.netmask = _credential.config.sta.dns1 = _credential.config.sta.dns2 = 0U;
+  if (!args.hasArg(String(F(AUTOCONNECT_PARAMID_DHCP)))) {
+    _credential.dhcp = STA_STATIC;
+    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_STAIP)))) {
+      _apConfig.staip.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_STAIP))));
+      _credential.config.sta.ip = (uint32_t)_apConfig.staip;
+    }
+    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_GTWAY)))) {
+      _apConfig.staGateway.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_GTWAY))));
+      _credential.config.sta.gateway = (uint32_t)_apConfig.staGateway;
+    }
+    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_NTMSK)))) {
+      _apConfig.staNetmask.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_NTMSK))));
+      _credential.config.sta.netmask = (uint32_t)_apConfig.staNetmask;
+    }
+    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_DNS1)))) {
+      _apConfig.dns1.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_DNS1))));
+      _credential.config.sta.dns1 = (uint32_t)_apConfig.dns1;
+    }
+    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_DNS2))))
+      _apConfig.dns2.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_DNS2))));
+      _credential.config.sta.dns2 = (uint32_t)_apConfig.dns2;
+  }
+  else
+    _credential.dhcp = STA_DHCP;
+
   // Turn on the trigger to start WiFi.begin().
   _rfConnect = true;
 
@@ -811,6 +908,7 @@ String AutoConnect::_invokeResult(PageArgument& args) {
   // This is the specification as before.
   redirect += _currentHostIP.toString();
 #endif
+  AC_DBG("Redirect to %s\n", redirect.c_str());
   redirect += _redirectURI;
   _webServer->sendHeader(String(F("Location")), redirect, true);
   _webServer->send(302, String(F("text/plain")), _emptyString);
diff --git a/src/AutoConnect.h b/src/AutoConnect.h
index 415d569..f1f385b 100644
--- a/src/AutoConnect.h
+++ b/src/AutoConnect.h
@@ -2,8 +2,8 @@
  *	Declaration of AutoConnect class and accompanying AutoConnectConfig class.
  *	@file	AutoConnect.h
  *	@author	hieromon@gmail.com
- *	@version	1.0.0
- *	@date	2019-08-15
+ *	@version	1.1.0
+ *	@date	2019-10-07
  *	@copyright	MIT license.
  */
 
@@ -229,10 +229,12 @@ class AutoConnect {
   } AC_STARECONNECT_t;
   void  _initialize(void);
   bool  _config(void);
+  bool  _configSTA(const IPAddress& ip, const IPAddress& gateway, const IPAddress& netmask, const IPAddress& dns1, const IPAddress& dns2);
+  bool  _getConfigSTA(station_config_t* config);
   void  _startWebServer(void);
   void  _startDNSServer(void);
   void  _handleNotFound(void);
-  bool  _loadAvailCredential(void);
+  bool  _loadAvailCredential(const char* ssid);
   void  _stopPortal(void);
   bool  _classifyHandle(HTTPMethod mothod, String uri);
   void  _handleUpload(const String& requestUri, const HTTPUpload& upload);
@@ -289,8 +291,8 @@ class AutoConnect {
   std::unique_ptr<AutoConnectUpdate>  _update;
 
   /** Saved configurations */
-  AutoConnectConfig     _apConfig;
-  struct station_config _credential;
+  AutoConnectConfig  _apConfig;
+  station_config_t   _credential;
   uint8_t       _hiddenSSIDCount;
   int16_t       _scanCount;
   uint8_t       _connectCh;
@@ -374,6 +376,11 @@ class AutoConnect {
   String _token_LIST_SSID(PageArgument& args);
   String _token_SSID_COUNT(PageArgument& args);
   String _token_HIDDEN_COUNT(PageArgument& args);
+  String _token_CONFIG_STAIP(PageArgument& args);
+  String _token_CONFIG_STAGATEWAY(PageArgument& args);
+  String _token_CONFIG_STANETMASK(PageArgument& args);
+  String _token_CONFIG_STADNS1(PageArgument& args);
+  String _token_CONFIG_STADNS2(PageArgument& args);
   String _token_OPEN_SSID(PageArgument& args);
   String _token_UPTIME(PageArgument& args);
   String _token_BOOTURI(PageArgument& args);
diff --git a/src/AutoConnectCredential.cpp b/src/AutoConnectCredential.cpp
index c4de8d2..116a6bd 100644
--- a/src/AutoConnectCredential.cpp
+++ b/src/AutoConnectCredential.cpp
@@ -2,8 +2,8 @@
  *	AutoConnectCredential class dispatcher.
  *	@file	AutoConnectCredential.cpp
  *	@author	hieromon@gmail.com
- *	@version	1.0.2
- *	@date	2019-09-16
+ *	@version	1.1.0
+ *	@date	2019-10-07
  *	@copyright	MIT license.
  */
 
@@ -16,16 +16,23 @@
  *  AutoConnectCredential constructor takes the available count of saved
  *  entries.
  *  A stored credential data structure in EEPROM.
- *   0      7 8 9a b                                  (t)
- *  +--------+-+--+-----------------+-----------------+--+
- *  |AC_CREDT|e|ss|ssid\0pass\0bssid|ssid\0pass\0bssid|\0|
- *  +--------+-+--+-----------------+-----------------+--+
+ *   0      7 8 9a b                (u)                  (u+16)            (t)
+ *  +--------+-+--+-----------------+-+--+--+--+----+----+-----------------+--+
+ *  |AC_CREDT|e|ss|ssid\0pass\0bssid|d|ip|gw|nm|dns1|dns2|ssid\0pass\0bssid|\0|
+ *  +--------+-+--+-----------------+-+--+--+--+----+----+-----------------+--+
  *  AC_CREDT : Identifier. 8 characters.
  *  e  : Number of contained entries(uint8_t).
  *  ss : Container size, excluding ID and number of entries(uint16_t).
  *  ssid: SSID string with null termination.
  *  password : Password string with null termination.
  *  bssid : BSSID 6 bytes.
+ *  d  : DHCP is in available. 0:DCHP 1:Static IP
+ *  ip - dns2 : Optional fields for static IPs configuration, these fields are available when d=1.
+ *  ip : Static IP (uint32_t)
+ *  gw : Gateway address (uint32_t)
+ *  nm : Netmask (uint32_t)
+ *  dns1 : Primary DNS (uint32)
+ *  dns2 : Secondary DNS (uint32_t)
  *  t  : The end of the container is a continuous '\0'.
  *  The AC_CREDT identifier is at the beginning of the area.
  *  SSID and PASSWORD are terminated by '\ 0'.
@@ -81,7 +88,7 @@ AutoConnectCredential::~AutoConnectCredential() {
  *          false   Could not deleted.
  */
 bool AutoConnectCredential::del(const char* ssid) {
-  struct station_config entry;
+  station_config_t  entry;
   bool  rc = false;
 
   if (load(ssid, &entry) >= 0) {
@@ -100,9 +107,15 @@ bool AutoConnectCredential::del(const char* ssid) {
 
     // Erase BSSID
     _eeprom->write(_dp++, 0xff);
-    for (uint8_t i = 0; i < sizeof(station_config::bssid); i++)
+    for (uint8_t i = 0; i < sizeof(station_config_t::bssid); i++)
       _eeprom->write(_dp++, 0xff);
 
+    // Erase ip configuration extention
+    if (_eeprom->read(_dp) == STA_STATIC) {
+      for (uint8_t i = 0; i < sizeof(station_config_t::_config); i++)
+        _eeprom->write(_dp++, 0xff);
+    }
+
     // End 0xff writing, update headers.
     _entries--;
     _eeprom->write(_offset + static_cast<int>(sizeof(AC_IDENTIFIER)) - 1, _entries);
@@ -124,15 +137,15 @@ bool AutoConnectCredential::del(const char* ssid) {
  *  @retval The entry number of the SSID in EEPROM. If the number less than 0,
  *  the specified SSID was not found.
  */
-int8_t AutoConnectCredential::load(const char* ssid, struct station_config* config) {
+int8_t AutoConnectCredential::load(const char* ssid, station_config_t* config) {
   int8_t  entry = -1;
 
   _dp = AC_HEADERSIZE;
   if (_entries) {
     _eeprom->begin(AC_HEADERSIZE + _containSize);
     for (uint8_t i = 0; i < _entries; i++) {
-      _retrieveEntry(reinterpret_cast<char*>(config->ssid), reinterpret_cast<char*>(config->password), config->bssid);
-      if (!strcmp(ssid, (const char*)config->ssid)) {
+      _retrieveEntry(config);
+      if (!strcmp(ssid, reinterpret_cast<const char*>(config->ssid))) {
         entry = i;
         break;
       }
@@ -151,12 +164,12 @@ int8_t AutoConnectCredential::load(const char* ssid, struct station_config* conf
  *  @retval true    The entry number of the SSID in EEPROM.
  *          false   The number is not available.
  */
-bool AutoConnectCredential::load(int8_t entry, struct station_config* config) {
+bool AutoConnectCredential::load(int8_t entry, station_config_t* config) {
   _dp = AC_HEADERSIZE;
   if (_entries && entry < _entries) {
     _eeprom->begin(AC_HEADERSIZE + _containSize);
     while (entry-- >= 0)
-      _retrieveEntry(reinterpret_cast<char*>(config->ssid), reinterpret_cast<char*>(config->password), config->bssid);
+      _retrieveEntry(config);
     _eeprom->end();
     return true;
   }
@@ -174,18 +187,18 @@ bool AutoConnectCredential::load(int8_t entry, struct station_config* config) {
  *  @retval true    Successfully saved.
  *  @retval false   EEPROM commit failed.
  */
-bool AutoConnectCredential::save(const struct station_config* config) {
+bool AutoConnectCredential::save(const station_config_t* config) {
   static const char _id[] = AC_IDENTIFIER;
-  struct station_config  stage;
+  station_config_t  stage;
   int8_t  entry;
   bool    rep = false;
   bool    rc;
 
   // Detect same entry for replacement.
-  entry = load((const char*)(config->ssid), &stage);
+  entry = load(reinterpret_cast<const char*>(config->ssid), &stage);
 
   // Saving start.
-  _eeprom->begin(AC_HEADERSIZE + _containSize + sizeof(struct station_config));
+  _eeprom->begin(AC_HEADERSIZE + _containSize + sizeof(station_config_t));
 
   // Determine insertion or replacement.
   if (entry >= 0) {
@@ -196,9 +209,15 @@ bool AutoConnectCredential::save(const struct station_config* config) {
         dm--;
       _eeprom->write(_dp, 0xff);    // Clear SSID, Passphrase
     }
-    for (uint8_t i = 0; i < sizeof(station_config::bssid); i++) {
+    for (uint8_t i = 0; i < sizeof(station_config_t::bssid); i++) {
       _eeprom->write(_dp++, 0xff);  // Clear BSSID
     }
+    uint8_t ss = _eeprom->read(_dp); // Read dhcp assignment flag
+    _eeprom->write(_dp++, 0xff);    // Clear dhcp
+    if (ss == (uint8_t)STA_STATIC) {
+      for (uint8_t i = 0 ; i < sizeof(station_config_t::_config); i++)
+      _eeprom->write(_dp++, 0xff);  // Clear static IPs
+    }
   }
   else {
     // Same entry not found. increase the entry.
@@ -213,7 +232,11 @@ bool AutoConnectCredential::save(const struct station_config* config) {
   delay(10);
 
   // Seek insertion point, evaluate capacity to insert the new entry.
-  uint16_t eSize = strlen((const char*)config->ssid) + strlen((const char*)config->password) + sizeof(station_config::bssid) + 2;
+  uint16_t eSize = strlen(reinterpret_cast<const char*>(config->ssid)) + strlen(reinterpret_cast<const char*>(config->password)) + sizeof(station_config_t::bssid) + sizeof(station_config_t::dhcp);
+  if (config->dhcp == (uint8_t)STA_STATIC)
+    eSize += sizeof(station_config_t::_config);
+  eSize += sizeof('\0') + sizeof('\0');
+
   for (_dp = AC_HEADERSIZE; _dp < _containSize + AC_HEADERSIZE; _dp++) {
     uint8_t c = _eeprom->read(_dp);
     if (c == 0xff) {
@@ -241,9 +264,17 @@ bool AutoConnectCredential::save(const struct station_config* config) {
     c = *dt++;
     _eeprom->write(_dp++, c);
   } while (c != '\0');
-  for (uint8_t i = 0; i < sizeof(station_config::bssid); i++) {
+  for (uint8_t i = 0; i < sizeof(station_config_t::bssid); i++)
     _eeprom->write(_dp++, config->bssid[i]);  // write BSSID
+  _eeprom->write(_dp++, config->dhcp); // write dhcp flag
+  if (config->dhcp == (uint8_t)STA_STATIC) {
+    for (uint8_t e = 0; e < sizeof(station_config_t::_config::addr) / sizeof(uint32_t); e++) {
+      uint32_t  ip = config->config.addr[e];
+      for (uint8_t b = 1; b <= sizeof(ip); b++)
+        _eeprom->write(_dp++, ((uint8_t*)&ip)[sizeof(ip) - b]);
+    }
   }
+
   // Terminate container, mark to the end of credential area.
   // When the entry is replaced, not mark a terminator.
   if (!rep) {
@@ -268,27 +299,41 @@ bool AutoConnectCredential::save(const struct station_config* config) {
  *  @param  ssid      A SSID storing address.
  *  @param  password  A password storing address.
  */
-void AutoConnectCredential::_retrieveEntry(char* ssid, char* password, uint8_t* bssid) {
+void AutoConnectCredential::_retrieveEntry(station_config_t* config) {
   uint8_t ec;
 
   // Skip unavailable entry.
   while ((ec = _eeprom->read(_dp++)) == 0xff) {}
+  _ep = _dp - 1;
 
   // Retrieve SSID
-  _ep = _dp - 1;
-  *ssid++ = ec;
+  uint8_t* bp = config->ssid;
+  *bp++ = ec;
   do {
     ec = _eeprom->read(_dp++);
-    *ssid++ = ec;
+    *bp++ = ec;
   } while (ec != '\0');
   // Retrieve Password
+  bp = config->password;
   do {
     ec = _eeprom->read(_dp++);
-    *password++ = ec;
+    *bp++ = ec;
   } while (ec != '\0');
   // Retrieve BSSID
-  for (uint8_t i = 0; i < sizeof(station_config::bssid); i++)
-    bssid[i] = _eeprom->read(_dp++);
+  for (uint8_t i = 0; i < sizeof(station_config_t::bssid); i++)
+    config->bssid[i] = _eeprom->read(_dp++);
+  // Extended readout for static IP
+  config->dhcp = _eeprom->read(_dp++);
+  if (config->dhcp == (uint8_t)STA_STATIC) {
+    for (uint8_t e = 0; e < sizeof(station_config_t::_config::addr) / sizeof(uint32_t); e++) {
+      uint32_t* ip = &config->config.addr[e];
+      *ip = 0;
+      for (uint8_t b = 0; b < sizeof(uint32_t); b++) {
+        *ip <<= 8;
+        *ip += _eeprom->read(_dp++);
+      }
+    }
+  }
 }
 
 #else
@@ -299,19 +344,24 @@ void AutoConnectCredential::_retrieveEntry(char* ssid, char* password, uint8_t*
  *  The credential area in the flash used by AutoConnect was moved from
  *  EEPROM to NVS with v.1.0.0. A stored credential data structure of
  *  Preferences is as follows. It has no identifier as AC_CREDT.
- *   0 12 3                                  (t)
- *  +-+--+-----------------+-----------------+--+
- *  |e|ss|ssid\0pass\0bssid|ssid\0pass\0bssid|\0|
- *  +-+--+-----------------+-----------------+--+
+ *   0 12 3                (u)                  (u+16)            (t)
+ *  +-+--+-----------------+-+--+--+--+----+----+-----------------+--+
+ *  |e|ss|ssid\0pass\0bssid|d|ip|gw|nm|dns1|dns2|ssid\0pass\0bssid|\0|
+ *  +-+--+-----------------+-+--+--+--+----+----+-----------------+--+
  *  e  : Number of contained entries(uint8_t).
  *  ss : Container size, excluding ID and number of entries(uint16_t).
  *  ssid: SSID string with null termination.
  *  password : Password string with null termination.
  *  bssid : BSSID 6 bytes.
+ *  d  : DHCP is in available. 0:DCHP 1:Static IP
+ *  ip - dns2 : Optional fields for static IPs configuration, these fields are available when d=1.
+ *  ip : Static IP (uint32_t)
+ *  gw : Gateway address (uint32_t)
+ *  nm : Netmask (uint32_t)
+ *  dns1 : Primary DNS (uint32)
+ *  dns2 : Secondary DNS (uint32_t)
  *  t  : The end of the container is a continuous '\0'.
- *  The AC_CREDT identifier is at the beginning of the area.
  *  SSID and PASSWORD are terminated by '\ 0'.
- *  Free area are filled with FF, which is reused as an area for insertion.
  */
 AutoConnectCredential::AutoConnectCredential() {
   _allocateEntry();
@@ -362,7 +412,7 @@ inline uint8_t AutoConnectCredential::entries(void) {
  *  @retval The entry number of the SSID. If the number less than 0,
  *  the specified SSID was not found.
  */
-int8_t AutoConnectCredential::load(const char* ssid, struct station_config* config) {
+int8_t AutoConnectCredential::load(const char* ssid, station_config_t* config) {
   // Determine the number in entries
   int8_t  en = 0;
   _entries = _import(); // Reload the saved credentials
@@ -386,7 +436,7 @@ int8_t AutoConnectCredential::load(const char* ssid, struct station_config* conf
  *  @retval true    The entry number of the SSID.
  *          false   The number is not available.
  */
-bool AutoConnectCredential::load(int8_t entry, struct station_config* config) {
+bool AutoConnectCredential::load(int8_t entry, station_config_t* config) {
   _entries = _import();
   for (decltype(_credit)::iterator it = _credit.begin(), e = _credit.end(); it != e; ++it) {
     if (!entry--) {
@@ -406,7 +456,7 @@ bool AutoConnectCredential::load(int8_t entry, struct station_config* config) {
  *  @retval true    Successfully saved.
  *  @retval false   Preferences commit failed.
  */
-bool AutoConnectCredential::save(const struct station_config* config) {
+bool AutoConnectCredential::save(const station_config_t* config) {
   if (_add(config)) {
     return _commit() > 0 ? true : false;
   }
@@ -432,6 +482,9 @@ bool AutoConnectCredential::_add(const station_config_t* config) {
     AC_CREDTBODY_t  credtBody;
     credtBody.password = String(reinterpret_cast<const char*>(config->password));
     memcpy(credtBody.bssid, config->bssid, sizeof(AC_CREDTBODY_t::bssid));
+    credtBody.dhcp = config->dhcp;
+    for (uint8_t e = 0; e < sizeof(AC_CREDTBODY_t::ip) / sizeof(uint32_t); e++)
+      credtBody.ip[e] = credtBody.dhcp == (uint8_t)STA_STATIC ? config->config.addr[e] : 0U;
     std::pair<AC_CREDT_t::iterator, bool> rc = _credit.insert(std::make_pair(ssid, credtBody));
     _entries = _credit.size();
     #ifdef AC_DBG
@@ -455,7 +508,11 @@ size_t AutoConnectCredential::_commit(void) {
   for (const auto& credt : _credit) {
     ssid = credt.first;
     credtBody = credt.second;
-    sz += ssid.length() + sizeof('\0') + credtBody.password.length() + sizeof('\0') + sizeof(AC_CREDTBODY_t::bssid);
+    sz += ssid.length() + sizeof('\0') + credtBody.password.length() + sizeof('\0') + sizeof(AC_CREDTBODY_t::bssid) + sizeof(AC_CREDTBODY_t::dhcp);
+    if (credtBody.dhcp == (uint32_t)STA_STATIC) {
+      for (uint8_t e = 0; e < sizeof(AC_CREDTBODY_t::ip) / sizeof(uint32_t); e++)
+        sz += sizeof(uint32_t);
+    }
   }
   // When the entry is not empty, the size of container terminator as '\0' must be added.
   _containSize = sz + (_entries ? sizeof('\0') : 0);
@@ -484,6 +541,16 @@ size_t AutoConnectCredential::_commit(void) {
       dp += itemLen;
       memcpy(&credtPool[dp], credtBody.bssid, sizeof(station_config_t::bssid));
       dp += sizeof(station_config_t::bssid);
+      // DHCP/Static IP indicator
+      credtPool[dp++] = (uint8_t)credtBody.dhcp;
+      // Static IP configuration
+      if (credtBody.dhcp == STA_STATIC) {
+        for (uint8_t e = 0; e < sizeof(AC_CREDTBODY_t::ip) / sizeof(uint32_t); e++) {
+          // uint32_t  ip = credtBody.ip[e];
+          for (uint8_t b = 1; b <= sizeof(credtBody.ip[e]); b++)
+            credtPool[dp++] = ((uint8_t*)&credtBody.ip[e])[sizeof(credtBody.ip[e]) - b];
+        }
+      }
     }
     if (_credit.size() > 0)
       credtPool[dp] = '\0'; // Terminates a container
@@ -552,9 +619,22 @@ uint8_t AutoConnectCredential::_import(void) {
           // BSSID
           dp += credtBody.password.length() + sizeof('\0');
           memcpy(credtBody.bssid, &credtPool[dp], sizeof(AC_CREDTBODY_t::bssid));
+          dp += sizeof(AC_CREDTBODY_t::bssid);
+          // DHCP/Static IP indicator
+          credtBody.dhcp = credtPool[dp++];
+          // Static IP configuration
+          for (uint8_t e = 0; e < sizeof(AC_CREDTBODY_t::ip) / sizeof(uint32_t); e++) {
+            uint32_t* ip = &credtBody.ip[e];
+            *ip = 0U;
+            if (credtBody.dhcp == (uint8_t)STA_STATIC) {
+              for (uint8_t b = 0; b < sizeof(uint32_t); b++) {
+                *ip <<= 8;
+                *ip += credtPool[dp++];
+              }
+            }
+          }
           // Make an entry
           _credit.insert(std::make_pair(ssid, credtBody));
-          dp += sizeof(AC_CREDTBODY_t::bssid);
         }
         free(credtPool);
       }
@@ -585,6 +665,9 @@ void AutoConnectCredential::_obtain(AC_CREDT_t::iterator const& it, station_conf
   ssid.toCharArray(reinterpret_cast<char*>(config->ssid), sizeof(station_config_t::ssid));
   credtBody.password.toCharArray(reinterpret_cast<char*>(config->password), sizeof(station_config_t::password));
   memcpy(config->bssid, credtBody.bssid, sizeof(station_config_t::bssid));
+  config->dhcp = credtBody.dhcp;
+  for (uint8_t e = 0; e < sizeof(AC_CREDTBODY_t::ip) / sizeof(uint32_t); e++)
+    config->config.addr[e] = credtBody.dhcp == (uint8_t)STA_STATIC ? credtBody.ip[e] : 0U;
 }
 
 #endif
diff --git a/src/AutoConnectCredential.h b/src/AutoConnectCredential.h
index ec6b641..de75003 100644
--- a/src/AutoConnectCredential.h
+++ b/src/AutoConnectCredential.h
@@ -2,8 +2,8 @@
  *  Declaration of AutoConnectCredential class.
  *  @file AutoConnectCredential.h
  *  @author hieromon@gmail.com
- *  @version  1.0.2
- *  @date 2019-09-16
+ *  @version  1.1.0
+ *  @date 2019-10-07
  *  @copyright  MIT license.
  */
 
@@ -32,13 +32,6 @@ extern "C" {
 #define AC_CREDENTIAL_PREFERENCES 0
 #endif
 #include <esp_wifi.h>
-struct station_config {
-uint8_t  ssid[32];
-uint8_t  password[64];
-uint8_t  bssid_set;
-uint8_t  bssid[6];
-wifi_fast_scan_threshold_t threshold;
-};
 #endif
 #include "AutoConnectDefs.h"
 
@@ -59,15 +52,37 @@ wifi_fast_scan_threshold_t threshold;
 #define AC_IDENTIFIER "AC_CREDT"
 #endif
 
+typedef enum {
+  STA_DHCP,
+  STA_STATIC
+} station_config_dhcp;
+
+typedef struct {
+  uint8_t ssid[32];
+  uint8_t password[64];
+  uint8_t bssid[6];
+  uint8_t dhcp;   /**< 1:DHCP, 2:Static IP */
+  union _config {
+    uint32_t  addr[5];
+    struct _sta {
+      uint32_t ip;
+      uint32_t gateway;
+      uint32_t netmask;
+      uint32_t dns1;
+      uint32_t dns2;
+    } sta;
+  } config;
+} station_config_t;
+
 class AutoConnectCredentialBase {
  public:
   explicit AutoConnectCredentialBase() : _entries(0), _containSize(0) {}
   virtual ~AutoConnectCredentialBase() {}
   virtual uint8_t entries(void) { return _entries; }
   virtual bool    del(const char* ssid) = 0;
-  virtual int8_t  load(const char* ssid, struct station_config* config) = 0;
-  virtual bool    load(int8_t entry, struct station_config* config) = 0;
-  virtual bool    save(const struct station_config* config) = 0;
+  virtual int8_t  load(const char* ssid, station_config_t* config) = 0;
+  virtual bool    load(int8_t entry, station_config_t* config) = 0;
+  virtual bool    save(const station_config_t* config) = 0;
 
  protected:
   virtual void  _allocateEntry(void) = 0; /**< Initialize storage for credentials. */
@@ -88,15 +103,15 @@ class AutoConnectCredential : public AutoConnectCredentialBase {
   explicit AutoConnectCredential(uint16_t offset);
   ~AutoConnectCredential();
   bool    del(const char* ssid) override;
-  int8_t  load(const char* ssid, struct station_config* config) override;
-  bool    load(int8_t entry, struct station_config* config) override;
-  bool    save(const struct station_config* config) override;
+  int8_t  load(const char* ssid, station_config_t* config) override;
+  bool    load(int8_t entry, station_config_t* config) override;
+  bool    save(const station_config_t* config) override;
 
  protected:
   void    _allocateEntry(void) override;  /**< Initialize storage for credentials. */
 
  private:
-  void    _retrieveEntry(char* ssid, char* password, uint8_t* bssid);   /**< Read an available entry. */
+  void    _retrieveEntry(station_config_t* config);   /**< Read an available entry. */
 
   int       _dp;            /**< The current address in EEPROM */
   int       _ep;            /**< The current entry address in EEPROM */
@@ -127,20 +142,22 @@ class AutoConnectCredential : public AutoConnectCredentialBase {
   ~AutoConnectCredential();
   bool    del(const char* ssid) override;
   uint8_t entries(void) override;
-  int8_t  load(const char* ssid, struct station_config* config) override;
-  bool    load(int8_t entry, struct station_config* config) override;
-  bool    save(const struct station_config* config) override;
+  int8_t  load(const char* ssid, station_config_t* config) override;
+  bool    load(int8_t entry, station_config_t* config) override;
+  bool    save(const station_config_t* config) override;
 
  protected:
   void    _allocateEntry(void) override;  /**< Initialize storage for credentials. */
 
  private:
   typedef struct {
-    String  password;
-    uint8_t bssid[6];
+    String   password;
+    uint8_t  bssid[6];
+    uint8_t  dhcp;   /**< 1:DHCP, 2:Static IP */
+    uint32_t ip[5];
   } AC_CREDTBODY_t;         /**< Credential entry */
   typedef std::map<String, AC_CREDTBODY_t>  AC_CREDT_t;
-  typedef station_config  station_config_t;
+  // typedef station_config  station_config_t;
 
   bool    _add(const station_config_t* config); /**< Add an entry */
   size_t  _commit(void);    /**< Write back to the nvs */
diff --git a/src/AutoConnectPage.cpp b/src/AutoConnectPage.cpp
index 269fc95..24b0257 100644
--- a/src/AutoConnectPage.cpp
+++ b/src/AutoConnectPage.cpp
@@ -2,8 +2,8 @@
  *  AutoConnect portal site web page implementation.
  *  @file   AutoConnectPage.h
  *  @author hieromon@gmail.com
- *  @version    1.0.2
- *  @date   2019-09-17
+ *  @version    1.1.0
+ *  @date   2019-10-07
  *  @copyright  MIT license.
  */
 
@@ -38,12 +38,12 @@ const char AutoConnect::_CSS_BASE[] PROGMEM = {
   ".base-panel{"
     "margin:0 22px 0 22px"
   "}"
-  ".base-panel>*>label{"
+  ".base-panel * label{"
     "display:inline-block;"
     "width:3.0em;"
     "text-align:right"
   "}"
-  ".base-panel>*>label.slist{"
+  ".base-panel * .slist{"
     "width:auto;"
     "font-size:0.9em;"
     "margin-left:10px;"
@@ -100,34 +100,33 @@ const char AutoConnect::_CSS_BASE[] PROGMEM = {
 
 /**< non-marked list for UL */
 const char AutoConnect::_CSS_UL[] PROGMEM = {
-  "ul.noorder{"
+  ".noorder,.exp{"
     "padding:0;"
     "list-style:none;"
     "display:table"
   "}"
-  "ul.noorder li{"
-    "display:table-row"
+  ".noorder li,.exp{"
+    "display:table-row-group"
   "}"
-  "ul.noorder>*>label{"
+  ".noorder li label, .exp li *{"
     "display:table-cell;"
     "width:auto;"
-    "margin-right:10px;"
     "text-align:right;"
     "padding:10px 0.5em"
   "}"
-  "ul.noorder input[type=\"checkbox\"]{"
+  ".noorder input[type=\"checkbox\"]{"
     "-moz-appearance:checkbox;"
     "-webkit-appearance:checkbox"
   "}"
-  "ul.noorder input[type=\"radio\"]{"
+  ".noorder input[type=\"radio\"]{"
     "margin-right:0.5em;"
     "-moz-appearance:radio;"
     "-webkit-appearance:radio"
   "}"
-  "ul.noorder input[type=\"text\"]{"
+  ".noorder input[type=\"text\"]{"
     "width:auto"
   "}"
-  "ul.noorder input[type=\"text\"]:invalid{"
+  ".noorder input[type=\"text\"]:invalid{"
     "background:#fce4d6"
   "}"
 };
@@ -223,7 +222,8 @@ const char AutoConnect::_CSS_INPUT_TEXT[] PROGMEM = {
     "color:#D9434E"
   "}"
   ".aux-page label{"
-    "padding:10px 0.5em"
+    "display:inline;"
+    "padding:10px 0.5em;"
   "}"
 };
 
@@ -683,18 +683,44 @@ const char  AutoConnect::_PAGE_CONFIGNEW[] PROGMEM = {
               "<label for=\"passphrase\">Passphrase</label>"
               "<input id=\"passphrase\" type=\"password\" name=\"" AUTOCONNECT_PARAMID_PASS "\" placeholder=\"Passphrase\">"
             "</li>"
-            "<br><li><input type=\"submit\" value=\"Apply\"></li>"
+            "<li>"
+              "<label for=\"dhcp\">Enable DHCP</label>"
+              "<input id=\"dhcp\" type=\"checkbox\" name=\"dhcp\" value=\"en\" checked onclick=\"vsw(this.checked);\">"
+            "</li>"
+            "<li class=\"exp\" style=\"display:none\">"
+              "<label for=\"sip\">IP Address</label>"
+              "<input id=\"sip\" type=\"text\" name=\"staip\" value=\"{{CONFIG_IP}}\">"
+            "</li>"
+            "<li class=\"exp\" style=\"display:none\">"
+              "<label for=\"gw\">Gateway</label>"
+              "<input id=\"gw\" type=\"text\" name=\"gateway\" value=\"{{CONFIG_GW}}\">"
+            "</li>"
+            "<li class=\"exp\" style=\"display:none\">"
+              "<label for=\"nm\">Netmask</label>"
+              "<input id=\"nm\" type=\"text\" name=\"netmask\" value=\"{{CONFIG_NM}}\">"
+            "</li>"
+            "<li class=\"exp\" style=\"display:none\">"
+              "<label for=\"ns1\">DNS1</label>"
+              "<input id=\"ns1\" type=\"text\" name=\"dns1\" value=\"{{CONFIG_DNS1}}\">"
+            "</li>"
+            "<li class=\"exp\" style=\"display:none\">"
+              "<label for=\"ns2\">DNS2</label>"
+              "<input id=\"ns2\" type=\"text\" name=\"dns2\" value=\"{{CONFIG_DNS2}}\">"
+            "</li>"
+            "<li><input type=\"submit\" value=\"Apply\"></li>"
           "</ul>"
         "</form>"
       "</div>"
     "</div>"
-  "</body>"
   "<script type=\"text/javascript\">"
-    "function onFocus(value){"
-      "document.getElementById('ssid').value=value;"
-      "document.getElementById('passphrase').focus();"
+    "function onFocus(e){"
+      "document.getElementById('ssid').value=e,document.getElementById('passphrase').focus()"
+    "}"
+    "function vsw(e){"
+      "var t;t=e?'none':'table-row';for(const e of document.getElementsByClassName('exp'))e.style.display=t;e||document.getElementById('sip').focus()"
     "}"
   "</script>"
+  "</body>"
   "</html>"
 };
 
@@ -1189,10 +1215,35 @@ String AutoConnect::_token_HIDDEN_COUNT(PageArgument& args) {
   return String(_hiddenSSIDCount);
 }
 
+String AutoConnect::_token_CONFIG_STAIP(PageArgument& args) {
+  AC_UNUSED(args);
+  return !_apConfig.staip ? String(F("0.0.0.0")) : _apConfig.staip.toString();
+}
+
+String AutoConnect::_token_CONFIG_STAGATEWAY(PageArgument& args) {
+  AC_UNUSED(args);
+  return !_apConfig.staGateway ? String(F("0.0.0.0")) : _apConfig.staGateway.toString();
+}
+
+String AutoConnect::_token_CONFIG_STANETMASK(PageArgument& args) {
+  AC_UNUSED(args);
+  return !_apConfig.staNetmask ? String(F("0.0.0.0")) : _apConfig.staNetmask.toString();
+}
+
+String AutoConnect::_token_CONFIG_STADNS1(PageArgument& args) {
+  AC_UNUSED(args);
+  return !_apConfig.dns1 ? String(F("0.0.0.0")) : _apConfig.dns1.toString();
+}
+
+String AutoConnect::_token_CONFIG_STADNS2(PageArgument& args) {
+  AC_UNUSED(args);
+  return !_apConfig.dns2 ? String(F("0.0.0.0")) : _apConfig.dns2.toString();
+}
+
 String AutoConnect::_token_OPEN_SSID(PageArgument& args) {
   AC_UNUSED(args);
   AutoConnectCredential credit(_apConfig.boundaryOffset);
-  struct station_config entry;
+  station_config_t  entry;
   String ssidList;
   String rssiSym;
 
@@ -1210,7 +1261,7 @@ String AutoConnect::_token_OPEN_SSID(PageArgument& args) {
     ssidList += String(F("<input id=\"sb\" type=\"submit\" name=\"" AUTOCONNECT_PARAMID_CRED "\" value=\"")) + String(reinterpret_cast<char*>(entry.ssid)) + String(F("\"><label class=\"slist\">"));
     rssiSym = String(F("N/A</label>"));
     for (int8_t sc = 0; sc < (int8_t)_scanCount; sc++) {
-      if (!memcmp(entry.bssid, WiFi.BSSID(sc), sizeof(station_config::bssid))) {
+      if (!memcmp(entry.bssid, WiFi.BSSID(sc), sizeof(station_config_t::bssid))) {
         _connectCh = WiFi.channel(sc);
         rssiSym = String(AutoConnect::_toWiFiQuality(WiFi.RSSI(sc))) + String(F("&#037;&ensp;Ch.")) + String(_connectCh) + String(F("</label>"));
         if (WiFi.encryptionType(sc) != ENC_TYPE_NONE)
@@ -1240,7 +1291,7 @@ String AutoConnect::_token_BOOTURI(PageArgument& args) {
 
 String AutoConnect::_token_CURRENT_SSID(PageArgument& args) {
   AC_UNUSED(args);
-  char  ssid_c[sizeof(station_config::ssid) + 1];
+  char  ssid_c[sizeof(station_config_t::ssid) + 1];
   *ssid_c = '\0';
   strncat(ssid_c, reinterpret_cast<char*>(_credential.ssid), sizeof(ssid_c) - 1);
   String  ssid = String(ssid_c);
@@ -1307,6 +1358,11 @@ PageElement* AutoConnect::_setupPage(String uri) {
     elm->addToken(String(FPSTR("LIST_SSID")), std::bind(&AutoConnect::_token_LIST_SSID, this, std::placeholders::_1));
     elm->addToken(String(FPSTR("SSID_COUNT")), std::bind(&AutoConnect::_token_SSID_COUNT, this, std::placeholders::_1));
     elm->addToken(String(FPSTR("HIDDEN_COUNT")), std::bind(&AutoConnect::_token_HIDDEN_COUNT, this, std::placeholders::_1));
+    elm->addToken(String(FPSTR("CONFIG_IP")), std::bind(&AutoConnect::_token_CONFIG_STAIP, this, std::placeholders::_1));
+    elm->addToken(String(FPSTR("CONFIG_GW")), std::bind(&AutoConnect::_token_CONFIG_STAGATEWAY, this, std::placeholders::_1));
+    elm->addToken(String(FPSTR("CONFIG_NM")), std::bind(&AutoConnect::_token_CONFIG_STANETMASK, this, std::placeholders::_1));
+    elm->addToken(String(FPSTR("CONFIG_DNS1")), std::bind(&AutoConnect::_token_CONFIG_STADNS1, this, std::placeholders::_1));
+    elm->addToken(String(FPSTR("CONFIG_DNS2")), std::bind(&AutoConnect::_token_CONFIG_STADNS2, this, std::placeholders::_1));
   }
   else if (uri == String(AUTOCONNECT_URI_CONNECT)) {
 
diff --git a/src/AutoConnectPage.h b/src/AutoConnectPage.h
index 3a53869..748b945 100644
--- a/src/AutoConnectPage.h
+++ b/src/AutoConnectPage.h
@@ -2,8 +2,8 @@
  *  AutoConnect portal site web page declaration.
  *  @file   AutoConnectPage.h
  *  @author hieromon@gmail.com
- *  @version    1.0.0
- *  @date   2019-08-15
+ *  @version    1.1.0
+ *  @date   2019-10-04
  *  @copyright  MIT license.
  */
 
@@ -15,6 +15,12 @@
 #define AUTOCONNECT_PARAMID_SSID  "SSID"
 #define AUTOCONNECT_PARAMID_PASS  "Passphrase"
 #define AUTOCONNECT_PARAMID_CRED  "Credential"
+#define AUTOCONNECT_PARAMID_DHCP  "dhcp"
+#define AUTOCONNECT_PARAMID_STAIP "staip"
+#define AUTOCONNECT_PARAMID_GTWAY "gateway"
+#define AUTOCONNECT_PARAMID_NTMSK "netmask"
+#define AUTOCONNECT_PARAMID_DNS1  "dns1"
+#define AUTOCONNECT_PARAMID_DNS2  "dns2"
 
 // AutoConnect menu hyper-link as image
 #define AUTOCONNECT_GLYPH_COG_16  "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAA" \

From ba3251f42b7411aca95d064bb863f419b71ed89e Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Tue, 8 Oct 2019 16:59:34 +0900
Subject: [PATCH 02/25] Support the Config New with static IP

---
 mkdocs/images/staticip.png | Bin 0 -> 24328 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 mkdocs/images/staticip.png

diff --git a/mkdocs/images/staticip.png b/mkdocs/images/staticip.png
new file mode 100644
index 0000000000000000000000000000000000000000..7a02cd22c7449c24897497c3c4abdcf693ab6637
GIT binary patch
literal 24328
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
R2ic=^P8c4~IcoRYzX0p6tf2q^

literal 0
HcmV?d00001


From 7d99c49802f5debffe4df64237f09f827e21f820 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Tue, 8 Oct 2019 18:28:19 +0900
Subject: [PATCH 03/25] Fixed static IP loss with Open SSIDs

---
 src/AutoConnect.cpp | 67 +++++++++++++++++++++++++--------------------
 1 file changed, 37 insertions(+), 30 deletions(-)

diff --git a/src/AutoConnect.cpp b/src/AutoConnect.cpp
index 9de0f0b..2d13fde 100644
--- a/src/AutoConnect.cpp
+++ b/src/AutoConnect.cpp
@@ -806,9 +806,7 @@ String AutoConnect::_induceConnect(PageArgument& args) {
     // Read from EEPROM
     AutoConnectCredential credential(_apConfig.boundaryOffset);
     station_config_t entry;
-    credential.load(args.arg(String(F(AUTOCONNECT_PARAMID_CRED))).c_str(), &entry);
-    strncpy(reinterpret_cast<char*>(_credential.ssid), reinterpret_cast<const char*>(entry.ssid), sizeof(_credential.ssid));
-    strncpy(reinterpret_cast<char*>(_credential.password), reinterpret_cast<const char*>(entry.password), sizeof(_credential.password));
+    credential.load(args.arg(String(F(AUTOCONNECT_PARAMID_CRED))).c_str(), &_credential);
 #ifdef AC_DEBUG
     IPAddress staip = IPAddress(_credential.config.sta.ip);
     AC_DBG("Credential loaded:%.*s(%s)\n", sizeof(station_config_t::ssid), reinterpret_cast<const char*>(_credential.ssid), _credential.dhcp == STA_DHCP ? "DHCP" : staip.toString().c_str());
@@ -819,8 +817,44 @@ String AutoConnect::_induceConnect(PageArgument& args) {
     // Credential had by the post parameter.
     strncpy(reinterpret_cast<char*>(_credential.ssid), args.arg(String(F(AUTOCONNECT_PARAMID_SSID))).c_str(), sizeof(_credential.ssid));
     strncpy(reinterpret_cast<char*>(_credential.password), args.arg(String(F(AUTOCONNECT_PARAMID_PASS))).c_str(), sizeof(_credential.password));
+    // Static IP detection
+    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_DHCP)))) {
+      _credential.dhcp = STA_DHCP;
+      _credential.config.sta.ip = _credential.config.sta.gateway = _credential.config.sta.netmask = _credential.config.sta.dns1 = _credential.config.sta.dns2 = 0U;
+    }
+    else {
+      _credential.dhcp = STA_STATIC;
+      IPAddress cast;
+      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_STAIP)))) {
+        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_STAIP))));
+        _credential.config.sta.ip = static_cast<uint32_t>(cast);
+      }
+      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_GTWAY)))) {
+        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_GTWAY))));
+        _credential.config.sta.gateway = static_cast<uint32_t>(cast);
+      }
+      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_NTMSK)))) {
+        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_NTMSK))));
+        _credential.config.sta.netmask = static_cast<uint32_t>(cast);
+      }
+      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_DNS1)))) {
+        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_DNS1))));
+        _credential.config.sta.dns1 = static_cast<uint32_t>(cast);
+      }
+      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_DNS2)))) {
+        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_DNS2))));
+        _credential.config.sta.dns2 = static_cast<uint32_t>(cast);
+      }
+    }
   }
 
+  // Restore the configured IPs to STA configuration
+  _apConfig.staip = static_cast<IPAddress>(_credential.config.sta.ip);
+  _apConfig.staGateway = static_cast<IPAddress>(_credential.config.sta.gateway);
+  _apConfig.staNetmask = static_cast<IPAddress>(_credential.config.sta.netmask);
+  _apConfig.dns1 = static_cast<IPAddress>(_credential.config.sta.dns1);
+  _apConfig.dns2 = static_cast<IPAddress>(_credential.config.sta.dns2);
+
   // Determine the connection channel based on the scan result.
   _connectCh = 0;
   for (uint8_t nn = 0; nn < _scanCount; nn++) {
@@ -831,33 +865,6 @@ String AutoConnect::_induceConnect(PageArgument& args) {
     }
   }
 
-  // Static IP detection
-  _credential.config.sta.ip = _credential.config.sta.gateway = _credential.config.sta.netmask = _credential.config.sta.dns1 = _credential.config.sta.dns2 = 0U;
-  if (!args.hasArg(String(F(AUTOCONNECT_PARAMID_DHCP)))) {
-    _credential.dhcp = STA_STATIC;
-    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_STAIP)))) {
-      _apConfig.staip.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_STAIP))));
-      _credential.config.sta.ip = (uint32_t)_apConfig.staip;
-    }
-    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_GTWAY)))) {
-      _apConfig.staGateway.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_GTWAY))));
-      _credential.config.sta.gateway = (uint32_t)_apConfig.staGateway;
-    }
-    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_NTMSK)))) {
-      _apConfig.staNetmask.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_NTMSK))));
-      _credential.config.sta.netmask = (uint32_t)_apConfig.staNetmask;
-    }
-    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_DNS1)))) {
-      _apConfig.dns1.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_DNS1))));
-      _credential.config.sta.dns1 = (uint32_t)_apConfig.dns1;
-    }
-    if (args.hasArg(String(F(AUTOCONNECT_PARAMID_DNS2))))
-      _apConfig.dns2.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_DNS2))));
-      _credential.config.sta.dns2 = (uint32_t)_apConfig.dns2;
-  }
-  else
-    _credential.dhcp = STA_DHCP;
-
   // Turn on the trigger to start WiFi.begin().
   _rfConnect = true;
 

From 8a4dabef12992997bec45b51a9f00af9f9279f98 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Tue, 8 Oct 2019 18:29:31 +0900
Subject: [PATCH 04/25] Change for testing

---
 src/AutoConnectDefs.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/AutoConnectDefs.h b/src/AutoConnectDefs.h
index 2a5e171..97e8fd5 100644
--- a/src/AutoConnectDefs.h
+++ b/src/AutoConnectDefs.h
@@ -11,7 +11,7 @@
 #define _AUTOCONNECTDEFS_H_
 
 // Uncomment the following AC_DEBUG to enable debug output.
-//#define AC_DEBUG
+#define AC_DEBUG
 
 // Debug output destination can be defined externally with AC_DEBUG_PORT
 #ifndef AC_DEBUG_PORT

From dde5306cbdae021c0e6ae3424cc83e2612d69f72 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Wed, 9 Oct 2019 17:38:40 +0900
Subject: [PATCH 05/25] Support the Config New with static IP

---
 mkdocs/images/process_begin.svg | 250 ++++++++++++++++++++++++++++----
 1 file changed, 221 insertions(+), 29 deletions(-)

diff --git a/mkdocs/images/process_begin.svg b/mkdocs/images/process_begin.svg
index 9815b95..ab1e19a 100644
--- a/mkdocs/images/process_begin.svg
+++ b/mkdocs/images/process_begin.svg
@@ -9,9 +9,9 @@
    xmlns="http://www.w3.org/2000/svg"
    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   width="99.56517mm"
-   height="304.07242mm"
-   viewBox="0 0 99.56517 304.07241"
+   width="99.499031mm"
+   height="371.83472mm"
+   viewBox="0 0 99.499031 371.83471"
    version="1.1"
    id="svg8776"
    inkscape:version="0.92.2 (5c3e80d, 2017-08-06)"
@@ -224,6 +224,21 @@
          style="stroke-width:2"
          id="path2786" />
     </symbol>
+    <marker
+       inkscape:stockid="Arrow2Mstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="marker10923-1"
+       style="overflow:visible"
+       inkscape:isstock="true">
+      <path
+         id="path10921-8"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         transform="scale(0.6)"
+         inkscape:connector-curvature="0" />
+    </marker>
   </defs>
   <sodipodi:namedview
      id="base"
@@ -233,12 +248,12 @@
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
      inkscape:zoom="1.4142136"
-     inkscape:cx="192.80115"
-     inkscape:cy="364.94967"
+     inkscape:cx="182.89588"
+     inkscape:cy="1285.7123"
      inkscape:document-units="mm"
      inkscape:current-layer="layer1"
      showgrid="false"
-     inkscape:snap-global="false"
+     inkscape:snap-global="true"
      inkscape:snap-bbox="true"
      inkscape:snap-nodes="true"
      inkscape:snap-others="true"
@@ -261,8 +276,8 @@
     <inkscape:grid
        type="xygrid"
        id="grid9104"
-       originx="-23.598368"
-       originy="15.544285" />
+       originx="-23.664512"
+       originy="15.544299" />
   </sodipodi:namedview>
   <metadata
      id="metadata8773">
@@ -280,7 +295,17 @@
      inkscape:label="レイヤー 1"
      inkscape:groupmode="layer"
      id="layer1"
-     transform="translate(-23.598368,-8.4718652)">
+     transform="translate(-23.664512,59.290408)">
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208337,-11.256129 v 3.8405916"
+       id="path9639-8-5-5"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458335px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208337,16.669816 v 3.840593"
+       id="path9639"
+       inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
        d="m 58.208334,32.416659 v 4.08568"
@@ -464,7 +489,7 @@
     </g>
     <g
        id="g9633"
-       transform="translate(-33.072919,2.6458338)">
+       transform="translate(-33.734378,-65.116439)">
       <rect
          ry="0.26458257"
          rx="0.26458332"
@@ -486,11 +511,6 @@
            id="tspan9136"
            sodipodi:role="line">STA</tspan></text>
     </g>
-    <path
-       style="fill:none;stroke:#000000;stroke-width:0.26458335px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 58.208334,16.669815 v 3.840593"
-       id="path9639"
-       inkscape:connector-curvature="0" />
     <g
        id="g9714"
        transform="translate(-78.07551,36.012307)">
@@ -781,13 +801,13 @@
     </g>
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458335px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="M 105.83333,175.75504 V 297.54958 H 92.604167"
+       d="M 105.83318,175.75505 V 297.53597 H 92.575102"
        id="path9639-1-3-9"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="ccc" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458329px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 75.563113,86.193127 30.107867,-0.06083 0.0306,81.420513"
+       d="m 75.513505,86.193127 30.107915,-0.06083 0.0306,81.420513"
        id="path10088"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="ccc" />
@@ -838,13 +858,13 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458329px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="M 40.845696,26.589892 23.730739,26.467079 23.812499,163.71219 H 58.208331"
+       d="M 40.91184,26.461738 23.796883,26.338925 23.878643,163.58402 H 58.274475"
        id="path10088-9"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker10923)"
-       d="m 24.291915,102.06832 h 16.45392"
+       d="m 24.374806,102.06831 h 16.52812"
        id="path10088-92"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cc" />
@@ -870,7 +890,7 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#Arrow2Mstart)"
-       d="m 57.679167,215.1778 -33.866667,0.13255 0.0073,40.48128 h 16.92604"
+       d="m 57.676398,215.1778 -33.837442,0.13255 0.0074,40.48128 H 40.75779"
        id="path10088-92-6"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
@@ -891,7 +911,7 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker10931)"
-       d="m 58.7375,265.97716 33.866674,-0.13255 -0.0073,-40.48128 H 75.670833"
+       d="m 58.570889,265.97716 33.866674,-0.13255 -0.0073,-40.48128 H 75.504222"
        id="path10088-92-6-8"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
@@ -912,7 +932,7 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker10937)"
-       d="m 58.7375,297.59504 33.734352,-0.0718 -0.007,-21.90474 H 75.538509"
+       d="m 58.708562,297.61156 33.734352,-0.0718 -0.007,-21.90474 H 75.509571"
        id="path10088-92-6-8-3"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
@@ -982,12 +1002,6 @@
          x="60.844864"
          y="110.3716"
          style="stroke-width:0.26458332">YES</tspan></text>
-    <path
-       style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 75.257782,153.66218 30.310608,0.13228"
-       id="path10088-92-3"
-       inkscape:connector-curvature="0"
-       sodipodi:nodetypes="cc" />
     <text
        xml:space="preserve"
        style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
@@ -1165,7 +1179,7 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 41.085466,42.413935 -10.12458,-0.0196 0.01766,22.036862 h 27.103849"
+       d="m 41.054322,42.447007 -10.258285,-0.0196 0.01789,22.036862 H 58.27571"
        id="path10088-9-7"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
@@ -1201,5 +1215,183 @@
          x="60.844868"
          y="50.651817"
          style="stroke-width:0.26458332">Specified</tspan></text>
+    <g
+       id="g1109"
+       transform="translate(-37.739185,-61.587591)">
+      <g
+         id="g2292">
+        <rect
+           style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.26458329;stroke-linecap:butt;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill"
+           id="rect9134-4-7-4-7"
+           width="34.395828"
+           height="7.9375019"
+           x="78.749603"
+           y="14.472153"
+           rx="0.26458332"
+           ry="0.26458257" />
+        <text
+           xml:space="preserve"
+           style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+           x="84.833466"
+           y="19.319145"
+           id="text9138-7-3-9-9"><tspan
+             y="19.319145"
+             x="84.833466"
+             sodipodi:role="line"
+             id="tspan1104">Set hostname</tspan></text>
+      </g>
+    </g>
+    <g
+       id="g1197"
+       transform="translate(-0.22278483,12.761983)">
+      <rect
+         ry="0.26458257"
+         rx="0.26458332"
+         y="-4.1619601"
+         x="41.233208"
+         height="7.9375019"
+         width="34.395828"
+         id="rect9134-4-7-4-7-5"
+         style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.26458329;stroke-linecap:butt;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill" />
+      <text
+         id="text9138-7-3-9-9-9"
+         y="0.68503231"
+         x="44.635841"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         xml:space="preserve"><tspan
+           y="0.68503231"
+           x="44.635841"
+           id="tspan1192"
+           sodipodi:role="line">WiFi.config (STA)</tspan></text>
+    </g>
+    <g
+       id="g1187"
+       transform="translate(-46.605488,-48.241008)">
+      <rect
+         ry="0.26458257"
+         rx="0.26458332"
+         y="13.168248"
+         x="87.615906"
+         height="7.9375019"
+         width="34.395828"
+         id="rect9134-4-7-4-7-57"
+         style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.26458329;stroke-linecap:butt;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill" />
+      <text
+         id="text9138-7-3-9-9-90"
+         y="18.015242"
+         x="89.345772"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         xml:space="preserve"><tspan
+           id="tspan1182"
+           sodipodi:role="line"
+           x="89.345772"
+           y="18.015242">Load current config</tspan></text>
+    </g>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208332,-27.002966 v 3.840593"
+       id="path9639-8-5"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208332,-51.088322 v 3.840592"
+       id="path9639-8-5-3"
+       inkscape:connector-curvature="0" />
+    <g
+       id="g2166"
+       transform="translate(-30.682548,-13.096212)">
+      <rect
+         transform="matrix(0.94594599,0.32432418,-0.94594599,0.32432418,0,0)"
+         ry="3.6888673e-006"
+         rx="3.6888673e-006"
+         y="-62.503849"
+         x="31.466501"
+         height="18.355465"
+         width="18.355474"
+         id="rect9184-6-3-4-5"
+         style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.33777279;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill" />
+      <text
+         id="text9188-6"
+         y="-2.9309402"
+         x="82.091293"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1em;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         xml:space="preserve"><tspan
+           y="-2.9309402"
+           x="82.091293"
+           id="tspan2161"
+           sodipodi:role="line">Static IP</tspan></text>
+    </g>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26499999;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 75.49653,153.66198 H 105.6468"
+       id="path10088-92-2"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cc" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458338px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208337,4.6271392 v 3.840592"
+       id="path9639-0"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="M 58.208337,0.78654773 V 4.6271395"
+       id="path9639-0-5"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208332,-39.045645 v 3.840594"
+       id="path9639-8-5-6"
+       inkscape:connector-curvature="0" />
+    <g
+       id="g2200"
+       transform="translate(-37.753577,2.3026717)">
+      <rect
+         ry="0.26458257"
+         rx="0.26458332"
+         y="-9.5859175"
+         x="78.764"
+         height="7.9375019"
+         width="34.395828"
+         id="rect9134-4-7-4-7-57-3"
+         style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.26458329;stroke-linecap:butt;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill" />
+      <text
+         id="text9138-7-3-9-9-90-2"
+         y="-4.7389245"
+         x="79.303238"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         xml:space="preserve"><tspan
+           id="tspan2195"
+           sodipodi:role="line"
+           x="79.303238"
+           y="-4.7389245">Restore saved config</tspan></text>
+    </g>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 40.84505,-17.209253 -10.258285,-0.0196 0.01789,22.0368617 h 27.461784"
+       id="path10088-9-7-3"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cccc" />
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="35.828152"
+       y="-18.166817"
+       id="text10760-5-3"><tspan
+         sodipodi:role="line"
+         id="tspan10758-9-2"
+         x="35.828152"
+         y="-18.166817"
+         style="stroke-width:0.26458332">NO</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="60.096973"
+       y="-8.7963543"
+       id="text10760-57"><tspan
+         sodipodi:role="line"
+         id="tspan10758-6"
+         x="60.096973"
+         y="-8.7963543"
+         style="stroke-width:0.26458332">YES</tspan></text>
   </g>
 </svg>

From 042e9300a1bb45332e41086e8e1705b7dfccf211 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Thu, 10 Oct 2019 16:46:57 +0900
Subject: [PATCH 06/25] Changed IP address regular expression

---
 examples/ConfigIP/ConfigIP.ino | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/examples/ConfigIP/ConfigIP.ino b/examples/ConfigIP/ConfigIP.ino
index c77d8fa..7364fa3 100644
--- a/examples/ConfigIP/ConfigIP.ino
+++ b/examples/ConfigIP/ConfigIP.ino
@@ -63,28 +63,28 @@ static const char AUX_CONFIGIP[] PROGMEM = R"(
       "name": "staip",
       "type": "ACInput",
       "label": "IP",
-      "pattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$",
+      "pattern": "^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$",
       "global": true
     },
     {
       "name": "gateway",
       "type": "ACInput",
       "label": "Gateway",
-      "pattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$",
+      "pattern": "^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$",
       "global": true
     },
     {
       "name": "netmask",
       "type": "ACInput",
       "label": "Netmask",
-      "pattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$",
+      "pattern": "^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$",
       "global": true
     },
     {
       "name": "dns1",
       "type": "ACInput",
       "label": "DNS",
-      "pattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$",
+      "pattern": "^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$",
       "global": true
     },
     {

From 650885f0cf74b101ede100d9c81ce5fb185a6f3d Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Thu, 10 Oct 2019 16:48:58 +0900
Subject: [PATCH 07/25] Added a pattern to the static IP fields

---
 src/AutoConnectPage.cpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/AutoConnectPage.cpp b/src/AutoConnectPage.cpp
index 24b0257..13ae8ba 100644
--- a/src/AutoConnectPage.cpp
+++ b/src/AutoConnectPage.cpp
@@ -713,6 +713,10 @@ const char  AutoConnect::_PAGE_CONFIGNEW[] PROGMEM = {
       "</div>"
     "</div>"
   "<script type=\"text/javascript\">"
+    "window.onload=function(){"
+      "['sip','gw','nm','ns1','ns2'].forEach(function(n,o,t){"
+        "io=document.getElementById(n),io.placeholder='0.0.0.0',io.pattern='^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$'})"
+      "};"
     "function onFocus(e){"
       "document.getElementById('ssid').value=e,document.getElementById('passphrase').focus()"
     "}"

From 2441c874835d6f722494f0aba80b078c078dcd83 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Thu, 10 Oct 2019 16:51:19 +0900
Subject: [PATCH 08/25] Changed parsing for entered IP addresses

---
 src/AutoConnect.cpp | 33 +++++++++++++--------------------
 1 file changed, 13 insertions(+), 20 deletions(-)

diff --git a/src/AutoConnect.cpp b/src/AutoConnect.cpp
index 2d13fde..9ae4c59 100644
--- a/src/AutoConnect.cpp
+++ b/src/AutoConnect.cpp
@@ -824,26 +824,19 @@ String AutoConnect::_induceConnect(PageArgument& args) {
     }
     else {
       _credential.dhcp = STA_STATIC;
-      IPAddress cast;
-      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_STAIP)))) {
-        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_STAIP))));
-        _credential.config.sta.ip = static_cast<uint32_t>(cast);
-      }
-      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_GTWAY)))) {
-        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_GTWAY))));
-        _credential.config.sta.gateway = static_cast<uint32_t>(cast);
-      }
-      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_NTMSK)))) {
-        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_NTMSK))));
-        _credential.config.sta.netmask = static_cast<uint32_t>(cast);
-      }
-      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_DNS1)))) {
-        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_DNS1))));
-        _credential.config.sta.dns1 = static_cast<uint32_t>(cast);
-      }
-      if (args.hasArg(String(F(AUTOCONNECT_PARAMID_DNS2)))) {
-        cast.fromString(args.arg(String(F(AUTOCONNECT_PARAMID_DNS2))));
-        _credential.config.sta.dns2 = static_cast<uint32_t>(cast);
+      const String paramId[] = {
+        String(F(AUTOCONNECT_PARAMID_STAIP)),
+        String(F(AUTOCONNECT_PARAMID_GTWAY)),
+        String(F(AUTOCONNECT_PARAMID_NTMSK)),
+        String(F(AUTOCONNECT_PARAMID_DNS1)),
+        String(F(AUTOCONNECT_PARAMID_DNS2))
+      };
+      for (uint8_t i = 0; i < sizeof(station_config_t::_config::addr) / sizeof(uint32_t); i++) {
+        if (args.hasArg(paramId[i])) {
+          IPAddress ip;
+          if (ip.fromString(args.arg(paramId[i])))
+            _credential.config.addr[i] = static_cast<uint32_t>(ip);
+        }
       }
     }
   }

From e61d6cdcdbb8b95145fc453ede83dbe1f33a2ff7 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Thu, 10 Oct 2019 17:38:24 +0900
Subject: [PATCH 09/25] Support the Config New with static IP

---
 mkdocs/images/newap.png        | Bin 63923 -> 76246 bytes
 mkdocs/images/newap_static.png | Bin 0 -> 101206 bytes
 mkdocs/menu.md                 |   6 +++++-
 3 files changed, 5 insertions(+), 1 deletion(-)
 create mode 100644 mkdocs/images/newap_static.png

diff --git a/mkdocs/images/newap.png b/mkdocs/images/newap.png
index ebcb920e09fc47766a17dc8f406db61487e407ce..b89b3b432f939779ec43b99b112d6cf0556a1b5a 100644
GIT binary patch
literal 76246
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

literal 63923
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
B+!+7>

diff --git a/mkdocs/images/newap_static.png b/mkdocs/images/newap_static.png
new file mode 100644
index 0000000000000000000000000000000000000000..35415b0f7dc6087120dff6cd2c07d15b2e5e462e
GIT binary patch
literal 101206
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
H9yswoS>(f}

literal 0
HcmV?d00001

diff --git a/mkdocs/menu.md b/mkdocs/menu.md
index 308665e..f1a10fa 100644
--- a/mkdocs/menu.md
+++ b/mkdocs/menu.md
@@ -25,10 +25,14 @@ Currently, AutoConnect supports four menus. Undermost menu as "HOME" returns to
 ## <i class="fa fa-bars"></i> Configure new AP
 
 Scan all available access point in the vicinity and display it. Strength and security of the detected AP are marked. The <i class="fa fa-lock"></i> is indicated for the SSID that needs a security key. "**Hidden:**" means the number of hidden SSIDs discovered.  
-Enter SSID and Passphrase and tap "**apply**" to starts WiFi connection. 
+Enter SSID and Passphrase and tap "**Apply**" to starts WiFi connection. 
 
 <img src="images/newap.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" />
 
+If you want to configure with static IP, uncheck "**Enable DHCP**". Once the WiFi connection is established, the entered static IP configuration is saved in the credentials and restored to the station configuration via the [Open SSIDs](#open-ssids) menu.
+
+<img src="images/newap_static.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" />
+
 ## <i class="fa fa-bars"></i> Open SSIDs
 
 Once it was established WiFi connection, its SSID and password will be saved in the flash of ESP8266/ESP32 automatically. The **Open SSIDs** menu reads the saved SSID credentials from the flash. The stored credential data are listed by the SSID as shown below. Its label is a clickable button. Tap the SSID button, starts WiFi connection it.

From 82ed17489e2cb18515ce9e74b4bc3dbf64ac2572 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <Hieromon@users.noreply.github.com>
Date: Thu, 10 Oct 2019 22:50:12 +0900
Subject: [PATCH 10/25] Removed unused variable

---
 src/AutoConnect.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/AutoConnect.cpp b/src/AutoConnect.cpp
index 9ae4c59..9bacf60 100644
--- a/src/AutoConnect.cpp
+++ b/src/AutoConnect.cpp
@@ -805,7 +805,6 @@ String AutoConnect::_induceConnect(PageArgument& args) {
   if (args.hasArg(String(F(AUTOCONNECT_PARAMID_CRED)))) {
     // Read from EEPROM
     AutoConnectCredential credential(_apConfig.boundaryOffset);
-    station_config_t entry;
     credential.load(args.arg(String(F(AUTOCONNECT_PARAMID_CRED))).c_str(), &_credential);
 #ifdef AC_DEBUG
     IPAddress staip = IPAddress(_credential.config.sta.ip);

From 70be65dfd17900c8d6269c38a128db16af74ab66 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <Hieromon@users.noreply.github.com>
Date: Thu, 10 Oct 2019 22:50:37 +0900
Subject: [PATCH 11/25] Fixed IP address regexp

---
 src/AutoConnectPage.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/AutoConnectPage.cpp b/src/AutoConnectPage.cpp
index 13ae8ba..b029f25 100644
--- a/src/AutoConnectPage.cpp
+++ b/src/AutoConnectPage.cpp
@@ -715,7 +715,7 @@ const char  AutoConnect::_PAGE_CONFIGNEW[] PROGMEM = {
   "<script type=\"text/javascript\">"
     "window.onload=function(){"
       "['sip','gw','nm','ns1','ns2'].forEach(function(n,o,t){"
-        "io=document.getElementById(n),io.placeholder='0.0.0.0',io.pattern='^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$'})"
+        "io=document.getElementById(n),io.placeholder='0.0.0.0',io.pattern='^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$'})"
       "};"
     "function onFocus(e){"
       "document.getElementById('ssid').value=e,document.getElementById('passphrase').focus()"

From f47ecfe1f64254f21cadf22ad0655785ffdfb8b6 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Fri, 11 Oct 2019 17:19:29 +0900
Subject: [PATCH 12/25] Reduced consume memory for the ConfigNew page

---
 src/AutoConnect.h       |  6 +--
 src/AutoConnectDefs.h   |  8 ++--
 src/AutoConnectPage.cpp | 89 ++++++++++++++++++-----------------------
 src/AutoConnectPage.h   | 12 +++---
 4 files changed, 51 insertions(+), 64 deletions(-)

diff --git a/src/AutoConnect.h b/src/AutoConnect.h
index f1f385b..f35967d 100644
--- a/src/AutoConnect.h
+++ b/src/AutoConnect.h
@@ -3,7 +3,7 @@
  *	@file	AutoConnect.h
  *	@author	hieromon@gmail.com
  *	@version	1.1.0
- *	@date	2019-10-07
+ *	@date	2019-10-11
  *	@copyright	MIT license.
  */
 
@@ -377,10 +377,6 @@ class AutoConnect {
   String _token_SSID_COUNT(PageArgument& args);
   String _token_HIDDEN_COUNT(PageArgument& args);
   String _token_CONFIG_STAIP(PageArgument& args);
-  String _token_CONFIG_STAGATEWAY(PageArgument& args);
-  String _token_CONFIG_STANETMASK(PageArgument& args);
-  String _token_CONFIG_STADNS1(PageArgument& args);
-  String _token_CONFIG_STADNS2(PageArgument& args);
   String _token_OPEN_SSID(PageArgument& args);
   String _token_UPTIME(PageArgument& args);
   String _token_BOOTURI(PageArgument& args);
diff --git a/src/AutoConnectDefs.h b/src/AutoConnectDefs.h
index 97e8fd5..7589b37 100644
--- a/src/AutoConnectDefs.h
+++ b/src/AutoConnectDefs.h
@@ -2,8 +2,8 @@
  * Predefined AutoConnect configuration parameters.
  * @file AutoConnectDefs.h
  * @author hieromon@gmail.com
- * @version  1.0.0
- * @date 2019-08-15
+ * @version  1.1.0
+ * @date 2019-10-11
  * @copyright  MIT license.
  */
 
@@ -11,7 +11,7 @@
 #define _AUTOCONNECTDEFS_H_
 
 // Uncomment the following AC_DEBUG to enable debug output.
-#define AC_DEBUG
+//#define AC_DEBUG
 
 // Debug output destination can be defined externally with AC_DEBUG_PORT
 #ifndef AC_DEBUG_PORT
@@ -133,7 +133,7 @@
 
 // Reserved buffer size to build content
 #ifndef AUTOCONNECT_CONTENTBUFFER_SIZE
-#define AUTOCONNECT_CONTENTBUFFER_SIZE  (13 * 1024)
+#define AUTOCONNECT_CONTENTBUFFER_SIZE  (14 * 1024)
 #endif // !AUTOCONNECT_CONTENTBUFFER_SIZE
 
 // Number of unit lines in the page that lists available SSIDs
diff --git a/src/AutoConnectPage.cpp b/src/AutoConnectPage.cpp
index b029f25..940ca18 100644
--- a/src/AutoConnectPage.cpp
+++ b/src/AutoConnectPage.cpp
@@ -3,7 +3,7 @@
  *  @file   AutoConnectPage.h
  *  @author hieromon@gmail.com
  *  @version    1.1.0
- *  @date   2019-10-07
+ *  @date   2019-10-11
  *  @copyright  MIT license.
  */
 
@@ -687,26 +687,7 @@ const char  AutoConnect::_PAGE_CONFIGNEW[] PROGMEM = {
               "<label for=\"dhcp\">Enable DHCP</label>"
               "<input id=\"dhcp\" type=\"checkbox\" name=\"dhcp\" value=\"en\" checked onclick=\"vsw(this.checked);\">"
             "</li>"
-            "<li class=\"exp\" style=\"display:none\">"
-              "<label for=\"sip\">IP Address</label>"
-              "<input id=\"sip\" type=\"text\" name=\"staip\" value=\"{{CONFIG_IP}}\">"
-            "</li>"
-            "<li class=\"exp\" style=\"display:none\">"
-              "<label for=\"gw\">Gateway</label>"
-              "<input id=\"gw\" type=\"text\" name=\"gateway\" value=\"{{CONFIG_GW}}\">"
-            "</li>"
-            "<li class=\"exp\" style=\"display:none\">"
-              "<label for=\"nm\">Netmask</label>"
-              "<input id=\"nm\" type=\"text\" name=\"netmask\" value=\"{{CONFIG_NM}}\">"
-            "</li>"
-            "<li class=\"exp\" style=\"display:none\">"
-              "<label for=\"ns1\">DNS1</label>"
-              "<input id=\"ns1\" type=\"text\" name=\"dns1\" value=\"{{CONFIG_DNS1}}\">"
-            "</li>"
-            "<li class=\"exp\" style=\"display:none\">"
-              "<label for=\"ns2\">DNS2</label>"
-              "<input id=\"ns2\" type=\"text\" name=\"dns2\" value=\"{{CONFIG_DNS2}}\">"
-            "</li>"
+            "{{CONFIG_IP}}"
             "<li><input type=\"submit\" value=\"Apply\"></li>"
           "</ul>"
         "</form>"
@@ -714,9 +695,9 @@ const char  AutoConnect::_PAGE_CONFIGNEW[] PROGMEM = {
     "</div>"
   "<script type=\"text/javascript\">"
     "window.onload=function(){"
-      "['sip','gw','nm','ns1','ns2'].forEach(function(n,o,t){"
-        "io=document.getElementById(n),io.placeholder='0.0.0.0',io.pattern='^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$'})"
-      "};"
+      "['" AUTOCONNECT_PARAMID_STAIP "','" AUTOCONNECT_PARAMID_GTWAY "','" AUTOCONNECT_PARAMID_NTMSK "','" AUTOCONNECT_PARAMID_DNS1 "','" AUTOCONNECT_PARAMID_DNS2 "'].forEach(function(n,o,t){"
+        "io=document.getElementById(n),io.placeholder='0.0.0.0',io.pattern='^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$'});"
+      "vsw(true)};"
     "function onFocus(e){"
       "document.getElementById('ssid').value=e,document.getElementById('passphrase').focus()"
     "}"
@@ -1221,27 +1202,41 @@ String AutoConnect::_token_HIDDEN_COUNT(PageArgument& args) {
 
 String AutoConnect::_token_CONFIG_STAIP(PageArgument& args) {
   AC_UNUSED(args);
-  return !_apConfig.staip ? String(F("0.0.0.0")) : _apConfig.staip.toString();
-}
-
-String AutoConnect::_token_CONFIG_STAGATEWAY(PageArgument& args) {
-  AC_UNUSED(args);
-  return !_apConfig.staGateway ? String(F("0.0.0.0")) : _apConfig.staGateway.toString();
-}
-
-String AutoConnect::_token_CONFIG_STANETMASK(PageArgument& args) {
-  AC_UNUSED(args);
-  return !_apConfig.staNetmask ? String(F("0.0.0.0")) : _apConfig.staNetmask.toString();
-}
-
-String AutoConnect::_token_CONFIG_STADNS1(PageArgument& args) {
-  AC_UNUSED(args);
-  return !_apConfig.dns1 ? String(F("0.0.0.0")) : _apConfig.dns1.toString();
-}
-
-String AutoConnect::_token_CONFIG_STADNS2(PageArgument& args) {
-  AC_UNUSED(args);
-  return !_apConfig.dns2 ? String(F("0.0.0.0")) : _apConfig.dns2.toString();
+  static const char _configIPList[] PROGMEM =
+    "<li class=\"exp\">"
+    "<label for=\"%s\">%s</label>"
+    "<input id=\"%s\" type=\"text\" name=\"%s\" value=\"%s\">"
+    "</li>";
+  struct _reps {
+    PGM_P lid;
+    PGM_P lbl;
+  } static const reps[]  = {
+    { PSTR(AUTOCONNECT_PARAMID_STAIP), PSTR("IP Address") },
+    { PSTR(AUTOCONNECT_PARAMID_GTWAY), PSTR("Gateway") },
+    { PSTR(AUTOCONNECT_PARAMID_NTMSK), PSTR("Netmask") },
+    { PSTR(AUTOCONNECT_PARAMID_DNS1), PSTR("DNS1") },
+    { PSTR(AUTOCONNECT_PARAMID_DNS2), PSTR("DNS2") }
+  };
+  char  liCont[600];
+  char* liBuf = liCont;
+
+  for (uint8_t i = 0; i < 5; i++) {
+    IPAddress*  ip;
+    if (i == 0)
+      ip = &_apConfig.staip;
+    else if (i == 1)
+      ip = &_apConfig.staGateway;
+    else if (i == 2)
+      ip = &_apConfig.staNetmask;
+    else if (i == 3)
+      ip = &_apConfig.dns1;
+    else if (i == 4)
+      ip = &_apConfig.dns2;
+    String  ipStr = *ip ? ip->toString() : String(F("0.0.0.0"));
+    snprintf_P(liBuf, sizeof(liCont), (PGM_P)_configIPList, reps[i].lid, reps[i].lbl, reps[i].lid, reps[i].lid, ipStr.c_str());
+    liBuf += strlen(liBuf);
+  }
+  return String(liCont);
 }
 
 String AutoConnect::_token_OPEN_SSID(PageArgument& args) {
@@ -1363,10 +1358,6 @@ PageElement* AutoConnect::_setupPage(String uri) {
     elm->addToken(String(FPSTR("SSID_COUNT")), std::bind(&AutoConnect::_token_SSID_COUNT, this, std::placeholders::_1));
     elm->addToken(String(FPSTR("HIDDEN_COUNT")), std::bind(&AutoConnect::_token_HIDDEN_COUNT, this, std::placeholders::_1));
     elm->addToken(String(FPSTR("CONFIG_IP")), std::bind(&AutoConnect::_token_CONFIG_STAIP, this, std::placeholders::_1));
-    elm->addToken(String(FPSTR("CONFIG_GW")), std::bind(&AutoConnect::_token_CONFIG_STAGATEWAY, this, std::placeholders::_1));
-    elm->addToken(String(FPSTR("CONFIG_NM")), std::bind(&AutoConnect::_token_CONFIG_STANETMASK, this, std::placeholders::_1));
-    elm->addToken(String(FPSTR("CONFIG_DNS1")), std::bind(&AutoConnect::_token_CONFIG_STADNS1, this, std::placeholders::_1));
-    elm->addToken(String(FPSTR("CONFIG_DNS2")), std::bind(&AutoConnect::_token_CONFIG_STADNS2, this, std::placeholders::_1));
   }
   else if (uri == String(AUTOCONNECT_URI_CONNECT)) {
 
diff --git a/src/AutoConnectPage.h b/src/AutoConnectPage.h
index 748b945..71c44a6 100644
--- a/src/AutoConnectPage.h
+++ b/src/AutoConnectPage.h
@@ -3,7 +3,7 @@
  *  @file   AutoConnectPage.h
  *  @author hieromon@gmail.com
  *  @version    1.1.0
- *  @date   2019-10-04
+ *  @date   2019-10-11
  *  @copyright  MIT license.
  */
 
@@ -16,11 +16,11 @@
 #define AUTOCONNECT_PARAMID_PASS  "Passphrase"
 #define AUTOCONNECT_PARAMID_CRED  "Credential"
 #define AUTOCONNECT_PARAMID_DHCP  "dhcp"
-#define AUTOCONNECT_PARAMID_STAIP "staip"
-#define AUTOCONNECT_PARAMID_GTWAY "gateway"
-#define AUTOCONNECT_PARAMID_NTMSK "netmask"
-#define AUTOCONNECT_PARAMID_DNS1  "dns1"
-#define AUTOCONNECT_PARAMID_DNS2  "dns2"
+#define AUTOCONNECT_PARAMID_STAIP "sip"
+#define AUTOCONNECT_PARAMID_GTWAY "gw"
+#define AUTOCONNECT_PARAMID_NTMSK "nm"
+#define AUTOCONNECT_PARAMID_DNS1  "ns1"
+#define AUTOCONNECT_PARAMID_DNS2  "ns2"
 
 // AutoConnect menu hyper-link as image
 #define AUTOCONNECT_GLYPH_COG_16  "iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAA" \

From ba989740fd9c2369d6ad83b97e4ae1e3a85a63ba Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <Hieromon@users.noreply.github.com>
Date: Mon, 14 Oct 2019 01:57:14 +0900
Subject: [PATCH 13/25] Reduced consume memory for the ConfigNew page

---
 src/AutoConnectDefs.h   |  4 ++--
 src/AutoConnectPage.cpp | 45 +++++++++++++++++++++++++++++------------
 2 files changed, 34 insertions(+), 15 deletions(-)

diff --git a/src/AutoConnectDefs.h b/src/AutoConnectDefs.h
index 7589b37..096d6e2 100644
--- a/src/AutoConnectDefs.h
+++ b/src/AutoConnectDefs.h
@@ -11,7 +11,7 @@
 #define _AUTOCONNECTDEFS_H_
 
 // Uncomment the following AC_DEBUG to enable debug output.
-//#define AC_DEBUG
+#define AC_DEBUG
 
 // Debug output destination can be defined externally with AC_DEBUG_PORT
 #ifndef AC_DEBUG_PORT
@@ -133,7 +133,7 @@
 
 // Reserved buffer size to build content
 #ifndef AUTOCONNECT_CONTENTBUFFER_SIZE
-#define AUTOCONNECT_CONTENTBUFFER_SIZE  (14 * 1024)
+#define AUTOCONNECT_CONTENTBUFFER_SIZE  (13 * 1024)
 #endif // !AUTOCONNECT_CONTENTBUFFER_SIZE
 
 // Number of unit lines in the page that lists available SSIDs
diff --git a/src/AutoConnectPage.cpp b/src/AutoConnectPage.cpp
index 940ca18..5e5861d 100644
--- a/src/AutoConnectPage.cpp
+++ b/src/AutoConnectPage.cpp
@@ -3,7 +3,7 @@
  *  @file   AutoConnectPage.h
  *  @author hieromon@gmail.com
  *  @version    1.1.0
- *  @date   2019-10-11
+ *  @date   2019-10-13
  *  @copyright  MIT license.
  */
 
@@ -1154,11 +1154,27 @@ String AutoConnect::_token_LIST_SSID(PageArgument& args) {
     _scanCount = WiFi.scanNetworks(false, true);
     AC_DBG("%d network(s) found\n", (int)_scanCount);
   }
+  // Preapre SSID list content building buffer
+  size_t  bufSize = 192 * (_scanCount > AUTOCONNECT_SSIDPAGEUNIT_LINES ? AUTOCONNECT_SSIDPAGEUNIT_LINES : _scanCount);
+  bufSize += 88 * (_scanCount > AUTOCONNECT_SSIDPAGEUNIT_LINES ? (_scanCount > (AUTOCONNECT_SSIDPAGEUNIT_LINES * 2) ? 2 : 1) : 0);
+  char* ssidList = (char*)malloc(bufSize);
+  if (!ssidList) {
+    AC_DBG("ssidList buffer(%d) allocation failed\n", (int)bufSize);
+    return _emptyString;
+  }
+  AC_DBG_DUMB("\n");
   // Locate to the page and build SSD list content.
-  String  ssidList = String("");
+  static const char _ssidList[] PROGMEM =
+    "<input type=\"button\" onClick=\"onFocus(this.getAttribute('value'))\" value=\"%s\">"
+    "<label class=\"slist\">%d&#037;&ensp;Ch.%d</label>%s<br>";
+  static const char _ssidEnc[] PROGMEM =
+    "<span class=\"img-lock\"></span>";
+  static const char _ssidPage[] PROGMEM =
+    "<button type=\"submit\" name=\"page\" value=\"%d\" formaction=\"/_ac/config\">%s</button>&emsp;";
   _hiddenSSIDCount = 0;
   uint8_t validCount = 0;
   uint8_t dispCount = 0;
+  char* slBuf = ssidList;
   for (uint8_t i = 0; i < _scanCount; i++) {
     String ssid = WiFi.SSID(i);
     if (ssid.length() > 0) {
@@ -1167,11 +1183,8 @@ String AutoConnect::_token_LIST_SSID(PageArgument& args) {
       // per page in the available SSID list.
       if (validCount >= page * AUTOCONNECT_SSIDPAGEUNIT_LINES && validCount <= (page + 1) * AUTOCONNECT_SSIDPAGEUNIT_LINES - 1) {
         if (++dispCount <= AUTOCONNECT_SSIDPAGEUNIT_LINES) {
-          ssidList += String(F("<input type=\"button\" onClick=\"onFocus(this.getAttribute('value'))\" value=\"")) + ssid + String("\">");
-          ssidList += String(F("<label class=\"slist\">")) + String(AutoConnect::_toWiFiQuality(WiFi.RSSI(i))) + String(F("&#037;&ensp;Ch.")) + String(WiFi.channel(i)) + String(F("</label>"));
-          if (WiFi.encryptionType(i) != ENC_TYPE_NONE)
-            ssidList += String(F("<span class=\"img-lock\"></span>"));
-          ssidList += String(F("<br>"));
+          snprintf_P(slBuf, bufSize - (slBuf - ssidList), (PGM_P)_ssidList, ssid.c_str(), AutoConnect::_toWiFiQuality(WiFi.RSSI(i)), WiFi.channel(i), WiFi.encryptionType(i) != ENC_TYPE_NONE ? (PGM_P)_ssidEnc : "");
+          slBuf += strlen(slBuf);
         }
       }
       // The validCount counts the found SSIDs that is not the Hidden
@@ -1182,12 +1195,18 @@ String AutoConnect::_token_LIST_SSID(PageArgument& args) {
       _hiddenSSIDCount++;
   }
   // Prepare perv. button
-  if (page >= 1)
-    ssidList += String(F("<button type=\"submit\" name=\"page\" value=\"")) + String(page - 1) + String(F("\" formaction=\"")) + String(F(AUTOCONNECT_URI_CONFIG)) + String(F("\">Prev.</button>&emsp;"));
+  if (page >= 1) {
+    snprintf_P(slBuf, bufSize - (slBuf - ssidList), (PGM_P)_ssidPage, page - 1, PSTR("Prev."));
+    slBuf = ssidList + strlen(ssidList);
+  }
   // Prepare next button
-  if (validCount > (page + 1) * AUTOCONNECT_SSIDPAGEUNIT_LINES)
-    ssidList += String(F("<button type=\"submit\" name=\"page\" value=\"")) + String(page + 1) + String(F("\" formaction=\"")) + String(F(AUTOCONNECT_URI_CONFIG)) + String(F("\">Next</button>&emsp;"));
-  return ssidList;
+  if (validCount > (page + 1) * AUTOCONNECT_SSIDPAGEUNIT_LINES) {
+    snprintf_P(slBuf, bufSize - (slBuf - ssidList), (PGM_P)_ssidPage, page + 1, PSTR("Next"));
+  }
+  // return ssidList;
+  String ssidListStr = String(ssidList);
+  free(ssidList);
+  return ssidListStr;
 }
 
 String AutoConnect::_token_SSID_COUNT(PageArgument& args) {
@@ -1233,7 +1252,7 @@ String AutoConnect::_token_CONFIG_STAIP(PageArgument& args) {
     else if (i == 4)
       ip = &_apConfig.dns2;
     String  ipStr = *ip ? ip->toString() : String(F("0.0.0.0"));
-    snprintf_P(liBuf, sizeof(liCont), (PGM_P)_configIPList, reps[i].lid, reps[i].lbl, reps[i].lid, reps[i].lid, ipStr.c_str());
+    snprintf_P(liBuf, sizeof(liCont) - (liBuf - liCont), (PGM_P)_configIPList, reps[i].lid, reps[i].lbl, reps[i].lid, reps[i].lid, ipStr.c_str());
     liBuf += strlen(liBuf);
   }
   return String(liCont);

From d2a076249e642b001e8c6a5b250e192036400054 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Tue, 15 Oct 2019 10:55:28 +0900
Subject: [PATCH 14/25] Fixed missing SoftAPIP

---
 src/AutoConnect.cpp | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/AutoConnect.cpp b/src/AutoConnect.cpp
index 9bacf60..57728fb 100644
--- a/src/AutoConnect.cpp
+++ b/src/AutoConnect.cpp
@@ -184,9 +184,7 @@ bool AutoConnect::begin(const char* ssid, const char* passphrase, unsigned long
 
       // Connection unsuccessful, launch the captive portal.
 #if defined(ARDUINO_ARCH_ESP8266)
-      if (!_apConfig.apip && !_apConfig.gateway && !_apConfig.netmask) {
-        _config();
-      }
+      _config();
 #endif
       WiFi.softAP(_apConfig.apid.c_str(), _apConfig.psk.c_str(), _apConfig.channel, _apConfig.hidden);
       do {
@@ -194,9 +192,7 @@ bool AutoConnect::begin(const char* ssid, const char* passphrase, unsigned long
         yield();
       } while (!WiFi.softAPIP());
 #if defined(ARDUINO_ARCH_ESP32)
-      if (!(static_cast<uint32_t>(_apConfig.apip) == 0U || static_cast<uint32_t>(_apConfig.gateway) == 0U || static_cast<uint32_t>(_apConfig.netmask) == 0U)) {
-        _config();
-      }
+      _config();
 #endif
       if (_apConfig.apip) {
         do {
@@ -300,6 +296,8 @@ bool AutoConnect::config(AutoConnectConfig& Config) {
  *  by Config method.
  */
 bool AutoConnect::_config(void) {
+  if (static_cast<uint32_t>(_apConfig.apip) == 0U || static_cast<uint32_t>(_apConfig.gateway) == 0U || static_cast<uint32_t>(_apConfig.netmask) == 0U)
+    AC_DBG("Warning: Contains invalid SoftAPIP address(es).\n");
   bool  rc = WiFi.softAPConfig(_apConfig.apip, _apConfig.gateway, _apConfig.netmask);
   AC_DBG("SoftAP configure %s, %s, %s %s\n", _apConfig.apip.toString().c_str(), _apConfig.gateway.toString().c_str(), _apConfig.netmask.toString().c_str(), rc ? "" : "failed");
   return rc;

From cb2a8f4972bda5cdf1db87412a40ec2ba652399a Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Tue, 15 Oct 2019 14:34:14 +0900
Subject: [PATCH 15/25] Change station_config_dhcp enum

---
 examples/Credential/Credential.ino       |  2 +-
 examples/CreditMigrate/CreditMigrate.ino | 13 ++++++++++++-
 src/AutoConnectCredential.h              |  4 ++--
 3 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/examples/Credential/Credential.ino b/examples/Credential/Credential.ino
index 4759c87..ed1e0bc 100644
--- a/examples/Credential/Credential.ino
+++ b/examples/Credential/Credential.ino
@@ -103,7 +103,7 @@ PageBuilder delPage("/del", { elmDel });
 // with the <li> tag.
 String viewCredential(PageArgument& args) {
   AutoConnectCredential  ac(CREDENTIAL_OFFSET);
-  struct station_config  entry;
+  station_config_t  entry;
   String content = "";
   uint8_t  count = ac.entries();          // Get number of entries.
 
diff --git a/examples/CreditMigrate/CreditMigrate.ino b/examples/CreditMigrate/CreditMigrate.ino
index 214c87f..118dc8f 100644
--- a/examples/CreditMigrate/CreditMigrate.ino
+++ b/examples/CreditMigrate/CreditMigrate.ino
@@ -75,7 +75,7 @@ void convert(const uint8_t* eeprom, const size_t size) {
         break;
 
       // Obtain each entry and store to Preferences
-      struct station_config config;
+      station_config_t  config;
       Serial.printf("[%d] ", ec);
       uint8_t ei = 0;
       do {
@@ -91,6 +91,17 @@ void convert(const uint8_t* eeprom, const size_t size) {
         config.bssid[ei] = *dp++;
         Serial.printf(":%02x", config.bssid[ei]);
       }
+      config.dhcp = *dp++;
+      if (config.dhcp == STA_STATIC) {
+        for (uint8_t e = 0; e < sizeof(station_config_t::_config::addr) / sizeof(uint32_t); e++) {
+          uint32_t* ip = &config.config.addr[e];
+          *ip = 0;
+          for (uint8_t b = 0; b < sizeof(uint32_t); b++) {
+            *ip <<= 8;
+            *ip += *dp++;
+          }
+        }
+      }
       bool rc = credential.save(&config);
       Serial.println(rc ? " transferred" : " failed to save Preferences");
     }
diff --git a/src/AutoConnectCredential.h b/src/AutoConnectCredential.h
index de75003..1a22fc9 100644
--- a/src/AutoConnectCredential.h
+++ b/src/AutoConnectCredential.h
@@ -53,7 +53,7 @@ extern "C" {
 #endif
 
 typedef enum {
-  STA_DHCP,
+  STA_DHCP = 0,
   STA_STATIC
 } station_config_dhcp;
 
@@ -61,7 +61,7 @@ typedef struct {
   uint8_t ssid[32];
   uint8_t password[64];
   uint8_t bssid[6];
-  uint8_t dhcp;   /**< 1:DHCP, 2:Static IP */
+  uint8_t dhcp;   /**< 0:DHCP, 1:Static IP */
   union _config {
     uint32_t  addr[5];
     struct _sta {

From 506bc832b0384d6aa0efa57b46e96c3947c9a622 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Tue, 15 Oct 2019 14:34:31 +0900
Subject: [PATCH 16/25] Added a description for static IP configuration

---
 mkdocs/changelog.md             |  3 ++
 mkdocs/credit.md                | 84 ++++++++++++++++++++-------------
 mkdocs/faq.md                   |  7 +++
 mkdocs/gettingstarted.md        |  3 ++
 mkdocs/images/process_begin.svg | 69 +++++++++++++++++++--------
 mkdocs/menu.md                  | 10 +++-
 6 files changed, 124 insertions(+), 52 deletions(-)

diff --git a/mkdocs/changelog.md b/mkdocs/changelog.md
index 8300cf5..25a35b4 100644
--- a/mkdocs/changelog.md
+++ b/mkdocs/changelog.md
@@ -1,3 +1,6 @@
+#### [1.1.0] Oct. 15, 2019
+- Supports static IPs with the [**Configure new AP**](menu.md#configure-new-ap) menu.
+
 #### [1.0.3] Sept. 30, 2019
 - Fixed a return of AutoConnectCredential::entries().
 
diff --git a/mkdocs/credit.md b/mkdocs/credit.md
index 53a4ed3..10d8b26 100644
--- a/mkdocs/credit.md
+++ b/mkdocs/credit.md
@@ -79,43 +79,43 @@ Returns number of entries as contained credentials.
 #### <i class="fa fa-caret-right"></i> load
 
 ```cpp
-int8_t load(const char* ssid, struct station_config* config)
+int8_t load(const char* ssid, station_config_t* config)
 ```
 
 Load a credential entry and store to **config**.
 <dl class="apidl">
     <dt>**Parameters**</dt>
     <dd><span class="apidef">ssid</span><span class="apidesc">SSID to be loaded.</span></dd>
-    <dd><span class="apidef">config</span><span class="apidesc">station_config</span></dd>
+    <dd><span class="apidef">config</span><span class="apidesc">station_config_t</span></dd>
     <dt>**Return value**</dt>
-    <dd>Save the specified SSID's credential entry to station_config pointed to by the parameter as **config**. -1 is returned if the SSID is not saved. </dd>
+    <dd>Save the specified SSID's credential entry to station_config_t pointed to by the parameter as **config**. -1 is returned if the SSID is not saved. </dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> load
 
 ```cpp
-bool load(int8_t entry, struct station_config* config)
+bool load(int8_t entry, station_config_t* config)
 ```
 
 Load a credential entry and store to **config**.
 <dl class="apidl">
     <dt>**Parameters**</dt>
     <dd><span class="apidef">entry</span><span class="apidesc">Specifies the index number based 0 to be loaded.</span></dd>
-    <dd><span class="apidef">config</span><span class="apidesc">station_config</span></dd>
+    <dd><span class="apidef">config</span><span class="apidesc">station_config_t</span></dd>
     <dt>**Return value**</dt>
-    <dd>Save the specified credential entry to station_config pointed to by the parameter as **config**. -1 is returned if specified number is not saved. </dd>
+    <dd>Save the specified credential entry to station_config_t pointed to by the parameter as **config**. -1 is returned if specified number is not saved. </dd>
 </dl>
 
 #### <i class="fa fa-caret-right"></i> save
 
 ```cpp
-bool save(const struct station_config* config)
+bool save(const station_config_t* config)
 ```
 
 Save a credential entry.
 <dl class="apidl">
     <dt>**Parameter**</dt>
-    <dd><span class="apidef">config</span><span class="apidesc">station_config to be saved.</span></dd>
+    <dd><span class="apidef">config</span><span class="apidesc">station_config_t to be saved.</span></dd>
     <dt>**Return value**</dt>
     <dd><span class="apidef">true</span><span class="apidesc">Successfully saved.</span></dd>
     <dd><span class="apidef">false</span><span class="apidesc">Failed to save.</span></dd>
@@ -142,7 +142,7 @@ Delete a credential the specified SSID.
     ```cpp
     void deleteAllCredentials(void) {
       AutoConnectCredential credential;
-      struct station_config config;
+      station_config_t config;
       uint8_t ent = credential.entries();
 
       while (ent--) {
@@ -154,24 +154,31 @@ Delete a credential the specified SSID.
 
 ## The data structures
 
-### <i class="fa fa-code"></i>  station_config
+### <i class="fa fa-code"></i>  station_config_t
 
-A structure is included in the ESP8266 SDK. You can use it in the sketch like as follows:
+The saved credential structure is defined as stato_config_t in the AcutoConnectCredential header file.
 
 ```cpp
-extern "C" {
-#include <user_interface.h>
-}
+typedef struct {
+  uint8_t ssid[32];
+  uint8_t password[64];
+  uint8_t bssid[6];
+  uint8_t dhcp;   /**< 0:DHCP, 1:Static IP */
+  union _config {
+    uint32_t  addr[5];
+    struct _sta {
+      uint32_t ip;
+      uint32_t gateway;
+      uint32_t netmask;
+      uint32_t dns1;
+      uint32_t dns2;
+    } sta;
+  } config;
+} station_config_t;
 ```
 
-```cpp
-struct station_config {
-  uint8 ssid[32];
-  uint8 password[64];
-  uint8 bssid_set;
-  uint8 bssid[6];
-};
-```
+!!! note "The byte size of station_config_t in program memory and stored credentials is different"
+    There is a gap byte for boundary alignment between the `dhcp` member and the static IP members of the above station_config_t. Its gap byte will be removed with saved credentials on the flash.
 
 ### <i class="fa fa-code"></i>  The credential entry
 
@@ -180,13 +187,26 @@ A data structure of the credential saving area in EEPROM as the below. [^4]
 [^4]:
 There may be 0xff as an invalid data in the credential saving area. The 0xff area would be reused.
 
-| Byte offset | Length   | Value                                                               |
-|-------------|----------|---------------------------------------------------------------------|
-| 0           | 8        | AC_CREDT                                                            |
-| 8           | 1        | Number of contained entries (uint8_t)                               |
-| 9           | 2        | Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). |
-| 11          | variable | SSID terminated by 0x00. Max length is 32 bytes.                    |
-| variable    | variable | Password plain text terminated by 0x00. Max length is 64 bytes.     |
-| variable    | 6        | BSSID                                                               |
-| variable    |          | Contained the next entries. (Continuation SSID+Password+BSSID)      |
-| variable    | 1        | 0x00. End of container.                                             |
+| byte offset  | Length | Value |
+|------------- |--------|-------|
+| 0            | 8        | AC_CREDT |
+| 8            | 1        | Number of contained entries (uint8_t) |
+| 9            | 2        | Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). |
+| 11           | variable | SSID terminated by 0x00. Max length is 32 bytes. |
+| variable     | variable | Password plain text terminated by 0x00. Max length is 64 bytes. |
+| variable     | 6        | BSSID |
+| variable     | 1        | Flag for DHCP or Static IP (0:DHCP, 1:Static IP) |
+| <td colspan=3>The following IP address entries are stored only for static IPs.
+| variable(1)  | 4        | Station IP address (uint32_t) |
+| variable(5)  | 4        | Gateway address (uint32_t) |
+| variable(9)  | 4        | Netmask (uint32_t) |
+| variable(13) | 4        | Primary DNS address (uint32_t) |
+| variable(17) | 4        | Secondary IP address (uint32_t) |
+| variable     | variable | Contained the next entries. (Continuation SSID+Password+BSSID+DHCP flag+Static IPs(if exists)) |
+| variable     | 1        | 0x00. End of container. |
+
+!!! note "AutoConnectCredential has changed"
+    It was lost AutoConnectCredential backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not work properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading.
+    ```
+    esptool -c esp8266 (or esp32) - p [COM_PORT] erase_flash
+    ```
diff --git a/mkdocs/faq.md b/mkdocs/faq.md
index 32dab11..96cd9ac 100644
--- a/mkdocs/faq.md
+++ b/mkdocs/faq.md
@@ -180,6 +180,13 @@ Because AutoConnect does not send a login success response to the captive portal
 
 If the sketch is correct, a JSON syntax error may have occurred. In this case, activate the [AC_DEBUG](faq.md#3-turn-on-the-debug-log-options) and rerun. If you take the message of JSON syntax error, the [Json Assistant](https://arduinojson.org/v5/assistant/) helps syntax checking. This online tool is provided by the author of ArduinoJson and is most consistent for the AutoConnect. 
 
+## <i class="fa fa-question-circle"></i> Saved credentials are wrong or lost.
+
+A structure of AutoConnect saved credentials have changed in two times throughout enhancement with v1.0.3 and v1.1.0. Especially in v1.1.0 enhancements, there is no backward compatibility of AutoConnectCredential structures to the earlier versions. To save the credentials correctly in v110, you must erase the flash of the ESP module using the esptool completely.
+```
+esptool -c esp8266 (or esp32) -p [COM_PORT] erase_flash
+```
+
 ## <i class="fa fa-question-circle"></i> Submit element in a custom Web page does not react.
 
 Is there the AutoConnectElements element named **SUBMIT** in the custom Web page? (case sensitive ignored) AutoConnect does not rely on the `input type=submit` element for the form submission and uses [HTML form element submit](https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/submit) function instead. So, the submit function will fail if there is an element named 'submit' in the form. You can not use **SUBMIT** as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element.
diff --git a/mkdocs/gettingstarted.md b/mkdocs/gettingstarted.md
index 038085b..ff6a13a 100644
--- a/mkdocs/gettingstarted.md
+++ b/mkdocs/gettingstarted.md
@@ -50,6 +50,9 @@ Here, tap *"Configure new AP"* to connect the new access point then the SSID con
 
 <img src="images/menu_login.png" style="border:1px solid lightgrey;width:280px;" /><img src="images/arrow_right.svg" style="vertical-align:top;padding-top:120px;width:48px;margin-left:30px;margin-right:30px;" /><img src="images/config_ssid.png" style="border:1px solid lightgrey;width:280px;" />
 
+!!! info "Can be configured with static IP"
+    Since v1.1.0, [**Configure new AP**](menu.md#configure-new-ap) menu can configure for WIFI_STA with static IP.
+
 ### <i class="fa fa-rss"></i> Connection establishment
 
 After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI\_AP\_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step.
diff --git a/mkdocs/images/process_begin.svg b/mkdocs/images/process_begin.svg
index ab1e19a..b9224a9 100644
--- a/mkdocs/images/process_begin.svg
+++ b/mkdocs/images/process_begin.svg
@@ -9,9 +9,9 @@
    xmlns="http://www.w3.org/2000/svg"
    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   width="99.499031mm"
+   width="109mm"
    height="371.83472mm"
-   viewBox="0 0 99.499031 371.83471"
+   viewBox="0 0 108.99999 371.83472"
    version="1.1"
    id="svg8776"
    inkscape:version="0.92.2 (5c3e80d, 2017-08-06)"
@@ -248,8 +248,8 @@
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
      inkscape:zoom="1.4142136"
-     inkscape:cx="182.89588"
-     inkscape:cy="1285.7123"
+     inkscape:cx="259.43725"
+     inkscape:cy="1200.0696"
      inkscape:document-units="mm"
      inkscape:current-layer="layer1"
      showgrid="false"
@@ -264,11 +264,11 @@
      inkscape:bbox-nodes="true"
      inkscape:snap-bbox-edge-midpoints="true"
      inkscape:snap-bbox-midpoints="true"
-     inkscape:window-width="1920"
-     inkscape:window-height="1029"
-     inkscape:window-x="1272"
-     inkscape:window-y="-8"
-     inkscape:window-maximized="1"
+     inkscape:window-width="1571"
+     inkscape:window-height="1013"
+     inkscape:window-x="1376"
+     inkscape:window-y="0"
+     inkscape:window-maximized="0"
      fit-margin-top="0"
      fit-margin-left="0"
      fit-margin-right="0"
@@ -277,7 +277,7 @@
        type="xygrid"
        id="grid9104"
        originx="-23.664512"
-       originy="15.544299" />
+       originy="15.544259" />
   </sodipodi:namedview>
   <metadata
      id="metadata8773">
@@ -295,7 +295,7 @@
      inkscape:label="レイヤー 1"
      inkscape:groupmode="layer"
      id="layer1"
-     transform="translate(-23.664512,59.290408)">
+     transform="translate(-23.664512,59.290411)">
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
        d="m 58.208337,-11.256129 v 3.8405916"
@@ -1265,27 +1265,26 @@
            sodipodi:role="line">WiFi.config (STA)</tspan></text>
     </g>
     <g
-       id="g1187"
-       transform="translate(-46.605488,-48.241008)">
+       id="g1141">
       <rect
          ry="0.26458257"
          rx="0.26458332"
-         y="13.168248"
-         x="87.615906"
+         y="-35.072762"
+         x="41.010418"
          height="7.9375019"
          width="34.395828"
          id="rect9134-4-7-4-7-57"
          style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.26458329;stroke-linecap:butt;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill" />
       <text
          id="text9138-7-3-9-9-90"
-         y="18.015242"
-         x="89.345772"
+         y="-30.225767"
+         x="42.740284"
          style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
          xml:space="preserve"><tspan
            id="tspan1182"
            sodipodi:role="line"
-           x="89.345772"
-           y="18.015242">Load current config</tspan></text>
+           x="42.740284"
+           y="-30.225767">Load current config</tspan></text>
     </g>
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
@@ -1393,5 +1392,37 @@
          x="60.096973"
          y="-8.7963543"
          style="stroke-width:0.26458332">YES</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:'Times New Roman';-inkscape-font-specification:'Times New Roman, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="79.585876"
+       y="-32.471371"
+       id="text9138-7-3-9-9-90-9"><tspan
+         sodipodi:role="line"
+         id="tspan1283"
+         x="79.585876"
+         y="-32.471371">Loads saved credentials from the flash</tspan><tspan
+         sodipodi:role="line"
+         id="tspan1285"
+         x="79.585876"
+         y="-28.502621">that matches the last SSID stored in</tspan><tspan
+         sodipodi:role="line"
+         id="tspan1287"
+         x="79.585876"
+         y="-24.533871">the ESP module. </tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:serif;-inkscape-font-specification:'serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="79.543159"
+       y="-14.876924"
+       id="text9138-7-3-9-9-90-9-7"><tspan
+         sodipodi:role="line"
+         id="tspan1289"
+         x="79.543159"
+         y="-14.876924">If that credential has a static IP,</tspan><tspan
+         sodipodi:role="line"
+         id="tspan1291"
+         x="79.543159"
+         y="-10.908174">restore it.</tspan></text>
   </g>
 </svg>
diff --git a/mkdocs/menu.md b/mkdocs/menu.md
index f1a10fa..151e8de 100644
--- a/mkdocs/menu.md
+++ b/mkdocs/menu.md
@@ -29,7 +29,9 @@ Enter SSID and Passphrase and tap "**Apply**" to starts WiFi connection.
 
 <img src="images/newap.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" />
 
-If you want to configure with static IP, uncheck "**Enable DHCP**". Once the WiFi connection is established, the entered static IP configuration is saved in the credentials and restored to the station configuration via the [Open SSIDs](#open-ssids) menu.
+If you want to configure with static IP, uncheck "**Enable DHCP**". Once the WiFi connection is established, the entered static IP[^1] configuration is saved in the credentials and restored to the station configuration via the [Open SSIDs](#open-ssids) menu.
+
+[^1]: AutoConnect will not check the syntax and validity of the entered IP address. If the entered static IPs are incorrect, it cannot connect to the access point.
 
 <img src="images/newap_static.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" />
 
@@ -39,6 +41,12 @@ Once it was established WiFi connection, its SSID and password will be saved in
 
 <img src="images/open.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" />
 
+!!! note "Saved credentials data structure has changed"
+    A structure of AutoConnect saved credentials have changed in v1.1.0 and was lost backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not display properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading.
+    ```
+    esptool -c esp8266 (or esp32) - p [COM_PORT] erase_flash
+    ```
+
 ## <i class="fa fa-bars"></i> Disconnect
 
 Disconnect ESP8266/ESP32 from the current connection. It can also reset the ESP8266/ESP32 automatically after disconnection by instructing with using [API](api.md#autoreset) in the sketch.

From a8675ba7cb8e6ed6b916c6937e1b008f4547c7ab Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Tue, 15 Oct 2019 14:35:00 +0900
Subject: [PATCH 17/25] Release for v1.1.0

---
 README.md          | 3 +++
 library.json       | 2 +-
 library.properties | 2 +-
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index e3f74cf..134e448 100644
--- a/README.md
+++ b/README.md
@@ -101,6 +101,9 @@ Full documentation is available on https://Hieromon.github.io/AutoConnect, some
 
 ## Change log
 
+### [1.1.0] Oct. 15, 2019
+- Supprts static IPs with the 'Configure new AP' menu. (issue #132)
+
 ### [1.0.3] Sept. 30, 2019
 - Fixed a return of AutoConnectCredential::entries(). (issue #133)
 
diff --git a/library.json b/library.json
index 80fe1d7..b275d39 100644
--- a/library.json
+++ b/library.json
@@ -25,6 +25,6 @@
     "espressif8266",
     "espressif32"
   ],
-  "version": "1.0.3",
+  "version": "1.1.0",
   "license": "MIT"
 }
diff --git a/library.properties b/library.properties
index 112f207..1f9f3f3 100644
--- a/library.properties
+++ b/library.properties
@@ -1,5 +1,5 @@
 name=AutoConnect
-version=1.0.3
+version=1.1.0
 author=Hieromon Ikasamo <hieromon@gmail.com>
 maintainer=Hieromon Ikasamo <hieromon@gmail.com>
 sentence=ESP8266/ESP32 WLAN configuration at runtime with web interface.

From 2fd24fecd3884df841dcf0cb04760f1a82a6f16d Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <Hieromon@users.noreply.github.com>
Date: Wed, 16 Oct 2019 01:36:25 +0900
Subject: [PATCH 18/25] Reduced consume memory for the OpenSSIDs page

---
 src/AutoConnectPage.cpp | 77 +++++++++++++++++++++++------------------
 1 file changed, 44 insertions(+), 33 deletions(-)

diff --git a/src/AutoConnectPage.cpp b/src/AutoConnectPage.cpp
index 5e5861d..1d70999 100644
--- a/src/AutoConnectPage.cpp
+++ b/src/AutoConnectPage.cpp
@@ -3,7 +3,7 @@
  *  @file   AutoConnectPage.h
  *  @author hieromon@gmail.com
  *  @version    1.1.0
- *  @date   2019-10-13
+ *  @date   2019-10-15
  *  @copyright  MIT license.
  */
 
@@ -289,7 +289,7 @@ const char AutoConnect::_CSS_SPINNER[] PROGMEM = {
     "position:relative;"
     "margin:100px auto"
   "}"
-  ".double-bounce1, .double-bounce2{"
+  ".dbl-bounce1, .dbl-bounce2{"
     "width:100%;"
     "height:100%;"
     "border-radius:50%;"
@@ -301,7 +301,7 @@ const char AutoConnect::_CSS_SPINNER[] PROGMEM = {
     "-webkit-animation:sk-bounce 2.0s infinite ease-in-out;"
     "animation:sk-bounce 2.0s infinite ease-in-out"
   "}"
-  ".double-bounce2{"
+  ".dbl-bounce2{"
     "-webkit-animation-delay:-1.0s;"
     "animation-delay:-1.0s"
   "}"
@@ -487,10 +487,10 @@ const char AutoConnect::_CSS_LUXBAR[] PROGMEM = {
       "white-space:nowrap;"
     "}"
   "}"
-  ".lb-cb:checked+.lb-menu .lb-burger-doublespin span::before{"
+  ".lb-cb:checked+.lb-menu .lb-burger-dblspin span::before{"
     "transform:rotate(225deg)"
   "}"
-  ".lb-cb:checked+.lb-menu .lb-burger-doublespin span::after{"
+  ".lb-cb:checked+.lb-menu .lb-burger-dblspin span::after{"
     "transform:rotate(-225deg)"
   "}"
   ".lb-menu-material,"
@@ -525,7 +525,7 @@ const char  AutoConnect::_ELM_MENU_PRE[] PROGMEM = {
       "<ul class=\"lb-navigation\">"
         "<li class=\"lb-header\">"
           "<a href=\"" AUTOCONNECT_URI "\" class=\"lb-brand\">MENU_TITLE</a>"
-          "<label class=\"lb-burger lb-burger-doublespin\" id=\"lb-burger\" for=\"lb-cb\"><span></span></label>"
+          "<label class=\"lb-burger lb-burger-dblspin\" id=\"lb-burger\" for=\"lb-cb\"><span></span></label>"
         "</li>"
         "<li class=\"lb-item\"><a href=\"" AUTOCONNECT_URI_CONFIG "\">" AUTOCONNECT_MENULABEL_CONFIGNEW "</a></li>"
         "<li class=\"lb-item\"><a href=\"" AUTOCONNECT_URI_OPEN "\">" AUTOCONNECT_MENULABEL_OPENSSIDS "</a></li>"
@@ -751,8 +751,8 @@ const char  AutoConnect::_PAGE_CONNECTING[] PROGMEM = {
       "{{MENU_PRE}}"
       "{{MENU_POST}}"
       "<div class=\"spinner\">"
-        "<div class=\"double-bounce1\"></div>"
-        "<div class=\"double-bounce2\"></div>"
+        "<div class=\"dbl-bounce1\"></div>"
+        "<div class=\"dbl-bounce2\"></div>"
         "<div style=\"position:absolute;left:-100%;right:-100%;text-align:center;margin:10px auto;font-weight:bold;color:#0b0b33;\">{{CUR_SSID}}</div>"
       "</div>"
     "</div>"
@@ -1006,15 +1006,17 @@ String AutoConnect::_token_WIFI_STATUS(PageArgument& args) {
 
 String AutoConnect::_token_STATION_STATUS(PageArgument& args) {
   AC_UNUSED(args);
-  const char* wlStatusSymbol ="";
-  static const char* wlStatusSymbols[] = {
+  PGM_P wlStatusSymbol = PSTR("");
+  // const char* wlStatusSymbol ="";
+  PGM_P wlStatusSymbols[] = {
+  // static const char* wlStatusSymbols[] = {
 #if defined(ARDUINO_ARCH_ESP8266)
-    "IDLE",
-    "CONNECTING",
-    "WRONG_PASSWORD",
-    "NO_AP_FOUND",
-    "CONNECT_FAIL",
-    "GOT_IP"
+    PSTR("IDLE"),
+    PSTR("CONNECTING"),
+    PSTR("WRONG_PASSWORD"),
+    PSTR("NO_AP_FOUND"),
+    PSTR("CONNECT_FAIL"),
+    PSTR("GOT_IP")
   };
   switch (wifi_station_get_connect_status()) {
   case STATION_IDLE:
@@ -1036,14 +1038,14 @@ String AutoConnect::_token_STATION_STATUS(PageArgument& args) {
     wlStatusSymbol = wlStatusSymbols[5];
     break;
 #elif defined(ARDUINO_ARCH_ESP32)
-    "IDLE",
-    "NO_SSID_AVAIL",
-    "SCAN_COMPLETED",
-    "CONNECTED",
-    "CONNECT_FAILED",
-    "CONNECTION_LOST",
-    "DISCONNECTED",
-    "NO_SHIELD"
+    PSTR("IDLE"),
+    PSTR("NO_SSID_AVAIL"),
+    PSTR("SCAN_COMPLETED"),
+    PSTR("CONNECTED"),
+    PSTR("CONNECT_FAILED"),
+    PSTR("CONNECTION_LOST"),
+    PSTR("DISCONNECTED"),
+    PSTR("NO_SHIELD")
   };
   switch (_rsConnect) {
   case WL_IDLE_STATUS:
@@ -1072,7 +1074,7 @@ String AutoConnect::_token_STATION_STATUS(PageArgument& args) {
     break;
 #endif
   }
-  return String("(") + String(_rsConnect) + String(") ") + String(wlStatusSymbol);
+  return String("(") + String(_rsConnect) + String(") ") + String(FPSTR(wlStatusSymbol));
 }
 
 String AutoConnect::_token_LOCAL_IP(PageArgument& args) {
@@ -1260,10 +1262,16 @@ String AutoConnect::_token_CONFIG_STAIP(PageArgument& args) {
 
 String AutoConnect::_token_OPEN_SSID(PageArgument& args) {
   AC_UNUSED(args);
-  AutoConnectCredential credit(_apConfig.boundaryOffset);
-  station_config_t  entry;
+  static const char _ssidList[] PROGMEM = "<input id=\"sb\" type=\"submit\" name=\"%s\" value=\"%s\"><label class=\"slist\">%s</label>%s<br>";
+  static const char _ssidRssi[] PROGMEM = "%d&#037;&ensp;Ch.%d";
+  static const char _ssidNA[]   PROGMEM = "N/A";
+  static const char _ssidLock[] PROGMEM = "<span class=\"img-lock\"></span>";
+  static const char _ssidNull[] PROGMEM = "";
   String ssidList;
-  String rssiSym;
+  station_config_t  entry;
+  char  slCont[176];
+  char  rssiCont[32];
+  AutoConnectCredential credit(_apConfig.boundaryOffset);
 
   uint8_t creEntries = credit.entries();
   if (creEntries > 0) {
@@ -1274,20 +1282,23 @@ String AutoConnect::_token_OPEN_SSID(PageArgument& args) {
     ssidList = String(F("<p><b>No saved credentials.</b></p>"));
 
   for (uint8_t i = 0; i < creEntries; i++) {
+    rssiCont[0] = '\0';
+    PGM_P rssiSym = _ssidNA;
+    PGM_P ssidLock = _ssidNull;
     credit.load(i, &entry);
     AC_DBG("A credential #%d loaded\n", (int)i);
-    ssidList += String(F("<input id=\"sb\" type=\"submit\" name=\"" AUTOCONNECT_PARAMID_CRED "\" value=\"")) + String(reinterpret_cast<char*>(entry.ssid)) + String(F("\"><label class=\"slist\">"));
-    rssiSym = String(F("N/A</label>"));
     for (int8_t sc = 0; sc < (int8_t)_scanCount; sc++) {
       if (!memcmp(entry.bssid, WiFi.BSSID(sc), sizeof(station_config_t::bssid))) {
         _connectCh = WiFi.channel(sc);
-        rssiSym = String(AutoConnect::_toWiFiQuality(WiFi.RSSI(sc))) + String(F("&#037;&ensp;Ch.")) + String(_connectCh) + String(F("</label>"));
+        snprintf_P(rssiCont, sizeof(rssiCont), (PGM_P)_ssidRssi, AutoConnect::_toWiFiQuality(WiFi.RSSI(sc)), _connectCh);
+        rssiSym = rssiCont;
         if (WiFi.encryptionType(sc) != ENC_TYPE_NONE)
-          rssiSym += String(F("<span class=\"img-lock\"></span>"));
+          ssidLock = _ssidLock;
         break;
       }
     }
-    ssidList += rssiSym + String(F("<br>"));
+    snprintf_P(slCont, sizeof(slCont), (PGM_P)_ssidList, AUTOCONNECT_PARAMID_CRED, reinterpret_cast<char*>(entry.ssid), rssiSym, ssidLock);
+    ssidList += String(slCont);
   }
   return ssidList;
 }

From 7d12936db87686aafae6e760f9489b087302045c Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Wed, 16 Oct 2019 14:44:58 +0900
Subject: [PATCH 19/25] Fixes typo

---
 mkdocs/advancedusage.md |  2 +-
 mkdocs/faq.md           | 18 +++++++++++++++++-
 mkdocs/menu.md          | 36 ++++++++++++++++++------------------
 3 files changed, 36 insertions(+), 20 deletions(-)

diff --git a/mkdocs/advancedusage.md b/mkdocs/advancedusage.md
index 0d37202..35906c6 100644
--- a/mkdocs/advancedusage.md
+++ b/mkdocs/advancedusage.md
@@ -190,7 +190,7 @@ void loop() {
 
 If your sketch handles web pages, you can embed the pages into the AutoConnect menu in continuance enjoying the utility of the WiFi connection feature. Unlike the custom Web pages by [AutoConnectElements](acelements.md), this allows to legacy web pages registered by *ESP8266WebServer::on* or *WebServer::on* function.
 
-You can use AutoConnectAux only constructed with the URI of the page to be embedding. AutoConnectElements is not required. The basic procedure for this as follows:
+To implement embedding your legacy web pages to the AutoConnect menu, you can use AutoConnectAux only constructed with the URI of the page to be embedding. AutoConnectElements is not required. The basic procedure for this as follows:
 
 1. Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu.
 2. Sketch the legacy page handlers.
diff --git a/mkdocs/faq.md b/mkdocs/faq.md
index 96cd9ac..3eec6a6 100644
--- a/mkdocs/faq.md
+++ b/mkdocs/faq.md
@@ -182,11 +182,27 @@ If the sketch is correct, a JSON syntax error may have occurred. In this case, a
 
 ## <i class="fa fa-question-circle"></i> Saved credentials are wrong or lost.
 
-A structure of AutoConnect saved credentials have changed in two times throughout enhancement with v1.0.3 and v1.1.0. Especially in v1.1.0 enhancements, there is no backward compatibility of AutoConnectCredential structures to the earlier versions. To save the credentials correctly in v110, you must erase the flash of the ESP module using the esptool completely.
+A structure of AutoConnect saved credentials has changed two times throughout enhancement with v1.0.3 and v1.1.0. In particular, due to enhancements in v1.1.0, AutoConnectCredential data structure has lost the backward compatibility with previous versions. You must erase the flash of the ESP module using the esptool completely to save the credentials correctly with v1.1.0.
 ```
 esptool -c esp8266 (or esp32) -p [COM_PORT] erase_flash
 ```
 
+## <i class="fa fa-question-circle"></i> Some AutoConnect page is cut off.
+
+It may be two possibilities as follows:
+
+1. Packet loss during transmission due to a too weak WiFi signal.
+2. Heap is insufficient memory. AutoConnect entrusts HTML generation to PageBuilder that makes heavy use the String::concatenate function and causes memory fragmentation. This is a structural problem with PageBuilder, but it is difficult to solve immediately.
+
+If this issue produces with your sketch, Reloading the page may recover.  
+Also, you can check the memory running out status by rebuilding the sketch with [PageBuilder's debug log option](faq.html#fn:2) turned on.
+
+If the heap memory is insufficient, the following message is displayed on the serial console.
+
+```
+[PB] Failed building, free heap:<Size of free heap>
+```
+
 ## <i class="fa fa-question-circle"></i> Submit element in a custom Web page does not react.
 
 Is there the AutoConnectElements element named **SUBMIT** in the custom Web page? (case sensitive ignored) AutoConnect does not rely on the `input type=submit` element for the form submission and uses [HTML form element submit](https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/submit) function instead. So, the submit function will fail if there is an element named 'submit' in the form. You can not use **SUBMIT** as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element.
diff --git a/mkdocs/menu.md b/mkdocs/menu.md
index 151e8de..3836a69 100644
--- a/mkdocs/menu.md
+++ b/mkdocs/menu.md
@@ -3,12 +3,12 @@
 
 ## <i class="fa fa-external-link"></i> Where the from
 
-The AutoConnect menu appears when you access the **AutoConnect root path**. It is assigned "**/_ac**" located on the *local IP address* of ESP8266/ESP32 module by default. This location can be changed in the sketch. The following screen will appear at access to `http://{localIP}/_ac` as the root path. This is the statistics of the current WiFi connection. You can access the menu from the here, to invoke it tap <i class="fa fa-bars"></i> at right on top. (e.g. `http://172.217.28.1/_ac` for SoftAP mode.)
+The following screen will appear as the AutoConnect menu when you access to **AutoConnect root URL** via `http://{localIP}/_ac`. (eg. `http://172.217.28.1/_ac`) It is a top page of AutoConnect which shows the current WiFi connection statistics. To invoke the AutoConnect menu, you can t tap <i class="fa fa-bars"></i> at right on top.
 
 <img src="images/ac.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" />
 
-!!! note "What's the local IP?"
-    A local IP means Local IP at connection established or SoftAP's IP.
+!!! note "AutoConnect root URL"
+    It is assigned "**/_ac**" located on the *local IP address* of ESP8266/ESP32 module by default and can be changed with the sketch. A local IP means Local IP at connection established or SoftAP's IP.
 
 ## <i class="fa fa-bars"></i> Right on top
 
@@ -24,38 +24,38 @@ Currently, AutoConnect supports four menus. Undermost menu as "HOME" returns to
 
 ## <i class="fa fa-bars"></i> Configure new AP
 
-Scan all available access point in the vicinity and display it. Strength and security of the detected AP are marked. The <i class="fa fa-lock"></i> is indicated for the SSID that needs a security key. "**Hidden:**" means the number of hidden SSIDs discovered.  
-Enter SSID and Passphrase and tap "**Apply**" to starts WiFi connection. 
+It scans all available access points in the vicinity and display it further the WiFi signal strength and security indicator as <i class="fa fa-lock"></i> of the detected AP. Below that, the number of discovered hidden APs will be displayed. 
+Enter SSID and Passphrase and tap "**Apply**" to start a WiFi connection. 
 
 <img src="images/newap.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" />
 
-If you want to configure with static IP, uncheck "**Enable DHCP**". Once the WiFi connection is established, the entered static IP[^1] configuration is saved in the credentials and restored to the station configuration via the [Open SSIDs](#open-ssids) menu.
+If you want to configure with static IP, uncheck "**Enable DHCP**". Once the WiFi connection is established, the entered static IP[^1] configuration will be stored to the credentials in the flash and restored to the station configuration via the [Open SSIDs](#open-ssids) menu.
 
-[^1]: AutoConnect will not check the syntax and validity of the entered IP address. If the entered static IPs are incorrect, it cannot connect to the access point.
+[^1]: AutoConnect does not check the syntax and validity of the entered IP address. If the entered static IPs are incorrect, it cannot connect to the access point.
 
 <img src="images/newap_static.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" />
 
 ## <i class="fa fa-bars"></i> Open SSIDs
 
-Once it was established WiFi connection, its SSID and password will be saved in the flash of ESP8266/ESP32 automatically. The **Open SSIDs** menu reads the saved SSID credentials from the flash. The stored credential data are listed by the SSID as shown below. Its label is a clickable button. Tap the SSID button, starts WiFi connection it.
+After WiFi connected, AutoConnect will automatically save the established SSID and password to the flash on the ESP module. **Open SSIDs** menu reads the saved SSID credentials and lists them as below. Listed items are clickable buttons and can initiate a connection to its access point.
 
 <img src="images/open.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" />
 
 !!! note "Saved credentials data structure has changed"
-    A structure of AutoConnect saved credentials have changed in v1.1.0 and was lost backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not display properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading.
+    A structure of AutoConnect saved credentials has changed in v1.1.0 and was lost backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not display properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading.
     ```
     esptool -c esp8266 (or esp32) - p [COM_PORT] erase_flash
     ```
 
 ## <i class="fa fa-bars"></i> Disconnect
 
-Disconnect ESP8266/ESP32 from the current connection. It can also reset the ESP8266/ESP32 automatically after disconnection by instructing with using [API](api.md#autoreset) in the sketch.
+It disconnects ESP8266/ESP32 from the current connection. Also, ESP8266/ESP32 can be automatically reset after WiFi cutting by instructing with the sketch using the [AutoConnect API](api.md#autoreset).
 
-After tapping "Disconnect", you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting the WLAN. 
+After tapping the **Disconnect**, you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting to the WLAN. 
 
 ## <i class="fa fa-bars"></i> Reset...
 
-Reset the ESP8266/ESP32 module, it will start rebooting. After rebooting complete, the ESP8266/ESP32 module begins establishing the previous connection with WIFI_STA mode, and *esp8266ap* or *esp32ap* of an access point will disappear from WLAN.
+Resetting the ESP8266/ESP32 module will initiate a reboot. When the module restarting, the *esp8266ap* or *esp32ap* access point will disappear from the WLAN and the ESP8266/ESP32 module will begin to reconnect a previous access point with WIFI_STA mode.
 
 <img src="images/resetting.png" style="width:280px;" />
 
@@ -64,23 +64,23 @@ Reset the ESP8266/ESP32 module, it will start rebooting. After rebooting complet
 
 ## <i class="fa fa-bars"></i> Custom menu items
 
-The menu items of the custom Web page line up at the below in the AutoConnect menu if the custom Web pages are joined. Details for [Custom Web pages in AutoConnect menu](acintro.md#custom-web-pages-in-autoconnectmenu).
+If the sketch has custom Web pages, the AutoConnect menu lines them up with the AutoConnect's items. Details for [Custom Web pages in AutoConnect menu](acintro.md#custom-web-pages-in-autoconnectmenu).
 
 ## <i class="fa fa-bars"></i> HOME
 
-A **HOME** item located at the bottom of the menu list is a link to the home path. The URI as the home path is `/` by default, and it is defined by `AUTOCONNECT_HOMEURI` with **AutoConnectDefs.h** file.
+A **HOME** item at the bottom of the menu list is a link to the home path, and the default URI is `/` which is defined by `AUTOCONNECT_HOMEURI` in **AutoConnectDefs.h** header file.
 
 ```cpp
 #define AUTOCONNECT_HOMEURI     "/"
 ```
 
-You can change the HOME path using the AutoConnect API. The [**AutoConnect::home**](api.md#home) function sets the URI as a link of the HOME item of the AutoConnect menu.
+Also, you can change the HOME path using the AutoConnect API. The [**AutoConnect::home**](api.md#home) function sets the URI as a link of the HOME item in the AutoConnect menu.
 
-## <i class="fa fa-bars"></i> by attaching AutoConnect menu
+## <i class="fa fa-bars"></i> Attaching to AutoConnect menu
 
-The AutoConnect menu can contain HTML pages of your owns sketch as custom items. It works for HTML pages implemented by **ESP8266WebServer::on** handler or **WebServer::on** handler for ESP32. That is, you can make it as menu items to invoke the legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as [FSBrowser](https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer/examples/FSBrowser) to the AutoConnect menu item. It adds Edit and List items with little modification to the legacy sketch code.
+The AutoConnect menu can contain your sketch's web pages as extra items as a custom. It works for HTML pages implemented by the **ESP8266WebServer::on** handler or the **WebServer::on** handler for ESP32. That is, you can make them invoke the legacy web pages from the AutoConnect menu. The below screen-shot is the result of adding an example sketch for the ESP8266WebServer library known as [FSBrowser](https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer/examples/FSBrowser) to the AutoConnect menu item. It can add Edit and List items with little modification to the legacy sketch code.
 
 <div style="float:left;width:auto;height:420px;"><img style="width:auto;height:420px;" src="images/fsbmenu.png"></div>
 <img style="margin-left:70px;width:auto;height:420px;" src="images/fsbmenu_expand.png">
 
-You can extend the AutoConnect menu to improve the original sketches and according to the procedure described in section [*Advanced Usage*](advancedusage.md#casts-the-html-pages-to-be-add-on-into-the-menu).
+You can improve your sketches by extending the AutoConnect menu by adding the legacy web pages according to the procedure described in section [*Advanced Usage*](advancedusage.md#casts-the-html-pages-to-be-add-on-into-the-menu).

From 7b8879ee1ec00d4286fb67caac6d8358494165ec Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Wed, 16 Oct 2019 17:05:52 +0900
Subject: [PATCH 20/25] Fixed no member named 'printTo' compilation error

---
 README.md                          | 1 +
 examples/Credential/Credential.ino | 2 +-
 mkdocs/changelog.md                | 1 +
 src/AutoConnectUpdate.cpp          | 2 +-
 4 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 134e448..a7d8cb3 100644
--- a/README.md
+++ b/README.md
@@ -103,6 +103,7 @@ Full documentation is available on https://Hieromon.github.io/AutoConnect, some
 
 ### [1.1.0] Oct. 15, 2019
 - Supprts static IPs with the 'Configure new AP' menu. (issue #132)
+- Fixed compilation error that no member named 'printTo' with ArduinoJson 5.
 
 ### [1.0.3] Sept. 30, 2019
 - Fixed a return of AutoConnectCredential::entries(). (issue #133)
diff --git a/examples/Credential/Credential.ino b/examples/Credential/Credential.ino
index ed1e0bc..fe2fa5e 100644
--- a/examples/Credential/Credential.ino
+++ b/examples/Credential/Credential.ino
@@ -125,7 +125,7 @@ String delCredential(PageArgument& args) {
     int8_t  e = args.arg("num").toInt();
     Serial.printf("Request deletion #%d\n", e);
     if (e > 0) {
-      struct  station_config entry;
+      station_config_t  entry;
 
       // If the input number is valid, delete that entry.
       int8_t  de = ac.load(e - 1, &entry);  // A base of entry num is 0.
diff --git a/mkdocs/changelog.md b/mkdocs/changelog.md
index 25a35b4..7e6e844 100644
--- a/mkdocs/changelog.md
+++ b/mkdocs/changelog.md
@@ -1,5 +1,6 @@
 #### [1.1.0] Oct. 15, 2019
 - Supports static IPs with the [**Configure new AP**](menu.md#configure-new-ap) menu.
+- Fixed compilation error that no member named 'printTo' with ArduinoJson 5.
 
 #### [1.0.3] Sept. 30, 2019
 - Fixed a return of AutoConnectCredential::entries().
diff --git a/src/AutoConnectUpdate.cpp b/src/AutoConnectUpdate.cpp
index 3b9b678..d5b7409 100644
--- a/src/AutoConnectUpdate.cpp
+++ b/src/AutoConnectUpdate.cpp
@@ -405,7 +405,7 @@ String AutoConnectUpdateAct::_onCatalog(AutoConnectAux& catalog, PageArgument& a
         if (parse) {
 #ifdef AC_DEBUG
           AC_DBG_DUMB("\n");
-          ARDUINOJSON_PRINT(jb, AC_DEBUG_PORT);
+          ARDUINOJSON_PRINT(json, AC_DEBUG_PORT);
 #endif
           // Register only bin type file name as available sketch binary to
           // AutoConnectRadio value based on the response from the update server.

From 6b9564145ace436c2f1ac9b77707624898ce90f2 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Wed, 16 Oct 2019 17:06:09 +0900
Subject: [PATCH 21/25] Support the Config New with static IP

---
 src/AutoConnectPage.cpp     | 2 +-
 src/AutoConnectUpdatePage.h | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/AutoConnectPage.cpp b/src/AutoConnectPage.cpp
index 1d70999..047b6cc 100644
--- a/src/AutoConnectPage.cpp
+++ b/src/AutoConnectPage.cpp
@@ -38,7 +38,7 @@ const char AutoConnect::_CSS_BASE[] PROGMEM = {
   ".base-panel{"
     "margin:0 22px 0 22px"
   "}"
-  ".base-panel * label{"
+  ".base-panel * label :not(.bins){"
     "display:inline-block;"
     "width:3.0em;"
     "text-align:right"
diff --git a/src/AutoConnectUpdatePage.h b/src/AutoConnectUpdatePage.h
index 5488dcd..880d2c2 100644
--- a/src/AutoConnectUpdatePage.h
+++ b/src/AutoConnectUpdatePage.h
@@ -14,7 +14,7 @@
 // Define the AUTOCONNECT_URI_UPDATE page to select the sketch binary
 // for update and order update execution.
 const AutoConnectUpdateAct::ACElementProp_t AutoConnectUpdateAct::_elmCatalog[] PROGMEM = {
-  { AC_Element, "binSty", "<style type=\"text/css\">.bins{display:grid;font-size:14px;grid-gap:10px 0;grid-template-columns:1em repeat(4,max-content);overflow-x:auto}.bins input[type=radio]{-moz-appearance:radio;-webkit-appearance:radio;margin:0;vertical-align:middle}.noorder .bins label,span{margin:0 .5em 0 .5em;padding:0;text-align:left}</style>", nullptr },
+  { AC_Element, "binSty", "<style type=\"text/css\">.bins{display:grid;font-size:14px;grid-gap:10px 0;grid-template-columns:1em repeat(4,max-content);overflow-x:auto}.bins input[type=radio]{-moz-appearance:radio;-webkit-appearance:radio;margin:0;vertical-align:middle}.noorder .bins label,.bins span{margin:0 .5em 0 .5em;padding:0;text-align:left}</style>", nullptr },
   { AC_Text, "caption", nullptr, nullptr },
   { AC_Element, "c1", "<div class=\"bins\">", nullptr },
   { AC_Radio, "firmwares", nullptr, nullptr },

From 4d947bd0ac2e8e988c4559a9c5a9a488f8a837ec Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Wed, 16 Oct 2019 17:27:11 +0900
Subject: [PATCH 22/25] Release for v1.1.0

---
 src/AutoConnectDefs.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/AutoConnectDefs.h b/src/AutoConnectDefs.h
index 096d6e2..fb8e960 100644
--- a/src/AutoConnectDefs.h
+++ b/src/AutoConnectDefs.h
@@ -11,7 +11,7 @@
 #define _AUTOCONNECTDEFS_H_
 
 // Uncomment the following AC_DEBUG to enable debug output.
-#define AC_DEBUG
+//#define AC_DEBUG
 
 // Debug output destination can be defined externally with AC_DEBUG_PORT
 #ifndef AC_DEBUG_PORT

From 5527dd27449a93bfe34ebb0d6591575e033f1522 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <hieromon@gmail.com>
Date: Wed, 16 Oct 2019 17:32:00 +0900
Subject: [PATCH 23/25] Fixes typo

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a7d8cb3..9ab07a7 100644
--- a/README.md
+++ b/README.md
@@ -102,7 +102,7 @@ Full documentation is available on https://Hieromon.github.io/AutoConnect, some
 ## Change log
 
 ### [1.1.0] Oct. 15, 2019
-- Supprts static IPs with the 'Configure new AP' menu. (issue #132)
+- Supports static IPs with the 'Configure new AP' menu. (issue #132)
 - Fixed compilation error that no member named 'printTo' with ArduinoJson 5.
 
 ### [1.0.3] Sept. 30, 2019

From 595a43cfca4efd9f8886c0dcf7d7907283732d33 Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <Hieromon@users.noreply.github.com>
Date: Wed, 16 Oct 2019 18:49:56 +0900
Subject: [PATCH 24/25] Fixes typo

---
 mkdocs/faq.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mkdocs/faq.md b/mkdocs/faq.md
index 3eec6a6..7955661 100644
--- a/mkdocs/faq.md
+++ b/mkdocs/faq.md
@@ -195,7 +195,7 @@ It may be two possibilities as follows:
 2. Heap is insufficient memory. AutoConnect entrusts HTML generation to PageBuilder that makes heavy use the String::concatenate function and causes memory fragmentation. This is a structural problem with PageBuilder, but it is difficult to solve immediately.
 
 If this issue produces with your sketch, Reloading the page may recover.  
-Also, you can check the memory running out status by rebuilding the sketch with [PageBuilder's debug log option](faq.html#fn:2) turned on.
+Also, you can check the memory running out status by rebuilding the sketch with [PageBuilder's debug log option](faq.md#fn:2) turned on.
 
 If the heap memory is insufficient, the following message is displayed on the serial console.
 

From 690f2f11d52c7ef2348f2248a52dd79d38681e0f Mon Sep 17 00:00:00 2001
From: Hieromon Ikasamo <Hieromon@users.noreply.github.com>
Date: Wed, 16 Oct 2019 18:51:52 +0900
Subject: [PATCH 25/25] v110 deployment

---
 docs/advancedusage.html       |   2 +-
 docs/changelog.html           |  23 ++-
 docs/credit.html              | 106 +++++++++----
 docs/faq.html                 |  44 +++++
 docs/gettingstarted.html      |   4 +
 docs/images/newap.png         | Bin 63923 -> 76246 bytes
 docs/images/newap_static.png  | Bin 0 -> 101206 bytes
 docs/images/process_begin.svg | 291 ++++++++++++++++++++++++++++++----
 docs/images/staticip.png      | Bin 0 -> 24328 bytes
 docs/menu.html                |  54 ++++---
 docs/search/search_index.json |   2 +-
 docs/sitemap.xml              |  58 +++----
 docs/sitemap.xml.gz           | Bin 408 -> 409 bytes
 13 files changed, 470 insertions(+), 114 deletions(-)
 create mode 100644 docs/images/newap_static.png
 create mode 100644 docs/images/staticip.png

diff --git a/docs/advancedusage.html b/docs/advancedusage.html
index f966097..5aa3cfb 100644
--- a/docs/advancedusage.html
+++ b/docs/advancedusage.html
@@ -1354,7 +1354,7 @@ Also, if you want to stop AutoConnect completely when the captive portal is time
 
 <h3 id="casts-the-html-pages-to-be-add-on-into-the-menu"><i class="fa fa-caret-right"></i> Casts the HTML pages to be add-on into the menu<a class="headerlink" href="#casts-the-html-pages-to-be-add-on-into-the-menu" title="Permanent link">&para;</a></h3>
 <p>If your sketch handles web pages, you can embed the pages into the AutoConnect menu in continuance enjoying the utility of the WiFi connection feature. Unlike the custom Web pages by <a href="acelements.html">AutoConnectElements</a>, this allows to legacy web pages registered by <em>ESP8266WebServer::on</em> or <em>WebServer::on</em> function.</p>
-<p>You can use AutoConnectAux only constructed with the URI of the page to be embedding. AutoConnectElements is not required. The basic procedure for this as follows:</p>
+<p>To implement embedding your legacy web pages to the AutoConnect menu, you can use AutoConnectAux only constructed with the URI of the page to be embedding. AutoConnectElements is not required. The basic procedure for this as follows:</p>
 <ol>
 <li>Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu.</li>
 <li>Sketch the legacy page handlers.</li>
diff --git a/docs/changelog.html b/docs/changelog.html
index 8a97d4a..abd0e1e 100644
--- a/docs/changelog.html
+++ b/docs/changelog.html
@@ -122,7 +122,7 @@
     <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
     <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
     
-      <a href="#103-sept-30-2019" tabindex="1" class="md-skip">
+      <a href="#110-oct-15-2019" tabindex="1" class="md-skip">
         Skip to content
       </a>
     
@@ -725,6 +725,13 @@
     <label class="md-nav__title" for="__toc">Table of contents</label>
     <ul class="md-nav__list" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#110-oct-15-2019" title="[1.1.0] Oct. 15, 2019" class="md-nav__link">
+    [1.1.0] Oct. 15, 2019
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#103-sept-30-2019" title="[1.0.3] Sept. 30, 2019" class="md-nav__link">
     [1.0.3] Sept. 30, 2019
@@ -878,6 +885,13 @@
     <label class="md-nav__title" for="__toc">Table of contents</label>
     <ul class="md-nav__list" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#110-oct-15-2019" title="[1.1.0] Oct. 15, 2019" class="md-nav__link">
+    [1.1.0] Oct. 15, 2019
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#103-sept-30-2019" title="[1.0.3] Sept. 30, 2019" class="md-nav__link">
     [1.0.3] Sept. 30, 2019
@@ -1009,7 +1023,12 @@
                 
                   <h1>Change log</h1>
                 
-                <h4 id="103-sept-30-2019">[1.0.3] Sept. 30, 2019<a class="headerlink" href="#103-sept-30-2019" title="Permanent link">&para;</a></h4>
+                <h4 id="110-oct-15-2019">[1.1.0] Oct. 15, 2019<a class="headerlink" href="#110-oct-15-2019" title="Permanent link">&para;</a></h4>
+<ul>
+<li>Supports static IPs with the <a href="menu.html#configure-new-ap"><strong>Configure new AP</strong></a> menu.</li>
+<li>Fixed compilation error that no member named 'printTo' with ArduinoJson 5.</li>
+</ul>
+<h4 id="103-sept-30-2019">[1.0.3] Sept. 30, 2019<a class="headerlink" href="#103-sept-30-2019" title="Permanent link">&para;</a></h4>
 <ul>
 <li>Fixed a return of AutoConnectCredential::entries().</li>
 </ul>
diff --git a/docs/credit.html b/docs/credit.html
index bfbccc5..eb5a400 100644
--- a/docs/credit.html
+++ b/docs/credit.html
@@ -772,8 +772,8 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#station_config" title="  station_config" class="md-nav__link">
-      station_config
+  <a href="#station_config_t" title="  station_config_t" class="md-nav__link">
+      station_config_t
   </a>
   
 </li>
@@ -982,8 +982,8 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#station_config" title="  station_config" class="md-nav__link">
-      station_config
+  <a href="#station_config_t" title="  station_config_t" class="md-nav__link">
+      station_config_t
   </a>
   
 </li>
@@ -1075,37 +1075,37 @@
     <dd>Number of entries as contained credentials.</dd>
 </dl></p>
 <h4 id="load"><i class="fa fa-caret-right"></i> load<a class="headerlink" href="#load" title="Permanent link">&para;</a></h4>
-<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">int8_t</span> <span style="color: #f8f8f2">load(</span><span style="color: #66d9ef">const</span> <span style="color: #66d9ef">char</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">ssid,</span> <span style="color: #66d9ef">struct</span> <span style="color: #f8f8f2">station_config</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">config)</span>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">int8_t</span> <span style="color: #f8f8f2">load(</span><span style="color: #66d9ef">const</span> <span style="color: #66d9ef">char</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">ssid,</span> <span style="color: #f8f8f2">station_config_t</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">config)</span>
 </pre></div>
 
 <p>Load a credential entry and store to <strong>config</strong>.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
     <dd><span class="apidef">ssid</span><span class="apidesc">SSID to be loaded.</span></dd>
-    <dd><span class="apidef">config</span><span class="apidesc">station_config</span></dd>
+    <dd><span class="apidef">config</span><span class="apidesc">station_config_t</span></dd>
     <dt><strong>Return value</strong></dt>
-    <dd>Save the specified SSID's credential entry to station_config pointed to by the parameter as <strong>config</strong>. -1 is returned if the SSID is not saved. </dd>
+    <dd>Save the specified SSID's credential entry to station_config_t pointed to by the parameter as <strong>config</strong>. -1 is returned if the SSID is not saved. </dd>
 </dl></p>
 <h4 id="load_1"><i class="fa fa-caret-right"></i> load<a class="headerlink" href="#load_1" title="Permanent link">&para;</a></h4>
-<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">load(</span><span style="color: #66d9ef">int8_t</span> <span style="color: #f8f8f2">entry,</span> <span style="color: #66d9ef">struct</span> <span style="color: #f8f8f2">station_config</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">config)</span>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">load(</span><span style="color: #66d9ef">int8_t</span> <span style="color: #f8f8f2">entry,</span> <span style="color: #f8f8f2">station_config_t</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">config)</span>
 </pre></div>
 
 <p>Load a credential entry and store to <strong>config</strong>.
 <dl class="apidl">
     <dt><strong>Parameters</strong></dt>
     <dd><span class="apidef">entry</span><span class="apidesc">Specifies the index number based 0 to be loaded.</span></dd>
-    <dd><span class="apidef">config</span><span class="apidesc">station_config</span></dd>
+    <dd><span class="apidef">config</span><span class="apidesc">station_config_t</span></dd>
     <dt><strong>Return value</strong></dt>
-    <dd>Save the specified credential entry to station_config pointed to by the parameter as <strong>config</strong>. -1 is returned if specified number is not saved. </dd>
+    <dd>Save the specified credential entry to station_config_t pointed to by the parameter as <strong>config</strong>. -1 is returned if specified number is not saved. </dd>
 </dl></p>
 <h4 id="save"><i class="fa fa-caret-right"></i> save<a class="headerlink" href="#save" title="Permanent link">&para;</a></h4>
-<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">save(</span><span style="color: #66d9ef">const</span> <span style="color: #66d9ef">struct</span> <span style="color: #f8f8f2">station_config</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">config)</span>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">bool</span> <span style="color: #f8f8f2">save(</span><span style="color: #66d9ef">const</span> <span style="color: #f8f8f2">station_config_t</span><span style="color: #f92672">*</span> <span style="color: #f8f8f2">config)</span>
 </pre></div>
 
 <p>Save a credential entry.
 <dl class="apidl">
     <dt><strong>Parameter</strong></dt>
-    <dd><span class="apidef">config</span><span class="apidesc">station_config to be saved.</span></dd>
+    <dd><span class="apidef">config</span><span class="apidesc">station_config_t to be saved.</span></dd>
     <dt><strong>Return value</strong></dt>
     <dd><span class="apidef">true</span><span class="apidesc">Successfully saved.</span></dd>
     <dd><span class="apidef">false</span><span class="apidesc">Failed to save.</span></dd>
@@ -1128,7 +1128,7 @@
 The following function is an implementation example, and you can use it to achieve batch clearing.
 <div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">void</span> <span style="color: #a6e22e">deleteAllCredentials</span><span style="color: #f8f8f2">(</span><span style="color: #66d9ef">void</span><span style="color: #f8f8f2">)</span> <span style="color: #f8f8f2">{</span>
   <span style="color: #f8f8f2">AutoConnectCredential</span> <span style="color: #f8f8f2">credential;</span>
-  <span style="color: #66d9ef">struct</span> <span style="color: #f8f8f2">station_config</span> <span style="color: #f8f8f2">config;</span>
+  <span style="color: #f8f8f2">station_config_t</span> <span style="color: #f8f8f2">config;</span>
   <span style="color: #66d9ef">uint8_t</span> <span style="color: #f8f8f2">ent</span> <span style="color: #f92672">=</span> <span style="color: #f8f8f2">credential.entries();</span>
 
   <span style="color: #66d9ef">while</span> <span style="color: #f8f8f2">(ent</span><span style="color: #f92672">--</span><span style="color: #f8f8f2">)</span> <span style="color: #f8f8f2">{</span>
@@ -1139,27 +1139,36 @@ The following function is an implementation example, and you can use it to achie
 </pre></div></p>
 </div>
 <h2 id="the-data-structures">The data structures<a class="headerlink" href="#the-data-structures" title="Permanent link">&para;</a></h2>
-<h3 id="station_config"><i class="fa fa-code"></i>  station_config<a class="headerlink" href="#station_config" title="Permanent link">&para;</a></h3>
-<p>A structure is included in the ESP8266 SDK. You can use it in the sketch like as follows:</p>
-<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">extern</span> <span style="color: #e6db74">&quot;C&quot;</span> <span style="color: #f8f8f2">{</span>
-<span style="color: #75715e">#include</span> <span style="color: #75715e">&lt;user_interface.h&gt;</span>
-<span style="color: #f8f8f2">}</span>
-</pre></div>
-
-<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">struct</span> <span style="color: #f8f8f2">station_config</span> <span style="color: #f8f8f2">{</span>
-  <span style="color: #f8f8f2">uint8</span> <span style="color: #f8f8f2">ssid[</span><span style="color: #ae81ff">32</span><span style="color: #f8f8f2">];</span>
-  <span style="color: #f8f8f2">uint8</span> <span style="color: #f8f8f2">password[</span><span style="color: #ae81ff">64</span><span style="color: #f8f8f2">];</span>
-  <span style="color: #f8f8f2">uint8</span> <span style="color: #f8f8f2">bssid_set;</span>
-  <span style="color: #f8f8f2">uint8</span> <span style="color: #f8f8f2">bssid[</span><span style="color: #ae81ff">6</span><span style="color: #f8f8f2">];</span>
-<span style="color: #f8f8f2">};</span>
+<h3 id="station_config_t"><i class="fa fa-code"></i>  station_config_t<a class="headerlink" href="#station_config_t" title="Permanent link">&para;</a></h3>
+<p>The saved credential structure is defined as stato_config_t in the AcutoConnectCredential header file.</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #66d9ef">typedef</span> <span style="color: #66d9ef">struct</span> <span style="color: #f8f8f2">{</span>
+  <span style="color: #66d9ef">uint8_t</span> <span style="color: #f8f8f2">ssid[</span><span style="color: #ae81ff">32</span><span style="color: #f8f8f2">];</span>
+  <span style="color: #66d9ef">uint8_t</span> <span style="color: #f8f8f2">password[</span><span style="color: #ae81ff">64</span><span style="color: #f8f8f2">];</span>
+  <span style="color: #66d9ef">uint8_t</span> <span style="color: #f8f8f2">bssid[</span><span style="color: #ae81ff">6</span><span style="color: #f8f8f2">];</span>
+  <span style="color: #66d9ef">uint8_t</span> <span style="color: #f8f8f2">dhcp;</span>   <span style="color: #75715e">/**&lt; 0:DHCP, 1:Static IP */</span>
+  <span style="color: #66d9ef">union</span> <span style="color: #f8f8f2">_config</span> <span style="color: #f8f8f2">{</span>
+    <span style="color: #66d9ef">uint32_t</span>  <span style="color: #f8f8f2">addr[</span><span style="color: #ae81ff">5</span><span style="color: #f8f8f2">];</span>
+    <span style="color: #66d9ef">struct</span> <span style="color: #f8f8f2">_sta</span> <span style="color: #f8f8f2">{</span>
+      <span style="color: #66d9ef">uint32_t</span> <span style="color: #f8f8f2">ip;</span>
+      <span style="color: #66d9ef">uint32_t</span> <span style="color: #f8f8f2">gateway;</span>
+      <span style="color: #66d9ef">uint32_t</span> <span style="color: #f8f8f2">netmask;</span>
+      <span style="color: #66d9ef">uint32_t</span> <span style="color: #f8f8f2">dns1;</span>
+      <span style="color: #66d9ef">uint32_t</span> <span style="color: #f8f8f2">dns2;</span>
+    <span style="color: #f8f8f2">}</span> <span style="color: #f8f8f2">sta;</span>
+  <span style="color: #f8f8f2">}</span> <span style="color: #f8f8f2">config;</span>
+<span style="color: #f8f8f2">}</span> <span style="color: #f8f8f2">station_config_t;</span>
 </pre></div>
 
+<div class="admonition note">
+<p class="admonition-title">The byte size of station_config_t in program memory and stored credentials is different</p>
+<p>There is a gap byte for boundary alignment between the <code>dhcp</code> member and the static IP members of the above station_config_t. Its gap byte will be removed with saved credentials on the flash.</p>
+</div>
 <h3 id="the-credential-entry"><i class="fa fa-code"></i>  The credential entry<a class="headerlink" href="#the-credential-entry" title="Permanent link">&para;</a></h3>
 <p>A data structure of the credential saving area in EEPROM as the below. <sup id="fnref:4"><a class="footnote-ref" href="#fn:4" rel="footnote">4</a></sup></p>
 <table>
 <thead>
 <tr>
-<th>Byte offset</th>
+<th>byte offset</th>
 <th>Length</th>
 <th>Value</th>
 </tr>
@@ -1197,8 +1206,43 @@ The following function is an implementation example, and you can use it to achie
 </tr>
 <tr>
 <td>variable</td>
+<td>1</td>
+<td>Flag for DHCP or Static IP (0:DHCP, 1:Static IP)</td>
+</tr>
+<tr>
+<td><td colspan=3>The following IP address entries are stored only for static IPs.</td>
+<td></td>
 <td></td>
-<td>Contained the next entries. (Continuation SSID+Password+BSSID)</td>
+</tr>
+<tr>
+<td>variable(1)</td>
+<td>4</td>
+<td>Station IP address (uint32_t)</td>
+</tr>
+<tr>
+<td>variable(5)</td>
+<td>4</td>
+<td>Gateway address (uint32_t)</td>
+</tr>
+<tr>
+<td>variable(9)</td>
+<td>4</td>
+<td>Netmask (uint32_t)</td>
+</tr>
+<tr>
+<td>variable(13)</td>
+<td>4</td>
+<td>Primary DNS address (uint32_t)</td>
+</tr>
+<tr>
+<td>variable(17)</td>
+<td>4</td>
+<td>Secondary IP address (uint32_t)</td>
+</tr>
+<tr>
+<td>variable</td>
+<td>variable</td>
+<td>Contained the next entries. (Continuation SSID+Password+BSSID+DHCP flag+Static IPs(if exists))</td>
 </tr>
 <tr>
 <td>variable</td>
@@ -1207,6 +1251,12 @@ The following function is an implementation example, and you can use it to achie
 </tr>
 </tbody>
 </table>
+<div class="admonition note">
+<p class="admonition-title">AutoConnectCredential has changed</p>
+<p>It was lost AutoConnectCredential backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not work properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading.
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>esptool -c esp8266 (or esp32) - p [COM_PORT] erase_flash
+</pre></div></p>
+</div>
 <div class="footnote">
 <hr />
 <ol>
diff --git a/docs/faq.html b/docs/faq.html
index 8259134..28888e1 100644
--- a/docs/faq.html
+++ b/docs/faq.html
@@ -857,6 +857,20 @@
      I cannot see the custom Web page.
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#saved-credentials-are-wrong-or-lost" title=" Saved credentials are wrong or lost." class="md-nav__link">
+     Saved credentials are wrong or lost.
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#some-autoconnect-page-is-cut-off" title=" Some AutoConnect page is cut off." class="md-nav__link">
+     Some AutoConnect page is cut off.
+  </a>
+  
 </li>
       
         <li class="md-nav__item">
@@ -1124,6 +1138,20 @@
      I cannot see the custom Web page.
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#saved-credentials-are-wrong-or-lost" title=" Saved credentials are wrong or lost." class="md-nav__link">
+     Saved credentials are wrong or lost.
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#some-autoconnect-page-is-cut-off" title=" Some AutoConnect page is cut off." class="md-nav__link">
+     Some AutoConnect page is cut off.
+  </a>
+  
 </li>
       
         <li class="md-nav__item">
@@ -1361,6 +1389,22 @@ wdt reset
 <p>Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu.</p>
 <h2 id="i-cannot-see-the-custom-web-page"><i class="fa fa-question-circle"></i> I cannot see the custom Web page.<a class="headerlink" href="#i-cannot-see-the-custom-web-page" title="Permanent link">&para;</a></h2>
 <p>If the sketch is correct, a JSON syntax error may have occurred. In this case, activate the <a href="faq.html#3-turn-on-the-debug-log-options">AC_DEBUG</a> and rerun. If you take the message of JSON syntax error, the <a href="https://arduinojson.org/v5/assistant/">Json Assistant</a> helps syntax checking. This online tool is provided by the author of ArduinoJson and is most consistent for the AutoConnect. </p>
+<h2 id="saved-credentials-are-wrong-or-lost"><i class="fa fa-question-circle"></i> Saved credentials are wrong or lost.<a class="headerlink" href="#saved-credentials-are-wrong-or-lost" title="Permanent link">&para;</a></h2>
+<p>A structure of AutoConnect saved credentials has changed two times throughout enhancement with v1.0.3 and v1.1.0. In particular, due to enhancements in v1.1.0, AutoConnectCredential data structure has lost the backward compatibility with previous versions. You must erase the flash of the ESP module using the esptool completely to save the credentials correctly with v1.1.0.
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>esptool -c esp8266 (or esp32) -p [COM_PORT] erase_flash
+</pre></div></p>
+<h2 id="some-autoconnect-page-is-cut-off"><i class="fa fa-question-circle"></i> Some AutoConnect page is cut off.<a class="headerlink" href="#some-autoconnect-page-is-cut-off" title="Permanent link">&para;</a></h2>
+<p>It may be two possibilities as follows:</p>
+<ol>
+<li>Packet loss during transmission due to a too weak WiFi signal.</li>
+<li>Heap is insufficient memory. AutoConnect entrusts HTML generation to PageBuilder that makes heavy use the String::concatenate function and causes memory fragmentation. This is a structural problem with PageBuilder, but it is difficult to solve immediately.</li>
+</ol>
+<p>If this issue produces with your sketch, Reloading the page may recover.<br />
+Also, you can check the memory running out status by rebuilding the sketch with <a href="faq.html#fn:2">PageBuilder's debug log option</a> turned on.</p>
+<p>If the heap memory is insufficient, the following message is displayed on the serial console.</p>
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>[PB] Failed building, free heap:&lt;Size of free heap&gt;
+</pre></div>
+
 <h2 id="submit-element-in-a-custom-web-page-does-not-react"><i class="fa fa-question-circle"></i> Submit element in a custom Web page does not react.<a class="headerlink" href="#submit-element-in-a-custom-web-page-does-not-react" title="Permanent link">&para;</a></h2>
 <p>Is there the AutoConnectElements element named <strong>SUBMIT</strong> in the custom Web page? (case sensitive ignored) AutoConnect does not rely on the <code>input type=submit</code> element for the form submission and uses <a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement/submit">HTML form element submit</a> function instead. So, the submit function will fail if there is an element named 'submit' in the form. You can not use <strong>SUBMIT</strong> as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element.</p>
 <h2 id="still-not-stable-with-my-sketch"><i class="fa fa-question-circle"></i> Still, not stable with my sketch.<a class="headerlink" href="#still-not-stable-with-my-sketch" title="Permanent link">&para;</a></h2>
diff --git a/docs/gettingstarted.html b/docs/gettingstarted.html
index 805817c..170ee76 100644
--- a/docs/gettingstarted.html
+++ b/docs/gettingstarted.html
@@ -907,6 +907,10 @@
 <h3 id="join-to-the-new-access-point"><i class="fa fa-cog"></i> Join to the new access point<a class="headerlink" href="#join-to-the-new-access-point" title="Permanent link">&para;</a></h3>
 <p>Here, tap <em>"Configure new AP"</em> to connect the new access point then the SSID configuration screen would be shown. Enter the <strong>SSID</strong> and <strong>Passphrase</strong> and tap <strong>apply</strong> to start connecting the access point.</p>
 <p><img src="images/menu_login.png" style="border:1px solid lightgrey;width:280px;" /><img src="images/arrow_right.svg" style="vertical-align:top;padding-top:120px;width:48px;margin-left:30px;margin-right:30px;" /><img src="images/config_ssid.png" style="border:1px solid lightgrey;width:280px;" /></p>
+<div class="admonition info">
+<p class="admonition-title">Can be configured with static IP</p>
+<p>Since v1.1.0, <a href="menu.html#configure-new-ap"><strong>Configure new AP</strong></a> menu can configure for WIFI_STA with static IP.</p>
+</div>
 <h3 id="connection-establishment"><i class="fa fa-rss"></i> Connection establishment<a class="headerlink" href="#connection-establishment" title="Permanent link">&para;</a></h3>
 <p>After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI_AP_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step.</p>
 <p>For one, continues execution of the sketch while keeping this connection. You can access ESP8266 via browser through the established IP address after cancel to "<strong>Log in</strong>" by upper right on the screen.<br />
diff --git a/docs/images/newap.png b/docs/images/newap.png
index ebcb920e09fc47766a17dc8f406db61487e407ce..b89b3b432f939779ec43b99b112d6cf0556a1b5a 100644
GIT binary patch
literal 76246
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

literal 63923
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
B+!+7>

diff --git a/docs/images/newap_static.png b/docs/images/newap_static.png
new file mode 100644
index 0000000000000000000000000000000000000000..35415b0f7dc6087120dff6cd2c07d15b2e5e462e
GIT binary patch
literal 101206
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
H9yswoS>(f}

literal 0
HcmV?d00001

diff --git a/docs/images/process_begin.svg b/docs/images/process_begin.svg
index 9815b95..b9224a9 100644
--- a/docs/images/process_begin.svg
+++ b/docs/images/process_begin.svg
@@ -9,9 +9,9 @@
    xmlns="http://www.w3.org/2000/svg"
    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   width="99.56517mm"
-   height="304.07242mm"
-   viewBox="0 0 99.56517 304.07241"
+   width="109mm"
+   height="371.83472mm"
+   viewBox="0 0 108.99999 371.83472"
    version="1.1"
    id="svg8776"
    inkscape:version="0.92.2 (5c3e80d, 2017-08-06)"
@@ -224,6 +224,21 @@
          style="stroke-width:2"
          id="path2786" />
     </symbol>
+    <marker
+       inkscape:stockid="Arrow2Mstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="marker10923-1"
+       style="overflow:visible"
+       inkscape:isstock="true">
+      <path
+         id="path10921-8"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         transform="scale(0.6)"
+         inkscape:connector-curvature="0" />
+    </marker>
   </defs>
   <sodipodi:namedview
      id="base"
@@ -233,12 +248,12 @@
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
      inkscape:zoom="1.4142136"
-     inkscape:cx="192.80115"
-     inkscape:cy="364.94967"
+     inkscape:cx="259.43725"
+     inkscape:cy="1200.0696"
      inkscape:document-units="mm"
      inkscape:current-layer="layer1"
      showgrid="false"
-     inkscape:snap-global="false"
+     inkscape:snap-global="true"
      inkscape:snap-bbox="true"
      inkscape:snap-nodes="true"
      inkscape:snap-others="true"
@@ -249,11 +264,11 @@
      inkscape:bbox-nodes="true"
      inkscape:snap-bbox-edge-midpoints="true"
      inkscape:snap-bbox-midpoints="true"
-     inkscape:window-width="1920"
-     inkscape:window-height="1029"
-     inkscape:window-x="1272"
-     inkscape:window-y="-8"
-     inkscape:window-maximized="1"
+     inkscape:window-width="1571"
+     inkscape:window-height="1013"
+     inkscape:window-x="1376"
+     inkscape:window-y="0"
+     inkscape:window-maximized="0"
      fit-margin-top="0"
      fit-margin-left="0"
      fit-margin-right="0"
@@ -261,8 +276,8 @@
     <inkscape:grid
        type="xygrid"
        id="grid9104"
-       originx="-23.598368"
-       originy="15.544285" />
+       originx="-23.664512"
+       originy="15.544259" />
   </sodipodi:namedview>
   <metadata
      id="metadata8773">
@@ -280,7 +295,17 @@
      inkscape:label="レイヤー 1"
      inkscape:groupmode="layer"
      id="layer1"
-     transform="translate(-23.598368,-8.4718652)">
+     transform="translate(-23.664512,59.290411)">
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208337,-11.256129 v 3.8405916"
+       id="path9639-8-5-5"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458335px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208337,16.669816 v 3.840593"
+       id="path9639"
+       inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
        d="m 58.208334,32.416659 v 4.08568"
@@ -464,7 +489,7 @@
     </g>
     <g
        id="g9633"
-       transform="translate(-33.072919,2.6458338)">
+       transform="translate(-33.734378,-65.116439)">
       <rect
          ry="0.26458257"
          rx="0.26458332"
@@ -486,11 +511,6 @@
            id="tspan9136"
            sodipodi:role="line">STA</tspan></text>
     </g>
-    <path
-       style="fill:none;stroke:#000000;stroke-width:0.26458335px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 58.208334,16.669815 v 3.840593"
-       id="path9639"
-       inkscape:connector-curvature="0" />
     <g
        id="g9714"
        transform="translate(-78.07551,36.012307)">
@@ -781,13 +801,13 @@
     </g>
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458335px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="M 105.83333,175.75504 V 297.54958 H 92.604167"
+       d="M 105.83318,175.75505 V 297.53597 H 92.575102"
        id="path9639-1-3-9"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="ccc" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458329px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 75.563113,86.193127 30.107867,-0.06083 0.0306,81.420513"
+       d="m 75.513505,86.193127 30.107915,-0.06083 0.0306,81.420513"
        id="path10088"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="ccc" />
@@ -838,13 +858,13 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458329px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="M 40.845696,26.589892 23.730739,26.467079 23.812499,163.71219 H 58.208331"
+       d="M 40.91184,26.461738 23.796883,26.338925 23.878643,163.58402 H 58.274475"
        id="path10088-9"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker10923)"
-       d="m 24.291915,102.06832 h 16.45392"
+       d="m 24.374806,102.06831 h 16.52812"
        id="path10088-92"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cc" />
@@ -870,7 +890,7 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#Arrow2Mstart)"
-       d="m 57.679167,215.1778 -33.866667,0.13255 0.0073,40.48128 h 16.92604"
+       d="m 57.676398,215.1778 -33.837442,0.13255 0.0074,40.48128 H 40.75779"
        id="path10088-92-6"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
@@ -891,7 +911,7 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker10931)"
-       d="m 58.7375,265.97716 33.866674,-0.13255 -0.0073,-40.48128 H 75.670833"
+       d="m 58.570889,265.97716 33.866674,-0.13255 -0.0073,-40.48128 H 75.504222"
        id="path10088-92-6-8"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
@@ -912,7 +932,7 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker10937)"
-       d="m 58.7375,297.59504 33.734352,-0.0718 -0.007,-21.90474 H 75.538509"
+       d="m 58.708562,297.61156 33.734352,-0.0718 -0.007,-21.90474 H 75.509571"
        id="path10088-92-6-8-3"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
@@ -982,12 +1002,6 @@
          x="60.844864"
          y="110.3716"
          style="stroke-width:0.26458332">YES</tspan></text>
-    <path
-       style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 75.257782,153.66218 30.310608,0.13228"
-       id="path10088-92-3"
-       inkscape:connector-curvature="0"
-       sodipodi:nodetypes="cc" />
     <text
        xml:space="preserve"
        style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
@@ -1165,7 +1179,7 @@
        inkscape:connector-curvature="0" />
     <path
        style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       d="m 41.085466,42.413935 -10.12458,-0.0196 0.01766,22.036862 h 27.103849"
+       d="m 41.054322,42.447007 -10.258285,-0.0196 0.01789,22.036862 H 58.27571"
        id="path10088-9-7"
        inkscape:connector-curvature="0"
        sodipodi:nodetypes="cccc" />
@@ -1201,5 +1215,214 @@
          x="60.844868"
          y="50.651817"
          style="stroke-width:0.26458332">Specified</tspan></text>
+    <g
+       id="g1109"
+       transform="translate(-37.739185,-61.587591)">
+      <g
+         id="g2292">
+        <rect
+           style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.26458329;stroke-linecap:butt;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill"
+           id="rect9134-4-7-4-7"
+           width="34.395828"
+           height="7.9375019"
+           x="78.749603"
+           y="14.472153"
+           rx="0.26458332"
+           ry="0.26458257" />
+        <text
+           xml:space="preserve"
+           style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+           x="84.833466"
+           y="19.319145"
+           id="text9138-7-3-9-9"><tspan
+             y="19.319145"
+             x="84.833466"
+             sodipodi:role="line"
+             id="tspan1104">Set hostname</tspan></text>
+      </g>
+    </g>
+    <g
+       id="g1197"
+       transform="translate(-0.22278483,12.761983)">
+      <rect
+         ry="0.26458257"
+         rx="0.26458332"
+         y="-4.1619601"
+         x="41.233208"
+         height="7.9375019"
+         width="34.395828"
+         id="rect9134-4-7-4-7-5"
+         style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.26458329;stroke-linecap:butt;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill" />
+      <text
+         id="text9138-7-3-9-9-9"
+         y="0.68503231"
+         x="44.635841"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         xml:space="preserve"><tspan
+           y="0.68503231"
+           x="44.635841"
+           id="tspan1192"
+           sodipodi:role="line">WiFi.config (STA)</tspan></text>
+    </g>
+    <g
+       id="g1141">
+      <rect
+         ry="0.26458257"
+         rx="0.26458332"
+         y="-35.072762"
+         x="41.010418"
+         height="7.9375019"
+         width="34.395828"
+         id="rect9134-4-7-4-7-57"
+         style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.26458329;stroke-linecap:butt;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill" />
+      <text
+         id="text9138-7-3-9-9-90"
+         y="-30.225767"
+         x="42.740284"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         xml:space="preserve"><tspan
+           id="tspan1182"
+           sodipodi:role="line"
+           x="42.740284"
+           y="-30.225767">Load current config</tspan></text>
+    </g>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208332,-27.002966 v 3.840593"
+       id="path9639-8-5"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208332,-51.088322 v 3.840592"
+       id="path9639-8-5-3"
+       inkscape:connector-curvature="0" />
+    <g
+       id="g2166"
+       transform="translate(-30.682548,-13.096212)">
+      <rect
+         transform="matrix(0.94594599,0.32432418,-0.94594599,0.32432418,0,0)"
+         ry="3.6888673e-006"
+         rx="3.6888673e-006"
+         y="-62.503849"
+         x="31.466501"
+         height="18.355465"
+         width="18.355474"
+         id="rect9184-6-3-4-5"
+         style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.33777279;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill" />
+      <text
+         id="text9188-6"
+         y="-2.9309402"
+         x="82.091293"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1em;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         xml:space="preserve"><tspan
+           y="-2.9309402"
+           x="82.091293"
+           id="tspan2161"
+           sodipodi:role="line">Static IP</tspan></text>
+    </g>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26499999;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 75.49653,153.66198 H 105.6468"
+       id="path10088-92-2"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cc" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458338px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208337,4.6271392 v 3.840592"
+       id="path9639-0"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="M 58.208337,0.78654773 V 4.6271395"
+       id="path9639-0-5"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458341px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 58.208332,-39.045645 v 3.840594"
+       id="path9639-8-5-6"
+       inkscape:connector-curvature="0" />
+    <g
+       id="g2200"
+       transform="translate(-37.753577,2.3026717)">
+      <rect
+         ry="0.26458257"
+         rx="0.26458332"
+         y="-9.5859175"
+         x="78.764"
+         height="7.9375019"
+         width="34.395828"
+         id="rect9134-4-7-4-7-57-3"
+         style="opacity:0.66000001;vector-effect:none;fill:#e7f3ff;fill-opacity:1;stroke:#000000;stroke-width:0.26458329;stroke-linecap:butt;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:stroke markers fill" />
+      <text
+         id="text9138-7-3-9-9-90-2"
+         y="-4.7389245"
+         x="79.303238"
+         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+         xml:space="preserve"><tspan
+           id="tspan2195"
+           sodipodi:role="line"
+           x="79.303238"
+           y="-4.7389245">Restore saved config</tspan></text>
+    </g>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 40.84505,-17.209253 -10.258285,-0.0196 0.01789,22.0368617 h 27.461784"
+       id="path10088-9-7-3"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="cccc" />
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="35.828152"
+       y="-18.166817"
+       id="text10760-5-3"><tspan
+         sodipodi:role="line"
+         id="tspan10758-9-2"
+         x="35.828152"
+         y="-18.166817"
+         style="stroke-width:0.26458332">NO</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:sans-serif;-inkscape-font-specification:'sans-serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="60.096973"
+       y="-8.7963543"
+       id="text10760-57"><tspan
+         sodipodi:role="line"
+         id="tspan10758-6"
+         x="60.096973"
+         y="-8.7963543"
+         style="stroke-width:0.26458332">YES</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:'Times New Roman';-inkscape-font-specification:'Times New Roman, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="79.585876"
+       y="-32.471371"
+       id="text9138-7-3-9-9-90-9"><tspan
+         sodipodi:role="line"
+         id="tspan1283"
+         x="79.585876"
+         y="-32.471371">Loads saved credentials from the flash</tspan><tspan
+         sodipodi:role="line"
+         id="tspan1285"
+         x="79.585876"
+         y="-28.502621">that matches the last SSID stored in</tspan><tspan
+         sodipodi:role="line"
+         id="tspan1287"
+         x="79.585876"
+         y="-24.533871">the ESP module. </tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.17499995px;line-height:1.25;font-family:serif;-inkscape-font-specification:'serif, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-feature-settings:normal;text-align:start;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.26458332"
+       x="79.543159"
+       y="-14.876924"
+       id="text9138-7-3-9-9-90-9-7"><tspan
+         sodipodi:role="line"
+         id="tspan1289"
+         x="79.543159"
+         y="-14.876924">If that credential has a static IP,</tspan><tspan
+         sodipodi:role="line"
+         id="tspan1291"
+         x="79.543159"
+         y="-10.908174">restore it.</tspan></text>
   </g>
 </svg>
diff --git a/docs/images/staticip.png b/docs/images/staticip.png
new file mode 100644
index 0000000000000000000000000000000000000000..7a02cd22c7449c24897497c3c4abdcf693ab6637
GIT binary patch
literal 24328
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
R2ic=^P8c4~IcoRYzX0p6tf2q^

literal 0
HcmV?d00001

diff --git a/docs/menu.html b/docs/menu.html
index 4d3aa49..1788964 100644
--- a/docs/menu.html
+++ b/docs/menu.html
@@ -362,8 +362,8 @@
 </li>
       
         <li class="md-nav__item">
-  <a href="#by-attaching-autoconnect-menu" title=" by attaching AutoConnect menu" class="md-nav__link">
-     by attaching AutoConnect menu
+  <a href="#attaching-to-autoconnect-menu" title=" Attaching to AutoConnect menu" class="md-nav__link">
+     Attaching to AutoConnect menu
   </a>
   
 </li>
@@ -886,8 +886,8 @@
 </li>
       
         <li class="md-nav__item">
-  <a href="#by-attaching-autoconnect-menu" title=" by attaching AutoConnect menu" class="md-nav__link">
-     by attaching AutoConnect menu
+  <a href="#attaching-to-autoconnect-menu" title=" Attaching to AutoConnect menu" class="md-nav__link">
+     Attaching to AutoConnect menu
   </a>
   
 </li>
@@ -916,11 +916,11 @@
 <p>The AutoConnect menu is developed using the <a href="https://github.com/balzss/luxbar">LuxBar</a> which is licensed under the MIT License. See the <a href="license.html">License</a>.</p>
 </div>
 <h2 id="where-the-from"><i class="fa fa-external-link"></i> Where the from<a class="headerlink" href="#where-the-from" title="Permanent link">&para;</a></h2>
-<p>The AutoConnect menu appears when you access the <strong>AutoConnect root path</strong>. It is assigned "<strong>/_ac</strong>" located on the <em>local IP address</em> of ESP8266/ESP32 module by default. This location can be changed in the sketch. The following screen will appear at access to <code>http://{localIP}/_ac</code> as the root path. This is the statistics of the current WiFi connection. You can access the menu from the here, to invoke it tap <i class="fa fa-bars"></i> at right on top. (e.g. <code>http://172.217.28.1/_ac</code> for SoftAP mode.)</p>
+<p>The following screen will appear as the AutoConnect menu when you access to <strong>AutoConnect root URL</strong> via <code>http://{localIP}/_ac</code>. (eg. <code>http://172.217.28.1/_ac</code>) It is a top page of AutoConnect which shows the current WiFi connection statistics. To invoke the AutoConnect menu, you can t tap <i class="fa fa-bars"></i> at right on top.</p>
 <p><img src="images/ac.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" /></p>
 <div class="admonition note">
-<p class="admonition-title">What's the local IP?</p>
-<p>A local IP means Local IP at connection established or SoftAP's IP.</p>
+<p class="admonition-title">AutoConnect root URL</p>
+<p>It is assigned "<strong>/_ac</strong>" located on the <em>local IP address</em> of ESP8266/ESP32 module by default and can be changed with the sketch. A local IP means Local IP at connection established or SoftAP's IP.</p>
 </div>
 <h2 id="right-on-top"><i class="fa fa-bars"></i> Right on top<a class="headerlink" href="#right-on-top" title="Permanent link">&para;</a></h2>
 <p>Currently, AutoConnect supports four menus. Undermost menu as "HOME" returns to the home path of its sketch.</p>
@@ -933,36 +933,52 @@
 </ul>
 <p><img src="images/menu.png" style="width:280px;" /></p>
 <h2 id="configure-new-ap"><i class="fa fa-bars"></i> Configure new AP<a class="headerlink" href="#configure-new-ap" title="Permanent link">&para;</a></h2>
-<p>Scan all available access point in the vicinity and display it. Strength and security of the detected AP are marked. The <i class="fa fa-lock"></i> is indicated for the SSID that needs a security key. "<strong>Hidden:</strong>" means the number of hidden SSIDs discovered.<br />
-Enter SSID and Passphrase and tap "<strong>apply</strong>" to starts WiFi connection. </p>
+<p>It scans all available access points in the vicinity and display it further the WiFi signal strength and security indicator as <i class="fa fa-lock"></i> of the detected AP. Below that, the number of discovered hidden APs will be displayed. 
+Enter SSID and Passphrase and tap "<strong>Apply</strong>" to start a WiFi connection. </p>
 <p><img src="images/newap.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" /></p>
+<p>If you want to configure with static IP, uncheck "<strong>Enable DHCP</strong>". Once the WiFi connection is established, the entered static IP<sup id="fnref:1"><a class="footnote-ref" href="#fn:1" rel="footnote">1</a></sup> configuration will be stored to the credentials in the flash and restored to the station configuration via the <a href="#open-ssids">Open SSIDs</a> menu.</p>
+<p><img src="images/newap_static.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" /></p>
 <h2 id="open-ssids"><i class="fa fa-bars"></i> Open SSIDs<a class="headerlink" href="#open-ssids" title="Permanent link">&para;</a></h2>
-<p>Once it was established WiFi connection, its SSID and password will be saved in the flash of ESP8266/ESP32 automatically. The <strong>Open SSIDs</strong> menu reads the saved SSID credentials from the flash. The stored credential data are listed by the SSID as shown below. Its label is a clickable button. Tap the SSID button, starts WiFi connection it.</p>
+<p>After WiFi connected, AutoConnect will automatically save the established SSID and password to the flash on the ESP module. <strong>Open SSIDs</strong> menu reads the saved SSID credentials and lists them as below. Listed items are clickable buttons and can initiate a connection to its access point.</p>
 <p><img src="images/open.png" style="border-style:solid;border-width:1px;border-color:lightgrey;width:280px;" /></p>
+<div class="admonition note">
+<p class="admonition-title">Saved credentials data structure has changed</p>
+<p>A structure of AutoConnect saved credentials has changed in v1.1.0 and was lost backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not display properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading.
+<div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span>esptool -c esp8266 (or esp32) - p [COM_PORT] erase_flash
+</pre></div></p>
+</div>
 <h2 id="disconnect"><i class="fa fa-bars"></i> Disconnect<a class="headerlink" href="#disconnect" title="Permanent link">&para;</a></h2>
-<p>Disconnect ESP8266/ESP32 from the current connection. It can also reset the ESP8266/ESP32 automatically after disconnection by instructing with using <a href="api.html#autoreset">API</a> in the sketch.</p>
-<p>After tapping "Disconnect", you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting the WLAN. </p>
+<p>It disconnects ESP8266/ESP32 from the current connection. Also, ESP8266/ESP32 can be automatically reset after WiFi cutting by instructing with the sketch using the <a href="api.html#autoreset">AutoConnect API</a>.</p>
+<p>After tapping the <strong>Disconnect</strong>, you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting to the WLAN. </p>
 <h2 id="reset"><i class="fa fa-bars"></i> Reset...<a class="headerlink" href="#reset" title="Permanent link">&para;</a></h2>
-<p>Reset the ESP8266/ESP32 module, it will start rebooting. After rebooting complete, the ESP8266/ESP32 module begins establishing the previous connection with WIFI_STA mode, and <em>esp8266ap</em> or <em>esp32ap</em> of an access point will disappear from WLAN.</p>
+<p>Resetting the ESP8266/ESP32 module will initiate a reboot. When the module restarting, the <em>esp8266ap</em> or <em>esp32ap</em> access point will disappear from the WLAN and the ESP8266/ESP32 module will begin to reconnect a previous access point with WIFI_STA mode.</p>
 <p><img src="images/resetting.png" style="width:280px;" /></p>
 <div class="admonition warning">
 <p class="admonition-title">Not every ESP8266 module will be rebooted normally</p>
 <p>The Reset menu is using the <strong>ESP.reset()</strong> function for ESP8266. This is an almost hardware reset. In order to resume the sketch normally, the <a href="https://github.com/esp8266/esp8266-wiki/wiki/Boot-Process#esp-boot-modes">state of GPIO0</a> is important. Since this depends on the circuit implementation for each module, not every module will be rebooted normally. See also <a href="faq.html#hang-up-after-reset">FAQ</a>.</p>
 </div>
 <h2 id="custom-menu-items"><i class="fa fa-bars"></i> Custom menu items<a class="headerlink" href="#custom-menu-items" title="Permanent link">&para;</a></h2>
-<p>The menu items of the custom Web page line up at the below in the AutoConnect menu if the custom Web pages are joined. Details for <a href="acintro.html#custom-web-pages-in-autoconnectmenu">Custom Web pages in AutoConnect menu</a>.</p>
+<p>If the sketch has custom Web pages, the AutoConnect menu lines them up with the AutoConnect's items. Details for <a href="acintro.html#custom-web-pages-in-autoconnectmenu">Custom Web pages in AutoConnect menu</a>.</p>
 <h2 id="home"><i class="fa fa-bars"></i> HOME<a class="headerlink" href="#home" title="Permanent link">&para;</a></h2>
-<p>A <strong>HOME</strong> item located at the bottom of the menu list is a link to the home path. The URI as the home path is <code>/</code> by default, and it is defined by <code>AUTOCONNECT_HOMEURI</code> with <strong>AutoConnectDefs.h</strong> file.</p>
+<p>A <strong>HOME</strong> item at the bottom of the menu list is a link to the home path, and the default URI is <code>/</code> which is defined by <code>AUTOCONNECT_HOMEURI</code> in <strong>AutoConnectDefs.h</strong> header file.</p>
 <div class="codehilite" style="background: #272822"><pre style="line-height: 125%"><span></span><span style="color: #75715e">#define AUTOCONNECT_HOMEURI     &quot;/&quot;</span>
 </pre></div>
 
-<p>You can change the HOME path using the AutoConnect API. The <a href="api.html#home"><strong>AutoConnect::home</strong></a> function sets the URI as a link of the HOME item of the AutoConnect menu.</p>
-<h2 id="by-attaching-autoconnect-menu"><i class="fa fa-bars"></i> by attaching AutoConnect menu<a class="headerlink" href="#by-attaching-autoconnect-menu" title="Permanent link">&para;</a></h2>
-<p>The AutoConnect menu can contain HTML pages of your owns sketch as custom items. It works for HTML pages implemented by <strong>ESP8266WebServer::on</strong> handler or <strong>WebServer::on</strong> handler for ESP32. That is, you can make it as menu items to invoke the legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as <a href="https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer/examples/FSBrowser">FSBrowser</a> to the AutoConnect menu item. It adds Edit and List items with little modification to the legacy sketch code.</p>
+<p>Also, you can change the HOME path using the AutoConnect API. The <a href="api.html#home"><strong>AutoConnect::home</strong></a> function sets the URI as a link of the HOME item in the AutoConnect menu.</p>
+<h2 id="attaching-to-autoconnect-menu"><i class="fa fa-bars"></i> Attaching to AutoConnect menu<a class="headerlink" href="#attaching-to-autoconnect-menu" title="Permanent link">&para;</a></h2>
+<p>The AutoConnect menu can contain your sketch's web pages as extra items as a custom. It works for HTML pages implemented by the <strong>ESP8266WebServer::on</strong> handler or the <strong>WebServer::on</strong> handler for ESP32. That is, you can make them invoke the legacy web pages from the AutoConnect menu. The below screen-shot is the result of adding an example sketch for the ESP8266WebServer library known as <a href="https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WebServer/examples/FSBrowser">FSBrowser</a> to the AutoConnect menu item. It can add Edit and List items with little modification to the legacy sketch code.</p>
 <div style="float:left;width:auto;height:420px;"><img style="width:auto;height:420px;" src="images/fsbmenu.png"></div>
 
 <p><img style="margin-left:70px;width:auto;height:420px;" src="images/fsbmenu_expand.png"></p>
-<p>You can extend the AutoConnect menu to improve the original sketches and according to the procedure described in section <a href="advancedusage.html#casts-the-html-pages-to-be-add-on-into-the-menu"><em>Advanced Usage</em></a>.</p>
+<p>You can improve your sketches by extending the AutoConnect menu by adding the legacy web pages according to the procedure described in section <a href="advancedusage.html#casts-the-html-pages-to-be-add-on-into-the-menu"><em>Advanced Usage</em></a>.</p>
+<div class="footnote">
+<hr />
+<ol>
+<li id="fn:1">
+<p>AutoConnect does not check the syntax and validity of the entered IP address. If the entered static IPs are incorrect, it cannot connect to the access point.&#160;<a class="footnote-backref" href="#fnref:1" rev="footnote" title="Jump back to footnote 1 in the text">&#8617;</a></p>
+</li>
+</ol>
+</div>
                 
                   
                 
diff --git a/docs/search/search_index.json b/docs/search/search_index.json
index d41e913..c5b1cb9 100644
--- a/docs/search/search_index.json
+++ b/docs/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"index.html","text":"AutoConnect for ESP8266/ESP32 \u00b6 An Arduino library for ESP8266/ESP32 WLAN configuration at run time with web interface. Overview \u00b6 To the dynamic configuration for joining to WLAN with SSID and PSK accordingly. It an Arduino library united with ESP8266WebServer class for ESP8266 or WebServer class for ESP32. Easy implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi connection. With this library to make a sketch easily which connects from ESP8266/ESP32 to the access point at runtime by the web interface without hard-coded SSID and password. No need pre-coded SSID & password \u00b6 It is no needed hard-coding in advance the SSID and Password into the sketch to connect between ESP8266/ESP32 and WLAN. You can input SSID & Password from a smartphone via the web interface at runtime. Simple usage \u00b6 AutoConnect control screen will be displayed automatically for establishing new connections. It aids by the captive portal when vested the connection cannot be detected. By using the AutoConnect menu , to manage the connections convenient. Store the established connection \u00b6 The connection authentication data as credentials are saved automatically in the flash of ESP8266/ESP32 and You can select the past SSID from the AutoConnect menu . Easy to embed in \u00b6 AutoConnect can be placed easily in your sketch. It's \" begin \" and \" handleClient \" only. Lives with your sketches \u00b6 The sketches which provide the web page using ESP8266WebServer there is, AutoConnect will not disturb it. AutoConnect can use an already instantiated ESP8266WebServer object, or itself can assign it. This effect also applies to ESP32. The corresponding class for ESP32 will be the WebServer. Easy to add the custom Web pages ENHANCED w/v0.9.7 \u00b6 You can easily add your owned web pages that can consist of representative HTML elements and invoke them from the menu. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. Quick and easy to equip the OTA update feature ENHANCED w/v1.0.0 \u00b6 You can quickly and easily equip the OTA update feature to your sketch and also you can operate the firmware update process via OTA from AutoConnect menu. Installation \u00b6 Requirements \u00b6 Supported hardware \u00b6 Generic ESP8266 modules (applying the ESP8266 Community's Arduino core) Adafruit HUZZAH ESP8266 (ESP-12) ESP-WROOM-02 Heltec WiFi Kit 8 NodeMCU 0.9 (ESP-12) / NodeMCU 1.0 (ESP-12E) Olimex MOD-WIFI-ESP8266 SparkFun Thing SweetPea ESP-210 ESP32Dev Board (applying the Espressif's arduino-esp32 core) SparkFun ESP32 Thing WEMOS LOLIN D32 Ai-Thinker NodeMCU-32S Heltec WiFi Kit 32 M5Stack And other ESP8266/ESP32 modules supported by the Additional Board Manager URLs of the Arduino-IDE. About flash size on the module The AutoConnect sketch size is relatively large. Large flash capacity is necessary. 512Kbyte (4Mbits) flash inclusion module such as ESP-01 is not recommended. Required libraries \u00b6 AutoConnect requires the following environment and libraries. Arduino IDE The current upstream at the 1.8 level or later is needed. Please install from the official Arduino IDE download page . This step is not required if you already have a modern version. ESP8266 Arduino core AutoConnect targets sketches made on the assumption of ESP8266 Community's Arduino core . Stable 2.4.0 or higher required and the latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. Package URL is http://arduino.esp8266.com/stable/package_esp8266com_index.json ESP32 Arduino core Also, to apply AutoConnect to ESP32, the arduino-esp32 core provided by Espressif is needed. Stable 1.0.1 or required and the latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. You can add multiple URLs into Additional Board Manager URLs field, separating them with commas. Package URL is https://dl.espressif.com/dl/package_esp32_index.json for ESP32. Arduino core for ESP32 1.0.3 or later For ESP32, AutoConnect v1.0.0 later is required for arduino-esp32 1.0.3 or later. Additional library (Required) The PageBuilder library to build HTML for ESP8266WebServer is needed. To install the PageBuilder library into your Arduino IDE, you can use the Library Manager . Select the board of ESP8266 series in the Arduino IDE, open the library manager and search keyword ' PageBuilder ' with the topic ' Communication ', then you can see the PageBuilder . The latest version is required 1.3.3 later . 1 Additional library (Optional) By adding the ArduinoJson library, AutoConnect will be able to handle the custom Web pages described with JSON. Since AutoConnect v0.9.7 you can insert user-owned web pages that can consist of representative HTML elements as styled TEXT, INPUT, BUTTON, CHECKBOX, SELECT, SUBMIT and invoke them from the AutoConnect menu. These HTML elements can be added by sketches using the AutoConnect API. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. ArduinoJson is required to use this feature. 2 AutoConnect can work with ArduinoJson both version 5 and version 6 . Install the AutoConnect \u00b6 Clone or download from the AutoConnect GitHub repository . When you select Download, you can import it to Arduino IDE immediately. After downloaded, the AutoConnect-master.zip file will be saved in your download folder. Then in the Arduino IDE, navigate to \"Sketch > Include Library\" . At the top of the drop down list, select the option to \"Add .ZIP Library...\" . Details for Arduino official page . Supported by Library manager. AutoConnect was added to the Arduino IDE library manager. It can be used with the PlatformIO library also. window.onload = function() { Gifffer(); }; Since AutoConnect v0.9.8, PageBuilder v1.3.3 later is required. \u21a9 Using the AutoConnect API natively allows you to sketch custom Web pages without JSON. \u21a9","title":"Overview"},{"location":"index.html#autoconnect-for-esp8266esp32","text":"An Arduino library for ESP8266/ESP32 WLAN configuration at run time with web interface.","title":"AutoConnect for ESP8266/ESP32"},{"location":"index.html#overview","text":"To the dynamic configuration for joining to WLAN with SSID and PSK accordingly. It an Arduino library united with ESP8266WebServer class for ESP8266 or WebServer class for ESP32. Easy implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi connection. With this library to make a sketch easily which connects from ESP8266/ESP32 to the access point at runtime by the web interface without hard-coded SSID and password.","title":"Overview"},{"location":"index.html#no-need-pre-coded-ssid-password","text":"It is no needed hard-coding in advance the SSID and Password into the sketch to connect between ESP8266/ESP32 and WLAN. You can input SSID & Password from a smartphone via the web interface at runtime.","title":" No need pre-coded SSID &amp; password"},{"location":"index.html#simple-usage","text":"AutoConnect control screen will be displayed automatically for establishing new connections. It aids by the captive portal when vested the connection cannot be detected. By using the AutoConnect menu , to manage the connections convenient.","title":" Simple usage"},{"location":"index.html#store-the-established-connection","text":"The connection authentication data as credentials are saved automatically in the flash of ESP8266/ESP32 and You can select the past SSID from the AutoConnect menu .","title":" Store the established connection"},{"location":"index.html#easy-to-embed-in","text":"AutoConnect can be placed easily in your sketch. It's \" begin \" and \" handleClient \" only.","title":" Easy to embed in"},{"location":"index.html#lives-with-your-sketches","text":"The sketches which provide the web page using ESP8266WebServer there is, AutoConnect will not disturb it. AutoConnect can use an already instantiated ESP8266WebServer object, or itself can assign it. This effect also applies to ESP32. The corresponding class for ESP32 will be the WebServer.","title":" Lives with your sketches"},{"location":"index.html#easy-to-add-the-custom-web-pages-enhanced-wv097","text":"You can easily add your owned web pages that can consist of representative HTML elements and invoke them from the menu. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD.","title":" Easy to add the custom Web pages ENHANCED w/v0.9.7"},{"location":"index.html#quick-and-easy-to-equip-the-ota-update-feature-enhanced-wv100","text":"You can quickly and easily equip the OTA update feature to your sketch and also you can operate the firmware update process via OTA from AutoConnect menu.","title":" Quick and easy to equip the OTA update feature ENHANCED w/v1.0.0"},{"location":"index.html#installation","text":"","title":"Installation"},{"location":"index.html#requirements","text":"","title":"Requirements"},{"location":"index.html#supported-hardware","text":"Generic ESP8266 modules (applying the ESP8266 Community's Arduino core) Adafruit HUZZAH ESP8266 (ESP-12) ESP-WROOM-02 Heltec WiFi Kit 8 NodeMCU 0.9 (ESP-12) / NodeMCU 1.0 (ESP-12E) Olimex MOD-WIFI-ESP8266 SparkFun Thing SweetPea ESP-210 ESP32Dev Board (applying the Espressif's arduino-esp32 core) SparkFun ESP32 Thing WEMOS LOLIN D32 Ai-Thinker NodeMCU-32S Heltec WiFi Kit 32 M5Stack And other ESP8266/ESP32 modules supported by the Additional Board Manager URLs of the Arduino-IDE. About flash size on the module The AutoConnect sketch size is relatively large. Large flash capacity is necessary. 512Kbyte (4Mbits) flash inclusion module such as ESP-01 is not recommended.","title":"Supported hardware"},{"location":"index.html#required-libraries","text":"AutoConnect requires the following environment and libraries. Arduino IDE The current upstream at the 1.8 level or later is needed. Please install from the official Arduino IDE download page . This step is not required if you already have a modern version. ESP8266 Arduino core AutoConnect targets sketches made on the assumption of ESP8266 Community's Arduino core . Stable 2.4.0 or higher required and the latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. Package URL is http://arduino.esp8266.com/stable/package_esp8266com_index.json ESP32 Arduino core Also, to apply AutoConnect to ESP32, the arduino-esp32 core provided by Espressif is needed. Stable 1.0.1 or required and the latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. You can add multiple URLs into Additional Board Manager URLs field, separating them with commas. Package URL is https://dl.espressif.com/dl/package_esp32_index.json for ESP32. Arduino core for ESP32 1.0.3 or later For ESP32, AutoConnect v1.0.0 later is required for arduino-esp32 1.0.3 or later. Additional library (Required) The PageBuilder library to build HTML for ESP8266WebServer is needed. To install the PageBuilder library into your Arduino IDE, you can use the Library Manager . Select the board of ESP8266 series in the Arduino IDE, open the library manager and search keyword ' PageBuilder ' with the topic ' Communication ', then you can see the PageBuilder . The latest version is required 1.3.3 later . 1 Additional library (Optional) By adding the ArduinoJson library, AutoConnect will be able to handle the custom Web pages described with JSON. Since AutoConnect v0.9.7 you can insert user-owned web pages that can consist of representative HTML elements as styled TEXT, INPUT, BUTTON, CHECKBOX, SELECT, SUBMIT and invoke them from the AutoConnect menu. These HTML elements can be added by sketches using the AutoConnect API. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. ArduinoJson is required to use this feature. 2 AutoConnect can work with ArduinoJson both version 5 and version 6 .","title":"Required libraries"},{"location":"index.html#install-the-autoconnect","text":"Clone or download from the AutoConnect GitHub repository . When you select Download, you can import it to Arduino IDE immediately. After downloaded, the AutoConnect-master.zip file will be saved in your download folder. Then in the Arduino IDE, navigate to \"Sketch > Include Library\" . At the top of the drop down list, select the option to \"Add .ZIP Library...\" . Details for Arduino official page . Supported by Library manager. AutoConnect was added to the Arduino IDE library manager. It can be used with the PlatformIO library also. window.onload = function() { Gifffer(); }; Since AutoConnect v0.9.8, PageBuilder v1.3.3 later is required. \u21a9 Using the AutoConnect API natively allows you to sketch custom Web pages without JSON. \u21a9","title":"Install the AutoConnect"},{"location":"acelements.html","text":"The elements for the custom Web pages \u00b6 Representative HTML elements for making the custom Web page are provided as AutoConnectElements. AutoConnectButton : Labeled action button AutoConnectCheckbox : Labeled checkbox AutoConnectElement : General tag AutoConnectFile : File uploader AutoConnectInput : Labeled text input box AutoConnectRadio : Labeled radio button AutoConnectSelect : Selection list AutoConnectStyle : Custom CSS code AutoConnectSubmit : Submit button AutoConnectText : Style attributed text Layout on a custom Web page \u00b6 AutoConnect will not actively be involved in the layout of custom Web pages generated from AutoConnectElements. However, each element has an attribute to arrange placement on a custom web page by horizontally or vertically. Custom CSS for a custom Web page \u00b6 All custom Web page styles are limited to the built-in unique CSS embedded in the library code. Direct modification of the CSS affects AutoConnect behavior. You can use dedicated elements to relatively safely modify the style of your custom Web page. The AutoConnectStyle will insert the raw CSS code into the style block in HTML of the custom Web page. Form and AutoConnectElements \u00b6 All AutoConnectElements placed on custom web pages will be contained into one form. Its form is fixed and created by AutoConnect. The form value (usually the text or checkbox you entered) is sent by AutoConnectSubmit using the POST method with HTTP. The post method sends the actual form data which is a query string whose contents are the name and value of AutoConnectElements. You can retrieve the value for the parameter with the sketch from the query string with ESP8266WebServer::arg function or PageArgument class of the AutoConnect::on handler when the form is submitted. AutoConnectElement - A basic class of elements \u00b6 AutoConnectElement is a base class for other element classes and has common attributes for all elements. It can also be used as a variant of each element. The following items are attributes that AutoConnectElement has and are common to other elements. Sample AutoConnectElement element(\"element\", \"<hr>\"); On the page: Constructor \u00b6 AutoConnectElement( const char * name, const char * value, const ACPosterior_t post) name \u00b6 Each element has a name. The name is the String data type. You can identify each element by the name to access it with sketches. value \u00b6 The value is the string which is a source to generate an HTML code. Characteristics of Value vary depending on the element. The value of AutoConnectElement is native HTML code. A string of value is output as HTML as it is. post \u00b6 The post specifies a tag to add behind the HTML code generated from the element. Its purpose is to place elements on the custom Web page as intended by the user sketch. AutoConnect will not actively be involved in the layout of custom Web pages generated from AutoConnectElements. Each element follows behind the previous one, with the exception of some elements. You can use the post value to arrange vertically or horizontal when the elements do not have the intended position on the custom Web Page specifying the following enumeration value as ACPosterior_t type for the post . AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. The default interpretation of the post value is specific to each element. AutoConnectElements Default interpretation of the post value AutoConnectElement AC_Tag_None AutoConnectButton AC_Tag_None AutoConnectCheckBox AC_Tag_BR AutoConnectFile AC_Tag_BR AutoConnectInput AC_Tag_BR AutoConnectRadio AC_Tag_BR AutoConnectSelect AC_Tag_BR AutoConnectSubmit AC_Tag_None AutoConnectText AC_Tag_None type \u00b6 The type indicates the type of the element and represented as the ACElement_t enumeration type in the sketch. Since AutoConnectElement also acts as a variant of other elements, it can be applied to handle elements collectively. At that time, the type can be referred to by the typeOf() function. The following example changes the font color of all AutoConnectText elements of a custom Web page to gray. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.typeOf() == AC_Text) { AutoConnectText & text = reinterpret_cast < AutoConnectText &> (elm); text.style = \"color:gray;\" ; } } The enumerators for ACElement_t are as follows: AutoConnectButton: AC_Button AutoConnectCheckbox: AC_Checkbox AutoConnectElement: AC_Element AutoConnectFile: AC_File AutoConnectInput: AC_Input AutoConnectRadio: AC_Radio AutoConnectSelect: AC_Select AutoConnectStyle: AC_Style AutoConnectSubmit: AC_Submit AutoConnectText: AC_Text Uninitialized element: AC_Unknown Furthermore, to convert an entity that is not an AutoConnectElement to its native type, you must re-interpret that type with c++. Or, you can be coding the sketch more easily with using the as<T> function. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.type() == AC_Text) { AutoConnectText & text = customPage[elm.name].as < AutoConnectText > (); text.style = \"color:gray;\" ; // Or, it is also possible to write the code further reduced as follows. // customPage[elm.name].as<AutoConnectText>().style = \"color:gray;\"; } } AutoConnectButton \u00b6 AutoConnectButton generates an HTML < button type = \"button\" > tag and locates a clickable button to a custom Web page. Currently AutoConnectButton corresponds only to name, value, an onclick attribute of HTML button tag. An onclick attribute is generated from an action member variable of the AutoConnectButton, which is mostly used with a JavaScript to activate a script. Sample AutoConnectButton button(\"button\", \"OK\", \"myFunction()\"); On the page: Constructor \u00b6 AutoConnectButton( const char * name, const char * value, const String & action, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectButton element and matches the name attribute of the button tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a value of the value attribute of an HTML button tag. action \u00b6 action is String data type and is an onclick attribute fire on a mouse click on the element. It is mostly used with a JavaScript to activate a script. 1 For example, the following code defines a custom Web page that copies a content of Text1 to Text2 by clicking Button . const char * scCopyText = R\"( <script> function CopyText() { document.getElementById(\"Text2\").value = document.getElementById(\"Text1\").value; } </script> )\" ; ACInput(Text1, \"Text1\" ); ACInput(Text2, \"Text2\" ); ACButton(Button, \"COPY\" , \"CopyText()\" ); ACElement(TextCopy, scCopyText); post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None . AutoConnectCheckbox \u00b6 AutoConnectCheckbox generates an HTML < input type = \"checkbox\" > tag and a < label > tag. It places horizontally on a custom Web page by default. Sample AutoConnectCheckbox checkbox(\"checkbox\", \"uniqueapid\", \"Use APID unique\", false); On the page: Constructor \u00b6 AutoConnectCheckbox( const char * name, const char * value, const char * label, const bool checked, const ACPosition_t labelPosition, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectCheckbox element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a value of the value attribute of an HTML < input type = \"checkbox\" > tag. label \u00b6 A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML <label> tag with an id attribute. The checkbox and the label are connected by the id attribute. Only will be displayed if a label is not specified. checked \u00b6 A checked is a Boolean value and indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent. labelPosition \u00b6 The position of the label belonging to the checkbox can be specified around the element. The labelPosition specifies the position of the label to generate with ACPostion_t enumeration value. The default value is AC_Behind . AC_Infront : Place a label in front of the check box. AC_Behind : Place a label behind the check box. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectFile \u00b6 AutoConnectFile generates an HTML < input type = \"file\" > tag and a < label > tag. AutoConnectFile enables file upload from the client through the web browser to ESP8266/ESP32 module. You can select the flash in the module, external SD device or any output destination as the storage of the uploaded file. Sample AutoConnectFile file(\"file\", \"\", \"Upload:\", AC_File_FS) On the page: Constructor \u00b6 AutoConnectFile( const char * name, const char * value, const char * label, const ACFile_t store, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectFile element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 File name to be upload. The value contains the value entered by the client browser to the < input type = \"file\" > tag and is read-only. Even If you give a value to the constructor, it does not affect as an initial value like a default file name. label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. store \u00b6 Specifies the destination to save the uploaded file. The destination can be specified the following values \u200b\u200bin the ACFile_t enumeration type. AC_File_FS : Save as the SPIFFS file in flash of ESP8266/ESP32 module. AC_File_SD : Save to an external SD device connected to ESP8266/ESP32 module. AC_File_Extern : Pass the content of the uploaded file to the uploader which is declared by the sketch individually. Its uploader must inherit AutoConnectUploadHandler class and implements _open , _write and _close function. Built-in uploader is ready. AutoConnect already equips the built-in uploader for saving to the SPIFFS as AC_File_FS and the external SD as AC_File_SD. It is already implemented inside AutoConnect and will store uploaded file automatically. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectInput \u00b6 AutoConnectInput generates an HTML < input type = \"text\" > tag and a < label > tag. It can also have a placeholder. The value of the input box is passed to the destination in the query string and can be retrieved programmatically. You can also update from the sketches. Sample AutoConnectInput input(\"input\", \"\", \"Server\", \"MQTT broker server\"); On the page: Constructor \u00b6 AutoConnectInput( const char * name, const char * value, const char * label, const char * pattern, const char * placeholder, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectInput element and matches the name attribute, the id attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a string value of the value attribute of an HTML < input type = \"text\" > tag. The text entered from the custom Web page will be grouped in the query string of the form submission and the string set before accessing the page will be displayed as the initial value. label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. pattern \u00b6 A pattern specifies a regular expression that the AutoConnectInput element's value is checked against on form submission. If it is invalid, the background color will change, but it will be sent even if the data format does not match. To check whether the entered value matches the pattern, use the isValid function. The password that must contain 8 or more characters that are of at least one number, and one uppercase and lowercase letter: (?=.*\\d)(?=.*[a-z])(?=.*[A-Z]).{8,} Email address as characters@characters.domain : [a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,} IP address: (([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5]) Host name of Internet: (([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9]) Date (MM/DD/YYYY) as range 1900-2099: (0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d Twitter account: ^@?(\\w){1,15}$ placeholder \u00b6 A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectRadio \u00b6 AutoConnectRadio generates few HTML < input type = \"radio\" > tags as grouped and the same number of < label > tags. AutoConnectRadio can keep the value of a radio button as a collection. The grouped values will be placed in the custom Web page to select only one exclusively. Sample AutoConnectRadio radio(\"radio\", { \"30 sec.\", \"60 sec.\", \"180 sec.\" }, \"Update period\", AC_Vertical, 1); On the page: Constructor \u00b6 AutoConnectRadio( const char * name, std :: vector < String > const & values, const char * label, const ACArrange_t order, const uint8_t checked, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectRadio element and matches the name attribute of the input tags. It also becomes the parameter name of the query string when submitted. values \u00b6 A values is an array of String type for the radio button options which as actually std::vector . It is an initialization list can be used. The input tags will be generated from each entry in the values, the amount of which is the same as the number of items in values . label \u00b6 A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Specification of a label will generate an HTML < label > tag with an id attribute. The radio buttons and the label are connected by the id attribute. order \u00b6 A order specifies the direction to arrange the radio buttons. It is a value of type ACArrange_t and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. A label will place in the left or the top according to the order . checked \u00b6 A checked specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectStyle \u00b6 AutoConnectStyle inserts the string given by the value into the style block of a custom Web page as it is raw. The validity as CSS will not be checked AutoConnectStyle does not do syntax checking and semantic analysis of value. Insert the specified string into the style block of the custom Web page without processing it. Therefore, specifying the wrong CSS will modulate the behavior of the custom Web page. Constructor \u00b6 AutoConnectStyle( const char * name, const char * value) name \u00b6 It is the name of the AutoConnectStyle element and is useful only to access this element from the sketch. It does not affect the generated HTML code. value \u00b6 The raw CSS code. It is not necessary to write <style> </style> tags. AutoConnectSelect \u00b6 AutoConnectSelect generates an HTML < select > tag (drop-down list) and few < option > tags. Sample AutoConnectSelect select(\"select\", { String(\"Europe/London\"), String(\"Europe/Berlin\"), String(\"Europe/Helsinki\"), String(\"Europe/Moscow\"), String(\"Asia/Dubai\") }, \"Select TZ name\"); On the page: Constructor \u00b6 AutoConnectSelect( const char * name, std :: vector < String > const & options, const char * label, const uint8_t selected, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectSelect element and matches the name attribute of the select tags. options \u00b6 An options is an array of String type for the options which as actually std::vector for an HTML < option > tag. It is an initialization list can be used. The option tags will be generated from each entry in the options, the amount of which is the same as the number of items in an options . label \u00b6 A label is an optional string. A label is always arranged on the left side of the drop-down list. Specification of a label will generate an HTML < label > tag with an id attribute. The select tag and the label are connected by the id attribute. selected \u00b6 A selected is an optional value. Specifies that an option should be pre-selected when the page loads. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectSubmit \u00b6 AutoConnectSubmit generates an HTML < input type = \"button\" > tag attached onclick attribute. The native code of the onclick attribute is the submission of the form with the POST method. Sample AutoConnectSubmit submit(\"submit\", \"Save\", \"/mqtt_save\"); On the page: Constructor \u00b6 AutoConnectSubmit( const char * name, const char * value, const char * uri, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectSubmit element and matches the name attribute of the input tag. value \u00b6 It becomes a string of the value attribute of an HTML < input type = \"button\" > tag. The value will be displayed as a label of the button. uri \u00b6 A uri specifies the URI to send form data when the button declared by AutoConnectSubmit is clicked. The query string of the form data sent with AutoConnectSubmit contains the URI of the page. Its parameter name is _acuri . In Sketch, you can know the called URI by referring to the _acuri parameter with the destination page handler. The actual query string is as follows: _acuri= CALLER_URI post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None . AutoConnectText \u00b6 AutoConnectText generates an HTML < div > tag. A style attribute will be attached if a style parameter is passed. Sample AutoConnectText text(\"text\", \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\", \"font-family:serif;color:#4682b4;\"); On the page: Constructor \u00b6 AutoConnectText( const char * name, const char * value, const char * style, const char * format, const ACPosterior_t post) name \u00b6 A name does not exist in the generated HTML. It provides only a means of accessing elements with the sketches. value \u00b6 It becomes content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style \u00b6 A style specifies the qualification style to give to the content and can use the style attribute format as it is. format \u00b6 A format is a pointer to a null-terminated multi byte string specifying how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to C-style printf library functions, but depends on the Espressif's SDK implementation. The conversion specification is valid only in %s format. (Left and Right justification, width are also valid.) post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None . How to coding for the elements \u00b6 Declaration for the elements in Sketches \u00b6 Variables of each AutoConnetElement can be declared with macros. By using the macros, you can treat element name that is String type as variable in sketches. 2 ACElement ( name [ , value ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACButton ( name [ , value ] [ , action ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACCheckbox ( name [ , value ] [ , label ] [ , true | false ] [ , AC_Infront | AC_Behind ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACFile ( name [ , value ] [ , label ] [ , AC_File_FS | AC_File_SD | AC_File_Extern ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACInput ( name [ , value ] [ , label ] [ , pattern ] [ , placeholder ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACRadio ( name [ , values ] [ , label ] [ , AC_Horizontal | AC_Vertical ] [ , checked ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACSelect ( name [ , options ] [ , label ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACStyle ( name [ , value ] ) ACSubmit ( name [ , value ] [ , uri ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACText ( name [ , value ] [ , style ] [ , format ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) Declaration macro usage For example, AutoConnectText can be declared using macros. AutoConnectText caption( \"caption\" , \"hello, world\" , \"color:blue;\" ) equals by using ACText macro. ACText(caption, \"hello, world\" , \"color:blue;\" ) Variant for AutoConnectElements \u00b6 Some AutoConnectAux APIs specify AutoConnectElements as an argument. There are also functions that return a pointer to AutoConnectElements. AutoConnectElement behaves as a variant type of each element class to make these interfaces a single. Use reinterpret_cast to cast from a variant pointer to an Actual type pointer of AutoConnectElements. AutoConnectAux aux; ACText(Text1, \"hello, world\" ); aux.add(Text1); AutoConnectText * text_p = reinterpret_cast < AutoConnectText *> (aux.getElement( \"Text1\" )); AutoConnectText & text = aux.getElement < AutoConnectText > ( \"Text1\" ); JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9 The square brackets in the syntax are optional parameters, the stroke is a selection parameter, the bold fonts are literal. \u21a9","title":"AutoConnectElements"},{"location":"acelements.html#the-elements-for-the-custom-web-pages","text":"Representative HTML elements for making the custom Web page are provided as AutoConnectElements. AutoConnectButton : Labeled action button AutoConnectCheckbox : Labeled checkbox AutoConnectElement : General tag AutoConnectFile : File uploader AutoConnectInput : Labeled text input box AutoConnectRadio : Labeled radio button AutoConnectSelect : Selection list AutoConnectStyle : Custom CSS code AutoConnectSubmit : Submit button AutoConnectText : Style attributed text","title":"The elements for the custom Web pages"},{"location":"acelements.html#layout-on-a-custom-web-page","text":"AutoConnect will not actively be involved in the layout of custom Web pages generated from AutoConnectElements. However, each element has an attribute to arrange placement on a custom web page by horizontally or vertically.","title":"Layout on a custom Web page"},{"location":"acelements.html#custom-css-for-a-custom-web-page","text":"All custom Web page styles are limited to the built-in unique CSS embedded in the library code. Direct modification of the CSS affects AutoConnect behavior. You can use dedicated elements to relatively safely modify the style of your custom Web page. The AutoConnectStyle will insert the raw CSS code into the style block in HTML of the custom Web page.","title":"Custom CSS for a custom Web page"},{"location":"acelements.html#form-and-autoconnectelements","text":"All AutoConnectElements placed on custom web pages will be contained into one form. Its form is fixed and created by AutoConnect. The form value (usually the text or checkbox you entered) is sent by AutoConnectSubmit using the POST method with HTTP. The post method sends the actual form data which is a query string whose contents are the name and value of AutoConnectElements. You can retrieve the value for the parameter with the sketch from the query string with ESP8266WebServer::arg function or PageArgument class of the AutoConnect::on handler when the form is submitted.","title":"Form and AutoConnectElements"},{"location":"acelements.html#autoconnectelement-a-basic-class-of-elements","text":"AutoConnectElement is a base class for other element classes and has common attributes for all elements. It can also be used as a variant of each element. The following items are attributes that AutoConnectElement has and are common to other elements. Sample AutoConnectElement element(\"element\", \"<hr>\"); On the page:","title":"AutoConnectElement - A basic class of elements"},{"location":"acelements.html#constructor","text":"AutoConnectElement( const char * name, const char * value, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name","text":"Each element has a name. The name is the String data type. You can identify each element by the name to access it with sketches.","title":" name"},{"location":"acelements.html#value","text":"The value is the string which is a source to generate an HTML code. Characteristics of Value vary depending on the element. The value of AutoConnectElement is native HTML code. A string of value is output as HTML as it is.","title":" value"},{"location":"acelements.html#post","text":"The post specifies a tag to add behind the HTML code generated from the element. Its purpose is to place elements on the custom Web page as intended by the user sketch. AutoConnect will not actively be involved in the layout of custom Web pages generated from AutoConnectElements. Each element follows behind the previous one, with the exception of some elements. You can use the post value to arrange vertically or horizontal when the elements do not have the intended position on the custom Web Page specifying the following enumeration value as ACPosterior_t type for the post . AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. The default interpretation of the post value is specific to each element. AutoConnectElements Default interpretation of the post value AutoConnectElement AC_Tag_None AutoConnectButton AC_Tag_None AutoConnectCheckBox AC_Tag_BR AutoConnectFile AC_Tag_BR AutoConnectInput AC_Tag_BR AutoConnectRadio AC_Tag_BR AutoConnectSelect AC_Tag_BR AutoConnectSubmit AC_Tag_None AutoConnectText AC_Tag_None","title":" post"},{"location":"acelements.html#type","text":"The type indicates the type of the element and represented as the ACElement_t enumeration type in the sketch. Since AutoConnectElement also acts as a variant of other elements, it can be applied to handle elements collectively. At that time, the type can be referred to by the typeOf() function. The following example changes the font color of all AutoConnectText elements of a custom Web page to gray. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.typeOf() == AC_Text) { AutoConnectText & text = reinterpret_cast < AutoConnectText &> (elm); text.style = \"color:gray;\" ; } } The enumerators for ACElement_t are as follows: AutoConnectButton: AC_Button AutoConnectCheckbox: AC_Checkbox AutoConnectElement: AC_Element AutoConnectFile: AC_File AutoConnectInput: AC_Input AutoConnectRadio: AC_Radio AutoConnectSelect: AC_Select AutoConnectStyle: AC_Style AutoConnectSubmit: AC_Submit AutoConnectText: AC_Text Uninitialized element: AC_Unknown Furthermore, to convert an entity that is not an AutoConnectElement to its native type, you must re-interpret that type with c++. Or, you can be coding the sketch more easily with using the as<T> function. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.type() == AC_Text) { AutoConnectText & text = customPage[elm.name].as < AutoConnectText > (); text.style = \"color:gray;\" ; // Or, it is also possible to write the code further reduced as follows. // customPage[elm.name].as<AutoConnectText>().style = \"color:gray;\"; } }","title":" type"},{"location":"acelements.html#autoconnectbutton","text":"AutoConnectButton generates an HTML < button type = \"button\" > tag and locates a clickable button to a custom Web page. Currently AutoConnectButton corresponds only to name, value, an onclick attribute of HTML button tag. An onclick attribute is generated from an action member variable of the AutoConnectButton, which is mostly used with a JavaScript to activate a script. Sample AutoConnectButton button(\"button\", \"OK\", \"myFunction()\"); On the page:","title":"AutoConnectButton"},{"location":"acelements.html#constructor_1","text":"AutoConnectButton( const char * name, const char * value, const String & action, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_1","text":"It is the name of the AutoConnectButton element and matches the name attribute of the button tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_1","text":"It becomes a value of the value attribute of an HTML button tag.","title":" value"},{"location":"acelements.html#action","text":"action is String data type and is an onclick attribute fire on a mouse click on the element. It is mostly used with a JavaScript to activate a script. 1 For example, the following code defines a custom Web page that copies a content of Text1 to Text2 by clicking Button . const char * scCopyText = R\"( <script> function CopyText() { document.getElementById(\"Text2\").value = document.getElementById(\"Text1\").value; } </script> )\" ; ACInput(Text1, \"Text1\" ); ACInput(Text2, \"Text2\" ); ACButton(Button, \"COPY\" , \"CopyText()\" ); ACElement(TextCopy, scCopyText);","title":" action"},{"location":"acelements.html#post_1","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None .","title":" post"},{"location":"acelements.html#autoconnectcheckbox","text":"AutoConnectCheckbox generates an HTML < input type = \"checkbox\" > tag and a < label > tag. It places horizontally on a custom Web page by default. Sample AutoConnectCheckbox checkbox(\"checkbox\", \"uniqueapid\", \"Use APID unique\", false); On the page:","title":"AutoConnectCheckbox"},{"location":"acelements.html#constructor_2","text":"AutoConnectCheckbox( const char * name, const char * value, const char * label, const bool checked, const ACPosition_t labelPosition, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_2","text":"It is the name of the AutoConnectCheckbox element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_2","text":"It becomes a value of the value attribute of an HTML < input type = \"checkbox\" > tag.","title":" value"},{"location":"acelements.html#label","text":"A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML <label> tag with an id attribute. The checkbox and the label are connected by the id attribute. Only will be displayed if a label is not specified.","title":" label"},{"location":"acelements.html#checked","text":"A checked is a Boolean value and indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent.","title":" checked"},{"location":"acelements.html#labelposition","text":"The position of the label belonging to the checkbox can be specified around the element. The labelPosition specifies the position of the label to generate with ACPostion_t enumeration value. The default value is AC_Behind . AC_Infront : Place a label in front of the check box. AC_Behind : Place a label behind the check box.","title":" labelPosition"},{"location":"acelements.html#post_2","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectfile","text":"AutoConnectFile generates an HTML < input type = \"file\" > tag and a < label > tag. AutoConnectFile enables file upload from the client through the web browser to ESP8266/ESP32 module. You can select the flash in the module, external SD device or any output destination as the storage of the uploaded file. Sample AutoConnectFile file(\"file\", \"\", \"Upload:\", AC_File_FS) On the page:","title":"AutoConnectFile"},{"location":"acelements.html#constructor_3","text":"AutoConnectFile( const char * name, const char * value, const char * label, const ACFile_t store, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_3","text":"It is the name of the AutoConnectFile element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_3","text":"File name to be upload. The value contains the value entered by the client browser to the < input type = \"file\" > tag and is read-only. Even If you give a value to the constructor, it does not affect as an initial value like a default file name.","title":" value"},{"location":"acelements.html#label_1","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#store","text":"Specifies the destination to save the uploaded file. The destination can be specified the following values \u200b\u200bin the ACFile_t enumeration type. AC_File_FS : Save as the SPIFFS file in flash of ESP8266/ESP32 module. AC_File_SD : Save to an external SD device connected to ESP8266/ESP32 module. AC_File_Extern : Pass the content of the uploaded file to the uploader which is declared by the sketch individually. Its uploader must inherit AutoConnectUploadHandler class and implements _open , _write and _close function. Built-in uploader is ready. AutoConnect already equips the built-in uploader for saving to the SPIFFS as AC_File_FS and the external SD as AC_File_SD. It is already implemented inside AutoConnect and will store uploaded file automatically.","title":" store"},{"location":"acelements.html#post_3","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectinput","text":"AutoConnectInput generates an HTML < input type = \"text\" > tag and a < label > tag. It can also have a placeholder. The value of the input box is passed to the destination in the query string and can be retrieved programmatically. You can also update from the sketches. Sample AutoConnectInput input(\"input\", \"\", \"Server\", \"MQTT broker server\"); On the page:","title":"AutoConnectInput"},{"location":"acelements.html#constructor_4","text":"AutoConnectInput( const char * name, const char * value, const char * label, const char * pattern, const char * placeholder, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_4","text":"It is the name of the AutoConnectInput element and matches the name attribute, the id attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_4","text":"It becomes a string value of the value attribute of an HTML < input type = \"text\" > tag. The text entered from the custom Web page will be grouped in the query string of the form submission and the string set before accessing the page will be displayed as the initial value.","title":" value"},{"location":"acelements.html#label_2","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#pattern","text":"A pattern specifies a regular expression that the AutoConnectInput element's value is checked against on form submission. If it is invalid, the background color will change, but it will be sent even if the data format does not match. To check whether the entered value matches the pattern, use the isValid function. The password that must contain 8 or more characters that are of at least one number, and one uppercase and lowercase letter: (?=.*\\d)(?=.*[a-z])(?=.*[A-Z]).{8,} Email address as characters@characters.domain : [a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,} IP address: (([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5]) Host name of Internet: (([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9]) Date (MM/DD/YYYY) as range 1900-2099: (0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d Twitter account: ^@?(\\w){1,15}$","title":" pattern"},{"location":"acelements.html#placeholder","text":"A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag.","title":" placeholder"},{"location":"acelements.html#post_4","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectradio","text":"AutoConnectRadio generates few HTML < input type = \"radio\" > tags as grouped and the same number of < label > tags. AutoConnectRadio can keep the value of a radio button as a collection. The grouped values will be placed in the custom Web page to select only one exclusively. Sample AutoConnectRadio radio(\"radio\", { \"30 sec.\", \"60 sec.\", \"180 sec.\" }, \"Update period\", AC_Vertical, 1); On the page:","title":"AutoConnectRadio"},{"location":"acelements.html#constructor_5","text":"AutoConnectRadio( const char * name, std :: vector < String > const & values, const char * label, const ACArrange_t order, const uint8_t checked, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_5","text":"It is the name of the AutoConnectRadio element and matches the name attribute of the input tags. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#values","text":"A values is an array of String type for the radio button options which as actually std::vector . It is an initialization list can be used. The input tags will be generated from each entry in the values, the amount of which is the same as the number of items in values .","title":" values"},{"location":"acelements.html#label_3","text":"A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Specification of a label will generate an HTML < label > tag with an id attribute. The radio buttons and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#order","text":"A order specifies the direction to arrange the radio buttons. It is a value of type ACArrange_t and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. A label will place in the left or the top according to the order .","title":" order"},{"location":"acelements.html#checked_1","text":"A checked specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked.","title":" checked"},{"location":"acelements.html#post_5","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectstyle","text":"AutoConnectStyle inserts the string given by the value into the style block of a custom Web page as it is raw. The validity as CSS will not be checked AutoConnectStyle does not do syntax checking and semantic analysis of value. Insert the specified string into the style block of the custom Web page without processing it. Therefore, specifying the wrong CSS will modulate the behavior of the custom Web page.","title":"AutoConnectStyle"},{"location":"acelements.html#constructor_6","text":"AutoConnectStyle( const char * name, const char * value)","title":" Constructor"},{"location":"acelements.html#name_6","text":"It is the name of the AutoConnectStyle element and is useful only to access this element from the sketch. It does not affect the generated HTML code.","title":" name"},{"location":"acelements.html#value_5","text":"The raw CSS code. It is not necessary to write <style> </style> tags.","title":" value"},{"location":"acelements.html#autoconnectselect","text":"AutoConnectSelect generates an HTML < select > tag (drop-down list) and few < option > tags. Sample AutoConnectSelect select(\"select\", { String(\"Europe/London\"), String(\"Europe/Berlin\"), String(\"Europe/Helsinki\"), String(\"Europe/Moscow\"), String(\"Asia/Dubai\") }, \"Select TZ name\"); On the page:","title":"AutoConnectSelect"},{"location":"acelements.html#constructor_7","text":"AutoConnectSelect( const char * name, std :: vector < String > const & options, const char * label, const uint8_t selected, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_7","text":"It is the name of the AutoConnectSelect element and matches the name attribute of the select tags.","title":" name"},{"location":"acelements.html#options","text":"An options is an array of String type for the options which as actually std::vector for an HTML < option > tag. It is an initialization list can be used. The option tags will be generated from each entry in the options, the amount of which is the same as the number of items in an options .","title":" options"},{"location":"acelements.html#label_4","text":"A label is an optional string. A label is always arranged on the left side of the drop-down list. Specification of a label will generate an HTML < label > tag with an id attribute. The select tag and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#selected","text":"A selected is an optional value. Specifies that an option should be pre-selected when the page loads.","title":" selected"},{"location":"acelements.html#post_6","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectsubmit","text":"AutoConnectSubmit generates an HTML < input type = \"button\" > tag attached onclick attribute. The native code of the onclick attribute is the submission of the form with the POST method. Sample AutoConnectSubmit submit(\"submit\", \"Save\", \"/mqtt_save\"); On the page:","title":"AutoConnectSubmit"},{"location":"acelements.html#constructor_8","text":"AutoConnectSubmit( const char * name, const char * value, const char * uri, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_8","text":"It is the name of the AutoConnectSubmit element and matches the name attribute of the input tag.","title":" name"},{"location":"acelements.html#value_6","text":"It becomes a string of the value attribute of an HTML < input type = \"button\" > tag. The value will be displayed as a label of the button.","title":" value"},{"location":"acelements.html#uri","text":"A uri specifies the URI to send form data when the button declared by AutoConnectSubmit is clicked. The query string of the form data sent with AutoConnectSubmit contains the URI of the page. Its parameter name is _acuri . In Sketch, you can know the called URI by referring to the _acuri parameter with the destination page handler. The actual query string is as follows: _acuri= CALLER_URI","title":" uri"},{"location":"acelements.html#post_7","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None .","title":" post"},{"location":"acelements.html#autoconnecttext","text":"AutoConnectText generates an HTML < div > tag. A style attribute will be attached if a style parameter is passed. Sample AutoConnectText text(\"text\", \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\", \"font-family:serif;color:#4682b4;\"); On the page:","title":"AutoConnectText"},{"location":"acelements.html#constructor_9","text":"AutoConnectText( const char * name, const char * value, const char * style, const char * format, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_9","text":"A name does not exist in the generated HTML. It provides only a means of accessing elements with the sketches.","title":" name"},{"location":"acelements.html#value_7","text":"It becomes content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag.","title":" value"},{"location":"acelements.html#style","text":"A style specifies the qualification style to give to the content and can use the style attribute format as it is.","title":" style"},{"location":"acelements.html#format","text":"A format is a pointer to a null-terminated multi byte string specifying how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to C-style printf library functions, but depends on the Espressif's SDK implementation. The conversion specification is valid only in %s format. (Left and Right justification, width are also valid.)","title":" format"},{"location":"acelements.html#post_8","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None .","title":" post"},{"location":"acelements.html#how-to-coding-for-the-elements","text":"","title":"How to coding for the elements"},{"location":"acelements.html#declaration-for-the-elements-in-sketches","text":"Variables of each AutoConnetElement can be declared with macros. By using the macros, you can treat element name that is String type as variable in sketches. 2 ACElement ( name [ , value ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACButton ( name [ , value ] [ , action ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACCheckbox ( name [ , value ] [ , label ] [ , true | false ] [ , AC_Infront | AC_Behind ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACFile ( name [ , value ] [ , label ] [ , AC_File_FS | AC_File_SD | AC_File_Extern ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACInput ( name [ , value ] [ , label ] [ , pattern ] [ , placeholder ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACRadio ( name [ , values ] [ , label ] [ , AC_Horizontal | AC_Vertical ] [ , checked ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACSelect ( name [ , options ] [ , label ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACStyle ( name [ , value ] ) ACSubmit ( name [ , value ] [ , uri ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACText ( name [ , value ] [ , style ] [ , format ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) Declaration macro usage For example, AutoConnectText can be declared using macros. AutoConnectText caption( \"caption\" , \"hello, world\" , \"color:blue;\" ) equals by using ACText macro. ACText(caption, \"hello, world\" , \"color:blue;\" )","title":" Declaration for the elements in Sketches"},{"location":"acelements.html#variant-for-autoconnectelements","text":"Some AutoConnectAux APIs specify AutoConnectElements as an argument. There are also functions that return a pointer to AutoConnectElements. AutoConnectElement behaves as a variant type of each element class to make these interfaces a single. Use reinterpret_cast to cast from a variant pointer to an Actual type pointer of AutoConnectElements. AutoConnectAux aux; ACText(Text1, \"hello, world\" ); aux.add(Text1); AutoConnectText * text_p = reinterpret_cast < AutoConnectText *> (aux.getElement( \"Text1\" )); AutoConnectText & text = aux.getElement < AutoConnectText > ( \"Text1\" ); JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9 The square brackets in the syntax are optional parameters, the stroke is a selection parameter, the bold fonts are literal. \u21a9","title":" Variant for AutoConnectElements"},{"location":"achandling.html","text":"Page, Container, Component \u00b6 AutoConnectAux is the container for a custom Web page, AutoConnectElement is the component of a page. AutoConnectElements must be contained in AutoConnectAux object. (ie. they are the elements displayed on the custom Web page.) Then AutoConnect makes an AutoConnectAux to a page. AutoConnectElements declared in sketch must be programmed to add to AutoConnectAux one after another. Elements are automatically included in AutoConnectAux by AutoConnect if you load it from the JSON document. In either method, it is common to use the function of AutoConnectAux to access an element with a sketch. Handing AutoConnectElements with the sketches \u00b6 The AutoConnectAux class has several functions to manipulate AutoConnectElements. The functions can add, delete, retrieve elements, and get and set values. Add AutoConnectElements to the AutoConnectAux object \u00b6 To add AutoConnectElment(s) to an AutoConnectAux object, use the add function. void AutoConnectAux :: add(AutoConnectElement & addon) void AutoConnectAux :: add(AutoConnectElementVT addons) The add function adds the specified AutoConnectElement to AutoConnectAux. The AutoConnectElementVT type is the std::vector of the reference wrapper to AutoConnectElements, and you can add these elements in bulk by using the list initialization with the sketch. typedef std :: vector < std :: reference_wrapper < AutoConnectElement >> AutoConnectElementVT; AutoConnectElements contained in AutoConnectAux object are uniquely identified by name. When adding an AutoConnectElement, if an element with the same name already exists in the AutoConnectAux, checking the type, and if it is the same, the value will be replaced. If another type of AutoConnectElement exists with the same name, that add operation will be invalid. 1 In the following example, AutoConnectButton button addition will invalid because hello with the same name already exists as AutoConnectText. AutoConnectAux aux; AutoConnectText text ( \"hello\" , \"hello, world\" ); AutoConnectButton button ( \"hello\" , \"hello, world\" , \"alert('Hello world!')\") ; // This is invalid. aux.add({ text, button }); Similarly this, the uniqueness of the name is also necessary within the JSON document { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true , \"element\" : [ { \"name\" : \"hello\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"hello\" , \"type\" : \"ACButton\" , \"value\" : \"hello, world\" , \"action\" : \"alert('Hello world!')\" } ] } Load all elements from JSON document If you load all AutoConnectElements from JSON document into AutoConnect, you do not need to sketch the population process of the AutoConnectElements. It is managed by the AutoConnect library automatically. Get AutoConnectElement from the AutoConnectAux \u00b6 To retrieve an element from AutoConnectAux, use the getElement or getElements function. Normally, the getElement is needed when accessing the value of AutoConnectElement in the sketch. AutoConnectElement * AutoConnectAux :: getElement( const String & name) T & AutoConnectAux :: getElement < T > ( const String & name) AutoConnectElementVT * AutoConnectAux :: getElements( void ) The getElement function returns an AutoConnectElement with the specified name as a key. When you use this function, you need to know the type of AutoConnectElement in advance and specify its type <T> to an argument of the getElement. A type of <T> can be specified as follows. AutoConnectButton & AutoConnectAux :: getElement < AutoConnectButton > ( const String & name) AutoConnectCheckbox & AutoConnectAux :: getElement < AutoConnectCheckbox > ( const String & name) AutoConnectElement & AutoConnectAux :: getElement < AutoConnectElement > ( const String & name) AutoConnectFile & AutoConnectAux :: getElement < AutoConnectFile > ( const String & name) AutoConnectInput & AutoConnectAux :: getElement < AutoConnectInput > ( const String & name) AutoConnectRadio & AutoConnectAux :: getElement < AutoConnectRadio > ( const String & name) AutoConnectSelect & AutoConnectAux :: getElement < AutoConnectSelect > ( const String & name) AutoConnectSubmit & AutoConnectAux :: getElement < AutoConnectSubmit > ( const String & name) AutoConnectText & AutoConnectAux :: getElement < AutoConnectText > ( const String & name) To retrieve an AutoConnectElement by specifying its type, use the following method. AutoConnectAux aux; aux.load( \"SOME_JSON_DOCUMENT\" ); // Retrieve the pointer of the AutoConnectText AutoConnectText * text = reinterpret_cast < AutoConnectText *> (aux.getElement( \"TEXT_ELEMENT_NAME\" )); // Retrieve the reference of the AutoConnectText AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_ELEMENT_NAME\" ); The AutoConnectElement type behaves as a variant of other element types. Therefore use cast or template to convert to actual type as above. In the sketch, you access the real type of AutoConnectElement after casting it and storing into the variable. const String auxJson = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); AutoConnect portal; portal.load(auxJson); AutoConnectAux * aux = portal.aux( \"/page1\" ); // Identify the AutoConnectAux instance with uri AutoConnectText & text = aux -> getElement < AutoConnectText > ( \"caption\" ); // Cast to real type and access members Serial.println(text.value); You can also use the operator [] of AutoConnectAux as another way to get the desired element. An operator [] is a shortcut for getElement function with the reference casting and makes simplify the sketch code and treats like an array with the elements placed on a custom Web page. Its argument is the name of the element to be acquired similarly to getElement function. In the sketch, by combining the AutoConnectElement::as<T> function with the operator [] , you can access the AutoConnectElements reference according to its actual type. For example, the following sketch code returns the same as a reference of AutoConnectText element as the caption . AutoConnect portal; portal.load(auxJson); AutoConnectAux & aux = * portal.aux( \"/page1\" ); AutoConnectText & text1 = aux.getElement < AutoConnectElement > ( \"caption\" ); AutoConnectText & text2 = aux[ \"caption\" ].as < AutoConnectText > (); Need cast to convert to the actual type An operator [] returns a reference of an AutoConnectElement. It is necessary to convert the type according to the actual element type with AutoConnectElement::as<T> function. AutoConnectButton & AutoConnectElement :: as < AutoConnectButton > () AutoConnectCheckbox & AutoConnectElement :: as < AutoConnectCheckbox > () AutoConnectElement & AutoConnectElement :: as < AutoConnectElement > () AutoConnectFile & AutoConnectElement :: as < AutoConnectFile > () AutoConnectInput & AutoConnectElement :: as < AutoConnectInput > () AutoConnectRadio & AutoConnectElement :: as < AutoConnectRadio > () AutoConnectSelect & AutoConnectElement :: as < AutoConnectSelect > () AutoConnectSubmit & AutoConnectElement :: as < AutoConnectSubmit > () AutoConnectText & AutoConnectElement :: as < AutoConnectText > () To get all the AutoConnectElements in an AutoConnectAux object use the getElements function. This function returns the vector of the reference wrapper as AutoConnectElementVT to all AutoConnectElements registered in the AutoConnectAux. AutoConnectElementVT & AutoConnectAux :: getElements( void ) Enable AutoConnectElements during the sketch execution \u00b6 AutoConnectElemets have an enable attribute to activate its own HTML generation. Sketches can change the HTMLization of their elements dynamically by setting or resetting the enable value. An element whose the enable attribute is true will generate itself HTML and place on the custom Web page. And conversely, it will not generate the HTML when the value is false. For example, to enable the submit button only when the ESP module is connected to the access point in STA mode, you can sketch the following: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char AUX[] PROGMEM = R( \" { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true, \"element\" : [ { \"name\" : \"input\" , \"type\" : \"ACInput\" , \"label\" : \"Input\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/send\" } ] } \"); AutoConnect portal; AutoConnectAux page; String onPage (AutoConectAux & aux, PageArgument & args) { AutoConnectSubmit & send = aux[ \"send\" ].as < AutoConnectSubmit > (); if (WiFi.isConnected()) send.enable = (WiFi.getMode() == WIFI_STA); else send.enable = false; return String(); } void setup () { page.load(AUX); page.on(onPage); portal.join(page); portal.begin(); } void loop () { portal.handleClient(); } Desirable to set or reset the enable attribute in the page handler The enable attribute can be set at any time during the sketch execution. The page handler with the AC_EXIT_AHEAD option is sure to handle it. Loading & saving AutoConnectElements with JSON \u00b6 AutoConnect supports reading the custom Web page definitions written in JSON and also supports loading and saving of AutoConnectAux or AutoConnectElements. In both cases, the target object is a JSON document for AutoConnect . However, it can not save all AutoConnectElements contained in the page as a custom Web page. (ie. AutoConnectAux) Loading AutoConnectAux & AutoConnectElements with JSON \u00b6 To load a JSON document as AutoConnectAux use the AutoConnect::load function and load the JSON document of each AutoConnectElement using the AutoConnectAux::loadElement function. Although the functions of both are similar, the structure of the target JSON document is different. The AutoConnect::load function loads the entire AutoConnectAux and creates both the AutoConnectAux instance and each AutoConnectElement instance. A single JSON document can contain multiple custom Web pages. If you write JSON of AutoConnectAux as an array, the load function generates all the pages contained in that array. Therefore, it is necessary to supply the JSON document of AutoConnectAux as an input of the load function and must contain the elements described section JSON document structure for AutoConnectAux . The AutoConnectAux::loadElement function loads the elements individually into an AutoConnectAux object. The structure of its supplying JSON document is not AutoConnectAux. It must be a JSON structure for AutoConnectElement , but you can specify an array. // AutoConnectAux as a custom Web page. const char page[] PROGMEM = R\"raw( { \"title\": \"Settings\", \"uri\": \"/settings\", \"menu\": true, \"element\": [ { \"name\": \"server\", \"type\": \"ACInput\", \"label\": \"Server\" }, { \"name\": \"set\", \"type\": \"ACSubmit\", \"value\": \"SET\", \"uri\" : \"/set\" } ] } )raw\" ; // Additional AutoConnectElements. const char addons[] PROGMEM = R\"raw( [ { \"name\": \"notes\", \"type\": \"ACText\", \"value\": \"An update period as the below optionally.\" }, { \"name\": \"period\", \"type\": \"ACRadio\", \"value\": [ \"30 sec.\", \"60 sec.\", \"180 sec.\" ], \"arrange\": \"vertical\", \"checked\": 1 } ] )raw\" ; AutoConnect portal; AutoConnectAux * auxPage; // Load a custom Web page. portal.load(page); // Get a '/settings' page auxPage = portal.aux( \"/settings\" ); // Also, load only AutoConnectRadio named the period. auxPage -> loadElement(addons, \"period\" ); // Retrieve a server name from an AutoConnectText value. AutoConnectText & serverName = auxPage -> getElement < AutoConnectText > ( \"server\" ); Serial.println(serverName.value); Saving AutoConnectElements with JSON \u00b6 To save the AutoConnectAux or the AutoConnectElement as a JSON document, use the AutoConnectAux::saveElement function. It serializes the contents of the object based on the type of the AutoConnectElement. You can persist a serialized AutoConnectElements as a JSON document to a stream. // Open a parameter file on the SPIFFS. SPIFFS.begin(); FILE param = SPIFFS.open( \"/param\" , \"w\" ); // Save elements as the parameters. auxPage -> saveElement(param, { \"server\" , \"period\" }); // Close a parameter file. param.close(); SPIFFS.end(); The example above saves server and period elements from the AutoConnectAux object as mentioned above to the /param file on SPIFFS. Its JSON document of AutoConnectElements saved by its code looks like this: [ { \"name\" : \"server\" , \"type\" : \"ACInput\" , \"value\" : \"An inputted server name\" , \"label\" : \"Server\" , \"placeholder\" : \"\" }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"arrange\" : \"vertical\" , \"checked\" : 2 } ] Above JSON document can be loaded as it is into a custom Web page using the loadElement function. The loadElement function also loads the value of the element, so the saved value can be restored on the custom Web page. Custom field data handling \u00b6 A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored in the member variable of each element by AutoConnect whenever GET/POST transmission occurs. The following diagram shows the flow of the input values of a custom Web page into a sketch and is the basis for actions to manipulate the values of custom Web pages using sketches. Where to pick up the values \u00b6 A sketch composed of handlers can receive the value of AutoConnectElements entered in a custom Web page after sending, but that handler is different from the page where the value was entered. It is necessary to be aware that can accept the entered values by the next page handler after the transition. Usually, two ways to retrieve entered values we have. One is to use the ESP8266WebServer::arg (or WebServer::arg for ESP32) function in the on handler attached by ESP8266WebServer (WebServer w/ESP32 also). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char addonJson[] PROGMEM = R\"raw( { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] } )raw\" ; ESP8266WebServer webServer; AutoConnect portal (webServer); // Here, /feels handler void feelsOn () { // Retrieve the value of a input-box named \"feels\" String feel = webServer.arg( \"feels\" ); // Echo back the value String echo = \"<html><p style= \\\" color:blue;font-family:verdana;font-size:300%; \\\" >\" + feel + String( \" and a bold world!</p></html>\" ); webServer.send( 200 , \"text/html\" , echo); } void setup () { delay( 1000 ); webServer.on( \"/feels\" , feelsOn); // Register /feels handler portal.load(addonJson); // Load a custom Web page portal.begin(); } void loop () { portal.handleClient(); } An above example is the most simple sketch of handling values entered into a custom Web page. This sketch obtains the string entered in the AutoConnectInput named feels with the /feels handler after page transition, and the AutoConnectInput is an <input type=\"text\" name=\"feels\"> element wrapped in the form as the actual HTML code. Should be accessed /_ac first When you actually try the above sketch, there is no a root handler. So the URL that should be accessed first is /_ac concatenated with the local IP address of the esp8266 module. Another method is effective when custom Web pages have complicated page transitions. It is a way to straight access the AutoConnectElements member value. You can get the AutoConnectElement with the specified name using the getElement function. The following sketch executes the above example with AutoConnect only, without using the function of ESP8266WebServer. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> const static char addonJson[] PROGMEM = R\"raw( [ { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] }, { \"title\": \"Hello\", \"uri\": \"/feels\", \"menu\": false, \"element\": [ { \"name\": \"echo\", \"type\": \"ACText\", \"style\": \"color:blue;font-family:verdana;font-size:300%;\" } ] } ] )raw\" ; AutoConnect portal; // Here, /feels handler String feelsOn (AutoConnectAux & aux, PageArgument & args) { // Get the AutoConnectInput named \"feels\". // The where() function returns an uri string of the AutoConnectAux that triggered this handler. AutoConnectAux * hello = portal.aux(portal.where()); AutoConnectInput & feels = hello -> getElement < AutoConnectInput > ( \"feels\" ); // Get the AutoConnectText named \"echo\". AutoConnectText & echo = aux.getElement < AutoConnectText > ( \"echo\" ); // Echo back from input-box to /feels page. echo.value = feels.value + String( \" and a bold world!\" ); return String( \"\" ); } void setup () { delay( 1000 ); portal.load(addonJson); // Load custom Web pages portal.on( \"/feels\" , feelsOn, AC_EXIT_AHEAD); // Register /feels handler portal.begin(); } void loop () { portal.handleClient(); } The above example handles in the handler for the values of a custom Web page. An AutoConnect::on function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the PageArgument object. To retrieve the values entered in a custom Web page you need to access the AutoConnectElement of the page that caused the request to this page and to do this, you use the AutoConnect::where function. The AutoConnect::where function returns an uri string of the AutoConnectAux object of the custom Web page that caused the HTTP request. The where() function is available for only AutoConnectAux. The AutoConnect::where function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/WebServer for ESP32. In other words, the AutoConnect::where function only returns the last AutoConnecAux page called. When setting the initial values \u00b6 An AutoConnectAux page is dynamically created by AutoConnect when its uri is requested. The initial value of AutoConnectElements can be set before its page request. It is also possible during loop() . To set the initial value when the page is accessed it needs by the handler of its page. The AutoConnect::on and AutoConnectAux::on functions register a handler for a custom Web page and also specify when to call that handler. The behavior of the two on functions is the same, only the class and arguments are different. bool AutoConnect :: on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order) void AutoConnectAux :: on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order) Parameter uri specifies an URI of the custom Web page, but an AutoConnectAux object with its URI must be registered with AutoConnect via the AutoConnect::join function beforehand. AutoConnect::on/AutoConnectAux::on is not ESP8266WebServer::on The on function for AutoConnect is different from the on function of Arduino core ESP8266WebServer (WebServer for ESP32). You can share the same handler via wrapper, but access to AutoConnectElements is valid only for handlers registered with on function for AutoConnect . AuxHandlerFunctionT type is a handler declaration using with std::function . String handler(AutoConnectAux & aux, PageArgument & args) The handler of the custom Web page has two arguments by a reference of AutoConnectAux and a reference of PageArgument, it returns String. AutoConnect appends the string returned from the handler to the generated HTML. This allows you to add an HTML part before displaying the page. AutoConnectExitOrder_t specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. The following example is a part of sketch contained the handlers. // AutoConnect object declarations ACInput(input1); AutoConnectAux aux ( \"/aux\" , { input1 }); AutoConnect portal; // Pre-declare handlers String initialize (AutoConnectAux & , PageArgument & ); String append (AutoConnectAux & , PageArgument & ); // Register handlers and launch the portal. aux.on(initialize, AC_AHEAD); aux.on(append, AC_LATER); portal.join(aux); portal.begin(); // Some code here... // The handler called before HTML generating String initialize (AutoConnectAux & aux, PageArgument & args) { AutoConnectInput & input1 = aux.getElement < AutoConnectInput > ( \"input1\" ); // Set initial value for the input box in a custom Web page. input1.value = \"Initial value\" ; // Nothing appendix for a generated HTML. return String(); } // The handler called after HTML generated String append (AutoConnectAux & aux, PageArgument & args) { // Append an HTML return String( \"<p>This text has been added.</p>\" ); } How you can reach the values \u00b6 AutoConnectSubmit uses the POST method to send HTTP requests. A value of AutoConnectInput sent to the ESP8266 or ESP32 with POST is stored in the request body of the HTTP request: POST /feels HTTP/1.1 Host: ESP8266_IP_ADDRESS name1=value1&name2=value2&name3=value3 ESP8266WebServer class will parse the query string and rebuilds its arguments when the above request arrives. A custom page handler registered with the ESP8266WebServer::on function can access the value of AutoConnectElements with ESP8266WebServe::arg function. It reaches the values of AutoConnectElements without the intermediation of AutoConnect. Therefore, its handler will not be AutoConnectAux and can send a response to the client directly. The following example is part of a server sketch which has two web pages. The /hello page is a custom Web page of AutoConnectAux which has an input box named \"input1\". Another /echo page is a page handler for ESP8266WebServer, which uses the ESP8266WebServer::send function to echo back the value of an input1 as an http response. ESP8266WebServer server; AutoConnect portal (server); ACInput(input1, \"\" , \"INPUT\" ); ACSubmit(send, \"HELLO\" , \"/echo\" ); AutoConnectAux aux ( \"/hello\" , { input1, send }); server.on( \"/echo\" , []() { String echo = server.arg( \"input1\" ); Serial.println(echo); server.send( 200 , \"text/plain\" , echo); }); portal.join(aux); portal.begin(); Also, you can choose another way to access arguments without going through the ESP8266WebServer class. The PageArgument object of the custom Web page handler argument is a copy of the arg object of the ESP8266WebServer class. Either of these methods is a simple and easy way to access parameters in custom Web page handlers. However, if you need to access from outside of the handler to the value of AutoConnectElements, you need to accomplish it using with the AutoConnectAux::getElement function. The following sketch code replaces the above example with JSON and PageArgument, and its behaves is equivalent basically to the above sketch. const static char auxPage[] PROGMEM = R\"raw( [ { \"title\":\"Hello\", \"uri\":\"/hello\", \"menu\":true, \"element\":[ { \"name\":\"input1\", \"type\": \"ACInput\", \"label\": \"INPUT\" }, { \"name\":\"send\", \"type\":\"ACSubmit\", \"value\":\"HELLO\", \"uri\":\"/echo\" }] }, { \"title\":\"Echo\", \"uri\":\"/echo\", \"menu\":false, \"element\":[ { \"name\":\"echo\", \"type\":\"ACText\" }] } ] )raw\" ; AutoConnect portal; portal.load(auxPage); portal.on( \"/echo\" , [](AutoConnectAux & aux, PageArgument & args) { AutoConnectText & ac_echo = aux.getElement < AutoConnectText > ( \"echo\" ); ac_echo.value = args.arg( \"input1\" ); return String (); }); portal.begin(); Transfer of input values \u200b\u200bacross pages \u00b6 Since v1.0.0, AutoConnect supports a new attribute with each element that allows automatic transfer of input values across pages without sketching. AutoConnect will copy the input value of the elements declared as global to the same-named global elements on a different custom Web pages at the page transition timing. The global attribute will be useful for echoing input values back to another custom Web pages. This copy operation can be performed between different types. (eg., copy value from AutoConnectInput to AutoConnectText) The following example reflects the input value of PAGE1 to the AutoConnectText field of PAGE2 without sketch code. static const char PAGE1[] PROGMEM = R\"( { \"title\": \"PAGE1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\": \"input1\", \"type\": \"ACInput\", \"global\": true }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"OK\", \"uri\": \"/page2\" } ] } )\" ; static const char PAGE2[] PROGMEM = R\"( { \"title\": \"PAGE2\", \"uri\": \"/page2\", \"menu\": false, \"element\": [ { \"name\": \"input1\", \"type\": \"ACText\", \"global\": true } ] } )\" ; AutoConnect portal; AutoConnectAux page1; AutoConnectAux page2; void setup () { page1.load(PAGE1); page2.load(PAGE2); portal.join( { page1, page2 }); portal.begin(); } void loop () { portal.handleClient(); } The value entered in input1 declared in PAGE1 is reflected in input1 of PAGE2 as an AutoConnectText value even if there is no sketch code to transfer it to PAGE2. It's shown as like: Copy only for same-named and the global The input value will be copied only if the global attribute of the destination element is true. If an element with the same name is declared non-global, the value is not copied. Retrieve the values with WebServer::on handler \u00b6 ESP8266WebServer class and the WebServer class assume that the implementation of the ReqestHandler class contained in the WebServer library will handle the URL requests. Usually, it is sketch code registered by ESP8266WebServer::on function. When a page transition from a custom Web page created by AutoConnectAux to a handler registered with ESP2866WebServer::on function, a little trick is needed to retrieve the values of AutoConnectElements. (i.e. the URI of the ESP8266WebServer::on handler is specified in the uri attribute of AutoConnectSubmit ) AutoConnect cannot intervene in the procedure in which the ESP8266WebServer class calls the on-page handler coded with the sketch. Therefore, it is necessary to retrieve preliminary the values of AutoConnectElements using the AutoConnectAux::fetchElement function for value processing with the on-page handler. The following sketch is an example of extracting values inputted on a custom web page with an on-page handler and then processing it. ESP8266WebServer server; AutoConnect portal (server); AutoConnectAux Input; const static char InputPage[] PROGMEM = R\"r( { \"title\": \"Input\", \"uri\": \"/input\", \"menu\": true, \"element\": [ { \"name\": \"input\", \"type\": \"ACInput\", \"label\": \"INPUT\" }, { \"name\": \"save\", \"type\": \"ACSubmit\", \"value\": \"SAVE\", \"uri\": \"/\" } ] } )r\" ; // An on-page handler for '/' access void onRoot () { String content = \"<html>\" \"<head><meta name='viewport' content='width=device-width, initial-scale=1'></head>\" \"<body><div>INPUT: {{value}}</div></body>\" \"</html>\" ; Input.fetchElement(); // Preliminary acquisition // For this steps to work, need to call fetchElement function beforehand. String value = Input[ \"input\" ].value; content.replace( \"{{value}}\" , value); server.send( 200 , \"text/html\" , content); } void setup () { Input.load(InputPage); portal.join(Input); server.on( \"/\" , onRoot); // Register the on-page handler portal.begin(); } void loop () { portal.handleClient(); } Overwrite the AutoConnectElements \u00b6 Sketches can update the attributes of AutoConnectElements with two approaches. A one is to assign directly to the attributes of a member variable of its element. The other is to overwrite them with loading the element by AutoConnectAux::loadElement . The elements for attributes described in the JSON document for AutoConnectElements overwrites the member variables of the target AutoConnectElements. However, AutoConnectAux::loadElement keeps the member variables unchanged if there is no element in the JSON document. This overwriting behavior is the same for the AutoConnect::load function. For example, the combination of the sketch and JSON document as follows updates only the style while keeping Caption (ie. \"Hello, world\") as AutoConnectText value. External JSON document for the below sketch to modify the text style. { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"style\" : \"text-align:center;font-size:24px;font-family:'Impact','Futura',sans-serif;color:tomato;\" } The sketch (a part of code), load above JSON. ACText(Caption, \"Hello, world\" ); AutoConnectAux helloPage ( \"/hello\" , \"Hello\" , true, { Caption }); AutoConnect portal; String onHello (AutoConnectAux & aux, PageArgument & args) { aux.loadElement(JSON); return String(); } void setup () { helloPage.on(onHello); portal.join(helloPage); portal.begin(); } void loop () { portal.handleClient(); } It's shown as like: Check data against on submission \u00b6 By giving a pattern to AutoConnectInput , you can find errors in data styles while typing in custom Web pages. The pattern is specified with regular expression . 2 If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. The following example shows the behavior when checking the IP address in the AutoConnectInput field. { \"title\" : \"Page-1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" , \"pattern\" : \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" } ] } It's shown as like: If you are not familiar with regular expressions, you may feel that description very strange. Matter of fact, it's a strange description for those who are unfamiliar with the formal languages. If your regular expression can not interpret the intended syntax and semantics, you can use an online tester. The regex101 is an exceptional online tool for testing and debugging regular expressions. Input data validation \u00b6 The pattern attribute of AutoConnectInput only determines the data consistency on the web browser based on the given regular expression. In order to guarantee the validity of input data, it is necessary to verify it before actually using it. You can validate input data from AutoConnectInput using the isValid function before actually processing it. The isValid function determines whether the value currently stored in AutoConnectInput matches the pattern . You can also use the AutoConnectAux::isValid function to verify the data input to all AutoConnectInput elements on the custom Web page at once. The two sketches below show the difference between using AutoConnectInput::isValid and using AutoConnectAux::isValid . In both cases, it verifies the input data of the same AutoConnectInput, but in the case of using AutoConnectAux::isValid, the amount of sketch coding is small. A common declaration const char PAGE[] PROGMEM = R\"( { \"title\": \"Custom page\", \"uri\": \"/page\", \"menu\": true, \"element\": [ { \"name\": \"input1\", \"type\": \"ACInput\", \"pattern\": \"^[0-9]{4}$\" }, { \"name\": \"input2\", \"type\": \"ACInput\", \"pattern\": \"^[a-zA-Z]{4}$\" } ] } )\" ; AutoConnectAux page; page.load(PAGE); Using AutoConnectInput::isValid AutoConnectInput & input1 = page[ \"input1\" ].as < AutoConnectInput > (); AutoConnectInput & input2 = page[ \"input2\" ].as < AutoConnectInput > (); if ( ! input1.isValid() || ! input2.isValid()) Serial.println( \"Validation error\" ); Using AutoConnectAux::isValid if ( ! page.isValid()) Serial.println( \"Validation error\" ); Convert data to actually type \u00b6 The values in the AutoConnectElements field of the custom Web page are all typed as String. A sketch needs to be converted to an actual data type if the data type required for sketch processing is not a String type. For the typical data type conversion method, refer to section Tips for data conversion . Transitions of the custom Web pages \u00b6 Scope & Lifetime of AutoConnectAux \u00b6 AutoConnectAux and AutoConnectElements must live while the custom Web pages are available. The implementation of the custom Web page inherits from requestHandler driven from ESP8266WebServer (WebServer for ESP32), so the instance of AutoConnectAux and AutoConnectElements must exist for the duration of effect of handleClient. The following example is incorrect for manipulating custom Web pages. Its AutoConnectAux instance will be destructed at the exit of the setup(). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const auxPage[] PROGMEM = R\"raw( { \"title\": \"Page-1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\":\"Server\", \"type\":\"ACText\", \"label\":\"Server address\" } ] } )raw\" ; AutoConnect portal; void setup () { // This declaration is wrong. AutoConnectAux aux; aux.load(auxPage); portal.join(aux); portal.begin(); } void loop () { portal.handleClient(); } The URI of the custom Web pages \u00b6 The transition of the custom Web page follows the URI of the page, but the ESP8266WebServer class does not know the URI of an AutoConnectAux page. (Registering a custom Web page does not use the ESP8266WebServer::on / WebServer::on function.) Therefore ESP8266WebServer class does not detect its URI access. If you want to detect an http request to AutoConnectAux's custom Web page, you need to register its URI with the AutoConnectAux::on function. In addition to this, there are restrictions in the handler for the custom Web page as shown in the following section. Limitations \u00b6 The custom Web pages handler has the following limitations. Do not send HTTP responses from the handler. If the handler returns its own response, the custom Web page will be lost. Use AutoConnectSubmit whenever possible. AutoConnect will hold the values of a custom Web Page is sent by AutoConnectSubmit. Can not handle the custom Web pages during a connection is not established yet. During the connection attempt, the web browser of the client will send a probe for a captive portal. Its request will cause unintended custom Web page transitions. Can not place URI of the custom Web pages to AUTOCONNECT_URI. AutoConnect will not work if you place a custom Web page to AUTOCONNECT_URI . Can not use the element named SUBMIT . You can not use 'SUBMIT' as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element. (Case sensitive ignored) AutoConnect does not rely on the input type=submit element for the form submission and uses HTML form element submit function instead. So, the submit function will fail if there is an element named 'submit' in the form. Do not handle for the same page Do not duplicate AutoConnect::on with ESP8266WebServer::on (also WebServer::on) for the same custom web page. window.onload = function() { Gifffer(); }; The valid scope of the name is within an AutoConnectAux. \u21a9 Regular expression specification as a pattern of AutoConnectInput is JavaScript compliant . \u21a9","title":"Handling the custom Web pages"},{"location":"achandling.html#page-container-component","text":"AutoConnectAux is the container for a custom Web page, AutoConnectElement is the component of a page. AutoConnectElements must be contained in AutoConnectAux object. (ie. they are the elements displayed on the custom Web page.) Then AutoConnect makes an AutoConnectAux to a page. AutoConnectElements declared in sketch must be programmed to add to AutoConnectAux one after another. Elements are automatically included in AutoConnectAux by AutoConnect if you load it from the JSON document. In either method, it is common to use the function of AutoConnectAux to access an element with a sketch.","title":"Page, Container, Component"},{"location":"achandling.html#handing-autoconnectelements-with-the-sketches","text":"The AutoConnectAux class has several functions to manipulate AutoConnectElements. The functions can add, delete, retrieve elements, and get and set values.","title":"Handing AutoConnectElements with the sketches"},{"location":"achandling.html#add-autoconnectelements-to-the-autoconnectaux-object","text":"To add AutoConnectElment(s) to an AutoConnectAux object, use the add function. void AutoConnectAux :: add(AutoConnectElement & addon) void AutoConnectAux :: add(AutoConnectElementVT addons) The add function adds the specified AutoConnectElement to AutoConnectAux. The AutoConnectElementVT type is the std::vector of the reference wrapper to AutoConnectElements, and you can add these elements in bulk by using the list initialization with the sketch. typedef std :: vector < std :: reference_wrapper < AutoConnectElement >> AutoConnectElementVT; AutoConnectElements contained in AutoConnectAux object are uniquely identified by name. When adding an AutoConnectElement, if an element with the same name already exists in the AutoConnectAux, checking the type, and if it is the same, the value will be replaced. If another type of AutoConnectElement exists with the same name, that add operation will be invalid. 1 In the following example, AutoConnectButton button addition will invalid because hello with the same name already exists as AutoConnectText. AutoConnectAux aux; AutoConnectText text ( \"hello\" , \"hello, world\" ); AutoConnectButton button ( \"hello\" , \"hello, world\" , \"alert('Hello world!')\") ; // This is invalid. aux.add({ text, button }); Similarly this, the uniqueness of the name is also necessary within the JSON document { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true , \"element\" : [ { \"name\" : \"hello\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"hello\" , \"type\" : \"ACButton\" , \"value\" : \"hello, world\" , \"action\" : \"alert('Hello world!')\" } ] } Load all elements from JSON document If you load all AutoConnectElements from JSON document into AutoConnect, you do not need to sketch the population process of the AutoConnectElements. It is managed by the AutoConnect library automatically.","title":" Add AutoConnectElements to the AutoConnectAux object"},{"location":"achandling.html#get-autoconnectelement-from-the-autoconnectaux","text":"To retrieve an element from AutoConnectAux, use the getElement or getElements function. Normally, the getElement is needed when accessing the value of AutoConnectElement in the sketch. AutoConnectElement * AutoConnectAux :: getElement( const String & name) T & AutoConnectAux :: getElement < T > ( const String & name) AutoConnectElementVT * AutoConnectAux :: getElements( void ) The getElement function returns an AutoConnectElement with the specified name as a key. When you use this function, you need to know the type of AutoConnectElement in advance and specify its type <T> to an argument of the getElement. A type of <T> can be specified as follows. AutoConnectButton & AutoConnectAux :: getElement < AutoConnectButton > ( const String & name) AutoConnectCheckbox & AutoConnectAux :: getElement < AutoConnectCheckbox > ( const String & name) AutoConnectElement & AutoConnectAux :: getElement < AutoConnectElement > ( const String & name) AutoConnectFile & AutoConnectAux :: getElement < AutoConnectFile > ( const String & name) AutoConnectInput & AutoConnectAux :: getElement < AutoConnectInput > ( const String & name) AutoConnectRadio & AutoConnectAux :: getElement < AutoConnectRadio > ( const String & name) AutoConnectSelect & AutoConnectAux :: getElement < AutoConnectSelect > ( const String & name) AutoConnectSubmit & AutoConnectAux :: getElement < AutoConnectSubmit > ( const String & name) AutoConnectText & AutoConnectAux :: getElement < AutoConnectText > ( const String & name) To retrieve an AutoConnectElement by specifying its type, use the following method. AutoConnectAux aux; aux.load( \"SOME_JSON_DOCUMENT\" ); // Retrieve the pointer of the AutoConnectText AutoConnectText * text = reinterpret_cast < AutoConnectText *> (aux.getElement( \"TEXT_ELEMENT_NAME\" )); // Retrieve the reference of the AutoConnectText AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_ELEMENT_NAME\" ); The AutoConnectElement type behaves as a variant of other element types. Therefore use cast or template to convert to actual type as above. In the sketch, you access the real type of AutoConnectElement after casting it and storing into the variable. const String auxJson = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); AutoConnect portal; portal.load(auxJson); AutoConnectAux * aux = portal.aux( \"/page1\" ); // Identify the AutoConnectAux instance with uri AutoConnectText & text = aux -> getElement < AutoConnectText > ( \"caption\" ); // Cast to real type and access members Serial.println(text.value); You can also use the operator [] of AutoConnectAux as another way to get the desired element. An operator [] is a shortcut for getElement function with the reference casting and makes simplify the sketch code and treats like an array with the elements placed on a custom Web page. Its argument is the name of the element to be acquired similarly to getElement function. In the sketch, by combining the AutoConnectElement::as<T> function with the operator [] , you can access the AutoConnectElements reference according to its actual type. For example, the following sketch code returns the same as a reference of AutoConnectText element as the caption . AutoConnect portal; portal.load(auxJson); AutoConnectAux & aux = * portal.aux( \"/page1\" ); AutoConnectText & text1 = aux.getElement < AutoConnectElement > ( \"caption\" ); AutoConnectText & text2 = aux[ \"caption\" ].as < AutoConnectText > (); Need cast to convert to the actual type An operator [] returns a reference of an AutoConnectElement. It is necessary to convert the type according to the actual element type with AutoConnectElement::as<T> function. AutoConnectButton & AutoConnectElement :: as < AutoConnectButton > () AutoConnectCheckbox & AutoConnectElement :: as < AutoConnectCheckbox > () AutoConnectElement & AutoConnectElement :: as < AutoConnectElement > () AutoConnectFile & AutoConnectElement :: as < AutoConnectFile > () AutoConnectInput & AutoConnectElement :: as < AutoConnectInput > () AutoConnectRadio & AutoConnectElement :: as < AutoConnectRadio > () AutoConnectSelect & AutoConnectElement :: as < AutoConnectSelect > () AutoConnectSubmit & AutoConnectElement :: as < AutoConnectSubmit > () AutoConnectText & AutoConnectElement :: as < AutoConnectText > () To get all the AutoConnectElements in an AutoConnectAux object use the getElements function. This function returns the vector of the reference wrapper as AutoConnectElementVT to all AutoConnectElements registered in the AutoConnectAux. AutoConnectElementVT & AutoConnectAux :: getElements( void )","title":" Get AutoConnectElement from the AutoConnectAux"},{"location":"achandling.html#enable-autoconnectelements-during-the-sketch-execution","text":"AutoConnectElemets have an enable attribute to activate its own HTML generation. Sketches can change the HTMLization of their elements dynamically by setting or resetting the enable value. An element whose the enable attribute is true will generate itself HTML and place on the custom Web page. And conversely, it will not generate the HTML when the value is false. For example, to enable the submit button only when the ESP module is connected to the access point in STA mode, you can sketch the following: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char AUX[] PROGMEM = R( \" { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true, \"element\" : [ { \"name\" : \"input\" , \"type\" : \"ACInput\" , \"label\" : \"Input\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/send\" } ] } \"); AutoConnect portal; AutoConnectAux page; String onPage (AutoConectAux & aux, PageArgument & args) { AutoConnectSubmit & send = aux[ \"send\" ].as < AutoConnectSubmit > (); if (WiFi.isConnected()) send.enable = (WiFi.getMode() == WIFI_STA); else send.enable = false; return String(); } void setup () { page.load(AUX); page.on(onPage); portal.join(page); portal.begin(); } void loop () { portal.handleClient(); } Desirable to set or reset the enable attribute in the page handler The enable attribute can be set at any time during the sketch execution. The page handler with the AC_EXIT_AHEAD option is sure to handle it.","title":" Enable AutoConnectElements during the sketch execution"},{"location":"achandling.html#loading-saving-autoconnectelements-with-json","text":"AutoConnect supports reading the custom Web page definitions written in JSON and also supports loading and saving of AutoConnectAux or AutoConnectElements. In both cases, the target object is a JSON document for AutoConnect . However, it can not save all AutoConnectElements contained in the page as a custom Web page. (ie. AutoConnectAux)","title":"Loading &amp; saving AutoConnectElements with JSON"},{"location":"achandling.html#loading-autoconnectaux-autoconnectelements-with-json","text":"To load a JSON document as AutoConnectAux use the AutoConnect::load function and load the JSON document of each AutoConnectElement using the AutoConnectAux::loadElement function. Although the functions of both are similar, the structure of the target JSON document is different. The AutoConnect::load function loads the entire AutoConnectAux and creates both the AutoConnectAux instance and each AutoConnectElement instance. A single JSON document can contain multiple custom Web pages. If you write JSON of AutoConnectAux as an array, the load function generates all the pages contained in that array. Therefore, it is necessary to supply the JSON document of AutoConnectAux as an input of the load function and must contain the elements described section JSON document structure for AutoConnectAux . The AutoConnectAux::loadElement function loads the elements individually into an AutoConnectAux object. The structure of its supplying JSON document is not AutoConnectAux. It must be a JSON structure for AutoConnectElement , but you can specify an array. // AutoConnectAux as a custom Web page. const char page[] PROGMEM = R\"raw( { \"title\": \"Settings\", \"uri\": \"/settings\", \"menu\": true, \"element\": [ { \"name\": \"server\", \"type\": \"ACInput\", \"label\": \"Server\" }, { \"name\": \"set\", \"type\": \"ACSubmit\", \"value\": \"SET\", \"uri\" : \"/set\" } ] } )raw\" ; // Additional AutoConnectElements. const char addons[] PROGMEM = R\"raw( [ { \"name\": \"notes\", \"type\": \"ACText\", \"value\": \"An update period as the below optionally.\" }, { \"name\": \"period\", \"type\": \"ACRadio\", \"value\": [ \"30 sec.\", \"60 sec.\", \"180 sec.\" ], \"arrange\": \"vertical\", \"checked\": 1 } ] )raw\" ; AutoConnect portal; AutoConnectAux * auxPage; // Load a custom Web page. portal.load(page); // Get a '/settings' page auxPage = portal.aux( \"/settings\" ); // Also, load only AutoConnectRadio named the period. auxPage -> loadElement(addons, \"period\" ); // Retrieve a server name from an AutoConnectText value. AutoConnectText & serverName = auxPage -> getElement < AutoConnectText > ( \"server\" ); Serial.println(serverName.value);","title":" Loading AutoConnectAux &amp; AutoConnectElements with JSON"},{"location":"achandling.html#saving-autoconnectelements-with-json","text":"To save the AutoConnectAux or the AutoConnectElement as a JSON document, use the AutoConnectAux::saveElement function. It serializes the contents of the object based on the type of the AutoConnectElement. You can persist a serialized AutoConnectElements as a JSON document to a stream. // Open a parameter file on the SPIFFS. SPIFFS.begin(); FILE param = SPIFFS.open( \"/param\" , \"w\" ); // Save elements as the parameters. auxPage -> saveElement(param, { \"server\" , \"period\" }); // Close a parameter file. param.close(); SPIFFS.end(); The example above saves server and period elements from the AutoConnectAux object as mentioned above to the /param file on SPIFFS. Its JSON document of AutoConnectElements saved by its code looks like this: [ { \"name\" : \"server\" , \"type\" : \"ACInput\" , \"value\" : \"An inputted server name\" , \"label\" : \"Server\" , \"placeholder\" : \"\" }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"arrange\" : \"vertical\" , \"checked\" : 2 } ] Above JSON document can be loaded as it is into a custom Web page using the loadElement function. The loadElement function also loads the value of the element, so the saved value can be restored on the custom Web page.","title":" Saving AutoConnectElements with JSON"},{"location":"achandling.html#custom-field-data-handling","text":"A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored in the member variable of each element by AutoConnect whenever GET/POST transmission occurs. The following diagram shows the flow of the input values of a custom Web page into a sketch and is the basis for actions to manipulate the values of custom Web pages using sketches.","title":"Custom field data handling"},{"location":"achandling.html#where-to-pick-up-the-values","text":"A sketch composed of handlers can receive the value of AutoConnectElements entered in a custom Web page after sending, but that handler is different from the page where the value was entered. It is necessary to be aware that can accept the entered values by the next page handler after the transition. Usually, two ways to retrieve entered values we have. One is to use the ESP8266WebServer::arg (or WebServer::arg for ESP32) function in the on handler attached by ESP8266WebServer (WebServer w/ESP32 also). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char addonJson[] PROGMEM = R\"raw( { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] } )raw\" ; ESP8266WebServer webServer; AutoConnect portal (webServer); // Here, /feels handler void feelsOn () { // Retrieve the value of a input-box named \"feels\" String feel = webServer.arg( \"feels\" ); // Echo back the value String echo = \"<html><p style= \\\" color:blue;font-family:verdana;font-size:300%; \\\" >\" + feel + String( \" and a bold world!</p></html>\" ); webServer.send( 200 , \"text/html\" , echo); } void setup () { delay( 1000 ); webServer.on( \"/feels\" , feelsOn); // Register /feels handler portal.load(addonJson); // Load a custom Web page portal.begin(); } void loop () { portal.handleClient(); } An above example is the most simple sketch of handling values entered into a custom Web page. This sketch obtains the string entered in the AutoConnectInput named feels with the /feels handler after page transition, and the AutoConnectInput is an <input type=\"text\" name=\"feels\"> element wrapped in the form as the actual HTML code. Should be accessed /_ac first When you actually try the above sketch, there is no a root handler. So the URL that should be accessed first is /_ac concatenated with the local IP address of the esp8266 module. Another method is effective when custom Web pages have complicated page transitions. It is a way to straight access the AutoConnectElements member value. You can get the AutoConnectElement with the specified name using the getElement function. The following sketch executes the above example with AutoConnect only, without using the function of ESP8266WebServer. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> const static char addonJson[] PROGMEM = R\"raw( [ { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] }, { \"title\": \"Hello\", \"uri\": \"/feels\", \"menu\": false, \"element\": [ { \"name\": \"echo\", \"type\": \"ACText\", \"style\": \"color:blue;font-family:verdana;font-size:300%;\" } ] } ] )raw\" ; AutoConnect portal; // Here, /feels handler String feelsOn (AutoConnectAux & aux, PageArgument & args) { // Get the AutoConnectInput named \"feels\". // The where() function returns an uri string of the AutoConnectAux that triggered this handler. AutoConnectAux * hello = portal.aux(portal.where()); AutoConnectInput & feels = hello -> getElement < AutoConnectInput > ( \"feels\" ); // Get the AutoConnectText named \"echo\". AutoConnectText & echo = aux.getElement < AutoConnectText > ( \"echo\" ); // Echo back from input-box to /feels page. echo.value = feels.value + String( \" and a bold world!\" ); return String( \"\" ); } void setup () { delay( 1000 ); portal.load(addonJson); // Load custom Web pages portal.on( \"/feels\" , feelsOn, AC_EXIT_AHEAD); // Register /feels handler portal.begin(); } void loop () { portal.handleClient(); } The above example handles in the handler for the values of a custom Web page. An AutoConnect::on function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the PageArgument object. To retrieve the values entered in a custom Web page you need to access the AutoConnectElement of the page that caused the request to this page and to do this, you use the AutoConnect::where function. The AutoConnect::where function returns an uri string of the AutoConnectAux object of the custom Web page that caused the HTTP request. The where() function is available for only AutoConnectAux. The AutoConnect::where function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/WebServer for ESP32. In other words, the AutoConnect::where function only returns the last AutoConnecAux page called.","title":" Where to pick up the values"},{"location":"achandling.html#when-setting-the-initial-values","text":"An AutoConnectAux page is dynamically created by AutoConnect when its uri is requested. The initial value of AutoConnectElements can be set before its page request. It is also possible during loop() . To set the initial value when the page is accessed it needs by the handler of its page. The AutoConnect::on and AutoConnectAux::on functions register a handler for a custom Web page and also specify when to call that handler. The behavior of the two on functions is the same, only the class and arguments are different. bool AutoConnect :: on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order) void AutoConnectAux :: on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order) Parameter uri specifies an URI of the custom Web page, but an AutoConnectAux object with its URI must be registered with AutoConnect via the AutoConnect::join function beforehand. AutoConnect::on/AutoConnectAux::on is not ESP8266WebServer::on The on function for AutoConnect is different from the on function of Arduino core ESP8266WebServer (WebServer for ESP32). You can share the same handler via wrapper, but access to AutoConnectElements is valid only for handlers registered with on function for AutoConnect . AuxHandlerFunctionT type is a handler declaration using with std::function . String handler(AutoConnectAux & aux, PageArgument & args) The handler of the custom Web page has two arguments by a reference of AutoConnectAux and a reference of PageArgument, it returns String. AutoConnect appends the string returned from the handler to the generated HTML. This allows you to add an HTML part before displaying the page. AutoConnectExitOrder_t specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. The following example is a part of sketch contained the handlers. // AutoConnect object declarations ACInput(input1); AutoConnectAux aux ( \"/aux\" , { input1 }); AutoConnect portal; // Pre-declare handlers String initialize (AutoConnectAux & , PageArgument & ); String append (AutoConnectAux & , PageArgument & ); // Register handlers and launch the portal. aux.on(initialize, AC_AHEAD); aux.on(append, AC_LATER); portal.join(aux); portal.begin(); // Some code here... // The handler called before HTML generating String initialize (AutoConnectAux & aux, PageArgument & args) { AutoConnectInput & input1 = aux.getElement < AutoConnectInput > ( \"input1\" ); // Set initial value for the input box in a custom Web page. input1.value = \"Initial value\" ; // Nothing appendix for a generated HTML. return String(); } // The handler called after HTML generated String append (AutoConnectAux & aux, PageArgument & args) { // Append an HTML return String( \"<p>This text has been added.</p>\" ); }","title":" When setting the initial values"},{"location":"achandling.html#how-you-can-reach-the-values","text":"AutoConnectSubmit uses the POST method to send HTTP requests. A value of AutoConnectInput sent to the ESP8266 or ESP32 with POST is stored in the request body of the HTTP request: POST /feels HTTP/1.1 Host: ESP8266_IP_ADDRESS name1=value1&name2=value2&name3=value3 ESP8266WebServer class will parse the query string and rebuilds its arguments when the above request arrives. A custom page handler registered with the ESP8266WebServer::on function can access the value of AutoConnectElements with ESP8266WebServe::arg function. It reaches the values of AutoConnectElements without the intermediation of AutoConnect. Therefore, its handler will not be AutoConnectAux and can send a response to the client directly. The following example is part of a server sketch which has two web pages. The /hello page is a custom Web page of AutoConnectAux which has an input box named \"input1\". Another /echo page is a page handler for ESP8266WebServer, which uses the ESP8266WebServer::send function to echo back the value of an input1 as an http response. ESP8266WebServer server; AutoConnect portal (server); ACInput(input1, \"\" , \"INPUT\" ); ACSubmit(send, \"HELLO\" , \"/echo\" ); AutoConnectAux aux ( \"/hello\" , { input1, send }); server.on( \"/echo\" , []() { String echo = server.arg( \"input1\" ); Serial.println(echo); server.send( 200 , \"text/plain\" , echo); }); portal.join(aux); portal.begin(); Also, you can choose another way to access arguments without going through the ESP8266WebServer class. The PageArgument object of the custom Web page handler argument is a copy of the arg object of the ESP8266WebServer class. Either of these methods is a simple and easy way to access parameters in custom Web page handlers. However, if you need to access from outside of the handler to the value of AutoConnectElements, you need to accomplish it using with the AutoConnectAux::getElement function. The following sketch code replaces the above example with JSON and PageArgument, and its behaves is equivalent basically to the above sketch. const static char auxPage[] PROGMEM = R\"raw( [ { \"title\":\"Hello\", \"uri\":\"/hello\", \"menu\":true, \"element\":[ { \"name\":\"input1\", \"type\": \"ACInput\", \"label\": \"INPUT\" }, { \"name\":\"send\", \"type\":\"ACSubmit\", \"value\":\"HELLO\", \"uri\":\"/echo\" }] }, { \"title\":\"Echo\", \"uri\":\"/echo\", \"menu\":false, \"element\":[ { \"name\":\"echo\", \"type\":\"ACText\" }] } ] )raw\" ; AutoConnect portal; portal.load(auxPage); portal.on( \"/echo\" , [](AutoConnectAux & aux, PageArgument & args) { AutoConnectText & ac_echo = aux.getElement < AutoConnectText > ( \"echo\" ); ac_echo.value = args.arg( \"input1\" ); return String (); }); portal.begin();","title":" How you can reach the values"},{"location":"achandling.html#transfer-of-input-values-across-pages","text":"Since v1.0.0, AutoConnect supports a new attribute with each element that allows automatic transfer of input values across pages without sketching. AutoConnect will copy the input value of the elements declared as global to the same-named global elements on a different custom Web pages at the page transition timing. The global attribute will be useful for echoing input values back to another custom Web pages. This copy operation can be performed between different types. (eg., copy value from AutoConnectInput to AutoConnectText) The following example reflects the input value of PAGE1 to the AutoConnectText field of PAGE2 without sketch code. static const char PAGE1[] PROGMEM = R\"( { \"title\": \"PAGE1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\": \"input1\", \"type\": \"ACInput\", \"global\": true }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"OK\", \"uri\": \"/page2\" } ] } )\" ; static const char PAGE2[] PROGMEM = R\"( { \"title\": \"PAGE2\", \"uri\": \"/page2\", \"menu\": false, \"element\": [ { \"name\": \"input1\", \"type\": \"ACText\", \"global\": true } ] } )\" ; AutoConnect portal; AutoConnectAux page1; AutoConnectAux page2; void setup () { page1.load(PAGE1); page2.load(PAGE2); portal.join( { page1, page2 }); portal.begin(); } void loop () { portal.handleClient(); } The value entered in input1 declared in PAGE1 is reflected in input1 of PAGE2 as an AutoConnectText value even if there is no sketch code to transfer it to PAGE2. It's shown as like: Copy only for same-named and the global The input value will be copied only if the global attribute of the destination element is true. If an element with the same name is declared non-global, the value is not copied.","title":" Transfer of input values \u200b\u200bacross pages"},{"location":"achandling.html#retrieve-the-values-with-webserveron-handler","text":"ESP8266WebServer class and the WebServer class assume that the implementation of the ReqestHandler class contained in the WebServer library will handle the URL requests. Usually, it is sketch code registered by ESP8266WebServer::on function. When a page transition from a custom Web page created by AutoConnectAux to a handler registered with ESP2866WebServer::on function, a little trick is needed to retrieve the values of AutoConnectElements. (i.e. the URI of the ESP8266WebServer::on handler is specified in the uri attribute of AutoConnectSubmit ) AutoConnect cannot intervene in the procedure in which the ESP8266WebServer class calls the on-page handler coded with the sketch. Therefore, it is necessary to retrieve preliminary the values of AutoConnectElements using the AutoConnectAux::fetchElement function for value processing with the on-page handler. The following sketch is an example of extracting values inputted on a custom web page with an on-page handler and then processing it. ESP8266WebServer server; AutoConnect portal (server); AutoConnectAux Input; const static char InputPage[] PROGMEM = R\"r( { \"title\": \"Input\", \"uri\": \"/input\", \"menu\": true, \"element\": [ { \"name\": \"input\", \"type\": \"ACInput\", \"label\": \"INPUT\" }, { \"name\": \"save\", \"type\": \"ACSubmit\", \"value\": \"SAVE\", \"uri\": \"/\" } ] } )r\" ; // An on-page handler for '/' access void onRoot () { String content = \"<html>\" \"<head><meta name='viewport' content='width=device-width, initial-scale=1'></head>\" \"<body><div>INPUT: {{value}}</div></body>\" \"</html>\" ; Input.fetchElement(); // Preliminary acquisition // For this steps to work, need to call fetchElement function beforehand. String value = Input[ \"input\" ].value; content.replace( \"{{value}}\" , value); server.send( 200 , \"text/html\" , content); } void setup () { Input.load(InputPage); portal.join(Input); server.on( \"/\" , onRoot); // Register the on-page handler portal.begin(); } void loop () { portal.handleClient(); }","title":" Retrieve the values with WebServer::on handler"},{"location":"achandling.html#overwrite-the-autoconnectelements","text":"Sketches can update the attributes of AutoConnectElements with two approaches. A one is to assign directly to the attributes of a member variable of its element. The other is to overwrite them with loading the element by AutoConnectAux::loadElement . The elements for attributes described in the JSON document for AutoConnectElements overwrites the member variables of the target AutoConnectElements. However, AutoConnectAux::loadElement keeps the member variables unchanged if there is no element in the JSON document. This overwriting behavior is the same for the AutoConnect::load function. For example, the combination of the sketch and JSON document as follows updates only the style while keeping Caption (ie. \"Hello, world\") as AutoConnectText value. External JSON document for the below sketch to modify the text style. { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"style\" : \"text-align:center;font-size:24px;font-family:'Impact','Futura',sans-serif;color:tomato;\" } The sketch (a part of code), load above JSON. ACText(Caption, \"Hello, world\" ); AutoConnectAux helloPage ( \"/hello\" , \"Hello\" , true, { Caption }); AutoConnect portal; String onHello (AutoConnectAux & aux, PageArgument & args) { aux.loadElement(JSON); return String(); } void setup () { helloPage.on(onHello); portal.join(helloPage); portal.begin(); } void loop () { portal.handleClient(); } It's shown as like:","title":" Overwrite the AutoConnectElements"},{"location":"achandling.html#check-data-against-on-submission","text":"By giving a pattern to AutoConnectInput , you can find errors in data styles while typing in custom Web pages. The pattern is specified with regular expression . 2 If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. The following example shows the behavior when checking the IP address in the AutoConnectInput field. { \"title\" : \"Page-1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" , \"pattern\" : \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" } ] } It's shown as like: If you are not familiar with regular expressions, you may feel that description very strange. Matter of fact, it's a strange description for those who are unfamiliar with the formal languages. If your regular expression can not interpret the intended syntax and semantics, you can use an online tester. The regex101 is an exceptional online tool for testing and debugging regular expressions.","title":" Check data against on submission"},{"location":"achandling.html#input-data-validation","text":"The pattern attribute of AutoConnectInput only determines the data consistency on the web browser based on the given regular expression. In order to guarantee the validity of input data, it is necessary to verify it before actually using it. You can validate input data from AutoConnectInput using the isValid function before actually processing it. The isValid function determines whether the value currently stored in AutoConnectInput matches the pattern . You can also use the AutoConnectAux::isValid function to verify the data input to all AutoConnectInput elements on the custom Web page at once. The two sketches below show the difference between using AutoConnectInput::isValid and using AutoConnectAux::isValid . In both cases, it verifies the input data of the same AutoConnectInput, but in the case of using AutoConnectAux::isValid, the amount of sketch coding is small. A common declaration const char PAGE[] PROGMEM = R\"( { \"title\": \"Custom page\", \"uri\": \"/page\", \"menu\": true, \"element\": [ { \"name\": \"input1\", \"type\": \"ACInput\", \"pattern\": \"^[0-9]{4}$\" }, { \"name\": \"input2\", \"type\": \"ACInput\", \"pattern\": \"^[a-zA-Z]{4}$\" } ] } )\" ; AutoConnectAux page; page.load(PAGE); Using AutoConnectInput::isValid AutoConnectInput & input1 = page[ \"input1\" ].as < AutoConnectInput > (); AutoConnectInput & input2 = page[ \"input2\" ].as < AutoConnectInput > (); if ( ! input1.isValid() || ! input2.isValid()) Serial.println( \"Validation error\" ); Using AutoConnectAux::isValid if ( ! page.isValid()) Serial.println( \"Validation error\" );","title":" Input data validation"},{"location":"achandling.html#convert-data-to-actually-type","text":"The values in the AutoConnectElements field of the custom Web page are all typed as String. A sketch needs to be converted to an actual data type if the data type required for sketch processing is not a String type. For the typical data type conversion method, refer to section Tips for data conversion .","title":" Convert data to actually type"},{"location":"achandling.html#transitions-of-the-custom-web-pages","text":"","title":"Transitions of the custom Web pages"},{"location":"achandling.html#scope-lifetime-of-autoconnectaux","text":"AutoConnectAux and AutoConnectElements must live while the custom Web pages are available. The implementation of the custom Web page inherits from requestHandler driven from ESP8266WebServer (WebServer for ESP32), so the instance of AutoConnectAux and AutoConnectElements must exist for the duration of effect of handleClient. The following example is incorrect for manipulating custom Web pages. Its AutoConnectAux instance will be destructed at the exit of the setup(). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const auxPage[] PROGMEM = R\"raw( { \"title\": \"Page-1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\":\"Server\", \"type\":\"ACText\", \"label\":\"Server address\" } ] } )raw\" ; AutoConnect portal; void setup () { // This declaration is wrong. AutoConnectAux aux; aux.load(auxPage); portal.join(aux); portal.begin(); } void loop () { portal.handleClient(); }","title":"Scope &amp; Lifetime of AutoConnectAux"},{"location":"achandling.html#the-uri-of-the-custom-web-pages","text":"The transition of the custom Web page follows the URI of the page, but the ESP8266WebServer class does not know the URI of an AutoConnectAux page. (Registering a custom Web page does not use the ESP8266WebServer::on / WebServer::on function.) Therefore ESP8266WebServer class does not detect its URI access. If you want to detect an http request to AutoConnectAux's custom Web page, you need to register its URI with the AutoConnectAux::on function. In addition to this, there are restrictions in the handler for the custom Web page as shown in the following section.","title":"The URI of the custom Web pages"},{"location":"achandling.html#limitations","text":"The custom Web pages handler has the following limitations. Do not send HTTP responses from the handler. If the handler returns its own response, the custom Web page will be lost. Use AutoConnectSubmit whenever possible. AutoConnect will hold the values of a custom Web Page is sent by AutoConnectSubmit. Can not handle the custom Web pages during a connection is not established yet. During the connection attempt, the web browser of the client will send a probe for a captive portal. Its request will cause unintended custom Web page transitions. Can not place URI of the custom Web pages to AUTOCONNECT_URI. AutoConnect will not work if you place a custom Web page to AUTOCONNECT_URI . Can not use the element named SUBMIT . You can not use 'SUBMIT' as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element. (Case sensitive ignored) AutoConnect does not rely on the input type=submit element for the form submission and uses HTML form element submit function instead. So, the submit function will fail if there is an element named 'submit' in the form. Do not handle for the same page Do not duplicate AutoConnect::on with ESP8266WebServer::on (also WebServer::on) for the same custom web page. window.onload = function() { Gifffer(); }; The valid scope of the name is within an AutoConnectAux. \u21a9 Regular expression specification as a pattern of AutoConnectInput is JavaScript compliant . \u21a9","title":"Limitations"},{"location":"acintro.html","text":"What it is \u00b6 AutoConnect can handle custom Web pages prepared by user sketches individually. Custom Web pages can be integrated into the AutoConnect menu and executed as menu items and can have input-output parameters and handle them. For example, you can program some sketches that publish messages by entering the URI or unique ID of the MQTT broker on a custom page. You do not need to code the processing to handle the web page. It retrieves the input parameters and passes to the MQTT broker connection API is only. How it works \u00b6 AutoConnect creates the custom Web pages dynamically at runtime. Sketch describes the custom Web pages using classes and APIs necessary for dynamic creation which are AutoConnectAux and the variant of AutoConnectElements . AutoConnectAux is an object dependent on AutoConnect, which provides an easy way to incorporate custom Web pages into AutoConnect like the one on the right figure. The elements make up a custom Web page are provided as an AutoConnectElement class. Furthermore, an input box, a check box, a submit button, etc. are implemented by classes derived from AutoConnectElement. AutoConnectAux is a container for AutoConnectElements. To make a custom Web page, create elements that make up the page and put it in the AutoConnectAux object. Joining its AutoConnectAux object to AutoConnect will integrate the custom Web page into the AutoConnect menu. The above figure shows a code sequence that declares AutoConnectElements and put in the AutoConnectAux container and integrates those into AutoConnect. It declares two text elements named header and caption , adds them to the AutoConnectAux object as aux , binds to an AutoConnect object named portal . This sequence is the basic procedure for creating custom Web pages with the sketch. The further explanation is available in section AutoConnectElements also. Custom Web pages in AutoConnect menu \u00b6 AutoConnect integrates custom Web page objects into menus as AutoConnectAux. The AutoConnectAux object contains URI and title as member variables and has an indicator to display in the AutoConnect menu. You give the title and URI of the custom Web page to the AutoConnectAux object with Sketch. Then the title of the custom Web page would be displayed in the AutoConnect menu as the left figure. 1 It is a hyperlink to a custom Web page which will be displayed tapped it. Multiple custom Web pages \u00b6 You can create multiple custom Web pages and specify pages that can be called from the menu. The following sketch shows a code sequence for integrating three custom Web pages into one and embedding them in a menu. In the above code, the third parameter of aux2 is false . The third parameter of the AutoConnectAux constructor is an indicator for whether it's shown to the AutoConnect menu. Right animation is an execution result of the above code. You will see that the menu applies only two items for three custom Web pages. The sketch of this animation is written to transition to aux2 by the utility of the AutoConnectSubmit element owned by aux1 . 2 The aux2 page transitions only from the aux1 page. As shown in mqttRSSI in the library example, its page replies the saving result for the parameters entered on the previous page. It can not be invoked directly from the menu and want to hide them with AutoConnect menu items. The utility of the third parameter of the AutoConnectAux constructor is that. Basic steps to use custom Web pages \u00b6 So, the basic procedure for handling of the custom Web pages is as follows: Create or define AutoConnectAux . Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . Perform AutoConnect::handleClient() . Write the custom Web page with JSON \u00b6 You can write the custom Web page in JSON without using sketch codes. 3 It is possible to describe the entire page in JSON and can be described for each element also. The JSON document can be saved in SPIFFS or SD and read using AutoConnect's load function. you can reduce the steps of the basic procedure with this approach, but this way consumes a lot of memory. The following JSON code and sketch will execute the custom Web page as an example in the above figure. That is, the sketch of this code and footnote 2 is equivalent. custom_page.json [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"MQTT broker settings\" }, { \"name\" : \"caption1\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi...\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"SAVE\" , \"uri\" : \"/mqtt_save\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption2\" , \"type\" : \"ACText\" , \"value\" : \"Save parameters\" }, { \"name\" : \"start\" , \"type\" : \"ACSubmit\" , \"value\" : \"START\" , \"uri\" : \"/mqtt_start\" } ] }, { \"title\" : \"MQTT Start\" , \"uri\" : \"/mqtt_start\" , \"menu\" : true , \"element\" : [] } ] The sketch #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> AutoConnect portal; void setup () { SPIFFS.begin(); File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); SPIFFS.end(); portal.begin(); } void loop () { portal.handleClient(); } Passing parameters with sketches and custom Web pages \u00b6 A sketch can access variables of AutoConnectElements on the custom Web page. The value entered into the AutoConnectElements is stored to the member variables of the element by AutoConnect whenever GET / POST transmission occurs. Your sketches can get these values with the request handler which will be registered by AutoConnect::on function. And if you assign a value to an element before a request to the page occurs, its value will appear as the initial value when the page is displayed. The details are explained in section Custom field data handling . window.onload = function() { Gifffer(); }; There is no overlay in the actual menu. \u21a9 The sketch is actually this: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; ACText(header, \"MQTT broker settings\" ); ACText(caption1, \"Publishing the WiFi...\" ); ACSubmit(save, \"SAVE\" , \"/mqtt_save\" ); AutoConnectAux aux1 ( \"/mqtt_setting\" , \"MQTT Setting\" , { header, caption1, save }); ACText(caption2, \"Save parameters\" ); ACSubmit(start, \"START\" , \"/mqtt_start\" ); AutoConnectAux aux2 ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, start }); AutoConnectAux aux3 ( \"/mqtt_start\" , \"MQTT Start\" ); void setup () { portal.join({ aux1, aux2, aux3 }); portal.begin(); } void loop () { portal.handleClient(); } \u21a9 Installation of the ArduinoJson as the latest release of version 5 series is required. \u21a9","title":"Custom Web pages with AutoConnect"},{"location":"acintro.html#what-it-is","text":"AutoConnect can handle custom Web pages prepared by user sketches individually. Custom Web pages can be integrated into the AutoConnect menu and executed as menu items and can have input-output parameters and handle them. For example, you can program some sketches that publish messages by entering the URI or unique ID of the MQTT broker on a custom page. You do not need to code the processing to handle the web page. It retrieves the input parameters and passes to the MQTT broker connection API is only.","title":"What it is"},{"location":"acintro.html#how-it-works","text":"AutoConnect creates the custom Web pages dynamically at runtime. Sketch describes the custom Web pages using classes and APIs necessary for dynamic creation which are AutoConnectAux and the variant of AutoConnectElements . AutoConnectAux is an object dependent on AutoConnect, which provides an easy way to incorporate custom Web pages into AutoConnect like the one on the right figure. The elements make up a custom Web page are provided as an AutoConnectElement class. Furthermore, an input box, a check box, a submit button, etc. are implemented by classes derived from AutoConnectElement. AutoConnectAux is a container for AutoConnectElements. To make a custom Web page, create elements that make up the page and put it in the AutoConnectAux object. Joining its AutoConnectAux object to AutoConnect will integrate the custom Web page into the AutoConnect menu. The above figure shows a code sequence that declares AutoConnectElements and put in the AutoConnectAux container and integrates those into AutoConnect. It declares two text elements named header and caption , adds them to the AutoConnectAux object as aux , binds to an AutoConnect object named portal . This sequence is the basic procedure for creating custom Web pages with the sketch. The further explanation is available in section AutoConnectElements also.","title":"How it works"},{"location":"acintro.html#custom-web-pages-in-autoconnect-menu","text":"AutoConnect integrates custom Web page objects into menus as AutoConnectAux. The AutoConnectAux object contains URI and title as member variables and has an indicator to display in the AutoConnect menu. You give the title and URI of the custom Web page to the AutoConnectAux object with Sketch. Then the title of the custom Web page would be displayed in the AutoConnect menu as the left figure. 1 It is a hyperlink to a custom Web page which will be displayed tapped it.","title":"Custom Web pages in AutoConnect menu"},{"location":"acintro.html#multiple-custom-web-pages","text":"You can create multiple custom Web pages and specify pages that can be called from the menu. The following sketch shows a code sequence for integrating three custom Web pages into one and embedding them in a menu. In the above code, the third parameter of aux2 is false . The third parameter of the AutoConnectAux constructor is an indicator for whether it's shown to the AutoConnect menu. Right animation is an execution result of the above code. You will see that the menu applies only two items for three custom Web pages. The sketch of this animation is written to transition to aux2 by the utility of the AutoConnectSubmit element owned by aux1 . 2 The aux2 page transitions only from the aux1 page. As shown in mqttRSSI in the library example, its page replies the saving result for the parameters entered on the previous page. It can not be invoked directly from the menu and want to hide them with AutoConnect menu items. The utility of the third parameter of the AutoConnectAux constructor is that.","title":"Multiple custom Web pages"},{"location":"acintro.html#basic-steps-to-use-custom-web-pages","text":"So, the basic procedure for handling of the custom Web pages is as follows: Create or define AutoConnectAux . Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . Perform AutoConnect::handleClient() .","title":"Basic steps to use custom Web pages"},{"location":"acintro.html#write-the-custom-web-page-with-json","text":"You can write the custom Web page in JSON without using sketch codes. 3 It is possible to describe the entire page in JSON and can be described for each element also. The JSON document can be saved in SPIFFS or SD and read using AutoConnect's load function. you can reduce the steps of the basic procedure with this approach, but this way consumes a lot of memory. The following JSON code and sketch will execute the custom Web page as an example in the above figure. That is, the sketch of this code and footnote 2 is equivalent. custom_page.json [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"MQTT broker settings\" }, { \"name\" : \"caption1\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi...\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"SAVE\" , \"uri\" : \"/mqtt_save\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption2\" , \"type\" : \"ACText\" , \"value\" : \"Save parameters\" }, { \"name\" : \"start\" , \"type\" : \"ACSubmit\" , \"value\" : \"START\" , \"uri\" : \"/mqtt_start\" } ] }, { \"title\" : \"MQTT Start\" , \"uri\" : \"/mqtt_start\" , \"menu\" : true , \"element\" : [] } ] The sketch #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> AutoConnect portal; void setup () { SPIFFS.begin(); File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); SPIFFS.end(); portal.begin(); } void loop () { portal.handleClient(); }","title":"Write the custom Web page with JSON"},{"location":"acintro.html#passing-parameters-with-sketches-and-custom-web-pages","text":"A sketch can access variables of AutoConnectElements on the custom Web page. The value entered into the AutoConnectElements is stored to the member variables of the element by AutoConnect whenever GET / POST transmission occurs. Your sketches can get these values with the request handler which will be registered by AutoConnect::on function. And if you assign a value to an element before a request to the page occurs, its value will appear as the initial value when the page is displayed. The details are explained in section Custom field data handling . window.onload = function() { Gifffer(); }; There is no overlay in the actual menu. \u21a9 The sketch is actually this: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; ACText(header, \"MQTT broker settings\" ); ACText(caption1, \"Publishing the WiFi...\" ); ACSubmit(save, \"SAVE\" , \"/mqtt_save\" ); AutoConnectAux aux1 ( \"/mqtt_setting\" , \"MQTT Setting\" , { header, caption1, save }); ACText(caption2, \"Save parameters\" ); ACSubmit(start, \"START\" , \"/mqtt_start\" ); AutoConnectAux aux2 ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, start }); AutoConnectAux aux3 ( \"/mqtt_start\" , \"MQTT Start\" ); void setup () { portal.join({ aux1, aux2, aux3 }); portal.begin(); } void loop () { portal.handleClient(); } \u21a9 Installation of the ArduinoJson as the latest release of version 5 series is required. \u21a9","title":"Passing parameters with sketches and custom Web pages"},{"location":"acjson.html","text":"You can embed custom Web pages written in JSON into AutoConnect without AutoConnectAux & AutoConnectElements declaration. Custom Web page declaration by JSON can embed in the sketch as a fixed string or can store in the external file such as SPIFFS for stream loading. Also, you can also load and save AutoConnectElements objects individually. 1 By providing the following JSON document to AutoConnect, you can include the custom Web page like the below: A JSON document for AutoConnect can contain the custom Web page multiple. You can further reduce the sketch process by loading multiple pages of JSON document at once. Adopt ArduinoJson v5 or v6 To handle AutoConnectAux and AutoConnectElements written in JSON, you need to install the ArduinoJson library. You can adopt either version 5 or version 6 for the ArduinoJson. AutoConnect supports both versions. JSON objects & elements for the custom Web page \u00b6 JSON document structure for AutoConnectAux \u00b6 AutoConnectAux will configure custom Web pages with JSON objects. The elements that make up the object are as follows: { \"title\" : title , \"uri\" : uri , \"menu\" : true | false , \"element\" : element_array } title \u00b6 A title of the custom Web page. This is string value. String specified title will be displayed in the AutoConnection menu. uri \u00b6 String of URI path that specifies where to place the custom Web page. It needs to be a location from the root path including ' / '. menu \u00b6 This is a Boolean value indicating whether to include the custom Web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu. element \u00b6 Describe an array of JSON objects as element_array . It is a JSON object array of the AutoConnectElements that make up the custom Web page. Order of elements on a custom Web page The order in which AutoConnectElements are placed on a custom Web page is the order in the JSON document. Multiple custom Web pages declaration in JSON document \u00b6 You can put declarations of multiple custom Web pages in one JSON document. In that case, declare an array of each custom Web page with JSON. The following JSON document contains three custom Web pages: [ { \"title\" : \"Page 1 title\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page2\" } ] }, { \"title\" : \"Page 1 title\" , \"uri\" : \"/page2\" , \"menu\" : false , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"Good day\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page3\" } ] }, { \"title\" : \"Page 3 title\" , \"uri\" : \"/page3\" , \"menu\" : true , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"bye\" } ] } ] The above custom Web page definitions can be loaded in a batch using the AutoConnect::load function. JSON object for AutoConnectElements \u00b6 JSON description for AutoConnectElements describes as an array in the element with arguments of each constructor . { \"name\" : name , \"type\" : type , key_according_to_type : the_value | array_of_value , [ key_according_to_type : the_value | array_of_value ] } name \u00b6 A string of the name for the element. type \u00b6 A string of the type for the element. For this type, specify the following string corresponding to each element. AutoConnectButton: ACButton AutoConnectCheckbox: ACCheckbox AutoConnectElement: ACElement AutoConnectFile: ACFile AutoConnectInput: ACInput AutoConnectRadio: ACRadio AutoConnectSelect: ACSelect AutoConnectStyle: ACStyle AutoConnectSubmit: ACSubmit AutoConnectText: ACText key_according_to_type \u00b6 This is different for each AutoConnectElements, and the key that can be specified by the type of AutoConnectElements is determined. ACButton \u00b6 value : Specifies the button label. This value also applies to the value attribute of an HTML button tag. action : Specifies an action to be fire on a mouse click on the button. It is mostly used with a JavaScript to activate a script, or it directly describes a JavaScript. ACCheckbox \u00b6 value : Specifies the value to be supplied to the checkbox. It will be packed in the query string as name=value when the checkbox is ticked. label : Specifies a label of the checkbox. Its placement is always to the right of the checkbox. checked : Specifies checking status as a boolean value. The value of the checked checkbox element is packed in the query string and sent. ACElement \u00b6 value : Specifies the source code of generating HTML. The value is native HTML code and is output as HTML as it is. ACFile \u00b6 value : The file name of the upload file will be stored. The value is read-only and will be ignored if specified. label : Specifies a label of the file selection box. Its placement is always to the left of the file selection box. store : Specifies the destination to save the uploaded file. Its value accepts one of the following: fs : Save as the SPIFFS file in flash of ESP8266/ESP32 module. sd : Save to an external SD device connected to ESP8266/ESP32 module. extern : Pass the content of the uploaded file to the uploader which is declared by the sketch individually. Its uploader must inherit AutoConnectUploadHandler class and implements _open , _write and _close function. ACInput \u00b6 value : Specifies the initial text string of the input box. If this value is omitted, placeholder is displayed as the initial string. label : Specifies a label of the input box. Its placement is always to the left of the input box. placeholder : Specifies short hint of the input box. ACRadio \u00b6 value : Specifies the collection of radio buttons as an array element. label : Specifies a label of the collection of radio buttons, not for each button. The arrangement will be the top or left side according to the arrange . arrange : Specifies the orientation of the radio buttons. Its value accepts one of the following: horizontal : Horizontal arrangement. vertical : Vertical arrangement. checked : Specifies the index number (1-based) of the radio buttons collection to be checked. ACSelect \u00b6 label : Specifies a label of the drop-down list. Its placement is always to the left of the drop-down list. option : Specifies the initial value collection of the drop-down list as an array element. ACStyle \u00b6 value : Specifies the custom CSS code. ACSubmit \u00b6 value : Specifies a label of the submit button. uri : Specifies the URI to send form data when the button is clicked. ACText \u00b6 value : Specifies a content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style : Specifies the qualification style to give to the content and can use the style attribute format as it is. format : Specifies how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to the C-style printf library functions, but depends on the espressif sdk implementation. The conversion specification is valid only for %s format. (Left and Right justification, width are also valid.) AutoConnect's JSON parsing process is not perfect It is based on analysis by ArduinoJson, but the semantic analysis is simplified to save memory. Consequently, it is not an error that a custom Web page JSON document to have unnecessary keys. It will be ignored. Loading JSON document \u00b6 Loading to AutoConnect \u00b6 There are two main ways to load the custom Web pages into AutoConnect. Load directly into AutoConnect This way does not require an explicit declaration of AutoConnectAux objects with sketches and is also useful when importing the custom Web pages JSON document from an external file such as SPIFFS because the page definition and sketch coding structure can be separated. Using the AutoCoonnect::load function, AutoConnect dynamically generates the necessary AutoConnectAux objects internally based on the custom Web page definition of the imported JSON document content. In the sketch, the generated AutoConnectAux object can be referenced using the AutoConnect::aux function. You can reach the AutoConnectElements you desired using the AutoConnectAux::getElement function of its AutoConnectAux. In the following example, it loads in a batch a JSON document of custom Web pages stored in SPIFFS and accesses to the AutoConnectInput element. [ { \"title\" : \"page1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" } ] }, { \"title\" : \"page2\" , \"uri\" : \"/page2\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input2\" , \"type\" : \"ACInput\" } ] } ] AutoConnect portal; File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); AutoConnectAux * aux = portal.aux( \"/page1\" ); AutoConnectInput & input1 = aux -> getElement < AutoConnectInput > ( \"input1\" ); Load to AutoConnectAux and join to AutoConnect This way declares AutoConnectAux in the sketch and loads the custom Web pages JSON document there. It has an advantage for if you want to define each page of a custom Web page individually or allocate AutoConnectAux objects dynamically on the sketch side. After loading a JSON document using the AutoConnectAux::load function by each, integrate those into AutoConnect using the AutoConnect::join function. In the following example, you can see the difference between two sketches in a sketch modified using the AutoConnectAux::load. { \"title\" : \"page1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" } ] } { \"title\" : \"page2\" , \"uri\" : \"/page2\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input2\" , \"type\" : \"ACInput\" } ] } AutoConnect portal; AutoConnectAux page1; AutoConnectAux page2; File page = SPIFFS.open( \"/custom_page1.json\" , \"r\" ); page1.load(page); page.close(); page = SPIFFS.open( \"/custom_page2.json\" , \"r\" ); page2.load(page); page.close(); portal.join( { page1, page2 } ); AutoConnectInput & input1 = page1.getElement < AutoConnectInput > ( \"input1\" ); Loading from the streamed file \u00b6 AutoConnect supports loading of JSON document from the following instances: String PROGMEM Stream To load custom Web pages JSON document into AutoConnect, use the load function of the AutoConnect class. Its JSON document can read must be completed as a description interpretable by the ArduinoJson library. It cannot import custom Web pages if there are syntax errors for the JSON. If you can not see the custom Web page prepared by JSON, you can check the syntax with ArduinoJson Assistant . It is useful for pre-checking. bool AutoConnect :: load( const String & aux) bool AutoConnect :: load( const __FlashStringHelper * aux) bool AutoConnect :: load(Stream & aux) An example of using each function is as follows. AutoConnect portal; // Loading from String const String aux = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); portal.load(aux); // Loading from PROGMEM const char aux[] PROGMEM = R\"raw( { \"title\" : \"Page 1 title\", \"uri\" : \"/page1\", \"menu\" : true, \"element\" : [ { \"name\" : \"caption\", \"type\" : \"ACText\", \"value\" : \"hello, world\" } ] } )raw\" ; portal.load(aux); // Loading from Stream assumes \"aux.json\" file should be store in SPIFFS. File aux = SPIFFS.open( \"aux.json\" , \"r\" ); portal.load(aux); aux.close(); AutoConnect passes the given JSON document directly to the parseObject() function of the ArduinoJson library for parsing. Therefore, the constraint of the parseObject() function is applied as it is in the parsing of the JSON document for the AutoConnect. That is, if the JSON string is read-only, duplicating the input string occurs and consumes more memory. Adjust the JSON document buffer size \u00b6 AutoConnect uses ArduinoJson library's dynamic buffer to parse JSON documents. Its dynamic buffer allocation scheme depends on the version 5 or version 6 of ArduinoJson library. Either version must have enough buffer to parse the custom web page's JSON document successfully. AutoConnect has the following three constants internally to complete the parsing as much as possible in both ArduinoJson version. These constants are macro defined in AutoConnectDefs.h . If memory insufficiency occurs during JSON document parsing, you can adjust these constants to avoid insufficiency by using the JsonAssistant with deriving the required buffer size in advance. #define AUTOCONNECT_JSONBUFFER_SIZE 256 #define AUTOCONNECT_JSONDOCUMENT_SIZE (8 * 1024) #define AUTOCONNECT_JSONPSRAM_SIZE (16* 1024) AUTOCONNECT_JSONBUFFER_SIZE \u00b6 This is a unit size constant of DynamicJsonBuffer and works when the library used is ArduinoJson version 5. A buffer size of the JSON document increases with this unit. This value relates to the impact of the fragmented heap area. If it is too large, may occur run-out of memory. AUTOCONNECT_JSONDOCUMENT_SIZE \u00b6 This is a size of DynamicJsonDocument for ArduinoJson version 6. This buffer is not automatically expanding, and the size determines the limit. AUTOCONNECT_JSONPSRAM_SIZE \u00b6 For ESP32 module equips with PSRAM, you can allocate the JSON document buffer to PSRAM. Buffer allocation to PSRAM will enable when PSRAM:Enabled option selected in the Arduino IDE's Board Manager menu. It is available since ArduinoJson 6.10.0. Saving JSON document \u00b6 The sketch can persist AutoConnectElements as a JSON document and also uses this function to save the values \u200b\u200bentered on the custom Web page. And you can reload the saved JSON document into AutoConnectElements as the field in a custom Web page using the load function . Loading and saving AutoConnect parameters adopt this method. \u21a9","title":"Custom Web pages with JSON"},{"location":"acjson.html#json-objects-elements-for-the-custom-web-page","text":"","title":"JSON objects &amp; elements for the custom Web page"},{"location":"acjson.html#json-document-structure-for-autoconnectaux","text":"AutoConnectAux will configure custom Web pages with JSON objects. The elements that make up the object are as follows: { \"title\" : title , \"uri\" : uri , \"menu\" : true | false , \"element\" : element_array }","title":" JSON document structure for AutoConnectAux"},{"location":"acjson.html#title","text":"A title of the custom Web page. This is string value. String specified title will be displayed in the AutoConnection menu.","title":" title"},{"location":"acjson.html#uri","text":"String of URI path that specifies where to place the custom Web page. It needs to be a location from the root path including ' / '.","title":" uri"},{"location":"acjson.html#menu","text":"This is a Boolean value indicating whether to include the custom Web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu.","title":" menu"},{"location":"acjson.html#element","text":"Describe an array of JSON objects as element_array . It is a JSON object array of the AutoConnectElements that make up the custom Web page. Order of elements on a custom Web page The order in which AutoConnectElements are placed on a custom Web page is the order in the JSON document.","title":" element"},{"location":"acjson.html#multiple-custom-web-pages-declaration-in-json-document","text":"You can put declarations of multiple custom Web pages in one JSON document. In that case, declare an array of each custom Web page with JSON. The following JSON document contains three custom Web pages: [ { \"title\" : \"Page 1 title\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page2\" } ] }, { \"title\" : \"Page 1 title\" , \"uri\" : \"/page2\" , \"menu\" : false , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"Good day\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page3\" } ] }, { \"title\" : \"Page 3 title\" , \"uri\" : \"/page3\" , \"menu\" : true , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"bye\" } ] } ] The above custom Web page definitions can be loaded in a batch using the AutoConnect::load function.","title":" Multiple custom Web pages declaration in JSON document"},{"location":"acjson.html#json-object-for-autoconnectelements","text":"JSON description for AutoConnectElements describes as an array in the element with arguments of each constructor . { \"name\" : name , \"type\" : type , key_according_to_type : the_value | array_of_value , [ key_according_to_type : the_value | array_of_value ] }","title":" JSON object for AutoConnectElements"},{"location":"acjson.html#name","text":"A string of the name for the element.","title":" name"},{"location":"acjson.html#type","text":"A string of the type for the element. For this type, specify the following string corresponding to each element. AutoConnectButton: ACButton AutoConnectCheckbox: ACCheckbox AutoConnectElement: ACElement AutoConnectFile: ACFile AutoConnectInput: ACInput AutoConnectRadio: ACRadio AutoConnectSelect: ACSelect AutoConnectStyle: ACStyle AutoConnectSubmit: ACSubmit AutoConnectText: ACText","title":" type"},{"location":"acjson.html#key_according_to_type","text":"This is different for each AutoConnectElements, and the key that can be specified by the type of AutoConnectElements is determined.","title":" key_according_to_type"},{"location":"acjson.html#acbutton","text":"value : Specifies the button label. This value also applies to the value attribute of an HTML button tag. action : Specifies an action to be fire on a mouse click on the button. It is mostly used with a JavaScript to activate a script, or it directly describes a JavaScript.","title":" ACButton"},{"location":"acjson.html#accheckbox","text":"value : Specifies the value to be supplied to the checkbox. It will be packed in the query string as name=value when the checkbox is ticked. label : Specifies a label of the checkbox. Its placement is always to the right of the checkbox. checked : Specifies checking status as a boolean value. The value of the checked checkbox element is packed in the query string and sent.","title":" ACCheckbox"},{"location":"acjson.html#acelement","text":"value : Specifies the source code of generating HTML. The value is native HTML code and is output as HTML as it is.","title":" ACElement"},{"location":"acjson.html#acfile","text":"value : The file name of the upload file will be stored. The value is read-only and will be ignored if specified. label : Specifies a label of the file selection box. Its placement is always to the left of the file selection box. store : Specifies the destination to save the uploaded file. Its value accepts one of the following: fs : Save as the SPIFFS file in flash of ESP8266/ESP32 module. sd : Save to an external SD device connected to ESP8266/ESP32 module. extern : Pass the content of the uploaded file to the uploader which is declared by the sketch individually. Its uploader must inherit AutoConnectUploadHandler class and implements _open , _write and _close function.","title":" ACFile"},{"location":"acjson.html#acinput","text":"value : Specifies the initial text string of the input box. If this value is omitted, placeholder is displayed as the initial string. label : Specifies a label of the input box. Its placement is always to the left of the input box. placeholder : Specifies short hint of the input box.","title":" ACInput"},{"location":"acjson.html#acradio","text":"value : Specifies the collection of radio buttons as an array element. label : Specifies a label of the collection of radio buttons, not for each button. The arrangement will be the top or left side according to the arrange . arrange : Specifies the orientation of the radio buttons. Its value accepts one of the following: horizontal : Horizontal arrangement. vertical : Vertical arrangement. checked : Specifies the index number (1-based) of the radio buttons collection to be checked.","title":" ACRadio"},{"location":"acjson.html#acselect","text":"label : Specifies a label of the drop-down list. Its placement is always to the left of the drop-down list. option : Specifies the initial value collection of the drop-down list as an array element.","title":" ACSelect"},{"location":"acjson.html#acstyle","text":"value : Specifies the custom CSS code.","title":" ACStyle"},{"location":"acjson.html#acsubmit","text":"value : Specifies a label of the submit button. uri : Specifies the URI to send form data when the button is clicked.","title":" ACSubmit"},{"location":"acjson.html#actext","text":"value : Specifies a content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style : Specifies the qualification style to give to the content and can use the style attribute format as it is. format : Specifies how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to the C-style printf library functions, but depends on the espressif sdk implementation. The conversion specification is valid only for %s format. (Left and Right justification, width are also valid.) AutoConnect's JSON parsing process is not perfect It is based on analysis by ArduinoJson, but the semantic analysis is simplified to save memory. Consequently, it is not an error that a custom Web page JSON document to have unnecessary keys. It will be ignored.","title":" ACText"},{"location":"acjson.html#loading-json-document","text":"","title":"Loading JSON document"},{"location":"acjson.html#loading-to-autoconnect","text":"There are two main ways to load the custom Web pages into AutoConnect. Load directly into AutoConnect This way does not require an explicit declaration of AutoConnectAux objects with sketches and is also useful when importing the custom Web pages JSON document from an external file such as SPIFFS because the page definition and sketch coding structure can be separated. Using the AutoCoonnect::load function, AutoConnect dynamically generates the necessary AutoConnectAux objects internally based on the custom Web page definition of the imported JSON document content. In the sketch, the generated AutoConnectAux object can be referenced using the AutoConnect::aux function. You can reach the AutoConnectElements you desired using the AutoConnectAux::getElement function of its AutoConnectAux. In the following example, it loads in a batch a JSON document of custom Web pages stored in SPIFFS and accesses to the AutoConnectInput element. [ { \"title\" : \"page1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" } ] }, { \"title\" : \"page2\" , \"uri\" : \"/page2\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input2\" , \"type\" : \"ACInput\" } ] } ] AutoConnect portal; File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); AutoConnectAux * aux = portal.aux( \"/page1\" ); AutoConnectInput & input1 = aux -> getElement < AutoConnectInput > ( \"input1\" ); Load to AutoConnectAux and join to AutoConnect This way declares AutoConnectAux in the sketch and loads the custom Web pages JSON document there. It has an advantage for if you want to define each page of a custom Web page individually or allocate AutoConnectAux objects dynamically on the sketch side. After loading a JSON document using the AutoConnectAux::load function by each, integrate those into AutoConnect using the AutoConnect::join function. In the following example, you can see the difference between two sketches in a sketch modified using the AutoConnectAux::load. { \"title\" : \"page1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" } ] } { \"title\" : \"page2\" , \"uri\" : \"/page2\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input2\" , \"type\" : \"ACInput\" } ] } AutoConnect portal; AutoConnectAux page1; AutoConnectAux page2; File page = SPIFFS.open( \"/custom_page1.json\" , \"r\" ); page1.load(page); page.close(); page = SPIFFS.open( \"/custom_page2.json\" , \"r\" ); page2.load(page); page.close(); portal.join( { page1, page2 } ); AutoConnectInput & input1 = page1.getElement < AutoConnectInput > ( \"input1\" );","title":" Loading to AutoConnect"},{"location":"acjson.html#loading-from-the-streamed-file","text":"AutoConnect supports loading of JSON document from the following instances: String PROGMEM Stream To load custom Web pages JSON document into AutoConnect, use the load function of the AutoConnect class. Its JSON document can read must be completed as a description interpretable by the ArduinoJson library. It cannot import custom Web pages if there are syntax errors for the JSON. If you can not see the custom Web page prepared by JSON, you can check the syntax with ArduinoJson Assistant . It is useful for pre-checking. bool AutoConnect :: load( const String & aux) bool AutoConnect :: load( const __FlashStringHelper * aux) bool AutoConnect :: load(Stream & aux) An example of using each function is as follows. AutoConnect portal; // Loading from String const String aux = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); portal.load(aux); // Loading from PROGMEM const char aux[] PROGMEM = R\"raw( { \"title\" : \"Page 1 title\", \"uri\" : \"/page1\", \"menu\" : true, \"element\" : [ { \"name\" : \"caption\", \"type\" : \"ACText\", \"value\" : \"hello, world\" } ] } )raw\" ; portal.load(aux); // Loading from Stream assumes \"aux.json\" file should be store in SPIFFS. File aux = SPIFFS.open( \"aux.json\" , \"r\" ); portal.load(aux); aux.close(); AutoConnect passes the given JSON document directly to the parseObject() function of the ArduinoJson library for parsing. Therefore, the constraint of the parseObject() function is applied as it is in the parsing of the JSON document for the AutoConnect. That is, if the JSON string is read-only, duplicating the input string occurs and consumes more memory.","title":" Loading from the streamed file"},{"location":"acjson.html#adjust-the-json-document-buffer-size","text":"AutoConnect uses ArduinoJson library's dynamic buffer to parse JSON documents. Its dynamic buffer allocation scheme depends on the version 5 or version 6 of ArduinoJson library. Either version must have enough buffer to parse the custom web page's JSON document successfully. AutoConnect has the following three constants internally to complete the parsing as much as possible in both ArduinoJson version. These constants are macro defined in AutoConnectDefs.h . If memory insufficiency occurs during JSON document parsing, you can adjust these constants to avoid insufficiency by using the JsonAssistant with deriving the required buffer size in advance. #define AUTOCONNECT_JSONBUFFER_SIZE 256 #define AUTOCONNECT_JSONDOCUMENT_SIZE (8 * 1024) #define AUTOCONNECT_JSONPSRAM_SIZE (16* 1024)","title":" Adjust the JSON document buffer size"},{"location":"acjson.html#autoconnect_jsonbuffer_size","text":"This is a unit size constant of DynamicJsonBuffer and works when the library used is ArduinoJson version 5. A buffer size of the JSON document increases with this unit. This value relates to the impact of the fragmented heap area. If it is too large, may occur run-out of memory.","title":"AUTOCONNECT_JSONBUFFER_SIZE"},{"location":"acjson.html#autoconnect_jsondocument_size","text":"This is a size of DynamicJsonDocument for ArduinoJson version 6. This buffer is not automatically expanding, and the size determines the limit.","title":"AUTOCONNECT_JSONDOCUMENT_SIZE"},{"location":"acjson.html#autoconnect_jsonpsram_size","text":"For ESP32 module equips with PSRAM, you can allocate the JSON document buffer to PSRAM. Buffer allocation to PSRAM will enable when PSRAM:Enabled option selected in the Arduino IDE's Board Manager menu. It is available since ArduinoJson 6.10.0.","title":"AUTOCONNECT_JSONPSRAM_SIZE"},{"location":"acjson.html#saving-json-document","text":"The sketch can persist AutoConnectElements as a JSON document and also uses this function to save the values \u200b\u200bentered on the custom Web page. And you can reload the saved JSON document into AutoConnectElements as the field in a custom Web page using the load function . Loading and saving AutoConnect parameters adopt this method. \u21a9","title":"Saving JSON document"},{"location":"acupload.html","text":"Uploading file from Web Browser \u00b6 If you have to write some data individually to the ESP8266/ESP32 module for the sketch behavior, the AutoConnectFile element will assist with your wants implementation. The AutoConnectFile element produces an HTML <input type=\"file\"> tag and can save uploaded file to the flash or external SD of the ESP8266/ESP32 module. The handler for saving is built into AutoConnect. You can use it to inject any sketch data such as the initial values for the custom Web page into the ESP module via OTA without using the sketch data upload tool of Arduino-IDE. Basic steps of the file upload sketch \u00b6 Here is the basic procedure of the sketch which can upload files from the client browser using AutoConnectFile: 1 Place AutoConnectFile on a custom Web page by writing JSON or constructor code directly with the sketch. Place other AutoConnectElements as needed. Place AutoConnectSubmit on the same custom Web page. Perform the following process in the on-handler of submitting destination: Retrieve the AutoConnectFile instance from the custom Web page where you placed the AutoConnectFile element using the AutoConnectAux::getElement function or the operator [] . Start access to the device specified as the upload destination. In usually, it depends on the file system's begin function. For example, if you specified Flash's SPIFFS as the upload destination, invokes SPIFFS.begin() . The value member of AutoConnectFile contains the file name of the upload file. Use its file name to access the uploaded file on the device. Invokes the end function associated with the begin to close the device. It is the SPIFFS.end()* if the flash on the ESP module has been begun for SPIFFS. The following sketch is an example that implements the above basic steps. The postUpload function is the on-handler and retrieves the AutoConnectFile as named upload_file . You should note that this handler is not for a custom Web page placed with its AutoConnectFile element. The uploaded file should be processed by the handler for the transition destination page from the AutoConnectFile element placed page. AutoConnect built-in upload handler will save the uploaded file to the specified device before invoking the postUpload function. However, If you use uploaded files in different situations, it may be more appropriate to place the actual handling process outside the handler. It applies for the parameter file, etc. The important thing is that you do not have to sketch file reception and storing logic by using the AutoConnectFile element and the upload handler built into the AutoConnect. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> // Upload request custom Web page static const char PAGE_UPLOAD[] PROGMEM = R\"( { \"uri\": \"/\", \"title\": \"Upload\", \"menu\": true, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading platform<h2>\" }, { \"name\":\"upload_file\", \"type\":\"ACFile\", \"label\":\"Select file: \", \"store\":\"fs\" }, { \"name\":\"upload\", \"type\":\"ACSubmit\", \"value\":\"UPLOAD\", \"uri\":\"/upload\" } ] } )\" ; // Upload result display static const char PAGE_BROWSE[] PROGMEM = R\"( { \"uri\": \"/upload\", \"title\": \"Upload\", \"menu\": false, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>Uploading ended<h2>\" }, { \"name\":\"filename\", \"type\":\"ACText\" }, { \"name\":\"size\", \"type\":\"ACText\", \"format\":\"%s bytes uploaded\" }, { \"name\":\"content_type\", \"type\":\"ACText\", \"format\":\"Content: %s\" } ] } )\" ; ESP8266WebServer server; AutoConnect portal (server); // Declare AutoConnectAux separately as a custom web page to access // easily for each page in the post-upload handler. AutoConnectAux auxUpload; AutoConnectAux auxBrowse; /** * Post uploading, AutoConnectFile's built-in upload handler reads the * file saved in SPIFFS and displays the file contents on /upload custom * web page. However, only files with mime type uploaded as text are * displayed. A custom web page handler is called after upload. * @param aux AutoConnectAux(/upload) * @param args PageArgument * @return Uploaded text content */ String postUpload (AutoConnectAux & aux, PageArgument & args) { String content; AutoConnectFile & upload = auxUpload[ \"upload_file\" ].as < AutoConnectFile > (); AutoConnectText & aux_filename = aux[ \"filename\" ].as < AutoConnectText > (); AutoConnectText & aux_size = aux[ \"size\" ].as < AutoConnectText > (); AutoConnectText & aux_contentType = aux[ \"content_type\" ].as < AutoConnectText > (); // Assignment operator can be used for the element attribute. aux_filename.value = upload.value; aux_size.value = String(upload.size); aux_contentType.value = upload.mimeType; // The file saved by the AutoConnect upload handler is read from // the EEPROM and echoed to a custom web page. SPIFFS.begin(); File uploadFile = SPIFFS.open(String( \"/\" + upload.value).c_str(), \"r\" ); if (uploadFile) { while (uploadFile.available()) { char c = uploadFile.read(); Serial.print(c); } uploadFile.close(); } else content = \"Not saved\" ; SPIFFS.end(); return String(); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); auxUpload.load(PAGE_UPLOAD); auxBrowse.load(PAGE_BROWSE); portal.join({ auxUpload, auxBrowse }); auxBrowse.on(postUpload); portal.begin(); } void loop () { portal.handleClient(); } Where will the file upload \u00b6 The AutoConnect built-in upload handler can save the upload file to three locations: Flash memory embedded in the ESP8266/ESP32 module SD device externally connected to the ESP8266/ESP32 module Other character devices You can specify the device type to save with the store attribute of AutoConnectFile, and it accepts the following values: Flash : AC_File_FS for the API parameter or fs for the JSON document SD : AC_File_SD for the API parameter or sd for the JSON document Other : AC_File_Extern for the API parameter or extern for the JSON document The substance of AC_File_FS (fs) is a SPIFFS file system implemented by the ESP8266/ESP32 core, and then AutoConnect uses the Global Instance SPIFFS to access SPIFFS. Also, the substance of AC_File_SD (sd) is a FAT file of Arduino SD library ported to the ESP8266/ESP32 core, and then AutoConnect uses the Global Instance SD to access SD. When saving to an external SD device, there are additional required parameters for the connection interface and is defined as the macro in AutoConnectDefs.h. #define AUTOCONNECT_SD_CS SS #define AUTOCONNECT_SD_SPEED 4000000 AUTOCONNECT_SD_CS defines which GPIO for the CS (Chip Select, or SS as Slave Select) pin. This definition is derived from pins_arduino.h, which is included in the Arduino core distribution. If you want to assign the CS pin to another GPIO, you need to change the macro definition of AutoConnectDefs.h. AUTOCONNECT_SD_SPEED defines SPI clock speed depending on the connected device. Involves both the begin() and the end() The built-in uploader executes the begin and end functions regardless of the sketch whence the file system of the device will terminate with the uploader termination. Therefore, to use the device in the sketch after uploading, you need to restart it with the begin function. When it will be uploaded \u00b6 Upload handler will be launched by ESP8266WebServer/WebServer(as ESP32) library which is triggered by receiving an HTTP stream of POST BODY including file content. Its launching occurs before invoking the page handler. The following diagram illustrates the file uploading sequence: At the time of the page handler behaves, the uploaded file already saved to the device, and the member variables of AutoConnectFile reflects the file name and transfer size. The file name for the uploaded file \u00b6 AutoConnetFile saves the uploaded file with the file name you selected by <input type=\"file\"> tag on the browser. The file name used for uploading is stored in the AutoConnetFile's value member, which you can access after uploading. (i.e. In the handler of the destination page by the AutoConnectSubmit element.) You can not save it with a different name. It can be renamed after upload if you need to change the name. Upload to a device other than Flash or SD \u00b6 You can output the file to any device using a custom uploader by specifying extern with the store attribute of AutoConnectFile (or specifying AC_File_Extern for the store member variable) and can customize the uploader according to the need to upload files to other than Flash or SD. Implements your own uploader with inheriting the AutoConnectUploadHandler class which is the base class of the upload handler. It's not so difficult Implementing the custom uploader requires a little knowledge of the c++ language. If you are less attuned to programming c++, you may find it difficult. But don't worry. You can make it in various situations by just modifying the sketch skeleton that appears at the end of this page. Upload handler base class \u00b6 AutoConnectUploadHandler is a base class of upload handler and It has one public member function and three protected functions. Constructor \u00b6 AutoConnectUploadHandler() Member functions \u00b6 The upload public function is an entry point, the ESP8266WebServer (WebServer as ESP32) library will invoke the upload with each time of uploading content divided into chunks. Also, the _open , _write and _close protected functions are actually responsible for saving files and are declared as pure virtual functions. A custom uploader class that inherits from the AutoConnectUploadHandler class need to implement these functions. The actual upload process is handled by the three private functions above, and then upload only invokes three functions according to the upload situation. In usually, there is no need to override the upload function in an inherited class. public virtual void upload( const String & requestUri, const HTTPUpload & upload) Parameters requestUri URI of upload request source. upload A data structure of the upload file as HTTPUpload . It is defined in the ESP8266WebServer (WebServer as ESP32) library as follows: typedef struct { HTTPUploadStatus status; String filename; String name; String type; size_t totalSize; size_t currentSize; size_t contentLength; uint8_t buf[HTTP_UPLOAD_BUFLEN]; } HTTPUpload; The upload handler needs to implement processing based on the enumeration value of HTTPUpload.status as HTTPUploadStatus enum type. HTTPUploadStatus enumeration is as follows: UPLOAD_FILE_START : Invokes to the _open. UPLOAD_FILE_WRITE : Invokes to the _write. UPLOAD_FILE_END : Invokes to the _close. UPLOAD_FILE_ABORTED : Invokes to the _close. The _open function will be invoked when HTTPUploadStatus is UPLOAD_FILE_START . Usually, the implementation of an inherited class will open the file. protected virtual bool _open( const char * filename, const char * mode) = 0 Parameters filename Uploading file name. mode An indicator for the file access mode, a \"w\" for writing. Return value true File open successful. false Failed to open. The _write function will be invoked when HTTPUploadStatus is UPLOAD_FILE_WRITE . The content of the upload file is divided and the _write will be invoked in multiple times. Usually, the implementation of an inherited class will write data. protected virtual size_t _write( const uint8_t * buf, const size_t size)) = 0 Parameters buf File content block. size File block size to write. Return value Size written. The _close function will be invoked when HTTPUploadStatus is UPLOAD_FILE_END or UPLOAD_FILE_ABORTED . Usually, the implementation of an inherited class will close the file. protected virtual void _close( void ) = 0 For reference, the following AutoConnectUploadFS class is an implementation of AutoConnect built-in uploader and inherits from AutoConnectUploadHandler. class AutoConnectUploadFS : public AutoConnectUploadHandler { public : explicit AutoConnectUploadFS(SPIFFST & media) : _media( & media) {} ~ AutoConnectUploadFS() { _close(); } protected : bool _open( const char * filename, const char * mode) override { if (_media -> begin()) { _file = _media -> open(filename, mode); return _file != false; } return false; } size_t _write( const uint8_t * buf, const size_t size) override { if (_file) return _file.write(buf, size); else return - 1 ; } void _close( void ) override { if (_file) _file.close(); _media -> end(); } private : SPIFFST * _media; SPIFileT _file; }; Register custom upload handler \u00b6 In order to upload a file by the custom uploader, it is necessary to register it to the custom Web page beforehand. To register a custom uploader, specify the custom uploader class name in the template argument of the AutoConnectAux::onUpload function and invokes it. void AutoConnectAux :: onUpload < T > (T & uploadClass) Parameters T Specifies a class name of the custom uploader. This class name is a class that you implemented by inheriting AutoConnectUploadHandler for custom upload. uploadClass Specifies the custom upload class instance. The rough structure of the sketches that completed these implementations will be as follows: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char PAGE_UPLOAD[] PROGMEM = R\"( { \"uri\": \"/\", \"title\": \"Upload\", \"menu\": true, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading platform<h2>\" }, { \"name\":\"upload_file\", \"type\":\"ACFile\", \"label\":\"Select file: \", \"store\":\"extern\" }, { \"name\":\"upload\", \"type\":\"ACSubmit\", \"value\":\"UPLOAD\", \"uri\":\"/upload\" } ] } )\" ; static const char PAGE_RECEIVED[] PROGMEM = R\"( { \"uri\": \"/upload\", \"title\": \"Upload ended\", \"menu\": false, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading ended<h2>\" } ] } )\" ; // Custom upload handler class class CustomUploader : public AutoConnectUploadHandler { public : CustomUploader() {} ~ CustomUploader() {} protected : bool _open( const char * filename, const char * mode) override ; size_t _write ( const uint8_t * buf, const size_t size) override ; void _close ( void ) override ; }; // _open for custom open bool CustomUploader :: _open( const char * filename, const char * mode) { // Here, an implementation for the open file. } // _open for custom write size_t CustomUploader :: _write( const uint8_t * buf, const size_t size) { // Here, an implementation for the writing the file data. } // _open for custom close void CustomUploader :: _close( void ) { // Here, an implementation for the close file. } AutoConnect portal; AutoConnectAux uploadPage; AutoConnectAux receivePage; CustomUploader uploader; // Declare the custom uploader void setup () { uploadPage.load(PAGE_UPLOAD); receivePage.load(PAGE_RECEIVED); portal.join({ uploadPage, receivePage }); receivePage.onUpload < CustomUploader > (uploader); // Register the custom uploader portal.begin(); } void loop () { portal.handleClient(); } Don't forget to specify the store When using a custom uploader, remember to specify the extern for the store attribute of AutoConnectFile. window.onload = function() { Gifffer(); }; The AutoConnectFile element can be used with other AutoConnectElements on the same page. \u21a9","title":"File upload handler"},{"location":"acupload.html#uploading-file-from-web-browser","text":"If you have to write some data individually to the ESP8266/ESP32 module for the sketch behavior, the AutoConnectFile element will assist with your wants implementation. The AutoConnectFile element produces an HTML <input type=\"file\"> tag and can save uploaded file to the flash or external SD of the ESP8266/ESP32 module. The handler for saving is built into AutoConnect. You can use it to inject any sketch data such as the initial values for the custom Web page into the ESP module via OTA without using the sketch data upload tool of Arduino-IDE.","title":"Uploading file from Web Browser"},{"location":"acupload.html#basic-steps-of-the-file-upload-sketch","text":"Here is the basic procedure of the sketch which can upload files from the client browser using AutoConnectFile: 1 Place AutoConnectFile on a custom Web page by writing JSON or constructor code directly with the sketch. Place other AutoConnectElements as needed. Place AutoConnectSubmit on the same custom Web page. Perform the following process in the on-handler of submitting destination: Retrieve the AutoConnectFile instance from the custom Web page where you placed the AutoConnectFile element using the AutoConnectAux::getElement function or the operator [] . Start access to the device specified as the upload destination. In usually, it depends on the file system's begin function. For example, if you specified Flash's SPIFFS as the upload destination, invokes SPIFFS.begin() . The value member of AutoConnectFile contains the file name of the upload file. Use its file name to access the uploaded file on the device. Invokes the end function associated with the begin to close the device. It is the SPIFFS.end()* if the flash on the ESP module has been begun for SPIFFS. The following sketch is an example that implements the above basic steps. The postUpload function is the on-handler and retrieves the AutoConnectFile as named upload_file . You should note that this handler is not for a custom Web page placed with its AutoConnectFile element. The uploaded file should be processed by the handler for the transition destination page from the AutoConnectFile element placed page. AutoConnect built-in upload handler will save the uploaded file to the specified device before invoking the postUpload function. However, If you use uploaded files in different situations, it may be more appropriate to place the actual handling process outside the handler. It applies for the parameter file, etc. The important thing is that you do not have to sketch file reception and storing logic by using the AutoConnectFile element and the upload handler built into the AutoConnect. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> // Upload request custom Web page static const char PAGE_UPLOAD[] PROGMEM = R\"( { \"uri\": \"/\", \"title\": \"Upload\", \"menu\": true, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading platform<h2>\" }, { \"name\":\"upload_file\", \"type\":\"ACFile\", \"label\":\"Select file: \", \"store\":\"fs\" }, { \"name\":\"upload\", \"type\":\"ACSubmit\", \"value\":\"UPLOAD\", \"uri\":\"/upload\" } ] } )\" ; // Upload result display static const char PAGE_BROWSE[] PROGMEM = R\"( { \"uri\": \"/upload\", \"title\": \"Upload\", \"menu\": false, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>Uploading ended<h2>\" }, { \"name\":\"filename\", \"type\":\"ACText\" }, { \"name\":\"size\", \"type\":\"ACText\", \"format\":\"%s bytes uploaded\" }, { \"name\":\"content_type\", \"type\":\"ACText\", \"format\":\"Content: %s\" } ] } )\" ; ESP8266WebServer server; AutoConnect portal (server); // Declare AutoConnectAux separately as a custom web page to access // easily for each page in the post-upload handler. AutoConnectAux auxUpload; AutoConnectAux auxBrowse; /** * Post uploading, AutoConnectFile's built-in upload handler reads the * file saved in SPIFFS and displays the file contents on /upload custom * web page. However, only files with mime type uploaded as text are * displayed. A custom web page handler is called after upload. * @param aux AutoConnectAux(/upload) * @param args PageArgument * @return Uploaded text content */ String postUpload (AutoConnectAux & aux, PageArgument & args) { String content; AutoConnectFile & upload = auxUpload[ \"upload_file\" ].as < AutoConnectFile > (); AutoConnectText & aux_filename = aux[ \"filename\" ].as < AutoConnectText > (); AutoConnectText & aux_size = aux[ \"size\" ].as < AutoConnectText > (); AutoConnectText & aux_contentType = aux[ \"content_type\" ].as < AutoConnectText > (); // Assignment operator can be used for the element attribute. aux_filename.value = upload.value; aux_size.value = String(upload.size); aux_contentType.value = upload.mimeType; // The file saved by the AutoConnect upload handler is read from // the EEPROM and echoed to a custom web page. SPIFFS.begin(); File uploadFile = SPIFFS.open(String( \"/\" + upload.value).c_str(), \"r\" ); if (uploadFile) { while (uploadFile.available()) { char c = uploadFile.read(); Serial.print(c); } uploadFile.close(); } else content = \"Not saved\" ; SPIFFS.end(); return String(); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); auxUpload.load(PAGE_UPLOAD); auxBrowse.load(PAGE_BROWSE); portal.join({ auxUpload, auxBrowse }); auxBrowse.on(postUpload); portal.begin(); } void loop () { portal.handleClient(); }","title":"Basic steps of the file upload sketch"},{"location":"acupload.html#where-will-the-file-upload","text":"The AutoConnect built-in upload handler can save the upload file to three locations: Flash memory embedded in the ESP8266/ESP32 module SD device externally connected to the ESP8266/ESP32 module Other character devices You can specify the device type to save with the store attribute of AutoConnectFile, and it accepts the following values: Flash : AC_File_FS for the API parameter or fs for the JSON document SD : AC_File_SD for the API parameter or sd for the JSON document Other : AC_File_Extern for the API parameter or extern for the JSON document The substance of AC_File_FS (fs) is a SPIFFS file system implemented by the ESP8266/ESP32 core, and then AutoConnect uses the Global Instance SPIFFS to access SPIFFS. Also, the substance of AC_File_SD (sd) is a FAT file of Arduino SD library ported to the ESP8266/ESP32 core, and then AutoConnect uses the Global Instance SD to access SD. When saving to an external SD device, there are additional required parameters for the connection interface and is defined as the macro in AutoConnectDefs.h. #define AUTOCONNECT_SD_CS SS #define AUTOCONNECT_SD_SPEED 4000000 AUTOCONNECT_SD_CS defines which GPIO for the CS (Chip Select, or SS as Slave Select) pin. This definition is derived from pins_arduino.h, which is included in the Arduino core distribution. If you want to assign the CS pin to another GPIO, you need to change the macro definition of AutoConnectDefs.h. AUTOCONNECT_SD_SPEED defines SPI clock speed depending on the connected device. Involves both the begin() and the end() The built-in uploader executes the begin and end functions regardless of the sketch whence the file system of the device will terminate with the uploader termination. Therefore, to use the device in the sketch after uploading, you need to restart it with the begin function.","title":"Where will the file upload"},{"location":"acupload.html#when-it-will-be-uploaded","text":"Upload handler will be launched by ESP8266WebServer/WebServer(as ESP32) library which is triggered by receiving an HTTP stream of POST BODY including file content. Its launching occurs before invoking the page handler. The following diagram illustrates the file uploading sequence: At the time of the page handler behaves, the uploaded file already saved to the device, and the member variables of AutoConnectFile reflects the file name and transfer size.","title":"When it will be uploaded"},{"location":"acupload.html#the-file-name-for-the-uploaded-file","text":"AutoConnetFile saves the uploaded file with the file name you selected by <input type=\"file\"> tag on the browser. The file name used for uploading is stored in the AutoConnetFile's value member, which you can access after uploading. (i.e. In the handler of the destination page by the AutoConnectSubmit element.) You can not save it with a different name. It can be renamed after upload if you need to change the name.","title":"The file name for the uploaded file"},{"location":"acupload.html#upload-to-a-device-other-than-flash-or-sd","text":"You can output the file to any device using a custom uploader by specifying extern with the store attribute of AutoConnectFile (or specifying AC_File_Extern for the store member variable) and can customize the uploader according to the need to upload files to other than Flash or SD. Implements your own uploader with inheriting the AutoConnectUploadHandler class which is the base class of the upload handler. It's not so difficult Implementing the custom uploader requires a little knowledge of the c++ language. If you are less attuned to programming c++, you may find it difficult. But don't worry. You can make it in various situations by just modifying the sketch skeleton that appears at the end of this page.","title":"Upload to a device other than Flash or SD"},{"location":"acupload.html#upload-handler-base-class","text":"AutoConnectUploadHandler is a base class of upload handler and It has one public member function and three protected functions.","title":" Upload handler base class"},{"location":"acupload.html#constructor","text":"AutoConnectUploadHandler()","title":" Constructor"},{"location":"acupload.html#member-functions","text":"The upload public function is an entry point, the ESP8266WebServer (WebServer as ESP32) library will invoke the upload with each time of uploading content divided into chunks. Also, the _open , _write and _close protected functions are actually responsible for saving files and are declared as pure virtual functions. A custom uploader class that inherits from the AutoConnectUploadHandler class need to implement these functions. The actual upload process is handled by the three private functions above, and then upload only invokes three functions according to the upload situation. In usually, there is no need to override the upload function in an inherited class. public virtual void upload( const String & requestUri, const HTTPUpload & upload) Parameters requestUri URI of upload request source. upload A data structure of the upload file as HTTPUpload . It is defined in the ESP8266WebServer (WebServer as ESP32) library as follows: typedef struct { HTTPUploadStatus status; String filename; String name; String type; size_t totalSize; size_t currentSize; size_t contentLength; uint8_t buf[HTTP_UPLOAD_BUFLEN]; } HTTPUpload; The upload handler needs to implement processing based on the enumeration value of HTTPUpload.status as HTTPUploadStatus enum type. HTTPUploadStatus enumeration is as follows: UPLOAD_FILE_START : Invokes to the _open. UPLOAD_FILE_WRITE : Invokes to the _write. UPLOAD_FILE_END : Invokes to the _close. UPLOAD_FILE_ABORTED : Invokes to the _close. The _open function will be invoked when HTTPUploadStatus is UPLOAD_FILE_START . Usually, the implementation of an inherited class will open the file. protected virtual bool _open( const char * filename, const char * mode) = 0 Parameters filename Uploading file name. mode An indicator for the file access mode, a \"w\" for writing. Return value true File open successful. false Failed to open. The _write function will be invoked when HTTPUploadStatus is UPLOAD_FILE_WRITE . The content of the upload file is divided and the _write will be invoked in multiple times. Usually, the implementation of an inherited class will write data. protected virtual size_t _write( const uint8_t * buf, const size_t size)) = 0 Parameters buf File content block. size File block size to write. Return value Size written. The _close function will be invoked when HTTPUploadStatus is UPLOAD_FILE_END or UPLOAD_FILE_ABORTED . Usually, the implementation of an inherited class will close the file. protected virtual void _close( void ) = 0 For reference, the following AutoConnectUploadFS class is an implementation of AutoConnect built-in uploader and inherits from AutoConnectUploadHandler. class AutoConnectUploadFS : public AutoConnectUploadHandler { public : explicit AutoConnectUploadFS(SPIFFST & media) : _media( & media) {} ~ AutoConnectUploadFS() { _close(); } protected : bool _open( const char * filename, const char * mode) override { if (_media -> begin()) { _file = _media -> open(filename, mode); return _file != false; } return false; } size_t _write( const uint8_t * buf, const size_t size) override { if (_file) return _file.write(buf, size); else return - 1 ; } void _close( void ) override { if (_file) _file.close(); _media -> end(); } private : SPIFFST * _media; SPIFileT _file; };","title":" Member functions"},{"location":"acupload.html#register-custom-upload-handler","text":"In order to upload a file by the custom uploader, it is necessary to register it to the custom Web page beforehand. To register a custom uploader, specify the custom uploader class name in the template argument of the AutoConnectAux::onUpload function and invokes it. void AutoConnectAux :: onUpload < T > (T & uploadClass) Parameters T Specifies a class name of the custom uploader. This class name is a class that you implemented by inheriting AutoConnectUploadHandler for custom upload. uploadClass Specifies the custom upload class instance. The rough structure of the sketches that completed these implementations will be as follows: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char PAGE_UPLOAD[] PROGMEM = R\"( { \"uri\": \"/\", \"title\": \"Upload\", \"menu\": true, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading platform<h2>\" }, { \"name\":\"upload_file\", \"type\":\"ACFile\", \"label\":\"Select file: \", \"store\":\"extern\" }, { \"name\":\"upload\", \"type\":\"ACSubmit\", \"value\":\"UPLOAD\", \"uri\":\"/upload\" } ] } )\" ; static const char PAGE_RECEIVED[] PROGMEM = R\"( { \"uri\": \"/upload\", \"title\": \"Upload ended\", \"menu\": false, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading ended<h2>\" } ] } )\" ; // Custom upload handler class class CustomUploader : public AutoConnectUploadHandler { public : CustomUploader() {} ~ CustomUploader() {} protected : bool _open( const char * filename, const char * mode) override ; size_t _write ( const uint8_t * buf, const size_t size) override ; void _close ( void ) override ; }; // _open for custom open bool CustomUploader :: _open( const char * filename, const char * mode) { // Here, an implementation for the open file. } // _open for custom write size_t CustomUploader :: _write( const uint8_t * buf, const size_t size) { // Here, an implementation for the writing the file data. } // _open for custom close void CustomUploader :: _close( void ) { // Here, an implementation for the close file. } AutoConnect portal; AutoConnectAux uploadPage; AutoConnectAux receivePage; CustomUploader uploader; // Declare the custom uploader void setup () { uploadPage.load(PAGE_UPLOAD); receivePage.load(PAGE_RECEIVED); portal.join({ uploadPage, receivePage }); receivePage.onUpload < CustomUploader > (uploader); // Register the custom uploader portal.begin(); } void loop () { portal.handleClient(); } Don't forget to specify the store When using a custom uploader, remember to specify the extern for the store attribute of AutoConnectFile. window.onload = function() { Gifffer(); }; The AutoConnectFile element can be used with other AutoConnectElements on the same page. \u21a9","title":" Register custom upload handler"},{"location":"advancedusage.html","text":"Advanced usage \u00b6 404 handler \u00b6 Registering the \"not found\" handler is a different way than ESP8266WebServer (WebServer as ESP32). The onNotFound of ESP8266WebServer/WebServer does not work with AutoConnect. AutoConnect overrides ESP8266WebServer::onNotFound / WebServer::onNotFound to handle a captive portal. To register \"not found\" handler, use AutoConnect::onNotFound . Access to saved credentials \u00b6 AutoConnect stores the established WiFi connection in the flash of the ESP8266/ESP32 module and equips the class to access it from the sketch. You can read, write or erase the credentials using this class individually. It's AutoConnectCredential class which provides the access method to the saved credentials in the flash. Refer to section Saved credentials access for details. Where to store credentials in ESP32 with AutoConnect v1.0.0 or later Since v1.0.0, credentials are stored in nvs of ESP32. AutoConnect v1.0.0 or later accesses the credentials area using the Preferences class with the arduino esp-32 core. So in ESP32, the credentials are not in the EEPROM, it is in the namespace AC_CREDT of the nvs. See Saved credentials access for details. In ESP8266, it is saved in EEPROM as is conventionally done. Automatic reconnect \u00b6 When the captive portal is started, SoftAP starts and the STA is disconnected. The current SSID setting memorized in ESP8266 will be lost but then the reconnect behavior of ESP32 is somewhat different from this. The WiFiSTAClass::disconnect function implemented in the arduino-esp32 has extended parameters than the ESP8266's arduino-core. The second parameter of WiFi.disconnect on the arduino-esp32 core that does not exist in the ESP8266WiFiSTAClass has the effect of deleting the currently connected WiFi configuration and its default value is \"false\". On the ESP32 platform, even if WiFi.disconnect is executed, WiFi.begin() without the parameters in the next turn will try to connect to that AP. That is, automatic reconnection is implemented in arduino-esp32 already. Although this behavior appears seemingly competent, it is rather a disadvantage in scenes where you want to change the access point each time. When explicitly disconnecting WiFi from the Disconnect menu, AutoConnect will erase the AP connection settings saved by arduino-esp32 core. AutoConnect's automatic reconnection is a mechanism independent from the automatic reconnection of the arduino-esp32 core. If the autoReconnect option of the AutoConnectConfig class is enabled, it automatically attempts to reconnect to the disconnected past access point. When the autoReconnect option is specified, AutoConnect will not start SoftAP immediately if the first WiFi.begin fails. It will scan WiFi signal and the same connection information as the detected BSSID is stored in the flash as AutoConnect's credentials, explicitly apply it with WiFi.begin and rerun. AutoConnect Portal; AutoConnectConfig Config; Config.autoReconnect = true; Portal.config(Config); Portal.begin(); An autoReconnect option is available to AutoConnect::begin without SSID and pass Passphrase. An autoReconnect will work if SSID detection succeeded An autoReconnect will not effect if the SSID which stored credential to be connected is a hidden access point. Auto save Credential \u00b6 By default, AutoConnect saves the credentials of the established connection to the flash. You can disable it with the autoSave parameter specified by AutoConnectConfig . See the Saved credentials access chapter for details on accessing stored credentials. AutoConnect Portal; AutoConnectConfig Config; Config.autoSave = AC_SAVECREDENTIAL_NEVER; Portal.config(Config); Portal.begin(); Credentials storage location The location where AutoConnect saves credentials depends on the module type and the AutoConnect library version, also arduino-esp32 core version. AutoConnect Arduino core for ESP8266 Arduino core for ESP32 1.0.2 earlier 1.0.3 later v0.9.12 earlier EEPROM EEPROM (partition) Not supported v1.0.0 later Preferences (nvs) (Can be used EEPROM with turning off AUTOCONNECT_USE_PREFERENCES macro) Preferences (nvs) Captive portal start detection \u00b6 The captive portal will only be activated if the first WiFi::begin fails. Sketch can detect with the AutoConnect::onDetect function that the captive portal has started. For example, the sketch can be written like as follows that turns on the LED at the start captive portal. AutoConnect Portal; bool startCP (IPAddress ip) { digitalWrite(BUILTIN_LED, HIGH); Serial.println( \"C.P. started, IP:\" + WiFi.localIP().toString()); return true; } void setup () { Serial.begin( 115200 ); pinMode(BUILTIN_LED, OUTPUT); digitalWrite(BUILTIN_LED, LOW); Portal.onDetect(startCP); if (Portal.begin()) { digitalWrite(BUILTIN_LED, LOW); } } void loop () { Portal.handleClient(); } Captive portal timeout control \u00b6 AutoConnect has two parameters for timeout control. One is a timeout value used when trying to connect to the specified AP. It behaves the same as general timeout control in connection attempt by WiFi.begin. This control is specified by the third parameter of AutoConnect::begin . The default value is macro defined by AUTOCONNECT_TIMEOUT in the AutoConnectDef.h file. The other timeout control is for the captive portal itself. It is useful when you want to continue sketch execution with offline even if the WiFi connection is not possible. You can also combine it with the immediateStart option to create sketches with high mobility. The timeout of the captive portal is specified together with AutoConnectConfig::portalTimeout as follows. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Also, if you want to stop AutoConnect completely when the captive portal is timed out, you need to call the AutoConnect::end function. It looks like the following code: bool acEnable; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); acEnable = portal.begin(); if ( ! acEnable) { portal.end(); } } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } if (acEnable) { portal.handleClient(); } } There is another option related to timeout in AutoConnectConfig. It can make use of the captive portal function even after a timeout. The AutoConnectConfig::retainPortal option will not stop the SoftAP when the captive portal is timed out. If you enable the ratainPortal option, you can try to connect to the AP at any time while continuing to sketch execution with offline even after the captive portal timed-out. Compared to the above code specified no option with the following example code, the captive portal will remain available even after a timeout without changing the logic of the sketch. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds config.retainPortal = true; portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Casts the HTML pages to be add-on into the menu \u00b6 If your sketch handles web pages, you can embed the pages into the AutoConnect menu in continuance enjoying the utility of the WiFi connection feature. Unlike the custom Web pages by AutoConnectElements , this allows to legacy web pages registered by ESP8266WebServer::on or WebServer::on function. You can use AutoConnectAux only constructed with the URI of the page to be embedding. AutoConnectElements is not required. The basic procedure for this as follows: Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu. Sketch the legacy page handlers. Register those handler functions to ESP8266WebServer/WebServer with the on function. Register AutoConnectAux declared with #1 to AutoConnect using AutoConnect::join function. It serves as a menu item. Begin the portal. Performs AutoConnect::handleClient in the loop function. For details, see section Constructing the menu of Examples page. Change menu title \u00b6 Although the default menu title is AutoConnect , you can change the title by setting AutoConnectConfig::title . To set the menu title properly, you must set before calling AutoConnect::begin . AutoConnect Portal; AutoConnectConfig Config; void setup () { // Set menu title Config.title = \"FSBrowser\" ; Portal.config(Config); Portal.begin(); } Executing the above sketch will rewrite the menu title for the FSBrowser as the below. Change the menu labels \u00b6 You can change the label of the AutoConnect menu item by rewriting the default label letter in AutoConnectLabels.h macros. However, changing menu items letter influences all the sketch's build scenes. #define AUTOCONNECT_MENULABEL_CONFIGNEW \"Configure new AP\" #define AUTOCONNECT_MENULABEL_OPENSSIDS \"Open SSIDs\" #define AUTOCONNECT_MENULABEL_DISCONNECT \"Disconnect\" #define AUTOCONNECT_MENULABEL_RESET \"Reset...\" #define AUTOCONNECT_MENULABEL_HOME \"HOME\" #define AUTOCONNECT_BUTTONLABEL_RESET \"RESET\" Combination with mDNS \u00b6 With mDNS library , you can access to ESP8266 by name instead of IP address after connection. The sketch can start the MDNS responder after AutoConnect::begin . #include <ESP8266WiFi.h> #include <ESP8266mDNS.h> #include <ESP8266WebServer.h> AutoConnect Portal; void setup () { if (Portal.begin()) { if (MDNS.begin( \"esp8266\" )) { MDNS.addService( \"http\" , \"tcp\" , 80 ); } } } void loop () { Portal.handleClient(); } Debug print \u00b6 You can output AutoConnect monitor messages to the Serial . A monitor message activation switch is in an include header file AutoConnectDefs.h of library source. Define AC_DEBUG macro to output the monitor messages. 1 #define AC_DEBUG Disable the captive portal \u00b6 It can also prevent the captive portal from starting even if the connection at the first WiFi.begin fails. In this case, AutoConnect::begin behaves same as WiFi.begin . For disabling the captive portal, autoRise sets to false with AutoConnectConfig . AutoConnect portal; AutoConnectConfig acConfig; acConfig.autoRise = false; portal.config(acConfig); portal.begin(); Make SSID of SoftAP unique \u00b6 You can change SoftAP's SSID and password programmatically when the captive portal starts up. By using chip specific ID of esp8266/esp32 you can make SSID of SoftAP unique. SSID and password for SoftAP is AutoConnectConfig::apid and AutoConnectConfig::psk . AutoConnect portal; AutoConnectConfig acConfig; acConfig.apid = \"ESP-\" + String(ESP.getChipId(), HEX); acConfig.psk = YOUR_PASSWORD; portal.config(acConfig); portal.begin(); Obtaining chip ID for ESP32 acConfig.apid = \"ESP-\" + String((uint32_t)(ESP.getEfuseMac() >> 32), HEX); Move the saving area of EEPROM for the credentials \u00b6 By default, the credentials saving area is occupied from the beginning of EEPROM area. ESP8266 Arduino core document says that: The following diagram illustrates flash layout used in Arduino environment: |--------------|-------|---------------|--|--|--|--|--| ^ ^ ^ ^ ^ Sketch OTA update File system EEPROM WiFi config (SDK) and EEPROM library uses one sector of flash located just after the SPIFFS . Also, in ESP32 arduino core 1.0.2 earlier, the placement of the EEPROM area of ESP32 is described in the partition table . So in the default state, the credential storage area used by AutoConnect conflicts with data owned by the user sketch. It will be destroyed together saved data in EEPROM by user sketch and AutoConnect each other. But you can move the storage area to avoid this. The boundaryOffset in AutoConnectConfig specifies the start offset of the credentials storage area. The default value is 0. The boundaryOffset ignored with AutoConnect v1.0.0 later on ESP32 arduino core 1.0.3 later For ESP32 arduino core 1.0.3 and later, AutoConnect will store credentials to Preferences in the nvs. Since it is defined as the namespace dedicated to AutoConnect and separated from the area used for user sketches. Therefore, the boundaryOffet is ignored with the combination of AutoConnect v1.0.0 or later and the arduino-esp32 1.0.3 or later. On-demand start the captive portal \u00b6 If you do not usually connect to WiFi and need to establish a WiFi connection if necessary, you can combine the autoRise option with the immediateStart option to achieve on-demand connection. This behavior is similar to the WiFiManager's startConfigPortal function. In order to do this, you usually configure only with AutoConnectConfig in setup() and AutoConnect::begin handles in loop() . AutoConnect Portal; AutoConnectConfig Config; void setup () { Config.autoRise = false; Config.immediateStart = true; Portal.config(Config); } void loop () { if (digitalRead(TRIGGER_PIN) == LOW) { while (digitalRead(TRIGGER_PIN) == LOW) yield(); Portal.begin(); } Portal.handleClient(); } The above example does not connect to WiFi until TRIGGER_PIN goes LOW. When TRIGGER_PIN goes LOW, the captive portal starts and you can connect to WiFi. Even if you reset the module, it will not automatically reconnect. Refers the hosted ESP8266WebServer/WebServer \u00b6 Constructing an AutoConnect object variable without parameters then creates and starts an ESP8266WebServer/WebServer inside the AutoConnect. This object variable could be referred by AutoConnect::host function to access ESP8266WebServer/WebServer instance as like below. AutoConnect Portal; Portal.begin(); ESP8266WebServer & server = Portal.host(); server.send( 200 , \"text/plain\" , \"Hello, world\" ); When host() is valid The host() can be referred at after AutoConnect::begin . Usage for automatically instantiated ESP8266WebServer/WebServer \u00b6 The sketch can handle URL requests using ESP8266WebServer or WebServer that AutoConnect started internally. ESP8266WebServer/WebServer instantiated dynamically by AutoConnect can be referred to by AutoConnect::host function. The sketch can use the ' on ' function, ' send ' function, ' client ' function and others by ESP8266WebServer/WebServer reference of its return value. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect Portal; void handleRoot () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 200 , \"text/html\" , \"Hello, world\" ); } void handleNotFound () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 404 , \"text/html\" , \"Unknown.\" ); } void setup () { bool r = Portal.begin(); if (r) { ESP8266WebServer & IntServer = Portal.host(); IntServer.on( \"/\" , handleRoot); Portal.onNotFound(handleNotFound); // For only onNotFound. } } void loop () { Portal.host().handleClient(); Portal.handleRequest(); /* or following one line code is equ. Portal.handleClient(); */ } ESP8266WebServer/WebServer function should be called after AutoConnect::begin The sketch cannot refer to an instance of ESP8266WebServer/WebServer until AutoConnect::begin completes successfully. Do not use with ESP8266WebServer::begin or WebServer::begin ESP8266WebServer/WebServer is already running inside the AutoConnect. Use with the PageBuilder library \u00b6 In ordinary, the URL handler will respond the request by sending some HTML. PageBuilder library is HTML assembly aid. it can handle predefined HTML as like a template and simplify an HTML string assemble logic, and also the generated HTML send automatically. An example sketch used with the PageBuilder as follows and it explains how it aids for the HTML generating. Details for Github repository . Configuration functions \u00b6 Configuration for Soft AP and captive portal \u00b6 AutoConnect will activate SoftAP at failed the first WiFi.begin . It SoftAP settings are stored in AutoConnectConfig as the following parameters. The sketch could be configured SoftAP using these parameters, refer the AutoConnectConfig API for details. IP address of SoftAP activated. Gateway IP address. Subnet mask. SSID for SoftAP. Password for SoftAP. Channel. SoftAP name. Hidden attribute. Station hostname. Auto save credential. Offset address of the credentials storage area in EEPROM. Captive portal time out limit. Maintain portal function even after a timeout. Length of start up time after reset. Automatic starting the captive portal. Start the captive portal forcefully. Auto reset after connection establishment. Home URL of the user sketch application. Menu title. Ticker signal output. AutoConnect::config before AutoConnect::begin AutoConnect::config must be executed before AutoConnect::begin . Assign user sketch's home path \u00b6 HOME for returning to the user's sketch homepage will display at the bottom of the AutoConnect menu. It could be set using the AutoConnect::home function. Change SSID and Password for SoftAP \u00b6 An esp8266ap is default SSID name for SoftAP of captive portal and password is 12345678 for ESP8266. Similarly, esp32ap and 12345678 for ESP32. You can change both by setting apid and psk . AutoConnect portal; AutoConnectConfig config; void setup () { config.apid = \"ap_portal\" ; config.psk = \"new_password\" ; portal.config(config); portal.begin(); } Also, you can specify the SSID, password for SoftAP with the constructor of the AutoConnectConfig as below. AutoConnect portal; AutoConnectConfig config ( \"ap_portal\" , \"new_passwrod\" ); void setup () { portal.config(config); portal.begin(); } You can also assign no password to SoftAP launched as a captive portal. Assigning a null string as String(\"\") to AutoConnectConfig::psk does not require a password when connecting to SoftAP. But this method is not recommended. The broadcast radio of SSID emitted from SoftAP will leak and reach several tens of meters. Relocate the AutoConnect home path \u00b6 A home path of AutoConnect is /_ac by default. You can access from the browser with http://IPADDRESS/_ac. You can change the home path by revising AUTOCONNECT_URI macro in the include header file as AutoConnectDef.h . #define AUTOCONNECT_URI \"/_ac\" Static IP assignment 2 \u00b6 It is also possible to assign static IP Address to ESP8266/ESP32 in STA mode. By default DHCP is enabled and it becomes the IP address assigned by the DHCP server with WiFi.begin . To assign a static IP to ESP8266/ESP32 with WIFI_MODE_STA, the following parameters are required: IP address. Gateway address. Subnet mask. Primary DNS server. Secondary DNS server. (optional) The above parameters must be executed before AutoConnect::begin as arguments of AutoConnectConfig . AutoConnect portal; AutoConnectConfig Config; Config.staip = IPAddress( 192 , 168 , 1 , 10 ); Config.staGateway = IPAddress( 192 , 168 , 1 , 1 ); Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); Config.dns1 = IPAddress( 192 , 168 , 1 , 1 ); portal.config(Config); portal.begin(); Station host name \u00b6 AutoConnectConfig::hostName assigns the station DHCP hostname which complies with RFC952 . It must satisfy the following constraints. Up to 24 characters Only the alphabet (a-z, A-Z), digits (0-9), minus sign (-) No '-' as last character Ticker for WiFi status \u00b6 Flicker signal can be output from the ESP8266/ESP32 module according to WiFi connection status. If you connect the LED to the signal output pin, you can know the WiFi connection status during behavior inside AutoConnect::begin through the LED blink. AutoConnectConfig::ticker option specifies flicker signal output. The following sketch is an example of flashing the active-high LED connected to pin #16 according to WiFi connection during the AutoConnect::begin. AutoConnect portal; AutoConnectConfig Config; Config.ticker = true; config.tickerPort = 16 ; Config.tickerOn = HIGH; portal.config(Config); portal.begin(); The AutoConnect ticker indicates the WiFi connection status in the following three flicker patterns: Short blink: The ESP module stays in APSTA mode. Short-on and long-off: No STA connection state. (i.e. WiFi.status != WL_CONNECTED) No blink: WiFi connection with access point established and data link enabled. (i.e. WiFi.status = WL_CONNECTED) The flicker cycle length is defined by some macros in AutoConnectDefs.h header file. #define AUTOCONNECT_FLICKER_PERIODAP 1000 // [ms] #define AUTOCONNECT_FLICKER_PERIODDC (AUTOCONNECT_FLICKER_PERIODAP << 1) // [ms] #define AUTOCONNECT_FLICKER_WIDTHAP 96 // (8 bit resolution) #define AUTOCONNECT_FLICKER_WIDTHDC 16 // (8 bit resolution) AUTOCONNECTT_FLICKER_PERIODAP : Assigns a flicker period when the ESP module stays in APSTA mode. AUTOCONNECT_FLICKER_PERIODDC : Assigns a flicker period when WiFi is disconnected. AUTOCONNECT_FLICKER_WIDTHAP and AUTOCONNECT_FLICKER_WIDTHDC : Specify the duty rate for each period[ms] in 8-bit resolution. AutoConnectConfig::tickerPort specifies a port that outputs the flicker signal. If you are using an LED-equipped ESP module board, you can assign a LED pin to the tick-port for the WiFi connection monitoring without the external LED. The default pin is arduino valiant's LED_BUILTIN . You can refer to the Arduino IDE's variant information to find out which pin actually on the module assign to LED_BUILTIN . 3 AutoConnectConfig::tickerOn specifies the active logic level of the flicker signal. This value indicates the active signal level when driving the ticker. For example, if the LED connected to tickPort lights by LOW, the tickerOn is LOW . The logic level of LED_BUILTIN for popular modules are as follows: module Logic level LED_BUILTIN Pin Arduino alias NodeMCU V1.0 Active-low 16 D0 WEMOS D1 mini Active-low 2 D4 SparkFun ESP8266 Thing Active-high 5 Adafruit Feather HUZZAH ESP8266 Active-low 0 NodeMCU 32s Active-high 2 T2 LOLIN32 Pro Active-low 5 SS SparkFun ESP32 Thing Active-high 5 Adafruit Feather HUZZAH32 Active-high 13 A12 The source code placement of common macros for AutoConnect since v0.9.7 has changed. \u21a9 Static IP address assignment is available from version 0.9.3. \u21a9 It's defined in the pins_arduino.h file, located in the sub-folder named variants wherein Arduino IDE installed folder. \u21a9","title":"Advanced usage"},{"location":"advancedusage.html#advanced-usage","text":"","title":"Advanced usage"},{"location":"advancedusage.html#404-handler","text":"Registering the \"not found\" handler is a different way than ESP8266WebServer (WebServer as ESP32). The onNotFound of ESP8266WebServer/WebServer does not work with AutoConnect. AutoConnect overrides ESP8266WebServer::onNotFound / WebServer::onNotFound to handle a captive portal. To register \"not found\" handler, use AutoConnect::onNotFound .","title":" 404 handler"},{"location":"advancedusage.html#access-to-saved-credentials","text":"AutoConnect stores the established WiFi connection in the flash of the ESP8266/ESP32 module and equips the class to access it from the sketch. You can read, write or erase the credentials using this class individually. It's AutoConnectCredential class which provides the access method to the saved credentials in the flash. Refer to section Saved credentials access for details. Where to store credentials in ESP32 with AutoConnect v1.0.0 or later Since v1.0.0, credentials are stored in nvs of ESP32. AutoConnect v1.0.0 or later accesses the credentials area using the Preferences class with the arduino esp-32 core. So in ESP32, the credentials are not in the EEPROM, it is in the namespace AC_CREDT of the nvs. See Saved credentials access for details. In ESP8266, it is saved in EEPROM as is conventionally done.","title":" Access to saved credentials"},{"location":"advancedusage.html#automatic-reconnect","text":"When the captive portal is started, SoftAP starts and the STA is disconnected. The current SSID setting memorized in ESP8266 will be lost but then the reconnect behavior of ESP32 is somewhat different from this. The WiFiSTAClass::disconnect function implemented in the arduino-esp32 has extended parameters than the ESP8266's arduino-core. The second parameter of WiFi.disconnect on the arduino-esp32 core that does not exist in the ESP8266WiFiSTAClass has the effect of deleting the currently connected WiFi configuration and its default value is \"false\". On the ESP32 platform, even if WiFi.disconnect is executed, WiFi.begin() without the parameters in the next turn will try to connect to that AP. That is, automatic reconnection is implemented in arduino-esp32 already. Although this behavior appears seemingly competent, it is rather a disadvantage in scenes where you want to change the access point each time. When explicitly disconnecting WiFi from the Disconnect menu, AutoConnect will erase the AP connection settings saved by arduino-esp32 core. AutoConnect's automatic reconnection is a mechanism independent from the automatic reconnection of the arduino-esp32 core. If the autoReconnect option of the AutoConnectConfig class is enabled, it automatically attempts to reconnect to the disconnected past access point. When the autoReconnect option is specified, AutoConnect will not start SoftAP immediately if the first WiFi.begin fails. It will scan WiFi signal and the same connection information as the detected BSSID is stored in the flash as AutoConnect's credentials, explicitly apply it with WiFi.begin and rerun. AutoConnect Portal; AutoConnectConfig Config; Config.autoReconnect = true; Portal.config(Config); Portal.begin(); An autoReconnect option is available to AutoConnect::begin without SSID and pass Passphrase. An autoReconnect will work if SSID detection succeeded An autoReconnect will not effect if the SSID which stored credential to be connected is a hidden access point.","title":" Automatic reconnect"},{"location":"advancedusage.html#auto-save-credential","text":"By default, AutoConnect saves the credentials of the established connection to the flash. You can disable it with the autoSave parameter specified by AutoConnectConfig . See the Saved credentials access chapter for details on accessing stored credentials. AutoConnect Portal; AutoConnectConfig Config; Config.autoSave = AC_SAVECREDENTIAL_NEVER; Portal.config(Config); Portal.begin(); Credentials storage location The location where AutoConnect saves credentials depends on the module type and the AutoConnect library version, also arduino-esp32 core version. AutoConnect Arduino core for ESP8266 Arduino core for ESP32 1.0.2 earlier 1.0.3 later v0.9.12 earlier EEPROM EEPROM (partition) Not supported v1.0.0 later Preferences (nvs) (Can be used EEPROM with turning off AUTOCONNECT_USE_PREFERENCES macro) Preferences (nvs)","title":" Auto save Credential"},{"location":"advancedusage.html#captive-portal-start-detection","text":"The captive portal will only be activated if the first WiFi::begin fails. Sketch can detect with the AutoConnect::onDetect function that the captive portal has started. For example, the sketch can be written like as follows that turns on the LED at the start captive portal. AutoConnect Portal; bool startCP (IPAddress ip) { digitalWrite(BUILTIN_LED, HIGH); Serial.println( \"C.P. started, IP:\" + WiFi.localIP().toString()); return true; } void setup () { Serial.begin( 115200 ); pinMode(BUILTIN_LED, OUTPUT); digitalWrite(BUILTIN_LED, LOW); Portal.onDetect(startCP); if (Portal.begin()) { digitalWrite(BUILTIN_LED, LOW); } } void loop () { Portal.handleClient(); }","title":" Captive portal start detection"},{"location":"advancedusage.html#captive-portal-timeout-control","text":"AutoConnect has two parameters for timeout control. One is a timeout value used when trying to connect to the specified AP. It behaves the same as general timeout control in connection attempt by WiFi.begin. This control is specified by the third parameter of AutoConnect::begin . The default value is macro defined by AUTOCONNECT_TIMEOUT in the AutoConnectDef.h file. The other timeout control is for the captive portal itself. It is useful when you want to continue sketch execution with offline even if the WiFi connection is not possible. You can also combine it with the immediateStart option to create sketches with high mobility. The timeout of the captive portal is specified together with AutoConnectConfig::portalTimeout as follows. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Also, if you want to stop AutoConnect completely when the captive portal is timed out, you need to call the AutoConnect::end function. It looks like the following code: bool acEnable; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); acEnable = portal.begin(); if ( ! acEnable) { portal.end(); } } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } if (acEnable) { portal.handleClient(); } } There is another option related to timeout in AutoConnectConfig. It can make use of the captive portal function even after a timeout. The AutoConnectConfig::retainPortal option will not stop the SoftAP when the captive portal is timed out. If you enable the ratainPortal option, you can try to connect to the AP at any time while continuing to sketch execution with offline even after the captive portal timed-out. Compared to the above code specified no option with the following example code, the captive portal will remain available even after a timeout without changing the logic of the sketch. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds config.retainPortal = true; portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); }","title":" Captive portal timeout control"},{"location":"advancedusage.html#casts-the-html-pages-to-be-add-on-into-the-menu","text":"If your sketch handles web pages, you can embed the pages into the AutoConnect menu in continuance enjoying the utility of the WiFi connection feature. Unlike the custom Web pages by AutoConnectElements , this allows to legacy web pages registered by ESP8266WebServer::on or WebServer::on function. You can use AutoConnectAux only constructed with the URI of the page to be embedding. AutoConnectElements is not required. The basic procedure for this as follows: Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu. Sketch the legacy page handlers. Register those handler functions to ESP8266WebServer/WebServer with the on function. Register AutoConnectAux declared with #1 to AutoConnect using AutoConnect::join function. It serves as a menu item. Begin the portal. Performs AutoConnect::handleClient in the loop function. For details, see section Constructing the menu of Examples page.","title":" Casts the HTML pages to be add-on into the menu"},{"location":"advancedusage.html#change-menu-title","text":"Although the default menu title is AutoConnect , you can change the title by setting AutoConnectConfig::title . To set the menu title properly, you must set before calling AutoConnect::begin . AutoConnect Portal; AutoConnectConfig Config; void setup () { // Set menu title Config.title = \"FSBrowser\" ; Portal.config(Config); Portal.begin(); } Executing the above sketch will rewrite the menu title for the FSBrowser as the below.","title":" Change menu title"},{"location":"advancedusage.html#change-the-menu-labels","text":"You can change the label of the AutoConnect menu item by rewriting the default label letter in AutoConnectLabels.h macros. However, changing menu items letter influences all the sketch's build scenes. #define AUTOCONNECT_MENULABEL_CONFIGNEW \"Configure new AP\" #define AUTOCONNECT_MENULABEL_OPENSSIDS \"Open SSIDs\" #define AUTOCONNECT_MENULABEL_DISCONNECT \"Disconnect\" #define AUTOCONNECT_MENULABEL_RESET \"Reset...\" #define AUTOCONNECT_MENULABEL_HOME \"HOME\" #define AUTOCONNECT_BUTTONLABEL_RESET \"RESET\"","title":" Change the menu labels"},{"location":"advancedusage.html#combination-with-mdns","text":"With mDNS library , you can access to ESP8266 by name instead of IP address after connection. The sketch can start the MDNS responder after AutoConnect::begin . #include <ESP8266WiFi.h> #include <ESP8266mDNS.h> #include <ESP8266WebServer.h> AutoConnect Portal; void setup () { if (Portal.begin()) { if (MDNS.begin( \"esp8266\" )) { MDNS.addService( \"http\" , \"tcp\" , 80 ); } } } void loop () { Portal.handleClient(); }","title":" Combination with mDNS"},{"location":"advancedusage.html#debug-print","text":"You can output AutoConnect monitor messages to the Serial . A monitor message activation switch is in an include header file AutoConnectDefs.h of library source. Define AC_DEBUG macro to output the monitor messages. 1 #define AC_DEBUG","title":" Debug print"},{"location":"advancedusage.html#disable-the-captive-portal","text":"It can also prevent the captive portal from starting even if the connection at the first WiFi.begin fails. In this case, AutoConnect::begin behaves same as WiFi.begin . For disabling the captive portal, autoRise sets to false with AutoConnectConfig . AutoConnect portal; AutoConnectConfig acConfig; acConfig.autoRise = false; portal.config(acConfig); portal.begin();","title":" Disable the captive portal"},{"location":"advancedusage.html#make-ssid-of-softap-unique","text":"You can change SoftAP's SSID and password programmatically when the captive portal starts up. By using chip specific ID of esp8266/esp32 you can make SSID of SoftAP unique. SSID and password for SoftAP is AutoConnectConfig::apid and AutoConnectConfig::psk . AutoConnect portal; AutoConnectConfig acConfig; acConfig.apid = \"ESP-\" + String(ESP.getChipId(), HEX); acConfig.psk = YOUR_PASSWORD; portal.config(acConfig); portal.begin(); Obtaining chip ID for ESP32 acConfig.apid = \"ESP-\" + String((uint32_t)(ESP.getEfuseMac() >> 32), HEX);","title":" Make SSID of SoftAP unique"},{"location":"advancedusage.html#move-the-saving-area-of-eeprom-for-the-credentials","text":"By default, the credentials saving area is occupied from the beginning of EEPROM area. ESP8266 Arduino core document says that: The following diagram illustrates flash layout used in Arduino environment: |--------------|-------|---------------|--|--|--|--|--| ^ ^ ^ ^ ^ Sketch OTA update File system EEPROM WiFi config (SDK) and EEPROM library uses one sector of flash located just after the SPIFFS . Also, in ESP32 arduino core 1.0.2 earlier, the placement of the EEPROM area of ESP32 is described in the partition table . So in the default state, the credential storage area used by AutoConnect conflicts with data owned by the user sketch. It will be destroyed together saved data in EEPROM by user sketch and AutoConnect each other. But you can move the storage area to avoid this. The boundaryOffset in AutoConnectConfig specifies the start offset of the credentials storage area. The default value is 0. The boundaryOffset ignored with AutoConnect v1.0.0 later on ESP32 arduino core 1.0.3 later For ESP32 arduino core 1.0.3 and later, AutoConnect will store credentials to Preferences in the nvs. Since it is defined as the namespace dedicated to AutoConnect and separated from the area used for user sketches. Therefore, the boundaryOffet is ignored with the combination of AutoConnect v1.0.0 or later and the arduino-esp32 1.0.3 or later.","title":" Move the saving area of EEPROM for the credentials"},{"location":"advancedusage.html#on-demand-start-the-captive-portal","text":"If you do not usually connect to WiFi and need to establish a WiFi connection if necessary, you can combine the autoRise option with the immediateStart option to achieve on-demand connection. This behavior is similar to the WiFiManager's startConfigPortal function. In order to do this, you usually configure only with AutoConnectConfig in setup() and AutoConnect::begin handles in loop() . AutoConnect Portal; AutoConnectConfig Config; void setup () { Config.autoRise = false; Config.immediateStart = true; Portal.config(Config); } void loop () { if (digitalRead(TRIGGER_PIN) == LOW) { while (digitalRead(TRIGGER_PIN) == LOW) yield(); Portal.begin(); } Portal.handleClient(); } The above example does not connect to WiFi until TRIGGER_PIN goes LOW. When TRIGGER_PIN goes LOW, the captive portal starts and you can connect to WiFi. Even if you reset the module, it will not automatically reconnect.","title":" On-demand start the captive portal"},{"location":"advancedusage.html#refers-the-hosted-esp8266webserverwebserver","text":"Constructing an AutoConnect object variable without parameters then creates and starts an ESP8266WebServer/WebServer inside the AutoConnect. This object variable could be referred by AutoConnect::host function to access ESP8266WebServer/WebServer instance as like below. AutoConnect Portal; Portal.begin(); ESP8266WebServer & server = Portal.host(); server.send( 200 , \"text/plain\" , \"Hello, world\" ); When host() is valid The host() can be referred at after AutoConnect::begin .","title":" Refers the hosted ESP8266WebServer/WebServer"},{"location":"advancedusage.html#usage-for-automatically-instantiated-esp8266webserverwebserver","text":"The sketch can handle URL requests using ESP8266WebServer or WebServer that AutoConnect started internally. ESP8266WebServer/WebServer instantiated dynamically by AutoConnect can be referred to by AutoConnect::host function. The sketch can use the ' on ' function, ' send ' function, ' client ' function and others by ESP8266WebServer/WebServer reference of its return value. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect Portal; void handleRoot () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 200 , \"text/html\" , \"Hello, world\" ); } void handleNotFound () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 404 , \"text/html\" , \"Unknown.\" ); } void setup () { bool r = Portal.begin(); if (r) { ESP8266WebServer & IntServer = Portal.host(); IntServer.on( \"/\" , handleRoot); Portal.onNotFound(handleNotFound); // For only onNotFound. } } void loop () { Portal.host().handleClient(); Portal.handleRequest(); /* or following one line code is equ. Portal.handleClient(); */ } ESP8266WebServer/WebServer function should be called after AutoConnect::begin The sketch cannot refer to an instance of ESP8266WebServer/WebServer until AutoConnect::begin completes successfully. Do not use with ESP8266WebServer::begin or WebServer::begin ESP8266WebServer/WebServer is already running inside the AutoConnect.","title":" Usage for automatically instantiated ESP8266WebServer/WebServer"},{"location":"advancedusage.html#use-with-the-pagebuilder-library","text":"In ordinary, the URL handler will respond the request by sending some HTML. PageBuilder library is HTML assembly aid. it can handle predefined HTML as like a template and simplify an HTML string assemble logic, and also the generated HTML send automatically. An example sketch used with the PageBuilder as follows and it explains how it aids for the HTML generating. Details for Github repository .","title":" Use with the PageBuilder library"},{"location":"advancedusage.html#configuration-functions","text":"","title":"Configuration functions"},{"location":"advancedusage.html#configuration-for-soft-ap-and-captive-portal","text":"AutoConnect will activate SoftAP at failed the first WiFi.begin . It SoftAP settings are stored in AutoConnectConfig as the following parameters. The sketch could be configured SoftAP using these parameters, refer the AutoConnectConfig API for details. IP address of SoftAP activated. Gateway IP address. Subnet mask. SSID for SoftAP. Password for SoftAP. Channel. SoftAP name. Hidden attribute. Station hostname. Auto save credential. Offset address of the credentials storage area in EEPROM. Captive portal time out limit. Maintain portal function even after a timeout. Length of start up time after reset. Automatic starting the captive portal. Start the captive portal forcefully. Auto reset after connection establishment. Home URL of the user sketch application. Menu title. Ticker signal output. AutoConnect::config before AutoConnect::begin AutoConnect::config must be executed before AutoConnect::begin .","title":" Configuration for Soft AP and captive portal"},{"location":"advancedusage.html#assign-user-sketchs-home-path","text":"HOME for returning to the user's sketch homepage will display at the bottom of the AutoConnect menu. It could be set using the AutoConnect::home function.","title":" Assign user sketch's home path"},{"location":"advancedusage.html#change-ssid-and-password-for-softap","text":"An esp8266ap is default SSID name for SoftAP of captive portal and password is 12345678 for ESP8266. Similarly, esp32ap and 12345678 for ESP32. You can change both by setting apid and psk . AutoConnect portal; AutoConnectConfig config; void setup () { config.apid = \"ap_portal\" ; config.psk = \"new_password\" ; portal.config(config); portal.begin(); } Also, you can specify the SSID, password for SoftAP with the constructor of the AutoConnectConfig as below. AutoConnect portal; AutoConnectConfig config ( \"ap_portal\" , \"new_passwrod\" ); void setup () { portal.config(config); portal.begin(); } You can also assign no password to SoftAP launched as a captive portal. Assigning a null string as String(\"\") to AutoConnectConfig::psk does not require a password when connecting to SoftAP. But this method is not recommended. The broadcast radio of SSID emitted from SoftAP will leak and reach several tens of meters.","title":" Change SSID and Password for SoftAP"},{"location":"advancedusage.html#relocate-the-autoconnect-home-path","text":"A home path of AutoConnect is /_ac by default. You can access from the browser with http://IPADDRESS/_ac. You can change the home path by revising AUTOCONNECT_URI macro in the include header file as AutoConnectDef.h . #define AUTOCONNECT_URI \"/_ac\"","title":" Relocate the AutoConnect home path"},{"location":"advancedusage.html#static-ip-assignment-2","text":"It is also possible to assign static IP Address to ESP8266/ESP32 in STA mode. By default DHCP is enabled and it becomes the IP address assigned by the DHCP server with WiFi.begin . To assign a static IP to ESP8266/ESP32 with WIFI_MODE_STA, the following parameters are required: IP address. Gateway address. Subnet mask. Primary DNS server. Secondary DNS server. (optional) The above parameters must be executed before AutoConnect::begin as arguments of AutoConnectConfig . AutoConnect portal; AutoConnectConfig Config; Config.staip = IPAddress( 192 , 168 , 1 , 10 ); Config.staGateway = IPAddress( 192 , 168 , 1 , 1 ); Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); Config.dns1 = IPAddress( 192 , 168 , 1 , 1 ); portal.config(Config); portal.begin();","title":" Static IP assignment 2"},{"location":"advancedusage.html#station-host-name","text":"AutoConnectConfig::hostName assigns the station DHCP hostname which complies with RFC952 . It must satisfy the following constraints. Up to 24 characters Only the alphabet (a-z, A-Z), digits (0-9), minus sign (-) No '-' as last character","title":" Station host name"},{"location":"advancedusage.html#ticker-for-wifi-status","text":"Flicker signal can be output from the ESP8266/ESP32 module according to WiFi connection status. If you connect the LED to the signal output pin, you can know the WiFi connection status during behavior inside AutoConnect::begin through the LED blink. AutoConnectConfig::ticker option specifies flicker signal output. The following sketch is an example of flashing the active-high LED connected to pin #16 according to WiFi connection during the AutoConnect::begin. AutoConnect portal; AutoConnectConfig Config; Config.ticker = true; config.tickerPort = 16 ; Config.tickerOn = HIGH; portal.config(Config); portal.begin(); The AutoConnect ticker indicates the WiFi connection status in the following three flicker patterns: Short blink: The ESP module stays in APSTA mode. Short-on and long-off: No STA connection state. (i.e. WiFi.status != WL_CONNECTED) No blink: WiFi connection with access point established and data link enabled. (i.e. WiFi.status = WL_CONNECTED) The flicker cycle length is defined by some macros in AutoConnectDefs.h header file. #define AUTOCONNECT_FLICKER_PERIODAP 1000 // [ms] #define AUTOCONNECT_FLICKER_PERIODDC (AUTOCONNECT_FLICKER_PERIODAP << 1) // [ms] #define AUTOCONNECT_FLICKER_WIDTHAP 96 // (8 bit resolution) #define AUTOCONNECT_FLICKER_WIDTHDC 16 // (8 bit resolution) AUTOCONNECTT_FLICKER_PERIODAP : Assigns a flicker period when the ESP module stays in APSTA mode. AUTOCONNECT_FLICKER_PERIODDC : Assigns a flicker period when WiFi is disconnected. AUTOCONNECT_FLICKER_WIDTHAP and AUTOCONNECT_FLICKER_WIDTHDC : Specify the duty rate for each period[ms] in 8-bit resolution. AutoConnectConfig::tickerPort specifies a port that outputs the flicker signal. If you are using an LED-equipped ESP module board, you can assign a LED pin to the tick-port for the WiFi connection monitoring without the external LED. The default pin is arduino valiant's LED_BUILTIN . You can refer to the Arduino IDE's variant information to find out which pin actually on the module assign to LED_BUILTIN . 3 AutoConnectConfig::tickerOn specifies the active logic level of the flicker signal. This value indicates the active signal level when driving the ticker. For example, if the LED connected to tickPort lights by LOW, the tickerOn is LOW . The logic level of LED_BUILTIN for popular modules are as follows: module Logic level LED_BUILTIN Pin Arduino alias NodeMCU V1.0 Active-low 16 D0 WEMOS D1 mini Active-low 2 D4 SparkFun ESP8266 Thing Active-high 5 Adafruit Feather HUZZAH ESP8266 Active-low 0 NodeMCU 32s Active-high 2 T2 LOLIN32 Pro Active-low 5 SS SparkFun ESP32 Thing Active-high 5 Adafruit Feather HUZZAH32 Active-high 13 A12 The source code placement of common macros for AutoConnect since v0.9.7 has changed. \u21a9 Static IP address assignment is available from version 0.9.3. \u21a9 It's defined in the pins_arduino.h file, located in the sub-folder named variants wherein Arduino IDE installed folder. \u21a9","title":" Ticker for WiFi status"},{"location":"api.html","text":"Include headers \u00b6 AutoConnect.h \u00b6 #include <AutoConnect.h> Defined macros \u00b6 They contain in AutoConnectDefs.h . #define AC_DEBUG // Monitor message output activation #define AC_DEBUG_PORT Serial // Default message output device #define AUTOCONNECT_AP_IP 0x01F4A8C0 // Default SoftAP IP #define AUTOCONNECT_AP_GW 0x01F4A8C0 // Default SoftAP Gateway IP #define AUTOCONNECT_AP_NM 0x00FFFFFF // Default subnet mask #define AUTOCONNECT_DNSPORT 53 // Default DNS port at captive portal #define AUTOCONNECT_HTTPPORT 80 // Default HTTP #define AUTOCONNECT_MENU_TITLE \"AutoConnect\" // Default AutoConnect menu title #define AUTOCONNECT_STARTUPTIME 10 // Default waiting time[s] for after reset #define AUTOCONNECT_URI \"/_ac\" // Default AutoConnect root path #define AUTOCONNECT_TIMEOUT 30000 // Default connection timeout[ms] #define AUTOCONNECT_CAPTIVEPORTAL_TIMEOUT 0 // Captive portal timeout value #define AUTOCONNECT_USE_JSON // Allow AutoConnect elements to be handled by JSON format Macros placement moved Source code placement of the above macros provided for user sketch changed from v0.9.7. The new code is in AutoConnectDefs.h . Constructors \u00b6 AutoConnect \u00b6 AutoConnect() AutoConnect default constructor. This entry internally allocates the ESP8266WebServer for ESP8266 or WebServer for ESP32 and is activated internally. For ESP8266 AutoConnect(ESP8266WebServer & webServer) For ESP32 AutoConnect(WebServer & webServer) Run the AutoConnect site using the externally ensured ESP8266WebServer for ESP8266 or WebServer for ESP32. The handleClient function of AutoConnect can include the response of the URI handler added by the user using the \" on \" function of ESP8266WebServer/WebServer. If ESP8266WebServer/WebServer is assigned internally by AutoConnect, the sketch can obtain that reference with the host function. Parameter webServer A reference of ESP8266WebServer or WebServer instance. Public member functions \u00b6 aux \u00b6 AutoConnectAux * aux( const String & uri) const Returns a pointer to AutoConnectAux with the URI specified by uri . If AutoConnectAux with that URI is not bound, it returns nullptr . Parameter uri A string of the URI. Return value A Pointer of the AutoConnectAux instance. begin \u00b6 bool begin() bool begin( const char * ssid, const char * passphrase) bool begin( const char * ssid, const char * passphrase, unsigned long timeout) Starts establishing the WiFi connection. The WiFi mode at this time is WIFI_STA. AutoConnect first invokes WiFi.begin . If the ssid and the passphrase are missing, its WiFi.begin has no SSID and Password. Regardless of the result, ESP8266WebServer/WebServer will start immediately after the first WiFi.begin . The captive portal will not be started if the connection has been established with first WiFi.begin . If the connection cannot establish, switch to WIFI_AP_STA mode and activate SoftAP. Then DNS server starts. Parameters ssid SSID to be connected. passphrase Password for connection. timeout A time out value in milliseconds for waiting connection. Return value true Connection established, AutoConnect service started with WIFI_STA mode. false Could not connected, Captive portal started with WIFI_AP_STA mode. config \u00b6 bool config(AutoConnectConfig & config) bool config( const char * ap, const char * password = nullptr ) Set SoftAP's WiFi configuration and static IP configuration. Parameters config Reference to AutoConnectConfig containing SoftAP's parameters and static IP parameters. ap SSID for SoftAP. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The default value is 12345678 . Return value true Successfully configured. false Configuration parameter is invalid, some values out of range. end \u00b6 void end( void ) Stops AutoConnect captive portal service. Release ESP8266WebServer/WebServer and DNSServer. Attention to end The end function releases the instance of ESP8266WebServer/WebServer and DNSServer. It can not process them after the end function. handleClient \u00b6 void handleClient( void ) Process the AutoConnect menu interface. The handleClient() function of the ESP8266WebServer/WebServer hosted by AutoConnect is also called from within AutoConnect, and the client request handlers contained in the user sketch are also handled. handleRequest \u00b6 void handleRequest( void ) Handling for the AutoConnect menu request. About used in combination with handleClient The handleRequest function is not supposed to use with AutoConnect::handleClient. It should be used with ESP8266WebServer::handleClient or WebServer::handleClient. home \u00b6 void home(String & uri) Put a user site's home URI. The URI specified by home is linked from \"HOME\" in the AutoConnect menu. Parameter uri A URI string of user site's home path. host \u00b6 For ESP8266 ESP8266WebServer & host( void ) For ESP32 WebServer & host( void ) Returns the reference of the ESP8266WebServer/WebServer which is allocated in AutoConnect automatically. Return value A reference of the ESP8266WebServer/WebServer. &reference is not a pointer A reference cannot be re-assigned, and must be assigned at initialization. It's like as bind as alias. ESP8266WebServer & server = portal.host(); server.handleClient(); or portal.host().handleClient(); join \u00b6 void join(AutoConnectAux & aux) void join(std :: vector < std :: reference_wrapper < AutoConnectAux >> aux) Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joined one by one, or joined altogether. The AutoConnectAux object joined by the join function can be handled from the AutoConnect menu. Parameter aux Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with list initialization . load \u00b6 bool load( const String & aux) bool load(PGM_P aux) bool load( const __FlashStringHelper * aux) bool load(Stream & aux) Load JSON document of AutoConnectAux which contains AutoConnectElements. If there is a syntax error in the JSON document, false is returned. Parameter aux The input string to be loaded. Return value true The JSON document as AutoConnectAux successfully loaded. false Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the ArduinoJson Assistant . on \u00b6 bool on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters uri A string of the URI assigned to the AutoConnectAux page. handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. It is not ESP8266WebServer::on, not WebServer::on for ESP32. This function effects to AutoConnectAux only. However, it coexists with that of ESP8266WebServer::on or WebServer::on of ESP32. onDetect \u00b6 void onDetect(DetectExit_ft fn) Register the function which will call from AutoConnect at the start of the captive portal. Parameter fn Function called at the captive portal start. An fn specifies the function called when the captive portal starts. Its prototype declaration is defined as \" DetectExit_ft \". typedef std :: function < bool (IPAddress softapIP) > DetectExit_ft Parameter softapIP An IP address of SoftAP for the captive portal. Return value true Continues captive portal handling. false Cancel the captive portal. AutoConnect::begin function will return with a false. onNotFound \u00b6 For ESP8266 void onNotFound(ESP8266WebServer :: THandlerFunction fn) For ESP32 void onNotFound(WebServer :: THandlerFunction fn) Register the handler function for undefined URL request detected. Parameter fn A function of the \"not found\" handler. where \u00b6 String where( void ) Returns an uri string of the AutoConnectAux uri object of the custom Web page that caused the request to the page. AutoConnect identifies the URI (ie. the referrer URI) that caused the request each time from the client occurs and will save the URI If the request source is a custom Web page of AutoConnectAux. The where function returns a pointer of AutoConnectAux which is a URI of a least recent request from the custom Web page. This function is provided to access the fields (ie. the AutoConnectElements) with a custom Web page handler of a page and is available only for request source that is the custom Web pages. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/WebServer for ESP32. In other words, this function only returns the AutoConnecAux page which is a least recently displayed. Return value An uri string of the AutoConnectAux that caused the request the page. The where function usage is described in the section Where to pick up the values .","title":"AutoConnect API"},{"location":"api.html#include-headers","text":"","title":" Include headers"},{"location":"api.html#autoconnecth","text":"#include <AutoConnect.h>","title":"AutoConnect.h"},{"location":"api.html#defined-macros","text":"They contain in AutoConnectDefs.h . #define AC_DEBUG // Monitor message output activation #define AC_DEBUG_PORT Serial // Default message output device #define AUTOCONNECT_AP_IP 0x01F4A8C0 // Default SoftAP IP #define AUTOCONNECT_AP_GW 0x01F4A8C0 // Default SoftAP Gateway IP #define AUTOCONNECT_AP_NM 0x00FFFFFF // Default subnet mask #define AUTOCONNECT_DNSPORT 53 // Default DNS port at captive portal #define AUTOCONNECT_HTTPPORT 80 // Default HTTP #define AUTOCONNECT_MENU_TITLE \"AutoConnect\" // Default AutoConnect menu title #define AUTOCONNECT_STARTUPTIME 10 // Default waiting time[s] for after reset #define AUTOCONNECT_URI \"/_ac\" // Default AutoConnect root path #define AUTOCONNECT_TIMEOUT 30000 // Default connection timeout[ms] #define AUTOCONNECT_CAPTIVEPORTAL_TIMEOUT 0 // Captive portal timeout value #define AUTOCONNECT_USE_JSON // Allow AutoConnect elements to be handled by JSON format Macros placement moved Source code placement of the above macros provided for user sketch changed from v0.9.7. The new code is in AutoConnectDefs.h .","title":" Defined macros"},{"location":"api.html#constructors","text":"","title":" Constructors"},{"location":"api.html#autoconnect","text":"AutoConnect() AutoConnect default constructor. This entry internally allocates the ESP8266WebServer for ESP8266 or WebServer for ESP32 and is activated internally. For ESP8266 AutoConnect(ESP8266WebServer & webServer) For ESP32 AutoConnect(WebServer & webServer) Run the AutoConnect site using the externally ensured ESP8266WebServer for ESP8266 or WebServer for ESP32. The handleClient function of AutoConnect can include the response of the URI handler added by the user using the \" on \" function of ESP8266WebServer/WebServer. If ESP8266WebServer/WebServer is assigned internally by AutoConnect, the sketch can obtain that reference with the host function. Parameter webServer A reference of ESP8266WebServer or WebServer instance.","title":"AutoConnect"},{"location":"api.html#public-member-functions","text":"","title":" Public member functions"},{"location":"api.html#aux","text":"AutoConnectAux * aux( const String & uri) const Returns a pointer to AutoConnectAux with the URI specified by uri . If AutoConnectAux with that URI is not bound, it returns nullptr . Parameter uri A string of the URI. Return value A Pointer of the AutoConnectAux instance.","title":" aux"},{"location":"api.html#begin","text":"bool begin() bool begin( const char * ssid, const char * passphrase) bool begin( const char * ssid, const char * passphrase, unsigned long timeout) Starts establishing the WiFi connection. The WiFi mode at this time is WIFI_STA. AutoConnect first invokes WiFi.begin . If the ssid and the passphrase are missing, its WiFi.begin has no SSID and Password. Regardless of the result, ESP8266WebServer/WebServer will start immediately after the first WiFi.begin . The captive portal will not be started if the connection has been established with first WiFi.begin . If the connection cannot establish, switch to WIFI_AP_STA mode and activate SoftAP. Then DNS server starts. Parameters ssid SSID to be connected. passphrase Password for connection. timeout A time out value in milliseconds for waiting connection. Return value true Connection established, AutoConnect service started with WIFI_STA mode. false Could not connected, Captive portal started with WIFI_AP_STA mode.","title":" begin"},{"location":"api.html#config","text":"bool config(AutoConnectConfig & config) bool config( const char * ap, const char * password = nullptr ) Set SoftAP's WiFi configuration and static IP configuration. Parameters config Reference to AutoConnectConfig containing SoftAP's parameters and static IP parameters. ap SSID for SoftAP. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The default value is 12345678 . Return value true Successfully configured. false Configuration parameter is invalid, some values out of range.","title":" config"},{"location":"api.html#end","text":"void end( void ) Stops AutoConnect captive portal service. Release ESP8266WebServer/WebServer and DNSServer. Attention to end The end function releases the instance of ESP8266WebServer/WebServer and DNSServer. It can not process them after the end function.","title":" end"},{"location":"api.html#handleclient","text":"void handleClient( void ) Process the AutoConnect menu interface. The handleClient() function of the ESP8266WebServer/WebServer hosted by AutoConnect is also called from within AutoConnect, and the client request handlers contained in the user sketch are also handled.","title":" handleClient"},{"location":"api.html#handlerequest","text":"void handleRequest( void ) Handling for the AutoConnect menu request. About used in combination with handleClient The handleRequest function is not supposed to use with AutoConnect::handleClient. It should be used with ESP8266WebServer::handleClient or WebServer::handleClient.","title":" handleRequest"},{"location":"api.html#home","text":"void home(String & uri) Put a user site's home URI. The URI specified by home is linked from \"HOME\" in the AutoConnect menu. Parameter uri A URI string of user site's home path.","title":" home"},{"location":"api.html#host","text":"For ESP8266 ESP8266WebServer & host( void ) For ESP32 WebServer & host( void ) Returns the reference of the ESP8266WebServer/WebServer which is allocated in AutoConnect automatically. Return value A reference of the ESP8266WebServer/WebServer. &reference is not a pointer A reference cannot be re-assigned, and must be assigned at initialization. It's like as bind as alias. ESP8266WebServer & server = portal.host(); server.handleClient(); or portal.host().handleClient();","title":" host"},{"location":"api.html#join","text":"void join(AutoConnectAux & aux) void join(std :: vector < std :: reference_wrapper < AutoConnectAux >> aux) Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joined one by one, or joined altogether. The AutoConnectAux object joined by the join function can be handled from the AutoConnect menu. Parameter aux Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with list initialization .","title":" join"},{"location":"api.html#load","text":"bool load( const String & aux) bool load(PGM_P aux) bool load( const __FlashStringHelper * aux) bool load(Stream & aux) Load JSON document of AutoConnectAux which contains AutoConnectElements. If there is a syntax error in the JSON document, false is returned. Parameter aux The input string to be loaded. Return value true The JSON document as AutoConnectAux successfully loaded. false Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the ArduinoJson Assistant .","title":" load"},{"location":"api.html#on","text":"bool on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters uri A string of the URI assigned to the AutoConnectAux page. handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. It is not ESP8266WebServer::on, not WebServer::on for ESP32. This function effects to AutoConnectAux only. However, it coexists with that of ESP8266WebServer::on or WebServer::on of ESP32.","title":" on"},{"location":"api.html#ondetect","text":"void onDetect(DetectExit_ft fn) Register the function which will call from AutoConnect at the start of the captive portal. Parameter fn Function called at the captive portal start. An fn specifies the function called when the captive portal starts. Its prototype declaration is defined as \" DetectExit_ft \". typedef std :: function < bool (IPAddress softapIP) > DetectExit_ft Parameter softapIP An IP address of SoftAP for the captive portal. Return value true Continues captive portal handling. false Cancel the captive portal. AutoConnect::begin function will return with a false.","title":" onDetect"},{"location":"api.html#onnotfound","text":"For ESP8266 void onNotFound(ESP8266WebServer :: THandlerFunction fn) For ESP32 void onNotFound(WebServer :: THandlerFunction fn) Register the handler function for undefined URL request detected. Parameter fn A function of the \"not found\" handler.","title":" onNotFound"},{"location":"api.html#where","text":"String where( void ) Returns an uri string of the AutoConnectAux uri object of the custom Web page that caused the request to the page. AutoConnect identifies the URI (ie. the referrer URI) that caused the request each time from the client occurs and will save the URI If the request source is a custom Web page of AutoConnectAux. The where function returns a pointer of AutoConnectAux which is a URI of a least recent request from the custom Web page. This function is provided to access the fields (ie. the AutoConnectElements) with a custom Web page handler of a page and is available only for request source that is the custom Web pages. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/WebServer for ESP32. In other words, this function only returns the AutoConnecAux page which is a least recently displayed. Return value An uri string of the AutoConnectAux that caused the request the page. The where function usage is described in the section Where to pick up the values .","title":" where"},{"location":"apiaux.html","text":"Constructor \u00b6 AutoConnectAux \u00b6 AutoConnectAux( const String & uri = String( \"\" ), const String & title = String( \"\" ), const bool menu = true, const AutoConnectElementVT addons = AutoConnectElementVT()) Parameters uri URI of this custom Web Page. title Page title of this custom Web page. It will appear on the auto connection menu and at the top of that page. menu Specifies whether to display this page on menu. addons Reference to AutoConnectElement collection. Public member functions \u00b6 operator [ ] \u00b6 AutoConnectElement & operator []( const String & name) Returns a reference to the element specified by name . An operator [] is a shortcut for getElement function with the reference casting. Unlike getElement, which returns a pointer to that element, an operator [] returns a reference to that element. You also need to cast the return value to the actual type, just like the getElement function. Parameter name Name of the AutoConnectElements to be retrieved. Return value A reference to AutoConnectElement. It is different from the actual element type. add \u00b6 void add(AutoConnectElement & addon) void add(AutoConnectElementVT addons) Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu. Parameters addon Reference of AutoConnectElements. Specifies one of the AutoConnectElements classes. addons An array list of reference of AutoConnectElements. The list initialization with braced-init-list of the std::vector can be used for the addons parameter cause the actual definition of type AutoConnectElementVT is std::vector<std::reference_wrapper<AutoConnectElement>> . fetchElement \u00b6 void fetchElement( void ) Retrieve the values of the AutoConnectElements on the custom Web page. Refer to how to use the fetchElement . getElement \u00b6 T & getElement < T > ( const String & name) AutoConnectElement * getElement( const String & name) Get a registered AutoConnectElement as specified name. If T is specified as an actual type of AutoConnectElements, it returns a reference to that instance. Parameters T Actual type name of AutoConnectElements as AutoConnectButton , AutoConnectCheckbox , AutoConnectElement , AutoConnectFile , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectSubmit , AutoConnectText . name Name of the AutoConnectElements to be retrieved. Return value A reference of the AutoConnectElements. If a type is not specified returns a pointer. getElements \u00b6 AutoConnectElementVT & getElements( void ) Get vector of reference of all elements. Return value A reference to std::vector of reference to AutoConnecctElements. The getElements returns a reference to std::vector of reference to AutoConnecctElements. This function is provided to handle AutoConnectElemets owned by AutoConnectAux in bulk, and you can use each method of std::vector for a return value. // An example of getting type and name of all AutoConnectElements registered in AutoConnectAux. AutoConnectAux aux; // some code here... AutoConnectElementVt & elements = aux.getElements(); for (AutoConnectElement & elm : elements) { Serial.printf( \"name<%s> as type %d \\n \" , elm.name.c_str(), ( int )elm.typeOf()); } isMenu \u00b6 bool isMenu( void ) Returns whether embedded in the menu or not. The isMenu is a function that complements the menu function. Return value true The custom Web page has been incorporated into the AutoConnect menu as a menu item. false This custom Web page is not currently a menu item. isValid \u00b6 bool isValid( void ) Performs validation of all AutoConnectInput elements owned by AutoConnectAux and returns the result. The isValid function will return the true even if the AutoConnectAux does not own AutoConnectInputs. Return value true Validation is successful. A value of all AutoConnectInputs match with each pattern. false Some elements failed validation. load \u00b6 bool load( const String & in) bool load(PGM_P in) bool load( const __FlashStringHelper * in) bool load(Stream & in) Load all AutoConnectElements elements from JSON document into AutoConnectAux as custom Web pages. The JSON document specified by the load function must be the document structure of AutoConnectAux. Its JSON document can describe multiple pages as an array. Parameter in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. Return value true JSON document as the custom Web pages successfully loaded. false JSON document loading failed. Load multiple custom Web pages separately Multiple custom Web pages can be loaded at once with JSON as an array. But it will consume a lot of memory. By loading a JSON document by page as much as possible, you can reduce memory consumption. loadElement \u00b6 bool loadElement( const String & in, const String & name = String( \"\" )) bool loadElement( const String & in, std :: vector < String > const & names) bool loadElement(PGM_P in, const String & name = String( \"\" )) bool loadElement(PGM_P in, std :: vector < String > const & names) bool loadElement( const __FlashStringHelper * in, const String & name = String( \"\" )) bool loadElement( const __FlashStringHelper * in, std :: vector < String > const & names) bool loadElement(Stream & in, const String & name = String( \"\" )) bool loadElement(Stream & in, std :: vector < String > const & names) Load specified element from JSON document into AutoConnectAux. The JSON document specified by the loadElement function must be the AutoConnectElement document structure . When loading from a JSON document that describes multiple elements, its description must be an array syntax. Parameters in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. name Specifies the name to be load. If the name is not specified, the loadElement function will load all elements contained in the JSON document. names Spefifies an array list of String indicating the name of the element to be loaded. The list initialization with braced-init-list of the std::vector can be used. Return value true Specified AutoConnectElements successfully loaded. false JSON document loading failed. Maybe it is an array Please note that the JSON document that is the input for loadElement is an array syntax of AutoConnectElements when there are multiple elements. For example, the following JSON document has a syntax error: { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"value\" : \"Hello, world\" } , { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" } The outermost [ , ] is missing. menu \u00b6 void menu( const bool post) Set or reset the display as menu item for this AutoConnectAux. This function programmatically manipulates the menu parameter of the AutoConnectAux constructor . Parameter true Show on the menu. false Hidden on the menu. on \u00b6 void on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. onUpload \u00b6 void onUpload < T &> (T handler) void onUpload(PageBuilder :: UploadFuncT uploadFunc) Register the upload handler of the AutoConnectAux. Parameters T Specifies a class name of the custom uploader inherited from AutoConnectUploadHandler class. Refer to the appendix for details. handler Specifies the custom uploader inherited from AutoConnectUploadHandler class. Refer to the appendix for details. uploadFunc A function that behaves when request to upload with the AutoConnectAux page. UploadFuncT type is defined by the following declaration. void(const String&, const HTTPUpload&) A data structure of the upload file as HTTPUpload. It is defined in the ESP8266WebServer (the WebServer for ESP32) library as follows: typedef struct { HTTPUploadStatus status; String filename; String name; String type; size_t totalSize; size_t currentSize; size_t contentLength; uint8_t buf[HTTP_UPLOAD_BUFLEN]; } HTTPUpload; Refer to ' To upload to a device other than Flash or SD ' in section appendix for details. release \u00b6 bool release( const String & name) Release a specified AutoConnectElement from AutoConnectAux. The release function is provided to dynamically change the structure of the custom Web pages with the sketch. By combining the release function and the add function or the loadElement function, the sketch can change the style of the custom Web page according to its behavior. Parameter name Specifies the name of AutoConnectElements to be released. Return value true The AutoConnectElement successfully released. false The AutoConnectElement can not be released. saveElement \u00b6 size_t saveElement(Stream & out, std :: vector < String > const & names = {}) Write elements of AutoConnectAux to the stream. The saveElement function outputs the specified AutoConnectElements as a JSON document using the prettyPrintTo function of the ArduinoJson library. Parameters out Output stream to be output. SPIFFS, SD also Serial can be specified generally. names The array of the name of AutoConnectElements to be output. If the names parameter is not specified, all AutoConnectElements registered in AutoConnectAux are output. Return value The number of bytes written. The output format is pretty The saveElement function outputs a prettified JSON document. It is not complementary with loadElement The saveElement function which missing the names parameter without name list to be saved that saves an entire AutoConnectAux element, not just AutoConnectElements. Its saved JSON document is not a complementary input to the loadElement function. The JSON document describing AutoConnectAux saved without the names parameter must be loaded by the AutoConnectAux::load function or AutoConnect::load function. setElementValue \u00b6 bool setElementValue( const String & name, const String value) bool setElementValue( const String & name, std :: vector < String > const & values) Sets the value of the specified AutoConnectElement. If values \u200b\u200bis specified as a std::vector of String, the element that can set the values is the AutoConnectRadio or the AutoConnectSelect . Parameters name Specifies the name of the AutoConnectElements that you want to set the value. value Specifies the value to be set. values Specifies a reference of a std::vector of String. It contains the values of the AutoConnectRadio or the AutoConnectSelect. Return value true The value has been set. false AutoConnectElements with the specified name are not registered. Or the type of the value is not consistent with the specified AutoConnectElements. You can directly access the value member variable. If you are gripping with the sketch to the AutoConnectElements of the target that sets the value, you can access the value member variable directly. The following sketch code has the same effect. AutoConnectAux aux; // ... Griping the AutoConnectText here. aux.setElementValue( \"TEXT_FIELD\" , \"New value\" ); AutoConnectAux aux; // ... Griping the AutoConnectText here. AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_FIELD\" ); text.value = \"New value\" ; The difference between the setElementValue and the value access with the getElement is the certainty of the registration state for the element. The getElement returns an empty object if the element is not registered then a sketch assigns the value to it. May occur unexpected results and crashes. You should use the setElementValue if its registration is unsettled. setTitle \u00b6 void setTitle( const String & title) Set the title string of the custom Web page. This title will be displayed as the menu title of the custom Web page. Parameter title Title string to be display. Not the menu title The setTitle function is not set for the AutoConnect menu title. The effect of this function is that custom Web page only. To change the AutoConnect menu title use AutoConnectConfig::title .","title":"AutoConnectAux API"},{"location":"apiaux.html#constructor","text":"","title":" Constructor"},{"location":"apiaux.html#autoconnectaux","text":"AutoConnectAux( const String & uri = String( \"\" ), const String & title = String( \"\" ), const bool menu = true, const AutoConnectElementVT addons = AutoConnectElementVT()) Parameters uri URI of this custom Web Page. title Page title of this custom Web page. It will appear on the auto connection menu and at the top of that page. menu Specifies whether to display this page on menu. addons Reference to AutoConnectElement collection.","title":"AutoConnectAux"},{"location":"apiaux.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apiaux.html#operator","text":"AutoConnectElement & operator []( const String & name) Returns a reference to the element specified by name . An operator [] is a shortcut for getElement function with the reference casting. Unlike getElement, which returns a pointer to that element, an operator [] returns a reference to that element. You also need to cast the return value to the actual type, just like the getElement function. Parameter name Name of the AutoConnectElements to be retrieved. Return value A reference to AutoConnectElement. It is different from the actual element type.","title":" operator [ ]"},{"location":"apiaux.html#add","text":"void add(AutoConnectElement & addon) void add(AutoConnectElementVT addons) Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu. Parameters addon Reference of AutoConnectElements. Specifies one of the AutoConnectElements classes. addons An array list of reference of AutoConnectElements. The list initialization with braced-init-list of the std::vector can be used for the addons parameter cause the actual definition of type AutoConnectElementVT is std::vector<std::reference_wrapper<AutoConnectElement>> .","title":" add"},{"location":"apiaux.html#fetchelement","text":"void fetchElement( void ) Retrieve the values of the AutoConnectElements on the custom Web page. Refer to how to use the fetchElement .","title":" fetchElement"},{"location":"apiaux.html#getelement","text":"T & getElement < T > ( const String & name) AutoConnectElement * getElement( const String & name) Get a registered AutoConnectElement as specified name. If T is specified as an actual type of AutoConnectElements, it returns a reference to that instance. Parameters T Actual type name of AutoConnectElements as AutoConnectButton , AutoConnectCheckbox , AutoConnectElement , AutoConnectFile , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectSubmit , AutoConnectText . name Name of the AutoConnectElements to be retrieved. Return value A reference of the AutoConnectElements. If a type is not specified returns a pointer.","title":" getElement"},{"location":"apiaux.html#getelements","text":"AutoConnectElementVT & getElements( void ) Get vector of reference of all elements. Return value A reference to std::vector of reference to AutoConnecctElements. The getElements returns a reference to std::vector of reference to AutoConnecctElements. This function is provided to handle AutoConnectElemets owned by AutoConnectAux in bulk, and you can use each method of std::vector for a return value. // An example of getting type and name of all AutoConnectElements registered in AutoConnectAux. AutoConnectAux aux; // some code here... AutoConnectElementVt & elements = aux.getElements(); for (AutoConnectElement & elm : elements) { Serial.printf( \"name<%s> as type %d \\n \" , elm.name.c_str(), ( int )elm.typeOf()); }","title":" getElements"},{"location":"apiaux.html#ismenu","text":"bool isMenu( void ) Returns whether embedded in the menu or not. The isMenu is a function that complements the menu function. Return value true The custom Web page has been incorporated into the AutoConnect menu as a menu item. false This custom Web page is not currently a menu item.","title":" isMenu"},{"location":"apiaux.html#isvalid","text":"bool isValid( void ) Performs validation of all AutoConnectInput elements owned by AutoConnectAux and returns the result. The isValid function will return the true even if the AutoConnectAux does not own AutoConnectInputs. Return value true Validation is successful. A value of all AutoConnectInputs match with each pattern. false Some elements failed validation.","title":" isValid"},{"location":"apiaux.html#load","text":"bool load( const String & in) bool load(PGM_P in) bool load( const __FlashStringHelper * in) bool load(Stream & in) Load all AutoConnectElements elements from JSON document into AutoConnectAux as custom Web pages. The JSON document specified by the load function must be the document structure of AutoConnectAux. Its JSON document can describe multiple pages as an array. Parameter in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. Return value true JSON document as the custom Web pages successfully loaded. false JSON document loading failed. Load multiple custom Web pages separately Multiple custom Web pages can be loaded at once with JSON as an array. But it will consume a lot of memory. By loading a JSON document by page as much as possible, you can reduce memory consumption.","title":" load"},{"location":"apiaux.html#loadelement","text":"bool loadElement( const String & in, const String & name = String( \"\" )) bool loadElement( const String & in, std :: vector < String > const & names) bool loadElement(PGM_P in, const String & name = String( \"\" )) bool loadElement(PGM_P in, std :: vector < String > const & names) bool loadElement( const __FlashStringHelper * in, const String & name = String( \"\" )) bool loadElement( const __FlashStringHelper * in, std :: vector < String > const & names) bool loadElement(Stream & in, const String & name = String( \"\" )) bool loadElement(Stream & in, std :: vector < String > const & names) Load specified element from JSON document into AutoConnectAux. The JSON document specified by the loadElement function must be the AutoConnectElement document structure . When loading from a JSON document that describes multiple elements, its description must be an array syntax. Parameters in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. name Specifies the name to be load. If the name is not specified, the loadElement function will load all elements contained in the JSON document. names Spefifies an array list of String indicating the name of the element to be loaded. The list initialization with braced-init-list of the std::vector can be used. Return value true Specified AutoConnectElements successfully loaded. false JSON document loading failed. Maybe it is an array Please note that the JSON document that is the input for loadElement is an array syntax of AutoConnectElements when there are multiple elements. For example, the following JSON document has a syntax error: { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"value\" : \"Hello, world\" } , { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" } The outermost [ , ] is missing.","title":" loadElement"},{"location":"apiaux.html#menu","text":"void menu( const bool post) Set or reset the display as menu item for this AutoConnectAux. This function programmatically manipulates the menu parameter of the AutoConnectAux constructor . Parameter true Show on the menu. false Hidden on the menu.","title":" menu"},{"location":"apiaux.html#on","text":"void on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated.","title":" on"},{"location":"apiaux.html#onupload","text":"void onUpload < T &> (T handler) void onUpload(PageBuilder :: UploadFuncT uploadFunc) Register the upload handler of the AutoConnectAux. Parameters T Specifies a class name of the custom uploader inherited from AutoConnectUploadHandler class. Refer to the appendix for details. handler Specifies the custom uploader inherited from AutoConnectUploadHandler class. Refer to the appendix for details. uploadFunc A function that behaves when request to upload with the AutoConnectAux page. UploadFuncT type is defined by the following declaration. void(const String&, const HTTPUpload&) A data structure of the upload file as HTTPUpload. It is defined in the ESP8266WebServer (the WebServer for ESP32) library as follows: typedef struct { HTTPUploadStatus status; String filename; String name; String type; size_t totalSize; size_t currentSize; size_t contentLength; uint8_t buf[HTTP_UPLOAD_BUFLEN]; } HTTPUpload; Refer to ' To upload to a device other than Flash or SD ' in section appendix for details.","title":" onUpload"},{"location":"apiaux.html#release","text":"bool release( const String & name) Release a specified AutoConnectElement from AutoConnectAux. The release function is provided to dynamically change the structure of the custom Web pages with the sketch. By combining the release function and the add function or the loadElement function, the sketch can change the style of the custom Web page according to its behavior. Parameter name Specifies the name of AutoConnectElements to be released. Return value true The AutoConnectElement successfully released. false The AutoConnectElement can not be released.","title":" release"},{"location":"apiaux.html#saveelement","text":"size_t saveElement(Stream & out, std :: vector < String > const & names = {}) Write elements of AutoConnectAux to the stream. The saveElement function outputs the specified AutoConnectElements as a JSON document using the prettyPrintTo function of the ArduinoJson library. Parameters out Output stream to be output. SPIFFS, SD also Serial can be specified generally. names The array of the name of AutoConnectElements to be output. If the names parameter is not specified, all AutoConnectElements registered in AutoConnectAux are output. Return value The number of bytes written. The output format is pretty The saveElement function outputs a prettified JSON document. It is not complementary with loadElement The saveElement function which missing the names parameter without name list to be saved that saves an entire AutoConnectAux element, not just AutoConnectElements. Its saved JSON document is not a complementary input to the loadElement function. The JSON document describing AutoConnectAux saved without the names parameter must be loaded by the AutoConnectAux::load function or AutoConnect::load function.","title":" saveElement"},{"location":"apiaux.html#setelementvalue","text":"bool setElementValue( const String & name, const String value) bool setElementValue( const String & name, std :: vector < String > const & values) Sets the value of the specified AutoConnectElement. If values \u200b\u200bis specified as a std::vector of String, the element that can set the values is the AutoConnectRadio or the AutoConnectSelect . Parameters name Specifies the name of the AutoConnectElements that you want to set the value. value Specifies the value to be set. values Specifies a reference of a std::vector of String. It contains the values of the AutoConnectRadio or the AutoConnectSelect. Return value true The value has been set. false AutoConnectElements with the specified name are not registered. Or the type of the value is not consistent with the specified AutoConnectElements. You can directly access the value member variable. If you are gripping with the sketch to the AutoConnectElements of the target that sets the value, you can access the value member variable directly. The following sketch code has the same effect. AutoConnectAux aux; // ... Griping the AutoConnectText here. aux.setElementValue( \"TEXT_FIELD\" , \"New value\" ); AutoConnectAux aux; // ... Griping the AutoConnectText here. AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_FIELD\" ); text.value = \"New value\" ; The difference between the setElementValue and the value access with the getElement is the certainty of the registration state for the element. The getElement returns an empty object if the element is not registered then a sketch assigns the value to it. May occur unexpected results and crashes. You should use the setElementValue if its registration is unsettled.","title":" setElementValue"},{"location":"apiaux.html#settitle","text":"void setTitle( const String & title) Set the title string of the custom Web page. This title will be displayed as the menu title of the custom Web page. Parameter title Title string to be display. Not the menu title The setTitle function is not set for the AutoConnect menu title. The effect of this function is that custom Web page only. To change the AutoConnect menu title use AutoConnectConfig::title .","title":" setTitle"},{"location":"apiconfig.html","text":"Constructor \u00b6 AutoConnectConfig \u00b6 AutoConnectConfig() AutoConnectConfig( const char * ap, const char * password) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout, const uint8_t channel) Parameters ap SSID for SoftAP. The length should be up to 31. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The length should be from 8 to up to 63. The default value is 12345678 . timeout The timeout value of the captive portal in [ms] units. The default value is 0. channel The channel number of WIFi when SoftAP starts. The default values is 1. Public member variables \u00b6 apid \u00b6 SoftAP's SSID. Type String The default value is esp8266ap for ESP8266, esp32ap for ESP32. apip \u00b6 Sets IP address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 172.217.28.1 autoReconnect \u00b6 Automatically will try to reconnect with the past established access point (BSSID) when the current configured SSID in ESP8266/ESP32 could not be connected. By enabling this option, AutoConnect::begin() function will attempt to reconnect to a known access point using credentials stored in the flash, even if the connection failed by current SSID. If the connection fails, starts the captive portal in SoftAP+STA mode. Type bool Value true Reconnect automatically. false Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default. When the autoReconnect option is enabled, an automatic connection will behave if the following conditions are satisfied. Invokes AutoConnect::begin without user name and password parameter as begin() . If one of the saved BSSIDs (not the SSID) of the credentials matches the BSSID detected by the network scan. autoReset \u00b6 Reset ESP8266 module automatically after WLAN disconnected. Type bool Value true Reset after WiFi disconnected automatically. false No reset. autoRise \u00b6 Captive portal activation switch. False for disabling the captive portal. It prevents starting the captive portal even if the connection at the first WiFi.begin fails. Type bool Value true Enable the captive portal. This is the default. false Disable the captive portal. autoSave \u00b6 The credential saved automatically at the connection establishment. Type AC_SAVECREDENTIAL_t Value AC_SAVECREDENTIAL_AUTO The credential saved automatically. This is the default. AC_SAVECREDENTIAL_NEVER The credential no saved. bootUri \u00b6 Specify the location to be redirected after module reset in the AutoConnect menu. It is given as an enumeration value of AC_ONBOOTURI_t indicating either the AutoConnect root path or the user screen home path. Type AC_ONBOOTURI_t Value AC_ONBOOTURI_ROOT Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h. AC_ONBOOTURI_HOME It is redirected to the URI specified by AutoConnectConfig::homeUri . boundaryOffset \u00b6 Sets the offset address of the credential storage area for EEPROM. This value must be between greater than 4 and less than flash sector size. (4096 by SDK) The default value is 0. This option is valid only for ESP8266 or ESP32 arduino core 1.0.2 earlier. Type uint16_t It will conflict with user data. If the sketch leaves this offset at zero, it will conflict the storage area of credentials with the user sketch owned data. It needs to use the behind of credential area. channel \u00b6 The channel number of WIFi when SoftAP starts. Type uint8_t Value 1 ~ 14. The default value is 1. How do I choose Channel Espressif Systems had announced the application note about Wi-Fi channel selection. dns1 \u00b6 Set primary DNS server address when using static IP address. Type IPAddress dns2 \u00b6 Set secondary DNS server address when using static IP address. Type IPAddress gateway \u00b6 Sets gateway address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 172.217.28.1 hidden \u00b6 Sets SoftAP to hidden SSID. Type uint8_t Value 0 SSID will be appeared. This is the default. 1 SSID will be hidden. homeUri \u00b6 Sets the home path of user sketch. This path would be linked from 'HOME' in the AutoConnect menu. The default for homeUri is \"/\". Type String hostName \u00b6 Sets the station host name of ESP8266/ESP32. Type String immediateStart \u00b6 Disable the first WiFi.begin() and start the captive portal. If this option is enabled, the module will be in AP_STA mode and the captive portal will be activated regardless of AutoConnectConfig::autoRise specification. Type bool Value true Start the captive portal with AutoConnect::begin . false Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default. netmask \u00b6 Sets subnet mask for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 255.255.255.0 portalTimeout \u00b6 Specify the timeout value of the captive portal in [ms] units. It is valid when the station is not connected and does not time out if the station is connected to the ESP module in SoftAP mode (i.e. Attempting WiFi connection with the portal function). If 0, the captive portal will not be timed-out. Type unsigned long Captive portal timeout value. The default value is 0. psk \u00b6 Sets password for SoftAP. The length should be from 8 to up to 63. The default value is 12345678 . Type String retainPortal \u00b6 Specify whether to continue the portal function even if the captive portal timed out. If the true, when a timeout occurs, the AutoConnect::begin function is exited with returns false, but the portal facility remains alive. So SoftAP remains alive and you can invoke AutoConnect while continuing sketch execution. The default is false. Type bool Value true Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP. false When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default. Connection request after timed-out With the retainPortal , even if AutoConnect::begin in the setup() is timed out, you can execute the sketch and the portal function as a WiFi connection attempt by calling AutoConnect::handleClient in the loop(). All unresolved addresses redirects to /_ac If you enable the retainPortal option, all unresolved URIs will be redirected to SoftAPIP/_ac . It happens frequently as client devices repeat captive portal probes in particular. To avoid this, you need to exit from the WiFi connection Apps on your device once. staip \u00b6 Set a static IP address. The IP will behave with STA mode. Type IPAddress staGateway \u00b6 Set the gateway address when using static IP address. Type IPAddress staNetmask \u00b6 Set the subnetmask when using static IP address. Type IPAddress ticker \u00b6 Set flicker signal output according to WiFi connection status during AutoConnect::begin behavior. Type bool Value true Output the flicker signal while AutoConnect::begin operation. The AUTOCONNECT_TICKER_PORT macro in the AutoConnectDefs.h header file assigns pins for signal output. The default pin is arduino valiant's LED_BUILTIN. For boards without the LED_BUILTIN pin, assume pin #2. false No flicker signal output. tickerPort \u00b6 Specifies the GPIO port number to output the flicker signal of the ticker. The default assumes on the board dependent definition LED_BUILTIN macro redefined by AUTOCONNECT_TICKER_PORT in AutoConnectDefs.h . Type uint8_t tickerOn \u00b6 Specifies the active logic level of the flicker signal. This value indicates the active signal level when driving the ticker. Type uint8_t Value LOW A flicker signal is an active-high. HIGH A flicker signal is an active-low. title \u00b6 Set the menu title. Type String AutoConnectConfig example \u00b6 AutoConnect Portal; AutoConnectConfig Config ( \"\" , \"passpass\" ); // SoftAp name is determined at runtime Config.apid = ESP.hostname(); // Retrieve host name to SotAp identification Config.apip = IPAddress( 192 , 168 , 10 , 101 ); // Sets SoftAP IP address Config.gateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WLAN router IP address Config.netmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.autoReconnect = true; // Enable auto-reconnect Config.autoSave = AC_SAVECREDENTIAL_NEVER; // No save credential Config.boundaryOffet = 64 ; // Reserve 64 bytes for the user data in EEPROM. Config.portalTimeout = 60000 ; // Sets timeout value for the captive portal Config.retainPortal = true; // Retains the portal function after timed-out Config.homeUri = \"/index.html\" ; // Sets home path of the sketch application Config.title = \"My menu\" ; // Customize the menu title Config.staip = IPAddress( 192 , 168 , 10 , 10 ); // Sets static IP Config.staGateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WiFi router address Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.dns1 = IPAddress( 192 , 168 , 10 , 1 ); // Sets primary DNS address Portal.config(Config); // Configure AutoConnect Portal.begin(); // Starts and behaves captive portal","title":"AutoConnectConfig API"},{"location":"apiconfig.html#constructor","text":"","title":" Constructor"},{"location":"apiconfig.html#autoconnectconfig","text":"AutoConnectConfig() AutoConnectConfig( const char * ap, const char * password) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout, const uint8_t channel) Parameters ap SSID for SoftAP. The length should be up to 31. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The length should be from 8 to up to 63. The default value is 12345678 . timeout The timeout value of the captive portal in [ms] units. The default value is 0. channel The channel number of WIFi when SoftAP starts. The default values is 1.","title":"AutoConnectConfig"},{"location":"apiconfig.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apiconfig.html#apid","text":"SoftAP's SSID. Type String The default value is esp8266ap for ESP8266, esp32ap for ESP32.","title":" apid"},{"location":"apiconfig.html#apip","text":"Sets IP address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 172.217.28.1","title":" apip"},{"location":"apiconfig.html#autoreconnect","text":"Automatically will try to reconnect with the past established access point (BSSID) when the current configured SSID in ESP8266/ESP32 could not be connected. By enabling this option, AutoConnect::begin() function will attempt to reconnect to a known access point using credentials stored in the flash, even if the connection failed by current SSID. If the connection fails, starts the captive portal in SoftAP+STA mode. Type bool Value true Reconnect automatically. false Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default. When the autoReconnect option is enabled, an automatic connection will behave if the following conditions are satisfied. Invokes AutoConnect::begin without user name and password parameter as begin() . If one of the saved BSSIDs (not the SSID) of the credentials matches the BSSID detected by the network scan.","title":" autoReconnect"},{"location":"apiconfig.html#autoreset","text":"Reset ESP8266 module automatically after WLAN disconnected. Type bool Value true Reset after WiFi disconnected automatically. false No reset.","title":" autoReset"},{"location":"apiconfig.html#autorise","text":"Captive portal activation switch. False for disabling the captive portal. It prevents starting the captive portal even if the connection at the first WiFi.begin fails. Type bool Value true Enable the captive portal. This is the default. false Disable the captive portal.","title":" autoRise"},{"location":"apiconfig.html#autosave","text":"The credential saved automatically at the connection establishment. Type AC_SAVECREDENTIAL_t Value AC_SAVECREDENTIAL_AUTO The credential saved automatically. This is the default. AC_SAVECREDENTIAL_NEVER The credential no saved.","title":" autoSave"},{"location":"apiconfig.html#booturi","text":"Specify the location to be redirected after module reset in the AutoConnect menu. It is given as an enumeration value of AC_ONBOOTURI_t indicating either the AutoConnect root path or the user screen home path. Type AC_ONBOOTURI_t Value AC_ONBOOTURI_ROOT Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h. AC_ONBOOTURI_HOME It is redirected to the URI specified by AutoConnectConfig::homeUri .","title":" bootUri"},{"location":"apiconfig.html#boundaryoffset","text":"Sets the offset address of the credential storage area for EEPROM. This value must be between greater than 4 and less than flash sector size. (4096 by SDK) The default value is 0. This option is valid only for ESP8266 or ESP32 arduino core 1.0.2 earlier. Type uint16_t It will conflict with user data. If the sketch leaves this offset at zero, it will conflict the storage area of credentials with the user sketch owned data. It needs to use the behind of credential area.","title":" boundaryOffset"},{"location":"apiconfig.html#channel","text":"The channel number of WIFi when SoftAP starts. Type uint8_t Value 1 ~ 14. The default value is 1. How do I choose Channel Espressif Systems had announced the application note about Wi-Fi channel selection.","title":" channel"},{"location":"apiconfig.html#dns1","text":"Set primary DNS server address when using static IP address. Type IPAddress","title":" dns1"},{"location":"apiconfig.html#dns2","text":"Set secondary DNS server address when using static IP address. Type IPAddress","title":" dns2"},{"location":"apiconfig.html#gateway","text":"Sets gateway address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 172.217.28.1","title":" gateway"},{"location":"apiconfig.html#hidden","text":"Sets SoftAP to hidden SSID. Type uint8_t Value 0 SSID will be appeared. This is the default. 1 SSID will be hidden.","title":" hidden"},{"location":"apiconfig.html#homeuri","text":"Sets the home path of user sketch. This path would be linked from 'HOME' in the AutoConnect menu. The default for homeUri is \"/\". Type String","title":" homeUri"},{"location":"apiconfig.html#hostname","text":"Sets the station host name of ESP8266/ESP32. Type String","title":" hostName"},{"location":"apiconfig.html#immediatestart","text":"Disable the first WiFi.begin() and start the captive portal. If this option is enabled, the module will be in AP_STA mode and the captive portal will be activated regardless of AutoConnectConfig::autoRise specification. Type bool Value true Start the captive portal with AutoConnect::begin . false Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default.","title":" immediateStart"},{"location":"apiconfig.html#netmask","text":"Sets subnet mask for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 255.255.255.0","title":" netmask"},{"location":"apiconfig.html#portaltimeout","text":"Specify the timeout value of the captive portal in [ms] units. It is valid when the station is not connected and does not time out if the station is connected to the ESP module in SoftAP mode (i.e. Attempting WiFi connection with the portal function). If 0, the captive portal will not be timed-out. Type unsigned long Captive portal timeout value. The default value is 0.","title":" portalTimeout"},{"location":"apiconfig.html#psk","text":"Sets password for SoftAP. The length should be from 8 to up to 63. The default value is 12345678 . Type String","title":" psk"},{"location":"apiconfig.html#retainportal","text":"Specify whether to continue the portal function even if the captive portal timed out. If the true, when a timeout occurs, the AutoConnect::begin function is exited with returns false, but the portal facility remains alive. So SoftAP remains alive and you can invoke AutoConnect while continuing sketch execution. The default is false. Type bool Value true Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP. false When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default. Connection request after timed-out With the retainPortal , even if AutoConnect::begin in the setup() is timed out, you can execute the sketch and the portal function as a WiFi connection attempt by calling AutoConnect::handleClient in the loop(). All unresolved addresses redirects to /_ac If you enable the retainPortal option, all unresolved URIs will be redirected to SoftAPIP/_ac . It happens frequently as client devices repeat captive portal probes in particular. To avoid this, you need to exit from the WiFi connection Apps on your device once.","title":" retainPortal"},{"location":"apiconfig.html#staip","text":"Set a static IP address. The IP will behave with STA mode. Type IPAddress","title":" staip"},{"location":"apiconfig.html#stagateway","text":"Set the gateway address when using static IP address. Type IPAddress","title":" staGateway"},{"location":"apiconfig.html#stanetmask","text":"Set the subnetmask when using static IP address. Type IPAddress","title":" staNetmask"},{"location":"apiconfig.html#ticker","text":"Set flicker signal output according to WiFi connection status during AutoConnect::begin behavior. Type bool Value true Output the flicker signal while AutoConnect::begin operation. The AUTOCONNECT_TICKER_PORT macro in the AutoConnectDefs.h header file assigns pins for signal output. The default pin is arduino valiant's LED_BUILTIN. For boards without the LED_BUILTIN pin, assume pin #2. false No flicker signal output.","title":" ticker"},{"location":"apiconfig.html#tickerport","text":"Specifies the GPIO port number to output the flicker signal of the ticker. The default assumes on the board dependent definition LED_BUILTIN macro redefined by AUTOCONNECT_TICKER_PORT in AutoConnectDefs.h . Type uint8_t","title":" tickerPort"},{"location":"apiconfig.html#tickeron","text":"Specifies the active logic level of the flicker signal. This value indicates the active signal level when driving the ticker. Type uint8_t Value LOW A flicker signal is an active-high. HIGH A flicker signal is an active-low.","title":" tickerOn"},{"location":"apiconfig.html#title","text":"Set the menu title. Type String","title":" title"},{"location":"apiconfig.html#autoconnectconfig-example","text":"AutoConnect Portal; AutoConnectConfig Config ( \"\" , \"passpass\" ); // SoftAp name is determined at runtime Config.apid = ESP.hostname(); // Retrieve host name to SotAp identification Config.apip = IPAddress( 192 , 168 , 10 , 101 ); // Sets SoftAP IP address Config.gateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WLAN router IP address Config.netmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.autoReconnect = true; // Enable auto-reconnect Config.autoSave = AC_SAVECREDENTIAL_NEVER; // No save credential Config.boundaryOffet = 64 ; // Reserve 64 bytes for the user data in EEPROM. Config.portalTimeout = 60000 ; // Sets timeout value for the captive portal Config.retainPortal = true; // Retains the portal function after timed-out Config.homeUri = \"/index.html\" ; // Sets home path of the sketch application Config.title = \"My menu\" ; // Customize the menu title Config.staip = IPAddress( 192 , 168 , 10 , 10 ); // Sets static IP Config.staGateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WiFi router address Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.dns1 = IPAddress( 192 , 168 , 10 , 1 ); // Sets primary DNS address Portal.config(Config); // Configure AutoConnect Portal.begin(); // Starts and behaves captive portal","title":" AutoConnectConfig example"},{"location":"apielements.html","text":"AutoConnectButton \u00b6 Constructor \u00b6 AutoConnectButton( const char * name = \"\" , const char * value = \"\" , const String & action = String(), const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value Value of the element. action Native code of the action script executed when the button is clicked. post Specifies the tag to be output afterward the element. Public member variables \u00b6 action \u00b6 HTML native code of the action script to be executed when the button is clicked. It is mostly used with a JavaScript to activate a script. 1 Type String enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. value \u00b6 Value of the element. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Button AutoConnectCheckbox \u00b6 Constructor \u00b6 AutoConnectCheckbox( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const bool checked = false, const ACPosition_t labelPosition = AC_Behind, const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value Value of the element. label A label string prefixed to the checkbox. check Checked state of the checkbox. labelPosition Specifies the position of the label to generate. post Specifies the tag to be output afterward the element. Public member variables \u00b6 checked \u00b6 It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit. Type bool enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. label \u00b6 A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML < label > tag with an id attribute. The checkbox and the label are connected by the id attribute. Type String labelPosition \u00b6 Specifies the position of the label to generate with ACPostion_t enumeration value. Type ACPosition_t AC_Infront : Place a label in front of the check box. AC_Behind : Place a label behind the check box. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. value \u00b6 Value of the element. It becomes a value attribute of an HTML < input type = \"checkbox\" > tag. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Checkbox AutoConnectElement \u00b6 Constructor \u00b6 AutoConnectElement( const char * name = \"\" , const char * value = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value Value of the element. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. value \u00b6 Value of the element. It is output as HTML as it is as a source for generating HTML code. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Element as<T> \u00b6 AutoConnectElement & as < T > ( void ) Casts the reference to the AutoConnectElement the specified type. Parameter T The element type. AutoConnectElements type such as AutoConnectButton , AutoConnectCheckbox , AutoConnectFile , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectStyle , AutoConnectSubmit , AutoConnectText . Return value A reference to the AutoConnectElement with actual type. AutoConnectFile \u00b6 Constructor \u00b6 AutoConnectFile( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const ACFile_t store = AC_File_FS, const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value File name to be upload. label Label string. store The ACFile_t enumerator that represents the media to save the uploaded file. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. label \u00b6 A label is an optional string. A label is always arranged on the left side of the file input box. Specification of a label will generate an HTML < label > tag with an id attribute. The file input box and the label are connected by the id attribute. Type String mimeType \u00b6 The mime type of the upload file which included as Media type in the http post request. Set by the client (usually the browser) that requested the upload. It is determined by the file type as application/octet-stream , text etc. which is described in IANA Media Type . Type String name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. size \u00b6 Size of the uploading file. Type size_t store \u00b6 Specifies the save destination of the uploaded file. You can use the built-in uploader to save uploaded file to the flash of the ESP8266/ESP32 module or external SD media without writing a dedicated sketch code. It also supports saving to any destination using a custom uploader that inherits from the AutoConnectUploadHandler class. Type ACFile_t AC_File_FS : Save the uploaded file to SPIFFS in the flash. AC_File_SD : Save the uploaded file to SD. AC_File_Extern : Save the file using your own upload handler. value \u00b6 File name to be upload. The value contains the value entered by the client browser to the < input type = \"file\" > tag and is read-only. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectFile. Return value AC_File AutoConnectInput \u00b6 Constructor \u00b6 AutoConnectInput( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const char * pattern = \"\" , const char * placeholder = \"\" , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value Value of the element. label Label string. pattern Regular expression string for checking data format. placeholder A placeholder string. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. Type String name \u00b6 The element name. Type String pattern \u00b6 A pattern specifies a regular expression that the input-box's value is checked against on form submission. Type String placeholder \u00b6 A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. value \u00b6 Value of the element. It becomes a value attribute of an HTML < input type = \"text\" > tag. An entered text in the custom Web page will be sent with a query string of the form. The value set before accessing the page is displayed as the initial value. Type String Public member functions \u00b6 isValid \u00b6 bool isValid( void ) Evaluate the pattern as a regexp and return whether value matches. Always return true if the pattern is undefined. Return value true The value matches a pattern. false The value does not match a pattern. typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Input AutoConnectRadio \u00b6 Constructor \u00b6 AutoConnectRadio( const char * name = \"\" , std :: vector < String > const & values = {}, const char * label = \"\" , const ACArrange_t order = AC_Vertical, const uint8_t checked = 0 , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. values An array of values of the radio buttons. Specifies a std::vector object. label Label string. order The direction to arrange the radio buttons. checked An index to be checked in the radio buttons. post Specifies the tag to be output afterward the element. Public member variables \u00b6 checked \u00b6 Specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. Type uint8_t enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. label \u00b6 A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Type String name \u00b6 The element name. Type String order \u00b6 Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the order . It is a value of ACArrange_t type and accepts one of the following: Type ACArrange_t AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. values \u00b6 An array of String type for the radio button options. It is an initialization list can be used. The < input type = \"radio\" > tags will be generated from each entry in the values. Type std::vector<String> Public member functions \u00b6 add \u00b6 void add( const String & value) Adds an option for the radio button. Parameter value An option string to add to the radio button. check \u00b6 void check( const String & value) Indicates the check of the specified option for the radio buttons. You can use the check function for checking dynamically with arbitrary of the radio button. Parameter value An option string to be checked. empty \u00b6 void empty( const size_t reserve = 0 ) Clear the array of option strings that AutoConnectRadio has in the values. When the reserve parameter is specified, a vector container of that size is reserved. The empty function resets the checked value to zero. When the empty function is executed, any button will be turned off. Parameter reserve Reserved size of a container for the radio button option strings. operator [ ] \u00b6 const String & operator [] ( const std :: size_t n) Returns a value string of the index specified by n . Parameter n Index of values array to return. Its base number is 0. Return value A reference of a value string indexed by the specified the n . size \u00b6 size_t size( void ) Returns number of options which contained. Return value Number of options which contained. typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Radio value \u00b6 const String & value( void ) const Returns current checked option of the radio buttons. Return value A String of an option current checked. If there is no checked option, a null string returned. AutoConnectSelect \u00b6 Constructor \u00b6 AutoConnectSelect( const char * name = \"\" , std :: vector < String > const & options = {}, const char * label = \"\" , const uint8_t selected = 0 , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. options An array of options of the select element. Specifies a std::vector object. label Label string. selected An option should be pre-selected when the page loads. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String label \u00b6 A label is an optional string. A label will be arranged in the top of the selection list. Type String options \u00b6 An array of String type for the selection options. It is an initialization list can be used. The < option value > tags will be generated from each entry in the options. Type std::vector<String> post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. selected \u00b6 A selected is an optional value. Specifies 1-based index value of an options array that an option should be pre-selected when the page loads. Type uint8_t Public member functions \u00b6 add \u00b6 void add( const String & option) Adds a selectable option string for the selection list. Parameter option A string of selectable item to be contained in the select element. empty \u00b6 void empty( const size_t reserve = 0 ) Clear the array of options list that AutoConnectSelect has in the options. When the reserve parameter is specified, a vector container of that size is reserved. The empty function resets the selected value to zero. When the empty function is executed, there are no selected options and the first item is placed at the beginning. Parameter reserve Reserved size of a container for the options. operator [ ] \u00b6 const String & operator [] ( const std :: size_t n) Returns an option string of the index specified by n . Parameter n Index of options array to return. Its base number is 0. Return value A reference of a option string indexed by the specified the n . select \u00b6 void select ( const String & value); Selects an option with the value. Parameter value String value that option should be selected in an option array. size \u00b6 size_t size( void ) Returns number of options which contained. Return value Number of options which contained. typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Select value \u00b6 const String & value( void ) const ; Returns current selected option of the select list. Return value A String of an option current selected. If there is no select option, a null string returned. AutoConnectStyle \u00b6 Constructor \u00b6 AutoConnectStyle( const char * name = \"\" , const char * value = \"\" ) Parameters name The element name. value Raw CSS code to insert into a style block in a custom web page to generate. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. name \u00b6 The element name. Type String value \u00b6 Raw CSS code to insert into a style block in a custom web page to generate. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Style AutoConnectSubmit \u00b6 Constructor \u00b6 AutoConnectSubmit( const char * name = \"\" , const char * value = \"\" , char * uri = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value The name of the submit button as an HTML < input type = \"button\" > tag, it will also be the label of the button. uri Destination URI. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. uri \u00b6 Destination URI. Type String value \u00b6 The name of the submit button. It will also be the label of the button. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Submit AutoConnectText \u00b6 Constructor \u00b6 AutoConnectText( const char * name = \"\" , const char * value = \"\" , const char * style = \"\" , const char * format = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value String of content for the text element. style A style code with CSS format that qualifiers the text. format A pointer to a null-terminated multibyte string specifying how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to C-style printf library functions post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. format \u00b6 The conversion format when outputting values. The format string conforms to C-style printf library functions. Type String global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. style \u00b6 A style code with CSS format that qualifiers the text. Type String value \u00b6 A content string of the text element. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Text JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9","title":"AutoConnectElements API"},{"location":"apielements.html#autoconnectbutton","text":"","title":"AutoConnectButton"},{"location":"apielements.html#constructor","text":"AutoConnectButton( const char * name = \"\" , const char * value = \"\" , const String & action = String(), const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value Value of the element. action Native code of the action script executed when the button is clicked. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apielements.html#action","text":"HTML native code of the action script to be executed when the button is clicked. It is mostly used with a JavaScript to activate a script. 1 Type String","title":" action"},{"location":"apielements.html#enable","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#value","text":"Value of the element. Type String","title":" value"},{"location":"apielements.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apielements.html#typeof","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Button","title":" typeOf"},{"location":"apielements.html#autoconnectcheckbox","text":"","title":"AutoConnectCheckbox"},{"location":"apielements.html#constructor_1","text":"AutoConnectCheckbox( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const bool checked = false, const ACPosition_t labelPosition = AC_Behind, const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value Value of the element. label A label string prefixed to the checkbox. check Checked state of the checkbox. labelPosition Specifies the position of the label to generate. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_1","text":"","title":" Public member variables"},{"location":"apielements.html#checked","text":"It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit. Type bool","title":" checked"},{"location":"apielements.html#enable_1","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_1","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#label","text":"A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML < label > tag with an id attribute. The checkbox and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#labelposition","text":"Specifies the position of the label to generate with ACPostion_t enumeration value. Type ACPosition_t AC_Infront : Place a label in front of the check box. AC_Behind : Place a label behind the check box.","title":" labelPosition"},{"location":"apielements.html#name_1","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_1","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#value_1","text":"Value of the element. It becomes a value attribute of an HTML < input type = \"checkbox\" > tag. Type String","title":" value"},{"location":"apielements.html#public-member-functions_1","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_1","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Checkbox","title":" typeOf"},{"location":"apielements.html#autoconnectelement","text":"","title":"AutoConnectElement"},{"location":"apielements.html#constructor_2","text":"AutoConnectElement( const char * name = \"\" , const char * value = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value Value of the element. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_2","text":"","title":" Public member variables"},{"location":"apielements.html#enable_2","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_2","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name_2","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_2","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#value_2","text":"Value of the element. It is output as HTML as it is as a source for generating HTML code. Type String","title":" value"},{"location":"apielements.html#public-member-functions_2","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_2","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Element","title":" typeOf"},{"location":"apielements.html#ast62","text":"AutoConnectElement & as < T > ( void ) Casts the reference to the AutoConnectElement the specified type. Parameter T The element type. AutoConnectElements type such as AutoConnectButton , AutoConnectCheckbox , AutoConnectFile , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectStyle , AutoConnectSubmit , AutoConnectText . Return value A reference to the AutoConnectElement with actual type.","title":" as&lt;T>"},{"location":"apielements.html#autoconnectfile","text":"","title":"AutoConnectFile"},{"location":"apielements.html#constructor_3","text":"AutoConnectFile( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const ACFile_t store = AC_File_FS, const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value File name to be upload. label Label string. store The ACFile_t enumerator that represents the media to save the uploaded file. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_3","text":"","title":" Public member variables"},{"location":"apielements.html#enable_3","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_3","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#label_1","text":"A label is an optional string. A label is always arranged on the left side of the file input box. Specification of a label will generate an HTML < label > tag with an id attribute. The file input box and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#mimetype","text":"The mime type of the upload file which included as Media type in the http post request. Set by the client (usually the browser) that requested the upload. It is determined by the file type as application/octet-stream , text etc. which is described in IANA Media Type . Type String","title":" mimeType"},{"location":"apielements.html#name_3","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_3","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#size","text":"Size of the uploading file. Type size_t","title":" size"},{"location":"apielements.html#store","text":"Specifies the save destination of the uploaded file. You can use the built-in uploader to save uploaded file to the flash of the ESP8266/ESP32 module or external SD media without writing a dedicated sketch code. It also supports saving to any destination using a custom uploader that inherits from the AutoConnectUploadHandler class. Type ACFile_t AC_File_FS : Save the uploaded file to SPIFFS in the flash. AC_File_SD : Save the uploaded file to SD. AC_File_Extern : Save the file using your own upload handler.","title":" store"},{"location":"apielements.html#value_3","text":"File name to be upload. The value contains the value entered by the client browser to the < input type = \"file\" > tag and is read-only. Type String","title":" value"},{"location":"apielements.html#public-member-functions_3","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_3","text":"ACElement_t typeOf( void ) Returns type of AutoConnectFile. Return value AC_File","title":" typeOf"},{"location":"apielements.html#autoconnectinput","text":"","title":"AutoConnectInput"},{"location":"apielements.html#constructor_4","text":"AutoConnectInput( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const char * pattern = \"\" , const char * placeholder = \"\" , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value Value of the element. label Label string. pattern Regular expression string for checking data format. placeholder A placeholder string. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_4","text":"","title":" Public member variables"},{"location":"apielements.html#enable_4","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_4","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#label_2","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#name_4","text":"The element name. Type String","title":" name"},{"location":"apielements.html#pattern","text":"A pattern specifies a regular expression that the input-box's value is checked against on form submission. Type String","title":" pattern"},{"location":"apielements.html#placeholder","text":"A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. Type String","title":" placeholder"},{"location":"apielements.html#post_4","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#value_4","text":"Value of the element. It becomes a value attribute of an HTML < input type = \"text\" > tag. An entered text in the custom Web page will be sent with a query string of the form. The value set before accessing the page is displayed as the initial value. Type String","title":" value"},{"location":"apielements.html#public-member-functions_4","text":"","title":" Public member functions"},{"location":"apielements.html#isvalid","text":"bool isValid( void ) Evaluate the pattern as a regexp and return whether value matches. Always return true if the pattern is undefined. Return value true The value matches a pattern. false The value does not match a pattern.","title":" isValid"},{"location":"apielements.html#typeof_4","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Input","title":" typeOf"},{"location":"apielements.html#autoconnectradio","text":"","title":"AutoConnectRadio"},{"location":"apielements.html#constructor_5","text":"AutoConnectRadio( const char * name = \"\" , std :: vector < String > const & values = {}, const char * label = \"\" , const ACArrange_t order = AC_Vertical, const uint8_t checked = 0 , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. values An array of values of the radio buttons. Specifies a std::vector object. label Label string. order The direction to arrange the radio buttons. checked An index to be checked in the radio buttons. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_5","text":"","title":" Public member variables"},{"location":"apielements.html#checked_1","text":"Specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. Type uint8_t","title":" checked"},{"location":"apielements.html#enable_5","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_5","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#label_3","text":"A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Type String","title":" label"},{"location":"apielements.html#name_5","text":"The element name. Type String","title":" name"},{"location":"apielements.html#order","text":"Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the order . It is a value of ACArrange_t type and accepts one of the following: Type ACArrange_t AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement.","title":" order"},{"location":"apielements.html#post_5","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#values","text":"An array of String type for the radio button options. It is an initialization list can be used. The < input type = \"radio\" > tags will be generated from each entry in the values. Type std::vector<String>","title":" values"},{"location":"apielements.html#public-member-functions_5","text":"","title":" Public member functions"},{"location":"apielements.html#add","text":"void add( const String & value) Adds an option for the radio button. Parameter value An option string to add to the radio button.","title":" add"},{"location":"apielements.html#check","text":"void check( const String & value) Indicates the check of the specified option for the radio buttons. You can use the check function for checking dynamically with arbitrary of the radio button. Parameter value An option string to be checked.","title":" check"},{"location":"apielements.html#empty","text":"void empty( const size_t reserve = 0 ) Clear the array of option strings that AutoConnectRadio has in the values. When the reserve parameter is specified, a vector container of that size is reserved. The empty function resets the checked value to zero. When the empty function is executed, any button will be turned off. Parameter reserve Reserved size of a container for the radio button option strings.","title":" empty"},{"location":"apielements.html#operator","text":"const String & operator [] ( const std :: size_t n) Returns a value string of the index specified by n . Parameter n Index of values array to return. Its base number is 0. Return value A reference of a value string indexed by the specified the n .","title":" operator &#91;&nbsp;&#93;"},{"location":"apielements.html#size_1","text":"size_t size( void ) Returns number of options which contained. Return value Number of options which contained.","title":" size"},{"location":"apielements.html#typeof_5","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Radio","title":" typeOf"},{"location":"apielements.html#value_5","text":"const String & value( void ) const Returns current checked option of the radio buttons. Return value A String of an option current checked. If there is no checked option, a null string returned.","title":" value"},{"location":"apielements.html#autoconnectselect","text":"","title":"AutoConnectSelect"},{"location":"apielements.html#constructor_6","text":"AutoConnectSelect( const char * name = \"\" , std :: vector < String > const & options = {}, const char * label = \"\" , const uint8_t selected = 0 , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. options An array of options of the select element. Specifies a std::vector object. label Label string. selected An option should be pre-selected when the page loads. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_6","text":"","title":" Public member variables"},{"location":"apielements.html#enable_6","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_6","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name_6","text":"The element name. Type String","title":" name"},{"location":"apielements.html#label_4","text":"A label is an optional string. A label will be arranged in the top of the selection list. Type String","title":" label"},{"location":"apielements.html#options","text":"An array of String type for the selection options. It is an initialization list can be used. The < option value > tags will be generated from each entry in the options. Type std::vector<String>","title":" options"},{"location":"apielements.html#post_6","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#selected","text":"A selected is an optional value. Specifies 1-based index value of an options array that an option should be pre-selected when the page loads. Type uint8_t","title":" selected"},{"location":"apielements.html#public-member-functions_6","text":"","title":" Public member functions"},{"location":"apielements.html#add_1","text":"void add( const String & option) Adds a selectable option string for the selection list. Parameter option A string of selectable item to be contained in the select element.","title":" add"},{"location":"apielements.html#empty_1","text":"void empty( const size_t reserve = 0 ) Clear the array of options list that AutoConnectSelect has in the options. When the reserve parameter is specified, a vector container of that size is reserved. The empty function resets the selected value to zero. When the empty function is executed, there are no selected options and the first item is placed at the beginning. Parameter reserve Reserved size of a container for the options.","title":" empty"},{"location":"apielements.html#operator_1","text":"const String & operator [] ( const std :: size_t n) Returns an option string of the index specified by n . Parameter n Index of options array to return. Its base number is 0. Return value A reference of a option string indexed by the specified the n .","title":" operator &#91;&nbsp;&#93;"},{"location":"apielements.html#select","text":"void select ( const String & value); Selects an option with the value. Parameter value String value that option should be selected in an option array.","title":" select"},{"location":"apielements.html#size_2","text":"size_t size( void ) Returns number of options which contained. Return value Number of options which contained.","title":" size"},{"location":"apielements.html#typeof_6","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Select","title":" typeOf"},{"location":"apielements.html#value_6","text":"const String & value( void ) const ; Returns current selected option of the select list. Return value A String of an option current selected. If there is no select option, a null string returned.","title":" value"},{"location":"apielements.html#autoconnectstyle","text":"","title":"AutoConnectStyle"},{"location":"apielements.html#constructor_7","text":"AutoConnectStyle( const char * name = \"\" , const char * value = \"\" ) Parameters name The element name. value Raw CSS code to insert into a style block in a custom web page to generate.","title":" Constructor"},{"location":"apielements.html#public-member-variables_7","text":"","title":" Public member variables"},{"location":"apielements.html#enable_7","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#name_7","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value_7","text":"Raw CSS code to insert into a style block in a custom web page to generate. Type String","title":" value"},{"location":"apielements.html#public-member-functions_7","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_7","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Style","title":" typeOf"},{"location":"apielements.html#autoconnectsubmit","text":"","title":"AutoConnectSubmit"},{"location":"apielements.html#constructor_8","text":"AutoConnectSubmit( const char * name = \"\" , const char * value = \"\" , char * uri = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value The name of the submit button as an HTML < input type = \"button\" > tag, it will also be the label of the button. uri Destination URI. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_8","text":"","title":" Public member variables"},{"location":"apielements.html#enable_8","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_7","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name_8","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_7","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#uri","text":"Destination URI. Type String","title":" uri"},{"location":"apielements.html#value_8","text":"The name of the submit button. It will also be the label of the button. Type String","title":" value"},{"location":"apielements.html#public-member-functions_8","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_8","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Submit","title":" typeOf"},{"location":"apielements.html#autoconnecttext","text":"","title":"AutoConnectText"},{"location":"apielements.html#constructor_9","text":"AutoConnectText( const char * name = \"\" , const char * value = \"\" , const char * style = \"\" , const char * format = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value String of content for the text element. style A style code with CSS format that qualifiers the text. format A pointer to a null-terminated multibyte string specifying how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to C-style printf library functions post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_9","text":"","title":" Public member variables"},{"location":"apielements.html#enable_9","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#format","text":"The conversion format when outputting values. The format string conforms to C-style printf library functions. Type String","title":" format"},{"location":"apielements.html#global_8","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name_9","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_8","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#style","text":"A style code with CSS format that qualifiers the text. Type String","title":" style"},{"location":"apielements.html#value_9","text":"A content string of the text element. Type String","title":" value"},{"location":"apielements.html#public-member-functions_9","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_9","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Text JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9","title":" typeOf"},{"location":"apiextra.html","text":"Icons \u00b6 The library presents two PNG icons which can be used to embed a hyperlink to the AutoConnect menu. Bar type Cog type To reference the icon, use the AUTOCONNECT_LINK macro in the sketch. It expands into the string literal as an HTML <a></a> tag with PNG embedded of the AutoConnect menu hyperlinks. Icon type is specified by the parameter of the macro. BAR_24 Bars icon, 24x24. BAR_32 Bars icon, 32x32. BAR_48 Bars icon, 48x48. COG_16 Cog icon, 16x16. COG_24 Cog icon, 24x24. COG_32 Cog icon, 32x32. Usage String html = \"<html>\" ; html += AUTOCONNECT_LINK(BAR_32); html += \"</html>\" ; server.send( 200 , \"text/html\" , html);","title":"Something extra"},{"location":"apiextra.html#icons","text":"The library presents two PNG icons which can be used to embed a hyperlink to the AutoConnect menu. Bar type Cog type To reference the icon, use the AUTOCONNECT_LINK macro in the sketch. It expands into the string literal as an HTML <a></a> tag with PNG embedded of the AutoConnect menu hyperlinks. Icon type is specified by the parameter of the macro. BAR_24 Bars icon, 24x24. BAR_32 Bars icon, 32x32. BAR_48 Bars icon, 48x48. COG_16 Cog icon, 16x16. COG_24 Cog icon, 24x24. COG_32 Cog icon, 32x32. Usage String html = \"<html>\" ; html += AUTOCONNECT_LINK(BAR_32); html += \"</html>\" ; server.send( 200 , \"text/html\" , html);","title":" Icons"},{"location":"apiupdate.html","text":"Constructor \u00b6 AutoConnectUpdate \u00b6 AutoConnectUpdate( const String & host, const uint16_t port, const String & uri, const int timeout, const uint8_t ledOn) Parameters host Update server address. Specifies IP address or FQDN. port Specifies HTTP port for the updating process. The default is defined as the AUTOCONNECT_UPDATE_PORT macro in the AutoConnectDefs.h header file. uri Specifies a URI on the update server that has deployed available binary sketch files. timeout Specifies the maximum response time for the update server. The default is defined as the AUTOCONNECT_UPDATE_TIMEOUT macro in the AutoConnectDefs.h header file. ledOn Active signal to light the LED ticker during the update. Specifies HIGH or LOW The AutoConnectUpdate class inherits from the ESP8266HTTPUpdate ( HTTPUpdate for ESP32) class. Public member functions \u00b6 attach \u00b6 void AutoConnectUpdate :: attach(AutoConnect & portal) Attaches the AutoConnectUpdate to the AutoConnect which constitutes the bedrock of the update process. This function creates a dialog page for the update operation as an instance of AutoConnectAux and participates in the AutoConnect menu . Parameter portal Specifies a reference to the AutoConnect instance to attach. disable \u00b6 void AutoConnectUpdate :: disable( const bool activate) Disable the Update item in AutoConnect menu . The AutoConnect::disable function only hides the Update item from the menu, and the AutoConnectUpdate class is still active with the parameter condition. You can use the AutoConnectUpdate::enable function to appear it again in the menu. Parameter activate If specified the true then the Update item will be displayed on the AutoConnect menu and OTA update will be available during the WiFi status is WL_CONNECTED. For the false , the OTA update feature is disabled. enable \u00b6 void AutoConnectUpdate :: enable( void ) Makes AutoConnectUpdate class available by incorporating the OTA update function into the AutoConnect menu . In ordinarily, the AutoConnectUpdate class becomes available by just calling the AutoConnectUpdate::attach function. handleUpdate \u00b6 void AutoConnectUpdate :: handleUpdate( void ) Performs the update process. This function is called by AutoConnect::handleClient when AutoConnectUpdate is enabled. In many cases, sketches do not need to call this function on purpose. isEnabled \u00b6 bool AutoConnectUpdate :: isEnabled( void ) Returns whether AutoConnectUpdate is enabled. rebootOnUpdate \u00b6 void AutoConnectUpdate :: rebootOnUpdate( bool reboot) Specifies whether or not to automatically restart the module as a result of the successful completion of the update process. Parameter reboot If specified the true then the ESP module will reboot after the updating successfully completed. For the false , The module does not reboot automatically. The updated firmware remains stored in the flash update firmware area equipped on the ESP module. The boot process during the next start turn of the module by reset will copy the updated firmware to the actual program area and a new sketch program will start. The default value is the true. This function inherits from the ESP8266HTTPUpdate (HTTPUpdate for ESP32) class. setLedPin \u00b6 void AutoConnectUpdate :: setLedPin( int ledPin, uint8_t ledOn) Sets the port and the ON signal level of the externally connected LED that should act as a ticker during the update process. Parameter ledPin Specifies the PIN connected external LED for the ticker. The default is defined as the AUTOCONNECT_TICKER_PORT macro in the AutoConnectDefs.h header file and it is derived from the board-specific LED_BUILTIN . By default, the AutoConnectUpdate class does not use the ticker for boards without the LED_BUILTIN definition. If you connect the ticker LED externally, you need to specify the PIN using the setLedPin function. ledOn Specifies the the ON signal level of the LED PIN port. It is HIGH or LOW . This function inherits from the ESP8266HTTPUpdate (HTTPUpdate for ESP32) class. status \u00b6 AC_UPDATESTATUS_t AutoConnectUpdate :: status( void ) Returns the update process status transition indicator as an enumerated value of the AC_UPDATESTATUS_t type that indicates the process status of the AutoConnectUpdate class. Return value One of the enumerated values \u200b\u200bindicating the status of the Update class as follows: UPDATE_RESET : Update process ended, need to reset. UPDATE_IDLE : Update process has not started. UPDATE_START : Update process has been started. UPDATE_PROGRESS : Update process has been started. UPDATE_SUCCESS : Update successfully completed. UPDATE_NOAVAIL : No available update. UPDATE_FAIL : Update failed. Public member variables \u00b6 host \u00b6 Update server address. Specifies IP address or FQDN. Type String port \u00b6 HTTP port for the updating process. Type String The default is defined as the AUTOCONNECT_UPDATE_PORT macro in the AutoConnectDefs.h header file. uri \u00b6 URI on the update server that has deployed available binary sketch files. Type String","title":"AutoConnectUpdate API"},{"location":"apiupdate.html#constructor","text":"","title":" Constructor"},{"location":"apiupdate.html#autoconnectupdate","text":"AutoConnectUpdate( const String & host, const uint16_t port, const String & uri, const int timeout, const uint8_t ledOn) Parameters host Update server address. Specifies IP address or FQDN. port Specifies HTTP port for the updating process. The default is defined as the AUTOCONNECT_UPDATE_PORT macro in the AutoConnectDefs.h header file. uri Specifies a URI on the update server that has deployed available binary sketch files. timeout Specifies the maximum response time for the update server. The default is defined as the AUTOCONNECT_UPDATE_TIMEOUT macro in the AutoConnectDefs.h header file. ledOn Active signal to light the LED ticker during the update. Specifies HIGH or LOW The AutoConnectUpdate class inherits from the ESP8266HTTPUpdate ( HTTPUpdate for ESP32) class.","title":"AutoConnectUpdate"},{"location":"apiupdate.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apiupdate.html#attach","text":"void AutoConnectUpdate :: attach(AutoConnect & portal) Attaches the AutoConnectUpdate to the AutoConnect which constitutes the bedrock of the update process. This function creates a dialog page for the update operation as an instance of AutoConnectAux and participates in the AutoConnect menu . Parameter portal Specifies a reference to the AutoConnect instance to attach.","title":" attach"},{"location":"apiupdate.html#disable","text":"void AutoConnectUpdate :: disable( const bool activate) Disable the Update item in AutoConnect menu . The AutoConnect::disable function only hides the Update item from the menu, and the AutoConnectUpdate class is still active with the parameter condition. You can use the AutoConnectUpdate::enable function to appear it again in the menu. Parameter activate If specified the true then the Update item will be displayed on the AutoConnect menu and OTA update will be available during the WiFi status is WL_CONNECTED. For the false , the OTA update feature is disabled.","title":" disable"},{"location":"apiupdate.html#enable","text":"void AutoConnectUpdate :: enable( void ) Makes AutoConnectUpdate class available by incorporating the OTA update function into the AutoConnect menu . In ordinarily, the AutoConnectUpdate class becomes available by just calling the AutoConnectUpdate::attach function.","title":" enable"},{"location":"apiupdate.html#handleupdate","text":"void AutoConnectUpdate :: handleUpdate( void ) Performs the update process. This function is called by AutoConnect::handleClient when AutoConnectUpdate is enabled. In many cases, sketches do not need to call this function on purpose.","title":" handleUpdate"},{"location":"apiupdate.html#isenabled","text":"bool AutoConnectUpdate :: isEnabled( void ) Returns whether AutoConnectUpdate is enabled.","title":" isEnabled"},{"location":"apiupdate.html#rebootonupdate","text":"void AutoConnectUpdate :: rebootOnUpdate( bool reboot) Specifies whether or not to automatically restart the module as a result of the successful completion of the update process. Parameter reboot If specified the true then the ESP module will reboot after the updating successfully completed. For the false , The module does not reboot automatically. The updated firmware remains stored in the flash update firmware area equipped on the ESP module. The boot process during the next start turn of the module by reset will copy the updated firmware to the actual program area and a new sketch program will start. The default value is the true. This function inherits from the ESP8266HTTPUpdate (HTTPUpdate for ESP32) class.","title":" rebootOnUpdate"},{"location":"apiupdate.html#setledpin","text":"void AutoConnectUpdate :: setLedPin( int ledPin, uint8_t ledOn) Sets the port and the ON signal level of the externally connected LED that should act as a ticker during the update process. Parameter ledPin Specifies the PIN connected external LED for the ticker. The default is defined as the AUTOCONNECT_TICKER_PORT macro in the AutoConnectDefs.h header file and it is derived from the board-specific LED_BUILTIN . By default, the AutoConnectUpdate class does not use the ticker for boards without the LED_BUILTIN definition. If you connect the ticker LED externally, you need to specify the PIN using the setLedPin function. ledOn Specifies the the ON signal level of the LED PIN port. It is HIGH or LOW . This function inherits from the ESP8266HTTPUpdate (HTTPUpdate for ESP32) class.","title":" setLedPin"},{"location":"apiupdate.html#status","text":"AC_UPDATESTATUS_t AutoConnectUpdate :: status( void ) Returns the update process status transition indicator as an enumerated value of the AC_UPDATESTATUS_t type that indicates the process status of the AutoConnectUpdate class. Return value One of the enumerated values \u200b\u200bindicating the status of the Update class as follows: UPDATE_RESET : Update process ended, need to reset. UPDATE_IDLE : Update process has not started. UPDATE_START : Update process has been started. UPDATE_PROGRESS : Update process has been started. UPDATE_SUCCESS : Update successfully completed. UPDATE_NOAVAIL : No available update. UPDATE_FAIL : Update failed.","title":" status"},{"location":"apiupdate.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apiupdate.html#host","text":"Update server address. Specifies IP address or FQDN. Type String","title":" host"},{"location":"apiupdate.html#port","text":"HTTP port for the updating process. Type String The default is defined as the AUTOCONNECT_UPDATE_PORT macro in the AutoConnectDefs.h header file.","title":" port"},{"location":"apiupdate.html#uri","text":"URI on the update server that has deployed available binary sketch files. Type String","title":" uri"},{"location":"basicusage.html","text":"Simple usage \u00b6 Embed to the sketches \u00b6 How embed the AutoConnect to the sketches you have. Most simple approach to applying AutoConnect for the existing sketches, follow the below steps. The below sketch is for ESP8266. For ESP32, replace ESP8266WebServer with WebServer and ESP8266WiFi.h with WiFi.h respectively. Insert #include <AutoConnect.h> to behind of #include <ESP8266WebServer.h> . Insert AutoConnect PORTAL(WEBSERVER); to behind of ESP8266WebServer WEBSERVER; declaration. 1 Remove WiFi. begin ( SSID , PSK ) and the subsequent logic for the connection status check. Replace WEBSERVER . begin () to PORTAL . begin () . 2 Replace WEBSERVER . handleClient () to PORTAL . handleClient () . 3 If the connection checks logic is needed, you can check the return value according to PORTAL . begin () with true or false . Basic usage \u00b6 Basic logic sequence for the user sketches \u00b6 1. A typical logic sequence \u00b6 Include headers, ESP8266WebServer.h / WebServer.h and AutoConnect.h Declare an ESP8266WebServer variable for ESP8266 or a WebServer variable for ESP32. Declare an AutoConnect variable. Implement the URL handlers provided for the on method of ESP8266WebServer/WebServer with the function() . setup() 5.1 Sets URL handler the function() to ESP8266WebServer/WebServer by ESP8266WebServer::on / WebServer::on . 5.2 Starts AutoConnect::begin() . 5.3 Check WiFi connection status. loop() 6.1 Do the process for actual sketch. 6.2 Invokes AutoConnect::handleClient() , or invokes ESP8266WebServer::handleClient() / WebServer::handleClient then AutoConnect::handleRequest() . 2. Declare AutoConnect object \u00b6 Two options are available for AutoConnect constructor . AutoConnect VARIABLE ( & ESP8266WebServer); // For ESP8266 AutoConnect VARIABLE ( & WebServer); // For ESP32 or AutoConnect VARIABLE; The parameter with an ESP8266WebServer/WebServer variable: An ESP8266WebServer/WebServer object variable must be declared. AutoConnect uses its variable to handles the AutoConnect menu . With no parameter: The sketch does not declare ESP8266WebServer/WebServer object. In this case, AutoConnect allocates an instance of the ESP8266WebServer/WebServer internally. The logic sequence of the sketch is somewhat different as the above. To register a URL handler function by ESP8266WebServer::on or WebServer::on should be performed after AutoConnect::begin . 3. No need WiFI.begin(...) \u00b6 AutoConnect internally performs WiFi.begin to establish a WiFi connection. There is no need for a general process to establish a connection using WiFi.begin with a sketch code. 4. Alternate ESP8266WebServer::begin() and WebServer::begin() \u00b6 AutoConnect::begin executes ESP8266WebServer::begin / WebServer::begin internally too and it starts the DNS server to behave as a Captive portal. So it is not needed to call ESP8266WebServer::begin / WebServer::begin in the sketch. Why DNS Server starts AutoConnect traps the detection of the captive portal and achieves a connection with the WLAN interactively by the AutoConnect menu. It responds SoftAP address to all DNS queries temporarily to trap. Once a WiFi connection establishes, the DNS server contributed by AutoConnect stops. 5. AutoConnect::begin with SSID and Password \u00b6 SSID and Password can also specify by AutoConnect::begin . ESP8266/ESP32 uses provided SSID and Password explicitly. If the connection false with specified SSID with Password then a captive portal is activated. SSID and Password are not present, ESP8266 SDK will attempt to connect using the still effectual SSID and password. Usually, it succeeds. 6. Use ESP8266WebServer::on and WebServer::on to handle URL \u00b6 AutoConnect is designed to coexist with the process for handling the web pages by user sketches. The page processing function which will send an HTML to the client invoked by the \" on::ESP8266WebServer \" or the \" on::WebServer \" function is the same as when using ESP8266WebServer/WebServer natively. 7. Use either ESP8266WebServer::handleClient()/WebServer::handleClient() or AutoConnect::handleClient() \u00b6 Both classes member function name is the same: handleClient , but the behavior is different. Using the AutoConnect embedded along with ESP8266WebServer::handleClient/WebServer::handleClient has limitations. Refer to the below section for details. ESP8266WebServer/WebServer hosted or parasitic \u00b6 The interoperable process with an ESP8266WebServer/WebServer depends on the parameters of the AutoConnect constructor . Declaration parameter for the constructor Use ESP8266WebServer::handleClient or WebServer::handleClient only Use AutoConnect::handleClient None AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . also to use ESP8266WebServer/WebServer natively, need AutoConnect::host() . AutoConnect menu available. To use ESP8266WebServer/WebServer natively, need AutoConnect::host() . Reference to ESP8266WebServer/WebServer AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . AutoConnect menu available. By declaration for the AutoConnect variable with no parameter : The ESP8266WebServer/WebServer instance is hosted by AutoConnect automatically then the sketches use AutoConnect::host as API to get it after AutoConnect::begin performed. By declaration for the AutoConnect variable with the reference of ESP8266WebServer/WebServer : AutoConnect will use it. The sketch can use it is too. In use ESP8266WebServer::handleClient()/WebServer::handleClient() : AutoConnect menu can be dispatched but not works normally. It is necessary to call AutoConnect::handleRequest after ESP8255WebServer::handleClient / WebServer::handleClient invoking. In use AutoConnect::handleClient() : The handleClient() process and the AutoConnect menu is available without calling ESP8266WebServer::handleClient . Why AutoConnect::handleRequest is needed when using ESP8266WebServer::handleClient/WebServer::handleClient The AutoConnect menu function may affect WiFi connection state. It follows that the menu process must execute outside ESP8266WebServer::handleClient and WebServer::handleClient . AutoConnect::handleClient is equivalent ESP8266WebServer::handleClient and WEbServer::handleClient included AutoConnect::handleRequest . Each VARIABLE conforms to the actual declaration in the sketches. \u21a9 WiFi SSID and Password can be specified AutoConnect::begin() too. \u21a9 Replacement the handleClient method is not indispensable. AutoConnect can still connect with the captive portal as it is ESP8266WebServer::handleClient. But it can not valid AutoConnect menu . \u21a9","title":"Basic usage"},{"location":"basicusage.html#simple-usage","text":"","title":"Simple usage"},{"location":"basicusage.html#embed-to-the-sketches","text":"How embed the AutoConnect to the sketches you have. Most simple approach to applying AutoConnect for the existing sketches, follow the below steps. The below sketch is for ESP8266. For ESP32, replace ESP8266WebServer with WebServer and ESP8266WiFi.h with WiFi.h respectively. Insert #include <AutoConnect.h> to behind of #include <ESP8266WebServer.h> . Insert AutoConnect PORTAL(WEBSERVER); to behind of ESP8266WebServer WEBSERVER; declaration. 1 Remove WiFi. begin ( SSID , PSK ) and the subsequent logic for the connection status check. Replace WEBSERVER . begin () to PORTAL . begin () . 2 Replace WEBSERVER . handleClient () to PORTAL . handleClient () . 3 If the connection checks logic is needed, you can check the return value according to PORTAL . begin () with true or false .","title":" Embed to the sketches"},{"location":"basicusage.html#basic-usage","text":"","title":"Basic usage"},{"location":"basicusage.html#basic-logic-sequence-for-the-user-sketches","text":"","title":" Basic logic sequence for the user sketches"},{"location":"basicusage.html#1-a-typical-logic-sequence","text":"Include headers, ESP8266WebServer.h / WebServer.h and AutoConnect.h Declare an ESP8266WebServer variable for ESP8266 or a WebServer variable for ESP32. Declare an AutoConnect variable. Implement the URL handlers provided for the on method of ESP8266WebServer/WebServer with the function() . setup() 5.1 Sets URL handler the function() to ESP8266WebServer/WebServer by ESP8266WebServer::on / WebServer::on . 5.2 Starts AutoConnect::begin() . 5.3 Check WiFi connection status. loop() 6.1 Do the process for actual sketch. 6.2 Invokes AutoConnect::handleClient() , or invokes ESP8266WebServer::handleClient() / WebServer::handleClient then AutoConnect::handleRequest() .","title":"1. A typical logic sequence"},{"location":"basicusage.html#2-declare-autoconnect-object","text":"Two options are available for AutoConnect constructor . AutoConnect VARIABLE ( & ESP8266WebServer); // For ESP8266 AutoConnect VARIABLE ( & WebServer); // For ESP32 or AutoConnect VARIABLE; The parameter with an ESP8266WebServer/WebServer variable: An ESP8266WebServer/WebServer object variable must be declared. AutoConnect uses its variable to handles the AutoConnect menu . With no parameter: The sketch does not declare ESP8266WebServer/WebServer object. In this case, AutoConnect allocates an instance of the ESP8266WebServer/WebServer internally. The logic sequence of the sketch is somewhat different as the above. To register a URL handler function by ESP8266WebServer::on or WebServer::on should be performed after AutoConnect::begin .","title":"2. Declare AutoConnect object"},{"location":"basicusage.html#3-no-need-wifibegin","text":"AutoConnect internally performs WiFi.begin to establish a WiFi connection. There is no need for a general process to establish a connection using WiFi.begin with a sketch code.","title":"3. No need WiFI.begin(...)"},{"location":"basicusage.html#4-alternate-esp8266webserverbegin-and-webserverbegin","text":"AutoConnect::begin executes ESP8266WebServer::begin / WebServer::begin internally too and it starts the DNS server to behave as a Captive portal. So it is not needed to call ESP8266WebServer::begin / WebServer::begin in the sketch. Why DNS Server starts AutoConnect traps the detection of the captive portal and achieves a connection with the WLAN interactively by the AutoConnect menu. It responds SoftAP address to all DNS queries temporarily to trap. Once a WiFi connection establishes, the DNS server contributed by AutoConnect stops.","title":"4. Alternate ESP8266WebServer::begin() and WebServer::begin()"},{"location":"basicusage.html#5-autoconnectbegin-with-ssid-and-password","text":"SSID and Password can also specify by AutoConnect::begin . ESP8266/ESP32 uses provided SSID and Password explicitly. If the connection false with specified SSID with Password then a captive portal is activated. SSID and Password are not present, ESP8266 SDK will attempt to connect using the still effectual SSID and password. Usually, it succeeds.","title":"5. AutoConnect::begin with SSID and Password"},{"location":"basicusage.html#6-use-esp8266webserveron-and-webserveron-to-handle-url","text":"AutoConnect is designed to coexist with the process for handling the web pages by user sketches. The page processing function which will send an HTML to the client invoked by the \" on::ESP8266WebServer \" or the \" on::WebServer \" function is the same as when using ESP8266WebServer/WebServer natively.","title":"6. Use ESP8266WebServer::on and WebServer::on to handle URL"},{"location":"basicusage.html#7-use-either-esp8266webserverhandleclientwebserverhandleclient-or-autoconnecthandleclient","text":"Both classes member function name is the same: handleClient , but the behavior is different. Using the AutoConnect embedded along with ESP8266WebServer::handleClient/WebServer::handleClient has limitations. Refer to the below section for details.","title":"7. Use either ESP8266WebServer::handleClient()/WebServer::handleClient() or AutoConnect::handleClient()"},{"location":"basicusage.html#esp8266webserverwebserver-hosted-or-parasitic","text":"The interoperable process with an ESP8266WebServer/WebServer depends on the parameters of the AutoConnect constructor . Declaration parameter for the constructor Use ESP8266WebServer::handleClient or WebServer::handleClient only Use AutoConnect::handleClient None AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . also to use ESP8266WebServer/WebServer natively, need AutoConnect::host() . AutoConnect menu available. To use ESP8266WebServer/WebServer natively, need AutoConnect::host() . Reference to ESP8266WebServer/WebServer AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . AutoConnect menu available. By declaration for the AutoConnect variable with no parameter : The ESP8266WebServer/WebServer instance is hosted by AutoConnect automatically then the sketches use AutoConnect::host as API to get it after AutoConnect::begin performed. By declaration for the AutoConnect variable with the reference of ESP8266WebServer/WebServer : AutoConnect will use it. The sketch can use it is too. In use ESP8266WebServer::handleClient()/WebServer::handleClient() : AutoConnect menu can be dispatched but not works normally. It is necessary to call AutoConnect::handleRequest after ESP8255WebServer::handleClient / WebServer::handleClient invoking. In use AutoConnect::handleClient() : The handleClient() process and the AutoConnect menu is available without calling ESP8266WebServer::handleClient . Why AutoConnect::handleRequest is needed when using ESP8266WebServer::handleClient/WebServer::handleClient The AutoConnect menu function may affect WiFi connection state. It follows that the menu process must execute outside ESP8266WebServer::handleClient and WebServer::handleClient . AutoConnect::handleClient is equivalent ESP8266WebServer::handleClient and WEbServer::handleClient included AutoConnect::handleRequest . Each VARIABLE conforms to the actual declaration in the sketches. \u21a9 WiFi SSID and Password can be specified AutoConnect::begin() too. \u21a9 Replacement the handleClient method is not indispensable. AutoConnect can still connect with the captive portal as it is ESP8266WebServer::handleClient. But it can not valid AutoConnect menu . \u21a9","title":" ESP8266WebServer/WebServer hosted or parasitic"},{"location":"changelog.html","text":"[1.0.3] Sept. 30, 2019 \u00b6 Fixed a return of AutoConnectCredential::entries(). [1.0.2] Sept. 19, 2019 \u00b6 Fixed compilation error that no member named 'success' with ArduinoJson 5. Fixed SSID non termination. Fixed compilation error that getBytesLength missing with ESP32. Added #include directive restriction for EEPROM and ESP8266httpUpdate to FAQ. [1.0.1] Sept. 13, 2019 \u00b6 Added a sketch for ESP32 boards that migrates credentials stored in EEPROM partition to the Preferences. [1.0.0] Sept. 7, 2019 \u00b6 Supports Arduino core for ESP32 1.0.3. Supports AutoConnectUpdate for the OTA update . Supports Preferences for saving credentials with ESP32 core 1.0.3 and later. In ESP32, the credentials stored past in EEPROM will lose . Supports AutoConnectAux::isValid function. Supports the global attribute with all AutoConnectElements. [0.9.12] Aug. 18, 2019 \u00b6 Fixed missing captive portal notifications on the newer mobile OS client. As a result of this fix, the SoftAP default IP address and gateway have been changed to 172.217.28.1 . [0.9.11] July 13, 2019 \u00b6 Supports new element as AutoConnectSytle that can insert the custom CSS into AutoConnectAux page. Supports that <br> tags can now be added to each element. Supports that able to place the checkbox label forward or backward. Supports flicker signal output according to the status of WiFi_mode. Supports AutoConnectAux::fetchElement function to retrieve inputted element values via a custom Web page. Fixed bug in AutoConnectCredential when offset is >256. [0.9.10] June 12, 2019 \u00b6 Fixed the unable to get AutoConnectElemets values \u200b\u200bin the sketch with ESP8266 arduino core 2.5.2. [0.9.9] May 25, 2019 \u00b6 Supports ESP8266 Arduino core 2.5.2. Menu text/background color can be statically customized. Added the enable attribute to the AutoConnectElements. This attribute gives dynamically change to the element activation during the sketch executing. Added ID attribute to HTML tag generated from AutoConnectText. Fixed the input box layout collapsed. Fixed that the decoration of AutoConnectButton was disabled. Fixed that the value remains even after clearing the option with AutoConnectSelect. Fixed that an alignment violation exception occurred when loading AutoConnectAux described by JSON with PROGMEM attribute. [0.9.8] May 3, 2019 \u00b6 Supports ArduinoJson 6.9.1 or later. Supports allocating JsonDocument buffer to PSRAM on ESP32 with ArduinoJson 6.10.0 or later. Supports operator [] as a shortcut for AutoConnectAux::getElement function. Supports AutoConnectElement::as<T> function to easily coding for conversion from an AutoConnectElement to an actual type. Supports new element type AutoConnectFile and built-in file uploader. Supports a format attribute with the AutoConnectText element. Supports a selected attribute with the AutoConnectSelect element. Supports multiple element loading with AutoConnectAux::loadElement . Changed menu labels placement in source files structure. Changed API interface of **AutoConnect::where function. Fixed blank page responds with Configure new. Fixed loading elements value missing. Fixed losing elements in saveElement with ArduinoJson V6. Fixed compile error with older than ESP8266 core 2.5.0. [0.9.7] Jan. 25, 2019 \u00b6 Fixed crash in some environments. Thank you @ageurtse Supports AutoConnect menu extension by user sketch with AutoConnectAux . Supports loading and saving of user-defined parameters with JSON format. Improved the WiFi connection sequence at the first WiFi.begin. Even if AutoConnectConfig::autoReconnect is disabled when SSID and PSK are not specified, it will use the information of the last established access point. The autoReconnect option will achieve trying the connect after a previous connection failed. Supports the AutoConnectConfig::immediateStart option and immediately starts the portal without first trying WiFi.begin. You can start the captive portal at any time in combination with the AutoConnectConfig::autoRise option. Improved boot uri after reset. AutoConnectConfig::bootUri can be specified either /_ac or HOME path as the uri to be accessed after invoking Reset from AutoConnect menu. Improved source code placement of predefined macros. Defined common macros have been moved to AutoConnectDefs.h . Supports AutoConnectConfig::hostName . It activates WiFi.hostname() / WiFi.setHostName() . Supports the captive portal time-out. It can be controlled by AutoConnectConfig::portalTimeout and AutoConnectConfig::retainPortal . [0.9.6] Sept.27, 2018. \u00b6 Improvement of RSSI detection for saved SSIDs. Fixed disconnection SoftAP completely at the first connection phase of the AutoConnect::begin . [0.9.5] Aug.27, 2018. \u00b6 Supports ESP32. Fixed that crash may occur if the number of stored credentials in the EEPROM is smaller than the number of found WiFi networks. [0.9.4] May 5, 2018. \u00b6 Automatically focus passphrase after selecting SSID with Configure New AP. Supports AutoConnectConfig::autoReconnect option, it will scan the WLAN when it can not connect to the default SSID, apply the applicable credentials if it is saved, and try reconnecting. [0.9.3] March 23, 2018. \u00b6 Supports a static IP address assignment. [0.9.2] March 19, 2018. \u00b6 Improvement of string literal declaration with the examples, no library change. [0.9.1] March 13, 2018. \u00b6 A release of the stable.","title":"Change log"},{"location":"changelog.html#103-sept-30-2019","text":"Fixed a return of AutoConnectCredential::entries().","title":"[1.0.3] Sept. 30, 2019"},{"location":"changelog.html#102-sept-19-2019","text":"Fixed compilation error that no member named 'success' with ArduinoJson 5. Fixed SSID non termination. Fixed compilation error that getBytesLength missing with ESP32. Added #include directive restriction for EEPROM and ESP8266httpUpdate to FAQ.","title":"[1.0.2] Sept. 19, 2019"},{"location":"changelog.html#101-sept-13-2019","text":"Added a sketch for ESP32 boards that migrates credentials stored in EEPROM partition to the Preferences.","title":"[1.0.1] Sept. 13, 2019"},{"location":"changelog.html#100-sept-7-2019","text":"Supports Arduino core for ESP32 1.0.3. Supports AutoConnectUpdate for the OTA update . Supports Preferences for saving credentials with ESP32 core 1.0.3 and later. In ESP32, the credentials stored past in EEPROM will lose . Supports AutoConnectAux::isValid function. Supports the global attribute with all AutoConnectElements.","title":"[1.0.0] Sept. 7, 2019"},{"location":"changelog.html#0912-aug-18-2019","text":"Fixed missing captive portal notifications on the newer mobile OS client. As a result of this fix, the SoftAP default IP address and gateway have been changed to 172.217.28.1 .","title":"[0.9.12] Aug. 18, 2019"},{"location":"changelog.html#0911-july-13-2019","text":"Supports new element as AutoConnectSytle that can insert the custom CSS into AutoConnectAux page. Supports that <br> tags can now be added to each element. Supports that able to place the checkbox label forward or backward. Supports flicker signal output according to the status of WiFi_mode. Supports AutoConnectAux::fetchElement function to retrieve inputted element values via a custom Web page. Fixed bug in AutoConnectCredential when offset is >256.","title":"[0.9.11] July 13, 2019"},{"location":"changelog.html#0910-june-12-2019","text":"Fixed the unable to get AutoConnectElemets values \u200b\u200bin the sketch with ESP8266 arduino core 2.5.2.","title":"[0.9.10] June 12, 2019"},{"location":"changelog.html#099-may-25-2019","text":"Supports ESP8266 Arduino core 2.5.2. Menu text/background color can be statically customized. Added the enable attribute to the AutoConnectElements. This attribute gives dynamically change to the element activation during the sketch executing. Added ID attribute to HTML tag generated from AutoConnectText. Fixed the input box layout collapsed. Fixed that the decoration of AutoConnectButton was disabled. Fixed that the value remains even after clearing the option with AutoConnectSelect. Fixed that an alignment violation exception occurred when loading AutoConnectAux described by JSON with PROGMEM attribute.","title":"[0.9.9] May 25, 2019"},{"location":"changelog.html#098-may-3-2019","text":"Supports ArduinoJson 6.9.1 or later. Supports allocating JsonDocument buffer to PSRAM on ESP32 with ArduinoJson 6.10.0 or later. Supports operator [] as a shortcut for AutoConnectAux::getElement function. Supports AutoConnectElement::as<T> function to easily coding for conversion from an AutoConnectElement to an actual type. Supports new element type AutoConnectFile and built-in file uploader. Supports a format attribute with the AutoConnectText element. Supports a selected attribute with the AutoConnectSelect element. Supports multiple element loading with AutoConnectAux::loadElement . Changed menu labels placement in source files structure. Changed API interface of **AutoConnect::where function. Fixed blank page responds with Configure new. Fixed loading elements value missing. Fixed losing elements in saveElement with ArduinoJson V6. Fixed compile error with older than ESP8266 core 2.5.0.","title":"[0.9.8] May 3, 2019"},{"location":"changelog.html#097-jan-25-2019","text":"Fixed crash in some environments. Thank you @ageurtse Supports AutoConnect menu extension by user sketch with AutoConnectAux . Supports loading and saving of user-defined parameters with JSON format. Improved the WiFi connection sequence at the first WiFi.begin. Even if AutoConnectConfig::autoReconnect is disabled when SSID and PSK are not specified, it will use the information of the last established access point. The autoReconnect option will achieve trying the connect after a previous connection failed. Supports the AutoConnectConfig::immediateStart option and immediately starts the portal without first trying WiFi.begin. You can start the captive portal at any time in combination with the AutoConnectConfig::autoRise option. Improved boot uri after reset. AutoConnectConfig::bootUri can be specified either /_ac or HOME path as the uri to be accessed after invoking Reset from AutoConnect menu. Improved source code placement of predefined macros. Defined common macros have been moved to AutoConnectDefs.h . Supports AutoConnectConfig::hostName . It activates WiFi.hostname() / WiFi.setHostName() . Supports the captive portal time-out. It can be controlled by AutoConnectConfig::portalTimeout and AutoConnectConfig::retainPortal .","title":"[0.9.7] Jan. 25, 2019"},{"location":"changelog.html#096-sept27-2018","text":"Improvement of RSSI detection for saved SSIDs. Fixed disconnection SoftAP completely at the first connection phase of the AutoConnect::begin .","title":"[0.9.6] Sept.27, 2018."},{"location":"changelog.html#095-aug27-2018","text":"Supports ESP32. Fixed that crash may occur if the number of stored credentials in the EEPROM is smaller than the number of found WiFi networks.","title":"[0.9.5] Aug.27, 2018."},{"location":"changelog.html#094-may-5-2018","text":"Automatically focus passphrase after selecting SSID with Configure New AP. Supports AutoConnectConfig::autoReconnect option, it will scan the WLAN when it can not connect to the default SSID, apply the applicable credentials if it is saved, and try reconnecting.","title":"[0.9.4] May 5, 2018."},{"location":"changelog.html#093-march-23-2018","text":"Supports a static IP address assignment.","title":"[0.9.3] March 23, 2018."},{"location":"changelog.html#092-march-19-2018","text":"Improvement of string literal declaration with the examples, no library change.","title":"[0.9.2] March 19, 2018."},{"location":"changelog.html#091-march-13-2018","text":"A release of the stable.","title":"[0.9.1] March 13, 2018."},{"location":"colorized.html","text":"AutoConnect menu colorizing \u00b6 You can easily change the color of the AutoConnect menu. Menu colors can be changed statically by the AutoConnect menu color definition determined at compile time. You cannot change the color while the sketch is running. The menu color scheme has been separated to AutoConnectLabels.h placed the AutoConnect library folder. 1 You can change the color scheme of the menu with the following three color codes. The color code also accepts CSS standard color names. 2 In AutoConnectLabels.h you can find three definition macros for menu colors: #define AUTOCONNECT_MENUCOLOR_TEXT Defines the menu text color. #define AUTOCONNECT_MENUCOLOR_BACKGROUND Defines the menu background color. #define AUTOCONNECT_MENUCOLOR_ACTIVE Defines the active menu item background color. Typical color schemes \u00b6 Here are some color schemes picked up. Indigo \u00b6 #define AUTOCONNECT_MENUCOLOR_TEXT \"#ffa500\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#1a237e\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#283593\" Dim-gray \u00b6 #define AUTOCONNECT_MENUCOLOR_TEXT \"#fffacd\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#696969\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#808080\" Brown \u00b6 #define AUTOCONNECT_MENUCOLOR_TEXT \"#e6e6fa\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#3e2723\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#4e342e\" Usually, it will locate to the Arduino/libraries/AutoConnect/src folder of user documents. \u21a9 The W3C HTML and CSS standards have listed only 16 valid color names: aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, and yellow. Major browsers can accept more color names, but they are not web safe in typically. \u21a9","title":"Custom colorized"},{"location":"colorized.html#autoconnect-menu-colorizing","text":"You can easily change the color of the AutoConnect menu. Menu colors can be changed statically by the AutoConnect menu color definition determined at compile time. You cannot change the color while the sketch is running. The menu color scheme has been separated to AutoConnectLabels.h placed the AutoConnect library folder. 1 You can change the color scheme of the menu with the following three color codes. The color code also accepts CSS standard color names. 2 In AutoConnectLabels.h you can find three definition macros for menu colors: #define AUTOCONNECT_MENUCOLOR_TEXT Defines the menu text color. #define AUTOCONNECT_MENUCOLOR_BACKGROUND Defines the menu background color. #define AUTOCONNECT_MENUCOLOR_ACTIVE Defines the active menu item background color.","title":"AutoConnect menu colorizing"},{"location":"colorized.html#typical-color-schemes","text":"Here are some color schemes picked up.","title":"Typical color schemes"},{"location":"colorized.html#indigo","text":"#define AUTOCONNECT_MENUCOLOR_TEXT \"#ffa500\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#1a237e\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#283593\"","title":" Indigo"},{"location":"colorized.html#dim-gray","text":"#define AUTOCONNECT_MENUCOLOR_TEXT \"#fffacd\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#696969\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#808080\"","title":" Dim-gray"},{"location":"colorized.html#brown","text":"#define AUTOCONNECT_MENUCOLOR_TEXT \"#e6e6fa\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#3e2723\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#4e342e\" Usually, it will locate to the Arduino/libraries/AutoConnect/src folder of user documents. \u21a9 The W3C HTML and CSS standards have listed only 16 valid color names: aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, and yellow. Major browsers can accept more color names, but they are not web safe in typically. \u21a9","title":" Brown"},{"location":"credit.html","text":"Saved credentials in the flash \u00b6 AutoConnect stores the established WiFi connection in the flash memory of the ESP8266/ESP32 module and equips the class to access the credentials from the sketch. You can read, write or erase the credentials using this class individually. It's AutoConnectCredential class which provides the access method to the saved credentials in the flash. 1 Credentials storage location \u00b6 The location where AutoConnect saves credentials depends on the module type and the AutoConnect library version, also arduino-esp32 core version. In either case, the location is flash memory, but EEPROM and Preferences (in the nvs 2 ) are used depending on the library versions. AutoConnect Arduino core for ESP8266 Arduino core for ESP32 1.0.2 earlier 1.0.3 later v0.9.12 earlier EEPROM EEPROM (partition) Not supported v1.0.0 later Preferences (nvs) (Can be used EEPROM with turning off AUTOCONNECT_USE_PREFERENCES macro) Preferences (nvs) However, sketches do not need to know where to store credentials using the commonly accessible AutoConnectCredential API. If you are using an Arduino core for ESP32 1.0.2 earlier and need to use credentials in EEPROM for backward compatibility, turns off the AUTOCONNECT_USE_PREFERENCES 3 macro definition in AutoConnectCredentials.h file. AutoConnect behaves assuming that credentials are stored in EEPROM if AUTOCONNECT_USE_PREFERENCES is not defined. AutoConnectCredential \u00b6 Include header \u00b6 #include <AutoConnectCredential.h> Constructors \u00b6 AutoConnectCredential(); AutoConnectCredential default constructor. The default offset value is 0. In ESP8266 or ESP32 with arduino core 1.0.2 earlier, if the offset value is 0, the credential area starts from the top of the EEPROM. If you use this area in a user sketch, AutoConnect may overwrite that data. AutoConnectCredential( uint16_t offset); Parameter offset Species offset from the top of the EEPROM for the credential area together. The offset value is from 0 to the flash sector size. This parameter is ignored for AutoConnect v1.0.0 or later with arduino-esp32 core 1.0.3 or later. Public member functions \u00b6 entries \u00b6 uint8_t entries( void ) Returns number of entries as contained credentials. Return value Number of entries as contained credentials. load \u00b6 int8_t load( const char * ssid, struct station_config * config) Load a credential entry and store to config . Parameters ssid SSID to be loaded. config station_config Return value Save the specified SSID's credential entry to station_config pointed to by the parameter as config . -1 is returned if the SSID is not saved. load \u00b6 bool load( int8_t entry, struct station_config * config) Load a credential entry and store to config . Parameters entry Specifies the index number based 0 to be loaded. config station_config Return value Save the specified credential entry to station_config pointed to by the parameter as config . -1 is returned if specified number is not saved. save \u00b6 bool save( const struct station_config * config) Save a credential entry. Parameter config station_config to be saved. Return value true Successfully saved. false Failed to save. del \u00b6 bool del( const char * ssid) Delete a credential the specified SSID. Parameter ssid SSID to be deleted. Return value true Successfully deleted. false Failed to delete. Clear saved credentials There is no particular API for batch clearing of all credential data stored by AutoConnect. It is necessary to prepare a sketch function that combines several AutoConnectCredential APIs to erase all saved credentials. The following function is an implementation example, and you can use it to achieve batch clearing. void deleteAllCredentials ( void ) { AutoConnectCredential credential; struct station_config config; uint8_t ent = credential.entries(); while (ent -- ) { credential.load( 0 , & config); credential.del(( const char * ) & config.ssid[ 0 ]); } } The data structures \u00b6 station_config \u00b6 A structure is included in the ESP8266 SDK. You can use it in the sketch like as follows: extern \"C\" { #include <user_interface.h> } struct station_config { uint8 ssid[ 32 ]; uint8 password[ 64 ]; uint8 bssid_set; uint8 bssid[ 6 ]; }; The credential entry \u00b6 A data structure of the credential saving area in EEPROM as the below. 4 Byte offset Length Value 0 8 AC_CREDT 8 1 Number of contained entries (uint8_t) 9 2 Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). 11 variable SSID terminated by 0x00. Max length is 32 bytes. variable variable Password plain text terminated by 0x00. Max length is 64 bytes. variable 6 BSSID variable Contained the next entries. (Continuation SSID+Password+BSSID) variable 1 0x00. End of container. An example using AutoConnectCredential is provided as an example of a library sketch to delete saved credentials. \u21a9 The namespace for Preferences used by AutoConnect is AC_CREDT . \u21a9 Available only for AutoConnect v1.0.0 and later. \u21a9 There may be 0xff as an invalid data in the credential saving area. The 0xff area would be reused. \u21a9","title":"Saved credentials access"},{"location":"credit.html#saved-credentials-in-the-flash","text":"AutoConnect stores the established WiFi connection in the flash memory of the ESP8266/ESP32 module and equips the class to access the credentials from the sketch. You can read, write or erase the credentials using this class individually. It's AutoConnectCredential class which provides the access method to the saved credentials in the flash. 1","title":"Saved credentials in the flash"},{"location":"credit.html#credentials-storage-location","text":"The location where AutoConnect saves credentials depends on the module type and the AutoConnect library version, also arduino-esp32 core version. In either case, the location is flash memory, but EEPROM and Preferences (in the nvs 2 ) are used depending on the library versions. AutoConnect Arduino core for ESP8266 Arduino core for ESP32 1.0.2 earlier 1.0.3 later v0.9.12 earlier EEPROM EEPROM (partition) Not supported v1.0.0 later Preferences (nvs) (Can be used EEPROM with turning off AUTOCONNECT_USE_PREFERENCES macro) Preferences (nvs) However, sketches do not need to know where to store credentials using the commonly accessible AutoConnectCredential API. If you are using an Arduino core for ESP32 1.0.2 earlier and need to use credentials in EEPROM for backward compatibility, turns off the AUTOCONNECT_USE_PREFERENCES 3 macro definition in AutoConnectCredentials.h file. AutoConnect behaves assuming that credentials are stored in EEPROM if AUTOCONNECT_USE_PREFERENCES is not defined.","title":"Credentials storage location"},{"location":"credit.html#autoconnectcredential","text":"","title":"AutoConnectCredential"},{"location":"credit.html#include-header","text":"#include <AutoConnectCredential.h>","title":" Include header"},{"location":"credit.html#constructors","text":"AutoConnectCredential(); AutoConnectCredential default constructor. The default offset value is 0. In ESP8266 or ESP32 with arduino core 1.0.2 earlier, if the offset value is 0, the credential area starts from the top of the EEPROM. If you use this area in a user sketch, AutoConnect may overwrite that data. AutoConnectCredential( uint16_t offset); Parameter offset Species offset from the top of the EEPROM for the credential area together. The offset value is from 0 to the flash sector size. This parameter is ignored for AutoConnect v1.0.0 or later with arduino-esp32 core 1.0.3 or later.","title":" Constructors"},{"location":"credit.html#public-member-functions","text":"","title":" Public member functions"},{"location":"credit.html#entries","text":"uint8_t entries( void ) Returns number of entries as contained credentials. Return value Number of entries as contained credentials.","title":" entries"},{"location":"credit.html#load","text":"int8_t load( const char * ssid, struct station_config * config) Load a credential entry and store to config . Parameters ssid SSID to be loaded. config station_config Return value Save the specified SSID's credential entry to station_config pointed to by the parameter as config . -1 is returned if the SSID is not saved.","title":" load"},{"location":"credit.html#load_1","text":"bool load( int8_t entry, struct station_config * config) Load a credential entry and store to config . Parameters entry Specifies the index number based 0 to be loaded. config station_config Return value Save the specified credential entry to station_config pointed to by the parameter as config . -1 is returned if specified number is not saved.","title":" load"},{"location":"credit.html#save","text":"bool save( const struct station_config * config) Save a credential entry. Parameter config station_config to be saved. Return value true Successfully saved. false Failed to save.","title":" save"},{"location":"credit.html#del","text":"bool del( const char * ssid) Delete a credential the specified SSID. Parameter ssid SSID to be deleted. Return value true Successfully deleted. false Failed to delete. Clear saved credentials There is no particular API for batch clearing of all credential data stored by AutoConnect. It is necessary to prepare a sketch function that combines several AutoConnectCredential APIs to erase all saved credentials. The following function is an implementation example, and you can use it to achieve batch clearing. void deleteAllCredentials ( void ) { AutoConnectCredential credential; struct station_config config; uint8_t ent = credential.entries(); while (ent -- ) { credential.load( 0 , & config); credential.del(( const char * ) & config.ssid[ 0 ]); } }","title":" del"},{"location":"credit.html#the-data-structures","text":"","title":"The data structures"},{"location":"credit.html#station_config","text":"A structure is included in the ESP8266 SDK. You can use it in the sketch like as follows: extern \"C\" { #include <user_interface.h> } struct station_config { uint8 ssid[ 32 ]; uint8 password[ 64 ]; uint8 bssid_set; uint8 bssid[ 6 ]; };","title":"  station_config"},{"location":"credit.html#the-credential-entry","text":"A data structure of the credential saving area in EEPROM as the below. 4 Byte offset Length Value 0 8 AC_CREDT 8 1 Number of contained entries (uint8_t) 9 2 Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). 11 variable SSID terminated by 0x00. Max length is 32 bytes. variable variable Password plain text terminated by 0x00. Max length is 64 bytes. variable 6 BSSID variable Contained the next entries. (Continuation SSID+Password+BSSID) variable 1 0x00. End of container. An example using AutoConnectCredential is provided as an example of a library sketch to delete saved credentials. \u21a9 The namespace for Preferences used by AutoConnect is AC_CREDT . \u21a9 Available only for AutoConnect v1.0.0 and later. \u21a9 There may be 0xff as an invalid data in the credential saving area. The 0xff area would be reused. \u21a9","title":"  The credential entry"},{"location":"datatips.html","text":"Convert AutoConnectElements value to actual data type \u00b6 The values in the AutoConnectElements field of the custom Web page are all typed as String. A sketch needs to be converted to an actual data type if the data type required for sketch processing is not a String type. The AutoConnect library does not provide the data conversion utility, and its function depends on Arduino language functions or functions of the type class. However, commonly used data conversion methods are generally similar. Here, represent examples the typical method for the data type conversion for the AutoConnectElements value of custom Web pages. Integer \u00b6 Use int() or toInt() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); int value = input.value.toInt(); You can shorten it and write as like: int value = aux[ \"INPUT\" ].value.toInt(); Float \u00b6 Use float() or toFloat() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); float value = input.value.toFloat(); You can shorten it and write as like: float value = aux[ \"INPUT\" ].value.toFloat(); Date & Time \u00b6 The easiest way is to use the Arduino Time Library . Sketches must accommodate differences in date and time formats depending on the time zone. You can absorb the difference in DateTime format by using sscanf function. 1 #include <TimeLib.h> time_t tm; int Year, Month, Day, Hour, Minute, Second; AutoConnectInput & input = aux.[ \"INPUT\" ].as < AutoConnectInput > (); sscanf(input.value.c_str(), \"%d-%d-%d %d:%d:%d\" , & Year, & Month, & Day, & Hour, & Minute, & Second); tm.Year = CalendarYrToTm(Year); tm.Month = Month; tm.Day = Day; tm.Hour = Hour; tm.Minute = Minute; tm.Second = Second; IP address \u00b6 To convert a String to an IP address, use IPAddress::fromString . To stringize an instance of an IP address, use IPAddress::toString . IPAddress ip; AutoConnectInput & input aux[ \"INPUT\" ].as < AutoConnectInput > (); ip.fromString(input.value); input.value = ip.toString(); Validation for the value \u00b6 To convert input data correctly from the string, it must match its format. The validation implementation with sketches depends on various perspectives. Usually, the tiny devices have no enough power for the lexical analysis completely. But you can reduce the burden for data verification using the pattern of AutoConnectInput. By giving a pattern to AutoConnectInput , you can find errors in data format while typing in custom Web pages. Specifying the input data rule as a regular expression will validate the type match during input. If there is an error in the format during input, the background color of the field will change to pink. Refer to section Handling the custom Web pages . However, input data will be transmitted even if the value does not match the pattern. Sketches require the validation of the received data. You can use the AutoConnectInput::isValid function to validate it. The isValid function validates whether the value member variable matches a pattern and returns true or false. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char input_page[] PROGMEM = R\"raw( [ { \"title\": \"IP Address\", \"uri\": \"/\", \"menu\": true, \"element\": [ { \"name\": \"ipaddress\", \"type\": \"ACInput\", \"label\": \"IP Address\", \"pattern\": \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"SEND\", \"uri\": \"/check\" } ] }, { \"title\": \"IP Address\", \"uri\": \"/check\", \"menu\": false, \"element\": [ { \"name\": \"result\", \"type\": \"ACText\" } ] } ] )raw\" ; AutoConnect portal; String checkIPAddress (AutoConnectAux & aux, PageArgument & args) { AutoConnectAux & input_page = * portal.aux( \"/\" ); AutoConnectInput & ipaddress = input_page[ \"ipaddress\" ].as < AutoConnectInput > (); AutoConnectText & result = aux[ \"result\" ].as < AutoConnectText > (); if (ipaddress.isValid()) { result.value = \"IP Address \" + ipaddress.value + \" is OK.\" ; result.style = \"\" ; } else { result.value = \"IP Address \" + ipaddress.value + \" error.\" ; result.style = \"color:red;\" ; } return String( \"\" ); } void setup () { portal.load(input_page); portal.on( \"/check\" , checkIPAddress); portal.begin(); } void loop () { portal.handleClient(); } Regular Expressions for JavaScript Regular expressions specified in the AutoConnectInput pattern conforms to the JavaScript specification . Here, represent examples the typical regular expression for the input validation. URL \u00b6 ^\\w+([-+.]\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$ DNS hostname \u00b6 ^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$ email address 2 \u00b6 ^[a-zA-Z0-9.!#$%&'*+\\/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*$ IP Address \u00b6 ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ Date as MM/DD/YYYY 3 \u00b6 ^(0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d$ Contain with backquote If that regular expression contains a backquote it must be escaped by backquote duplication. The ssanf library function cannot be used with the old Arduino core. \u21a9 This regular expression does not fully support the format of the e-mail address requested in RFC5322 . \u21a9 This regular expression does not consider semantic constraints. It is not possible to detect errors that do not exist as actual dates. \u21a9","title":"Tips for data conversion"},{"location":"datatips.html#convert-autoconnectelements-value-to-actual-data-type","text":"The values in the AutoConnectElements field of the custom Web page are all typed as String. A sketch needs to be converted to an actual data type if the data type required for sketch processing is not a String type. The AutoConnect library does not provide the data conversion utility, and its function depends on Arduino language functions or functions of the type class. However, commonly used data conversion methods are generally similar. Here, represent examples the typical method for the data type conversion for the AutoConnectElements value of custom Web pages.","title":"Convert AutoConnectElements value to actual data type"},{"location":"datatips.html#integer","text":"Use int() or toInt() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); int value = input.value.toInt(); You can shorten it and write as like: int value = aux[ \"INPUT\" ].value.toInt();","title":" Integer"},{"location":"datatips.html#float","text":"Use float() or toFloat() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); float value = input.value.toFloat(); You can shorten it and write as like: float value = aux[ \"INPUT\" ].value.toFloat();","title":" Float"},{"location":"datatips.html#date-time","text":"The easiest way is to use the Arduino Time Library . Sketches must accommodate differences in date and time formats depending on the time zone. You can absorb the difference in DateTime format by using sscanf function. 1 #include <TimeLib.h> time_t tm; int Year, Month, Day, Hour, Minute, Second; AutoConnectInput & input = aux.[ \"INPUT\" ].as < AutoConnectInput > (); sscanf(input.value.c_str(), \"%d-%d-%d %d:%d:%d\" , & Year, & Month, & Day, & Hour, & Minute, & Second); tm.Year = CalendarYrToTm(Year); tm.Month = Month; tm.Day = Day; tm.Hour = Hour; tm.Minute = Minute; tm.Second = Second;","title":" Date &amp; Time"},{"location":"datatips.html#ip-address","text":"To convert a String to an IP address, use IPAddress::fromString . To stringize an instance of an IP address, use IPAddress::toString . IPAddress ip; AutoConnectInput & input aux[ \"INPUT\" ].as < AutoConnectInput > (); ip.fromString(input.value); input.value = ip.toString();","title":" IP address"},{"location":"datatips.html#validation-for-the-value","text":"To convert input data correctly from the string, it must match its format. The validation implementation with sketches depends on various perspectives. Usually, the tiny devices have no enough power for the lexical analysis completely. But you can reduce the burden for data verification using the pattern of AutoConnectInput. By giving a pattern to AutoConnectInput , you can find errors in data format while typing in custom Web pages. Specifying the input data rule as a regular expression will validate the type match during input. If there is an error in the format during input, the background color of the field will change to pink. Refer to section Handling the custom Web pages . However, input data will be transmitted even if the value does not match the pattern. Sketches require the validation of the received data. You can use the AutoConnectInput::isValid function to validate it. The isValid function validates whether the value member variable matches a pattern and returns true or false. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char input_page[] PROGMEM = R\"raw( [ { \"title\": \"IP Address\", \"uri\": \"/\", \"menu\": true, \"element\": [ { \"name\": \"ipaddress\", \"type\": \"ACInput\", \"label\": \"IP Address\", \"pattern\": \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"SEND\", \"uri\": \"/check\" } ] }, { \"title\": \"IP Address\", \"uri\": \"/check\", \"menu\": false, \"element\": [ { \"name\": \"result\", \"type\": \"ACText\" } ] } ] )raw\" ; AutoConnect portal; String checkIPAddress (AutoConnectAux & aux, PageArgument & args) { AutoConnectAux & input_page = * portal.aux( \"/\" ); AutoConnectInput & ipaddress = input_page[ \"ipaddress\" ].as < AutoConnectInput > (); AutoConnectText & result = aux[ \"result\" ].as < AutoConnectText > (); if (ipaddress.isValid()) { result.value = \"IP Address \" + ipaddress.value + \" is OK.\" ; result.style = \"\" ; } else { result.value = \"IP Address \" + ipaddress.value + \" error.\" ; result.style = \"color:red;\" ; } return String( \"\" ); } void setup () { portal.load(input_page); portal.on( \"/check\" , checkIPAddress); portal.begin(); } void loop () { portal.handleClient(); } Regular Expressions for JavaScript Regular expressions specified in the AutoConnectInput pattern conforms to the JavaScript specification . Here, represent examples the typical regular expression for the input validation.","title":"Validation for the value"},{"location":"datatips.html#url","text":"^\\w+([-+.]\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$","title":" URL"},{"location":"datatips.html#dns-hostname","text":"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$","title":" DNS hostname"},{"location":"datatips.html#email-address-2","text":"^[a-zA-Z0-9.!#$%&'*+\\/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*$","title":" email address 2"},{"location":"datatips.html#ip-address_1","text":"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$","title":" IP Address"},{"location":"datatips.html#date-as-mmddyyyy-3","text":"^(0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d$ Contain with backquote If that regular expression contains a backquote it must be escaped by backquote duplication. The ssanf library function cannot be used with the old Arduino core. \u21a9 This regular expression does not fully support the format of the e-mail address requested in RFC5322 . \u21a9 This regular expression does not consider semantic constraints. It is not possible to detect errors that do not exist as actual dates. \u21a9","title":" Date as MM/DD/YYYY 3"},{"location":"faq.html","text":"After connected, AutoConnect menu performs but no happens. \u00b6 If you can access the AutoConnect root path as http://ESP8266IPADDRESS/_ac from browser, probably the sketch uses ESP8266WebServer::handleClient() without AutoConnect::handleRequest() . For AutoConnect menus to work properly, call AutoConnect::handleRequest() after ESP8266WebServer::handleClient() invoked, or use AutoConnect::handleClient() . AutoConnect::handleClient() is equivalent ESP8266WebServer::handleClient combined AutoConnect::handleRequest() . See also the explanation here . After updating to AutoConnect v1.0.0, established APs disappear from Open SSIDs with ESP32. \u00b6 Since AutoConnect v1.0.0 for ESP32, the storage location in the flash of established credentials has moved from EEPROM to Preferences. After You update AutoConnect to v1.0.0, past credentials saved by v0.9.12 earlier will not be accessible from the AutoConnect menu - Open SSIDs . You need to transfer once the stored credentials from the EEPROM area to the Preferences area. You can migrate the past saved credentials using CreditMigrate.ino which the examples folder contains. Needs to Arduino core for ESP32 1.0.2 or earlier EEPROM area with arduino-esp32 core 1.0.3 has moved from partition to the nvs . CreditMigrate.ino requires arduino-esp32 core 1.0.2 or earlier to migrate saved credentials. An esp8266ap as SoftAP was connected but Captive portal does not start. \u00b6 Captive portal detection could not be trapped. It is necessary to disconnect and reset ESP8266 to clear memorized connection data in ESP8266. Also, It may be displayed on the smartphone if the connection information of esp8266ap is wrong. In that case, delete the connection information of esp8266ap memorized by the smartphone once. Compile error that 'EEPROM' was not declared in this scope \u00b6 If the user sketch includes the header file as EEPROM.h , this compilation error may occur depending on the order of the #include directives. AutoConnectCredentials.h including in succession linked from AutoConnect.h defines NO_GLOBAL_EEPROM internally, so if your sketch includes EEPROM.h after AutoConnect.h , the EEPROM global variable will be lost. If you use EEPROM with your sketch, declare #include <EEPROM.h> in front of #include <AutoConnect.h> . Compile error that 'ESPhttpUpdate' was not declared in this scope \u00b6 If the user sketch includes the header file as ESP8266httpUpdate.h , this compilation error may occur depending on the order of the #include directives. AutoConnectUpdate.h including in succession linked from AutoConnect.h defines NO_GLOBAL_HTTPUPDATE internally, so if your sketch includes ESP8266httpUpdate.h after AutoConnect.h , the ESPhttpUpdate global variable will be lost. You can avoid a compile error in one of two ways: Disable an AutoConnectUpdate feature if you don't need. You can disable the AutoConnectUpdate feature by commenting out the AUTOCONNECT_USE_UPDATE macro in the AutoConnectDefs.h header file. #define AUTOCONNECT_USE_UPDATE Change the order of #include directives. With the sketch, #include <ESP8266httpUpdate.h> before #include <AutoConnect.h> . Connection lost immediately after establishment with AP \u00b6 A captive portal is disconnected immediately after the connection establishes with the new AP. This is a known problem of ESP32, and it may occur when the following conditions are satisfied at the same time. SoftAP channel on ESP32 and the connecting AP channel you specified are different. (The default channel of SoftAP is 1.) NVS had erased by erase_flash causes the connection data lost. The NVS partition has been moved. Never connected to the AP in the past. There are receivable multiple WiFi signals which are the same SSID with different channels using the WiFi repeater etc. (This condition is loose, it may occur even if there is no WiFi repeater.) Or the using channel of the AP which established a connection is congested with the radio signal on the same band. (If the channel crowd, connections to known APs may also fail.) Other possibilities The above conditions are not absolute. It results from my investigation, and other conditions may exist. To avoid this problem, try changing the channel . ESP32 hardware equips only one RF circuitry for WiFi signal. At the AP_STA mode, ESP32 as an AP attempts connect to another AP on another channel while keeping the connection with the station then the channel switching will occur causes the station may be disconnected. But it may not be just a matter of channel switching causes ESP8266 has the same constraints too. It may be a problem with AutoConnect or the arduino core or SDK issue. This problem will persist until a specific solution. Data saved to EEPROM is different from my sketch wrote. \u00b6 By default, AutoConnect saves the credentials of the established connection into EEPROM. The credential area of EEPROM used by AutoConnect will conflict with data owned by the user sketch if without measures taken. It will destroy the user sketch data and the data stored in EEPROM by AutoConnect with each other. You have the following two options to avoid this conflict: Move the credential saving area of EEPROM. You can protect your data from corruption by notifying AutoConnect where to save credentials. Notification of the save location for the credentials uses AutoConnectConfig::boundaryOffset option. Refer to the chapter on Advanced usage for details. Suppresses the automatic save operation of credentials by AutoConnect. You can completely stop saving the credentials by AutoConnect. However, if you select this option, you lose the past credentials which were able to connect to the AP. Therefore, the effect of the automatic reconnection feature will be lost. If you want to stop the automatic saving of the credentials, uses AutoConnectConfig::autoSave option specifying AC_SAVECREDENTIAL_NEVER . Refer to the chapter on Advanced usage for details. Does not appear esp8266ap in smartphone. \u00b6 Maybe it is successfully connected at the first WiFi.begin . ESP8266 remembers the last SSID successfully connected and will use at the next. It means SoftAP will only start up when the first WiFi.begin() fails. The saved SSID would be cleared by WiFi.disconnect() with WIFI_STA mode. If you do not want automatic reconnection, you can erase the memorized SSID with the following simple sketch. #include <ESP8266WiFi.h> void setup () { delay( 1000 ); Serial.begin( 115200 ); WiFi.mode(WIFI_STA); delay( 100 ); WiFi.begin(); if (WiFi.waitForConnectResult() == WL_CONNECTED) { WiFi.disconnect(); while (WiFi.status() == WL_CONNECTED) delay( 100 ); } Serial.println( \"WiFi disconnected.\" ); } void loop () { delay( 1000 ); } You can interactively check the WiFi state of ESP8266. Please try ESPShaker . It is ESP8266 interactive serial command processor. Does not response from /_ac. \u00b6 Probably WiFi.begin failed with the specified SSID. Activating the debug printing will help you to track down the cause. Hang up after Reset? \u00b6 If ESP8266 hang up after reset by AutoConnect menu, perhaps manual reset is not yet. Especially if it is not manual reset yet after uploading the sketch, the boot mode will stay 'Uart Download'. There is some discussion about this on the Github's ESP8266 core: https://github.com/esp8266/Arduino/issues/1017 1 If you received the following message, the boot mode is still sketch uploaded. It needs to the manual reset once. ets Jan 8 2013,rst cause:2, boot mode:(1,6) or (1,7) ets Jan 8 2013,rst cause:4, boot mode:(1,6) or (1,7) wdt reset The correct boot mode for starting the sketch is (3, x) . ESP8266 Boot Messages It is described by ESP8266 Non-OS SDK API Reference , section A.5. Messages Description rst cause 1: power on 2: external reset 4: hardware watchdog reset boot mode (the first parameter) 1: ESP8266 is in UART-down mode (and downloads firmware into flash). 3: ESP8266 is in Flash-boot mode (and boots up from flash). How can I detect the captive portal starting? \u00b6 You can use the AutoConnect::onDetect exit routine. For more details and an implementation example of the onDetect exit routine, refer to the chapter \" Captive portal start detection \". How change HTTP port? \u00b6 HTTP port number is defined as a macro in AutoConnectDefs.h header file. You can change it directly with several editors and must re-compile. #define AUTOCONNECT_HTTPPORT 80 How change SSID or Password in Captive portal? \u00b6 You can change both by using AutoConnectConfig::apid and AutoConnectConfig::psk . Refer to section Change SSID and Password for SoftAP in Advanced usage . How erase the credentials saved in EEPROM? \u00b6 Make some sketches for erasing the EEPROM area, or some erasing utility is needed. You can prepare the sketch to erase the saved credential with AutoConnectCredential . The AutoConnectCrendential class provides the access method to the saved credential in EEPROM and library source file is including it. Refer to ' Saved credential access ' on section Appendix for details. Hint With the ESPShaker , you can access EEPROM interactively from the serial monitor, and of course you can erase saved credentials. How locate the link button to the AutoConnect menu? \u00b6 Link button to AutoConnect menu can be embedded into Sketch's web page. The root path of the menu is /_ac by default and embed the following <a></a> tag in the generating HTML. < a style = \"background-color:SteelBlue; display:inline-block; padding:7px 13px; text-decoration:none;\" href = \"/_ac\" > MENU </ a > How much memory does AutoConnect consume? \u00b6 Sketch size \u00b6 It increases about 53K bytes compared to the case without AutoConnect. A sketch size of the most simple example introduced in the Getting started is about 330K bytes. (270K byte without AutoConnect) Heap size \u00b6 It consumes about 2K bytes in the static and about 12K bytes are consumed at the moment when menu executed. I cannot complete to Wi-Fi login from smartphone. \u00b6 Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu. I cannot see the custom Web page. \u00b6 If the sketch is correct, a JSON syntax error may have occurred. In this case, activate the AC_DEBUG and rerun. If you take the message of JSON syntax error, the Json Assistant helps syntax checking. This online tool is provided by the author of ArduinoJson and is most consistent for the AutoConnect. Submit element in a custom Web page does not react. \u00b6 Is there the AutoConnectElements element named SUBMIT in the custom Web page? (case sensitive ignored) AutoConnect does not rely on the input type=submit element for the form submission and uses HTML form element submit function instead. So, the submit function will fail if there is an element named 'submit' in the form. You can not use SUBMIT as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element. Still, not stable with my sketch. \u00b6 If AutoConnect behavior is not stable with your sketch, you can try the following measures. 1. Change WiFi channel \u00b6 Both ESP8266 and ESP32 can only work on one channel at any given moment. This will cause your station to lose connectivity on the channel hosting the captive portal. If the channel of the AP which you want to connect is different from the SoftAP channel, the operation of the captive portal will not respond with the screen of the AutoConnect connection attempt remains displayed. In such a case, please try to configure the channel with AutoConnectConfig to match the access point. AutoConnect portal; AutoConnectConfig config; config.channel = 3 ; // Specifies a channel number that matches the AP portal.config(config); // Apply channel configurration portal.begin(); // Start the portal Channel selection guide Espressif Systems has released a channel selection guide . 2. Change the arduino core version \u00b6 I recommend change installed an arduino core version to the upstream when your sketch is not stable with AutoConnect on each board. with ESP8266 arduino core \u00b6 You can select the lwIP variant to contribute for the stable behavior. The lwIP v2 Lower memory option of Arduino IDE for core version 2.4.2 is based on the lwIP-v2. On the other hand, the core version 2.5.0 upstream is based on the lwIP-2.1.2 stable release. You can select the option from Arduino IDE as Tool menu, if you are using ESP8266 core 2.5.0. It can be select lwIP v2 Lower Memory option. (not lwIP v2 Lower Memory (no features) ) It is expected to improve response performance and stability. with ESP32 arduino core \u00b6 The arduino-esp32 is still under development. It is necessary to judge whether the problem cause of the core or AutoConnect. Trace the log with the esp32 core and the AutoConnect debug option enabled for problem diagnosis and please you check the issue of arduino-esp32 . The problem that your sketch possesses may already have been solved. 3. Turn on the debug log options \u00b6 To fully enable for the AutoConnect debug logging options, change the following two files. AutoConnectDefs.h #define AC_DEBUG PageBuilder.h 2 #define PB_DEBUG 4. Reports the issue to AutoConnect Github repository \u00b6 If you can not solve AutoConnect problems please report to Issues . And please make your question comprehensively, not a statement. Include all relevant information to start the problem diagnostics as follows: 3 Hardware module Arduino core version Including the upstream commit ID if necessary Operating System which you use Your smartphone OS and version (Especially for Android) Your AP information (IP, channel) if related lwIP variant Problem description If you have a STACK DUMP decoded result with formatted by the code block tag The sketch code with formatted by the code block tag (Reduce to the reproducible minimum code for the problem) Debug messages output (Including arduino core) I will make efforts to solve as quickly as possible. But I would like you to know that it is not always possible. Thank you. This issue has been resolved in ESP8266 core 2.5.0 and later. \u21a9 PageBuilder.h exists in the libraries/PageBuilder/src directory under your sketch folder. \u21a9 Without this information, the reproducibility of the problem is reduced, making diagnosis and analysis difficult. \u21a9","title":"FAQ"},{"location":"faq.html#after-connected-autoconnect-menu-performs-but-no-happens","text":"If you can access the AutoConnect root path as http://ESP8266IPADDRESS/_ac from browser, probably the sketch uses ESP8266WebServer::handleClient() without AutoConnect::handleRequest() . For AutoConnect menus to work properly, call AutoConnect::handleRequest() after ESP8266WebServer::handleClient() invoked, or use AutoConnect::handleClient() . AutoConnect::handleClient() is equivalent ESP8266WebServer::handleClient combined AutoConnect::handleRequest() . See also the explanation here .","title":" After connected, AutoConnect menu performs but no happens."},{"location":"faq.html#after-updating-to-autoconnect-v100-established-aps-disappear-from-open-ssids-with-esp32","text":"Since AutoConnect v1.0.0 for ESP32, the storage location in the flash of established credentials has moved from EEPROM to Preferences. After You update AutoConnect to v1.0.0, past credentials saved by v0.9.12 earlier will not be accessible from the AutoConnect menu - Open SSIDs . You need to transfer once the stored credentials from the EEPROM area to the Preferences area. You can migrate the past saved credentials using CreditMigrate.ino which the examples folder contains. Needs to Arduino core for ESP32 1.0.2 or earlier EEPROM area with arduino-esp32 core 1.0.3 has moved from partition to the nvs . CreditMigrate.ino requires arduino-esp32 core 1.0.2 or earlier to migrate saved credentials.","title":" After updating to AutoConnect v1.0.0, established APs disappear from Open SSIDs with ESP32."},{"location":"faq.html#an-esp8266ap-as-softap-was-connected-but-captive-portal-does-not-start","text":"Captive portal detection could not be trapped. It is necessary to disconnect and reset ESP8266 to clear memorized connection data in ESP8266. Also, It may be displayed on the smartphone if the connection information of esp8266ap is wrong. In that case, delete the connection information of esp8266ap memorized by the smartphone once.","title":" An esp8266ap as SoftAP was connected but Captive portal does not start."},{"location":"faq.html#compile-error-that-eeprom-was-not-declared-in-this-scope","text":"If the user sketch includes the header file as EEPROM.h , this compilation error may occur depending on the order of the #include directives. AutoConnectCredentials.h including in succession linked from AutoConnect.h defines NO_GLOBAL_EEPROM internally, so if your sketch includes EEPROM.h after AutoConnect.h , the EEPROM global variable will be lost. If you use EEPROM with your sketch, declare #include <EEPROM.h> in front of #include <AutoConnect.h> .","title":" Compile error that 'EEPROM' was not declared in this scope"},{"location":"faq.html#compile-error-that-esphttpupdate-was-not-declared-in-this-scope","text":"If the user sketch includes the header file as ESP8266httpUpdate.h , this compilation error may occur depending on the order of the #include directives. AutoConnectUpdate.h including in succession linked from AutoConnect.h defines NO_GLOBAL_HTTPUPDATE internally, so if your sketch includes ESP8266httpUpdate.h after AutoConnect.h , the ESPhttpUpdate global variable will be lost. You can avoid a compile error in one of two ways: Disable an AutoConnectUpdate feature if you don't need. You can disable the AutoConnectUpdate feature by commenting out the AUTOCONNECT_USE_UPDATE macro in the AutoConnectDefs.h header file. #define AUTOCONNECT_USE_UPDATE Change the order of #include directives. With the sketch, #include <ESP8266httpUpdate.h> before #include <AutoConnect.h> .","title":" Compile error that 'ESPhttpUpdate' was not declared in this scope"},{"location":"faq.html#connection-lost-immediately-after-establishment-with-ap","text":"A captive portal is disconnected immediately after the connection establishes with the new AP. This is a known problem of ESP32, and it may occur when the following conditions are satisfied at the same time. SoftAP channel on ESP32 and the connecting AP channel you specified are different. (The default channel of SoftAP is 1.) NVS had erased by erase_flash causes the connection data lost. The NVS partition has been moved. Never connected to the AP in the past. There are receivable multiple WiFi signals which are the same SSID with different channels using the WiFi repeater etc. (This condition is loose, it may occur even if there is no WiFi repeater.) Or the using channel of the AP which established a connection is congested with the radio signal on the same band. (If the channel crowd, connections to known APs may also fail.) Other possibilities The above conditions are not absolute. It results from my investigation, and other conditions may exist. To avoid this problem, try changing the channel . ESP32 hardware equips only one RF circuitry for WiFi signal. At the AP_STA mode, ESP32 as an AP attempts connect to another AP on another channel while keeping the connection with the station then the channel switching will occur causes the station may be disconnected. But it may not be just a matter of channel switching causes ESP8266 has the same constraints too. It may be a problem with AutoConnect or the arduino core or SDK issue. This problem will persist until a specific solution.","title":" Connection lost immediately after establishment with AP"},{"location":"faq.html#data-saved-to-eeprom-is-different-from-my-sketch-wrote","text":"By default, AutoConnect saves the credentials of the established connection into EEPROM. The credential area of EEPROM used by AutoConnect will conflict with data owned by the user sketch if without measures taken. It will destroy the user sketch data and the data stored in EEPROM by AutoConnect with each other. You have the following two options to avoid this conflict: Move the credential saving area of EEPROM. You can protect your data from corruption by notifying AutoConnect where to save credentials. Notification of the save location for the credentials uses AutoConnectConfig::boundaryOffset option. Refer to the chapter on Advanced usage for details. Suppresses the automatic save operation of credentials by AutoConnect. You can completely stop saving the credentials by AutoConnect. However, if you select this option, you lose the past credentials which were able to connect to the AP. Therefore, the effect of the automatic reconnection feature will be lost. If you want to stop the automatic saving of the credentials, uses AutoConnectConfig::autoSave option specifying AC_SAVECREDENTIAL_NEVER . Refer to the chapter on Advanced usage for details.","title":" Data saved to EEPROM is different from my sketch wrote."},{"location":"faq.html#does-not-appear-esp8266ap-in-smartphone","text":"Maybe it is successfully connected at the first WiFi.begin . ESP8266 remembers the last SSID successfully connected and will use at the next. It means SoftAP will only start up when the first WiFi.begin() fails. The saved SSID would be cleared by WiFi.disconnect() with WIFI_STA mode. If you do not want automatic reconnection, you can erase the memorized SSID with the following simple sketch. #include <ESP8266WiFi.h> void setup () { delay( 1000 ); Serial.begin( 115200 ); WiFi.mode(WIFI_STA); delay( 100 ); WiFi.begin(); if (WiFi.waitForConnectResult() == WL_CONNECTED) { WiFi.disconnect(); while (WiFi.status() == WL_CONNECTED) delay( 100 ); } Serial.println( \"WiFi disconnected.\" ); } void loop () { delay( 1000 ); } You can interactively check the WiFi state of ESP8266. Please try ESPShaker . It is ESP8266 interactive serial command processor.","title":" Does not appear esp8266ap in smartphone."},{"location":"faq.html#does-not-response-from-95ac","text":"Probably WiFi.begin failed with the specified SSID. Activating the debug printing will help you to track down the cause.","title":" Does not response from /_ac."},{"location":"faq.html#hang-up-after-reset","text":"If ESP8266 hang up after reset by AutoConnect menu, perhaps manual reset is not yet. Especially if it is not manual reset yet after uploading the sketch, the boot mode will stay 'Uart Download'. There is some discussion about this on the Github's ESP8266 core: https://github.com/esp8266/Arduino/issues/1017 1 If you received the following message, the boot mode is still sketch uploaded. It needs to the manual reset once. ets Jan 8 2013,rst cause:2, boot mode:(1,6) or (1,7) ets Jan 8 2013,rst cause:4, boot mode:(1,6) or (1,7) wdt reset The correct boot mode for starting the sketch is (3, x) . ESP8266 Boot Messages It is described by ESP8266 Non-OS SDK API Reference , section A.5. Messages Description rst cause 1: power on 2: external reset 4: hardware watchdog reset boot mode (the first parameter) 1: ESP8266 is in UART-down mode (and downloads firmware into flash). 3: ESP8266 is in Flash-boot mode (and boots up from flash).","title":" Hang up after Reset?"},{"location":"faq.html#how-can-i-detect-the-captive-portal-starting","text":"You can use the AutoConnect::onDetect exit routine. For more details and an implementation example of the onDetect exit routine, refer to the chapter \" Captive portal start detection \".","title":" How can I detect the captive portal starting?"},{"location":"faq.html#how-change-http-port","text":"HTTP port number is defined as a macro in AutoConnectDefs.h header file. You can change it directly with several editors and must re-compile. #define AUTOCONNECT_HTTPPORT 80","title":" How change HTTP port?"},{"location":"faq.html#how-change-ssid-or-password-in-captive-portal","text":"You can change both by using AutoConnectConfig::apid and AutoConnectConfig::psk . Refer to section Change SSID and Password for SoftAP in Advanced usage .","title":" How change SSID or Password in Captive portal?"},{"location":"faq.html#how-erase-the-credentials-saved-in-eeprom","text":"Make some sketches for erasing the EEPROM area, or some erasing utility is needed. You can prepare the sketch to erase the saved credential with AutoConnectCredential . The AutoConnectCrendential class provides the access method to the saved credential in EEPROM and library source file is including it. Refer to ' Saved credential access ' on section Appendix for details. Hint With the ESPShaker , you can access EEPROM interactively from the serial monitor, and of course you can erase saved credentials.","title":" How erase the credentials saved in EEPROM?"},{"location":"faq.html#how-locate-the-link-button-to-the-autoconnect-menu","text":"Link button to AutoConnect menu can be embedded into Sketch's web page. The root path of the menu is /_ac by default and embed the following <a></a> tag in the generating HTML. < a style = \"background-color:SteelBlue; display:inline-block; padding:7px 13px; text-decoration:none;\" href = \"/_ac\" > MENU </ a >","title":" How locate the link button to the  AutoConnect menu?"},{"location":"faq.html#how-much-memory-does-autoconnect-consume","text":"","title":" How much memory does AutoConnect consume?"},{"location":"faq.html#sketch-size","text":"It increases about 53K bytes compared to the case without AutoConnect. A sketch size of the most simple example introduced in the Getting started is about 330K bytes. (270K byte without AutoConnect)","title":"Sketch size"},{"location":"faq.html#heap-size","text":"It consumes about 2K bytes in the static and about 12K bytes are consumed at the moment when menu executed.","title":"Heap size"},{"location":"faq.html#i-cannot-complete-to-wi-fi-login-from-smartphone","text":"Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu.","title":" I cannot complete to Wi-Fi login from smartphone."},{"location":"faq.html#i-cannot-see-the-custom-web-page","text":"If the sketch is correct, a JSON syntax error may have occurred. In this case, activate the AC_DEBUG and rerun. If you take the message of JSON syntax error, the Json Assistant helps syntax checking. This online tool is provided by the author of ArduinoJson and is most consistent for the AutoConnect.","title":" I cannot see the custom Web page."},{"location":"faq.html#submit-element-in-a-custom-web-page-does-not-react","text":"Is there the AutoConnectElements element named SUBMIT in the custom Web page? (case sensitive ignored) AutoConnect does not rely on the input type=submit element for the form submission and uses HTML form element submit function instead. So, the submit function will fail if there is an element named 'submit' in the form. You can not use SUBMIT as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element.","title":" Submit element in a custom Web page does not react."},{"location":"faq.html#still-not-stable-with-my-sketch","text":"If AutoConnect behavior is not stable with your sketch, you can try the following measures.","title":" Still, not stable with my sketch."},{"location":"faq.html#1-change-wifi-channel","text":"Both ESP8266 and ESP32 can only work on one channel at any given moment. This will cause your station to lose connectivity on the channel hosting the captive portal. If the channel of the AP which you want to connect is different from the SoftAP channel, the operation of the captive portal will not respond with the screen of the AutoConnect connection attempt remains displayed. In such a case, please try to configure the channel with AutoConnectConfig to match the access point. AutoConnect portal; AutoConnectConfig config; config.channel = 3 ; // Specifies a channel number that matches the AP portal.config(config); // Apply channel configurration portal.begin(); // Start the portal Channel selection guide Espressif Systems has released a channel selection guide .","title":"1. Change WiFi channel"},{"location":"faq.html#2-change-the-arduino-core-version","text":"I recommend change installed an arduino core version to the upstream when your sketch is not stable with AutoConnect on each board.","title":"2. Change the arduino core version"},{"location":"faq.html#with-esp8266-arduino-core","text":"You can select the lwIP variant to contribute for the stable behavior. The lwIP v2 Lower memory option of Arduino IDE for core version 2.4.2 is based on the lwIP-v2. On the other hand, the core version 2.5.0 upstream is based on the lwIP-2.1.2 stable release. You can select the option from Arduino IDE as Tool menu, if you are using ESP8266 core 2.5.0. It can be select lwIP v2 Lower Memory option. (not lwIP v2 Lower Memory (no features) ) It is expected to improve response performance and stability.","title":"with ESP8266 arduino core"},{"location":"faq.html#with-esp32-arduino-core","text":"The arduino-esp32 is still under development. It is necessary to judge whether the problem cause of the core or AutoConnect. Trace the log with the esp32 core and the AutoConnect debug option enabled for problem diagnosis and please you check the issue of arduino-esp32 . The problem that your sketch possesses may already have been solved.","title":"with ESP32 arduino core"},{"location":"faq.html#3-turn-on-the-debug-log-options","text":"To fully enable for the AutoConnect debug logging options, change the following two files. AutoConnectDefs.h #define AC_DEBUG PageBuilder.h 2 #define PB_DEBUG","title":"3. Turn on the debug log options"},{"location":"faq.html#4-reports-the-issue-to-autoconnect-github-repository","text":"If you can not solve AutoConnect problems please report to Issues . And please make your question comprehensively, not a statement. Include all relevant information to start the problem diagnostics as follows: 3 Hardware module Arduino core version Including the upstream commit ID if necessary Operating System which you use Your smartphone OS and version (Especially for Android) Your AP information (IP, channel) if related lwIP variant Problem description If you have a STACK DUMP decoded result with formatted by the code block tag The sketch code with formatted by the code block tag (Reduce to the reproducible minimum code for the problem) Debug messages output (Including arduino core) I will make efforts to solve as quickly as possible. But I would like you to know that it is not always possible. Thank you. This issue has been resolved in ESP8266 core 2.5.0 and later. \u21a9 PageBuilder.h exists in the libraries/PageBuilder/src directory under your sketch folder. \u21a9 Without this information, the reproducibility of the problem is reduced, making diagnosis and analysis difficult. \u21a9","title":"4. Reports the issue to AutoConnect Github repository"},{"location":"gettingstarted.html","text":"Let's do the most simple sketch \u00b6 Open the Arduino IDE, write the following sketch and upload it. The feature of this sketch is that the SSID and Password are not coded. #include <ESP8266WiFi.h> // Replace with WiFi.h for ESP32 #include <ESP8266WebServer.h> // Replace with WebServer.h for ESP32 #include <AutoConnect.h> ESP8266WebServer Server; // Replace with WebServer for ESP32 AutoConnect Portal (Server); void rootPage () { char content[] = \"Hello, world\" ; Server.send( 200 , \"text/plain\" , content); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); Server.on( \"/\" , rootPage); if (Portal.begin()) { Serial.println( \"WiFi connected: \" + WiFi.localIP().toString()); } } void loop () { Portal.handleClient(); } The above code can be applied to ESP8266. To apply to ESP32, replace ESP8266WebServer class with WebServer and include WiFi.h and WebServer.h of arduino-esp32 appropriately. Run at first \u00b6 After about 30 seconds, if the ESP8266 cannot connect to nearby Wi-Fi spot, you pull out your smartphone and open Wi-Fi settings from the Settings Apps. You can see the esp8266ap 1 in the list of \"CHOOSE A NETWORK...\" . Then tap the esp8266ap and enter password 12345678 , a something screen pops up automatically as shown below. This is the AutoConnect statistics screen. This screen displays the current status of the established connection, WiFi mode, IP address, free memory size, and etc. Also, the hamburger icon is the control menu of AutoConnect seems at the upper right. By tap the hamburger icon, the control menu appears as the below. Join to the new access point \u00b6 Here, tap \"Configure new AP\" to connect the new access point then the SSID configuration screen would be shown. Enter the SSID and Passphrase and tap apply to start connecting the access point. Connection establishment \u00b6 After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI_AP_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step. For one, continues execution of the sketch while keeping this connection. You can access ESP8266 via browser through the established IP address after cancel to \" Log in \" by upper right on the screen. Or, \" RESET \" can be selected. The ESP8266 resets and reboots. After that, immediately before the connection will be restored automatically with WIFI_STA mode. Run for usually \u00b6 The IP address of ESP8266 would be displayed on the serial monitor after connection restored. Please access its address from the browser. The \"Hello, world\" page will respond. It's the page that was handled by in the sketch with \" on \" function of ESP8266WebServer . window.onload = function() { Gifffer(); }; When applied to ESP32, SSID will appear as esp32ap . \u21a9","title":"Getting started"},{"location":"gettingstarted.html#lets-do-the-most-simple-sketch","text":"Open the Arduino IDE, write the following sketch and upload it. The feature of this sketch is that the SSID and Password are not coded. #include <ESP8266WiFi.h> // Replace with WiFi.h for ESP32 #include <ESP8266WebServer.h> // Replace with WebServer.h for ESP32 #include <AutoConnect.h> ESP8266WebServer Server; // Replace with WebServer for ESP32 AutoConnect Portal (Server); void rootPage () { char content[] = \"Hello, world\" ; Server.send( 200 , \"text/plain\" , content); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); Server.on( \"/\" , rootPage); if (Portal.begin()) { Serial.println( \"WiFi connected: \" + WiFi.localIP().toString()); } } void loop () { Portal.handleClient(); } The above code can be applied to ESP8266. To apply to ESP32, replace ESP8266WebServer class with WebServer and include WiFi.h and WebServer.h of arduino-esp32 appropriately.","title":"Let's do the most simple sketch"},{"location":"gettingstarted.html#run-at-first","text":"After about 30 seconds, if the ESP8266 cannot connect to nearby Wi-Fi spot, you pull out your smartphone and open Wi-Fi settings from the Settings Apps. You can see the esp8266ap 1 in the list of \"CHOOSE A NETWORK...\" . Then tap the esp8266ap and enter password 12345678 , a something screen pops up automatically as shown below. This is the AutoConnect statistics screen. This screen displays the current status of the established connection, WiFi mode, IP address, free memory size, and etc. Also, the hamburger icon is the control menu of AutoConnect seems at the upper right. By tap the hamburger icon, the control menu appears as the below.","title":" Run at first"},{"location":"gettingstarted.html#join-to-the-new-access-point","text":"Here, tap \"Configure new AP\" to connect the new access point then the SSID configuration screen would be shown. Enter the SSID and Passphrase and tap apply to start connecting the access point.","title":" Join to the new access point"},{"location":"gettingstarted.html#connection-establishment","text":"After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI_AP_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step. For one, continues execution of the sketch while keeping this connection. You can access ESP8266 via browser through the established IP address after cancel to \" Log in \" by upper right on the screen. Or, \" RESET \" can be selected. The ESP8266 resets and reboots. After that, immediately before the connection will be restored automatically with WIFI_STA mode.","title":" Connection establishment"},{"location":"gettingstarted.html#run-for-usually","text":"The IP address of ESP8266 would be displayed on the serial monitor after connection restored. Please access its address from the browser. The \"Hello, world\" page will respond. It's the page that was handled by in the sketch with \" on \" function of ESP8266WebServer . window.onload = function() { Gifffer(); }; When applied to ESP32, SSID will appear as esp32ap . \u21a9","title":" Run for usually"},{"location":"howtoembed.html","text":"Embed the AutoConnect to the sketch \u00b6 Here hold two case examples. Both examples perform the same function. Only how to incorporate the AutoConnect into the sketch differs. Also included in the sample folder, HandlePortal.ino also shows how to use the PageBuilder library for HTML assemblies. What does this example do? \u00b6 Uses the web interface to light the LED connected to the D0 (sometimes called BUILTIN_LED ) port of the NodeMCU module like the following animation. Access to the ESP8266 module connected WiFi from the browser then the page contains the current value of the D0 port would be displayed. The page has the buttons to switch the port value. The LED will blink according to the value with clicked by the button. This example is a typical sketch of manipulating ESP8266's GPIO via WLAN. Embed AutoConnect library into this sketch. There are few places to be changed. And you can use AutoConnect's captive portal function to establish a connection freely to other WiFi spots. Embed AutoConnect \u00b6 Pattern A. \u00b6 Bind to ESP8266WebServer, performs handleClient with handleRequest. In what situations should the handleRequest be used. It is something needs to be done immediately after the handle client. It is better to call only AutoConnect::handleClient whenever possible. Pattern B. \u00b6 Declare only AutoConnect, performs handleClient. Used with MQTT as a client application \u00b6 The effect of AutoConnect is not only for ESP8266/ESP32 as the web server. It has advantages for something WiFi client as well. For example, AutoConnect is also convenient for publishing MQTT messages from various measurement points. Even if the SSID is different for each measurement point, it is not necessary to modify the sketch. This example tries to publish the WiFi signal strength of ESP8266 with MQTT. It uses the ThingSpeak for MQTT broker. ESP8266 publishes the RSSI value to the channel created on ThingSpeak as MQTT client . This example is well suited to demonstrate the usefulness of AutoConnect, as RSSI values are measured at each access point usually. Just adding a few lines of code makes it unnecessary to upload sketches with the different SSIDs rewrite for each access point. Advance procedures \u00b6 Arduino Client for MQTT - It's the PubSubClient , install it to Arduino IDE. If you have the latest version already, this step does not need. Create a channel on ThingSpeak. Get the Channel API Keys from ThingSpeak, put its keys to the sketch. The ThingSpeak is the open IoT platform. It is capable of sending data privately to the cloud and analyzing, visualizing its data. If you do not have an account of ThingSpeak, you need that account to proceed further. ThingSpeak has the free plan for the account which uses within the scope of this example. 1 You can sign up with the ThingSpeak sign-up page . Whether you should do sign-up or not. You are entrusted with the final judgment of account creation for ThingSpeak. Create an account at your own risk. Create a channel on ThingSpeak \u00b6 Sign in ThingSpeak. Select Channels to show the My Channels , then click New Channel . At the New Channel screen, enter each field as a below. And click Save Channel at the bottom of the screen to save. Name: ESP8266 Signal Strength Description: ESP8266 RSSI publish Field1: RSSI Get Channel ID and API Keys \u00b6 The channel successfully created, you can see the channel status screen as a below. Channel ID is displayed there. 2 Here, switch the channel status tab to API Keys . The API key required to publish the message is the Write API Key . The last key you need is the User API Key and can be confirmed it in the user profile. Pull down Account from the top menu, select My profile . Then you can see the ThingSpeak settings and the User API Key is displayed middle of this screen. The sketch, Publishes messages \u00b6 The complete code of the sketch is mqttRSSI.ino in the AutoConnect repository . Replace the following #define in a sketch with User API Key , Write API Key and Channel ID . After Keys updated, compile the sketch and upload it. #define MQTT_USER_KEY \"****************\" // Replace to User API Key. #define CHANNEL_ID \"******\" // Replace to Channel ID. #define CHANNEL_API_KEY_WR \"****************\" // Replace to the write API Key. Publish messages \u00b6 After upload and reboot complete, the message publishing will start via the access point now set. The message carries RSSI as the current WiFi signal strength. The signal strength variations in RSSI are displayed on ThingSpeak's Channel status screen. How embed to your sketches \u00b6 For the client sketches, the code required to connect to WiFi is the following four parts only. #include directive 3 Include AutoConnect.h header file behind the include of ESP8266WiFi.h . Declare AutoConnect The declaration of the AutoConnect variable is not accompanied by ESP8266WebServer. Invokes \"begin()\" Call AutoConnect::begin . If you need to assign a static IP address, executes AutoConnectConfig before that. Performs \"handleClent()\" in \"loop()\" Invokes AutoConnect::handleClient() at inside loop() to enable the AutoConnect menu. window.onload = function() { Gifffer(); }; As of March 21, 2018. \u21a9 '454951' in the example above, but your channel ID should be different. \u21a9 #include <ESP8266WebServer.h> does not necessary for uses only client. \u21a9","title":"How to embed"},{"location":"howtoembed.html#embed-the-autoconnect-to-the-sketch","text":"Here hold two case examples. Both examples perform the same function. Only how to incorporate the AutoConnect into the sketch differs. Also included in the sample folder, HandlePortal.ino also shows how to use the PageBuilder library for HTML assemblies.","title":"Embed the AutoConnect to the sketch"},{"location":"howtoembed.html#what-does-this-example-do","text":"Uses the web interface to light the LED connected to the D0 (sometimes called BUILTIN_LED ) port of the NodeMCU module like the following animation. Access to the ESP8266 module connected WiFi from the browser then the page contains the current value of the D0 port would be displayed. The page has the buttons to switch the port value. The LED will blink according to the value with clicked by the button. This example is a typical sketch of manipulating ESP8266's GPIO via WLAN. Embed AutoConnect library into this sketch. There are few places to be changed. And you can use AutoConnect's captive portal function to establish a connection freely to other WiFi spots.","title":"What does this example do?"},{"location":"howtoembed.html#embed-autoconnect","text":"","title":"Embed AutoConnect"},{"location":"howtoembed.html#pattern-a","text":"Bind to ESP8266WebServer, performs handleClient with handleRequest. In what situations should the handleRequest be used. It is something needs to be done immediately after the handle client. It is better to call only AutoConnect::handleClient whenever possible.","title":" Pattern A."},{"location":"howtoembed.html#pattern-b","text":"Declare only AutoConnect, performs handleClient.","title":" Pattern B."},{"location":"howtoembed.html#used-with-mqtt-as-a-client-application","text":"The effect of AutoConnect is not only for ESP8266/ESP32 as the web server. It has advantages for something WiFi client as well. For example, AutoConnect is also convenient for publishing MQTT messages from various measurement points. Even if the SSID is different for each measurement point, it is not necessary to modify the sketch. This example tries to publish the WiFi signal strength of ESP8266 with MQTT. It uses the ThingSpeak for MQTT broker. ESP8266 publishes the RSSI value to the channel created on ThingSpeak as MQTT client . This example is well suited to demonstrate the usefulness of AutoConnect, as RSSI values are measured at each access point usually. Just adding a few lines of code makes it unnecessary to upload sketches with the different SSIDs rewrite for each access point.","title":"Used with MQTT as a client application"},{"location":"howtoembed.html#advance-procedures","text":"Arduino Client for MQTT - It's the PubSubClient , install it to Arduino IDE. If you have the latest version already, this step does not need. Create a channel on ThingSpeak. Get the Channel API Keys from ThingSpeak, put its keys to the sketch. The ThingSpeak is the open IoT platform. It is capable of sending data privately to the cloud and analyzing, visualizing its data. If you do not have an account of ThingSpeak, you need that account to proceed further. ThingSpeak has the free plan for the account which uses within the scope of this example. 1 You can sign up with the ThingSpeak sign-up page . Whether you should do sign-up or not. You are entrusted with the final judgment of account creation for ThingSpeak. Create an account at your own risk.","title":"Advance procedures"},{"location":"howtoembed.html#create-a-channel-on-thingspeak","text":"Sign in ThingSpeak. Select Channels to show the My Channels , then click New Channel . At the New Channel screen, enter each field as a below. And click Save Channel at the bottom of the screen to save. Name: ESP8266 Signal Strength Description: ESP8266 RSSI publish Field1: RSSI","title":"Create a channel on ThingSpeak"},{"location":"howtoembed.html#get-channel-id-and-api-keys","text":"The channel successfully created, you can see the channel status screen as a below. Channel ID is displayed there. 2 Here, switch the channel status tab to API Keys . The API key required to publish the message is the Write API Key . The last key you need is the User API Key and can be confirmed it in the user profile. Pull down Account from the top menu, select My profile . Then you can see the ThingSpeak settings and the User API Key is displayed middle of this screen.","title":"Get Channel ID and API Keys"},{"location":"howtoembed.html#the-sketch-publishes-messages","text":"The complete code of the sketch is mqttRSSI.ino in the AutoConnect repository . Replace the following #define in a sketch with User API Key , Write API Key and Channel ID . After Keys updated, compile the sketch and upload it. #define MQTT_USER_KEY \"****************\" // Replace to User API Key. #define CHANNEL_ID \"******\" // Replace to Channel ID. #define CHANNEL_API_KEY_WR \"****************\" // Replace to the write API Key.","title":"The sketch, Publishes messages"},{"location":"howtoembed.html#publish-messages","text":"After upload and reboot complete, the message publishing will start via the access point now set. The message carries RSSI as the current WiFi signal strength. The signal strength variations in RSSI are displayed on ThingSpeak's Channel status screen.","title":"Publish messages"},{"location":"howtoembed.html#how-embed-to-your-sketches","text":"For the client sketches, the code required to connect to WiFi is the following four parts only. #include directive 3 Include AutoConnect.h header file behind the include of ESP8266WiFi.h . Declare AutoConnect The declaration of the AutoConnect variable is not accompanied by ESP8266WebServer. Invokes \"begin()\" Call AutoConnect::begin . If you need to assign a static IP address, executes AutoConnectConfig before that. Performs \"handleClent()\" in \"loop()\" Invokes AutoConnect::handleClient() at inside loop() to enable the AutoConnect menu. window.onload = function() { Gifffer(); }; As of March 21, 2018. \u21a9 '454951' in the example above, but your channel ID should be different. \u21a9 #include <ESP8266WebServer.h> does not necessary for uses only client. \u21a9","title":"How embed to your sketches"},{"location":"license.html","text":"MIT License Copyright \u00a9 2018-2019 Hieromon Ikasamo Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Acknowledgments Each of the following libraries used by AutoConnect is under its license: The Luxbar is licensed under the MIT License. https://github.com/balzss/luxbar ArduinoJson is licensed under the MIT License. https://arduinojson.org/","title":"License"},{"location":"lsbegin.html","text":"AutoConnect::begin logic sequence \u00b6 Several parameters as follows of AutoConnectConfig affect the behavior of AutoConnect::begin function. Each parameter affects the behaves in interacted order with the priority and apply to the logic sequence of AutoConnect::begin . immediateStart : The captive portal start immediately, without first WiFi.begin. autoReconenct : Attempt re-connect with past SSID by saved credential. portalTimeout : Time out limit for the portal. retainPortal : Keep DNS server functioning for the captive portal. You can use these parameters in combination with sketch requirements and need to understand correctly the behavior caused by the parameters. The following chart shows the AutoConnect::begin logic sequence including the effect of these parameters. For example, AutoConnect::begin will not exits without the portalTimeout while the connection not establishes, but WebServer will start to work. A DNS server that detects the probe of the captive portal is also effective. So, your sketch may work seemingly, but it will close with inside a loop of the AutoConnect::begin function. Especially when invoking AutoConnect::begin in the setup() , execution control does not pass to the loop() . As different scenes, you may use the immediateStart effectively. Equipped the external switch to activate the captive portal with the ESP module, combined with the portalTime and the retainPortal it will become WiFi active connection feature. You can start AutoConnect::begin at any point in the loop() , which allows your sketch can behave both the offline mode and the online mode. The retainPortal option allows the DNS server to continue operation after exiting from AutoConnect::begin . AutoConnect traps captive portal detection from the client and redirects it to the AutoConnect menu. That trap will answer all unresolved addresses with SoftAP's IP address. If the URI handler for the source request is undefined, it returns a 302 response with SoftAPIP/_ac to the client. This is the mechanism of AutoConnect's captive portal. Captive portal probes will frequently occur while you are attempting on the client device's WiFi connection Apps and these implementations are varied each OS, so it not realistic to identify all probing URIs. Therefore, while retainPortal is enabled, it is not preferable to executing the sketch under the WiFi connection Apps on the client device. (Probably not work correctly) You need to exit from the WiFi connection Apps once. Please consider these kinds of influence when you make sketches. The AutoConnect::begin 3 rd parameter Another parameter as the 3 rd parameter of AutoConnect::begin related to timeout constrains the connection wait time after WiFi.begin. It is the CONNECTED judgment of the above chart that it has an effect.","title":"Inside AutoConnect::begin"},{"location":"lsbegin.html#autoconnectbegin-logic-sequence","text":"Several parameters as follows of AutoConnectConfig affect the behavior of AutoConnect::begin function. Each parameter affects the behaves in interacted order with the priority and apply to the logic sequence of AutoConnect::begin . immediateStart : The captive portal start immediately, without first WiFi.begin. autoReconenct : Attempt re-connect with past SSID by saved credential. portalTimeout : Time out limit for the portal. retainPortal : Keep DNS server functioning for the captive portal. You can use these parameters in combination with sketch requirements and need to understand correctly the behavior caused by the parameters. The following chart shows the AutoConnect::begin logic sequence including the effect of these parameters. For example, AutoConnect::begin will not exits without the portalTimeout while the connection not establishes, but WebServer will start to work. A DNS server that detects the probe of the captive portal is also effective. So, your sketch may work seemingly, but it will close with inside a loop of the AutoConnect::begin function. Especially when invoking AutoConnect::begin in the setup() , execution control does not pass to the loop() . As different scenes, you may use the immediateStart effectively. Equipped the external switch to activate the captive portal with the ESP module, combined with the portalTime and the retainPortal it will become WiFi active connection feature. You can start AutoConnect::begin at any point in the loop() , which allows your sketch can behave both the offline mode and the online mode. The retainPortal option allows the DNS server to continue operation after exiting from AutoConnect::begin . AutoConnect traps captive portal detection from the client and redirects it to the AutoConnect menu. That trap will answer all unresolved addresses with SoftAP's IP address. If the URI handler for the source request is undefined, it returns a 302 response with SoftAPIP/_ac to the client. This is the mechanism of AutoConnect's captive portal. Captive portal probes will frequently occur while you are attempting on the client device's WiFi connection Apps and these implementations are varied each OS, so it not realistic to identify all probing URIs. Therefore, while retainPortal is enabled, it is not preferable to executing the sketch under the WiFi connection Apps on the client device. (Probably not work correctly) You need to exit from the WiFi connection Apps once. Please consider these kinds of influence when you make sketches. The AutoConnect::begin 3 rd parameter Another parameter as the 3 rd parameter of AutoConnect::begin related to timeout constrains the connection wait time after WiFi.begin. It is the CONNECTED judgment of the above chart that it has an effect.","title":"AutoConnect::begin logic sequence"},{"location":"menu.html","text":"Luxbar The AutoConnect menu is developed using the LuxBar which is licensed under the MIT License. See the License . Where the from \u00b6 The AutoConnect menu appears when you access the AutoConnect root path . It is assigned \" /_ac \" located on the local IP address of ESP8266/ESP32 module by default. This location can be changed in the sketch. The following screen will appear at access to http://{localIP}/_ac as the root path. This is the statistics of the current WiFi connection. You can access the menu from the here, to invoke it tap at right on top. (e.g. http://172.217.28.1/_ac for SoftAP mode.) What's the local IP? A local IP means Local IP at connection established or SoftAP's IP. Right on top \u00b6 Currently, AutoConnect supports four menus. Undermost menu as \"HOME\" returns to the home path of its sketch. Configure new AP : Configure SSID and Password for new access point. Open SSIDs : Opens the past SSID which has been established connection from the flash. Disconnect : Disconnects current connection. Reset... : Rest the ESP8266/ESP32 module. HOME : Return to user home page. Configure new AP \u00b6 Scan all available access point in the vicinity and display it. Strength and security of the detected AP are marked. The is indicated for the SSID that needs a security key. \" Hidden: \" means the number of hidden SSIDs discovered. Enter SSID and Passphrase and tap \" apply \" to starts WiFi connection. Open SSIDs \u00b6 Once it was established WiFi connection, its SSID and password will be saved in the flash of ESP8266/ESP32 automatically. The Open SSIDs menu reads the saved SSID credentials from the flash. The stored credential data are listed by the SSID as shown below. Its label is a clickable button. Tap the SSID button, starts WiFi connection it. Disconnect \u00b6 Disconnect ESP8266/ESP32 from the current connection. It can also reset the ESP8266/ESP32 automatically after disconnection by instructing with using API in the sketch. After tapping \"Disconnect\", you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting the WLAN. Reset... \u00b6 Reset the ESP8266/ESP32 module, it will start rebooting. After rebooting complete, the ESP8266/ESP32 module begins establishing the previous connection with WIFI_STA mode, and esp8266ap or esp32ap of an access point will disappear from WLAN. Not every ESP8266 module will be rebooted normally The Reset menu is using the ESP.reset() function for ESP8266. This is an almost hardware reset. In order to resume the sketch normally, the state of GPIO0 is important. Since this depends on the circuit implementation for each module, not every module will be rebooted normally. See also FAQ . Custom menu items \u00b6 The menu items of the custom Web page line up at the below in the AutoConnect menu if the custom Web pages are joined. Details for Custom Web pages in AutoConnect menu . HOME \u00b6 A HOME item located at the bottom of the menu list is a link to the home path. The URI as the home path is / by default, and it is defined by AUTOCONNECT_HOMEURI with AutoConnectDefs.h file. #define AUTOCONNECT_HOMEURI \"/\" You can change the HOME path using the AutoConnect API. The AutoConnect::home function sets the URI as a link of the HOME item of the AutoConnect menu. by attaching AutoConnect menu \u00b6 The AutoConnect menu can contain HTML pages of your owns sketch as custom items. It works for HTML pages implemented by ESP8266WebServer::on handler or WebServer::on handler for ESP32. That is, you can make it as menu items to invoke the legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as FSBrowser to the AutoConnect menu item. It adds Edit and List items with little modification to the legacy sketch code. You can extend the AutoConnect menu to improve the original sketches and according to the procedure described in section Advanced Usage .","title":"AutoConnect menu"},{"location":"menu.html#where-the-from","text":"The AutoConnect menu appears when you access the AutoConnect root path . It is assigned \" /_ac \" located on the local IP address of ESP8266/ESP32 module by default. This location can be changed in the sketch. The following screen will appear at access to http://{localIP}/_ac as the root path. This is the statistics of the current WiFi connection. You can access the menu from the here, to invoke it tap at right on top. (e.g. http://172.217.28.1/_ac for SoftAP mode.) What's the local IP? A local IP means Local IP at connection established or SoftAP's IP.","title":" Where the from"},{"location":"menu.html#right-on-top","text":"Currently, AutoConnect supports four menus. Undermost menu as \"HOME\" returns to the home path of its sketch. Configure new AP : Configure SSID and Password for new access point. Open SSIDs : Opens the past SSID which has been established connection from the flash. Disconnect : Disconnects current connection. Reset... : Rest the ESP8266/ESP32 module. HOME : Return to user home page.","title":" Right on top"},{"location":"menu.html#configure-new-ap","text":"Scan all available access point in the vicinity and display it. Strength and security of the detected AP are marked. The is indicated for the SSID that needs a security key. \" Hidden: \" means the number of hidden SSIDs discovered. Enter SSID and Passphrase and tap \" apply \" to starts WiFi connection.","title":" Configure new AP"},{"location":"menu.html#open-ssids","text":"Once it was established WiFi connection, its SSID and password will be saved in the flash of ESP8266/ESP32 automatically. The Open SSIDs menu reads the saved SSID credentials from the flash. The stored credential data are listed by the SSID as shown below. Its label is a clickable button. Tap the SSID button, starts WiFi connection it.","title":" Open SSIDs"},{"location":"menu.html#disconnect","text":"Disconnect ESP8266/ESP32 from the current connection. It can also reset the ESP8266/ESP32 automatically after disconnection by instructing with using API in the sketch. After tapping \"Disconnect\", you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting the WLAN.","title":" Disconnect"},{"location":"menu.html#reset","text":"Reset the ESP8266/ESP32 module, it will start rebooting. After rebooting complete, the ESP8266/ESP32 module begins establishing the previous connection with WIFI_STA mode, and esp8266ap or esp32ap of an access point will disappear from WLAN. Not every ESP8266 module will be rebooted normally The Reset menu is using the ESP.reset() function for ESP8266. This is an almost hardware reset. In order to resume the sketch normally, the state of GPIO0 is important. Since this depends on the circuit implementation for each module, not every module will be rebooted normally. See also FAQ .","title":" Reset..."},{"location":"menu.html#custom-menu-items","text":"The menu items of the custom Web page line up at the below in the AutoConnect menu if the custom Web pages are joined. Details for Custom Web pages in AutoConnect menu .","title":" Custom menu items"},{"location":"menu.html#home","text":"A HOME item located at the bottom of the menu list is a link to the home path. The URI as the home path is / by default, and it is defined by AUTOCONNECT_HOMEURI with AutoConnectDefs.h file. #define AUTOCONNECT_HOMEURI \"/\" You can change the HOME path using the AutoConnect API. The AutoConnect::home function sets the URI as a link of the HOME item of the AutoConnect menu.","title":" HOME"},{"location":"menu.html#by-attaching-autoconnect-menu","text":"The AutoConnect menu can contain HTML pages of your owns sketch as custom items. It works for HTML pages implemented by ESP8266WebServer::on handler or WebServer::on handler for ESP32. That is, you can make it as menu items to invoke the legacy web page. The below screenshot is the result of adding an example sketch for the ESP8266WebServer library known as FSBrowser to the AutoConnect menu item. It adds Edit and List items with little modification to the legacy sketch code. You can extend the AutoConnect menu to improve the original sketches and according to the procedure described in section Advanced Usage .","title":" by attaching AutoConnect menu"},{"location":"menuize.html","text":"What menus can be made using AutoConnect \u00b6 AutoConnect generates a menu dynamically depending on the instantiated AutoConnectAux at the sketch executing time. Usually, it is a collection of AutoConnectElement . In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. In other words, you can easily create a built-in menu featuring the WiFi connection facility embedding the legacy web pages. Basic mechanism of menu generation \u00b6 The sketch can display the AutoConnect menu by following three patterns depending on AutoConnect-API usage. \u2002 Basic menu It is the most basic menu for only connecting WiFi. Sketch can automatically display this menu with the basic call sequence of the AutoConnect API which invokes AutoConnect::begin and AutoConnect::handleClient . \u2002 Extra menu with custom Web pages which is consisted by AutoConnectElements It is an extended menu that appears when the sketch consists of the custom Web pages with AutoConnectAux and AutoConnectElements. Refer to section Custom Web pages section . \u2002 Extra menu which contains legacy pages It is for the legacy sketches using the on handler of ESP8266WebServer/WebServer(for ESP32) class natively and looks the same as the extra menu as above. The mechanism to generate the AutoConnect menu is simple. It will insert the item as <li> tag generated from the title and uri member variable of the AutoConnectAux object to the menu list of AutoConnect's built-in HTML. Therefore, the legacy sketches can invoke the web pages from the AutoConnect menu with just declaration the title and URI to AutoConnectAux. Place the item for the legacy sketches on the menu \u00b6 To implement this with your sketch, use only the AutoConnectAux constructed with the title and URI of that page. AutoConnectElements is not required. The AutoConnect library package contains an example sketch for ESP8266WebServer known as FSBrowser. Its example is a sample implementation that supports AutoConnect without changing the structure of the original FSBrowser and has the menu item for Edit and List . The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows: Add AutoConnect declaration. Add the menu item named \" Edit \" and \" List \" of AutoConnectAux as each page. Replace the instance of ESP8266WebServer to AutoConnect. Change the menu title to FSBrowser using AutoConnectConfig::title . Join the legacy pages to AutoConnect declared at step #1 using AutoConnect::join . Joining multiple at one time with the list initialization for std::vector . According to the basic procedure of AutoConnect. Establish a connection with AutoConnect::begin and perform AutoConnect::handleClient in loop() . \u2002 Modification for FSBrowser (a part of sketch code) ... and embeds a hyperlink with an icon in the bottom of the body section of index.htm contained in the data folder to jump to the AutoConnect menu. < p style = \"padding-top:15px;text-align:center\" > < a href = \"/_ac\" >< img src = \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAC2klEQVRIS61VvWsUQRSfmU2pon9BUIkQUaKFaCBKgooSb2d3NSSFKbQR/KrEIiIKBiGF2CgRxEpjQNHs7mwOUcghwUQ7g58IsbGxEBWsb2f8zR177s3t3S2cA8ftzPu993vzvoaSnMu2vRKlaqgKp74Q/tE8qjQPyHGcrUrRjwlWShmDbFMURd/a6TcQwNiYUmpFCPElUebcuQ2vz6aNATMVReHEPwzfSSntDcNwNo2rI+DcvQzhpAbA40VKyV0p1Q9snzBG1qYVcYufXV1sREraDcxpyHdXgkfpRBj6Uwm2RsC5dxxmZ9pdOY9cKTISRcHTCmGiUCh4fYyplTwG2mAUbtMTBMHXOgK9QfyXEZr+TkgQ1oUwDA40hEgfIAfj+HuQRaBzAs9eKyUZ5Htx+T3ZODKG8DzOJMANhmGomJVMXPll+hx9UUAlzZrJJ4QNCDG3VEfguu7mcpmcB/gkBOtShhQhchAlu5jlLUgc9ENgyP5gf9+y6LTv+58p5zySkgwzLNOIGc8sEoT1Lc53NMlbCQQuvMxeCME1NNPVVkmH/i3IzzXDtCSA0qQQwZWOCJDY50jsQRjJmkslEOxvTcDRO6zPxOh5xZglKkYLhWM9jMVnkIsTyMT6NBj7IbOCEjm6HxNVVTo2WXqEWJZ1T8rytB6GxizyDkPhWVpBqfiXUtbo/HywYJSpA9kMamNNPZ71R9Hcm+TMHHZNGw3EuraXEUldbfvw25UdOjqOt+JhMwJd7+jSTpZaEiIcaCDwPK83jtWnTkwnunFMtxeL/ge9r4XItt1RNNaj/0GAcV2bR3U5sG3nEh6M61US+Qrfd9Bs31GGulI2GOS/8dgcQZV1w+ApjIxB7TDwF9GcNzJzoA+rD0/8HvPnXQJCt2qFCwbBTfRI7UyXumWVt+HJ9NO4XI++bdsb0YyrqXmlh+AWOLHaLqS5CLQR5EggR3YlcVS9gKeH2hnX8r8Kmi1CAsl36QAAAABJRU5ErkJggg==\" border = \"0\" title = \"AutoConnect menu\" alt = \"AutoConnect menu\" /></ a > </ p > window.onload = function() { Gifffer(); };","title":"Attach the menu"},{"location":"menuize.html#what-menus-can-be-made-using-autoconnect","text":"AutoConnect generates a menu dynamically depending on the instantiated AutoConnectAux at the sketch executing time. Usually, it is a collection of AutoConnectElement . In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. In other words, you can easily create a built-in menu featuring the WiFi connection facility embedding the legacy web pages.","title":"What menus can be made using AutoConnect"},{"location":"menuize.html#basic-mechanism-of-menu-generation","text":"The sketch can display the AutoConnect menu by following three patterns depending on AutoConnect-API usage. \u2002 Basic menu It is the most basic menu for only connecting WiFi. Sketch can automatically display this menu with the basic call sequence of the AutoConnect API which invokes AutoConnect::begin and AutoConnect::handleClient . \u2002 Extra menu with custom Web pages which is consisted by AutoConnectElements It is an extended menu that appears when the sketch consists of the custom Web pages with AutoConnectAux and AutoConnectElements. Refer to section Custom Web pages section . \u2002 Extra menu which contains legacy pages It is for the legacy sketches using the on handler of ESP8266WebServer/WebServer(for ESP32) class natively and looks the same as the extra menu as above. The mechanism to generate the AutoConnect menu is simple. It will insert the item as <li> tag generated from the title and uri member variable of the AutoConnectAux object to the menu list of AutoConnect's built-in HTML. Therefore, the legacy sketches can invoke the web pages from the AutoConnect menu with just declaration the title and URI to AutoConnectAux.","title":"Basic mechanism of menu generation"},{"location":"menuize.html#place-the-item-for-the-legacy-sketches-on-the-menu","text":"To implement this with your sketch, use only the AutoConnectAux constructed with the title and URI of that page. AutoConnectElements is not required. The AutoConnect library package contains an example sketch for ESP8266WebServer known as FSBrowser. Its example is a sample implementation that supports AutoConnect without changing the structure of the original FSBrowser and has the menu item for Edit and List . The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows: Add AutoConnect declaration. Add the menu item named \" Edit \" and \" List \" of AutoConnectAux as each page. Replace the instance of ESP8266WebServer to AutoConnect. Change the menu title to FSBrowser using AutoConnectConfig::title . Join the legacy pages to AutoConnect declared at step #1 using AutoConnect::join . Joining multiple at one time with the list initialization for std::vector . According to the basic procedure of AutoConnect. Establish a connection with AutoConnect::begin and perform AutoConnect::handleClient in loop() . \u2002 Modification for FSBrowser (a part of sketch code) ... and embeds a hyperlink with an icon in the bottom of the body section of index.htm contained in the data folder to jump to the AutoConnect menu. < p style = \"padding-top:15px;text-align:center\" > < a href = \"/_ac\" >< img src = \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAC2klEQVRIS61VvWsUQRSfmU2pon9BUIkQUaKFaCBKgooSb2d3NSSFKbQR/KrEIiIKBiGF2CgRxEpjQNHs7mwOUcghwUQ7g58IsbGxEBWsb2f8zR177s3t3S2cA8ftzPu993vzvoaSnMu2vRKlaqgKp74Q/tE8qjQPyHGcrUrRjwlWShmDbFMURd/a6TcQwNiYUmpFCPElUebcuQ2vz6aNATMVReHEPwzfSSntDcNwNo2rI+DcvQzhpAbA40VKyV0p1Q9snzBG1qYVcYufXV1sREraDcxpyHdXgkfpRBj6Uwm2RsC5dxxmZ9pdOY9cKTISRcHTCmGiUCh4fYyplTwG2mAUbtMTBMHXOgK9QfyXEZr+TkgQ1oUwDA40hEgfIAfj+HuQRaBzAs9eKyUZ5Htx+T3ZODKG8DzOJMANhmGomJVMXPll+hx9UUAlzZrJJ4QNCDG3VEfguu7mcpmcB/gkBOtShhQhchAlu5jlLUgc9ENgyP5gf9+y6LTv+58p5zySkgwzLNOIGc8sEoT1Lc53NMlbCQQuvMxeCME1NNPVVkmH/i3IzzXDtCSA0qQQwZWOCJDY50jsQRjJmkslEOxvTcDRO6zPxOh5xZglKkYLhWM9jMVnkIsTyMT6NBj7IbOCEjm6HxNVVTo2WXqEWJZ1T8rytB6GxizyDkPhWVpBqfiXUtbo/HywYJSpA9kMamNNPZ71R9Hcm+TMHHZNGw3EuraXEUldbfvw25UdOjqOt+JhMwJd7+jSTpZaEiIcaCDwPK83jtWnTkwnunFMtxeL/ge9r4XItt1RNNaj/0GAcV2bR3U5sG3nEh6M61US+Qrfd9Bs31GGulI2GOS/8dgcQZV1w+ApjIxB7TDwF9GcNzJzoA+rD0/8HvPnXQJCt2qFCwbBTfRI7UyXumWVt+HJ9NO4XI++bdsb0YyrqXmlh+AWOLHaLqS5CLQR5EggR3YlcVS9gKeH2hnX8r8Kmi1CAsl36QAAAABJRU5ErkJggg==\" border = \"0\" title = \"AutoConnect menu\" alt = \"AutoConnect menu\" /></ a > </ p > window.onload = function() { Gifffer(); };","title":"Place the item for the legacy sketches on the menu"},{"location":"otabrowser.html","text":"Updates with the Web Browser \u00b6 You can implement the user sketch as described in the ESP8266 Arduino Core documentation to realize using the web browser as an update client. By incorporating the ESP8266HTTPUpdateServer class into AutoConnect, you can operate the dialog page for selecting the updating binary sketch file owned by ESP8266HTTPUpdateServer from the AutoConnect menu. Update feature with a web browser is implemented using ESP8266HTTPUpdateServer class and ESP8266mDNS class. However, ESP32 Arduino core does not provide a class implementation equivalent to ESP8266HTTPUpdateServer . Therefore, it is necessary to implement an HTTPUpdateServer class for ESP32 to realize the update using a Web browser. The AutoConnect library includes an implementation of the HTTPUpdateServer class for ESP32 to make it easy for you to experience . 1 For the client devices equipped with Android OS Depending on the state of Android OS configuration, Bonjour service may not be incorporated. This method does not work with some Android devices as the client. How to embed ESP8266HTTPUpdateServer in AutoConnect \u00b6 To embed the ESP8266HTTPUpdateServer class with AutoConnect into your sketch, basically follow these steps: Include ESP8266mDNS.h and ESP8266HTTPUpdateServer.h , also WiFiClient.h , in addition to the usual directives as ESP8266WebServer.h and AutoConnect.h . Declare an ESP8266WebServer object. (In ESP32, as WebServer) Declare an ESP8266HTTPUpdateServer object. Declare an AutoConnect object with an ESP8266WebServer object as an argument. Declare an AutoConnectAux object for the update operation page. Assign /update to the URI of the update dialog page. Assign any title as the AutoConnect menu for the update dialog page. Declare additional AutoConnectAux pages for your application intention if needed. Perform the following procedure steps in the setup() function: Invokes ESP8288HTTPUpdateServer::setup function, specifies the USERNAME and the PASSWORD as needed. Load the AutoConnectAux pages declared in step #8 for your application. (Except the update dialog page) Join these pages to AutoConnect along with the update dialog page declared in step #5. Invokes AutoConnect::begin function. Call the MDNS.begin and MDNS.addServer functions to start the multi cast DNS service. Perform the following procedure steps in the loop() function: Call the MDNS.update function to parse requests for mDNS. (No needed as ESP32) Invokes AutoConnect::handleClient function. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <ESP8266HTTPUpdateServer.h> // Step #1 #include <ESP8266mDNS.h> // Step #1 #include <WiFiClient.h> // Step #1 #include <AutoConnect.h> static const char HELLO_PAGE[] PROGMEM = R\"( { \"title\": \"Hello world\", \"uri\": \"/\", \"menu\": true, \"element\": [ { \"name\": \"caption\", \"type\": \"ACText\", \"value\": \"<h2>Hello, world</h2>\", \"style\": \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\": \"content\", \"type\": \"ACText\", \"value\": \"In this page, place the custom web page handled by the sketch application.\" } ] } )\" ; ESP8266WebServer httpServer; // Step #2 ESP8266HTTPUpdateServer httpUpdate; // Step #3 AutoConnect portal (httpServer); // Step #4 AutoConnectAux update ( \"/update\" , \"UPDATE\" ); // Step #5, #6, #7 AutoConnectAux hello; // Step #8 void setup () { httpUpdate.setup( & httpServer, \"USERNAME\" , \"PASSWORD\" ); // Step #9.a hello.load(HELLO_PAGE); // Step #9.b portal.join({ hello, update }); // Step #9.c if (portal.begin()) { // Step #9.d if (MDNS.begin( \"esp-webupdate\" )) // Step #9.e MDNS.addService( \"http\" , \"tcp\" , 80 ); // Step #9.e } } void loop () { MDNS.update(); // Step #10.a portal.handleClient(); // Step #10.b } For ESP32 This procedure is equally applicable to ESP32. If the target module is ESP32, change the following items: Change the include directives appropriately for the ESP32 environment. Change ESP8266HTTPUpdaetServer to HTTPUpdateServer using an implementation provided from AutoConnect library example code. Remove MDNS.update line from the sketch code. Share an ESP8266WebServer AutoConnect shares the ESP8266WebServer instance with the ESP8266HTTPUpdateServer class. You can give the same instance as ESP8266WebServer instance given to AutoConnect to ESP8266HTTPUpdateServer class. ESP8266WebServer httpServer; ESP8266HTTPUpdateServer updateServer; AutoConnect portal (httpServer); updateServer( & httpServer); This sharing specification is the same for ESP32. The result of the above sketch should be as follows. 2 How LED ticking during updates You cannot get the ticker with LED during updates by using this way. It is since the current implementation of the ESP8266HTTPUpdateServer class of the Arduino core library does not assign an LED PIN to the ESP8266HTTPUpdate class. How to make the binary sketch \u00b6 Binary sketch files for updating can be retrieved using the Arduino IDE. Open the Sketch menu and select the Export compiled Binary , then starts compilation. When the compilation is complete, a binary sketch will save with the extension .bin in the same folder as the sketch. window.onload = function() { Gifffer(); }; You can find the implementation of the HTTPUpdateServer class in the WebUpdate folder included in the AutoConnect library examples folder . \u21a9 The authentication dialog is displayed first. \u21a9","title":"Using Web Browser"},{"location":"otabrowser.html#updates-with-the-web-browser","text":"You can implement the user sketch as described in the ESP8266 Arduino Core documentation to realize using the web browser as an update client. By incorporating the ESP8266HTTPUpdateServer class into AutoConnect, you can operate the dialog page for selecting the updating binary sketch file owned by ESP8266HTTPUpdateServer from the AutoConnect menu. Update feature with a web browser is implemented using ESP8266HTTPUpdateServer class and ESP8266mDNS class. However, ESP32 Arduino core does not provide a class implementation equivalent to ESP8266HTTPUpdateServer . Therefore, it is necessary to implement an HTTPUpdateServer class for ESP32 to realize the update using a Web browser. The AutoConnect library includes an implementation of the HTTPUpdateServer class for ESP32 to make it easy for you to experience . 1 For the client devices equipped with Android OS Depending on the state of Android OS configuration, Bonjour service may not be incorporated. This method does not work with some Android devices as the client.","title":"Updates with the Web Browser"},{"location":"otabrowser.html#how-to-embed-esp8266httpupdateserver-in-autoconnect","text":"To embed the ESP8266HTTPUpdateServer class with AutoConnect into your sketch, basically follow these steps: Include ESP8266mDNS.h and ESP8266HTTPUpdateServer.h , also WiFiClient.h , in addition to the usual directives as ESP8266WebServer.h and AutoConnect.h . Declare an ESP8266WebServer object. (In ESP32, as WebServer) Declare an ESP8266HTTPUpdateServer object. Declare an AutoConnect object with an ESP8266WebServer object as an argument. Declare an AutoConnectAux object for the update operation page. Assign /update to the URI of the update dialog page. Assign any title as the AutoConnect menu for the update dialog page. Declare additional AutoConnectAux pages for your application intention if needed. Perform the following procedure steps in the setup() function: Invokes ESP8288HTTPUpdateServer::setup function, specifies the USERNAME and the PASSWORD as needed. Load the AutoConnectAux pages declared in step #8 for your application. (Except the update dialog page) Join these pages to AutoConnect along with the update dialog page declared in step #5. Invokes AutoConnect::begin function. Call the MDNS.begin and MDNS.addServer functions to start the multi cast DNS service. Perform the following procedure steps in the loop() function: Call the MDNS.update function to parse requests for mDNS. (No needed as ESP32) Invokes AutoConnect::handleClient function. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <ESP8266HTTPUpdateServer.h> // Step #1 #include <ESP8266mDNS.h> // Step #1 #include <WiFiClient.h> // Step #1 #include <AutoConnect.h> static const char HELLO_PAGE[] PROGMEM = R\"( { \"title\": \"Hello world\", \"uri\": \"/\", \"menu\": true, \"element\": [ { \"name\": \"caption\", \"type\": \"ACText\", \"value\": \"<h2>Hello, world</h2>\", \"style\": \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\": \"content\", \"type\": \"ACText\", \"value\": \"In this page, place the custom web page handled by the sketch application.\" } ] } )\" ; ESP8266WebServer httpServer; // Step #2 ESP8266HTTPUpdateServer httpUpdate; // Step #3 AutoConnect portal (httpServer); // Step #4 AutoConnectAux update ( \"/update\" , \"UPDATE\" ); // Step #5, #6, #7 AutoConnectAux hello; // Step #8 void setup () { httpUpdate.setup( & httpServer, \"USERNAME\" , \"PASSWORD\" ); // Step #9.a hello.load(HELLO_PAGE); // Step #9.b portal.join({ hello, update }); // Step #9.c if (portal.begin()) { // Step #9.d if (MDNS.begin( \"esp-webupdate\" )) // Step #9.e MDNS.addService( \"http\" , \"tcp\" , 80 ); // Step #9.e } } void loop () { MDNS.update(); // Step #10.a portal.handleClient(); // Step #10.b } For ESP32 This procedure is equally applicable to ESP32. If the target module is ESP32, change the following items: Change the include directives appropriately for the ESP32 environment. Change ESP8266HTTPUpdaetServer to HTTPUpdateServer using an implementation provided from AutoConnect library example code. Remove MDNS.update line from the sketch code. Share an ESP8266WebServer AutoConnect shares the ESP8266WebServer instance with the ESP8266HTTPUpdateServer class. You can give the same instance as ESP8266WebServer instance given to AutoConnect to ESP8266HTTPUpdateServer class. ESP8266WebServer httpServer; ESP8266HTTPUpdateServer updateServer; AutoConnect portal (httpServer); updateServer( & httpServer); This sharing specification is the same for ESP32. The result of the above sketch should be as follows. 2 How LED ticking during updates You cannot get the ticker with LED during updates by using this way. It is since the current implementation of the ESP8266HTTPUpdateServer class of the Arduino core library does not assign an LED PIN to the ESP8266HTTPUpdate class.","title":" How to embed ESP8266HTTPUpdateServer in AutoConnect"},{"location":"otabrowser.html#how-to-make-the-binary-sketch","text":"Binary sketch files for updating can be retrieved using the Arduino IDE. Open the Sketch menu and select the Export compiled Binary , then starts compilation. When the compilation is complete, a binary sketch will save with the extension .bin in the same folder as the sketch. window.onload = function() { Gifffer(); }; You can find the implementation of the HTTPUpdateServer class in the WebUpdate folder included in the AutoConnect library examples folder . \u21a9 The authentication dialog is displayed first. \u21a9","title":" How to make the binary sketch"},{"location":"otaserver.html","text":"Updates with the update server \u00b6 Since the v1.0.0 release, AutoConnect provides new feature for updating sketch firmware of ESP8266 or ESP32 modules via OTA using the AutoConnectUpdate class that is an implementation of the sketch binary update by the HTTP server mentioned in the OTA update of the ESP8266 Arduino Core documentation, which inherits from the ESP8266HTTPUpdate class (as HTTPUpdate class in the case of ESP32). It acts as a client agent for a series of update operations. This method allows you to remotely update the ESP module's firmware beyond the network segments from the update server, as long as you can ensure proper routing and forwarding. If you choose this update method, you need to prepare the server process as a variant of the HTTP server that supplies the binary sketch files to the updating client agent. Its server requires to be able to handle the HTTP headers extended by ESP8266HTTPUpdate class as described in the ESP8266 Arduino Core documentation . There are various implementations of the update server that provide binary sketch files. For example, the ESP8266 Arduino Core documentation suggests an advanced updater php script that can be fully communicated with the client agent using the ESP8266HTTPUpdate class. That is, the update server for AutoConnect must work with the client agent, and its implementation should make the handshake well with the AutoConnectUpdate class which wraps an ESP8266HTTPUpdate class. The AutoConnect library provides an update server script implemented in Python that can combine with the AutoConnectUpdate class. How to embed AutoConnectUpdate to your sketch \u00b6 To embed the AutoConnectUpdate class into your sketch, basically follow these steps: Declare an ESP8266WebServer object. (In ESP32, as WebServer) Declare an AutoConnect object with an ESP8266WebServer object. Declare an AutoConnectUpdate object with the update server address and the HTTP port as parameters. Invokes AutoConnect::begin function. Attach the AutoConnectUpdate object to AutoConnect using AutoConnectUpdate::attach function. Invokes AutoConnect::handleClient function in the loop() . #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> ESP8266WebServer server; // Step #1 AutoConnect portal; // Step #2 AutoConnectUpdate update ( \"192.168.0.100\" , 8000 ); // Step #3 void setup () { if (portal.begin()) { // Step #4 update.attach(portal); // Step #5 } } void loop () { portal.handleClient(); // Step #6 } Behavior of the AutoConnectUpdate class \u00b6 A sketch incorporating the AutoConnectUpdate class has an extended menu item as UPDATE in the AutoConnect menu. UPDATE as menu item will be attached by the AutoConnectUpdate automatically. When an UPDATE item started, its first action is requesting a catalog list of updatable binary sketch files to the update server . Then the update server sends back the catalog list of stored binary sketch files to a client which is the ESP module. The AutoConnectUpdate class will display responded list to a custom Web page 1 on the browser. The substance of Available firmware list is a custom Web page by AutoConnectAux, and you can select the target binary sketch file with the radio button (AutoConnectRadio). A progress bar will appear to notify the updating status once the update has begun. When the update finished, the ESP module will reset automatically to launch a new firmware. The AutoConnectUpdate class performs the above series of operations in conjunction with the update server. All you need to do is attach the AutoConnectUpdate class to AutoConnect and execute the AutoConnect::handleClient function in the loop() . Update server for the AutoConnectUpdate class \u00b6 The above series of operations using AutoConnectUpdate class requires an update server that can work with it. AutoConnect provides an update server script implemented in Python. This server script conforms to a sketch that uses the AutoConnectUpdate class as an update client agent. 2 In the OTA platform, you can place the update server operated by the script in a location that is reachable from the ESP module on the network. updateserver.py [ -h ] [ --port PORT ] [ --bind IP_ADDRESS ] [ --catalog CATALOG ] [ --log LOG_LEVEL ] --help | -h Show help message and exit. --port | -p Specifies PORT number (Default: 8000) --bind | -b Specifies the IP address to which the update server binds. Usually, it is the host address of the update server. When multiple NICs configured, specify one of the IP addresses. (Default: HOST IP or 127.0.0.0) --catalog | -d Specifies the directory path on the update server that contains the binary sketch files. (Default: The current directory) --log | -l Specifies the level of logging output. It accepts the Logging Levels specified in the Python logging module. updateserver.py usage Python First, prepare a Python environment. It is also possible with a tiny single-board computer like the raspberry pi . Popular distributions such as Ubuntu for Linux include Python. You can easily set up a Python 2 or 3 environment. If you are using a Mac, you already have the Python 2 environment. macOS is equipped with Python 2.7 by default. In the case of Windows OS, it is necessary to install the Python environment intentionally. Please refer to the Python official page to install Python in your environment. Deploy the binary sketch files Use the Arduino IDE to output a binary file of sketches and deploy it 3 under the update server. The path which specifies for the --catalog option of updateServer.py is the path of the binary sketch files you deployed. Start updateserver.py For example, to start the update server on the host with IP address 172.16.1.10 using 8080 port 4 , execute the following command: python updateserver.py --port 8080 --bind 172 .16.1.10 --catalog bin --log debug In this example assumes that the binary sketch files are deployed under the path bin from the current directory. Limitations of the updateserver.py The updateserver.py script equips only the minimum facility because it assumes a private small OTA platform without identifying individual modules and version restrictions etc. To operate a larger OTA platform, it is necessary to identify the individual ESP module and to consider version control and security. HTTP contents and the sequence for the AutoConnectUpdate class \u00b6 You can also equip an update server that works with the AutoConnectUpdate class. It can be improved more widely applicable by adding extensions such as version control and authentication to the updateserver.py script. It is necessary to understand the specifications related to HTTP data streams and sequences to enhance the update server that the AutoConnectUpdate class assumes. This section describes the contents of the HTTP data stream required by the communication with AutoConnectUpdate class. To work correctly with the AutoConnectUpdate class, the update server must meet two requirements: The update server notifies the catalog list of updatable binary files which stored in the update server to the client agent. 5 Send an updating binary file and MD5 hash to a client in response to URI request (HTTP GET). 6 Above requirements will be implemented on along the HTTP protocol. The AutoConnectUpdate class requests an update server to notify the client for a catalog list of binary sketch files using an HTTP URL query string. The specifications of the HTTP query and the contents of the catalog list to be returned are as follows: 1. HTTP URL query for the catalog list of the updatable \u00b6 [address]/_catalog?op=list&path=[path] address URL of the update server /_catalog Request path, it is fixed. op Operation command for the update server. Currently, only ' list ' occurs. path Path containing the updatable binary files on the update server. 2. The catalog list content \u00b6 The response (that is, the catalog list) to the above query from the server is the following specification in JSON format. { \"name\" : FILE_NAME , \"type\" : FILE_TYPE , \"date\" : FILE_TIMESTAMP_DATED , \"time\" : FILE_TIMESTAMP_TIMED , \"size\" : FILE_SIZE } name Binary sketch file name for update (String) type One of ' bin ', ' directory ' or ' file '. AutoConnect Update recognizes only file types of ' bin ' as update targets. (String) date File update date. AutoConnect v1.0.0 treats the file update date as an annotation and is not equip the version control feature yet. (String) time File update time. AutoConnect v1.0.0 treats the file update date as an annotation and is not equip the version control feature yet. (String) size File byte count (Numeric) The above JSON object is one entry. The actual catalog list is an array of this entry since it assumes that an update server will provide multiple update binary files in production. The update server should respond with the MIME type specified as application/json for the catalog list. 7 3. The binary sketch file used for updating \u00b6 The AutoConnectUpdate class issues a HTTP GET request with the specified host address and URI. The update server responds by sending back a binary sketch file with the following header: Content-Type: application/octet-stream Content-Disposition: attachment; filename=\"BINARY_SKETCH_FILE_NAME\" Content-Length: LENGTH_OF_CONTENT x-MD5: HEXDIGEST The header x-MD5 is a 128-bit hash value (digest in hexadecimal) that represents the checksum of the binary sketch file for updates required for the ESP8266HTTPUpdate class. window.onload = function() { Gifffer(); }; You can scroll horizontally on the browser to see the timestamp and file size that the catalog list contains. \u21a9 The folders containing the script: For Python2: AUTOCONNECT_LIBRARY_PATH /src/updateserver/python2 For Python3: AUTOCONNECT_LIBRARY_PATH /src/updateserver/python3 \u21a9 Deploying the binary sketch file output by Arduino IDE is usually just copying to the folder for deployment. However, its folder must be accessible from the updateserver.py script. \u21a9 The port of the update server and the port used by the AutoConnectUpdate class must be the same. \u21a9 The client agent is an instance of the AutoConnectUpdate class. \u21a9 The client agent will send its URI request to the update server. \u21a9 It should be represented as Content-Type: application/json in the HTTP response header. \u21a9","title":"Using Update Server"},{"location":"otaserver.html#updates-with-the-update-server","text":"Since the v1.0.0 release, AutoConnect provides new feature for updating sketch firmware of ESP8266 or ESP32 modules via OTA using the AutoConnectUpdate class that is an implementation of the sketch binary update by the HTTP server mentioned in the OTA update of the ESP8266 Arduino Core documentation, which inherits from the ESP8266HTTPUpdate class (as HTTPUpdate class in the case of ESP32). It acts as a client agent for a series of update operations. This method allows you to remotely update the ESP module's firmware beyond the network segments from the update server, as long as you can ensure proper routing and forwarding. If you choose this update method, you need to prepare the server process as a variant of the HTTP server that supplies the binary sketch files to the updating client agent. Its server requires to be able to handle the HTTP headers extended by ESP8266HTTPUpdate class as described in the ESP8266 Arduino Core documentation . There are various implementations of the update server that provide binary sketch files. For example, the ESP8266 Arduino Core documentation suggests an advanced updater php script that can be fully communicated with the client agent using the ESP8266HTTPUpdate class. That is, the update server for AutoConnect must work with the client agent, and its implementation should make the handshake well with the AutoConnectUpdate class which wraps an ESP8266HTTPUpdate class. The AutoConnect library provides an update server script implemented in Python that can combine with the AutoConnectUpdate class.","title":"Updates with the update server"},{"location":"otaserver.html#how-to-embed-autoconnectupdate-to-your-sketch","text":"To embed the AutoConnectUpdate class into your sketch, basically follow these steps: Declare an ESP8266WebServer object. (In ESP32, as WebServer) Declare an AutoConnect object with an ESP8266WebServer object. Declare an AutoConnectUpdate object with the update server address and the HTTP port as parameters. Invokes AutoConnect::begin function. Attach the AutoConnectUpdate object to AutoConnect using AutoConnectUpdate::attach function. Invokes AutoConnect::handleClient function in the loop() . #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> ESP8266WebServer server; // Step #1 AutoConnect portal; // Step #2 AutoConnectUpdate update ( \"192.168.0.100\" , 8000 ); // Step #3 void setup () { if (portal.begin()) { // Step #4 update.attach(portal); // Step #5 } } void loop () { portal.handleClient(); // Step #6 }","title":" How to embed AutoConnectUpdate to your sketch"},{"location":"otaserver.html#behavior-of-the-autoconnectupdate-class","text":"A sketch incorporating the AutoConnectUpdate class has an extended menu item as UPDATE in the AutoConnect menu. UPDATE as menu item will be attached by the AutoConnectUpdate automatically. When an UPDATE item started, its first action is requesting a catalog list of updatable binary sketch files to the update server . Then the update server sends back the catalog list of stored binary sketch files to a client which is the ESP module. The AutoConnectUpdate class will display responded list to a custom Web page 1 on the browser. The substance of Available firmware list is a custom Web page by AutoConnectAux, and you can select the target binary sketch file with the radio button (AutoConnectRadio). A progress bar will appear to notify the updating status once the update has begun. When the update finished, the ESP module will reset automatically to launch a new firmware. The AutoConnectUpdate class performs the above series of operations in conjunction with the update server. All you need to do is attach the AutoConnectUpdate class to AutoConnect and execute the AutoConnect::handleClient function in the loop() .","title":" Behavior of the AutoConnectUpdate class"},{"location":"otaserver.html#update-server-for-the-autoconnectupdate-class","text":"The above series of operations using AutoConnectUpdate class requires an update server that can work with it. AutoConnect provides an update server script implemented in Python. This server script conforms to a sketch that uses the AutoConnectUpdate class as an update client agent. 2 In the OTA platform, you can place the update server operated by the script in a location that is reachable from the ESP module on the network. updateserver.py [ -h ] [ --port PORT ] [ --bind IP_ADDRESS ] [ --catalog CATALOG ] [ --log LOG_LEVEL ] --help | -h Show help message and exit. --port | -p Specifies PORT number (Default: 8000) --bind | -b Specifies the IP address to which the update server binds. Usually, it is the host address of the update server. When multiple NICs configured, specify one of the IP addresses. (Default: HOST IP or 127.0.0.0) --catalog | -d Specifies the directory path on the update server that contains the binary sketch files. (Default: The current directory) --log | -l Specifies the level of logging output. It accepts the Logging Levels specified in the Python logging module. updateserver.py usage Python First, prepare a Python environment. It is also possible with a tiny single-board computer like the raspberry pi . Popular distributions such as Ubuntu for Linux include Python. You can easily set up a Python 2 or 3 environment. If you are using a Mac, you already have the Python 2 environment. macOS is equipped with Python 2.7 by default. In the case of Windows OS, it is necessary to install the Python environment intentionally. Please refer to the Python official page to install Python in your environment. Deploy the binary sketch files Use the Arduino IDE to output a binary file of sketches and deploy it 3 under the update server. The path which specifies for the --catalog option of updateServer.py is the path of the binary sketch files you deployed. Start updateserver.py For example, to start the update server on the host with IP address 172.16.1.10 using 8080 port 4 , execute the following command: python updateserver.py --port 8080 --bind 172 .16.1.10 --catalog bin --log debug In this example assumes that the binary sketch files are deployed under the path bin from the current directory. Limitations of the updateserver.py The updateserver.py script equips only the minimum facility because it assumes a private small OTA platform without identifying individual modules and version restrictions etc. To operate a larger OTA platform, it is necessary to identify the individual ESP module and to consider version control and security.","title":" Update server for the AutoConnectUpdate class"},{"location":"otaserver.html#http-contents-and-the-sequence-for-the-autoconnectupdate-class","text":"You can also equip an update server that works with the AutoConnectUpdate class. It can be improved more widely applicable by adding extensions such as version control and authentication to the updateserver.py script. It is necessary to understand the specifications related to HTTP data streams and sequences to enhance the update server that the AutoConnectUpdate class assumes. This section describes the contents of the HTTP data stream required by the communication with AutoConnectUpdate class. To work correctly with the AutoConnectUpdate class, the update server must meet two requirements: The update server notifies the catalog list of updatable binary files which stored in the update server to the client agent. 5 Send an updating binary file and MD5 hash to a client in response to URI request (HTTP GET). 6 Above requirements will be implemented on along the HTTP protocol. The AutoConnectUpdate class requests an update server to notify the client for a catalog list of binary sketch files using an HTTP URL query string. The specifications of the HTTP query and the contents of the catalog list to be returned are as follows:","title":" HTTP contents and the sequence for the AutoConnectUpdate class"},{"location":"otaserver.html#1-http-url-query-for-the-catalog-list-of-the-updatable","text":"[address]/_catalog?op=list&path=[path] address URL of the update server /_catalog Request path, it is fixed. op Operation command for the update server. Currently, only ' list ' occurs. path Path containing the updatable binary files on the update server.","title":"1. HTTP URL query for the catalog list of the updatable"},{"location":"otaserver.html#2-the-catalog-list-content","text":"The response (that is, the catalog list) to the above query from the server is the following specification in JSON format. { \"name\" : FILE_NAME , \"type\" : FILE_TYPE , \"date\" : FILE_TIMESTAMP_DATED , \"time\" : FILE_TIMESTAMP_TIMED , \"size\" : FILE_SIZE } name Binary sketch file name for update (String) type One of ' bin ', ' directory ' or ' file '. AutoConnect Update recognizes only file types of ' bin ' as update targets. (String) date File update date. AutoConnect v1.0.0 treats the file update date as an annotation and is not equip the version control feature yet. (String) time File update time. AutoConnect v1.0.0 treats the file update date as an annotation and is not equip the version control feature yet. (String) size File byte count (Numeric) The above JSON object is one entry. The actual catalog list is an array of this entry since it assumes that an update server will provide multiple update binary files in production. The update server should respond with the MIME type specified as application/json for the catalog list. 7","title":"2. The catalog list content"},{"location":"otaserver.html#3-the-binary-sketch-file-used-for-updating","text":"The AutoConnectUpdate class issues a HTTP GET request with the specified host address and URI. The update server responds by sending back a binary sketch file with the following header: Content-Type: application/octet-stream Content-Disposition: attachment; filename=\"BINARY_SKETCH_FILE_NAME\" Content-Length: LENGTH_OF_CONTENT x-MD5: HEXDIGEST The header x-MD5 is a 128-bit hash value (digest in hexadecimal) that represents the checksum of the binary sketch file for updates required for the ESP8266HTTPUpdate class. window.onload = function() { Gifffer(); }; You can scroll horizontally on the browser to see the timestamp and file size that the catalog list contains. \u21a9 The folders containing the script: For Python2: AUTOCONNECT_LIBRARY_PATH /src/updateserver/python2 For Python3: AUTOCONNECT_LIBRARY_PATH /src/updateserver/python3 \u21a9 Deploying the binary sketch file output by Arduino IDE is usually just copying to the folder for deployment. However, its folder must be accessible from the updateserver.py script. \u21a9 The port of the update server and the port used by the AutoConnectUpdate class must be the same. \u21a9 The client agent is an instance of the AutoConnectUpdate class. \u21a9 The client agent will send its URI request to the update server. \u21a9 It should be represented as Content-Type: application/json in the HTTP response header. \u21a9","title":"3. The binary sketch file used for updating"},{"location":"otaupdate.html","text":"OTA Updates with AutoConnect \u00b6 AutoConnect provides two type platforms for updating the binary sketch in the ESP8266 or ESP32 module via OTA. They correspond to the Web Browser Update and HTTP Server Update whiches mentioned in the ESP8266 Arduino Core documentation . The update behavior using a web browser as the client that supplies the binary sketch file for update follows the scenario assumed by the ESP8266 Arduino core. Therefore, the user sketch must meet the requirements described in the ESP8266 Arduino Core documentation, but you can easily embed the update feature that able to handle with the web browser by AutoConnect. All you need to do is that join the AutoConnectAux with embedded ESP8266HTTPUpdateServer 1 of the core library to AutoConnect. It is for the only the same network This method can apply only if the client browser and the ESP module belong to the same network segment. It cannot work correctly across networks. Another update method using an update server can be applied more broadly than using a web browser. This method can also update the ESP module over the Internet if you can secure the correct route and transparency between the ESP module and the update server. To configure this platform, you need to have an update server along with using the AutoConnectUpdate class in your sketch. Security Disclaimer The security level of the OTA update platform provided by AutoConnect is very weak. No guarantees as to the level of security for your application by the AutoConnect OTA Update is implied. The AutoConnect library provides an implementation of the HTTPUpdateServer class that ported from ESP8266HTTPUpdateServer class for ESP32 intention. It is contained the WebUpdate under the examples folder. \u21a9","title":"OTA Updates"},{"location":"otaupdate.html#ota-updates-with-autoconnect","text":"AutoConnect provides two type platforms for updating the binary sketch in the ESP8266 or ESP32 module via OTA. They correspond to the Web Browser Update and HTTP Server Update whiches mentioned in the ESP8266 Arduino Core documentation . The update behavior using a web browser as the client that supplies the binary sketch file for update follows the scenario assumed by the ESP8266 Arduino core. Therefore, the user sketch must meet the requirements described in the ESP8266 Arduino Core documentation, but you can easily embed the update feature that able to handle with the web browser by AutoConnect. All you need to do is that join the AutoConnectAux with embedded ESP8266HTTPUpdateServer 1 of the core library to AutoConnect. It is for the only the same network This method can apply only if the client browser and the ESP module belong to the same network segment. It cannot work correctly across networks. Another update method using an update server can be applied more broadly than using a web browser. This method can also update the ESP module over the Internet if you can secure the correct route and transparency between the ESP module and the update server. To configure this platform, you need to have an update server along with using the AutoConnectUpdate class in your sketch. Security Disclaimer The security level of the OTA update platform provided by AutoConnect is very weak. No guarantees as to the level of security for your application by the AutoConnect OTA Update is implied. The AutoConnect library provides an implementation of the HTTPUpdateServer class that ported from ESP8266HTTPUpdateServer class for ESP32 intention. It is contained the WebUpdate under the examples folder. \u21a9","title":"OTA Updates with AutoConnect"},{"location":"wojson.html","text":"Suppress increase in memory consumption \u00b6 Custom Web page processing consumes a lot of memory. AutoConnect will take a whole string of the JSON document for the custom Web pages into memory. The required buffer size for the JSON document of example sketch mqttRSSI reaches approximately 3000 bytes. And actually, it needs twice the heap area. Especially this constraint will be a problem with the ESP8266 which has a heap size poor. AutoConnect can handle custom Web pages without using JSON. In that case, since the ArduinoJson library will not be bound, the sketch size will also be reduced. Writing the custom Web pages without JSON \u00b6 To handle the custom Web pages without using JSON, follow the steps below. Create or define AutoConnectAux for each page. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . In addition to the above procedure, to completely cut off for binding with the ArduinoJson library, turn off the ArduinoJson use indicator which is declared by the AutoConnect definitions . Its declaration is in AutoConnectDefs.h file. 1 // Comment out the AUTOCONNECT_USE_JSON macro to detach the ArduinoJson. #define AUTOCONNECT_USE_JSON JSON processing will be disabled Commenting out the AUTOCONNECT_USE_JSON macro invalidates all functions related to JSON processing. If the sketch is using the JSON function, it will result in a compile error. Implementation example without ArduinoJson \u00b6 The code excluding JSON processing from the mqttRSSI sketch attached to the library is as follows. (It is a part of code. Refer to mqttRSSI_NA.ino for the whole sketch.) The JSON document for mqttRSSI [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"<h2>MQTT broker settings</h2>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"style\" : \"font-family:serif;color:#4682b4;\" }, { \"name\" : \"mqttserver\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"Server\" , \"pattern\" : \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\\\-]*[a-zA-Z0-9])\\\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\\\-]*[A-Za-z0-9])$\" , \"placeholder\" : \"MQTT broker server\" }, { \"name\" : \"channelid\" , \"type\" : \"ACInput\" , \"label\" : \"Channel ID\" , \"pattern\" : \"^[0-9]{6}$\" }, { \"name\" : \"userkey\" , \"type\" : \"ACInput\" , \"label\" : \"User Key\" }, { \"name\" : \"apikey\" , \"type\" : \"ACInput\" , \"label\" : \"API Key\" }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"uniqueid\" , \"type\" : \"ACCheckbox\" , \"value\" : \"unique\" , \"label\" : \"Use APID unique\" , \"checked\" : false }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"label\" : \"Update period\" , \"arrange\" : \"vertical\" , \"checked\" : 1 }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"hostname\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"ESP host name\" , \"pattern\" : \"^([a-zA-Z0-9]([a-zA-Z0-9-])*[a-zA-Z0-9]){1,32}$\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"Save&amp;Start\" , \"uri\" : \"/mqtt_save\" }, { \"name\" : \"discard\" , \"type\" : \"ACSubmit\" , \"value\" : \"Discard\" , \"uri\" : \"/\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"<h4>Parameters saved as:</h4>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"parameters\" , \"type\" : \"ACText\" }, { \"name\" : \"clear\" , \"type\" : \"ACSubmit\" , \"value\" : \"Clear channel\" , \"uri\" : \"/mqtt_clear\" } ] } ] Exclude the JSON and replace to the AutoConnectElements natively // In the declaration, // Declare AutoConnectElements for the page asf /mqtt_setting ACText(header, \"<h2>MQTT broker settings</h2>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(caption, \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"font-family:serif;color:#4682b4;\" ); ACInput(mqttserver, \"\" , \"Server\" , \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9 \\\\ -]*[a-zA-Z0-9]) \\\\ .)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9 \\\\ -]*[A-Za-z0-9])$\" , \"MQTT broker server\" ); ACInput(channelid, \"\" , \"Channel ID\" , \"^[0-9]{6}$\" ); ACInput(userkey, \"\" , \"User Key\" ); ACInput(apikey, \"\" , \"API Key\" ); ACElement(newline, \"<hr>\" ); ACCheckbox(uniqueid, \"unique\" , \"Use APID unique\" ); ACRadio(period, { \"30 sec.\" , \"60 sec.\" , \"180 sec.\" }, \"Update period\" , AC_Vertical, 1 ); ACSubmit(save, \"Start\" , \"mqtt_save\" ); ACSubmit(discard, \"Discard\" , \"/\" ); // Declare the custom Web page as /mqtt_setting and contains the AutoConnectElements AutoConnectAux mqtt_setting ( \"/mqtt_setting\" , \"MQTT Setting\" , true, { header, caption, mqttserver, channelid, userkey, apikey, newline, uniqueid, period, newline, save, discard }); // Declare AutoConnectElements for the page as /mqtt_save ACText(caption2, \"<h4>Parameters available as:</h4>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(parameters); ACSubmit(clear, \"Clear channel\" , \"/mqtt_clear\" ); // Declare the custom Web page as /mqtt_save and contains the AutoConnectElements AutoConnectAux mqtt_save ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, parameters, clear }); // In the setup(), // Join the custom Web pages and performs begin portal.join({ mqtt_setting, mqtt_save }); portal.begin(); Detaching the ArduinoJson library reduces the sketch size by approximately 10K bytes. \u21a9","title":"Custom Web pages w/o JSON"},{"location":"wojson.html#suppress-increase-in-memory-consumption","text":"Custom Web page processing consumes a lot of memory. AutoConnect will take a whole string of the JSON document for the custom Web pages into memory. The required buffer size for the JSON document of example sketch mqttRSSI reaches approximately 3000 bytes. And actually, it needs twice the heap area. Especially this constraint will be a problem with the ESP8266 which has a heap size poor. AutoConnect can handle custom Web pages without using JSON. In that case, since the ArduinoJson library will not be bound, the sketch size will also be reduced.","title":"Suppress increase in memory consumption"},{"location":"wojson.html#writing-the-custom-web-pages-without-json","text":"To handle the custom Web pages without using JSON, follow the steps below. Create or define AutoConnectAux for each page. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . In addition to the above procedure, to completely cut off for binding with the ArduinoJson library, turn off the ArduinoJson use indicator which is declared by the AutoConnect definitions . Its declaration is in AutoConnectDefs.h file. 1 // Comment out the AUTOCONNECT_USE_JSON macro to detach the ArduinoJson. #define AUTOCONNECT_USE_JSON JSON processing will be disabled Commenting out the AUTOCONNECT_USE_JSON macro invalidates all functions related to JSON processing. If the sketch is using the JSON function, it will result in a compile error.","title":"Writing the custom Web pages without JSON"},{"location":"wojson.html#implementation-example-without-arduinojson","text":"The code excluding JSON processing from the mqttRSSI sketch attached to the library is as follows. (It is a part of code. Refer to mqttRSSI_NA.ino for the whole sketch.) The JSON document for mqttRSSI [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"<h2>MQTT broker settings</h2>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"style\" : \"font-family:serif;color:#4682b4;\" }, { \"name\" : \"mqttserver\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"Server\" , \"pattern\" : \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\\\-]*[a-zA-Z0-9])\\\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\\\-]*[A-Za-z0-9])$\" , \"placeholder\" : \"MQTT broker server\" }, { \"name\" : \"channelid\" , \"type\" : \"ACInput\" , \"label\" : \"Channel ID\" , \"pattern\" : \"^[0-9]{6}$\" }, { \"name\" : \"userkey\" , \"type\" : \"ACInput\" , \"label\" : \"User Key\" }, { \"name\" : \"apikey\" , \"type\" : \"ACInput\" , \"label\" : \"API Key\" }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"uniqueid\" , \"type\" : \"ACCheckbox\" , \"value\" : \"unique\" , \"label\" : \"Use APID unique\" , \"checked\" : false }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"label\" : \"Update period\" , \"arrange\" : \"vertical\" , \"checked\" : 1 }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"hostname\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"ESP host name\" , \"pattern\" : \"^([a-zA-Z0-9]([a-zA-Z0-9-])*[a-zA-Z0-9]){1,32}$\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"Save&amp;Start\" , \"uri\" : \"/mqtt_save\" }, { \"name\" : \"discard\" , \"type\" : \"ACSubmit\" , \"value\" : \"Discard\" , \"uri\" : \"/\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"<h4>Parameters saved as:</h4>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"parameters\" , \"type\" : \"ACText\" }, { \"name\" : \"clear\" , \"type\" : \"ACSubmit\" , \"value\" : \"Clear channel\" , \"uri\" : \"/mqtt_clear\" } ] } ] Exclude the JSON and replace to the AutoConnectElements natively // In the declaration, // Declare AutoConnectElements for the page asf /mqtt_setting ACText(header, \"<h2>MQTT broker settings</h2>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(caption, \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"font-family:serif;color:#4682b4;\" ); ACInput(mqttserver, \"\" , \"Server\" , \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9 \\\\ -]*[a-zA-Z0-9]) \\\\ .)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9 \\\\ -]*[A-Za-z0-9])$\" , \"MQTT broker server\" ); ACInput(channelid, \"\" , \"Channel ID\" , \"^[0-9]{6}$\" ); ACInput(userkey, \"\" , \"User Key\" ); ACInput(apikey, \"\" , \"API Key\" ); ACElement(newline, \"<hr>\" ); ACCheckbox(uniqueid, \"unique\" , \"Use APID unique\" ); ACRadio(period, { \"30 sec.\" , \"60 sec.\" , \"180 sec.\" }, \"Update period\" , AC_Vertical, 1 ); ACSubmit(save, \"Start\" , \"mqtt_save\" ); ACSubmit(discard, \"Discard\" , \"/\" ); // Declare the custom Web page as /mqtt_setting and contains the AutoConnectElements AutoConnectAux mqtt_setting ( \"/mqtt_setting\" , \"MQTT Setting\" , true, { header, caption, mqttserver, channelid, userkey, apikey, newline, uniqueid, period, newline, save, discard }); // Declare AutoConnectElements for the page as /mqtt_save ACText(caption2, \"<h4>Parameters available as:</h4>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(parameters); ACSubmit(clear, \"Clear channel\" , \"/mqtt_clear\" ); // Declare the custom Web page as /mqtt_save and contains the AutoConnectElements AutoConnectAux mqtt_save ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, parameters, clear }); // In the setup(), // Join the custom Web pages and performs begin portal.join({ mqtt_setting, mqtt_save }); portal.begin(); Detaching the ArduinoJson library reduces the sketch size by approximately 10K bytes. \u21a9","title":"Implementation example without ArduinoJson"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"index.html","text":"AutoConnect for ESP8266/ESP32 \u00b6 An Arduino library for ESP8266/ESP32 WLAN configuration at run time with web interface. Overview \u00b6 To the dynamic configuration for joining to WLAN with SSID and PSK accordingly. It an Arduino library united with ESP8266WebServer class for ESP8266 or WebServer class for ESP32. Easy implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi connection. With this library to make a sketch easily which connects from ESP8266/ESP32 to the access point at runtime by the web interface without hard-coded SSID and password. No need pre-coded SSID & password \u00b6 It is no needed hard-coding in advance the SSID and Password into the sketch to connect between ESP8266/ESP32 and WLAN. You can input SSID & Password from a smartphone via the web interface at runtime. Simple usage \u00b6 AutoConnect control screen will be displayed automatically for establishing new connections. It aids by the captive portal when vested the connection cannot be detected. By using the AutoConnect menu , to manage the connections convenient. Store the established connection \u00b6 The connection authentication data as credentials are saved automatically in the flash of ESP8266/ESP32 and You can select the past SSID from the AutoConnect menu . Easy to embed in \u00b6 AutoConnect can be placed easily in your sketch. It's \" begin \" and \" handleClient \" only. Lives with your sketches \u00b6 The sketches which provide the web page using ESP8266WebServer there is, AutoConnect will not disturb it. AutoConnect can use an already instantiated ESP8266WebServer object, or itself can assign it. This effect also applies to ESP32. The corresponding class for ESP32 will be the WebServer. Easy to add the custom Web pages ENHANCED w/v0.9.7 \u00b6 You can easily add your owned web pages that can consist of representative HTML elements and invoke them from the menu. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. Quick and easy to equip the OTA update feature ENHANCED w/v1.0.0 \u00b6 You can quickly and easily equip the OTA update feature to your sketch and also you can operate the firmware update process via OTA from AutoConnect menu. Installation \u00b6 Requirements \u00b6 Supported hardware \u00b6 Generic ESP8266 modules (applying the ESP8266 Community's Arduino core) Adafruit HUZZAH ESP8266 (ESP-12) ESP-WROOM-02 Heltec WiFi Kit 8 NodeMCU 0.9 (ESP-12) / NodeMCU 1.0 (ESP-12E) Olimex MOD-WIFI-ESP8266 SparkFun Thing SweetPea ESP-210 ESP32Dev Board (applying the Espressif's arduino-esp32 core) SparkFun ESP32 Thing WEMOS LOLIN D32 Ai-Thinker NodeMCU-32S Heltec WiFi Kit 32 M5Stack And other ESP8266/ESP32 modules supported by the Additional Board Manager URLs of the Arduino-IDE. About flash size on the module The AutoConnect sketch size is relatively large. Large flash capacity is necessary. 512Kbyte (4Mbits) flash inclusion module such as ESP-01 is not recommended. Required libraries \u00b6 AutoConnect requires the following environment and libraries. Arduino IDE The current upstream at the 1.8 level or later is needed. Please install from the official Arduino IDE download page . This step is not required if you already have a modern version. ESP8266 Arduino core AutoConnect targets sketches made on the assumption of ESP8266 Community's Arduino core . Stable 2.4.0 or higher required and the latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. Package URL is http://arduino.esp8266.com/stable/package_esp8266com_index.json ESP32 Arduino core Also, to apply AutoConnect to ESP32, the arduino-esp32 core provided by Espressif is needed. Stable 1.0.1 or required and the latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. You can add multiple URLs into Additional Board Manager URLs field, separating them with commas. Package URL is https://dl.espressif.com/dl/package_esp32_index.json for ESP32. Arduino core for ESP32 1.0.3 or later For ESP32, AutoConnect v1.0.0 later is required for arduino-esp32 1.0.3 or later. Additional library (Required) The PageBuilder library to build HTML for ESP8266WebServer is needed. To install the PageBuilder library into your Arduino IDE, you can use the Library Manager . Select the board of ESP8266 series in the Arduino IDE, open the library manager and search keyword ' PageBuilder ' with the topic ' Communication ', then you can see the PageBuilder . The latest version is required 1.3.3 later . 1 Additional library (Optional) By adding the ArduinoJson library, AutoConnect will be able to handle the custom Web pages described with JSON. Since AutoConnect v0.9.7 you can insert user-owned web pages that can consist of representative HTML elements as styled TEXT, INPUT, BUTTON, CHECKBOX, SELECT, SUBMIT and invoke them from the AutoConnect menu. These HTML elements can be added by sketches using the AutoConnect API. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. ArduinoJson is required to use this feature. 2 AutoConnect can work with ArduinoJson both version 5 and version 6 . Install the AutoConnect \u00b6 Clone or download from the AutoConnect GitHub repository . When you select Download, you can import it to Arduino IDE immediately. After downloaded, the AutoConnect-master.zip file will be saved in your download folder. Then in the Arduino IDE, navigate to \"Sketch > Include Library\" . At the top of the drop down list, select the option to \"Add .ZIP Library...\" . Details for Arduino official page . Supported by Library manager. AutoConnect was added to the Arduino IDE library manager. It can be used with the PlatformIO library also. window.onload = function() { Gifffer(); }; Since AutoConnect v0.9.8, PageBuilder v1.3.3 later is required. \u21a9 Using the AutoConnect API natively allows you to sketch custom Web pages without JSON. \u21a9","title":"Overview"},{"location":"index.html#autoconnect-for-esp8266esp32","text":"An Arduino library for ESP8266/ESP32 WLAN configuration at run time with web interface.","title":"AutoConnect for ESP8266/ESP32"},{"location":"index.html#overview","text":"To the dynamic configuration for joining to WLAN with SSID and PSK accordingly. It an Arduino library united with ESP8266WebServer class for ESP8266 or WebServer class for ESP32. Easy implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi connection. With this library to make a sketch easily which connects from ESP8266/ESP32 to the access point at runtime by the web interface without hard-coded SSID and password.","title":"Overview"},{"location":"index.html#no-need-pre-coded-ssid-password","text":"It is no needed hard-coding in advance the SSID and Password into the sketch to connect between ESP8266/ESP32 and WLAN. You can input SSID & Password from a smartphone via the web interface at runtime.","title":" No need pre-coded SSID &amp; password"},{"location":"index.html#simple-usage","text":"AutoConnect control screen will be displayed automatically for establishing new connections. It aids by the captive portal when vested the connection cannot be detected. By using the AutoConnect menu , to manage the connections convenient.","title":" Simple usage"},{"location":"index.html#store-the-established-connection","text":"The connection authentication data as credentials are saved automatically in the flash of ESP8266/ESP32 and You can select the past SSID from the AutoConnect menu .","title":" Store the established connection"},{"location":"index.html#easy-to-embed-in","text":"AutoConnect can be placed easily in your sketch. It's \" begin \" and \" handleClient \" only.","title":" Easy to embed in"},{"location":"index.html#lives-with-your-sketches","text":"The sketches which provide the web page using ESP8266WebServer there is, AutoConnect will not disturb it. AutoConnect can use an already instantiated ESP8266WebServer object, or itself can assign it. This effect also applies to ESP32. The corresponding class for ESP32 will be the WebServer.","title":" Lives with your sketches"},{"location":"index.html#easy-to-add-the-custom-web-pages-enhanced-wv097","text":"You can easily add your owned web pages that can consist of representative HTML elements and invoke them from the menu. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD.","title":" Easy to add the custom Web pages ENHANCED w/v0.9.7"},{"location":"index.html#quick-and-easy-to-equip-the-ota-update-feature-enhanced-wv100","text":"You can quickly and easily equip the OTA update feature to your sketch and also you can operate the firmware update process via OTA from AutoConnect menu.","title":" Quick and easy to equip the OTA update feature ENHANCED w/v1.0.0"},{"location":"index.html#installation","text":"","title":"Installation"},{"location":"index.html#requirements","text":"","title":"Requirements"},{"location":"index.html#supported-hardware","text":"Generic ESP8266 modules (applying the ESP8266 Community's Arduino core) Adafruit HUZZAH ESP8266 (ESP-12) ESP-WROOM-02 Heltec WiFi Kit 8 NodeMCU 0.9 (ESP-12) / NodeMCU 1.0 (ESP-12E) Olimex MOD-WIFI-ESP8266 SparkFun Thing SweetPea ESP-210 ESP32Dev Board (applying the Espressif's arduino-esp32 core) SparkFun ESP32 Thing WEMOS LOLIN D32 Ai-Thinker NodeMCU-32S Heltec WiFi Kit 32 M5Stack And other ESP8266/ESP32 modules supported by the Additional Board Manager URLs of the Arduino-IDE. About flash size on the module The AutoConnect sketch size is relatively large. Large flash capacity is necessary. 512Kbyte (4Mbits) flash inclusion module such as ESP-01 is not recommended.","title":"Supported hardware"},{"location":"index.html#required-libraries","text":"AutoConnect requires the following environment and libraries. Arduino IDE The current upstream at the 1.8 level or later is needed. Please install from the official Arduino IDE download page . This step is not required if you already have a modern version. ESP8266 Arduino core AutoConnect targets sketches made on the assumption of ESP8266 Community's Arduino core . Stable 2.4.0 or higher required and the latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. Package URL is http://arduino.esp8266.com/stable/package_esp8266com_index.json ESP32 Arduino core Also, to apply AutoConnect to ESP32, the arduino-esp32 core provided by Espressif is needed. Stable 1.0.1 or required and the latest release is recommended. Install third-party platform using the Boards Manager of Arduino IDE. You can add multiple URLs into Additional Board Manager URLs field, separating them with commas. Package URL is https://dl.espressif.com/dl/package_esp32_index.json for ESP32. Arduino core for ESP32 1.0.3 or later For ESP32, AutoConnect v1.0.0 later is required for arduino-esp32 1.0.3 or later. Additional library (Required) The PageBuilder library to build HTML for ESP8266WebServer is needed. To install the PageBuilder library into your Arduino IDE, you can use the Library Manager . Select the board of ESP8266 series in the Arduino IDE, open the library manager and search keyword ' PageBuilder ' with the topic ' Communication ', then you can see the PageBuilder . The latest version is required 1.3.3 later . 1 Additional library (Optional) By adding the ArduinoJson library, AutoConnect will be able to handle the custom Web pages described with JSON. Since AutoConnect v0.9.7 you can insert user-owned web pages that can consist of representative HTML elements as styled TEXT, INPUT, BUTTON, CHECKBOX, SELECT, SUBMIT and invoke them from the AutoConnect menu. These HTML elements can be added by sketches using the AutoConnect API. Further it possible importing the custom Web pages declarations described with JSON which stored in PROGMEM, SPIFFS, or SD. ArduinoJson is required to use this feature. 2 AutoConnect can work with ArduinoJson both version 5 and version 6 .","title":"Required libraries"},{"location":"index.html#install-the-autoconnect","text":"Clone or download from the AutoConnect GitHub repository . When you select Download, you can import it to Arduino IDE immediately. After downloaded, the AutoConnect-master.zip file will be saved in your download folder. Then in the Arduino IDE, navigate to \"Sketch > Include Library\" . At the top of the drop down list, select the option to \"Add .ZIP Library...\" . Details for Arduino official page . Supported by Library manager. AutoConnect was added to the Arduino IDE library manager. It can be used with the PlatformIO library also. window.onload = function() { Gifffer(); }; Since AutoConnect v0.9.8, PageBuilder v1.3.3 later is required. \u21a9 Using the AutoConnect API natively allows you to sketch custom Web pages without JSON. \u21a9","title":"Install the AutoConnect"},{"location":"acelements.html","text":"The elements for the custom Web pages \u00b6 Representative HTML elements for making the custom Web page are provided as AutoConnectElements. AutoConnectButton : Labeled action button AutoConnectCheckbox : Labeled checkbox AutoConnectElement : General tag AutoConnectFile : File uploader AutoConnectInput : Labeled text input box AutoConnectRadio : Labeled radio button AutoConnectSelect : Selection list AutoConnectStyle : Custom CSS code AutoConnectSubmit : Submit button AutoConnectText : Style attributed text Layout on a custom Web page \u00b6 AutoConnect will not actively be involved in the layout of custom Web pages generated from AutoConnectElements. However, each element has an attribute to arrange placement on a custom web page by horizontally or vertically. Custom CSS for a custom Web page \u00b6 All custom Web page styles are limited to the built-in unique CSS embedded in the library code. Direct modification of the CSS affects AutoConnect behavior. You can use dedicated elements to relatively safely modify the style of your custom Web page. The AutoConnectStyle will insert the raw CSS code into the style block in HTML of the custom Web page. Form and AutoConnectElements \u00b6 All AutoConnectElements placed on custom web pages will be contained into one form. Its form is fixed and created by AutoConnect. The form value (usually the text or checkbox you entered) is sent by AutoConnectSubmit using the POST method with HTTP. The post method sends the actual form data which is a query string whose contents are the name and value of AutoConnectElements. You can retrieve the value for the parameter with the sketch from the query string with ESP8266WebServer::arg function or PageArgument class of the AutoConnect::on handler when the form is submitted. AutoConnectElement - A basic class of elements \u00b6 AutoConnectElement is a base class for other element classes and has common attributes for all elements. It can also be used as a variant of each element. The following items are attributes that AutoConnectElement has and are common to other elements. Sample AutoConnectElement element(\"element\", \"<hr>\"); On the page: Constructor \u00b6 AutoConnectElement( const char * name, const char * value, const ACPosterior_t post) name \u00b6 Each element has a name. The name is the String data type. You can identify each element by the name to access it with sketches. value \u00b6 The value is the string which is a source to generate an HTML code. Characteristics of Value vary depending on the element. The value of AutoConnectElement is native HTML code. A string of value is output as HTML as it is. post \u00b6 The post specifies a tag to add behind the HTML code generated from the element. Its purpose is to place elements on the custom Web page as intended by the user sketch. AutoConnect will not actively be involved in the layout of custom Web pages generated from AutoConnectElements. Each element follows behind the previous one, with the exception of some elements. You can use the post value to arrange vertically or horizontal when the elements do not have the intended position on the custom Web Page specifying the following enumeration value as ACPosterior_t type for the post . AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. The default interpretation of the post value is specific to each element. AutoConnectElements Default interpretation of the post value AutoConnectElement AC_Tag_None AutoConnectButton AC_Tag_None AutoConnectCheckBox AC_Tag_BR AutoConnectFile AC_Tag_BR AutoConnectInput AC_Tag_BR AutoConnectRadio AC_Tag_BR AutoConnectSelect AC_Tag_BR AutoConnectSubmit AC_Tag_None AutoConnectText AC_Tag_None type \u00b6 The type indicates the type of the element and represented as the ACElement_t enumeration type in the sketch. Since AutoConnectElement also acts as a variant of other elements, it can be applied to handle elements collectively. At that time, the type can be referred to by the typeOf() function. The following example changes the font color of all AutoConnectText elements of a custom Web page to gray. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.typeOf() == AC_Text) { AutoConnectText & text = reinterpret_cast < AutoConnectText &> (elm); text.style = \"color:gray;\" ; } } The enumerators for ACElement_t are as follows: AutoConnectButton: AC_Button AutoConnectCheckbox: AC_Checkbox AutoConnectElement: AC_Element AutoConnectFile: AC_File AutoConnectInput: AC_Input AutoConnectRadio: AC_Radio AutoConnectSelect: AC_Select AutoConnectStyle: AC_Style AutoConnectSubmit: AC_Submit AutoConnectText: AC_Text Uninitialized element: AC_Unknown Furthermore, to convert an entity that is not an AutoConnectElement to its native type, you must re-interpret that type with c++. Or, you can be coding the sketch more easily with using the as<T> function. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.type() == AC_Text) { AutoConnectText & text = customPage[elm.name].as < AutoConnectText > (); text.style = \"color:gray;\" ; // Or, it is also possible to write the code further reduced as follows. // customPage[elm.name].as<AutoConnectText>().style = \"color:gray;\"; } } AutoConnectButton \u00b6 AutoConnectButton generates an HTML < button type = \"button\" > tag and locates a clickable button to a custom Web page. Currently AutoConnectButton corresponds only to name, value, an onclick attribute of HTML button tag. An onclick attribute is generated from an action member variable of the AutoConnectButton, which is mostly used with a JavaScript to activate a script. Sample AutoConnectButton button(\"button\", \"OK\", \"myFunction()\"); On the page: Constructor \u00b6 AutoConnectButton( const char * name, const char * value, const String & action, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectButton element and matches the name attribute of the button tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a value of the value attribute of an HTML button tag. action \u00b6 action is String data type and is an onclick attribute fire on a mouse click on the element. It is mostly used with a JavaScript to activate a script. 1 For example, the following code defines a custom Web page that copies a content of Text1 to Text2 by clicking Button . const char * scCopyText = R\"( <script> function CopyText() { document.getElementById(\"Text2\").value = document.getElementById(\"Text1\").value; } </script> )\" ; ACInput(Text1, \"Text1\" ); ACInput(Text2, \"Text2\" ); ACButton(Button, \"COPY\" , \"CopyText()\" ); ACElement(TextCopy, scCopyText); post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None . AutoConnectCheckbox \u00b6 AutoConnectCheckbox generates an HTML < input type = \"checkbox\" > tag and a < label > tag. It places horizontally on a custom Web page by default. Sample AutoConnectCheckbox checkbox(\"checkbox\", \"uniqueapid\", \"Use APID unique\", false); On the page: Constructor \u00b6 AutoConnectCheckbox( const char * name, const char * value, const char * label, const bool checked, const ACPosition_t labelPosition, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectCheckbox element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a value of the value attribute of an HTML < input type = \"checkbox\" > tag. label \u00b6 A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML <label> tag with an id attribute. The checkbox and the label are connected by the id attribute. Only will be displayed if a label is not specified. checked \u00b6 A checked is a Boolean value and indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent. labelPosition \u00b6 The position of the label belonging to the checkbox can be specified around the element. The labelPosition specifies the position of the label to generate with ACPostion_t enumeration value. The default value is AC_Behind . AC_Infront : Place a label in front of the check box. AC_Behind : Place a label behind the check box. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectFile \u00b6 AutoConnectFile generates an HTML < input type = \"file\" > tag and a < label > tag. AutoConnectFile enables file upload from the client through the web browser to ESP8266/ESP32 module. You can select the flash in the module, external SD device or any output destination as the storage of the uploaded file. Sample AutoConnectFile file(\"file\", \"\", \"Upload:\", AC_File_FS) On the page: Constructor \u00b6 AutoConnectFile( const char * name, const char * value, const char * label, const ACFile_t store, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectFile element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 File name to be upload. The value contains the value entered by the client browser to the < input type = \"file\" > tag and is read-only. Even If you give a value to the constructor, it does not affect as an initial value like a default file name. label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. store \u00b6 Specifies the destination to save the uploaded file. The destination can be specified the following values \u200b\u200bin the ACFile_t enumeration type. AC_File_FS : Save as the SPIFFS file in flash of ESP8266/ESP32 module. AC_File_SD : Save to an external SD device connected to ESP8266/ESP32 module. AC_File_Extern : Pass the content of the uploaded file to the uploader which is declared by the sketch individually. Its uploader must inherit AutoConnectUploadHandler class and implements _open , _write and _close function. Built-in uploader is ready. AutoConnect already equips the built-in uploader for saving to the SPIFFS as AC_File_FS and the external SD as AC_File_SD. It is already implemented inside AutoConnect and will store uploaded file automatically. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectInput \u00b6 AutoConnectInput generates an HTML < input type = \"text\" > tag and a < label > tag. It can also have a placeholder. The value of the input box is passed to the destination in the query string and can be retrieved programmatically. You can also update from the sketches. Sample AutoConnectInput input(\"input\", \"\", \"Server\", \"MQTT broker server\"); On the page: Constructor \u00b6 AutoConnectInput( const char * name, const char * value, const char * label, const char * pattern, const char * placeholder, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectInput element and matches the name attribute, the id attribute of the input tag. It also becomes the parameter name of the query string when submitted. value \u00b6 It becomes a string value of the value attribute of an HTML < input type = \"text\" > tag. The text entered from the custom Web page will be grouped in the query string of the form submission and the string set before accessing the page will be displayed as the initial value. label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. pattern \u00b6 A pattern specifies a regular expression that the AutoConnectInput element's value is checked against on form submission. If it is invalid, the background color will change, but it will be sent even if the data format does not match. To check whether the entered value matches the pattern, use the isValid function. The password that must contain 8 or more characters that are of at least one number, and one uppercase and lowercase letter: (?=.*\\d)(?=.*[a-z])(?=.*[A-Z]).{8,} Email address as characters@characters.domain : [a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,} IP address: (([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5]) Host name of Internet: (([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9]) Date (MM/DD/YYYY) as range 1900-2099: (0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d Twitter account: ^@?(\\w){1,15}$ placeholder \u00b6 A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectRadio \u00b6 AutoConnectRadio generates few HTML < input type = \"radio\" > tags as grouped and the same number of < label > tags. AutoConnectRadio can keep the value of a radio button as a collection. The grouped values will be placed in the custom Web page to select only one exclusively. Sample AutoConnectRadio radio(\"radio\", { \"30 sec.\", \"60 sec.\", \"180 sec.\" }, \"Update period\", AC_Vertical, 1); On the page: Constructor \u00b6 AutoConnectRadio( const char * name, std :: vector < String > const & values, const char * label, const ACArrange_t order, const uint8_t checked, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectRadio element and matches the name attribute of the input tags. It also becomes the parameter name of the query string when submitted. values \u00b6 A values is an array of String type for the radio button options which as actually std::vector . It is an initialization list can be used. The input tags will be generated from each entry in the values, the amount of which is the same as the number of items in values . label \u00b6 A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Specification of a label will generate an HTML < label > tag with an id attribute. The radio buttons and the label are connected by the id attribute. order \u00b6 A order specifies the direction to arrange the radio buttons. It is a value of type ACArrange_t and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. A label will place in the left or the top according to the order . checked \u00b6 A checked specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectStyle \u00b6 AutoConnectStyle inserts the string given by the value into the style block of a custom Web page as it is raw. The validity as CSS will not be checked AutoConnectStyle does not do syntax checking and semantic analysis of value. Insert the specified string into the style block of the custom Web page without processing it. Therefore, specifying the wrong CSS will modulate the behavior of the custom Web page. Constructor \u00b6 AutoConnectStyle( const char * name, const char * value) name \u00b6 It is the name of the AutoConnectStyle element and is useful only to access this element from the sketch. It does not affect the generated HTML code. value \u00b6 The raw CSS code. It is not necessary to write <style> </style> tags. AutoConnectSelect \u00b6 AutoConnectSelect generates an HTML < select > tag (drop-down list) and few < option > tags. Sample AutoConnectSelect select(\"select\", { String(\"Europe/London\"), String(\"Europe/Berlin\"), String(\"Europe/Helsinki\"), String(\"Europe/Moscow\"), String(\"Asia/Dubai\") }, \"Select TZ name\"); On the page: Constructor \u00b6 AutoConnectSelect( const char * name, std :: vector < String > const & options, const char * label, const uint8_t selected, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectSelect element and matches the name attribute of the select tags. options \u00b6 An options is an array of String type for the options which as actually std::vector for an HTML < option > tag. It is an initialization list can be used. The option tags will be generated from each entry in the options, the amount of which is the same as the number of items in an options . label \u00b6 A label is an optional string. A label is always arranged on the left side of the drop-down list. Specification of a label will generate an HTML < label > tag with an id attribute. The select tag and the label are connected by the id attribute. selected \u00b6 A selected is an optional value. Specifies that an option should be pre-selected when the page loads. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR . AutoConnectSubmit \u00b6 AutoConnectSubmit generates an HTML < input type = \"button\" > tag attached onclick attribute. The native code of the onclick attribute is the submission of the form with the POST method. Sample AutoConnectSubmit submit(\"submit\", \"Save\", \"/mqtt_save\"); On the page: Constructor \u00b6 AutoConnectSubmit( const char * name, const char * value, const char * uri, const ACPosterior_t post) name \u00b6 It is the name of the AutoConnectSubmit element and matches the name attribute of the input tag. value \u00b6 It becomes a string of the value attribute of an HTML < input type = \"button\" > tag. The value will be displayed as a label of the button. uri \u00b6 A uri specifies the URI to send form data when the button declared by AutoConnectSubmit is clicked. The query string of the form data sent with AutoConnectSubmit contains the URI of the page. Its parameter name is _acuri . In Sketch, you can know the called URI by referring to the _acuri parameter with the destination page handler. The actual query string is as follows: _acuri= CALLER_URI post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None . AutoConnectText \u00b6 AutoConnectText generates an HTML < div > tag. A style attribute will be attached if a style parameter is passed. Sample AutoConnectText text(\"text\", \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\", \"font-family:serif;color:#4682b4;\"); On the page: Constructor \u00b6 AutoConnectText( const char * name, const char * value, const char * style, const char * format, const ACPosterior_t post) name \u00b6 A name does not exist in the generated HTML. It provides only a means of accessing elements with the sketches. value \u00b6 It becomes content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style \u00b6 A style specifies the qualification style to give to the content and can use the style attribute format as it is. format \u00b6 A format is a pointer to a null-terminated multi byte string specifying how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to C-style printf library functions, but depends on the Espressif's SDK implementation. The conversion specification is valid only in %s format. (Left and Right justification, width are also valid.) post \u00b6 Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None . How to coding for the elements \u00b6 Declaration for the elements in Sketches \u00b6 Variables of each AutoConnetElement can be declared with macros. By using the macros, you can treat element name that is String type as variable in sketches. 2 ACElement ( name [ , value ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACButton ( name [ , value ] [ , action ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACCheckbox ( name [ , value ] [ , label ] [ , true | false ] [ , AC_Infront | AC_Behind ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACFile ( name [ , value ] [ , label ] [ , AC_File_FS | AC_File_SD | AC_File_Extern ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACInput ( name [ , value ] [ , label ] [ , pattern ] [ , placeholder ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACRadio ( name [ , values ] [ , label ] [ , AC_Horizontal | AC_Vertical ] [ , checked ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACSelect ( name [ , options ] [ , label ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACStyle ( name [ , value ] ) ACSubmit ( name [ , value ] [ , uri ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACText ( name [ , value ] [ , style ] [ , format ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) Declaration macro usage For example, AutoConnectText can be declared using macros. AutoConnectText caption( \"caption\" , \"hello, world\" , \"color:blue;\" ) equals by using ACText macro. ACText(caption, \"hello, world\" , \"color:blue;\" ) Variant for AutoConnectElements \u00b6 Some AutoConnectAux APIs specify AutoConnectElements as an argument. There are also functions that return a pointer to AutoConnectElements. AutoConnectElement behaves as a variant type of each element class to make these interfaces a single. Use reinterpret_cast to cast from a variant pointer to an Actual type pointer of AutoConnectElements. AutoConnectAux aux; ACText(Text1, \"hello, world\" ); aux.add(Text1); AutoConnectText * text_p = reinterpret_cast < AutoConnectText *> (aux.getElement( \"Text1\" )); AutoConnectText & text = aux.getElement < AutoConnectText > ( \"Text1\" ); JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9 The square brackets in the syntax are optional parameters, the stroke is a selection parameter, the bold fonts are literal. \u21a9","title":"AutoConnectElements"},{"location":"acelements.html#the-elements-for-the-custom-web-pages","text":"Representative HTML elements for making the custom Web page are provided as AutoConnectElements. AutoConnectButton : Labeled action button AutoConnectCheckbox : Labeled checkbox AutoConnectElement : General tag AutoConnectFile : File uploader AutoConnectInput : Labeled text input box AutoConnectRadio : Labeled radio button AutoConnectSelect : Selection list AutoConnectStyle : Custom CSS code AutoConnectSubmit : Submit button AutoConnectText : Style attributed text","title":"The elements for the custom Web pages"},{"location":"acelements.html#layout-on-a-custom-web-page","text":"AutoConnect will not actively be involved in the layout of custom Web pages generated from AutoConnectElements. However, each element has an attribute to arrange placement on a custom web page by horizontally or vertically.","title":"Layout on a custom Web page"},{"location":"acelements.html#custom-css-for-a-custom-web-page","text":"All custom Web page styles are limited to the built-in unique CSS embedded in the library code. Direct modification of the CSS affects AutoConnect behavior. You can use dedicated elements to relatively safely modify the style of your custom Web page. The AutoConnectStyle will insert the raw CSS code into the style block in HTML of the custom Web page.","title":"Custom CSS for a custom Web page"},{"location":"acelements.html#form-and-autoconnectelements","text":"All AutoConnectElements placed on custom web pages will be contained into one form. Its form is fixed and created by AutoConnect. The form value (usually the text or checkbox you entered) is sent by AutoConnectSubmit using the POST method with HTTP. The post method sends the actual form data which is a query string whose contents are the name and value of AutoConnectElements. You can retrieve the value for the parameter with the sketch from the query string with ESP8266WebServer::arg function or PageArgument class of the AutoConnect::on handler when the form is submitted.","title":"Form and AutoConnectElements"},{"location":"acelements.html#autoconnectelement-a-basic-class-of-elements","text":"AutoConnectElement is a base class for other element classes and has common attributes for all elements. It can also be used as a variant of each element. The following items are attributes that AutoConnectElement has and are common to other elements. Sample AutoConnectElement element(\"element\", \"<hr>\"); On the page:","title":"AutoConnectElement - A basic class of elements"},{"location":"acelements.html#constructor","text":"AutoConnectElement( const char * name, const char * value, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name","text":"Each element has a name. The name is the String data type. You can identify each element by the name to access it with sketches.","title":" name"},{"location":"acelements.html#value","text":"The value is the string which is a source to generate an HTML code. Characteristics of Value vary depending on the element. The value of AutoConnectElement is native HTML code. A string of value is output as HTML as it is.","title":" value"},{"location":"acelements.html#post","text":"The post specifies a tag to add behind the HTML code generated from the element. Its purpose is to place elements on the custom Web page as intended by the user sketch. AutoConnect will not actively be involved in the layout of custom Web pages generated from AutoConnectElements. Each element follows behind the previous one, with the exception of some elements. You can use the post value to arrange vertically or horizontal when the elements do not have the intended position on the custom Web Page specifying the following enumeration value as ACPosterior_t type for the post . AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. The default interpretation of the post value is specific to each element. AutoConnectElements Default interpretation of the post value AutoConnectElement AC_Tag_None AutoConnectButton AC_Tag_None AutoConnectCheckBox AC_Tag_BR AutoConnectFile AC_Tag_BR AutoConnectInput AC_Tag_BR AutoConnectRadio AC_Tag_BR AutoConnectSelect AC_Tag_BR AutoConnectSubmit AC_Tag_None AutoConnectText AC_Tag_None","title":" post"},{"location":"acelements.html#type","text":"The type indicates the type of the element and represented as the ACElement_t enumeration type in the sketch. Since AutoConnectElement also acts as a variant of other elements, it can be applied to handle elements collectively. At that time, the type can be referred to by the typeOf() function. The following example changes the font color of all AutoConnectText elements of a custom Web page to gray. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.typeOf() == AC_Text) { AutoConnectText & text = reinterpret_cast < AutoConnectText &> (elm); text.style = \"color:gray;\" ; } } The enumerators for ACElement_t are as follows: AutoConnectButton: AC_Button AutoConnectCheckbox: AC_Checkbox AutoConnectElement: AC_Element AutoConnectFile: AC_File AutoConnectInput: AC_Input AutoConnectRadio: AC_Radio AutoConnectSelect: AC_Select AutoConnectStyle: AC_Style AutoConnectSubmit: AC_Submit AutoConnectText: AC_Text Uninitialized element: AC_Unknown Furthermore, to convert an entity that is not an AutoConnectElement to its native type, you must re-interpret that type with c++. Or, you can be coding the sketch more easily with using the as<T> function. AutoConnectAux customPage; AutoConnectElementVT & elements = customPage.getElements(); for (AutoConnectElement & elm : elements) { if (elm.type() == AC_Text) { AutoConnectText & text = customPage[elm.name].as < AutoConnectText > (); text.style = \"color:gray;\" ; // Or, it is also possible to write the code further reduced as follows. // customPage[elm.name].as<AutoConnectText>().style = \"color:gray;\"; } }","title":" type"},{"location":"acelements.html#autoconnectbutton","text":"AutoConnectButton generates an HTML < button type = \"button\" > tag and locates a clickable button to a custom Web page. Currently AutoConnectButton corresponds only to name, value, an onclick attribute of HTML button tag. An onclick attribute is generated from an action member variable of the AutoConnectButton, which is mostly used with a JavaScript to activate a script. Sample AutoConnectButton button(\"button\", \"OK\", \"myFunction()\"); On the page:","title":"AutoConnectButton"},{"location":"acelements.html#constructor_1","text":"AutoConnectButton( const char * name, const char * value, const String & action, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_1","text":"It is the name of the AutoConnectButton element and matches the name attribute of the button tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_1","text":"It becomes a value of the value attribute of an HTML button tag.","title":" value"},{"location":"acelements.html#action","text":"action is String data type and is an onclick attribute fire on a mouse click on the element. It is mostly used with a JavaScript to activate a script. 1 For example, the following code defines a custom Web page that copies a content of Text1 to Text2 by clicking Button . const char * scCopyText = R\"( <script> function CopyText() { document.getElementById(\"Text2\").value = document.getElementById(\"Text1\").value; } </script> )\" ; ACInput(Text1, \"Text1\" ); ACInput(Text2, \"Text2\" ); ACButton(Button, \"COPY\" , \"CopyText()\" ); ACElement(TextCopy, scCopyText);","title":" action"},{"location":"acelements.html#post_1","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None .","title":" post"},{"location":"acelements.html#autoconnectcheckbox","text":"AutoConnectCheckbox generates an HTML < input type = \"checkbox\" > tag and a < label > tag. It places horizontally on a custom Web page by default. Sample AutoConnectCheckbox checkbox(\"checkbox\", \"uniqueapid\", \"Use APID unique\", false); On the page:","title":"AutoConnectCheckbox"},{"location":"acelements.html#constructor_2","text":"AutoConnectCheckbox( const char * name, const char * value, const char * label, const bool checked, const ACPosition_t labelPosition, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_2","text":"It is the name of the AutoConnectCheckbox element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_2","text":"It becomes a value of the value attribute of an HTML < input type = \"checkbox\" > tag.","title":" value"},{"location":"acelements.html#label","text":"A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML <label> tag with an id attribute. The checkbox and the label are connected by the id attribute. Only will be displayed if a label is not specified.","title":" label"},{"location":"acelements.html#checked","text":"A checked is a Boolean value and indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent.","title":" checked"},{"location":"acelements.html#labelposition","text":"The position of the label belonging to the checkbox can be specified around the element. The labelPosition specifies the position of the label to generate with ACPostion_t enumeration value. The default value is AC_Behind . AC_Infront : Place a label in front of the check box. AC_Behind : Place a label behind the check box.","title":" labelPosition"},{"location":"acelements.html#post_2","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectfile","text":"AutoConnectFile generates an HTML < input type = \"file\" > tag and a < label > tag. AutoConnectFile enables file upload from the client through the web browser to ESP8266/ESP32 module. You can select the flash in the module, external SD device or any output destination as the storage of the uploaded file. Sample AutoConnectFile file(\"file\", \"\", \"Upload:\", AC_File_FS) On the page:","title":"AutoConnectFile"},{"location":"acelements.html#constructor_3","text":"AutoConnectFile( const char * name, const char * value, const char * label, const ACFile_t store, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_3","text":"It is the name of the AutoConnectFile element and matches the name attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_3","text":"File name to be upload. The value contains the value entered by the client browser to the < input type = \"file\" > tag and is read-only. Even If you give a value to the constructor, it does not affect as an initial value like a default file name.","title":" value"},{"location":"acelements.html#label_1","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#store","text":"Specifies the destination to save the uploaded file. The destination can be specified the following values \u200b\u200bin the ACFile_t enumeration type. AC_File_FS : Save as the SPIFFS file in flash of ESP8266/ESP32 module. AC_File_SD : Save to an external SD device connected to ESP8266/ESP32 module. AC_File_Extern : Pass the content of the uploaded file to the uploader which is declared by the sketch individually. Its uploader must inherit AutoConnectUploadHandler class and implements _open , _write and _close function. Built-in uploader is ready. AutoConnect already equips the built-in uploader for saving to the SPIFFS as AC_File_FS and the external SD as AC_File_SD. It is already implemented inside AutoConnect and will store uploaded file automatically.","title":" store"},{"location":"acelements.html#post_3","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectinput","text":"AutoConnectInput generates an HTML < input type = \"text\" > tag and a < label > tag. It can also have a placeholder. The value of the input box is passed to the destination in the query string and can be retrieved programmatically. You can also update from the sketches. Sample AutoConnectInput input(\"input\", \"\", \"Server\", \"MQTT broker server\"); On the page:","title":"AutoConnectInput"},{"location":"acelements.html#constructor_4","text":"AutoConnectInput( const char * name, const char * value, const char * label, const char * pattern, const char * placeholder, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_4","text":"It is the name of the AutoConnectInput element and matches the name attribute, the id attribute of the input tag. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#value_4","text":"It becomes a string value of the value attribute of an HTML < input type = \"text\" > tag. The text entered from the custom Web page will be grouped in the query string of the form submission and the string set before accessing the page will be displayed as the initial value.","title":" value"},{"location":"acelements.html#label_2","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#pattern","text":"A pattern specifies a regular expression that the AutoConnectInput element's value is checked against on form submission. If it is invalid, the background color will change, but it will be sent even if the data format does not match. To check whether the entered value matches the pattern, use the isValid function. The password that must contain 8 or more characters that are of at least one number, and one uppercase and lowercase letter: (?=.*\\d)(?=.*[a-z])(?=.*[A-Z]).{8,} Email address as characters@characters.domain : [a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,} IP address: (([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5]) Host name of Internet: (([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9]) Date (MM/DD/YYYY) as range 1900-2099: (0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d Twitter account: ^@?(\\w){1,15}$","title":" pattern"},{"location":"acelements.html#placeholder","text":"A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag.","title":" placeholder"},{"location":"acelements.html#post_4","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectradio","text":"AutoConnectRadio generates few HTML < input type = \"radio\" > tags as grouped and the same number of < label > tags. AutoConnectRadio can keep the value of a radio button as a collection. The grouped values will be placed in the custom Web page to select only one exclusively. Sample AutoConnectRadio radio(\"radio\", { \"30 sec.\", \"60 sec.\", \"180 sec.\" }, \"Update period\", AC_Vertical, 1); On the page:","title":"AutoConnectRadio"},{"location":"acelements.html#constructor_5","text":"AutoConnectRadio( const char * name, std :: vector < String > const & values, const char * label, const ACArrange_t order, const uint8_t checked, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_5","text":"It is the name of the AutoConnectRadio element and matches the name attribute of the input tags. It also becomes the parameter name of the query string when submitted.","title":" name"},{"location":"acelements.html#values","text":"A values is an array of String type for the radio button options which as actually std::vector . It is an initialization list can be used. The input tags will be generated from each entry in the values, the amount of which is the same as the number of items in values .","title":" values"},{"location":"acelements.html#label_3","text":"A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Specification of a label will generate an HTML < label > tag with an id attribute. The radio buttons and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#order","text":"A order specifies the direction to arrange the radio buttons. It is a value of type ACArrange_t and accepts one of the following: AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. A label will place in the left or the top according to the order .","title":" order"},{"location":"acelements.html#checked_1","text":"A checked specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked.","title":" checked"},{"location":"acelements.html#post_5","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectstyle","text":"AutoConnectStyle inserts the string given by the value into the style block of a custom Web page as it is raw. The validity as CSS will not be checked AutoConnectStyle does not do syntax checking and semantic analysis of value. Insert the specified string into the style block of the custom Web page without processing it. Therefore, specifying the wrong CSS will modulate the behavior of the custom Web page.","title":"AutoConnectStyle"},{"location":"acelements.html#constructor_6","text":"AutoConnectStyle( const char * name, const char * value)","title":" Constructor"},{"location":"acelements.html#name_6","text":"It is the name of the AutoConnectStyle element and is useful only to access this element from the sketch. It does not affect the generated HTML code.","title":" name"},{"location":"acelements.html#value_5","text":"The raw CSS code. It is not necessary to write <style> </style> tags.","title":" value"},{"location":"acelements.html#autoconnectselect","text":"AutoConnectSelect generates an HTML < select > tag (drop-down list) and few < option > tags. Sample AutoConnectSelect select(\"select\", { String(\"Europe/London\"), String(\"Europe/Berlin\"), String(\"Europe/Helsinki\"), String(\"Europe/Moscow\"), String(\"Asia/Dubai\") }, \"Select TZ name\"); On the page:","title":"AutoConnectSelect"},{"location":"acelements.html#constructor_7","text":"AutoConnectSelect( const char * name, std :: vector < String > const & options, const char * label, const uint8_t selected, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_7","text":"It is the name of the AutoConnectSelect element and matches the name attribute of the select tags.","title":" name"},{"location":"acelements.html#options","text":"An options is an array of String type for the options which as actually std::vector for an HTML < option > tag. It is an initialization list can be used. The option tags will be generated from each entry in the options, the amount of which is the same as the number of items in an options .","title":" options"},{"location":"acelements.html#label_4","text":"A label is an optional string. A label is always arranged on the left side of the drop-down list. Specification of a label will generate an HTML < label > tag with an id attribute. The select tag and the label are connected by the id attribute.","title":" label"},{"location":"acelements.html#selected","text":"A selected is an optional value. Specifies that an option should be pre-selected when the page loads.","title":" selected"},{"location":"acelements.html#post_6","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_BR .","title":" post"},{"location":"acelements.html#autoconnectsubmit","text":"AutoConnectSubmit generates an HTML < input type = \"button\" > tag attached onclick attribute. The native code of the onclick attribute is the submission of the form with the POST method. Sample AutoConnectSubmit submit(\"submit\", \"Save\", \"/mqtt_save\"); On the page:","title":"AutoConnectSubmit"},{"location":"acelements.html#constructor_8","text":"AutoConnectSubmit( const char * name, const char * value, const char * uri, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_8","text":"It is the name of the AutoConnectSubmit element and matches the name attribute of the input tag.","title":" name"},{"location":"acelements.html#value_6","text":"It becomes a string of the value attribute of an HTML < input type = \"button\" > tag. The value will be displayed as a label of the button.","title":" value"},{"location":"acelements.html#uri","text":"A uri specifies the URI to send form data when the button declared by AutoConnectSubmit is clicked. The query string of the form data sent with AutoConnectSubmit contains the URI of the page. Its parameter name is _acuri . In Sketch, you can know the called URI by referring to the _acuri parameter with the destination page handler. The actual query string is as follows: _acuri= CALLER_URI","title":" uri"},{"location":"acelements.html#post_7","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None .","title":" post"},{"location":"acelements.html#autoconnecttext","text":"AutoConnectText generates an HTML < div > tag. A style attribute will be attached if a style parameter is passed. Sample AutoConnectText text(\"text\", \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\", \"font-family:serif;color:#4682b4;\"); On the page:","title":"AutoConnectText"},{"location":"acelements.html#constructor_9","text":"AutoConnectText( const char * name, const char * value, const char * style, const char * format, const ACPosterior_t post)","title":" Constructor"},{"location":"acelements.html#name_9","text":"A name does not exist in the generated HTML. It provides only a means of accessing elements with the sketches.","title":" name"},{"location":"acelements.html#value_7","text":"It becomes content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag.","title":" value"},{"location":"acelements.html#style","text":"A style specifies the qualification style to give to the content and can use the style attribute format as it is.","title":" style"},{"location":"acelements.html#format","text":"A format is a pointer to a null-terminated multi byte string specifying how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to C-style printf library functions, but depends on the Espressif's SDK implementation. The conversion specification is valid only in %s format. (Left and Right justification, width are also valid.)","title":" format"},{"location":"acelements.html#post_8","text":"Specifies a tag to add behind the HTML code generated from the element. The default values is AC_Tag_None .","title":" post"},{"location":"acelements.html#how-to-coding-for-the-elements","text":"","title":"How to coding for the elements"},{"location":"acelements.html#declaration-for-the-elements-in-sketches","text":"Variables of each AutoConnetElement can be declared with macros. By using the macros, you can treat element name that is String type as variable in sketches. 2 ACElement ( name [ , value ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACButton ( name [ , value ] [ , action ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACCheckbox ( name [ , value ] [ , label ] [ , true | false ] [ , AC_Infront | AC_Behind ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACFile ( name [ , value ] [ , label ] [ , AC_File_FS | AC_File_SD | AC_File_Extern ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACInput ( name [ , value ] [ , label ] [ , pattern ] [ , placeholder ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACRadio ( name [ , values ] [ , label ] [ , AC_Horizontal | AC_Vertical ] [ , checked ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACSelect ( name [ , options ] [ , label ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACStyle ( name [ , value ] ) ACSubmit ( name [ , value ] [ , uri ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) ACText ( name [ , value ] [ , style ] [ , format ] [ , AC_Tag_None | AC_Tag_BR | AC_Tag_P ] ) Declaration macro usage For example, AutoConnectText can be declared using macros. AutoConnectText caption( \"caption\" , \"hello, world\" , \"color:blue;\" ) equals by using ACText macro. ACText(caption, \"hello, world\" , \"color:blue;\" )","title":" Declaration for the elements in Sketches"},{"location":"acelements.html#variant-for-autoconnectelements","text":"Some AutoConnectAux APIs specify AutoConnectElements as an argument. There are also functions that return a pointer to AutoConnectElements. AutoConnectElement behaves as a variant type of each element class to make these interfaces a single. Use reinterpret_cast to cast from a variant pointer to an Actual type pointer of AutoConnectElements. AutoConnectAux aux; ACText(Text1, \"hello, world\" ); aux.add(Text1); AutoConnectText * text_p = reinterpret_cast < AutoConnectText *> (aux.getElement( \"Text1\" )); AutoConnectText & text = aux.getElement < AutoConnectText > ( \"Text1\" ); JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9 The square brackets in the syntax are optional parameters, the stroke is a selection parameter, the bold fonts are literal. \u21a9","title":" Variant for AutoConnectElements"},{"location":"achandling.html","text":"Page, Container, Component \u00b6 AutoConnectAux is the container for a custom Web page, AutoConnectElement is the component of a page. AutoConnectElements must be contained in AutoConnectAux object. (ie. they are the elements displayed on the custom Web page.) Then AutoConnect makes an AutoConnectAux to a page. AutoConnectElements declared in sketch must be programmed to add to AutoConnectAux one after another. Elements are automatically included in AutoConnectAux by AutoConnect if you load it from the JSON document. In either method, it is common to use the function of AutoConnectAux to access an element with a sketch. Handing AutoConnectElements with the sketches \u00b6 The AutoConnectAux class has several functions to manipulate AutoConnectElements. The functions can add, delete, retrieve elements, and get and set values. Add AutoConnectElements to the AutoConnectAux object \u00b6 To add AutoConnectElment(s) to an AutoConnectAux object, use the add function. void AutoConnectAux :: add(AutoConnectElement & addon) void AutoConnectAux :: add(AutoConnectElementVT addons) The add function adds the specified AutoConnectElement to AutoConnectAux. The AutoConnectElementVT type is the std::vector of the reference wrapper to AutoConnectElements, and you can add these elements in bulk by using the list initialization with the sketch. typedef std :: vector < std :: reference_wrapper < AutoConnectElement >> AutoConnectElementVT; AutoConnectElements contained in AutoConnectAux object are uniquely identified by name. When adding an AutoConnectElement, if an element with the same name already exists in the AutoConnectAux, checking the type, and if it is the same, the value will be replaced. If another type of AutoConnectElement exists with the same name, that add operation will be invalid. 1 In the following example, AutoConnectButton button addition will invalid because hello with the same name already exists as AutoConnectText. AutoConnectAux aux; AutoConnectText text ( \"hello\" , \"hello, world\" ); AutoConnectButton button ( \"hello\" , \"hello, world\" , \"alert('Hello world!')\") ; // This is invalid. aux.add({ text, button }); Similarly this, the uniqueness of the name is also necessary within the JSON document { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true , \"element\" : [ { \"name\" : \"hello\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"hello\" , \"type\" : \"ACButton\" , \"value\" : \"hello, world\" , \"action\" : \"alert('Hello world!')\" } ] } Load all elements from JSON document If you load all AutoConnectElements from JSON document into AutoConnect, you do not need to sketch the population process of the AutoConnectElements. It is managed by the AutoConnect library automatically. Get AutoConnectElement from the AutoConnectAux \u00b6 To retrieve an element from AutoConnectAux, use the getElement or getElements function. Normally, the getElement is needed when accessing the value of AutoConnectElement in the sketch. AutoConnectElement * AutoConnectAux :: getElement( const String & name) T & AutoConnectAux :: getElement < T > ( const String & name) AutoConnectElementVT * AutoConnectAux :: getElements( void ) The getElement function returns an AutoConnectElement with the specified name as a key. When you use this function, you need to know the type of AutoConnectElement in advance and specify its type <T> to an argument of the getElement. A type of <T> can be specified as follows. AutoConnectButton & AutoConnectAux :: getElement < AutoConnectButton > ( const String & name) AutoConnectCheckbox & AutoConnectAux :: getElement < AutoConnectCheckbox > ( const String & name) AutoConnectElement & AutoConnectAux :: getElement < AutoConnectElement > ( const String & name) AutoConnectFile & AutoConnectAux :: getElement < AutoConnectFile > ( const String & name) AutoConnectInput & AutoConnectAux :: getElement < AutoConnectInput > ( const String & name) AutoConnectRadio & AutoConnectAux :: getElement < AutoConnectRadio > ( const String & name) AutoConnectSelect & AutoConnectAux :: getElement < AutoConnectSelect > ( const String & name) AutoConnectSubmit & AutoConnectAux :: getElement < AutoConnectSubmit > ( const String & name) AutoConnectText & AutoConnectAux :: getElement < AutoConnectText > ( const String & name) To retrieve an AutoConnectElement by specifying its type, use the following method. AutoConnectAux aux; aux.load( \"SOME_JSON_DOCUMENT\" ); // Retrieve the pointer of the AutoConnectText AutoConnectText * text = reinterpret_cast < AutoConnectText *> (aux.getElement( \"TEXT_ELEMENT_NAME\" )); // Retrieve the reference of the AutoConnectText AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_ELEMENT_NAME\" ); The AutoConnectElement type behaves as a variant of other element types. Therefore use cast or template to convert to actual type as above. In the sketch, you access the real type of AutoConnectElement after casting it and storing into the variable. const String auxJson = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); AutoConnect portal; portal.load(auxJson); AutoConnectAux * aux = portal.aux( \"/page1\" ); // Identify the AutoConnectAux instance with uri AutoConnectText & text = aux -> getElement < AutoConnectText > ( \"caption\" ); // Cast to real type and access members Serial.println(text.value); You can also use the operator [] of AutoConnectAux as another way to get the desired element. An operator [] is a shortcut for getElement function with the reference casting and makes simplify the sketch code and treats like an array with the elements placed on a custom Web page. Its argument is the name of the element to be acquired similarly to getElement function. In the sketch, by combining the AutoConnectElement::as<T> function with the operator [] , you can access the AutoConnectElements reference according to its actual type. For example, the following sketch code returns the same as a reference of AutoConnectText element as the caption . AutoConnect portal; portal.load(auxJson); AutoConnectAux & aux = * portal.aux( \"/page1\" ); AutoConnectText & text1 = aux.getElement < AutoConnectElement > ( \"caption\" ); AutoConnectText & text2 = aux[ \"caption\" ].as < AutoConnectText > (); Need cast to convert to the actual type An operator [] returns a reference of an AutoConnectElement. It is necessary to convert the type according to the actual element type with AutoConnectElement::as<T> function. AutoConnectButton & AutoConnectElement :: as < AutoConnectButton > () AutoConnectCheckbox & AutoConnectElement :: as < AutoConnectCheckbox > () AutoConnectElement & AutoConnectElement :: as < AutoConnectElement > () AutoConnectFile & AutoConnectElement :: as < AutoConnectFile > () AutoConnectInput & AutoConnectElement :: as < AutoConnectInput > () AutoConnectRadio & AutoConnectElement :: as < AutoConnectRadio > () AutoConnectSelect & AutoConnectElement :: as < AutoConnectSelect > () AutoConnectSubmit & AutoConnectElement :: as < AutoConnectSubmit > () AutoConnectText & AutoConnectElement :: as < AutoConnectText > () To get all the AutoConnectElements in an AutoConnectAux object use the getElements function. This function returns the vector of the reference wrapper as AutoConnectElementVT to all AutoConnectElements registered in the AutoConnectAux. AutoConnectElementVT & AutoConnectAux :: getElements( void ) Enable AutoConnectElements during the sketch execution \u00b6 AutoConnectElemets have an enable attribute to activate its own HTML generation. Sketches can change the HTMLization of their elements dynamically by setting or resetting the enable value. An element whose the enable attribute is true will generate itself HTML and place on the custom Web page. And conversely, it will not generate the HTML when the value is false. For example, to enable the submit button only when the ESP module is connected to the access point in STA mode, you can sketch the following: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char AUX[] PROGMEM = R( \" { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true, \"element\" : [ { \"name\" : \"input\" , \"type\" : \"ACInput\" , \"label\" : \"Input\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/send\" } ] } \"); AutoConnect portal; AutoConnectAux page; String onPage (AutoConectAux & aux, PageArgument & args) { AutoConnectSubmit & send = aux[ \"send\" ].as < AutoConnectSubmit > (); if (WiFi.isConnected()) send.enable = (WiFi.getMode() == WIFI_STA); else send.enable = false; return String(); } void setup () { page.load(AUX); page.on(onPage); portal.join(page); portal.begin(); } void loop () { portal.handleClient(); } Desirable to set or reset the enable attribute in the page handler The enable attribute can be set at any time during the sketch execution. The page handler with the AC_EXIT_AHEAD option is sure to handle it. Loading & saving AutoConnectElements with JSON \u00b6 AutoConnect supports reading the custom Web page definitions written in JSON and also supports loading and saving of AutoConnectAux or AutoConnectElements. In both cases, the target object is a JSON document for AutoConnect . However, it can not save all AutoConnectElements contained in the page as a custom Web page. (ie. AutoConnectAux) Loading AutoConnectAux & AutoConnectElements with JSON \u00b6 To load a JSON document as AutoConnectAux use the AutoConnect::load function and load the JSON document of each AutoConnectElement using the AutoConnectAux::loadElement function. Although the functions of both are similar, the structure of the target JSON document is different. The AutoConnect::load function loads the entire AutoConnectAux and creates both the AutoConnectAux instance and each AutoConnectElement instance. A single JSON document can contain multiple custom Web pages. If you write JSON of AutoConnectAux as an array, the load function generates all the pages contained in that array. Therefore, it is necessary to supply the JSON document of AutoConnectAux as an input of the load function and must contain the elements described section JSON document structure for AutoConnectAux . The AutoConnectAux::loadElement function loads the elements individually into an AutoConnectAux object. The structure of its supplying JSON document is not AutoConnectAux. It must be a JSON structure for AutoConnectElement , but you can specify an array. // AutoConnectAux as a custom Web page. const char page[] PROGMEM = R\"raw( { \"title\": \"Settings\", \"uri\": \"/settings\", \"menu\": true, \"element\": [ { \"name\": \"server\", \"type\": \"ACInput\", \"label\": \"Server\" }, { \"name\": \"set\", \"type\": \"ACSubmit\", \"value\": \"SET\", \"uri\" : \"/set\" } ] } )raw\" ; // Additional AutoConnectElements. const char addons[] PROGMEM = R\"raw( [ { \"name\": \"notes\", \"type\": \"ACText\", \"value\": \"An update period as the below optionally.\" }, { \"name\": \"period\", \"type\": \"ACRadio\", \"value\": [ \"30 sec.\", \"60 sec.\", \"180 sec.\" ], \"arrange\": \"vertical\", \"checked\": 1 } ] )raw\" ; AutoConnect portal; AutoConnectAux * auxPage; // Load a custom Web page. portal.load(page); // Get a '/settings' page auxPage = portal.aux( \"/settings\" ); // Also, load only AutoConnectRadio named the period. auxPage -> loadElement(addons, \"period\" ); // Retrieve a server name from an AutoConnectText value. AutoConnectText & serverName = auxPage -> getElement < AutoConnectText > ( \"server\" ); Serial.println(serverName.value); Saving AutoConnectElements with JSON \u00b6 To save the AutoConnectAux or the AutoConnectElement as a JSON document, use the AutoConnectAux::saveElement function. It serializes the contents of the object based on the type of the AutoConnectElement. You can persist a serialized AutoConnectElements as a JSON document to a stream. // Open a parameter file on the SPIFFS. SPIFFS.begin(); FILE param = SPIFFS.open( \"/param\" , \"w\" ); // Save elements as the parameters. auxPage -> saveElement(param, { \"server\" , \"period\" }); // Close a parameter file. param.close(); SPIFFS.end(); The example above saves server and period elements from the AutoConnectAux object as mentioned above to the /param file on SPIFFS. Its JSON document of AutoConnectElements saved by its code looks like this: [ { \"name\" : \"server\" , \"type\" : \"ACInput\" , \"value\" : \"An inputted server name\" , \"label\" : \"Server\" , \"placeholder\" : \"\" }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"arrange\" : \"vertical\" , \"checked\" : 2 } ] Above JSON document can be loaded as it is into a custom Web page using the loadElement function. The loadElement function also loads the value of the element, so the saved value can be restored on the custom Web page. Custom field data handling \u00b6 A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored in the member variable of each element by AutoConnect whenever GET/POST transmission occurs. The following diagram shows the flow of the input values of a custom Web page into a sketch and is the basis for actions to manipulate the values of custom Web pages using sketches. Where to pick up the values \u00b6 A sketch composed of handlers can receive the value of AutoConnectElements entered in a custom Web page after sending, but that handler is different from the page where the value was entered. It is necessary to be aware that can accept the entered values by the next page handler after the transition. Usually, two ways to retrieve entered values we have. One is to use the ESP8266WebServer::arg (or WebServer::arg for ESP32) function in the on handler attached by ESP8266WebServer (WebServer w/ESP32 also). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char addonJson[] PROGMEM = R\"raw( { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] } )raw\" ; ESP8266WebServer webServer; AutoConnect portal (webServer); // Here, /feels handler void feelsOn () { // Retrieve the value of a input-box named \"feels\" String feel = webServer.arg( \"feels\" ); // Echo back the value String echo = \"<html><p style= \\\" color:blue;font-family:verdana;font-size:300%; \\\" >\" + feel + String( \" and a bold world!</p></html>\" ); webServer.send( 200 , \"text/html\" , echo); } void setup () { delay( 1000 ); webServer.on( \"/feels\" , feelsOn); // Register /feels handler portal.load(addonJson); // Load a custom Web page portal.begin(); } void loop () { portal.handleClient(); } An above example is the most simple sketch of handling values entered into a custom Web page. This sketch obtains the string entered in the AutoConnectInput named feels with the /feels handler after page transition, and the AutoConnectInput is an <input type=\"text\" name=\"feels\"> element wrapped in the form as the actual HTML code. Should be accessed /_ac first When you actually try the above sketch, there is no a root handler. So the URL that should be accessed first is /_ac concatenated with the local IP address of the esp8266 module. Another method is effective when custom Web pages have complicated page transitions. It is a way to straight access the AutoConnectElements member value. You can get the AutoConnectElement with the specified name using the getElement function. The following sketch executes the above example with AutoConnect only, without using the function of ESP8266WebServer. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> const static char addonJson[] PROGMEM = R\"raw( [ { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] }, { \"title\": \"Hello\", \"uri\": \"/feels\", \"menu\": false, \"element\": [ { \"name\": \"echo\", \"type\": \"ACText\", \"style\": \"color:blue;font-family:verdana;font-size:300%;\" } ] } ] )raw\" ; AutoConnect portal; // Here, /feels handler String feelsOn (AutoConnectAux & aux, PageArgument & args) { // Get the AutoConnectInput named \"feels\". // The where() function returns an uri string of the AutoConnectAux that triggered this handler. AutoConnectAux * hello = portal.aux(portal.where()); AutoConnectInput & feels = hello -> getElement < AutoConnectInput > ( \"feels\" ); // Get the AutoConnectText named \"echo\". AutoConnectText & echo = aux.getElement < AutoConnectText > ( \"echo\" ); // Echo back from input-box to /feels page. echo.value = feels.value + String( \" and a bold world!\" ); return String( \"\" ); } void setup () { delay( 1000 ); portal.load(addonJson); // Load custom Web pages portal.on( \"/feels\" , feelsOn, AC_EXIT_AHEAD); // Register /feels handler portal.begin(); } void loop () { portal.handleClient(); } The above example handles in the handler for the values of a custom Web page. An AutoConnect::on function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the PageArgument object. To retrieve the values entered in a custom Web page you need to access the AutoConnectElement of the page that caused the request to this page and to do this, you use the AutoConnect::where function. The AutoConnect::where function returns an uri string of the AutoConnectAux object of the custom Web page that caused the HTTP request. The where() function is available for only AutoConnectAux. The AutoConnect::where function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/WebServer for ESP32. In other words, the AutoConnect::where function only returns the last AutoConnecAux page called. When setting the initial values \u00b6 An AutoConnectAux page is dynamically created by AutoConnect when its uri is requested. The initial value of AutoConnectElements can be set before its page request. It is also possible during loop() . To set the initial value when the page is accessed it needs by the handler of its page. The AutoConnect::on and AutoConnectAux::on functions register a handler for a custom Web page and also specify when to call that handler. The behavior of the two on functions is the same, only the class and arguments are different. bool AutoConnect :: on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order) void AutoConnectAux :: on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order) Parameter uri specifies an URI of the custom Web page, but an AutoConnectAux object with its URI must be registered with AutoConnect via the AutoConnect::join function beforehand. AutoConnect::on/AutoConnectAux::on is not ESP8266WebServer::on The on function for AutoConnect is different from the on function of Arduino core ESP8266WebServer (WebServer for ESP32). You can share the same handler via wrapper, but access to AutoConnectElements is valid only for handlers registered with on function for AutoConnect . AuxHandlerFunctionT type is a handler declaration using with std::function . String handler(AutoConnectAux & aux, PageArgument & args) The handler of the custom Web page has two arguments by a reference of AutoConnectAux and a reference of PageArgument, it returns String. AutoConnect appends the string returned from the handler to the generated HTML. This allows you to add an HTML part before displaying the page. AutoConnectExitOrder_t specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. The following example is a part of sketch contained the handlers. // AutoConnect object declarations ACInput(input1); AutoConnectAux aux ( \"/aux\" , { input1 }); AutoConnect portal; // Pre-declare handlers String initialize (AutoConnectAux & , PageArgument & ); String append (AutoConnectAux & , PageArgument & ); // Register handlers and launch the portal. aux.on(initialize, AC_AHEAD); aux.on(append, AC_LATER); portal.join(aux); portal.begin(); // Some code here... // The handler called before HTML generating String initialize (AutoConnectAux & aux, PageArgument & args) { AutoConnectInput & input1 = aux.getElement < AutoConnectInput > ( \"input1\" ); // Set initial value for the input box in a custom Web page. input1.value = \"Initial value\" ; // Nothing appendix for a generated HTML. return String(); } // The handler called after HTML generated String append (AutoConnectAux & aux, PageArgument & args) { // Append an HTML return String( \"<p>This text has been added.</p>\" ); } How you can reach the values \u00b6 AutoConnectSubmit uses the POST method to send HTTP requests. A value of AutoConnectInput sent to the ESP8266 or ESP32 with POST is stored in the request body of the HTTP request: POST /feels HTTP/1.1 Host: ESP8266_IP_ADDRESS name1=value1&name2=value2&name3=value3 ESP8266WebServer class will parse the query string and rebuilds its arguments when the above request arrives. A custom page handler registered with the ESP8266WebServer::on function can access the value of AutoConnectElements with ESP8266WebServe::arg function. It reaches the values of AutoConnectElements without the intermediation of AutoConnect. Therefore, its handler will not be AutoConnectAux and can send a response to the client directly. The following example is part of a server sketch which has two web pages. The /hello page is a custom Web page of AutoConnectAux which has an input box named \"input1\". Another /echo page is a page handler for ESP8266WebServer, which uses the ESP8266WebServer::send function to echo back the value of an input1 as an http response. ESP8266WebServer server; AutoConnect portal (server); ACInput(input1, \"\" , \"INPUT\" ); ACSubmit(send, \"HELLO\" , \"/echo\" ); AutoConnectAux aux ( \"/hello\" , { input1, send }); server.on( \"/echo\" , []() { String echo = server.arg( \"input1\" ); Serial.println(echo); server.send( 200 , \"text/plain\" , echo); }); portal.join(aux); portal.begin(); Also, you can choose another way to access arguments without going through the ESP8266WebServer class. The PageArgument object of the custom Web page handler argument is a copy of the arg object of the ESP8266WebServer class. Either of these methods is a simple and easy way to access parameters in custom Web page handlers. However, if you need to access from outside of the handler to the value of AutoConnectElements, you need to accomplish it using with the AutoConnectAux::getElement function. The following sketch code replaces the above example with JSON and PageArgument, and its behaves is equivalent basically to the above sketch. const static char auxPage[] PROGMEM = R\"raw( [ { \"title\":\"Hello\", \"uri\":\"/hello\", \"menu\":true, \"element\":[ { \"name\":\"input1\", \"type\": \"ACInput\", \"label\": \"INPUT\" }, { \"name\":\"send\", \"type\":\"ACSubmit\", \"value\":\"HELLO\", \"uri\":\"/echo\" }] }, { \"title\":\"Echo\", \"uri\":\"/echo\", \"menu\":false, \"element\":[ { \"name\":\"echo\", \"type\":\"ACText\" }] } ] )raw\" ; AutoConnect portal; portal.load(auxPage); portal.on( \"/echo\" , [](AutoConnectAux & aux, PageArgument & args) { AutoConnectText & ac_echo = aux.getElement < AutoConnectText > ( \"echo\" ); ac_echo.value = args.arg( \"input1\" ); return String (); }); portal.begin(); Transfer of input values \u200b\u200bacross pages \u00b6 Since v1.0.0, AutoConnect supports a new attribute with each element that allows automatic transfer of input values across pages without sketching. AutoConnect will copy the input value of the elements declared as global to the same-named global elements on a different custom Web pages at the page transition timing. The global attribute will be useful for echoing input values back to another custom Web pages. This copy operation can be performed between different types. (eg., copy value from AutoConnectInput to AutoConnectText) The following example reflects the input value of PAGE1 to the AutoConnectText field of PAGE2 without sketch code. static const char PAGE1[] PROGMEM = R\"( { \"title\": \"PAGE1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\": \"input1\", \"type\": \"ACInput\", \"global\": true }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"OK\", \"uri\": \"/page2\" } ] } )\" ; static const char PAGE2[] PROGMEM = R\"( { \"title\": \"PAGE2\", \"uri\": \"/page2\", \"menu\": false, \"element\": [ { \"name\": \"input1\", \"type\": \"ACText\", \"global\": true } ] } )\" ; AutoConnect portal; AutoConnectAux page1; AutoConnectAux page2; void setup () { page1.load(PAGE1); page2.load(PAGE2); portal.join( { page1, page2 }); portal.begin(); } void loop () { portal.handleClient(); } The value entered in input1 declared in PAGE1 is reflected in input1 of PAGE2 as an AutoConnectText value even if there is no sketch code to transfer it to PAGE2. It's shown as like: Copy only for same-named and the global The input value will be copied only if the global attribute of the destination element is true. If an element with the same name is declared non-global, the value is not copied. Retrieve the values with WebServer::on handler \u00b6 ESP8266WebServer class and the WebServer class assume that the implementation of the ReqestHandler class contained in the WebServer library will handle the URL requests. Usually, it is sketch code registered by ESP8266WebServer::on function. When a page transition from a custom Web page created by AutoConnectAux to a handler registered with ESP2866WebServer::on function, a little trick is needed to retrieve the values of AutoConnectElements. (i.e. the URI of the ESP8266WebServer::on handler is specified in the uri attribute of AutoConnectSubmit ) AutoConnect cannot intervene in the procedure in which the ESP8266WebServer class calls the on-page handler coded with the sketch. Therefore, it is necessary to retrieve preliminary the values of AutoConnectElements using the AutoConnectAux::fetchElement function for value processing with the on-page handler. The following sketch is an example of extracting values inputted on a custom web page with an on-page handler and then processing it. ESP8266WebServer server; AutoConnect portal (server); AutoConnectAux Input; const static char InputPage[] PROGMEM = R\"r( { \"title\": \"Input\", \"uri\": \"/input\", \"menu\": true, \"element\": [ { \"name\": \"input\", \"type\": \"ACInput\", \"label\": \"INPUT\" }, { \"name\": \"save\", \"type\": \"ACSubmit\", \"value\": \"SAVE\", \"uri\": \"/\" } ] } )r\" ; // An on-page handler for '/' access void onRoot () { String content = \"<html>\" \"<head><meta name='viewport' content='width=device-width, initial-scale=1'></head>\" \"<body><div>INPUT: {{value}}</div></body>\" \"</html>\" ; Input.fetchElement(); // Preliminary acquisition // For this steps to work, need to call fetchElement function beforehand. String value = Input[ \"input\" ].value; content.replace( \"{{value}}\" , value); server.send( 200 , \"text/html\" , content); } void setup () { Input.load(InputPage); portal.join(Input); server.on( \"/\" , onRoot); // Register the on-page handler portal.begin(); } void loop () { portal.handleClient(); } Overwrite the AutoConnectElements \u00b6 Sketches can update the attributes of AutoConnectElements with two approaches. A one is to assign directly to the attributes of a member variable of its element. The other is to overwrite them with loading the element by AutoConnectAux::loadElement . The elements for attributes described in the JSON document for AutoConnectElements overwrites the member variables of the target AutoConnectElements. However, AutoConnectAux::loadElement keeps the member variables unchanged if there is no element in the JSON document. This overwriting behavior is the same for the AutoConnect::load function. For example, the combination of the sketch and JSON document as follows updates only the style while keeping Caption (ie. \"Hello, world\") as AutoConnectText value. External JSON document for the below sketch to modify the text style. { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"style\" : \"text-align:center;font-size:24px;font-family:'Impact','Futura',sans-serif;color:tomato;\" } The sketch (a part of code), load above JSON. ACText(Caption, \"Hello, world\" ); AutoConnectAux helloPage ( \"/hello\" , \"Hello\" , true, { Caption }); AutoConnect portal; String onHello (AutoConnectAux & aux, PageArgument & args) { aux.loadElement(JSON); return String(); } void setup () { helloPage.on(onHello); portal.join(helloPage); portal.begin(); } void loop () { portal.handleClient(); } It's shown as like: Check data against on submission \u00b6 By giving a pattern to AutoConnectInput , you can find errors in data styles while typing in custom Web pages. The pattern is specified with regular expression . 2 If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. The following example shows the behavior when checking the IP address in the AutoConnectInput field. { \"title\" : \"Page-1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" , \"pattern\" : \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" } ] } It's shown as like: If you are not familiar with regular expressions, you may feel that description very strange. Matter of fact, it's a strange description for those who are unfamiliar with the formal languages. If your regular expression can not interpret the intended syntax and semantics, you can use an online tester. The regex101 is an exceptional online tool for testing and debugging regular expressions. Input data validation \u00b6 The pattern attribute of AutoConnectInput only determines the data consistency on the web browser based on the given regular expression. In order to guarantee the validity of input data, it is necessary to verify it before actually using it. You can validate input data from AutoConnectInput using the isValid function before actually processing it. The isValid function determines whether the value currently stored in AutoConnectInput matches the pattern . You can also use the AutoConnectAux::isValid function to verify the data input to all AutoConnectInput elements on the custom Web page at once. The two sketches below show the difference between using AutoConnectInput::isValid and using AutoConnectAux::isValid . In both cases, it verifies the input data of the same AutoConnectInput, but in the case of using AutoConnectAux::isValid, the amount of sketch coding is small. A common declaration const char PAGE[] PROGMEM = R\"( { \"title\": \"Custom page\", \"uri\": \"/page\", \"menu\": true, \"element\": [ { \"name\": \"input1\", \"type\": \"ACInput\", \"pattern\": \"^[0-9]{4}$\" }, { \"name\": \"input2\", \"type\": \"ACInput\", \"pattern\": \"^[a-zA-Z]{4}$\" } ] } )\" ; AutoConnectAux page; page.load(PAGE); Using AutoConnectInput::isValid AutoConnectInput & input1 = page[ \"input1\" ].as < AutoConnectInput > (); AutoConnectInput & input2 = page[ \"input2\" ].as < AutoConnectInput > (); if ( ! input1.isValid() || ! input2.isValid()) Serial.println( \"Validation error\" ); Using AutoConnectAux::isValid if ( ! page.isValid()) Serial.println( \"Validation error\" ); Convert data to actually type \u00b6 The values in the AutoConnectElements field of the custom Web page are all typed as String. A sketch needs to be converted to an actual data type if the data type required for sketch processing is not a String type. For the typical data type conversion method, refer to section Tips for data conversion . Transitions of the custom Web pages \u00b6 Scope & Lifetime of AutoConnectAux \u00b6 AutoConnectAux and AutoConnectElements must live while the custom Web pages are available. The implementation of the custom Web page inherits from requestHandler driven from ESP8266WebServer (WebServer for ESP32), so the instance of AutoConnectAux and AutoConnectElements must exist for the duration of effect of handleClient. The following example is incorrect for manipulating custom Web pages. Its AutoConnectAux instance will be destructed at the exit of the setup(). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const auxPage[] PROGMEM = R\"raw( { \"title\": \"Page-1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\":\"Server\", \"type\":\"ACText\", \"label\":\"Server address\" } ] } )raw\" ; AutoConnect portal; void setup () { // This declaration is wrong. AutoConnectAux aux; aux.load(auxPage); portal.join(aux); portal.begin(); } void loop () { portal.handleClient(); } The URI of the custom Web pages \u00b6 The transition of the custom Web page follows the URI of the page, but the ESP8266WebServer class does not know the URI of an AutoConnectAux page. (Registering a custom Web page does not use the ESP8266WebServer::on / WebServer::on function.) Therefore ESP8266WebServer class does not detect its URI access. If you want to detect an http request to AutoConnectAux's custom Web page, you need to register its URI with the AutoConnectAux::on function. In addition to this, there are restrictions in the handler for the custom Web page as shown in the following section. Limitations \u00b6 The custom Web pages handler has the following limitations. Do not send HTTP responses from the handler. If the handler returns its own response, the custom Web page will be lost. Use AutoConnectSubmit whenever possible. AutoConnect will hold the values of a custom Web Page is sent by AutoConnectSubmit. Can not handle the custom Web pages during a connection is not established yet. During the connection attempt, the web browser of the client will send a probe for a captive portal. Its request will cause unintended custom Web page transitions. Can not place URI of the custom Web pages to AUTOCONNECT_URI. AutoConnect will not work if you place a custom Web page to AUTOCONNECT_URI . Can not use the element named SUBMIT . You can not use 'SUBMIT' as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element. (Case sensitive ignored) AutoConnect does not rely on the input type=submit element for the form submission and uses HTML form element submit function instead. So, the submit function will fail if there is an element named 'submit' in the form. Do not handle for the same page Do not duplicate AutoConnect::on with ESP8266WebServer::on (also WebServer::on) for the same custom web page. window.onload = function() { Gifffer(); }; The valid scope of the name is within an AutoConnectAux. \u21a9 Regular expression specification as a pattern of AutoConnectInput is JavaScript compliant . \u21a9","title":"Handling the custom Web pages"},{"location":"achandling.html#page-container-component","text":"AutoConnectAux is the container for a custom Web page, AutoConnectElement is the component of a page. AutoConnectElements must be contained in AutoConnectAux object. (ie. they are the elements displayed on the custom Web page.) Then AutoConnect makes an AutoConnectAux to a page. AutoConnectElements declared in sketch must be programmed to add to AutoConnectAux one after another. Elements are automatically included in AutoConnectAux by AutoConnect if you load it from the JSON document. In either method, it is common to use the function of AutoConnectAux to access an element with a sketch.","title":"Page, Container, Component"},{"location":"achandling.html#handing-autoconnectelements-with-the-sketches","text":"The AutoConnectAux class has several functions to manipulate AutoConnectElements. The functions can add, delete, retrieve elements, and get and set values.","title":"Handing AutoConnectElements with the sketches"},{"location":"achandling.html#add-autoconnectelements-to-the-autoconnectaux-object","text":"To add AutoConnectElment(s) to an AutoConnectAux object, use the add function. void AutoConnectAux :: add(AutoConnectElement & addon) void AutoConnectAux :: add(AutoConnectElementVT addons) The add function adds the specified AutoConnectElement to AutoConnectAux. The AutoConnectElementVT type is the std::vector of the reference wrapper to AutoConnectElements, and you can add these elements in bulk by using the list initialization with the sketch. typedef std :: vector < std :: reference_wrapper < AutoConnectElement >> AutoConnectElementVT; AutoConnectElements contained in AutoConnectAux object are uniquely identified by name. When adding an AutoConnectElement, if an element with the same name already exists in the AutoConnectAux, checking the type, and if it is the same, the value will be replaced. If another type of AutoConnectElement exists with the same name, that add operation will be invalid. 1 In the following example, AutoConnectButton button addition will invalid because hello with the same name already exists as AutoConnectText. AutoConnectAux aux; AutoConnectText text ( \"hello\" , \"hello, world\" ); AutoConnectButton button ( \"hello\" , \"hello, world\" , \"alert('Hello world!')\") ; // This is invalid. aux.add({ text, button }); Similarly this, the uniqueness of the name is also necessary within the JSON document { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true , \"element\" : [ { \"name\" : \"hello\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"hello\" , \"type\" : \"ACButton\" , \"value\" : \"hello, world\" , \"action\" : \"alert('Hello world!')\" } ] } Load all elements from JSON document If you load all AutoConnectElements from JSON document into AutoConnect, you do not need to sketch the population process of the AutoConnectElements. It is managed by the AutoConnect library automatically.","title":" Add AutoConnectElements to the AutoConnectAux object"},{"location":"achandling.html#get-autoconnectelement-from-the-autoconnectaux","text":"To retrieve an element from AutoConnectAux, use the getElement or getElements function. Normally, the getElement is needed when accessing the value of AutoConnectElement in the sketch. AutoConnectElement * AutoConnectAux :: getElement( const String & name) T & AutoConnectAux :: getElement < T > ( const String & name) AutoConnectElementVT * AutoConnectAux :: getElements( void ) The getElement function returns an AutoConnectElement with the specified name as a key. When you use this function, you need to know the type of AutoConnectElement in advance and specify its type <T> to an argument of the getElement. A type of <T> can be specified as follows. AutoConnectButton & AutoConnectAux :: getElement < AutoConnectButton > ( const String & name) AutoConnectCheckbox & AutoConnectAux :: getElement < AutoConnectCheckbox > ( const String & name) AutoConnectElement & AutoConnectAux :: getElement < AutoConnectElement > ( const String & name) AutoConnectFile & AutoConnectAux :: getElement < AutoConnectFile > ( const String & name) AutoConnectInput & AutoConnectAux :: getElement < AutoConnectInput > ( const String & name) AutoConnectRadio & AutoConnectAux :: getElement < AutoConnectRadio > ( const String & name) AutoConnectSelect & AutoConnectAux :: getElement < AutoConnectSelect > ( const String & name) AutoConnectSubmit & AutoConnectAux :: getElement < AutoConnectSubmit > ( const String & name) AutoConnectText & AutoConnectAux :: getElement < AutoConnectText > ( const String & name) To retrieve an AutoConnectElement by specifying its type, use the following method. AutoConnectAux aux; aux.load( \"SOME_JSON_DOCUMENT\" ); // Retrieve the pointer of the AutoConnectText AutoConnectText * text = reinterpret_cast < AutoConnectText *> (aux.getElement( \"TEXT_ELEMENT_NAME\" )); // Retrieve the reference of the AutoConnectText AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_ELEMENT_NAME\" ); The AutoConnectElement type behaves as a variant of other element types. Therefore use cast or template to convert to actual type as above. In the sketch, you access the real type of AutoConnectElement after casting it and storing into the variable. const String auxJson = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); AutoConnect portal; portal.load(auxJson); AutoConnectAux * aux = portal.aux( \"/page1\" ); // Identify the AutoConnectAux instance with uri AutoConnectText & text = aux -> getElement < AutoConnectText > ( \"caption\" ); // Cast to real type and access members Serial.println(text.value); You can also use the operator [] of AutoConnectAux as another way to get the desired element. An operator [] is a shortcut for getElement function with the reference casting and makes simplify the sketch code and treats like an array with the elements placed on a custom Web page. Its argument is the name of the element to be acquired similarly to getElement function. In the sketch, by combining the AutoConnectElement::as<T> function with the operator [] , you can access the AutoConnectElements reference according to its actual type. For example, the following sketch code returns the same as a reference of AutoConnectText element as the caption . AutoConnect portal; portal.load(auxJson); AutoConnectAux & aux = * portal.aux( \"/page1\" ); AutoConnectText & text1 = aux.getElement < AutoConnectElement > ( \"caption\" ); AutoConnectText & text2 = aux[ \"caption\" ].as < AutoConnectText > (); Need cast to convert to the actual type An operator [] returns a reference of an AutoConnectElement. It is necessary to convert the type according to the actual element type with AutoConnectElement::as<T> function. AutoConnectButton & AutoConnectElement :: as < AutoConnectButton > () AutoConnectCheckbox & AutoConnectElement :: as < AutoConnectCheckbox > () AutoConnectElement & AutoConnectElement :: as < AutoConnectElement > () AutoConnectFile & AutoConnectElement :: as < AutoConnectFile > () AutoConnectInput & AutoConnectElement :: as < AutoConnectInput > () AutoConnectRadio & AutoConnectElement :: as < AutoConnectRadio > () AutoConnectSelect & AutoConnectElement :: as < AutoConnectSelect > () AutoConnectSubmit & AutoConnectElement :: as < AutoConnectSubmit > () AutoConnectText & AutoConnectElement :: as < AutoConnectText > () To get all the AutoConnectElements in an AutoConnectAux object use the getElements function. This function returns the vector of the reference wrapper as AutoConnectElementVT to all AutoConnectElements registered in the AutoConnectAux. AutoConnectElementVT & AutoConnectAux :: getElements( void )","title":" Get AutoConnectElement from the AutoConnectAux"},{"location":"achandling.html#enable-autoconnectelements-during-the-sketch-execution","text":"AutoConnectElemets have an enable attribute to activate its own HTML generation. Sketches can change the HTMLization of their elements dynamically by setting or resetting the enable value. An element whose the enable attribute is true will generate itself HTML and place on the custom Web page. And conversely, it will not generate the HTML when the value is false. For example, to enable the submit button only when the ESP module is connected to the access point in STA mode, you can sketch the following: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char AUX[] PROGMEM = R( \" { \"name\" : \"aux\" , \"uri\" : \"/aux\" , \"menu\" : true, \"element\" : [ { \"name\" : \"input\" , \"type\" : \"ACInput\" , \"label\" : \"Input\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/send\" } ] } \"); AutoConnect portal; AutoConnectAux page; String onPage (AutoConectAux & aux, PageArgument & args) { AutoConnectSubmit & send = aux[ \"send\" ].as < AutoConnectSubmit > (); if (WiFi.isConnected()) send.enable = (WiFi.getMode() == WIFI_STA); else send.enable = false; return String(); } void setup () { page.load(AUX); page.on(onPage); portal.join(page); portal.begin(); } void loop () { portal.handleClient(); } Desirable to set or reset the enable attribute in the page handler The enable attribute can be set at any time during the sketch execution. The page handler with the AC_EXIT_AHEAD option is sure to handle it.","title":" Enable AutoConnectElements during the sketch execution"},{"location":"achandling.html#loading-saving-autoconnectelements-with-json","text":"AutoConnect supports reading the custom Web page definitions written in JSON and also supports loading and saving of AutoConnectAux or AutoConnectElements. In both cases, the target object is a JSON document for AutoConnect . However, it can not save all AutoConnectElements contained in the page as a custom Web page. (ie. AutoConnectAux)","title":"Loading &amp; saving AutoConnectElements with JSON"},{"location":"achandling.html#loading-autoconnectaux-autoconnectelements-with-json","text":"To load a JSON document as AutoConnectAux use the AutoConnect::load function and load the JSON document of each AutoConnectElement using the AutoConnectAux::loadElement function. Although the functions of both are similar, the structure of the target JSON document is different. The AutoConnect::load function loads the entire AutoConnectAux and creates both the AutoConnectAux instance and each AutoConnectElement instance. A single JSON document can contain multiple custom Web pages. If you write JSON of AutoConnectAux as an array, the load function generates all the pages contained in that array. Therefore, it is necessary to supply the JSON document of AutoConnectAux as an input of the load function and must contain the elements described section JSON document structure for AutoConnectAux . The AutoConnectAux::loadElement function loads the elements individually into an AutoConnectAux object. The structure of its supplying JSON document is not AutoConnectAux. It must be a JSON structure for AutoConnectElement , but you can specify an array. // AutoConnectAux as a custom Web page. const char page[] PROGMEM = R\"raw( { \"title\": \"Settings\", \"uri\": \"/settings\", \"menu\": true, \"element\": [ { \"name\": \"server\", \"type\": \"ACInput\", \"label\": \"Server\" }, { \"name\": \"set\", \"type\": \"ACSubmit\", \"value\": \"SET\", \"uri\" : \"/set\" } ] } )raw\" ; // Additional AutoConnectElements. const char addons[] PROGMEM = R\"raw( [ { \"name\": \"notes\", \"type\": \"ACText\", \"value\": \"An update period as the below optionally.\" }, { \"name\": \"period\", \"type\": \"ACRadio\", \"value\": [ \"30 sec.\", \"60 sec.\", \"180 sec.\" ], \"arrange\": \"vertical\", \"checked\": 1 } ] )raw\" ; AutoConnect portal; AutoConnectAux * auxPage; // Load a custom Web page. portal.load(page); // Get a '/settings' page auxPage = portal.aux( \"/settings\" ); // Also, load only AutoConnectRadio named the period. auxPage -> loadElement(addons, \"period\" ); // Retrieve a server name from an AutoConnectText value. AutoConnectText & serverName = auxPage -> getElement < AutoConnectText > ( \"server\" ); Serial.println(serverName.value);","title":" Loading AutoConnectAux &amp; AutoConnectElements with JSON"},{"location":"achandling.html#saving-autoconnectelements-with-json","text":"To save the AutoConnectAux or the AutoConnectElement as a JSON document, use the AutoConnectAux::saveElement function. It serializes the contents of the object based on the type of the AutoConnectElement. You can persist a serialized AutoConnectElements as a JSON document to a stream. // Open a parameter file on the SPIFFS. SPIFFS.begin(); FILE param = SPIFFS.open( \"/param\" , \"w\" ); // Save elements as the parameters. auxPage -> saveElement(param, { \"server\" , \"period\" }); // Close a parameter file. param.close(); SPIFFS.end(); The example above saves server and period elements from the AutoConnectAux object as mentioned above to the /param file on SPIFFS. Its JSON document of AutoConnectElements saved by its code looks like this: [ { \"name\" : \"server\" , \"type\" : \"ACInput\" , \"value\" : \"An inputted server name\" , \"label\" : \"Server\" , \"placeholder\" : \"\" }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"arrange\" : \"vertical\" , \"checked\" : 2 } ] Above JSON document can be loaded as it is into a custom Web page using the loadElement function. The loadElement function also loads the value of the element, so the saved value can be restored on the custom Web page.","title":" Saving AutoConnectElements with JSON"},{"location":"achandling.html#custom-field-data-handling","text":"A sketch can access variables of AutoConnectElements in the custom Web page. The value entered into the AutoConnectElements on the page is stored in the member variable of each element by AutoConnect whenever GET/POST transmission occurs. The following diagram shows the flow of the input values of a custom Web page into a sketch and is the basis for actions to manipulate the values of custom Web pages using sketches.","title":"Custom field data handling"},{"location":"achandling.html#where-to-pick-up-the-values","text":"A sketch composed of handlers can receive the value of AutoConnectElements entered in a custom Web page after sending, but that handler is different from the page where the value was entered. It is necessary to be aware that can accept the entered values by the next page handler after the transition. Usually, two ways to retrieve entered values we have. One is to use the ESP8266WebServer::arg (or WebServer::arg for ESP32) function in the on handler attached by ESP8266WebServer (WebServer w/ESP32 also). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char addonJson[] PROGMEM = R\"raw( { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] } )raw\" ; ESP8266WebServer webServer; AutoConnect portal (webServer); // Here, /feels handler void feelsOn () { // Retrieve the value of a input-box named \"feels\" String feel = webServer.arg( \"feels\" ); // Echo back the value String echo = \"<html><p style= \\\" color:blue;font-family:verdana;font-size:300%; \\\" >\" + feel + String( \" and a bold world!</p></html>\" ); webServer.send( 200 , \"text/html\" , echo); } void setup () { delay( 1000 ); webServer.on( \"/feels\" , feelsOn); // Register /feels handler portal.load(addonJson); // Load a custom Web page portal.begin(); } void loop () { portal.handleClient(); } An above example is the most simple sketch of handling values entered into a custom Web page. This sketch obtains the string entered in the AutoConnectInput named feels with the /feels handler after page transition, and the AutoConnectInput is an <input type=\"text\" name=\"feels\"> element wrapped in the form as the actual HTML code. Should be accessed /_ac first When you actually try the above sketch, there is no a root handler. So the URL that should be accessed first is /_ac concatenated with the local IP address of the esp8266 module. Another method is effective when custom Web pages have complicated page transitions. It is a way to straight access the AutoConnectElements member value. You can get the AutoConnectElement with the specified name using the getElement function. The following sketch executes the above example with AutoConnect only, without using the function of ESP8266WebServer. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> const static char addonJson[] PROGMEM = R\"raw( [ { \"title\": \"Hello\", \"uri\": \"/hello\", \"menu\": true, \"element\": [ { \"name\": \"feels\", \"type\": \"ACInput\", \"label\": \"What's up?\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"Just it!\", \"uri\": \"/feels\" } ] }, { \"title\": \"Hello\", \"uri\": \"/feels\", \"menu\": false, \"element\": [ { \"name\": \"echo\", \"type\": \"ACText\", \"style\": \"color:blue;font-family:verdana;font-size:300%;\" } ] } ] )raw\" ; AutoConnect portal; // Here, /feels handler String feelsOn (AutoConnectAux & aux, PageArgument & args) { // Get the AutoConnectInput named \"feels\". // The where() function returns an uri string of the AutoConnectAux that triggered this handler. AutoConnectAux * hello = portal.aux(portal.where()); AutoConnectInput & feels = hello -> getElement < AutoConnectInput > ( \"feels\" ); // Get the AutoConnectText named \"echo\". AutoConnectText & echo = aux.getElement < AutoConnectText > ( \"echo\" ); // Echo back from input-box to /feels page. echo.value = feels.value + String( \" and a bold world!\" ); return String( \"\" ); } void setup () { delay( 1000 ); portal.load(addonJson); // Load custom Web pages portal.on( \"/feels\" , feelsOn, AC_EXIT_AHEAD); // Register /feels handler portal.begin(); } void loop () { portal.handleClient(); } The above example handles in the handler for the values of a custom Web page. An AutoConnect::on function registers a handler for the AutoConnectAux page of the specified uri. The argument of the custom Web page handler is an AutoConnectAux of the page itself and the PageArgument object. To retrieve the values entered in a custom Web page you need to access the AutoConnectElement of the page that caused the request to this page and to do this, you use the AutoConnect::where function. The AutoConnect::where function returns an uri string of the AutoConnectAux object of the custom Web page that caused the HTTP request. The where() function is available for only AutoConnectAux. The AutoConnect::where function is available only for the AutoConnectAux object. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/WebServer for ESP32. In other words, the AutoConnect::where function only returns the last AutoConnecAux page called.","title":" Where to pick up the values"},{"location":"achandling.html#when-setting-the-initial-values","text":"An AutoConnectAux page is dynamically created by AutoConnect when its uri is requested. The initial value of AutoConnectElements can be set before its page request. It is also possible during loop() . To set the initial value when the page is accessed it needs by the handler of its page. The AutoConnect::on and AutoConnectAux::on functions register a handler for a custom Web page and also specify when to call that handler. The behavior of the two on functions is the same, only the class and arguments are different. bool AutoConnect :: on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order) void AutoConnectAux :: on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order) Parameter uri specifies an URI of the custom Web page, but an AutoConnectAux object with its URI must be registered with AutoConnect via the AutoConnect::join function beforehand. AutoConnect::on/AutoConnectAux::on is not ESP8266WebServer::on The on function for AutoConnect is different from the on function of Arduino core ESP8266WebServer (WebServer for ESP32). You can share the same handler via wrapper, but access to AutoConnectElements is valid only for handlers registered with on function for AutoConnect . AuxHandlerFunctionT type is a handler declaration using with std::function . String handler(AutoConnectAux & aux, PageArgument & args) The handler of the custom Web page has two arguments by a reference of AutoConnectAux and a reference of PageArgument, it returns String. AutoConnect appends the string returned from the handler to the generated HTML. This allows you to add an HTML part before displaying the page. AutoConnectExitOrder_t specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. The following example is a part of sketch contained the handlers. // AutoConnect object declarations ACInput(input1); AutoConnectAux aux ( \"/aux\" , { input1 }); AutoConnect portal; // Pre-declare handlers String initialize (AutoConnectAux & , PageArgument & ); String append (AutoConnectAux & , PageArgument & ); // Register handlers and launch the portal. aux.on(initialize, AC_AHEAD); aux.on(append, AC_LATER); portal.join(aux); portal.begin(); // Some code here... // The handler called before HTML generating String initialize (AutoConnectAux & aux, PageArgument & args) { AutoConnectInput & input1 = aux.getElement < AutoConnectInput > ( \"input1\" ); // Set initial value for the input box in a custom Web page. input1.value = \"Initial value\" ; // Nothing appendix for a generated HTML. return String(); } // The handler called after HTML generated String append (AutoConnectAux & aux, PageArgument & args) { // Append an HTML return String( \"<p>This text has been added.</p>\" ); }","title":" When setting the initial values"},{"location":"achandling.html#how-you-can-reach-the-values","text":"AutoConnectSubmit uses the POST method to send HTTP requests. A value of AutoConnectInput sent to the ESP8266 or ESP32 with POST is stored in the request body of the HTTP request: POST /feels HTTP/1.1 Host: ESP8266_IP_ADDRESS name1=value1&name2=value2&name3=value3 ESP8266WebServer class will parse the query string and rebuilds its arguments when the above request arrives. A custom page handler registered with the ESP8266WebServer::on function can access the value of AutoConnectElements with ESP8266WebServe::arg function. It reaches the values of AutoConnectElements without the intermediation of AutoConnect. Therefore, its handler will not be AutoConnectAux and can send a response to the client directly. The following example is part of a server sketch which has two web pages. The /hello page is a custom Web page of AutoConnectAux which has an input box named \"input1\". Another /echo page is a page handler for ESP8266WebServer, which uses the ESP8266WebServer::send function to echo back the value of an input1 as an http response. ESP8266WebServer server; AutoConnect portal (server); ACInput(input1, \"\" , \"INPUT\" ); ACSubmit(send, \"HELLO\" , \"/echo\" ); AutoConnectAux aux ( \"/hello\" , { input1, send }); server.on( \"/echo\" , []() { String echo = server.arg( \"input1\" ); Serial.println(echo); server.send( 200 , \"text/plain\" , echo); }); portal.join(aux); portal.begin(); Also, you can choose another way to access arguments without going through the ESP8266WebServer class. The PageArgument object of the custom Web page handler argument is a copy of the arg object of the ESP8266WebServer class. Either of these methods is a simple and easy way to access parameters in custom Web page handlers. However, if you need to access from outside of the handler to the value of AutoConnectElements, you need to accomplish it using with the AutoConnectAux::getElement function. The following sketch code replaces the above example with JSON and PageArgument, and its behaves is equivalent basically to the above sketch. const static char auxPage[] PROGMEM = R\"raw( [ { \"title\":\"Hello\", \"uri\":\"/hello\", \"menu\":true, \"element\":[ { \"name\":\"input1\", \"type\": \"ACInput\", \"label\": \"INPUT\" }, { \"name\":\"send\", \"type\":\"ACSubmit\", \"value\":\"HELLO\", \"uri\":\"/echo\" }] }, { \"title\":\"Echo\", \"uri\":\"/echo\", \"menu\":false, \"element\":[ { \"name\":\"echo\", \"type\":\"ACText\" }] } ] )raw\" ; AutoConnect portal; portal.load(auxPage); portal.on( \"/echo\" , [](AutoConnectAux & aux, PageArgument & args) { AutoConnectText & ac_echo = aux.getElement < AutoConnectText > ( \"echo\" ); ac_echo.value = args.arg( \"input1\" ); return String (); }); portal.begin();","title":" How you can reach the values"},{"location":"achandling.html#transfer-of-input-values-across-pages","text":"Since v1.0.0, AutoConnect supports a new attribute with each element that allows automatic transfer of input values across pages without sketching. AutoConnect will copy the input value of the elements declared as global to the same-named global elements on a different custom Web pages at the page transition timing. The global attribute will be useful for echoing input values back to another custom Web pages. This copy operation can be performed between different types. (eg., copy value from AutoConnectInput to AutoConnectText) The following example reflects the input value of PAGE1 to the AutoConnectText field of PAGE2 without sketch code. static const char PAGE1[] PROGMEM = R\"( { \"title\": \"PAGE1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\": \"input1\", \"type\": \"ACInput\", \"global\": true }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"OK\", \"uri\": \"/page2\" } ] } )\" ; static const char PAGE2[] PROGMEM = R\"( { \"title\": \"PAGE2\", \"uri\": \"/page2\", \"menu\": false, \"element\": [ { \"name\": \"input1\", \"type\": \"ACText\", \"global\": true } ] } )\" ; AutoConnect portal; AutoConnectAux page1; AutoConnectAux page2; void setup () { page1.load(PAGE1); page2.load(PAGE2); portal.join( { page1, page2 }); portal.begin(); } void loop () { portal.handleClient(); } The value entered in input1 declared in PAGE1 is reflected in input1 of PAGE2 as an AutoConnectText value even if there is no sketch code to transfer it to PAGE2. It's shown as like: Copy only for same-named and the global The input value will be copied only if the global attribute of the destination element is true. If an element with the same name is declared non-global, the value is not copied.","title":" Transfer of input values \u200b\u200bacross pages"},{"location":"achandling.html#retrieve-the-values-with-webserveron-handler","text":"ESP8266WebServer class and the WebServer class assume that the implementation of the ReqestHandler class contained in the WebServer library will handle the URL requests. Usually, it is sketch code registered by ESP8266WebServer::on function. When a page transition from a custom Web page created by AutoConnectAux to a handler registered with ESP2866WebServer::on function, a little trick is needed to retrieve the values of AutoConnectElements. (i.e. the URI of the ESP8266WebServer::on handler is specified in the uri attribute of AutoConnectSubmit ) AutoConnect cannot intervene in the procedure in which the ESP8266WebServer class calls the on-page handler coded with the sketch. Therefore, it is necessary to retrieve preliminary the values of AutoConnectElements using the AutoConnectAux::fetchElement function for value processing with the on-page handler. The following sketch is an example of extracting values inputted on a custom web page with an on-page handler and then processing it. ESP8266WebServer server; AutoConnect portal (server); AutoConnectAux Input; const static char InputPage[] PROGMEM = R\"r( { \"title\": \"Input\", \"uri\": \"/input\", \"menu\": true, \"element\": [ { \"name\": \"input\", \"type\": \"ACInput\", \"label\": \"INPUT\" }, { \"name\": \"save\", \"type\": \"ACSubmit\", \"value\": \"SAVE\", \"uri\": \"/\" } ] } )r\" ; // An on-page handler for '/' access void onRoot () { String content = \"<html>\" \"<head><meta name='viewport' content='width=device-width, initial-scale=1'></head>\" \"<body><div>INPUT: {{value}}</div></body>\" \"</html>\" ; Input.fetchElement(); // Preliminary acquisition // For this steps to work, need to call fetchElement function beforehand. String value = Input[ \"input\" ].value; content.replace( \"{{value}}\" , value); server.send( 200 , \"text/html\" , content); } void setup () { Input.load(InputPage); portal.join(Input); server.on( \"/\" , onRoot); // Register the on-page handler portal.begin(); } void loop () { portal.handleClient(); }","title":" Retrieve the values with WebServer::on handler"},{"location":"achandling.html#overwrite-the-autoconnectelements","text":"Sketches can update the attributes of AutoConnectElements with two approaches. A one is to assign directly to the attributes of a member variable of its element. The other is to overwrite them with loading the element by AutoConnectAux::loadElement . The elements for attributes described in the JSON document for AutoConnectElements overwrites the member variables of the target AutoConnectElements. However, AutoConnectAux::loadElement keeps the member variables unchanged if there is no element in the JSON document. This overwriting behavior is the same for the AutoConnect::load function. For example, the combination of the sketch and JSON document as follows updates only the style while keeping Caption (ie. \"Hello, world\") as AutoConnectText value. External JSON document for the below sketch to modify the text style. { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"style\" : \"text-align:center;font-size:24px;font-family:'Impact','Futura',sans-serif;color:tomato;\" } The sketch (a part of code), load above JSON. ACText(Caption, \"Hello, world\" ); AutoConnectAux helloPage ( \"/hello\" , \"Hello\" , true, { Caption }); AutoConnect portal; String onHello (AutoConnectAux & aux, PageArgument & args) { aux.loadElement(JSON); return String(); } void setup () { helloPage.on(onHello); portal.join(helloPage); portal.begin(); } void loop () { portal.handleClient(); } It's shown as like:","title":" Overwrite the AutoConnectElements"},{"location":"achandling.html#check-data-against-on-submission","text":"By giving a pattern to AutoConnectInput , you can find errors in data styles while typing in custom Web pages. The pattern is specified with regular expression . 2 If the value during input of AutoConnectInput does not match the regular expression specified in the pattern, its background color changes to pink. The following example shows the behavior when checking the IP address in the AutoConnectInput field. { \"title\" : \"Page-1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" , \"pattern\" : \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" } ] } It's shown as like: If you are not familiar with regular expressions, you may feel that description very strange. Matter of fact, it's a strange description for those who are unfamiliar with the formal languages. If your regular expression can not interpret the intended syntax and semantics, you can use an online tester. The regex101 is an exceptional online tool for testing and debugging regular expressions.","title":" Check data against on submission"},{"location":"achandling.html#input-data-validation","text":"The pattern attribute of AutoConnectInput only determines the data consistency on the web browser based on the given regular expression. In order to guarantee the validity of input data, it is necessary to verify it before actually using it. You can validate input data from AutoConnectInput using the isValid function before actually processing it. The isValid function determines whether the value currently stored in AutoConnectInput matches the pattern . You can also use the AutoConnectAux::isValid function to verify the data input to all AutoConnectInput elements on the custom Web page at once. The two sketches below show the difference between using AutoConnectInput::isValid and using AutoConnectAux::isValid . In both cases, it verifies the input data of the same AutoConnectInput, but in the case of using AutoConnectAux::isValid, the amount of sketch coding is small. A common declaration const char PAGE[] PROGMEM = R\"( { \"title\": \"Custom page\", \"uri\": \"/page\", \"menu\": true, \"element\": [ { \"name\": \"input1\", \"type\": \"ACInput\", \"pattern\": \"^[0-9]{4}$\" }, { \"name\": \"input2\", \"type\": \"ACInput\", \"pattern\": \"^[a-zA-Z]{4}$\" } ] } )\" ; AutoConnectAux page; page.load(PAGE); Using AutoConnectInput::isValid AutoConnectInput & input1 = page[ \"input1\" ].as < AutoConnectInput > (); AutoConnectInput & input2 = page[ \"input2\" ].as < AutoConnectInput > (); if ( ! input1.isValid() || ! input2.isValid()) Serial.println( \"Validation error\" ); Using AutoConnectAux::isValid if ( ! page.isValid()) Serial.println( \"Validation error\" );","title":" Input data validation"},{"location":"achandling.html#convert-data-to-actually-type","text":"The values in the AutoConnectElements field of the custom Web page are all typed as String. A sketch needs to be converted to an actual data type if the data type required for sketch processing is not a String type. For the typical data type conversion method, refer to section Tips for data conversion .","title":" Convert data to actually type"},{"location":"achandling.html#transitions-of-the-custom-web-pages","text":"","title":"Transitions of the custom Web pages"},{"location":"achandling.html#scope-lifetime-of-autoconnectaux","text":"AutoConnectAux and AutoConnectElements must live while the custom Web pages are available. The implementation of the custom Web page inherits from requestHandler driven from ESP8266WebServer (WebServer for ESP32), so the instance of AutoConnectAux and AutoConnectElements must exist for the duration of effect of handleClient. The following example is incorrect for manipulating custom Web pages. Its AutoConnectAux instance will be destructed at the exit of the setup(). #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const auxPage[] PROGMEM = R\"raw( { \"title\": \"Page-1\", \"uri\": \"/page1\", \"menu\": true, \"element\": [ { \"name\":\"Server\", \"type\":\"ACText\", \"label\":\"Server address\" } ] } )raw\" ; AutoConnect portal; void setup () { // This declaration is wrong. AutoConnectAux aux; aux.load(auxPage); portal.join(aux); portal.begin(); } void loop () { portal.handleClient(); }","title":"Scope &amp; Lifetime of AutoConnectAux"},{"location":"achandling.html#the-uri-of-the-custom-web-pages","text":"The transition of the custom Web page follows the URI of the page, but the ESP8266WebServer class does not know the URI of an AutoConnectAux page. (Registering a custom Web page does not use the ESP8266WebServer::on / WebServer::on function.) Therefore ESP8266WebServer class does not detect its URI access. If you want to detect an http request to AutoConnectAux's custom Web page, you need to register its URI with the AutoConnectAux::on function. In addition to this, there are restrictions in the handler for the custom Web page as shown in the following section.","title":"The URI of the custom Web pages"},{"location":"achandling.html#limitations","text":"The custom Web pages handler has the following limitations. Do not send HTTP responses from the handler. If the handler returns its own response, the custom Web page will be lost. Use AutoConnectSubmit whenever possible. AutoConnect will hold the values of a custom Web Page is sent by AutoConnectSubmit. Can not handle the custom Web pages during a connection is not established yet. During the connection attempt, the web browser of the client will send a probe for a captive portal. Its request will cause unintended custom Web page transitions. Can not place URI of the custom Web pages to AUTOCONNECT_URI. AutoConnect will not work if you place a custom Web page to AUTOCONNECT_URI . Can not use the element named SUBMIT . You can not use 'SUBMIT' as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element. (Case sensitive ignored) AutoConnect does not rely on the input type=submit element for the form submission and uses HTML form element submit function instead. So, the submit function will fail if there is an element named 'submit' in the form. Do not handle for the same page Do not duplicate AutoConnect::on with ESP8266WebServer::on (also WebServer::on) for the same custom web page. window.onload = function() { Gifffer(); }; The valid scope of the name is within an AutoConnectAux. \u21a9 Regular expression specification as a pattern of AutoConnectInput is JavaScript compliant . \u21a9","title":"Limitations"},{"location":"acintro.html","text":"What it is \u00b6 AutoConnect can handle custom Web pages prepared by user sketches individually. Custom Web pages can be integrated into the AutoConnect menu and executed as menu items and can have input-output parameters and handle them. For example, you can program some sketches that publish messages by entering the URI or unique ID of the MQTT broker on a custom page. You do not need to code the processing to handle the web page. It retrieves the input parameters and passes to the MQTT broker connection API is only. How it works \u00b6 AutoConnect creates the custom Web pages dynamically at runtime. Sketch describes the custom Web pages using classes and APIs necessary for dynamic creation which are AutoConnectAux and the variant of AutoConnectElements . AutoConnectAux is an object dependent on AutoConnect, which provides an easy way to incorporate custom Web pages into AutoConnect like the one on the right figure. The elements make up a custom Web page are provided as an AutoConnectElement class. Furthermore, an input box, a check box, a submit button, etc. are implemented by classes derived from AutoConnectElement. AutoConnectAux is a container for AutoConnectElements. To make a custom Web page, create elements that make up the page and put it in the AutoConnectAux object. Joining its AutoConnectAux object to AutoConnect will integrate the custom Web page into the AutoConnect menu. The above figure shows a code sequence that declares AutoConnectElements and put in the AutoConnectAux container and integrates those into AutoConnect. It declares two text elements named header and caption , adds them to the AutoConnectAux object as aux , binds to an AutoConnect object named portal . This sequence is the basic procedure for creating custom Web pages with the sketch. The further explanation is available in section AutoConnectElements also. Custom Web pages in AutoConnect menu \u00b6 AutoConnect integrates custom Web page objects into menus as AutoConnectAux. The AutoConnectAux object contains URI and title as member variables and has an indicator to display in the AutoConnect menu. You give the title and URI of the custom Web page to the AutoConnectAux object with Sketch. Then the title of the custom Web page would be displayed in the AutoConnect menu as the left figure. 1 It is a hyperlink to a custom Web page which will be displayed tapped it. Multiple custom Web pages \u00b6 You can create multiple custom Web pages and specify pages that can be called from the menu. The following sketch shows a code sequence for integrating three custom Web pages into one and embedding them in a menu. In the above code, the third parameter of aux2 is false . The third parameter of the AutoConnectAux constructor is an indicator for whether it's shown to the AutoConnect menu. Right animation is an execution result of the above code. You will see that the menu applies only two items for three custom Web pages. The sketch of this animation is written to transition to aux2 by the utility of the AutoConnectSubmit element owned by aux1 . 2 The aux2 page transitions only from the aux1 page. As shown in mqttRSSI in the library example, its page replies the saving result for the parameters entered on the previous page. It can not be invoked directly from the menu and want to hide them with AutoConnect menu items. The utility of the third parameter of the AutoConnectAux constructor is that. Basic steps to use custom Web pages \u00b6 So, the basic procedure for handling of the custom Web pages is as follows: Create or define AutoConnectAux . Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . Perform AutoConnect::handleClient() . Write the custom Web page with JSON \u00b6 You can write the custom Web page in JSON without using sketch codes. 3 It is possible to describe the entire page in JSON and can be described for each element also. The JSON document can be saved in SPIFFS or SD and read using AutoConnect's load function. you can reduce the steps of the basic procedure with this approach, but this way consumes a lot of memory. The following JSON code and sketch will execute the custom Web page as an example in the above figure. That is, the sketch of this code and footnote 2 is equivalent. custom_page.json [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"MQTT broker settings\" }, { \"name\" : \"caption1\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi...\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"SAVE\" , \"uri\" : \"/mqtt_save\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption2\" , \"type\" : \"ACText\" , \"value\" : \"Save parameters\" }, { \"name\" : \"start\" , \"type\" : \"ACSubmit\" , \"value\" : \"START\" , \"uri\" : \"/mqtt_start\" } ] }, { \"title\" : \"MQTT Start\" , \"uri\" : \"/mqtt_start\" , \"menu\" : true , \"element\" : [] } ] The sketch #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> AutoConnect portal; void setup () { SPIFFS.begin(); File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); SPIFFS.end(); portal.begin(); } void loop () { portal.handleClient(); } Passing parameters with sketches and custom Web pages \u00b6 A sketch can access variables of AutoConnectElements on the custom Web page. The value entered into the AutoConnectElements is stored to the member variables of the element by AutoConnect whenever GET / POST transmission occurs. Your sketches can get these values with the request handler which will be registered by AutoConnect::on function. And if you assign a value to an element before a request to the page occurs, its value will appear as the initial value when the page is displayed. The details are explained in section Custom field data handling . window.onload = function() { Gifffer(); }; There is no overlay in the actual menu. \u21a9 The sketch is actually this: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; ACText(header, \"MQTT broker settings\" ); ACText(caption1, \"Publishing the WiFi...\" ); ACSubmit(save, \"SAVE\" , \"/mqtt_save\" ); AutoConnectAux aux1 ( \"/mqtt_setting\" , \"MQTT Setting\" , { header, caption1, save }); ACText(caption2, \"Save parameters\" ); ACSubmit(start, \"START\" , \"/mqtt_start\" ); AutoConnectAux aux2 ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, start }); AutoConnectAux aux3 ( \"/mqtt_start\" , \"MQTT Start\" ); void setup () { portal.join({ aux1, aux2, aux3 }); portal.begin(); } void loop () { portal.handleClient(); } \u21a9 Installation of the ArduinoJson as the latest release of version 5 series is required. \u21a9","title":"Custom Web pages with AutoConnect"},{"location":"acintro.html#what-it-is","text":"AutoConnect can handle custom Web pages prepared by user sketches individually. Custom Web pages can be integrated into the AutoConnect menu and executed as menu items and can have input-output parameters and handle them. For example, you can program some sketches that publish messages by entering the URI or unique ID of the MQTT broker on a custom page. You do not need to code the processing to handle the web page. It retrieves the input parameters and passes to the MQTT broker connection API is only.","title":"What it is"},{"location":"acintro.html#how-it-works","text":"AutoConnect creates the custom Web pages dynamically at runtime. Sketch describes the custom Web pages using classes and APIs necessary for dynamic creation which are AutoConnectAux and the variant of AutoConnectElements . AutoConnectAux is an object dependent on AutoConnect, which provides an easy way to incorporate custom Web pages into AutoConnect like the one on the right figure. The elements make up a custom Web page are provided as an AutoConnectElement class. Furthermore, an input box, a check box, a submit button, etc. are implemented by classes derived from AutoConnectElement. AutoConnectAux is a container for AutoConnectElements. To make a custom Web page, create elements that make up the page and put it in the AutoConnectAux object. Joining its AutoConnectAux object to AutoConnect will integrate the custom Web page into the AutoConnect menu. The above figure shows a code sequence that declares AutoConnectElements and put in the AutoConnectAux container and integrates those into AutoConnect. It declares two text elements named header and caption , adds them to the AutoConnectAux object as aux , binds to an AutoConnect object named portal . This sequence is the basic procedure for creating custom Web pages with the sketch. The further explanation is available in section AutoConnectElements also.","title":"How it works"},{"location":"acintro.html#custom-web-pages-in-autoconnect-menu","text":"AutoConnect integrates custom Web page objects into menus as AutoConnectAux. The AutoConnectAux object contains URI and title as member variables and has an indicator to display in the AutoConnect menu. You give the title and URI of the custom Web page to the AutoConnectAux object with Sketch. Then the title of the custom Web page would be displayed in the AutoConnect menu as the left figure. 1 It is a hyperlink to a custom Web page which will be displayed tapped it.","title":"Custom Web pages in AutoConnect menu"},{"location":"acintro.html#multiple-custom-web-pages","text":"You can create multiple custom Web pages and specify pages that can be called from the menu. The following sketch shows a code sequence for integrating three custom Web pages into one and embedding them in a menu. In the above code, the third parameter of aux2 is false . The third parameter of the AutoConnectAux constructor is an indicator for whether it's shown to the AutoConnect menu. Right animation is an execution result of the above code. You will see that the menu applies only two items for three custom Web pages. The sketch of this animation is written to transition to aux2 by the utility of the AutoConnectSubmit element owned by aux1 . 2 The aux2 page transitions only from the aux1 page. As shown in mqttRSSI in the library example, its page replies the saving result for the parameters entered on the previous page. It can not be invoked directly from the menu and want to hide them with AutoConnect menu items. The utility of the third parameter of the AutoConnectAux constructor is that.","title":"Multiple custom Web pages"},{"location":"acintro.html#basic-steps-to-use-custom-web-pages","text":"So, the basic procedure for handling of the custom Web pages is as follows: Create or define AutoConnectAux . Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . Perform AutoConnect::handleClient() .","title":"Basic steps to use custom Web pages"},{"location":"acintro.html#write-the-custom-web-page-with-json","text":"You can write the custom Web page in JSON without using sketch codes. 3 It is possible to describe the entire page in JSON and can be described for each element also. The JSON document can be saved in SPIFFS or SD and read using AutoConnect's load function. you can reduce the steps of the basic procedure with this approach, but this way consumes a lot of memory. The following JSON code and sketch will execute the custom Web page as an example in the above figure. That is, the sketch of this code and footnote 2 is equivalent. custom_page.json [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"MQTT broker settings\" }, { \"name\" : \"caption1\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi...\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"SAVE\" , \"uri\" : \"/mqtt_save\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption2\" , \"type\" : \"ACText\" , \"value\" : \"Save parameters\" }, { \"name\" : \"start\" , \"type\" : \"ACSubmit\" , \"value\" : \"START\" , \"uri\" : \"/mqtt_start\" } ] }, { \"title\" : \"MQTT Start\" , \"uri\" : \"/mqtt_start\" , \"menu\" : true , \"element\" : [] } ] The sketch #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> AutoConnect portal; void setup () { SPIFFS.begin(); File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); SPIFFS.end(); portal.begin(); } void loop () { portal.handleClient(); }","title":"Write the custom Web page with JSON"},{"location":"acintro.html#passing-parameters-with-sketches-and-custom-web-pages","text":"A sketch can access variables of AutoConnectElements on the custom Web page. The value entered into the AutoConnectElements is stored to the member variables of the element by AutoConnect whenever GET / POST transmission occurs. Your sketches can get these values with the request handler which will be registered by AutoConnect::on function. And if you assign a value to an element before a request to the page occurs, its value will appear as the initial value when the page is displayed. The details are explained in section Custom field data handling . window.onload = function() { Gifffer(); }; There is no overlay in the actual menu. \u21a9 The sketch is actually this: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; ACText(header, \"MQTT broker settings\" ); ACText(caption1, \"Publishing the WiFi...\" ); ACSubmit(save, \"SAVE\" , \"/mqtt_save\" ); AutoConnectAux aux1 ( \"/mqtt_setting\" , \"MQTT Setting\" , { header, caption1, save }); ACText(caption2, \"Save parameters\" ); ACSubmit(start, \"START\" , \"/mqtt_start\" ); AutoConnectAux aux2 ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, start }); AutoConnectAux aux3 ( \"/mqtt_start\" , \"MQTT Start\" ); void setup () { portal.join({ aux1, aux2, aux3 }); portal.begin(); } void loop () { portal.handleClient(); } \u21a9 Installation of the ArduinoJson as the latest release of version 5 series is required. \u21a9","title":"Passing parameters with sketches and custom Web pages"},{"location":"acjson.html","text":"You can embed custom Web pages written in JSON into AutoConnect without AutoConnectAux & AutoConnectElements declaration. Custom Web page declaration by JSON can embed in the sketch as a fixed string or can store in the external file such as SPIFFS for stream loading. Also, you can also load and save AutoConnectElements objects individually. 1 By providing the following JSON document to AutoConnect, you can include the custom Web page like the below: A JSON document for AutoConnect can contain the custom Web page multiple. You can further reduce the sketch process by loading multiple pages of JSON document at once. Adopt ArduinoJson v5 or v6 To handle AutoConnectAux and AutoConnectElements written in JSON, you need to install the ArduinoJson library. You can adopt either version 5 or version 6 for the ArduinoJson. AutoConnect supports both versions. JSON objects & elements for the custom Web page \u00b6 JSON document structure for AutoConnectAux \u00b6 AutoConnectAux will configure custom Web pages with JSON objects. The elements that make up the object are as follows: { \"title\" : title , \"uri\" : uri , \"menu\" : true | false , \"element\" : element_array } title \u00b6 A title of the custom Web page. This is string value. String specified title will be displayed in the AutoConnection menu. uri \u00b6 String of URI path that specifies where to place the custom Web page. It needs to be a location from the root path including ' / '. menu \u00b6 This is a Boolean value indicating whether to include the custom Web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu. element \u00b6 Describe an array of JSON objects as element_array . It is a JSON object array of the AutoConnectElements that make up the custom Web page. Order of elements on a custom Web page The order in which AutoConnectElements are placed on a custom Web page is the order in the JSON document. Multiple custom Web pages declaration in JSON document \u00b6 You can put declarations of multiple custom Web pages in one JSON document. In that case, declare an array of each custom Web page with JSON. The following JSON document contains three custom Web pages: [ { \"title\" : \"Page 1 title\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page2\" } ] }, { \"title\" : \"Page 1 title\" , \"uri\" : \"/page2\" , \"menu\" : false , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"Good day\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page3\" } ] }, { \"title\" : \"Page 3 title\" , \"uri\" : \"/page3\" , \"menu\" : true , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"bye\" } ] } ] The above custom Web page definitions can be loaded in a batch using the AutoConnect::load function. JSON object for AutoConnectElements \u00b6 JSON description for AutoConnectElements describes as an array in the element with arguments of each constructor . { \"name\" : name , \"type\" : type , key_according_to_type : the_value | array_of_value , [ key_according_to_type : the_value | array_of_value ] } name \u00b6 A string of the name for the element. type \u00b6 A string of the type for the element. For this type, specify the following string corresponding to each element. AutoConnectButton: ACButton AutoConnectCheckbox: ACCheckbox AutoConnectElement: ACElement AutoConnectFile: ACFile AutoConnectInput: ACInput AutoConnectRadio: ACRadio AutoConnectSelect: ACSelect AutoConnectStyle: ACStyle AutoConnectSubmit: ACSubmit AutoConnectText: ACText key_according_to_type \u00b6 This is different for each AutoConnectElements, and the key that can be specified by the type of AutoConnectElements is determined. ACButton \u00b6 value : Specifies the button label. This value also applies to the value attribute of an HTML button tag. action : Specifies an action to be fire on a mouse click on the button. It is mostly used with a JavaScript to activate a script, or it directly describes a JavaScript. ACCheckbox \u00b6 value : Specifies the value to be supplied to the checkbox. It will be packed in the query string as name=value when the checkbox is ticked. label : Specifies a label of the checkbox. Its placement is always to the right of the checkbox. checked : Specifies checking status as a boolean value. The value of the checked checkbox element is packed in the query string and sent. ACElement \u00b6 value : Specifies the source code of generating HTML. The value is native HTML code and is output as HTML as it is. ACFile \u00b6 value : The file name of the upload file will be stored. The value is read-only and will be ignored if specified. label : Specifies a label of the file selection box. Its placement is always to the left of the file selection box. store : Specifies the destination to save the uploaded file. Its value accepts one of the following: fs : Save as the SPIFFS file in flash of ESP8266/ESP32 module. sd : Save to an external SD device connected to ESP8266/ESP32 module. extern : Pass the content of the uploaded file to the uploader which is declared by the sketch individually. Its uploader must inherit AutoConnectUploadHandler class and implements _open , _write and _close function. ACInput \u00b6 value : Specifies the initial text string of the input box. If this value is omitted, placeholder is displayed as the initial string. label : Specifies a label of the input box. Its placement is always to the left of the input box. placeholder : Specifies short hint of the input box. ACRadio \u00b6 value : Specifies the collection of radio buttons as an array element. label : Specifies a label of the collection of radio buttons, not for each button. The arrangement will be the top or left side according to the arrange . arrange : Specifies the orientation of the radio buttons. Its value accepts one of the following: horizontal : Horizontal arrangement. vertical : Vertical arrangement. checked : Specifies the index number (1-based) of the radio buttons collection to be checked. ACSelect \u00b6 label : Specifies a label of the drop-down list. Its placement is always to the left of the drop-down list. option : Specifies the initial value collection of the drop-down list as an array element. ACStyle \u00b6 value : Specifies the custom CSS code. ACSubmit \u00b6 value : Specifies a label of the submit button. uri : Specifies the URI to send form data when the button is clicked. ACText \u00b6 value : Specifies a content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style : Specifies the qualification style to give to the content and can use the style attribute format as it is. format : Specifies how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to the C-style printf library functions, but depends on the espressif sdk implementation. The conversion specification is valid only for %s format. (Left and Right justification, width are also valid.) AutoConnect's JSON parsing process is not perfect It is based on analysis by ArduinoJson, but the semantic analysis is simplified to save memory. Consequently, it is not an error that a custom Web page JSON document to have unnecessary keys. It will be ignored. Loading JSON document \u00b6 Loading to AutoConnect \u00b6 There are two main ways to load the custom Web pages into AutoConnect. Load directly into AutoConnect This way does not require an explicit declaration of AutoConnectAux objects with sketches and is also useful when importing the custom Web pages JSON document from an external file such as SPIFFS because the page definition and sketch coding structure can be separated. Using the AutoCoonnect::load function, AutoConnect dynamically generates the necessary AutoConnectAux objects internally based on the custom Web page definition of the imported JSON document content. In the sketch, the generated AutoConnectAux object can be referenced using the AutoConnect::aux function. You can reach the AutoConnectElements you desired using the AutoConnectAux::getElement function of its AutoConnectAux. In the following example, it loads in a batch a JSON document of custom Web pages stored in SPIFFS and accesses to the AutoConnectInput element. [ { \"title\" : \"page1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" } ] }, { \"title\" : \"page2\" , \"uri\" : \"/page2\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input2\" , \"type\" : \"ACInput\" } ] } ] AutoConnect portal; File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); AutoConnectAux * aux = portal.aux( \"/page1\" ); AutoConnectInput & input1 = aux -> getElement < AutoConnectInput > ( \"input1\" ); Load to AutoConnectAux and join to AutoConnect This way declares AutoConnectAux in the sketch and loads the custom Web pages JSON document there. It has an advantage for if you want to define each page of a custom Web page individually or allocate AutoConnectAux objects dynamically on the sketch side. After loading a JSON document using the AutoConnectAux::load function by each, integrate those into AutoConnect using the AutoConnect::join function. In the following example, you can see the difference between two sketches in a sketch modified using the AutoConnectAux::load. { \"title\" : \"page1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" } ] } { \"title\" : \"page2\" , \"uri\" : \"/page2\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input2\" , \"type\" : \"ACInput\" } ] } AutoConnect portal; AutoConnectAux page1; AutoConnectAux page2; File page = SPIFFS.open( \"/custom_page1.json\" , \"r\" ); page1.load(page); page.close(); page = SPIFFS.open( \"/custom_page2.json\" , \"r\" ); page2.load(page); page.close(); portal.join( { page1, page2 } ); AutoConnectInput & input1 = page1.getElement < AutoConnectInput > ( \"input1\" ); Loading from the streamed file \u00b6 AutoConnect supports loading of JSON document from the following instances: String PROGMEM Stream To load custom Web pages JSON document into AutoConnect, use the load function of the AutoConnect class. Its JSON document can read must be completed as a description interpretable by the ArduinoJson library. It cannot import custom Web pages if there are syntax errors for the JSON. If you can not see the custom Web page prepared by JSON, you can check the syntax with ArduinoJson Assistant . It is useful for pre-checking. bool AutoConnect :: load( const String & aux) bool AutoConnect :: load( const __FlashStringHelper * aux) bool AutoConnect :: load(Stream & aux) An example of using each function is as follows. AutoConnect portal; // Loading from String const String aux = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); portal.load(aux); // Loading from PROGMEM const char aux[] PROGMEM = R\"raw( { \"title\" : \"Page 1 title\", \"uri\" : \"/page1\", \"menu\" : true, \"element\" : [ { \"name\" : \"caption\", \"type\" : \"ACText\", \"value\" : \"hello, world\" } ] } )raw\" ; portal.load(aux); // Loading from Stream assumes \"aux.json\" file should be store in SPIFFS. File aux = SPIFFS.open( \"aux.json\" , \"r\" ); portal.load(aux); aux.close(); AutoConnect passes the given JSON document directly to the parseObject() function of the ArduinoJson library for parsing. Therefore, the constraint of the parseObject() function is applied as it is in the parsing of the JSON document for the AutoConnect. That is, if the JSON string is read-only, duplicating the input string occurs and consumes more memory. Adjust the JSON document buffer size \u00b6 AutoConnect uses ArduinoJson library's dynamic buffer to parse JSON documents. Its dynamic buffer allocation scheme depends on the version 5 or version 6 of ArduinoJson library. Either version must have enough buffer to parse the custom web page's JSON document successfully. AutoConnect has the following three constants internally to complete the parsing as much as possible in both ArduinoJson version. These constants are macro defined in AutoConnectDefs.h . If memory insufficiency occurs during JSON document parsing, you can adjust these constants to avoid insufficiency by using the JsonAssistant with deriving the required buffer size in advance. #define AUTOCONNECT_JSONBUFFER_SIZE 256 #define AUTOCONNECT_JSONDOCUMENT_SIZE (8 * 1024) #define AUTOCONNECT_JSONPSRAM_SIZE (16* 1024) AUTOCONNECT_JSONBUFFER_SIZE \u00b6 This is a unit size constant of DynamicJsonBuffer and works when the library used is ArduinoJson version 5. A buffer size of the JSON document increases with this unit. This value relates to the impact of the fragmented heap area. If it is too large, may occur run-out of memory. AUTOCONNECT_JSONDOCUMENT_SIZE \u00b6 This is a size of DynamicJsonDocument for ArduinoJson version 6. This buffer is not automatically expanding, and the size determines the limit. AUTOCONNECT_JSONPSRAM_SIZE \u00b6 For ESP32 module equips with PSRAM, you can allocate the JSON document buffer to PSRAM. Buffer allocation to PSRAM will enable when PSRAM:Enabled option selected in the Arduino IDE's Board Manager menu. It is available since ArduinoJson 6.10.0. Saving JSON document \u00b6 The sketch can persist AutoConnectElements as a JSON document and also uses this function to save the values \u200b\u200bentered on the custom Web page. And you can reload the saved JSON document into AutoConnectElements as the field in a custom Web page using the load function . Loading and saving AutoConnect parameters adopt this method. \u21a9","title":"Custom Web pages with JSON"},{"location":"acjson.html#json-objects-elements-for-the-custom-web-page","text":"","title":"JSON objects &amp; elements for the custom Web page"},{"location":"acjson.html#json-document-structure-for-autoconnectaux","text":"AutoConnectAux will configure custom Web pages with JSON objects. The elements that make up the object are as follows: { \"title\" : title , \"uri\" : uri , \"menu\" : true | false , \"element\" : element_array }","title":" JSON document structure for AutoConnectAux"},{"location":"acjson.html#title","text":"A title of the custom Web page. This is string value. String specified title will be displayed in the AutoConnection menu.","title":" title"},{"location":"acjson.html#uri","text":"String of URI path that specifies where to place the custom Web page. It needs to be a location from the root path including ' / '.","title":" uri"},{"location":"acjson.html#menu","text":"This is a Boolean value indicating whether to include the custom Web page in the AutoConnect menu. If the page only responds to another page and you want to prevent the direct use from the menu, you can exclude from the AutoConnect menu. If this key is false, it will not appear in the menu.","title":" menu"},{"location":"acjson.html#element","text":"Describe an array of JSON objects as element_array . It is a JSON object array of the AutoConnectElements that make up the custom Web page. Order of elements on a custom Web page The order in which AutoConnectElements are placed on a custom Web page is the order in the JSON document.","title":" element"},{"location":"acjson.html#multiple-custom-web-pages-declaration-in-json-document","text":"You can put declarations of multiple custom Web pages in one JSON document. In that case, declare an array of each custom Web page with JSON. The following JSON document contains three custom Web pages: [ { \"title\" : \"Page 1 title\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"hello, world\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page2\" } ] }, { \"title\" : \"Page 1 title\" , \"uri\" : \"/page2\" , \"menu\" : false , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"Good day\" }, { \"name\" : \"send\" , \"type\" : \"ACSubmit\" , \"uri\" : \"/page3\" } ] }, { \"title\" : \"Page 3 title\" , \"uri\" : \"/page3\" , \"menu\" : true , \"element\" : [ { \"name\" : \"responds\" , \"type\" : \"ACText\" , \"value\" : \"bye\" } ] } ] The above custom Web page definitions can be loaded in a batch using the AutoConnect::load function.","title":" Multiple custom Web pages declaration in JSON document"},{"location":"acjson.html#json-object-for-autoconnectelements","text":"JSON description for AutoConnectElements describes as an array in the element with arguments of each constructor . { \"name\" : name , \"type\" : type , key_according_to_type : the_value | array_of_value , [ key_according_to_type : the_value | array_of_value ] }","title":" JSON object for AutoConnectElements"},{"location":"acjson.html#name","text":"A string of the name for the element.","title":" name"},{"location":"acjson.html#type","text":"A string of the type for the element. For this type, specify the following string corresponding to each element. AutoConnectButton: ACButton AutoConnectCheckbox: ACCheckbox AutoConnectElement: ACElement AutoConnectFile: ACFile AutoConnectInput: ACInput AutoConnectRadio: ACRadio AutoConnectSelect: ACSelect AutoConnectStyle: ACStyle AutoConnectSubmit: ACSubmit AutoConnectText: ACText","title":" type"},{"location":"acjson.html#key_according_to_type","text":"This is different for each AutoConnectElements, and the key that can be specified by the type of AutoConnectElements is determined.","title":" key_according_to_type"},{"location":"acjson.html#acbutton","text":"value : Specifies the button label. This value also applies to the value attribute of an HTML button tag. action : Specifies an action to be fire on a mouse click on the button. It is mostly used with a JavaScript to activate a script, or it directly describes a JavaScript.","title":" ACButton"},{"location":"acjson.html#accheckbox","text":"value : Specifies the value to be supplied to the checkbox. It will be packed in the query string as name=value when the checkbox is ticked. label : Specifies a label of the checkbox. Its placement is always to the right of the checkbox. checked : Specifies checking status as a boolean value. The value of the checked checkbox element is packed in the query string and sent.","title":" ACCheckbox"},{"location":"acjson.html#acelement","text":"value : Specifies the source code of generating HTML. The value is native HTML code and is output as HTML as it is.","title":" ACElement"},{"location":"acjson.html#acfile","text":"value : The file name of the upload file will be stored. The value is read-only and will be ignored if specified. label : Specifies a label of the file selection box. Its placement is always to the left of the file selection box. store : Specifies the destination to save the uploaded file. Its value accepts one of the following: fs : Save as the SPIFFS file in flash of ESP8266/ESP32 module. sd : Save to an external SD device connected to ESP8266/ESP32 module. extern : Pass the content of the uploaded file to the uploader which is declared by the sketch individually. Its uploader must inherit AutoConnectUploadHandler class and implements _open , _write and _close function.","title":" ACFile"},{"location":"acjson.html#acinput","text":"value : Specifies the initial text string of the input box. If this value is omitted, placeholder is displayed as the initial string. label : Specifies a label of the input box. Its placement is always to the left of the input box. placeholder : Specifies short hint of the input box.","title":" ACInput"},{"location":"acjson.html#acradio","text":"value : Specifies the collection of radio buttons as an array element. label : Specifies a label of the collection of radio buttons, not for each button. The arrangement will be the top or left side according to the arrange . arrange : Specifies the orientation of the radio buttons. Its value accepts one of the following: horizontal : Horizontal arrangement. vertical : Vertical arrangement. checked : Specifies the index number (1-based) of the radio buttons collection to be checked.","title":" ACRadio"},{"location":"acjson.html#acselect","text":"label : Specifies a label of the drop-down list. Its placement is always to the left of the drop-down list. option : Specifies the initial value collection of the drop-down list as an array element.","title":" ACSelect"},{"location":"acjson.html#acstyle","text":"value : Specifies the custom CSS code.","title":" ACStyle"},{"location":"acjson.html#acsubmit","text":"value : Specifies a label of the submit button. uri : Specifies the URI to send form data when the button is clicked.","title":" ACSubmit"},{"location":"acjson.html#actext","text":"value : Specifies a content and also can contain the native HTML code, but remember that your written code is enclosed by the div tag. style : Specifies the qualification style to give to the content and can use the style attribute format as it is. format : Specifies how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to the C-style printf library functions, but depends on the espressif sdk implementation. The conversion specification is valid only for %s format. (Left and Right justification, width are also valid.) AutoConnect's JSON parsing process is not perfect It is based on analysis by ArduinoJson, but the semantic analysis is simplified to save memory. Consequently, it is not an error that a custom Web page JSON document to have unnecessary keys. It will be ignored.","title":" ACText"},{"location":"acjson.html#loading-json-document","text":"","title":"Loading JSON document"},{"location":"acjson.html#loading-to-autoconnect","text":"There are two main ways to load the custom Web pages into AutoConnect. Load directly into AutoConnect This way does not require an explicit declaration of AutoConnectAux objects with sketches and is also useful when importing the custom Web pages JSON document from an external file such as SPIFFS because the page definition and sketch coding structure can be separated. Using the AutoCoonnect::load function, AutoConnect dynamically generates the necessary AutoConnectAux objects internally based on the custom Web page definition of the imported JSON document content. In the sketch, the generated AutoConnectAux object can be referenced using the AutoConnect::aux function. You can reach the AutoConnectElements you desired using the AutoConnectAux::getElement function of its AutoConnectAux. In the following example, it loads in a batch a JSON document of custom Web pages stored in SPIFFS and accesses to the AutoConnectInput element. [ { \"title\" : \"page1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" } ] }, { \"title\" : \"page2\" , \"uri\" : \"/page2\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input2\" , \"type\" : \"ACInput\" } ] } ] AutoConnect portal; File page = SPIFFS.open( \"/custom_page.json\" , \"r\" ); portal.load(page); page.close(); AutoConnectAux * aux = portal.aux( \"/page1\" ); AutoConnectInput & input1 = aux -> getElement < AutoConnectInput > ( \"input1\" ); Load to AutoConnectAux and join to AutoConnect This way declares AutoConnectAux in the sketch and loads the custom Web pages JSON document there. It has an advantage for if you want to define each page of a custom Web page individually or allocate AutoConnectAux objects dynamically on the sketch side. After loading a JSON document using the AutoConnectAux::load function by each, integrate those into AutoConnect using the AutoConnect::join function. In the following example, you can see the difference between two sketches in a sketch modified using the AutoConnectAux::load. { \"title\" : \"page1\" , \"uri\" : \"/page1\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input1\" , \"type\" : \"ACInput\" } ] } { \"title\" : \"page2\" , \"uri\" : \"/page2\" , \"menu\" : true , \"element\" : [ { \"name\" : \"input2\" , \"type\" : \"ACInput\" } ] } AutoConnect portal; AutoConnectAux page1; AutoConnectAux page2; File page = SPIFFS.open( \"/custom_page1.json\" , \"r\" ); page1.load(page); page.close(); page = SPIFFS.open( \"/custom_page2.json\" , \"r\" ); page2.load(page); page.close(); portal.join( { page1, page2 } ); AutoConnectInput & input1 = page1.getElement < AutoConnectInput > ( \"input1\" );","title":" Loading to AutoConnect"},{"location":"acjson.html#loading-from-the-streamed-file","text":"AutoConnect supports loading of JSON document from the following instances: String PROGMEM Stream To load custom Web pages JSON document into AutoConnect, use the load function of the AutoConnect class. Its JSON document can read must be completed as a description interpretable by the ArduinoJson library. It cannot import custom Web pages if there are syntax errors for the JSON. If you can not see the custom Web page prepared by JSON, you can check the syntax with ArduinoJson Assistant . It is useful for pre-checking. bool AutoConnect :: load( const String & aux) bool AutoConnect :: load( const __FlashStringHelper * aux) bool AutoConnect :: load(Stream & aux) An example of using each function is as follows. AutoConnect portal; // Loading from String const String aux = String( \"{ \\\" title \\\" : \\\" Page 1 title \\\" , \\\" uri \\\" : \\\" /page1 \\\" , \\\" menu \\\" :true, \\\" element \\\" :[{ \\\" name \\\" : \\\" caption \\\" , \\\" type \\\" : \\\" ACText \\\" , \\\" value \\\" : \\\" hello, world \\\" }]}\" ); portal.load(aux); // Loading from PROGMEM const char aux[] PROGMEM = R\"raw( { \"title\" : \"Page 1 title\", \"uri\" : \"/page1\", \"menu\" : true, \"element\" : [ { \"name\" : \"caption\", \"type\" : \"ACText\", \"value\" : \"hello, world\" } ] } )raw\" ; portal.load(aux); // Loading from Stream assumes \"aux.json\" file should be store in SPIFFS. File aux = SPIFFS.open( \"aux.json\" , \"r\" ); portal.load(aux); aux.close(); AutoConnect passes the given JSON document directly to the parseObject() function of the ArduinoJson library for parsing. Therefore, the constraint of the parseObject() function is applied as it is in the parsing of the JSON document for the AutoConnect. That is, if the JSON string is read-only, duplicating the input string occurs and consumes more memory.","title":" Loading from the streamed file"},{"location":"acjson.html#adjust-the-json-document-buffer-size","text":"AutoConnect uses ArduinoJson library's dynamic buffer to parse JSON documents. Its dynamic buffer allocation scheme depends on the version 5 or version 6 of ArduinoJson library. Either version must have enough buffer to parse the custom web page's JSON document successfully. AutoConnect has the following three constants internally to complete the parsing as much as possible in both ArduinoJson version. These constants are macro defined in AutoConnectDefs.h . If memory insufficiency occurs during JSON document parsing, you can adjust these constants to avoid insufficiency by using the JsonAssistant with deriving the required buffer size in advance. #define AUTOCONNECT_JSONBUFFER_SIZE 256 #define AUTOCONNECT_JSONDOCUMENT_SIZE (8 * 1024) #define AUTOCONNECT_JSONPSRAM_SIZE (16* 1024)","title":" Adjust the JSON document buffer size"},{"location":"acjson.html#autoconnect_jsonbuffer_size","text":"This is a unit size constant of DynamicJsonBuffer and works when the library used is ArduinoJson version 5. A buffer size of the JSON document increases with this unit. This value relates to the impact of the fragmented heap area. If it is too large, may occur run-out of memory.","title":"AUTOCONNECT_JSONBUFFER_SIZE"},{"location":"acjson.html#autoconnect_jsondocument_size","text":"This is a size of DynamicJsonDocument for ArduinoJson version 6. This buffer is not automatically expanding, and the size determines the limit.","title":"AUTOCONNECT_JSONDOCUMENT_SIZE"},{"location":"acjson.html#autoconnect_jsonpsram_size","text":"For ESP32 module equips with PSRAM, you can allocate the JSON document buffer to PSRAM. Buffer allocation to PSRAM will enable when PSRAM:Enabled option selected in the Arduino IDE's Board Manager menu. It is available since ArduinoJson 6.10.0.","title":"AUTOCONNECT_JSONPSRAM_SIZE"},{"location":"acjson.html#saving-json-document","text":"The sketch can persist AutoConnectElements as a JSON document and also uses this function to save the values \u200b\u200bentered on the custom Web page. And you can reload the saved JSON document into AutoConnectElements as the field in a custom Web page using the load function . Loading and saving AutoConnect parameters adopt this method. \u21a9","title":"Saving JSON document"},{"location":"acupload.html","text":"Uploading file from Web Browser \u00b6 If you have to write some data individually to the ESP8266/ESP32 module for the sketch behavior, the AutoConnectFile element will assist with your wants implementation. The AutoConnectFile element produces an HTML <input type=\"file\"> tag and can save uploaded file to the flash or external SD of the ESP8266/ESP32 module. The handler for saving is built into AutoConnect. You can use it to inject any sketch data such as the initial values for the custom Web page into the ESP module via OTA without using the sketch data upload tool of Arduino-IDE. Basic steps of the file upload sketch \u00b6 Here is the basic procedure of the sketch which can upload files from the client browser using AutoConnectFile: 1 Place AutoConnectFile on a custom Web page by writing JSON or constructor code directly with the sketch. Place other AutoConnectElements as needed. Place AutoConnectSubmit on the same custom Web page. Perform the following process in the on-handler of submitting destination: Retrieve the AutoConnectFile instance from the custom Web page where you placed the AutoConnectFile element using the AutoConnectAux::getElement function or the operator [] . Start access to the device specified as the upload destination. In usually, it depends on the file system's begin function. For example, if you specified Flash's SPIFFS as the upload destination, invokes SPIFFS.begin() . The value member of AutoConnectFile contains the file name of the upload file. Use its file name to access the uploaded file on the device. Invokes the end function associated with the begin to close the device. It is the SPIFFS.end()* if the flash on the ESP module has been begun for SPIFFS. The following sketch is an example that implements the above basic steps. The postUpload function is the on-handler and retrieves the AutoConnectFile as named upload_file . You should note that this handler is not for a custom Web page placed with its AutoConnectFile element. The uploaded file should be processed by the handler for the transition destination page from the AutoConnectFile element placed page. AutoConnect built-in upload handler will save the uploaded file to the specified device before invoking the postUpload function. However, If you use uploaded files in different situations, it may be more appropriate to place the actual handling process outside the handler. It applies for the parameter file, etc. The important thing is that you do not have to sketch file reception and storing logic by using the AutoConnectFile element and the upload handler built into the AutoConnect. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> // Upload request custom Web page static const char PAGE_UPLOAD[] PROGMEM = R\"( { \"uri\": \"/\", \"title\": \"Upload\", \"menu\": true, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading platform<h2>\" }, { \"name\":\"upload_file\", \"type\":\"ACFile\", \"label\":\"Select file: \", \"store\":\"fs\" }, { \"name\":\"upload\", \"type\":\"ACSubmit\", \"value\":\"UPLOAD\", \"uri\":\"/upload\" } ] } )\" ; // Upload result display static const char PAGE_BROWSE[] PROGMEM = R\"( { \"uri\": \"/upload\", \"title\": \"Upload\", \"menu\": false, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>Uploading ended<h2>\" }, { \"name\":\"filename\", \"type\":\"ACText\" }, { \"name\":\"size\", \"type\":\"ACText\", \"format\":\"%s bytes uploaded\" }, { \"name\":\"content_type\", \"type\":\"ACText\", \"format\":\"Content: %s\" } ] } )\" ; ESP8266WebServer server; AutoConnect portal (server); // Declare AutoConnectAux separately as a custom web page to access // easily for each page in the post-upload handler. AutoConnectAux auxUpload; AutoConnectAux auxBrowse; /** * Post uploading, AutoConnectFile's built-in upload handler reads the * file saved in SPIFFS and displays the file contents on /upload custom * web page. However, only files with mime type uploaded as text are * displayed. A custom web page handler is called after upload. * @param aux AutoConnectAux(/upload) * @param args PageArgument * @return Uploaded text content */ String postUpload (AutoConnectAux & aux, PageArgument & args) { String content; AutoConnectFile & upload = auxUpload[ \"upload_file\" ].as < AutoConnectFile > (); AutoConnectText & aux_filename = aux[ \"filename\" ].as < AutoConnectText > (); AutoConnectText & aux_size = aux[ \"size\" ].as < AutoConnectText > (); AutoConnectText & aux_contentType = aux[ \"content_type\" ].as < AutoConnectText > (); // Assignment operator can be used for the element attribute. aux_filename.value = upload.value; aux_size.value = String(upload.size); aux_contentType.value = upload.mimeType; // The file saved by the AutoConnect upload handler is read from // the EEPROM and echoed to a custom web page. SPIFFS.begin(); File uploadFile = SPIFFS.open(String( \"/\" + upload.value).c_str(), \"r\" ); if (uploadFile) { while (uploadFile.available()) { char c = uploadFile.read(); Serial.print(c); } uploadFile.close(); } else content = \"Not saved\" ; SPIFFS.end(); return String(); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); auxUpload.load(PAGE_UPLOAD); auxBrowse.load(PAGE_BROWSE); portal.join({ auxUpload, auxBrowse }); auxBrowse.on(postUpload); portal.begin(); } void loop () { portal.handleClient(); } Where will the file upload \u00b6 The AutoConnect built-in upload handler can save the upload file to three locations: Flash memory embedded in the ESP8266/ESP32 module SD device externally connected to the ESP8266/ESP32 module Other character devices You can specify the device type to save with the store attribute of AutoConnectFile, and it accepts the following values: Flash : AC_File_FS for the API parameter or fs for the JSON document SD : AC_File_SD for the API parameter or sd for the JSON document Other : AC_File_Extern for the API parameter or extern for the JSON document The substance of AC_File_FS (fs) is a SPIFFS file system implemented by the ESP8266/ESP32 core, and then AutoConnect uses the Global Instance SPIFFS to access SPIFFS. Also, the substance of AC_File_SD (sd) is a FAT file of Arduino SD library ported to the ESP8266/ESP32 core, and then AutoConnect uses the Global Instance SD to access SD. When saving to an external SD device, there are additional required parameters for the connection interface and is defined as the macro in AutoConnectDefs.h. #define AUTOCONNECT_SD_CS SS #define AUTOCONNECT_SD_SPEED 4000000 AUTOCONNECT_SD_CS defines which GPIO for the CS (Chip Select, or SS as Slave Select) pin. This definition is derived from pins_arduino.h, which is included in the Arduino core distribution. If you want to assign the CS pin to another GPIO, you need to change the macro definition of AutoConnectDefs.h. AUTOCONNECT_SD_SPEED defines SPI clock speed depending on the connected device. Involves both the begin() and the end() The built-in uploader executes the begin and end functions regardless of the sketch whence the file system of the device will terminate with the uploader termination. Therefore, to use the device in the sketch after uploading, you need to restart it with the begin function. When it will be uploaded \u00b6 Upload handler will be launched by ESP8266WebServer/WebServer(as ESP32) library which is triggered by receiving an HTTP stream of POST BODY including file content. Its launching occurs before invoking the page handler. The following diagram illustrates the file uploading sequence: At the time of the page handler behaves, the uploaded file already saved to the device, and the member variables of AutoConnectFile reflects the file name and transfer size. The file name for the uploaded file \u00b6 AutoConnetFile saves the uploaded file with the file name you selected by <input type=\"file\"> tag on the browser. The file name used for uploading is stored in the AutoConnetFile's value member, which you can access after uploading. (i.e. In the handler of the destination page by the AutoConnectSubmit element.) You can not save it with a different name. It can be renamed after upload if you need to change the name. Upload to a device other than Flash or SD \u00b6 You can output the file to any device using a custom uploader by specifying extern with the store attribute of AutoConnectFile (or specifying AC_File_Extern for the store member variable) and can customize the uploader according to the need to upload files to other than Flash or SD. Implements your own uploader with inheriting the AutoConnectUploadHandler class which is the base class of the upload handler. It's not so difficult Implementing the custom uploader requires a little knowledge of the c++ language. If you are less attuned to programming c++, you may find it difficult. But don't worry. You can make it in various situations by just modifying the sketch skeleton that appears at the end of this page. Upload handler base class \u00b6 AutoConnectUploadHandler is a base class of upload handler and It has one public member function and three protected functions. Constructor \u00b6 AutoConnectUploadHandler() Member functions \u00b6 The upload public function is an entry point, the ESP8266WebServer (WebServer as ESP32) library will invoke the upload with each time of uploading content divided into chunks. Also, the _open , _write and _close protected functions are actually responsible for saving files and are declared as pure virtual functions. A custom uploader class that inherits from the AutoConnectUploadHandler class need to implement these functions. The actual upload process is handled by the three private functions above, and then upload only invokes three functions according to the upload situation. In usually, there is no need to override the upload function in an inherited class. public virtual void upload( const String & requestUri, const HTTPUpload & upload) Parameters requestUri URI of upload request source. upload A data structure of the upload file as HTTPUpload . It is defined in the ESP8266WebServer (WebServer as ESP32) library as follows: typedef struct { HTTPUploadStatus status; String filename; String name; String type; size_t totalSize; size_t currentSize; size_t contentLength; uint8_t buf[HTTP_UPLOAD_BUFLEN]; } HTTPUpload; The upload handler needs to implement processing based on the enumeration value of HTTPUpload.status as HTTPUploadStatus enum type. HTTPUploadStatus enumeration is as follows: UPLOAD_FILE_START : Invokes to the _open. UPLOAD_FILE_WRITE : Invokes to the _write. UPLOAD_FILE_END : Invokes to the _close. UPLOAD_FILE_ABORTED : Invokes to the _close. The _open function will be invoked when HTTPUploadStatus is UPLOAD_FILE_START . Usually, the implementation of an inherited class will open the file. protected virtual bool _open( const char * filename, const char * mode) = 0 Parameters filename Uploading file name. mode An indicator for the file access mode, a \"w\" for writing. Return value true File open successful. false Failed to open. The _write function will be invoked when HTTPUploadStatus is UPLOAD_FILE_WRITE . The content of the upload file is divided and the _write will be invoked in multiple times. Usually, the implementation of an inherited class will write data. protected virtual size_t _write( const uint8_t * buf, const size_t size)) = 0 Parameters buf File content block. size File block size to write. Return value Size written. The _close function will be invoked when HTTPUploadStatus is UPLOAD_FILE_END or UPLOAD_FILE_ABORTED . Usually, the implementation of an inherited class will close the file. protected virtual void _close( void ) = 0 For reference, the following AutoConnectUploadFS class is an implementation of AutoConnect built-in uploader and inherits from AutoConnectUploadHandler. class AutoConnectUploadFS : public AutoConnectUploadHandler { public : explicit AutoConnectUploadFS(SPIFFST & media) : _media( & media) {} ~ AutoConnectUploadFS() { _close(); } protected : bool _open( const char * filename, const char * mode) override { if (_media -> begin()) { _file = _media -> open(filename, mode); return _file != false; } return false; } size_t _write( const uint8_t * buf, const size_t size) override { if (_file) return _file.write(buf, size); else return - 1 ; } void _close( void ) override { if (_file) _file.close(); _media -> end(); } private : SPIFFST * _media; SPIFileT _file; }; Register custom upload handler \u00b6 In order to upload a file by the custom uploader, it is necessary to register it to the custom Web page beforehand. To register a custom uploader, specify the custom uploader class name in the template argument of the AutoConnectAux::onUpload function and invokes it. void AutoConnectAux :: onUpload < T > (T & uploadClass) Parameters T Specifies a class name of the custom uploader. This class name is a class that you implemented by inheriting AutoConnectUploadHandler for custom upload. uploadClass Specifies the custom upload class instance. The rough structure of the sketches that completed these implementations will be as follows: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char PAGE_UPLOAD[] PROGMEM = R\"( { \"uri\": \"/\", \"title\": \"Upload\", \"menu\": true, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading platform<h2>\" }, { \"name\":\"upload_file\", \"type\":\"ACFile\", \"label\":\"Select file: \", \"store\":\"extern\" }, { \"name\":\"upload\", \"type\":\"ACSubmit\", \"value\":\"UPLOAD\", \"uri\":\"/upload\" } ] } )\" ; static const char PAGE_RECEIVED[] PROGMEM = R\"( { \"uri\": \"/upload\", \"title\": \"Upload ended\", \"menu\": false, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading ended<h2>\" } ] } )\" ; // Custom upload handler class class CustomUploader : public AutoConnectUploadHandler { public : CustomUploader() {} ~ CustomUploader() {} protected : bool _open( const char * filename, const char * mode) override ; size_t _write ( const uint8_t * buf, const size_t size) override ; void _close ( void ) override ; }; // _open for custom open bool CustomUploader :: _open( const char * filename, const char * mode) { // Here, an implementation for the open file. } // _open for custom write size_t CustomUploader :: _write( const uint8_t * buf, const size_t size) { // Here, an implementation for the writing the file data. } // _open for custom close void CustomUploader :: _close( void ) { // Here, an implementation for the close file. } AutoConnect portal; AutoConnectAux uploadPage; AutoConnectAux receivePage; CustomUploader uploader; // Declare the custom uploader void setup () { uploadPage.load(PAGE_UPLOAD); receivePage.load(PAGE_RECEIVED); portal.join({ uploadPage, receivePage }); receivePage.onUpload < CustomUploader > (uploader); // Register the custom uploader portal.begin(); } void loop () { portal.handleClient(); } Don't forget to specify the store When using a custom uploader, remember to specify the extern for the store attribute of AutoConnectFile. window.onload = function() { Gifffer(); }; The AutoConnectFile element can be used with other AutoConnectElements on the same page. \u21a9","title":"File upload handler"},{"location":"acupload.html#uploading-file-from-web-browser","text":"If you have to write some data individually to the ESP8266/ESP32 module for the sketch behavior, the AutoConnectFile element will assist with your wants implementation. The AutoConnectFile element produces an HTML <input type=\"file\"> tag and can save uploaded file to the flash or external SD of the ESP8266/ESP32 module. The handler for saving is built into AutoConnect. You can use it to inject any sketch data such as the initial values for the custom Web page into the ESP module via OTA without using the sketch data upload tool of Arduino-IDE.","title":"Uploading file from Web Browser"},{"location":"acupload.html#basic-steps-of-the-file-upload-sketch","text":"Here is the basic procedure of the sketch which can upload files from the client browser using AutoConnectFile: 1 Place AutoConnectFile on a custom Web page by writing JSON or constructor code directly with the sketch. Place other AutoConnectElements as needed. Place AutoConnectSubmit on the same custom Web page. Perform the following process in the on-handler of submitting destination: Retrieve the AutoConnectFile instance from the custom Web page where you placed the AutoConnectFile element using the AutoConnectAux::getElement function or the operator [] . Start access to the device specified as the upload destination. In usually, it depends on the file system's begin function. For example, if you specified Flash's SPIFFS as the upload destination, invokes SPIFFS.begin() . The value member of AutoConnectFile contains the file name of the upload file. Use its file name to access the uploaded file on the device. Invokes the end function associated with the begin to close the device. It is the SPIFFS.end()* if the flash on the ESP module has been begun for SPIFFS. The following sketch is an example that implements the above basic steps. The postUpload function is the on-handler and retrieves the AutoConnectFile as named upload_file . You should note that this handler is not for a custom Web page placed with its AutoConnectFile element. The uploaded file should be processed by the handler for the transition destination page from the AutoConnectFile element placed page. AutoConnect built-in upload handler will save the uploaded file to the specified device before invoking the postUpload function. However, If you use uploaded files in different situations, it may be more appropriate to place the actual handling process outside the handler. It applies for the parameter file, etc. The important thing is that you do not have to sketch file reception and storing logic by using the AutoConnectFile element and the upload handler built into the AutoConnect. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <FS.h> #include <AutoConnect.h> // Upload request custom Web page static const char PAGE_UPLOAD[] PROGMEM = R\"( { \"uri\": \"/\", \"title\": \"Upload\", \"menu\": true, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading platform<h2>\" }, { \"name\":\"upload_file\", \"type\":\"ACFile\", \"label\":\"Select file: \", \"store\":\"fs\" }, { \"name\":\"upload\", \"type\":\"ACSubmit\", \"value\":\"UPLOAD\", \"uri\":\"/upload\" } ] } )\" ; // Upload result display static const char PAGE_BROWSE[] PROGMEM = R\"( { \"uri\": \"/upload\", \"title\": \"Upload\", \"menu\": false, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>Uploading ended<h2>\" }, { \"name\":\"filename\", \"type\":\"ACText\" }, { \"name\":\"size\", \"type\":\"ACText\", \"format\":\"%s bytes uploaded\" }, { \"name\":\"content_type\", \"type\":\"ACText\", \"format\":\"Content: %s\" } ] } )\" ; ESP8266WebServer server; AutoConnect portal (server); // Declare AutoConnectAux separately as a custom web page to access // easily for each page in the post-upload handler. AutoConnectAux auxUpload; AutoConnectAux auxBrowse; /** * Post uploading, AutoConnectFile's built-in upload handler reads the * file saved in SPIFFS and displays the file contents on /upload custom * web page. However, only files with mime type uploaded as text are * displayed. A custom web page handler is called after upload. * @param aux AutoConnectAux(/upload) * @param args PageArgument * @return Uploaded text content */ String postUpload (AutoConnectAux & aux, PageArgument & args) { String content; AutoConnectFile & upload = auxUpload[ \"upload_file\" ].as < AutoConnectFile > (); AutoConnectText & aux_filename = aux[ \"filename\" ].as < AutoConnectText > (); AutoConnectText & aux_size = aux[ \"size\" ].as < AutoConnectText > (); AutoConnectText & aux_contentType = aux[ \"content_type\" ].as < AutoConnectText > (); // Assignment operator can be used for the element attribute. aux_filename.value = upload.value; aux_size.value = String(upload.size); aux_contentType.value = upload.mimeType; // The file saved by the AutoConnect upload handler is read from // the EEPROM and echoed to a custom web page. SPIFFS.begin(); File uploadFile = SPIFFS.open(String( \"/\" + upload.value).c_str(), \"r\" ); if (uploadFile) { while (uploadFile.available()) { char c = uploadFile.read(); Serial.print(c); } uploadFile.close(); } else content = \"Not saved\" ; SPIFFS.end(); return String(); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); auxUpload.load(PAGE_UPLOAD); auxBrowse.load(PAGE_BROWSE); portal.join({ auxUpload, auxBrowse }); auxBrowse.on(postUpload); portal.begin(); } void loop () { portal.handleClient(); }","title":"Basic steps of the file upload sketch"},{"location":"acupload.html#where-will-the-file-upload","text":"The AutoConnect built-in upload handler can save the upload file to three locations: Flash memory embedded in the ESP8266/ESP32 module SD device externally connected to the ESP8266/ESP32 module Other character devices You can specify the device type to save with the store attribute of AutoConnectFile, and it accepts the following values: Flash : AC_File_FS for the API parameter or fs for the JSON document SD : AC_File_SD for the API parameter or sd for the JSON document Other : AC_File_Extern for the API parameter or extern for the JSON document The substance of AC_File_FS (fs) is a SPIFFS file system implemented by the ESP8266/ESP32 core, and then AutoConnect uses the Global Instance SPIFFS to access SPIFFS. Also, the substance of AC_File_SD (sd) is a FAT file of Arduino SD library ported to the ESP8266/ESP32 core, and then AutoConnect uses the Global Instance SD to access SD. When saving to an external SD device, there are additional required parameters for the connection interface and is defined as the macro in AutoConnectDefs.h. #define AUTOCONNECT_SD_CS SS #define AUTOCONNECT_SD_SPEED 4000000 AUTOCONNECT_SD_CS defines which GPIO for the CS (Chip Select, or SS as Slave Select) pin. This definition is derived from pins_arduino.h, which is included in the Arduino core distribution. If you want to assign the CS pin to another GPIO, you need to change the macro definition of AutoConnectDefs.h. AUTOCONNECT_SD_SPEED defines SPI clock speed depending on the connected device. Involves both the begin() and the end() The built-in uploader executes the begin and end functions regardless of the sketch whence the file system of the device will terminate with the uploader termination. Therefore, to use the device in the sketch after uploading, you need to restart it with the begin function.","title":"Where will the file upload"},{"location":"acupload.html#when-it-will-be-uploaded","text":"Upload handler will be launched by ESP8266WebServer/WebServer(as ESP32) library which is triggered by receiving an HTTP stream of POST BODY including file content. Its launching occurs before invoking the page handler. The following diagram illustrates the file uploading sequence: At the time of the page handler behaves, the uploaded file already saved to the device, and the member variables of AutoConnectFile reflects the file name and transfer size.","title":"When it will be uploaded"},{"location":"acupload.html#the-file-name-for-the-uploaded-file","text":"AutoConnetFile saves the uploaded file with the file name you selected by <input type=\"file\"> tag on the browser. The file name used for uploading is stored in the AutoConnetFile's value member, which you can access after uploading. (i.e. In the handler of the destination page by the AutoConnectSubmit element.) You can not save it with a different name. It can be renamed after upload if you need to change the name.","title":"The file name for the uploaded file"},{"location":"acupload.html#upload-to-a-device-other-than-flash-or-sd","text":"You can output the file to any device using a custom uploader by specifying extern with the store attribute of AutoConnectFile (or specifying AC_File_Extern for the store member variable) and can customize the uploader according to the need to upload files to other than Flash or SD. Implements your own uploader with inheriting the AutoConnectUploadHandler class which is the base class of the upload handler. It's not so difficult Implementing the custom uploader requires a little knowledge of the c++ language. If you are less attuned to programming c++, you may find it difficult. But don't worry. You can make it in various situations by just modifying the sketch skeleton that appears at the end of this page.","title":"Upload to a device other than Flash or SD"},{"location":"acupload.html#upload-handler-base-class","text":"AutoConnectUploadHandler is a base class of upload handler and It has one public member function and three protected functions.","title":" Upload handler base class"},{"location":"acupload.html#constructor","text":"AutoConnectUploadHandler()","title":" Constructor"},{"location":"acupload.html#member-functions","text":"The upload public function is an entry point, the ESP8266WebServer (WebServer as ESP32) library will invoke the upload with each time of uploading content divided into chunks. Also, the _open , _write and _close protected functions are actually responsible for saving files and are declared as pure virtual functions. A custom uploader class that inherits from the AutoConnectUploadHandler class need to implement these functions. The actual upload process is handled by the three private functions above, and then upload only invokes three functions according to the upload situation. In usually, there is no need to override the upload function in an inherited class. public virtual void upload( const String & requestUri, const HTTPUpload & upload) Parameters requestUri URI of upload request source. upload A data structure of the upload file as HTTPUpload . It is defined in the ESP8266WebServer (WebServer as ESP32) library as follows: typedef struct { HTTPUploadStatus status; String filename; String name; String type; size_t totalSize; size_t currentSize; size_t contentLength; uint8_t buf[HTTP_UPLOAD_BUFLEN]; } HTTPUpload; The upload handler needs to implement processing based on the enumeration value of HTTPUpload.status as HTTPUploadStatus enum type. HTTPUploadStatus enumeration is as follows: UPLOAD_FILE_START : Invokes to the _open. UPLOAD_FILE_WRITE : Invokes to the _write. UPLOAD_FILE_END : Invokes to the _close. UPLOAD_FILE_ABORTED : Invokes to the _close. The _open function will be invoked when HTTPUploadStatus is UPLOAD_FILE_START . Usually, the implementation of an inherited class will open the file. protected virtual bool _open( const char * filename, const char * mode) = 0 Parameters filename Uploading file name. mode An indicator for the file access mode, a \"w\" for writing. Return value true File open successful. false Failed to open. The _write function will be invoked when HTTPUploadStatus is UPLOAD_FILE_WRITE . The content of the upload file is divided and the _write will be invoked in multiple times. Usually, the implementation of an inherited class will write data. protected virtual size_t _write( const uint8_t * buf, const size_t size)) = 0 Parameters buf File content block. size File block size to write. Return value Size written. The _close function will be invoked when HTTPUploadStatus is UPLOAD_FILE_END or UPLOAD_FILE_ABORTED . Usually, the implementation of an inherited class will close the file. protected virtual void _close( void ) = 0 For reference, the following AutoConnectUploadFS class is an implementation of AutoConnect built-in uploader and inherits from AutoConnectUploadHandler. class AutoConnectUploadFS : public AutoConnectUploadHandler { public : explicit AutoConnectUploadFS(SPIFFST & media) : _media( & media) {} ~ AutoConnectUploadFS() { _close(); } protected : bool _open( const char * filename, const char * mode) override { if (_media -> begin()) { _file = _media -> open(filename, mode); return _file != false; } return false; } size_t _write( const uint8_t * buf, const size_t size) override { if (_file) return _file.write(buf, size); else return - 1 ; } void _close( void ) override { if (_file) _file.close(); _media -> end(); } private : SPIFFST * _media; SPIFileT _file; };","title":" Member functions"},{"location":"acupload.html#register-custom-upload-handler","text":"In order to upload a file by the custom uploader, it is necessary to register it to the custom Web page beforehand. To register a custom uploader, specify the custom uploader class name in the template argument of the AutoConnectAux::onUpload function and invokes it. void AutoConnectAux :: onUpload < T > (T & uploadClass) Parameters T Specifies a class name of the custom uploader. This class name is a class that you implemented by inheriting AutoConnectUploadHandler for custom upload. uploadClass Specifies the custom upload class instance. The rough structure of the sketches that completed these implementations will be as follows: #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char PAGE_UPLOAD[] PROGMEM = R\"( { \"uri\": \"/\", \"title\": \"Upload\", \"menu\": true, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading platform<h2>\" }, { \"name\":\"upload_file\", \"type\":\"ACFile\", \"label\":\"Select file: \", \"store\":\"extern\" }, { \"name\":\"upload\", \"type\":\"ACSubmit\", \"value\":\"UPLOAD\", \"uri\":\"/upload\" } ] } )\" ; static const char PAGE_RECEIVED[] PROGMEM = R\"( { \"uri\": \"/upload\", \"title\": \"Upload ended\", \"menu\": false, \"element\": [ { \"name\":\"caption\", \"type\":\"ACText\", \"value\":\"<h2>File uploading ended<h2>\" } ] } )\" ; // Custom upload handler class class CustomUploader : public AutoConnectUploadHandler { public : CustomUploader() {} ~ CustomUploader() {} protected : bool _open( const char * filename, const char * mode) override ; size_t _write ( const uint8_t * buf, const size_t size) override ; void _close ( void ) override ; }; // _open for custom open bool CustomUploader :: _open( const char * filename, const char * mode) { // Here, an implementation for the open file. } // _open for custom write size_t CustomUploader :: _write( const uint8_t * buf, const size_t size) { // Here, an implementation for the writing the file data. } // _open for custom close void CustomUploader :: _close( void ) { // Here, an implementation for the close file. } AutoConnect portal; AutoConnectAux uploadPage; AutoConnectAux receivePage; CustomUploader uploader; // Declare the custom uploader void setup () { uploadPage.load(PAGE_UPLOAD); receivePage.load(PAGE_RECEIVED); portal.join({ uploadPage, receivePage }); receivePage.onUpload < CustomUploader > (uploader); // Register the custom uploader portal.begin(); } void loop () { portal.handleClient(); } Don't forget to specify the store When using a custom uploader, remember to specify the extern for the store attribute of AutoConnectFile. window.onload = function() { Gifffer(); }; The AutoConnectFile element can be used with other AutoConnectElements on the same page. \u21a9","title":" Register custom upload handler"},{"location":"advancedusage.html","text":"Advanced usage \u00b6 404 handler \u00b6 Registering the \"not found\" handler is a different way than ESP8266WebServer (WebServer as ESP32). The onNotFound of ESP8266WebServer/WebServer does not work with AutoConnect. AutoConnect overrides ESP8266WebServer::onNotFound / WebServer::onNotFound to handle a captive portal. To register \"not found\" handler, use AutoConnect::onNotFound . Access to saved credentials \u00b6 AutoConnect stores the established WiFi connection in the flash of the ESP8266/ESP32 module and equips the class to access it from the sketch. You can read, write or erase the credentials using this class individually. It's AutoConnectCredential class which provides the access method to the saved credentials in the flash. Refer to section Saved credentials access for details. Where to store credentials in ESP32 with AutoConnect v1.0.0 or later Since v1.0.0, credentials are stored in nvs of ESP32. AutoConnect v1.0.0 or later accesses the credentials area using the Preferences class with the arduino esp-32 core. So in ESP32, the credentials are not in the EEPROM, it is in the namespace AC_CREDT of the nvs. See Saved credentials access for details. In ESP8266, it is saved in EEPROM as is conventionally done. Automatic reconnect \u00b6 When the captive portal is started, SoftAP starts and the STA is disconnected. The current SSID setting memorized in ESP8266 will be lost but then the reconnect behavior of ESP32 is somewhat different from this. The WiFiSTAClass::disconnect function implemented in the arduino-esp32 has extended parameters than the ESP8266's arduino-core. The second parameter of WiFi.disconnect on the arduino-esp32 core that does not exist in the ESP8266WiFiSTAClass has the effect of deleting the currently connected WiFi configuration and its default value is \"false\". On the ESP32 platform, even if WiFi.disconnect is executed, WiFi.begin() without the parameters in the next turn will try to connect to that AP. That is, automatic reconnection is implemented in arduino-esp32 already. Although this behavior appears seemingly competent, it is rather a disadvantage in scenes where you want to change the access point each time. When explicitly disconnecting WiFi from the Disconnect menu, AutoConnect will erase the AP connection settings saved by arduino-esp32 core. AutoConnect's automatic reconnection is a mechanism independent from the automatic reconnection of the arduino-esp32 core. If the autoReconnect option of the AutoConnectConfig class is enabled, it automatically attempts to reconnect to the disconnected past access point. When the autoReconnect option is specified, AutoConnect will not start SoftAP immediately if the first WiFi.begin fails. It will scan WiFi signal and the same connection information as the detected BSSID is stored in the flash as AutoConnect's credentials, explicitly apply it with WiFi.begin and rerun. AutoConnect Portal; AutoConnectConfig Config; Config.autoReconnect = true; Portal.config(Config); Portal.begin(); An autoReconnect option is available to AutoConnect::begin without SSID and pass Passphrase. An autoReconnect will work if SSID detection succeeded An autoReconnect will not effect if the SSID which stored credential to be connected is a hidden access point. Auto save Credential \u00b6 By default, AutoConnect saves the credentials of the established connection to the flash. You can disable it with the autoSave parameter specified by AutoConnectConfig . See the Saved credentials access chapter for details on accessing stored credentials. AutoConnect Portal; AutoConnectConfig Config; Config.autoSave = AC_SAVECREDENTIAL_NEVER; Portal.config(Config); Portal.begin(); Credentials storage location The location where AutoConnect saves credentials depends on the module type and the AutoConnect library version, also arduino-esp32 core version. AutoConnect Arduino core for ESP8266 Arduino core for ESP32 1.0.2 earlier 1.0.3 later v0.9.12 earlier EEPROM EEPROM (partition) Not supported v1.0.0 later Preferences (nvs) (Can be used EEPROM with turning off AUTOCONNECT_USE_PREFERENCES macro) Preferences (nvs) Captive portal start detection \u00b6 The captive portal will only be activated if the first WiFi::begin fails. Sketch can detect with the AutoConnect::onDetect function that the captive portal has started. For example, the sketch can be written like as follows that turns on the LED at the start captive portal. AutoConnect Portal; bool startCP (IPAddress ip) { digitalWrite(BUILTIN_LED, HIGH); Serial.println( \"C.P. started, IP:\" + WiFi.localIP().toString()); return true; } void setup () { Serial.begin( 115200 ); pinMode(BUILTIN_LED, OUTPUT); digitalWrite(BUILTIN_LED, LOW); Portal.onDetect(startCP); if (Portal.begin()) { digitalWrite(BUILTIN_LED, LOW); } } void loop () { Portal.handleClient(); } Captive portal timeout control \u00b6 AutoConnect has two parameters for timeout control. One is a timeout value used when trying to connect to the specified AP. It behaves the same as general timeout control in connection attempt by WiFi.begin. This control is specified by the third parameter of AutoConnect::begin . The default value is macro defined by AUTOCONNECT_TIMEOUT in the AutoConnectDef.h file. The other timeout control is for the captive portal itself. It is useful when you want to continue sketch execution with offline even if the WiFi connection is not possible. You can also combine it with the immediateStart option to create sketches with high mobility. The timeout of the captive portal is specified together with AutoConnectConfig::portalTimeout as follows. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Also, if you want to stop AutoConnect completely when the captive portal is timed out, you need to call the AutoConnect::end function. It looks like the following code: bool acEnable; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); acEnable = portal.begin(); if ( ! acEnable) { portal.end(); } } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } if (acEnable) { portal.handleClient(); } } There is another option related to timeout in AutoConnectConfig. It can make use of the captive portal function even after a timeout. The AutoConnectConfig::retainPortal option will not stop the SoftAP when the captive portal is timed out. If you enable the ratainPortal option, you can try to connect to the AP at any time while continuing to sketch execution with offline even after the captive portal timed-out. Compared to the above code specified no option with the following example code, the captive portal will remain available even after a timeout without changing the logic of the sketch. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds config.retainPortal = true; portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Casts the HTML pages to be add-on into the menu \u00b6 If your sketch handles web pages, you can embed the pages into the AutoConnect menu in continuance enjoying the utility of the WiFi connection feature. Unlike the custom Web pages by AutoConnectElements , this allows to legacy web pages registered by ESP8266WebServer::on or WebServer::on function. To implement embedding your legacy web pages to the AutoConnect menu, you can use AutoConnectAux only constructed with the URI of the page to be embedding. AutoConnectElements is not required. The basic procedure for this as follows: Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu. Sketch the legacy page handlers. Register those handler functions to ESP8266WebServer/WebServer with the on function. Register AutoConnectAux declared with #1 to AutoConnect using AutoConnect::join function. It serves as a menu item. Begin the portal. Performs AutoConnect::handleClient in the loop function. For details, see section Constructing the menu of Examples page. Change menu title \u00b6 Although the default menu title is AutoConnect , you can change the title by setting AutoConnectConfig::title . To set the menu title properly, you must set before calling AutoConnect::begin . AutoConnect Portal; AutoConnectConfig Config; void setup () { // Set menu title Config.title = \"FSBrowser\" ; Portal.config(Config); Portal.begin(); } Executing the above sketch will rewrite the menu title for the FSBrowser as the below. Change the menu labels \u00b6 You can change the label of the AutoConnect menu item by rewriting the default label letter in AutoConnectLabels.h macros. However, changing menu items letter influences all the sketch's build scenes. #define AUTOCONNECT_MENULABEL_CONFIGNEW \"Configure new AP\" #define AUTOCONNECT_MENULABEL_OPENSSIDS \"Open SSIDs\" #define AUTOCONNECT_MENULABEL_DISCONNECT \"Disconnect\" #define AUTOCONNECT_MENULABEL_RESET \"Reset...\" #define AUTOCONNECT_MENULABEL_HOME \"HOME\" #define AUTOCONNECT_BUTTONLABEL_RESET \"RESET\" Combination with mDNS \u00b6 With mDNS library , you can access to ESP8266 by name instead of IP address after connection. The sketch can start the MDNS responder after AutoConnect::begin . #include <ESP8266WiFi.h> #include <ESP8266mDNS.h> #include <ESP8266WebServer.h> AutoConnect Portal; void setup () { if (Portal.begin()) { if (MDNS.begin( \"esp8266\" )) { MDNS.addService( \"http\" , \"tcp\" , 80 ); } } } void loop () { Portal.handleClient(); } Debug print \u00b6 You can output AutoConnect monitor messages to the Serial . A monitor message activation switch is in an include header file AutoConnectDefs.h of library source. Define AC_DEBUG macro to output the monitor messages. 1 #define AC_DEBUG Disable the captive portal \u00b6 It can also prevent the captive portal from starting even if the connection at the first WiFi.begin fails. In this case, AutoConnect::begin behaves same as WiFi.begin . For disabling the captive portal, autoRise sets to false with AutoConnectConfig . AutoConnect portal; AutoConnectConfig acConfig; acConfig.autoRise = false; portal.config(acConfig); portal.begin(); Make SSID of SoftAP unique \u00b6 You can change SoftAP's SSID and password programmatically when the captive portal starts up. By using chip specific ID of esp8266/esp32 you can make SSID of SoftAP unique. SSID and password for SoftAP is AutoConnectConfig::apid and AutoConnectConfig::psk . AutoConnect portal; AutoConnectConfig acConfig; acConfig.apid = \"ESP-\" + String(ESP.getChipId(), HEX); acConfig.psk = YOUR_PASSWORD; portal.config(acConfig); portal.begin(); Obtaining chip ID for ESP32 acConfig.apid = \"ESP-\" + String((uint32_t)(ESP.getEfuseMac() >> 32), HEX); Move the saving area of EEPROM for the credentials \u00b6 By default, the credentials saving area is occupied from the beginning of EEPROM area. ESP8266 Arduino core document says that: The following diagram illustrates flash layout used in Arduino environment: |--------------|-------|---------------|--|--|--|--|--| ^ ^ ^ ^ ^ Sketch OTA update File system EEPROM WiFi config (SDK) and EEPROM library uses one sector of flash located just after the SPIFFS . Also, in ESP32 arduino core 1.0.2 earlier, the placement of the EEPROM area of ESP32 is described in the partition table . So in the default state, the credential storage area used by AutoConnect conflicts with data owned by the user sketch. It will be destroyed together saved data in EEPROM by user sketch and AutoConnect each other. But you can move the storage area to avoid this. The boundaryOffset in AutoConnectConfig specifies the start offset of the credentials storage area. The default value is 0. The boundaryOffset ignored with AutoConnect v1.0.0 later on ESP32 arduino core 1.0.3 later For ESP32 arduino core 1.0.3 and later, AutoConnect will store credentials to Preferences in the nvs. Since it is defined as the namespace dedicated to AutoConnect and separated from the area used for user sketches. Therefore, the boundaryOffet is ignored with the combination of AutoConnect v1.0.0 or later and the arduino-esp32 1.0.3 or later. On-demand start the captive portal \u00b6 If you do not usually connect to WiFi and need to establish a WiFi connection if necessary, you can combine the autoRise option with the immediateStart option to achieve on-demand connection. This behavior is similar to the WiFiManager's startConfigPortal function. In order to do this, you usually configure only with AutoConnectConfig in setup() and AutoConnect::begin handles in loop() . AutoConnect Portal; AutoConnectConfig Config; void setup () { Config.autoRise = false; Config.immediateStart = true; Portal.config(Config); } void loop () { if (digitalRead(TRIGGER_PIN) == LOW) { while (digitalRead(TRIGGER_PIN) == LOW) yield(); Portal.begin(); } Portal.handleClient(); } The above example does not connect to WiFi until TRIGGER_PIN goes LOW. When TRIGGER_PIN goes LOW, the captive portal starts and you can connect to WiFi. Even if you reset the module, it will not automatically reconnect. Refers the hosted ESP8266WebServer/WebServer \u00b6 Constructing an AutoConnect object variable without parameters then creates and starts an ESP8266WebServer/WebServer inside the AutoConnect. This object variable could be referred by AutoConnect::host function to access ESP8266WebServer/WebServer instance as like below. AutoConnect Portal; Portal.begin(); ESP8266WebServer & server = Portal.host(); server.send( 200 , \"text/plain\" , \"Hello, world\" ); When host() is valid The host() can be referred at after AutoConnect::begin . Usage for automatically instantiated ESP8266WebServer/WebServer \u00b6 The sketch can handle URL requests using ESP8266WebServer or WebServer that AutoConnect started internally. ESP8266WebServer/WebServer instantiated dynamically by AutoConnect can be referred to by AutoConnect::host function. The sketch can use the ' on ' function, ' send ' function, ' client ' function and others by ESP8266WebServer/WebServer reference of its return value. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect Portal; void handleRoot () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 200 , \"text/html\" , \"Hello, world\" ); } void handleNotFound () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 404 , \"text/html\" , \"Unknown.\" ); } void setup () { bool r = Portal.begin(); if (r) { ESP8266WebServer & IntServer = Portal.host(); IntServer.on( \"/\" , handleRoot); Portal.onNotFound(handleNotFound); // For only onNotFound. } } void loop () { Portal.host().handleClient(); Portal.handleRequest(); /* or following one line code is equ. Portal.handleClient(); */ } ESP8266WebServer/WebServer function should be called after AutoConnect::begin The sketch cannot refer to an instance of ESP8266WebServer/WebServer until AutoConnect::begin completes successfully. Do not use with ESP8266WebServer::begin or WebServer::begin ESP8266WebServer/WebServer is already running inside the AutoConnect. Use with the PageBuilder library \u00b6 In ordinary, the URL handler will respond the request by sending some HTML. PageBuilder library is HTML assembly aid. it can handle predefined HTML as like a template and simplify an HTML string assemble logic, and also the generated HTML send automatically. An example sketch used with the PageBuilder as follows and it explains how it aids for the HTML generating. Details for Github repository . Configuration functions \u00b6 Configuration for Soft AP and captive portal \u00b6 AutoConnect will activate SoftAP at failed the first WiFi.begin . It SoftAP settings are stored in AutoConnectConfig as the following parameters. The sketch could be configured SoftAP using these parameters, refer the AutoConnectConfig API for details. IP address of SoftAP activated. Gateway IP address. Subnet mask. SSID for SoftAP. Password for SoftAP. Channel. SoftAP name. Hidden attribute. Station hostname. Auto save credential. Offset address of the credentials storage area in EEPROM. Captive portal time out limit. Maintain portal function even after a timeout. Length of start up time after reset. Automatic starting the captive portal. Start the captive portal forcefully. Auto reset after connection establishment. Home URL of the user sketch application. Menu title. Ticker signal output. AutoConnect::config before AutoConnect::begin AutoConnect::config must be executed before AutoConnect::begin . Assign user sketch's home path \u00b6 HOME for returning to the user's sketch homepage will display at the bottom of the AutoConnect menu. It could be set using the AutoConnect::home function. Change SSID and Password for SoftAP \u00b6 An esp8266ap is default SSID name for SoftAP of captive portal and password is 12345678 for ESP8266. Similarly, esp32ap and 12345678 for ESP32. You can change both by setting apid and psk . AutoConnect portal; AutoConnectConfig config; void setup () { config.apid = \"ap_portal\" ; config.psk = \"new_password\" ; portal.config(config); portal.begin(); } Also, you can specify the SSID, password for SoftAP with the constructor of the AutoConnectConfig as below. AutoConnect portal; AutoConnectConfig config ( \"ap_portal\" , \"new_passwrod\" ); void setup () { portal.config(config); portal.begin(); } You can also assign no password to SoftAP launched as a captive portal. Assigning a null string as String(\"\") to AutoConnectConfig::psk does not require a password when connecting to SoftAP. But this method is not recommended. The broadcast radio of SSID emitted from SoftAP will leak and reach several tens of meters. Relocate the AutoConnect home path \u00b6 A home path of AutoConnect is /_ac by default. You can access from the browser with http://IPADDRESS/_ac. You can change the home path by revising AUTOCONNECT_URI macro in the include header file as AutoConnectDef.h . #define AUTOCONNECT_URI \"/_ac\" Static IP assignment 2 \u00b6 It is also possible to assign static IP Address to ESP8266/ESP32 in STA mode. By default DHCP is enabled and it becomes the IP address assigned by the DHCP server with WiFi.begin . To assign a static IP to ESP8266/ESP32 with WIFI_MODE_STA, the following parameters are required: IP address. Gateway address. Subnet mask. Primary DNS server. Secondary DNS server. (optional) The above parameters must be executed before AutoConnect::begin as arguments of AutoConnectConfig . AutoConnect portal; AutoConnectConfig Config; Config.staip = IPAddress( 192 , 168 , 1 , 10 ); Config.staGateway = IPAddress( 192 , 168 , 1 , 1 ); Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); Config.dns1 = IPAddress( 192 , 168 , 1 , 1 ); portal.config(Config); portal.begin(); Station host name \u00b6 AutoConnectConfig::hostName assigns the station DHCP hostname which complies with RFC952 . It must satisfy the following constraints. Up to 24 characters Only the alphabet (a-z, A-Z), digits (0-9), minus sign (-) No '-' as last character Ticker for WiFi status \u00b6 Flicker signal can be output from the ESP8266/ESP32 module according to WiFi connection status. If you connect the LED to the signal output pin, you can know the WiFi connection status during behavior inside AutoConnect::begin through the LED blink. AutoConnectConfig::ticker option specifies flicker signal output. The following sketch is an example of flashing the active-high LED connected to pin #16 according to WiFi connection during the AutoConnect::begin. AutoConnect portal; AutoConnectConfig Config; Config.ticker = true; config.tickerPort = 16 ; Config.tickerOn = HIGH; portal.config(Config); portal.begin(); The AutoConnect ticker indicates the WiFi connection status in the following three flicker patterns: Short blink: The ESP module stays in APSTA mode. Short-on and long-off: No STA connection state. (i.e. WiFi.status != WL_CONNECTED) No blink: WiFi connection with access point established and data link enabled. (i.e. WiFi.status = WL_CONNECTED) The flicker cycle length is defined by some macros in AutoConnectDefs.h header file. #define AUTOCONNECT_FLICKER_PERIODAP 1000 // [ms] #define AUTOCONNECT_FLICKER_PERIODDC (AUTOCONNECT_FLICKER_PERIODAP << 1) // [ms] #define AUTOCONNECT_FLICKER_WIDTHAP 96 // (8 bit resolution) #define AUTOCONNECT_FLICKER_WIDTHDC 16 // (8 bit resolution) AUTOCONNECTT_FLICKER_PERIODAP : Assigns a flicker period when the ESP module stays in APSTA mode. AUTOCONNECT_FLICKER_PERIODDC : Assigns a flicker period when WiFi is disconnected. AUTOCONNECT_FLICKER_WIDTHAP and AUTOCONNECT_FLICKER_WIDTHDC : Specify the duty rate for each period[ms] in 8-bit resolution. AutoConnectConfig::tickerPort specifies a port that outputs the flicker signal. If you are using an LED-equipped ESP module board, you can assign a LED pin to the tick-port for the WiFi connection monitoring without the external LED. The default pin is arduino valiant's LED_BUILTIN . You can refer to the Arduino IDE's variant information to find out which pin actually on the module assign to LED_BUILTIN . 3 AutoConnectConfig::tickerOn specifies the active logic level of the flicker signal. This value indicates the active signal level when driving the ticker. For example, if the LED connected to tickPort lights by LOW, the tickerOn is LOW . The logic level of LED_BUILTIN for popular modules are as follows: module Logic level LED_BUILTIN Pin Arduino alias NodeMCU V1.0 Active-low 16 D0 WEMOS D1 mini Active-low 2 D4 SparkFun ESP8266 Thing Active-high 5 Adafruit Feather HUZZAH ESP8266 Active-low 0 NodeMCU 32s Active-high 2 T2 LOLIN32 Pro Active-low 5 SS SparkFun ESP32 Thing Active-high 5 Adafruit Feather HUZZAH32 Active-high 13 A12 The source code placement of common macros for AutoConnect since v0.9.7 has changed. \u21a9 Static IP address assignment is available from version 0.9.3. \u21a9 It's defined in the pins_arduino.h file, located in the sub-folder named variants wherein Arduino IDE installed folder. \u21a9","title":"Advanced usage"},{"location":"advancedusage.html#advanced-usage","text":"","title":"Advanced usage"},{"location":"advancedusage.html#404-handler","text":"Registering the \"not found\" handler is a different way than ESP8266WebServer (WebServer as ESP32). The onNotFound of ESP8266WebServer/WebServer does not work with AutoConnect. AutoConnect overrides ESP8266WebServer::onNotFound / WebServer::onNotFound to handle a captive portal. To register \"not found\" handler, use AutoConnect::onNotFound .","title":" 404 handler"},{"location":"advancedusage.html#access-to-saved-credentials","text":"AutoConnect stores the established WiFi connection in the flash of the ESP8266/ESP32 module and equips the class to access it from the sketch. You can read, write or erase the credentials using this class individually. It's AutoConnectCredential class which provides the access method to the saved credentials in the flash. Refer to section Saved credentials access for details. Where to store credentials in ESP32 with AutoConnect v1.0.0 or later Since v1.0.0, credentials are stored in nvs of ESP32. AutoConnect v1.0.0 or later accesses the credentials area using the Preferences class with the arduino esp-32 core. So in ESP32, the credentials are not in the EEPROM, it is in the namespace AC_CREDT of the nvs. See Saved credentials access for details. In ESP8266, it is saved in EEPROM as is conventionally done.","title":" Access to saved credentials"},{"location":"advancedusage.html#automatic-reconnect","text":"When the captive portal is started, SoftAP starts and the STA is disconnected. The current SSID setting memorized in ESP8266 will be lost but then the reconnect behavior of ESP32 is somewhat different from this. The WiFiSTAClass::disconnect function implemented in the arduino-esp32 has extended parameters than the ESP8266's arduino-core. The second parameter of WiFi.disconnect on the arduino-esp32 core that does not exist in the ESP8266WiFiSTAClass has the effect of deleting the currently connected WiFi configuration and its default value is \"false\". On the ESP32 platform, even if WiFi.disconnect is executed, WiFi.begin() without the parameters in the next turn will try to connect to that AP. That is, automatic reconnection is implemented in arduino-esp32 already. Although this behavior appears seemingly competent, it is rather a disadvantage in scenes where you want to change the access point each time. When explicitly disconnecting WiFi from the Disconnect menu, AutoConnect will erase the AP connection settings saved by arduino-esp32 core. AutoConnect's automatic reconnection is a mechanism independent from the automatic reconnection of the arduino-esp32 core. If the autoReconnect option of the AutoConnectConfig class is enabled, it automatically attempts to reconnect to the disconnected past access point. When the autoReconnect option is specified, AutoConnect will not start SoftAP immediately if the first WiFi.begin fails. It will scan WiFi signal and the same connection information as the detected BSSID is stored in the flash as AutoConnect's credentials, explicitly apply it with WiFi.begin and rerun. AutoConnect Portal; AutoConnectConfig Config; Config.autoReconnect = true; Portal.config(Config); Portal.begin(); An autoReconnect option is available to AutoConnect::begin without SSID and pass Passphrase. An autoReconnect will work if SSID detection succeeded An autoReconnect will not effect if the SSID which stored credential to be connected is a hidden access point.","title":" Automatic reconnect"},{"location":"advancedusage.html#auto-save-credential","text":"By default, AutoConnect saves the credentials of the established connection to the flash. You can disable it with the autoSave parameter specified by AutoConnectConfig . See the Saved credentials access chapter for details on accessing stored credentials. AutoConnect Portal; AutoConnectConfig Config; Config.autoSave = AC_SAVECREDENTIAL_NEVER; Portal.config(Config); Portal.begin(); Credentials storage location The location where AutoConnect saves credentials depends on the module type and the AutoConnect library version, also arduino-esp32 core version. AutoConnect Arduino core for ESP8266 Arduino core for ESP32 1.0.2 earlier 1.0.3 later v0.9.12 earlier EEPROM EEPROM (partition) Not supported v1.0.0 later Preferences (nvs) (Can be used EEPROM with turning off AUTOCONNECT_USE_PREFERENCES macro) Preferences (nvs)","title":" Auto save Credential"},{"location":"advancedusage.html#captive-portal-start-detection","text":"The captive portal will only be activated if the first WiFi::begin fails. Sketch can detect with the AutoConnect::onDetect function that the captive portal has started. For example, the sketch can be written like as follows that turns on the LED at the start captive portal. AutoConnect Portal; bool startCP (IPAddress ip) { digitalWrite(BUILTIN_LED, HIGH); Serial.println( \"C.P. started, IP:\" + WiFi.localIP().toString()); return true; } void setup () { Serial.begin( 115200 ); pinMode(BUILTIN_LED, OUTPUT); digitalWrite(BUILTIN_LED, LOW); Portal.onDetect(startCP); if (Portal.begin()) { digitalWrite(BUILTIN_LED, LOW); } } void loop () { Portal.handleClient(); }","title":" Captive portal start detection"},{"location":"advancedusage.html#captive-portal-timeout-control","text":"AutoConnect has two parameters for timeout control. One is a timeout value used when trying to connect to the specified AP. It behaves the same as general timeout control in connection attempt by WiFi.begin. This control is specified by the third parameter of AutoConnect::begin . The default value is macro defined by AUTOCONNECT_TIMEOUT in the AutoConnectDef.h file. The other timeout control is for the captive portal itself. It is useful when you want to continue sketch execution with offline even if the WiFi connection is not possible. You can also combine it with the immediateStart option to create sketches with high mobility. The timeout of the captive portal is specified together with AutoConnectConfig::portalTimeout as follows. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); } Also, if you want to stop AutoConnect completely when the captive portal is timed out, you need to call the AutoConnect::end function. It looks like the following code: bool acEnable; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds portal.config(config); acEnable = portal.begin(); if ( ! acEnable) { portal.end(); } } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } if (acEnable) { portal.handleClient(); } } There is another option related to timeout in AutoConnectConfig. It can make use of the captive portal function even after a timeout. The AutoConnectConfig::retainPortal option will not stop the SoftAP when the captive portal is timed out. If you enable the ratainPortal option, you can try to connect to the AP at any time while continuing to sketch execution with offline even after the captive portal timed-out. Compared to the above code specified no option with the following example code, the captive portal will remain available even after a timeout without changing the logic of the sketch. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect portal; AutoConnectConfig config; void setup () { config.portalTimeout = 60000 ; // It will time out in 60 seconds config.retainPortal = true; portal.config(config); portal.begin(); } void loop () { if (WiFi.status() == WL_CONNECTED) { // Some sketch code for the connected scene is here. } else { // Some sketch code for not connected scene is here. } portal.handleClient(); }","title":" Captive portal timeout control"},{"location":"advancedusage.html#casts-the-html-pages-to-be-add-on-into-the-menu","text":"If your sketch handles web pages, you can embed the pages into the AutoConnect menu in continuance enjoying the utility of the WiFi connection feature. Unlike the custom Web pages by AutoConnectElements , this allows to legacy web pages registered by ESP8266WebServer::on or WebServer::on function. To implement embedding your legacy web pages to the AutoConnect menu, you can use AutoConnectAux only constructed with the URI of the page to be embedding. AutoConnectElements is not required. The basic procedure for this as follows: Declare AutoConnectAux for each legacy page. It includes the URI of the page and item string which will display in the AutoConnect menu. Sketch the legacy page handlers. Register those handler functions to ESP8266WebServer/WebServer with the on function. Register AutoConnectAux declared with #1 to AutoConnect using AutoConnect::join function. It serves as a menu item. Begin the portal. Performs AutoConnect::handleClient in the loop function. For details, see section Constructing the menu of Examples page.","title":" Casts the HTML pages to be add-on into the menu"},{"location":"advancedusage.html#change-menu-title","text":"Although the default menu title is AutoConnect , you can change the title by setting AutoConnectConfig::title . To set the menu title properly, you must set before calling AutoConnect::begin . AutoConnect Portal; AutoConnectConfig Config; void setup () { // Set menu title Config.title = \"FSBrowser\" ; Portal.config(Config); Portal.begin(); } Executing the above sketch will rewrite the menu title for the FSBrowser as the below.","title":" Change menu title"},{"location":"advancedusage.html#change-the-menu-labels","text":"You can change the label of the AutoConnect menu item by rewriting the default label letter in AutoConnectLabels.h macros. However, changing menu items letter influences all the sketch's build scenes. #define AUTOCONNECT_MENULABEL_CONFIGNEW \"Configure new AP\" #define AUTOCONNECT_MENULABEL_OPENSSIDS \"Open SSIDs\" #define AUTOCONNECT_MENULABEL_DISCONNECT \"Disconnect\" #define AUTOCONNECT_MENULABEL_RESET \"Reset...\" #define AUTOCONNECT_MENULABEL_HOME \"HOME\" #define AUTOCONNECT_BUTTONLABEL_RESET \"RESET\"","title":" Change the menu labels"},{"location":"advancedusage.html#combination-with-mdns","text":"With mDNS library , you can access to ESP8266 by name instead of IP address after connection. The sketch can start the MDNS responder after AutoConnect::begin . #include <ESP8266WiFi.h> #include <ESP8266mDNS.h> #include <ESP8266WebServer.h> AutoConnect Portal; void setup () { if (Portal.begin()) { if (MDNS.begin( \"esp8266\" )) { MDNS.addService( \"http\" , \"tcp\" , 80 ); } } } void loop () { Portal.handleClient(); }","title":" Combination with mDNS"},{"location":"advancedusage.html#debug-print","text":"You can output AutoConnect monitor messages to the Serial . A monitor message activation switch is in an include header file AutoConnectDefs.h of library source. Define AC_DEBUG macro to output the monitor messages. 1 #define AC_DEBUG","title":" Debug print"},{"location":"advancedusage.html#disable-the-captive-portal","text":"It can also prevent the captive portal from starting even if the connection at the first WiFi.begin fails. In this case, AutoConnect::begin behaves same as WiFi.begin . For disabling the captive portal, autoRise sets to false with AutoConnectConfig . AutoConnect portal; AutoConnectConfig acConfig; acConfig.autoRise = false; portal.config(acConfig); portal.begin();","title":" Disable the captive portal"},{"location":"advancedusage.html#make-ssid-of-softap-unique","text":"You can change SoftAP's SSID and password programmatically when the captive portal starts up. By using chip specific ID of esp8266/esp32 you can make SSID of SoftAP unique. SSID and password for SoftAP is AutoConnectConfig::apid and AutoConnectConfig::psk . AutoConnect portal; AutoConnectConfig acConfig; acConfig.apid = \"ESP-\" + String(ESP.getChipId(), HEX); acConfig.psk = YOUR_PASSWORD; portal.config(acConfig); portal.begin(); Obtaining chip ID for ESP32 acConfig.apid = \"ESP-\" + String((uint32_t)(ESP.getEfuseMac() >> 32), HEX);","title":" Make SSID of SoftAP unique"},{"location":"advancedusage.html#move-the-saving-area-of-eeprom-for-the-credentials","text":"By default, the credentials saving area is occupied from the beginning of EEPROM area. ESP8266 Arduino core document says that: The following diagram illustrates flash layout used in Arduino environment: |--------------|-------|---------------|--|--|--|--|--| ^ ^ ^ ^ ^ Sketch OTA update File system EEPROM WiFi config (SDK) and EEPROM library uses one sector of flash located just after the SPIFFS . Also, in ESP32 arduino core 1.0.2 earlier, the placement of the EEPROM area of ESP32 is described in the partition table . So in the default state, the credential storage area used by AutoConnect conflicts with data owned by the user sketch. It will be destroyed together saved data in EEPROM by user sketch and AutoConnect each other. But you can move the storage area to avoid this. The boundaryOffset in AutoConnectConfig specifies the start offset of the credentials storage area. The default value is 0. The boundaryOffset ignored with AutoConnect v1.0.0 later on ESP32 arduino core 1.0.3 later For ESP32 arduino core 1.0.3 and later, AutoConnect will store credentials to Preferences in the nvs. Since it is defined as the namespace dedicated to AutoConnect and separated from the area used for user sketches. Therefore, the boundaryOffet is ignored with the combination of AutoConnect v1.0.0 or later and the arduino-esp32 1.0.3 or later.","title":" Move the saving area of EEPROM for the credentials"},{"location":"advancedusage.html#on-demand-start-the-captive-portal","text":"If you do not usually connect to WiFi and need to establish a WiFi connection if necessary, you can combine the autoRise option with the immediateStart option to achieve on-demand connection. This behavior is similar to the WiFiManager's startConfigPortal function. In order to do this, you usually configure only with AutoConnectConfig in setup() and AutoConnect::begin handles in loop() . AutoConnect Portal; AutoConnectConfig Config; void setup () { Config.autoRise = false; Config.immediateStart = true; Portal.config(Config); } void loop () { if (digitalRead(TRIGGER_PIN) == LOW) { while (digitalRead(TRIGGER_PIN) == LOW) yield(); Portal.begin(); } Portal.handleClient(); } The above example does not connect to WiFi until TRIGGER_PIN goes LOW. When TRIGGER_PIN goes LOW, the captive portal starts and you can connect to WiFi. Even if you reset the module, it will not automatically reconnect.","title":" On-demand start the captive portal"},{"location":"advancedusage.html#refers-the-hosted-esp8266webserverwebserver","text":"Constructing an AutoConnect object variable without parameters then creates and starts an ESP8266WebServer/WebServer inside the AutoConnect. This object variable could be referred by AutoConnect::host function to access ESP8266WebServer/WebServer instance as like below. AutoConnect Portal; Portal.begin(); ESP8266WebServer & server = Portal.host(); server.send( 200 , \"text/plain\" , \"Hello, world\" ); When host() is valid The host() can be referred at after AutoConnect::begin .","title":" Refers the hosted ESP8266WebServer/WebServer"},{"location":"advancedusage.html#usage-for-automatically-instantiated-esp8266webserverwebserver","text":"The sketch can handle URL requests using ESP8266WebServer or WebServer that AutoConnect started internally. ESP8266WebServer/WebServer instantiated dynamically by AutoConnect can be referred to by AutoConnect::host function. The sketch can use the ' on ' function, ' send ' function, ' client ' function and others by ESP8266WebServer/WebServer reference of its return value. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> AutoConnect Portal; void handleRoot () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 200 , \"text/html\" , \"Hello, world\" ); } void handleNotFound () { ESP8266WebServer & IntServer = Portal.host(); IntServer.send( 404 , \"text/html\" , \"Unknown.\" ); } void setup () { bool r = Portal.begin(); if (r) { ESP8266WebServer & IntServer = Portal.host(); IntServer.on( \"/\" , handleRoot); Portal.onNotFound(handleNotFound); // For only onNotFound. } } void loop () { Portal.host().handleClient(); Portal.handleRequest(); /* or following one line code is equ. Portal.handleClient(); */ } ESP8266WebServer/WebServer function should be called after AutoConnect::begin The sketch cannot refer to an instance of ESP8266WebServer/WebServer until AutoConnect::begin completes successfully. Do not use with ESP8266WebServer::begin or WebServer::begin ESP8266WebServer/WebServer is already running inside the AutoConnect.","title":" Usage for automatically instantiated ESP8266WebServer/WebServer"},{"location":"advancedusage.html#use-with-the-pagebuilder-library","text":"In ordinary, the URL handler will respond the request by sending some HTML. PageBuilder library is HTML assembly aid. it can handle predefined HTML as like a template and simplify an HTML string assemble logic, and also the generated HTML send automatically. An example sketch used with the PageBuilder as follows and it explains how it aids for the HTML generating. Details for Github repository .","title":" Use with the PageBuilder library"},{"location":"advancedusage.html#configuration-functions","text":"","title":"Configuration functions"},{"location":"advancedusage.html#configuration-for-soft-ap-and-captive-portal","text":"AutoConnect will activate SoftAP at failed the first WiFi.begin . It SoftAP settings are stored in AutoConnectConfig as the following parameters. The sketch could be configured SoftAP using these parameters, refer the AutoConnectConfig API for details. IP address of SoftAP activated. Gateway IP address. Subnet mask. SSID for SoftAP. Password for SoftAP. Channel. SoftAP name. Hidden attribute. Station hostname. Auto save credential. Offset address of the credentials storage area in EEPROM. Captive portal time out limit. Maintain portal function even after a timeout. Length of start up time after reset. Automatic starting the captive portal. Start the captive portal forcefully. Auto reset after connection establishment. Home URL of the user sketch application. Menu title. Ticker signal output. AutoConnect::config before AutoConnect::begin AutoConnect::config must be executed before AutoConnect::begin .","title":" Configuration for Soft AP and captive portal"},{"location":"advancedusage.html#assign-user-sketchs-home-path","text":"HOME for returning to the user's sketch homepage will display at the bottom of the AutoConnect menu. It could be set using the AutoConnect::home function.","title":" Assign user sketch's home path"},{"location":"advancedusage.html#change-ssid-and-password-for-softap","text":"An esp8266ap is default SSID name for SoftAP of captive portal and password is 12345678 for ESP8266. Similarly, esp32ap and 12345678 for ESP32. You can change both by setting apid and psk . AutoConnect portal; AutoConnectConfig config; void setup () { config.apid = \"ap_portal\" ; config.psk = \"new_password\" ; portal.config(config); portal.begin(); } Also, you can specify the SSID, password for SoftAP with the constructor of the AutoConnectConfig as below. AutoConnect portal; AutoConnectConfig config ( \"ap_portal\" , \"new_passwrod\" ); void setup () { portal.config(config); portal.begin(); } You can also assign no password to SoftAP launched as a captive portal. Assigning a null string as String(\"\") to AutoConnectConfig::psk does not require a password when connecting to SoftAP. But this method is not recommended. The broadcast radio of SSID emitted from SoftAP will leak and reach several tens of meters.","title":" Change SSID and Password for SoftAP"},{"location":"advancedusage.html#relocate-the-autoconnect-home-path","text":"A home path of AutoConnect is /_ac by default. You can access from the browser with http://IPADDRESS/_ac. You can change the home path by revising AUTOCONNECT_URI macro in the include header file as AutoConnectDef.h . #define AUTOCONNECT_URI \"/_ac\"","title":" Relocate the AutoConnect home path"},{"location":"advancedusage.html#static-ip-assignment-2","text":"It is also possible to assign static IP Address to ESP8266/ESP32 in STA mode. By default DHCP is enabled and it becomes the IP address assigned by the DHCP server with WiFi.begin . To assign a static IP to ESP8266/ESP32 with WIFI_MODE_STA, the following parameters are required: IP address. Gateway address. Subnet mask. Primary DNS server. Secondary DNS server. (optional) The above parameters must be executed before AutoConnect::begin as arguments of AutoConnectConfig . AutoConnect portal; AutoConnectConfig Config; Config.staip = IPAddress( 192 , 168 , 1 , 10 ); Config.staGateway = IPAddress( 192 , 168 , 1 , 1 ); Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); Config.dns1 = IPAddress( 192 , 168 , 1 , 1 ); portal.config(Config); portal.begin();","title":" Static IP assignment 2"},{"location":"advancedusage.html#station-host-name","text":"AutoConnectConfig::hostName assigns the station DHCP hostname which complies with RFC952 . It must satisfy the following constraints. Up to 24 characters Only the alphabet (a-z, A-Z), digits (0-9), minus sign (-) No '-' as last character","title":" Station host name"},{"location":"advancedusage.html#ticker-for-wifi-status","text":"Flicker signal can be output from the ESP8266/ESP32 module according to WiFi connection status. If you connect the LED to the signal output pin, you can know the WiFi connection status during behavior inside AutoConnect::begin through the LED blink. AutoConnectConfig::ticker option specifies flicker signal output. The following sketch is an example of flashing the active-high LED connected to pin #16 according to WiFi connection during the AutoConnect::begin. AutoConnect portal; AutoConnectConfig Config; Config.ticker = true; config.tickerPort = 16 ; Config.tickerOn = HIGH; portal.config(Config); portal.begin(); The AutoConnect ticker indicates the WiFi connection status in the following three flicker patterns: Short blink: The ESP module stays in APSTA mode. Short-on and long-off: No STA connection state. (i.e. WiFi.status != WL_CONNECTED) No blink: WiFi connection with access point established and data link enabled. (i.e. WiFi.status = WL_CONNECTED) The flicker cycle length is defined by some macros in AutoConnectDefs.h header file. #define AUTOCONNECT_FLICKER_PERIODAP 1000 // [ms] #define AUTOCONNECT_FLICKER_PERIODDC (AUTOCONNECT_FLICKER_PERIODAP << 1) // [ms] #define AUTOCONNECT_FLICKER_WIDTHAP 96 // (8 bit resolution) #define AUTOCONNECT_FLICKER_WIDTHDC 16 // (8 bit resolution) AUTOCONNECTT_FLICKER_PERIODAP : Assigns a flicker period when the ESP module stays in APSTA mode. AUTOCONNECT_FLICKER_PERIODDC : Assigns a flicker period when WiFi is disconnected. AUTOCONNECT_FLICKER_WIDTHAP and AUTOCONNECT_FLICKER_WIDTHDC : Specify the duty rate for each period[ms] in 8-bit resolution. AutoConnectConfig::tickerPort specifies a port that outputs the flicker signal. If you are using an LED-equipped ESP module board, you can assign a LED pin to the tick-port for the WiFi connection monitoring without the external LED. The default pin is arduino valiant's LED_BUILTIN . You can refer to the Arduino IDE's variant information to find out which pin actually on the module assign to LED_BUILTIN . 3 AutoConnectConfig::tickerOn specifies the active logic level of the flicker signal. This value indicates the active signal level when driving the ticker. For example, if the LED connected to tickPort lights by LOW, the tickerOn is LOW . The logic level of LED_BUILTIN for popular modules are as follows: module Logic level LED_BUILTIN Pin Arduino alias NodeMCU V1.0 Active-low 16 D0 WEMOS D1 mini Active-low 2 D4 SparkFun ESP8266 Thing Active-high 5 Adafruit Feather HUZZAH ESP8266 Active-low 0 NodeMCU 32s Active-high 2 T2 LOLIN32 Pro Active-low 5 SS SparkFun ESP32 Thing Active-high 5 Adafruit Feather HUZZAH32 Active-high 13 A12 The source code placement of common macros for AutoConnect since v0.9.7 has changed. \u21a9 Static IP address assignment is available from version 0.9.3. \u21a9 It's defined in the pins_arduino.h file, located in the sub-folder named variants wherein Arduino IDE installed folder. \u21a9","title":" Ticker for WiFi status"},{"location":"api.html","text":"Include headers \u00b6 AutoConnect.h \u00b6 #include <AutoConnect.h> Defined macros \u00b6 They contain in AutoConnectDefs.h . #define AC_DEBUG // Monitor message output activation #define AC_DEBUG_PORT Serial // Default message output device #define AUTOCONNECT_AP_IP 0x01F4A8C0 // Default SoftAP IP #define AUTOCONNECT_AP_GW 0x01F4A8C0 // Default SoftAP Gateway IP #define AUTOCONNECT_AP_NM 0x00FFFFFF // Default subnet mask #define AUTOCONNECT_DNSPORT 53 // Default DNS port at captive portal #define AUTOCONNECT_HTTPPORT 80 // Default HTTP #define AUTOCONNECT_MENU_TITLE \"AutoConnect\" // Default AutoConnect menu title #define AUTOCONNECT_STARTUPTIME 10 // Default waiting time[s] for after reset #define AUTOCONNECT_URI \"/_ac\" // Default AutoConnect root path #define AUTOCONNECT_TIMEOUT 30000 // Default connection timeout[ms] #define AUTOCONNECT_CAPTIVEPORTAL_TIMEOUT 0 // Captive portal timeout value #define AUTOCONNECT_USE_JSON // Allow AutoConnect elements to be handled by JSON format Macros placement moved Source code placement of the above macros provided for user sketch changed from v0.9.7. The new code is in AutoConnectDefs.h . Constructors \u00b6 AutoConnect \u00b6 AutoConnect() AutoConnect default constructor. This entry internally allocates the ESP8266WebServer for ESP8266 or WebServer for ESP32 and is activated internally. For ESP8266 AutoConnect(ESP8266WebServer & webServer) For ESP32 AutoConnect(WebServer & webServer) Run the AutoConnect site using the externally ensured ESP8266WebServer for ESP8266 or WebServer for ESP32. The handleClient function of AutoConnect can include the response of the URI handler added by the user using the \" on \" function of ESP8266WebServer/WebServer. If ESP8266WebServer/WebServer is assigned internally by AutoConnect, the sketch can obtain that reference with the host function. Parameter webServer A reference of ESP8266WebServer or WebServer instance. Public member functions \u00b6 aux \u00b6 AutoConnectAux * aux( const String & uri) const Returns a pointer to AutoConnectAux with the URI specified by uri . If AutoConnectAux with that URI is not bound, it returns nullptr . Parameter uri A string of the URI. Return value A Pointer of the AutoConnectAux instance. begin \u00b6 bool begin() bool begin( const char * ssid, const char * passphrase) bool begin( const char * ssid, const char * passphrase, unsigned long timeout) Starts establishing the WiFi connection. The WiFi mode at this time is WIFI_STA. AutoConnect first invokes WiFi.begin . If the ssid and the passphrase are missing, its WiFi.begin has no SSID and Password. Regardless of the result, ESP8266WebServer/WebServer will start immediately after the first WiFi.begin . The captive portal will not be started if the connection has been established with first WiFi.begin . If the connection cannot establish, switch to WIFI_AP_STA mode and activate SoftAP. Then DNS server starts. Parameters ssid SSID to be connected. passphrase Password for connection. timeout A time out value in milliseconds for waiting connection. Return value true Connection established, AutoConnect service started with WIFI_STA mode. false Could not connected, Captive portal started with WIFI_AP_STA mode. config \u00b6 bool config(AutoConnectConfig & config) bool config( const char * ap, const char * password = nullptr ) Set SoftAP's WiFi configuration and static IP configuration. Parameters config Reference to AutoConnectConfig containing SoftAP's parameters and static IP parameters. ap SSID for SoftAP. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The default value is 12345678 . Return value true Successfully configured. false Configuration parameter is invalid, some values out of range. end \u00b6 void end( void ) Stops AutoConnect captive portal service. Release ESP8266WebServer/WebServer and DNSServer. Attention to end The end function releases the instance of ESP8266WebServer/WebServer and DNSServer. It can not process them after the end function. handleClient \u00b6 void handleClient( void ) Process the AutoConnect menu interface. The handleClient() function of the ESP8266WebServer/WebServer hosted by AutoConnect is also called from within AutoConnect, and the client request handlers contained in the user sketch are also handled. handleRequest \u00b6 void handleRequest( void ) Handling for the AutoConnect menu request. About used in combination with handleClient The handleRequest function is not supposed to use with AutoConnect::handleClient. It should be used with ESP8266WebServer::handleClient or WebServer::handleClient. home \u00b6 void home(String & uri) Put a user site's home URI. The URI specified by home is linked from \"HOME\" in the AutoConnect menu. Parameter uri A URI string of user site's home path. host \u00b6 For ESP8266 ESP8266WebServer & host( void ) For ESP32 WebServer & host( void ) Returns the reference of the ESP8266WebServer/WebServer which is allocated in AutoConnect automatically. Return value A reference of the ESP8266WebServer/WebServer. &reference is not a pointer A reference cannot be re-assigned, and must be assigned at initialization. It's like as bind as alias. ESP8266WebServer & server = portal.host(); server.handleClient(); or portal.host().handleClient(); join \u00b6 void join(AutoConnectAux & aux) void join(std :: vector < std :: reference_wrapper < AutoConnectAux >> aux) Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joined one by one, or joined altogether. The AutoConnectAux object joined by the join function can be handled from the AutoConnect menu. Parameter aux Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with list initialization . load \u00b6 bool load( const String & aux) bool load(PGM_P aux) bool load( const __FlashStringHelper * aux) bool load(Stream & aux) Load JSON document of AutoConnectAux which contains AutoConnectElements. If there is a syntax error in the JSON document, false is returned. Parameter aux The input string to be loaded. Return value true The JSON document as AutoConnectAux successfully loaded. false Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the ArduinoJson Assistant . on \u00b6 bool on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters uri A string of the URI assigned to the AutoConnectAux page. handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. It is not ESP8266WebServer::on, not WebServer::on for ESP32. This function effects to AutoConnectAux only. However, it coexists with that of ESP8266WebServer::on or WebServer::on of ESP32. onDetect \u00b6 void onDetect(DetectExit_ft fn) Register the function which will call from AutoConnect at the start of the captive portal. Parameter fn Function called at the captive portal start. An fn specifies the function called when the captive portal starts. Its prototype declaration is defined as \" DetectExit_ft \". typedef std :: function < bool (IPAddress softapIP) > DetectExit_ft Parameter softapIP An IP address of SoftAP for the captive portal. Return value true Continues captive portal handling. false Cancel the captive portal. AutoConnect::begin function will return with a false. onNotFound \u00b6 For ESP8266 void onNotFound(ESP8266WebServer :: THandlerFunction fn) For ESP32 void onNotFound(WebServer :: THandlerFunction fn) Register the handler function for undefined URL request detected. Parameter fn A function of the \"not found\" handler. where \u00b6 String where( void ) Returns an uri string of the AutoConnectAux uri object of the custom Web page that caused the request to the page. AutoConnect identifies the URI (ie. the referrer URI) that caused the request each time from the client occurs and will save the URI If the request source is a custom Web page of AutoConnectAux. The where function returns a pointer of AutoConnectAux which is a URI of a least recent request from the custom Web page. This function is provided to access the fields (ie. the AutoConnectElements) with a custom Web page handler of a page and is available only for request source that is the custom Web pages. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/WebServer for ESP32. In other words, this function only returns the AutoConnecAux page which is a least recently displayed. Return value An uri string of the AutoConnectAux that caused the request the page. The where function usage is described in the section Where to pick up the values .","title":"AutoConnect API"},{"location":"api.html#include-headers","text":"","title":" Include headers"},{"location":"api.html#autoconnecth","text":"#include <AutoConnect.h>","title":"AutoConnect.h"},{"location":"api.html#defined-macros","text":"They contain in AutoConnectDefs.h . #define AC_DEBUG // Monitor message output activation #define AC_DEBUG_PORT Serial // Default message output device #define AUTOCONNECT_AP_IP 0x01F4A8C0 // Default SoftAP IP #define AUTOCONNECT_AP_GW 0x01F4A8C0 // Default SoftAP Gateway IP #define AUTOCONNECT_AP_NM 0x00FFFFFF // Default subnet mask #define AUTOCONNECT_DNSPORT 53 // Default DNS port at captive portal #define AUTOCONNECT_HTTPPORT 80 // Default HTTP #define AUTOCONNECT_MENU_TITLE \"AutoConnect\" // Default AutoConnect menu title #define AUTOCONNECT_STARTUPTIME 10 // Default waiting time[s] for after reset #define AUTOCONNECT_URI \"/_ac\" // Default AutoConnect root path #define AUTOCONNECT_TIMEOUT 30000 // Default connection timeout[ms] #define AUTOCONNECT_CAPTIVEPORTAL_TIMEOUT 0 // Captive portal timeout value #define AUTOCONNECT_USE_JSON // Allow AutoConnect elements to be handled by JSON format Macros placement moved Source code placement of the above macros provided for user sketch changed from v0.9.7. The new code is in AutoConnectDefs.h .","title":" Defined macros"},{"location":"api.html#constructors","text":"","title":" Constructors"},{"location":"api.html#autoconnect","text":"AutoConnect() AutoConnect default constructor. This entry internally allocates the ESP8266WebServer for ESP8266 or WebServer for ESP32 and is activated internally. For ESP8266 AutoConnect(ESP8266WebServer & webServer) For ESP32 AutoConnect(WebServer & webServer) Run the AutoConnect site using the externally ensured ESP8266WebServer for ESP8266 or WebServer for ESP32. The handleClient function of AutoConnect can include the response of the URI handler added by the user using the \" on \" function of ESP8266WebServer/WebServer. If ESP8266WebServer/WebServer is assigned internally by AutoConnect, the sketch can obtain that reference with the host function. Parameter webServer A reference of ESP8266WebServer or WebServer instance.","title":"AutoConnect"},{"location":"api.html#public-member-functions","text":"","title":" Public member functions"},{"location":"api.html#aux","text":"AutoConnectAux * aux( const String & uri) const Returns a pointer to AutoConnectAux with the URI specified by uri . If AutoConnectAux with that URI is not bound, it returns nullptr . Parameter uri A string of the URI. Return value A Pointer of the AutoConnectAux instance.","title":" aux"},{"location":"api.html#begin","text":"bool begin() bool begin( const char * ssid, const char * passphrase) bool begin( const char * ssid, const char * passphrase, unsigned long timeout) Starts establishing the WiFi connection. The WiFi mode at this time is WIFI_STA. AutoConnect first invokes WiFi.begin . If the ssid and the passphrase are missing, its WiFi.begin has no SSID and Password. Regardless of the result, ESP8266WebServer/WebServer will start immediately after the first WiFi.begin . The captive portal will not be started if the connection has been established with first WiFi.begin . If the connection cannot establish, switch to WIFI_AP_STA mode and activate SoftAP. Then DNS server starts. Parameters ssid SSID to be connected. passphrase Password for connection. timeout A time out value in milliseconds for waiting connection. Return value true Connection established, AutoConnect service started with WIFI_STA mode. false Could not connected, Captive portal started with WIFI_AP_STA mode.","title":" begin"},{"location":"api.html#config","text":"bool config(AutoConnectConfig & config) bool config( const char * ap, const char * password = nullptr ) Set SoftAP's WiFi configuration and static IP configuration. Parameters config Reference to AutoConnectConfig containing SoftAP's parameters and static IP parameters. ap SSID for SoftAP. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The default value is 12345678 . Return value true Successfully configured. false Configuration parameter is invalid, some values out of range.","title":" config"},{"location":"api.html#end","text":"void end( void ) Stops AutoConnect captive portal service. Release ESP8266WebServer/WebServer and DNSServer. Attention to end The end function releases the instance of ESP8266WebServer/WebServer and DNSServer. It can not process them after the end function.","title":" end"},{"location":"api.html#handleclient","text":"void handleClient( void ) Process the AutoConnect menu interface. The handleClient() function of the ESP8266WebServer/WebServer hosted by AutoConnect is also called from within AutoConnect, and the client request handlers contained in the user sketch are also handled.","title":" handleClient"},{"location":"api.html#handlerequest","text":"void handleRequest( void ) Handling for the AutoConnect menu request. About used in combination with handleClient The handleRequest function is not supposed to use with AutoConnect::handleClient. It should be used with ESP8266WebServer::handleClient or WebServer::handleClient.","title":" handleRequest"},{"location":"api.html#home","text":"void home(String & uri) Put a user site's home URI. The URI specified by home is linked from \"HOME\" in the AutoConnect menu. Parameter uri A URI string of user site's home path.","title":" home"},{"location":"api.html#host","text":"For ESP8266 ESP8266WebServer & host( void ) For ESP32 WebServer & host( void ) Returns the reference of the ESP8266WebServer/WebServer which is allocated in AutoConnect automatically. Return value A reference of the ESP8266WebServer/WebServer. &reference is not a pointer A reference cannot be re-assigned, and must be assigned at initialization. It's like as bind as alias. ESP8266WebServer & server = portal.host(); server.handleClient(); or portal.host().handleClient();","title":" host"},{"location":"api.html#join","text":"void join(AutoConnectAux & aux) void join(std :: vector < std :: reference_wrapper < AutoConnectAux >> aux) Join the AutoConnectAux object to AutoConnect. AutoConnectAux objects can be joined one by one, or joined altogether. The AutoConnectAux object joined by the join function can be handled from the AutoConnect menu. Parameter aux Reference to AutoConnectAux. It can be std::vector of std::reference_wrapper of AutoConnectAux with list initialization .","title":" join"},{"location":"api.html#load","text":"bool load( const String & aux) bool load(PGM_P aux) bool load( const __FlashStringHelper * aux) bool load(Stream & aux) Load JSON document of AutoConnectAux which contains AutoConnectElements. If there is a syntax error in the JSON document, false is returned. Parameter aux The input string to be loaded. Return value true The JSON document as AutoConnectAux successfully loaded. false Loading JSON document unsuccessful, probably syntax errors have occurred or insufficient memory. You can diagnose the cause of loading failure using the ArduinoJson Assistant .","title":" load"},{"location":"api.html#on","text":"bool on( const String & uri, const AuxHandlerFunctionT handler, AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters uri A string of the URI assigned to the AutoConnectAux page. handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. It is not ESP8266WebServer::on, not WebServer::on for ESP32. This function effects to AutoConnectAux only. However, it coexists with that of ESP8266WebServer::on or WebServer::on of ESP32.","title":" on"},{"location":"api.html#ondetect","text":"void onDetect(DetectExit_ft fn) Register the function which will call from AutoConnect at the start of the captive portal. Parameter fn Function called at the captive portal start. An fn specifies the function called when the captive portal starts. Its prototype declaration is defined as \" DetectExit_ft \". typedef std :: function < bool (IPAddress softapIP) > DetectExit_ft Parameter softapIP An IP address of SoftAP for the captive portal. Return value true Continues captive portal handling. false Cancel the captive portal. AutoConnect::begin function will return with a false.","title":" onDetect"},{"location":"api.html#onnotfound","text":"For ESP8266 void onNotFound(ESP8266WebServer :: THandlerFunction fn) For ESP32 void onNotFound(WebServer :: THandlerFunction fn) Register the handler function for undefined URL request detected. Parameter fn A function of the \"not found\" handler.","title":" onNotFound"},{"location":"api.html#where","text":"String where( void ) Returns an uri string of the AutoConnectAux uri object of the custom Web page that caused the request to the page. AutoConnect identifies the URI (ie. the referrer URI) that caused the request each time from the client occurs and will save the URI If the request source is a custom Web page of AutoConnectAux. The where function returns a pointer of AutoConnectAux which is a URI of a least recent request from the custom Web page. This function is provided to access the fields (ie. the AutoConnectElements) with a custom Web page handler of a page and is available only for request source that is the custom Web pages. It is invalid for HTTP requests from individual pages registered with the on handler of ESP8266WebServer/WebServer for ESP32. In other words, this function only returns the AutoConnecAux page which is a least recently displayed. Return value An uri string of the AutoConnectAux that caused the request the page. The where function usage is described in the section Where to pick up the values .","title":" where"},{"location":"apiaux.html","text":"Constructor \u00b6 AutoConnectAux \u00b6 AutoConnectAux( const String & uri = String( \"\" ), const String & title = String( \"\" ), const bool menu = true, const AutoConnectElementVT addons = AutoConnectElementVT()) Parameters uri URI of this custom Web Page. title Page title of this custom Web page. It will appear on the auto connection menu and at the top of that page. menu Specifies whether to display this page on menu. addons Reference to AutoConnectElement collection. Public member functions \u00b6 operator [ ] \u00b6 AutoConnectElement & operator []( const String & name) Returns a reference to the element specified by name . An operator [] is a shortcut for getElement function with the reference casting. Unlike getElement, which returns a pointer to that element, an operator [] returns a reference to that element. You also need to cast the return value to the actual type, just like the getElement function. Parameter name Name of the AutoConnectElements to be retrieved. Return value A reference to AutoConnectElement. It is different from the actual element type. add \u00b6 void add(AutoConnectElement & addon) void add(AutoConnectElementVT addons) Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu. Parameters addon Reference of AutoConnectElements. Specifies one of the AutoConnectElements classes. addons An array list of reference of AutoConnectElements. The list initialization with braced-init-list of the std::vector can be used for the addons parameter cause the actual definition of type AutoConnectElementVT is std::vector<std::reference_wrapper<AutoConnectElement>> . fetchElement \u00b6 void fetchElement( void ) Retrieve the values of the AutoConnectElements on the custom Web page. Refer to how to use the fetchElement . getElement \u00b6 T & getElement < T > ( const String & name) AutoConnectElement * getElement( const String & name) Get a registered AutoConnectElement as specified name. If T is specified as an actual type of AutoConnectElements, it returns a reference to that instance. Parameters T Actual type name of AutoConnectElements as AutoConnectButton , AutoConnectCheckbox , AutoConnectElement , AutoConnectFile , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectSubmit , AutoConnectText . name Name of the AutoConnectElements to be retrieved. Return value A reference of the AutoConnectElements. If a type is not specified returns a pointer. getElements \u00b6 AutoConnectElementVT & getElements( void ) Get vector of reference of all elements. Return value A reference to std::vector of reference to AutoConnecctElements. The getElements returns a reference to std::vector of reference to AutoConnecctElements. This function is provided to handle AutoConnectElemets owned by AutoConnectAux in bulk, and you can use each method of std::vector for a return value. // An example of getting type and name of all AutoConnectElements registered in AutoConnectAux. AutoConnectAux aux; // some code here... AutoConnectElementVt & elements = aux.getElements(); for (AutoConnectElement & elm : elements) { Serial.printf( \"name<%s> as type %d \\n \" , elm.name.c_str(), ( int )elm.typeOf()); } isMenu \u00b6 bool isMenu( void ) Returns whether embedded in the menu or not. The isMenu is a function that complements the menu function. Return value true The custom Web page has been incorporated into the AutoConnect menu as a menu item. false This custom Web page is not currently a menu item. isValid \u00b6 bool isValid( void ) Performs validation of all AutoConnectInput elements owned by AutoConnectAux and returns the result. The isValid function will return the true even if the AutoConnectAux does not own AutoConnectInputs. Return value true Validation is successful. A value of all AutoConnectInputs match with each pattern. false Some elements failed validation. load \u00b6 bool load( const String & in) bool load(PGM_P in) bool load( const __FlashStringHelper * in) bool load(Stream & in) Load all AutoConnectElements elements from JSON document into AutoConnectAux as custom Web pages. The JSON document specified by the load function must be the document structure of AutoConnectAux. Its JSON document can describe multiple pages as an array. Parameter in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. Return value true JSON document as the custom Web pages successfully loaded. false JSON document loading failed. Load multiple custom Web pages separately Multiple custom Web pages can be loaded at once with JSON as an array. But it will consume a lot of memory. By loading a JSON document by page as much as possible, you can reduce memory consumption. loadElement \u00b6 bool loadElement( const String & in, const String & name = String( \"\" )) bool loadElement( const String & in, std :: vector < String > const & names) bool loadElement(PGM_P in, const String & name = String( \"\" )) bool loadElement(PGM_P in, std :: vector < String > const & names) bool loadElement( const __FlashStringHelper * in, const String & name = String( \"\" )) bool loadElement( const __FlashStringHelper * in, std :: vector < String > const & names) bool loadElement(Stream & in, const String & name = String( \"\" )) bool loadElement(Stream & in, std :: vector < String > const & names) Load specified element from JSON document into AutoConnectAux. The JSON document specified by the loadElement function must be the AutoConnectElement document structure . When loading from a JSON document that describes multiple elements, its description must be an array syntax. Parameters in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. name Specifies the name to be load. If the name is not specified, the loadElement function will load all elements contained in the JSON document. names Spefifies an array list of String indicating the name of the element to be loaded. The list initialization with braced-init-list of the std::vector can be used. Return value true Specified AutoConnectElements successfully loaded. false JSON document loading failed. Maybe it is an array Please note that the JSON document that is the input for loadElement is an array syntax of AutoConnectElements when there are multiple elements. For example, the following JSON document has a syntax error: { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"value\" : \"Hello, world\" } , { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" } The outermost [ , ] is missing. menu \u00b6 void menu( const bool post) Set or reset the display as menu item for this AutoConnectAux. This function programmatically manipulates the menu parameter of the AutoConnectAux constructor . Parameter true Show on the menu. false Hidden on the menu. on \u00b6 void on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated. onUpload \u00b6 void onUpload < T &> (T handler) void onUpload(PageBuilder :: UploadFuncT uploadFunc) Register the upload handler of the AutoConnectAux. Parameters T Specifies a class name of the custom uploader inherited from AutoConnectUploadHandler class. Refer to the appendix for details. handler Specifies the custom uploader inherited from AutoConnectUploadHandler class. Refer to the appendix for details. uploadFunc A function that behaves when request to upload with the AutoConnectAux page. UploadFuncT type is defined by the following declaration. void(const String&, const HTTPUpload&) A data structure of the upload file as HTTPUpload. It is defined in the ESP8266WebServer (the WebServer for ESP32) library as follows: typedef struct { HTTPUploadStatus status; String filename; String name; String type; size_t totalSize; size_t currentSize; size_t contentLength; uint8_t buf[HTTP_UPLOAD_BUFLEN]; } HTTPUpload; Refer to ' To upload to a device other than Flash or SD ' in section appendix for details. release \u00b6 bool release( const String & name) Release a specified AutoConnectElement from AutoConnectAux. The release function is provided to dynamically change the structure of the custom Web pages with the sketch. By combining the release function and the add function or the loadElement function, the sketch can change the style of the custom Web page according to its behavior. Parameter name Specifies the name of AutoConnectElements to be released. Return value true The AutoConnectElement successfully released. false The AutoConnectElement can not be released. saveElement \u00b6 size_t saveElement(Stream & out, std :: vector < String > const & names = {}) Write elements of AutoConnectAux to the stream. The saveElement function outputs the specified AutoConnectElements as a JSON document using the prettyPrintTo function of the ArduinoJson library. Parameters out Output stream to be output. SPIFFS, SD also Serial can be specified generally. names The array of the name of AutoConnectElements to be output. If the names parameter is not specified, all AutoConnectElements registered in AutoConnectAux are output. Return value The number of bytes written. The output format is pretty The saveElement function outputs a prettified JSON document. It is not complementary with loadElement The saveElement function which missing the names parameter without name list to be saved that saves an entire AutoConnectAux element, not just AutoConnectElements. Its saved JSON document is not a complementary input to the loadElement function. The JSON document describing AutoConnectAux saved without the names parameter must be loaded by the AutoConnectAux::load function or AutoConnect::load function. setElementValue \u00b6 bool setElementValue( const String & name, const String value) bool setElementValue( const String & name, std :: vector < String > const & values) Sets the value of the specified AutoConnectElement. If values \u200b\u200bis specified as a std::vector of String, the element that can set the values is the AutoConnectRadio or the AutoConnectSelect . Parameters name Specifies the name of the AutoConnectElements that you want to set the value. value Specifies the value to be set. values Specifies a reference of a std::vector of String. It contains the values of the AutoConnectRadio or the AutoConnectSelect. Return value true The value has been set. false AutoConnectElements with the specified name are not registered. Or the type of the value is not consistent with the specified AutoConnectElements. You can directly access the value member variable. If you are gripping with the sketch to the AutoConnectElements of the target that sets the value, you can access the value member variable directly. The following sketch code has the same effect. AutoConnectAux aux; // ... Griping the AutoConnectText here. aux.setElementValue( \"TEXT_FIELD\" , \"New value\" ); AutoConnectAux aux; // ... Griping the AutoConnectText here. AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_FIELD\" ); text.value = \"New value\" ; The difference between the setElementValue and the value access with the getElement is the certainty of the registration state for the element. The getElement returns an empty object if the element is not registered then a sketch assigns the value to it. May occur unexpected results and crashes. You should use the setElementValue if its registration is unsettled. setTitle \u00b6 void setTitle( const String & title) Set the title string of the custom Web page. This title will be displayed as the menu title of the custom Web page. Parameter title Title string to be display. Not the menu title The setTitle function is not set for the AutoConnect menu title. The effect of this function is that custom Web page only. To change the AutoConnect menu title use AutoConnectConfig::title .","title":"AutoConnectAux API"},{"location":"apiaux.html#constructor","text":"","title":" Constructor"},{"location":"apiaux.html#autoconnectaux","text":"AutoConnectAux( const String & uri = String( \"\" ), const String & title = String( \"\" ), const bool menu = true, const AutoConnectElementVT addons = AutoConnectElementVT()) Parameters uri URI of this custom Web Page. title Page title of this custom Web page. It will appear on the auto connection menu and at the top of that page. menu Specifies whether to display this page on menu. addons Reference to AutoConnectElement collection.","title":"AutoConnectAux"},{"location":"apiaux.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apiaux.html#operator","text":"AutoConnectElement & operator []( const String & name) Returns a reference to the element specified by name . An operator [] is a shortcut for getElement function with the reference casting. Unlike getElement, which returns a pointer to that element, an operator [] returns a reference to that element. You also need to cast the return value to the actual type, just like the getElement function. Parameter name Name of the AutoConnectElements to be retrieved. Return value A reference to AutoConnectElement. It is different from the actual element type.","title":" operator [ ]"},{"location":"apiaux.html#add","text":"void add(AutoConnectElement & addon) void add(AutoConnectElementVT addons) Add an element to the AutoConnectAux. An added element is displayed on the custom Web page invoked from the AutoConnect menu. Parameters addon Reference of AutoConnectElements. Specifies one of the AutoConnectElements classes. addons An array list of reference of AutoConnectElements. The list initialization with braced-init-list of the std::vector can be used for the addons parameter cause the actual definition of type AutoConnectElementVT is std::vector<std::reference_wrapper<AutoConnectElement>> .","title":" add"},{"location":"apiaux.html#fetchelement","text":"void fetchElement( void ) Retrieve the values of the AutoConnectElements on the custom Web page. Refer to how to use the fetchElement .","title":" fetchElement"},{"location":"apiaux.html#getelement","text":"T & getElement < T > ( const String & name) AutoConnectElement * getElement( const String & name) Get a registered AutoConnectElement as specified name. If T is specified as an actual type of AutoConnectElements, it returns a reference to that instance. Parameters T Actual type name of AutoConnectElements as AutoConnectButton , AutoConnectCheckbox , AutoConnectElement , AutoConnectFile , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectSubmit , AutoConnectText . name Name of the AutoConnectElements to be retrieved. Return value A reference of the AutoConnectElements. If a type is not specified returns a pointer.","title":" getElement"},{"location":"apiaux.html#getelements","text":"AutoConnectElementVT & getElements( void ) Get vector of reference of all elements. Return value A reference to std::vector of reference to AutoConnecctElements. The getElements returns a reference to std::vector of reference to AutoConnecctElements. This function is provided to handle AutoConnectElemets owned by AutoConnectAux in bulk, and you can use each method of std::vector for a return value. // An example of getting type and name of all AutoConnectElements registered in AutoConnectAux. AutoConnectAux aux; // some code here... AutoConnectElementVt & elements = aux.getElements(); for (AutoConnectElement & elm : elements) { Serial.printf( \"name<%s> as type %d \\n \" , elm.name.c_str(), ( int )elm.typeOf()); }","title":" getElements"},{"location":"apiaux.html#ismenu","text":"bool isMenu( void ) Returns whether embedded in the menu or not. The isMenu is a function that complements the menu function. Return value true The custom Web page has been incorporated into the AutoConnect menu as a menu item. false This custom Web page is not currently a menu item.","title":" isMenu"},{"location":"apiaux.html#isvalid","text":"bool isValid( void ) Performs validation of all AutoConnectInput elements owned by AutoConnectAux and returns the result. The isValid function will return the true even if the AutoConnectAux does not own AutoConnectInputs. Return value true Validation is successful. A value of all AutoConnectInputs match with each pattern. false Some elements failed validation.","title":" isValid"},{"location":"apiaux.html#load","text":"bool load( const String & in) bool load(PGM_P in) bool load( const __FlashStringHelper * in) bool load(Stream & in) Load all AutoConnectElements elements from JSON document into AutoConnectAux as custom Web pages. The JSON document specified by the load function must be the document structure of AutoConnectAux. Its JSON document can describe multiple pages as an array. Parameter in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. Return value true JSON document as the custom Web pages successfully loaded. false JSON document loading failed. Load multiple custom Web pages separately Multiple custom Web pages can be loaded at once with JSON as an array. But it will consume a lot of memory. By loading a JSON document by page as much as possible, you can reduce memory consumption.","title":" load"},{"location":"apiaux.html#loadelement","text":"bool loadElement( const String & in, const String & name = String( \"\" )) bool loadElement( const String & in, std :: vector < String > const & names) bool loadElement(PGM_P in, const String & name = String( \"\" )) bool loadElement(PGM_P in, std :: vector < String > const & names) bool loadElement( const __FlashStringHelper * in, const String & name = String( \"\" )) bool loadElement( const __FlashStringHelper * in, std :: vector < String > const & names) bool loadElement(Stream & in, const String & name = String( \"\" )) bool loadElement(Stream & in, std :: vector < String > const & names) Load specified element from JSON document into AutoConnectAux. The JSON document specified by the loadElement function must be the AutoConnectElement document structure . When loading from a JSON document that describes multiple elements, its description must be an array syntax. Parameters in Specifies the JSON document to be load. The load function can input the following objects. String : Read-only String PROGMEM : Character array contained in the flash Stream : An entity that inherits stream class, generally SPIFFS or SD. name Specifies the name to be load. If the name is not specified, the loadElement function will load all elements contained in the JSON document. names Spefifies an array list of String indicating the name of the element to be loaded. The list initialization with braced-init-list of the std::vector can be used. Return value true Specified AutoConnectElements successfully loaded. false JSON document loading failed. Maybe it is an array Please note that the JSON document that is the input for loadElement is an array syntax of AutoConnectElements when there are multiple elements. For example, the following JSON document has a syntax error: { \"name\" : \"Caption\" , \"type\" : \"ACText\" , \"value\" : \"Hello, world\" } , { \"name\" : \"Server\" , \"type\" : \"ACInput\" , \"label\" : \"Server address\" } The outermost [ , ] is missing.","title":" loadElement"},{"location":"apiaux.html#menu","text":"void menu( const bool post) Set or reset the display as menu item for this AutoConnectAux. This function programmatically manipulates the menu parameter of the AutoConnectAux constructor . Parameter true Show on the menu. false Hidden on the menu.","title":" menu"},{"location":"apiaux.html#on","text":"void on( const AuxHandlerFunctionT handler, const AutoConnectExitOrder_t order = AC_EXIT_AHEAD) Register the handler function of the AutoConnectAux. Parameters handler A function that behaves when a request to the AutoConnectAux page occurs. AuxHandlerFunctionT type is defined by the following declaration. String handler(AutoConnectAux&, PageArgument&) order Specifies when the handler is called with the following enumeration value. AC_EXIT_AHEAD : Called before AutoConnect generates the HTML of the page. You set the value of AutoConnectElements in the handler then its value will be displayed on the page. AC_EXIT_LATER : Called after AutoConnect generates the HTML of the page. You can append to HTML generated by AutoConnect. AC_EXIT_BOTH : Called even before generating HTML and after generated.","title":" on"},{"location":"apiaux.html#onupload","text":"void onUpload < T &> (T handler) void onUpload(PageBuilder :: UploadFuncT uploadFunc) Register the upload handler of the AutoConnectAux. Parameters T Specifies a class name of the custom uploader inherited from AutoConnectUploadHandler class. Refer to the appendix for details. handler Specifies the custom uploader inherited from AutoConnectUploadHandler class. Refer to the appendix for details. uploadFunc A function that behaves when request to upload with the AutoConnectAux page. UploadFuncT type is defined by the following declaration. void(const String&, const HTTPUpload&) A data structure of the upload file as HTTPUpload. It is defined in the ESP8266WebServer (the WebServer for ESP32) library as follows: typedef struct { HTTPUploadStatus status; String filename; String name; String type; size_t totalSize; size_t currentSize; size_t contentLength; uint8_t buf[HTTP_UPLOAD_BUFLEN]; } HTTPUpload; Refer to ' To upload to a device other than Flash or SD ' in section appendix for details.","title":" onUpload"},{"location":"apiaux.html#release","text":"bool release( const String & name) Release a specified AutoConnectElement from AutoConnectAux. The release function is provided to dynamically change the structure of the custom Web pages with the sketch. By combining the release function and the add function or the loadElement function, the sketch can change the style of the custom Web page according to its behavior. Parameter name Specifies the name of AutoConnectElements to be released. Return value true The AutoConnectElement successfully released. false The AutoConnectElement can not be released.","title":" release"},{"location":"apiaux.html#saveelement","text":"size_t saveElement(Stream & out, std :: vector < String > const & names = {}) Write elements of AutoConnectAux to the stream. The saveElement function outputs the specified AutoConnectElements as a JSON document using the prettyPrintTo function of the ArduinoJson library. Parameters out Output stream to be output. SPIFFS, SD also Serial can be specified generally. names The array of the name of AutoConnectElements to be output. If the names parameter is not specified, all AutoConnectElements registered in AutoConnectAux are output. Return value The number of bytes written. The output format is pretty The saveElement function outputs a prettified JSON document. It is not complementary with loadElement The saveElement function which missing the names parameter without name list to be saved that saves an entire AutoConnectAux element, not just AutoConnectElements. Its saved JSON document is not a complementary input to the loadElement function. The JSON document describing AutoConnectAux saved without the names parameter must be loaded by the AutoConnectAux::load function or AutoConnect::load function.","title":" saveElement"},{"location":"apiaux.html#setelementvalue","text":"bool setElementValue( const String & name, const String value) bool setElementValue( const String & name, std :: vector < String > const & values) Sets the value of the specified AutoConnectElement. If values \u200b\u200bis specified as a std::vector of String, the element that can set the values is the AutoConnectRadio or the AutoConnectSelect . Parameters name Specifies the name of the AutoConnectElements that you want to set the value. value Specifies the value to be set. values Specifies a reference of a std::vector of String. It contains the values of the AutoConnectRadio or the AutoConnectSelect. Return value true The value has been set. false AutoConnectElements with the specified name are not registered. Or the type of the value is not consistent with the specified AutoConnectElements. You can directly access the value member variable. If you are gripping with the sketch to the AutoConnectElements of the target that sets the value, you can access the value member variable directly. The following sketch code has the same effect. AutoConnectAux aux; // ... Griping the AutoConnectText here. aux.setElementValue( \"TEXT_FIELD\" , \"New value\" ); AutoConnectAux aux; // ... Griping the AutoConnectText here. AutoConnectText & text = aux.getElement < AutoConnectText > ( \"TEXT_FIELD\" ); text.value = \"New value\" ; The difference between the setElementValue and the value access with the getElement is the certainty of the registration state for the element. The getElement returns an empty object if the element is not registered then a sketch assigns the value to it. May occur unexpected results and crashes. You should use the setElementValue if its registration is unsettled.","title":" setElementValue"},{"location":"apiaux.html#settitle","text":"void setTitle( const String & title) Set the title string of the custom Web page. This title will be displayed as the menu title of the custom Web page. Parameter title Title string to be display. Not the menu title The setTitle function is not set for the AutoConnect menu title. The effect of this function is that custom Web page only. To change the AutoConnect menu title use AutoConnectConfig::title .","title":" setTitle"},{"location":"apiconfig.html","text":"Constructor \u00b6 AutoConnectConfig \u00b6 AutoConnectConfig() AutoConnectConfig( const char * ap, const char * password) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout, const uint8_t channel) Parameters ap SSID for SoftAP. The length should be up to 31. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The length should be from 8 to up to 63. The default value is 12345678 . timeout The timeout value of the captive portal in [ms] units. The default value is 0. channel The channel number of WIFi when SoftAP starts. The default values is 1. Public member variables \u00b6 apid \u00b6 SoftAP's SSID. Type String The default value is esp8266ap for ESP8266, esp32ap for ESP32. apip \u00b6 Sets IP address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 172.217.28.1 autoReconnect \u00b6 Automatically will try to reconnect with the past established access point (BSSID) when the current configured SSID in ESP8266/ESP32 could not be connected. By enabling this option, AutoConnect::begin() function will attempt to reconnect to a known access point using credentials stored in the flash, even if the connection failed by current SSID. If the connection fails, starts the captive portal in SoftAP+STA mode. Type bool Value true Reconnect automatically. false Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default. When the autoReconnect option is enabled, an automatic connection will behave if the following conditions are satisfied. Invokes AutoConnect::begin without user name and password parameter as begin() . If one of the saved BSSIDs (not the SSID) of the credentials matches the BSSID detected by the network scan. autoReset \u00b6 Reset ESP8266 module automatically after WLAN disconnected. Type bool Value true Reset after WiFi disconnected automatically. false No reset. autoRise \u00b6 Captive portal activation switch. False for disabling the captive portal. It prevents starting the captive portal even if the connection at the first WiFi.begin fails. Type bool Value true Enable the captive portal. This is the default. false Disable the captive portal. autoSave \u00b6 The credential saved automatically at the connection establishment. Type AC_SAVECREDENTIAL_t Value AC_SAVECREDENTIAL_AUTO The credential saved automatically. This is the default. AC_SAVECREDENTIAL_NEVER The credential no saved. bootUri \u00b6 Specify the location to be redirected after module reset in the AutoConnect menu. It is given as an enumeration value of AC_ONBOOTURI_t indicating either the AutoConnect root path or the user screen home path. Type AC_ONBOOTURI_t Value AC_ONBOOTURI_ROOT Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h. AC_ONBOOTURI_HOME It is redirected to the URI specified by AutoConnectConfig::homeUri . boundaryOffset \u00b6 Sets the offset address of the credential storage area for EEPROM. This value must be between greater than 4 and less than flash sector size. (4096 by SDK) The default value is 0. This option is valid only for ESP8266 or ESP32 arduino core 1.0.2 earlier. Type uint16_t It will conflict with user data. If the sketch leaves this offset at zero, it will conflict the storage area of credentials with the user sketch owned data. It needs to use the behind of credential area. channel \u00b6 The channel number of WIFi when SoftAP starts. Type uint8_t Value 1 ~ 14. The default value is 1. How do I choose Channel Espressif Systems had announced the application note about Wi-Fi channel selection. dns1 \u00b6 Set primary DNS server address when using static IP address. Type IPAddress dns2 \u00b6 Set secondary DNS server address when using static IP address. Type IPAddress gateway \u00b6 Sets gateway address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 172.217.28.1 hidden \u00b6 Sets SoftAP to hidden SSID. Type uint8_t Value 0 SSID will be appeared. This is the default. 1 SSID will be hidden. homeUri \u00b6 Sets the home path of user sketch. This path would be linked from 'HOME' in the AutoConnect menu. The default for homeUri is \"/\". Type String hostName \u00b6 Sets the station host name of ESP8266/ESP32. Type String immediateStart \u00b6 Disable the first WiFi.begin() and start the captive portal. If this option is enabled, the module will be in AP_STA mode and the captive portal will be activated regardless of AutoConnectConfig::autoRise specification. Type bool Value true Start the captive portal with AutoConnect::begin . false Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default. netmask \u00b6 Sets subnet mask for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 255.255.255.0 portalTimeout \u00b6 Specify the timeout value of the captive portal in [ms] units. It is valid when the station is not connected and does not time out if the station is connected to the ESP module in SoftAP mode (i.e. Attempting WiFi connection with the portal function). If 0, the captive portal will not be timed-out. Type unsigned long Captive portal timeout value. The default value is 0. psk \u00b6 Sets password for SoftAP. The length should be from 8 to up to 63. The default value is 12345678 . Type String retainPortal \u00b6 Specify whether to continue the portal function even if the captive portal timed out. If the true, when a timeout occurs, the AutoConnect::begin function is exited with returns false, but the portal facility remains alive. So SoftAP remains alive and you can invoke AutoConnect while continuing sketch execution. The default is false. Type bool Value true Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP. false When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default. Connection request after timed-out With the retainPortal , even if AutoConnect::begin in the setup() is timed out, you can execute the sketch and the portal function as a WiFi connection attempt by calling AutoConnect::handleClient in the loop(). All unresolved addresses redirects to /_ac If you enable the retainPortal option, all unresolved URIs will be redirected to SoftAPIP/_ac . It happens frequently as client devices repeat captive portal probes in particular. To avoid this, you need to exit from the WiFi connection Apps on your device once. staip \u00b6 Set a static IP address. The IP will behave with STA mode. Type IPAddress staGateway \u00b6 Set the gateway address when using static IP address. Type IPAddress staNetmask \u00b6 Set the subnetmask when using static IP address. Type IPAddress ticker \u00b6 Set flicker signal output according to WiFi connection status during AutoConnect::begin behavior. Type bool Value true Output the flicker signal while AutoConnect::begin operation. The AUTOCONNECT_TICKER_PORT macro in the AutoConnectDefs.h header file assigns pins for signal output. The default pin is arduino valiant's LED_BUILTIN. For boards without the LED_BUILTIN pin, assume pin #2. false No flicker signal output. tickerPort \u00b6 Specifies the GPIO port number to output the flicker signal of the ticker. The default assumes on the board dependent definition LED_BUILTIN macro redefined by AUTOCONNECT_TICKER_PORT in AutoConnectDefs.h . Type uint8_t tickerOn \u00b6 Specifies the active logic level of the flicker signal. This value indicates the active signal level when driving the ticker. Type uint8_t Value LOW A flicker signal is an active-high. HIGH A flicker signal is an active-low. title \u00b6 Set the menu title. Type String AutoConnectConfig example \u00b6 AutoConnect Portal; AutoConnectConfig Config ( \"\" , \"passpass\" ); // SoftAp name is determined at runtime Config.apid = ESP.hostname(); // Retrieve host name to SotAp identification Config.apip = IPAddress( 192 , 168 , 10 , 101 ); // Sets SoftAP IP address Config.gateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WLAN router IP address Config.netmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.autoReconnect = true; // Enable auto-reconnect Config.autoSave = AC_SAVECREDENTIAL_NEVER; // No save credential Config.boundaryOffet = 64 ; // Reserve 64 bytes for the user data in EEPROM. Config.portalTimeout = 60000 ; // Sets timeout value for the captive portal Config.retainPortal = true; // Retains the portal function after timed-out Config.homeUri = \"/index.html\" ; // Sets home path of the sketch application Config.title = \"My menu\" ; // Customize the menu title Config.staip = IPAddress( 192 , 168 , 10 , 10 ); // Sets static IP Config.staGateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WiFi router address Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.dns1 = IPAddress( 192 , 168 , 10 , 1 ); // Sets primary DNS address Portal.config(Config); // Configure AutoConnect Portal.begin(); // Starts and behaves captive portal","title":"AutoConnectConfig API"},{"location":"apiconfig.html#constructor","text":"","title":" Constructor"},{"location":"apiconfig.html#autoconnectconfig","text":"AutoConnectConfig() AutoConnectConfig( const char * ap, const char * password) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout) AutoConnectConfig( const char * ap, const char * password, const unsigned long timeout, const uint8_t channel) Parameters ap SSID for SoftAP. The length should be up to 31. The default value is esp8266ap for ESP8266, esp32ap for ESP32. password Password for SodtAP. The length should be from 8 to up to 63. The default value is 12345678 . timeout The timeout value of the captive portal in [ms] units. The default value is 0. channel The channel number of WIFi when SoftAP starts. The default values is 1.","title":"AutoConnectConfig"},{"location":"apiconfig.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apiconfig.html#apid","text":"SoftAP's SSID. Type String The default value is esp8266ap for ESP8266, esp32ap for ESP32.","title":" apid"},{"location":"apiconfig.html#apip","text":"Sets IP address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 172.217.28.1","title":" apip"},{"location":"apiconfig.html#autoreconnect","text":"Automatically will try to reconnect with the past established access point (BSSID) when the current configured SSID in ESP8266/ESP32 could not be connected. By enabling this option, AutoConnect::begin() function will attempt to reconnect to a known access point using credentials stored in the flash, even if the connection failed by current SSID. If the connection fails, starts the captive portal in SoftAP+STA mode. Type bool Value true Reconnect automatically. false Starts Captive Portal in SoftAP + STA mode without trying to reconnect. This is the default. When the autoReconnect option is enabled, an automatic connection will behave if the following conditions are satisfied. Invokes AutoConnect::begin without user name and password parameter as begin() . If one of the saved BSSIDs (not the SSID) of the credentials matches the BSSID detected by the network scan.","title":" autoReconnect"},{"location":"apiconfig.html#autoreset","text":"Reset ESP8266 module automatically after WLAN disconnected. Type bool Value true Reset after WiFi disconnected automatically. false No reset.","title":" autoReset"},{"location":"apiconfig.html#autorise","text":"Captive portal activation switch. False for disabling the captive portal. It prevents starting the captive portal even if the connection at the first WiFi.begin fails. Type bool Value true Enable the captive portal. This is the default. false Disable the captive portal.","title":" autoRise"},{"location":"apiconfig.html#autosave","text":"The credential saved automatically at the connection establishment. Type AC_SAVECREDENTIAL_t Value AC_SAVECREDENTIAL_AUTO The credential saved automatically. This is the default. AC_SAVECREDENTIAL_NEVER The credential no saved.","title":" autoSave"},{"location":"apiconfig.html#booturi","text":"Specify the location to be redirected after module reset in the AutoConnect menu. It is given as an enumeration value of AC_ONBOOTURI_t indicating either the AutoConnect root path or the user screen home path. Type AC_ONBOOTURI_t Value AC_ONBOOTURI_ROOT Resetting the module redirects it to the AutoConnect root path. The root path is assumed to be AUTOCONNECT_URI defined in AutoConnectDefs.h. AC_ONBOOTURI_HOME It is redirected to the URI specified by AutoConnectConfig::homeUri .","title":" bootUri"},{"location":"apiconfig.html#boundaryoffset","text":"Sets the offset address of the credential storage area for EEPROM. This value must be between greater than 4 and less than flash sector size. (4096 by SDK) The default value is 0. This option is valid only for ESP8266 or ESP32 arduino core 1.0.2 earlier. Type uint16_t It will conflict with user data. If the sketch leaves this offset at zero, it will conflict the storage area of credentials with the user sketch owned data. It needs to use the behind of credential area.","title":" boundaryOffset"},{"location":"apiconfig.html#channel","text":"The channel number of WIFi when SoftAP starts. Type uint8_t Value 1 ~ 14. The default value is 1. How do I choose Channel Espressif Systems had announced the application note about Wi-Fi channel selection.","title":" channel"},{"location":"apiconfig.html#dns1","text":"Set primary DNS server address when using static IP address. Type IPAddress","title":" dns1"},{"location":"apiconfig.html#dns2","text":"Set secondary DNS server address when using static IP address. Type IPAddress","title":" dns2"},{"location":"apiconfig.html#gateway","text":"Sets gateway address for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 172.217.28.1","title":" gateway"},{"location":"apiconfig.html#hidden","text":"Sets SoftAP to hidden SSID. Type uint8_t Value 0 SSID will be appeared. This is the default. 1 SSID will be hidden.","title":" hidden"},{"location":"apiconfig.html#homeuri","text":"Sets the home path of user sketch. This path would be linked from 'HOME' in the AutoConnect menu. The default for homeUri is \"/\". Type String","title":" homeUri"},{"location":"apiconfig.html#hostname","text":"Sets the station host name of ESP8266/ESP32. Type String","title":" hostName"},{"location":"apiconfig.html#immediatestart","text":"Disable the first WiFi.begin() and start the captive portal. If this option is enabled, the module will be in AP_STA mode and the captive portal will be activated regardless of AutoConnectConfig::autoRise specification. Type bool Value true Start the captive portal with AutoConnect::begin . false Enable the first WiFi.begin() and it will start captive portal when connection failed. This is default.","title":" immediateStart"},{"location":"apiconfig.html#netmask","text":"Sets subnet mask for Soft AP in captive portal. When AutoConnect fails the initial WiFi.begin, it starts the captive portal with the IP address specified this. Type IPAddress The default value is 255.255.255.0","title":" netmask"},{"location":"apiconfig.html#portaltimeout","text":"Specify the timeout value of the captive portal in [ms] units. It is valid when the station is not connected and does not time out if the station is connected to the ESP module in SoftAP mode (i.e. Attempting WiFi connection with the portal function). If 0, the captive portal will not be timed-out. Type unsigned long Captive portal timeout value. The default value is 0.","title":" portalTimeout"},{"location":"apiconfig.html#psk","text":"Sets password for SoftAP. The length should be from 8 to up to 63. The default value is 12345678 . Type String","title":" psk"},{"location":"apiconfig.html#retainportal","text":"Specify whether to continue the portal function even if the captive portal timed out. If the true, when a timeout occurs, the AutoConnect::begin function is exited with returns false, but the portal facility remains alive. So SoftAP remains alive and you can invoke AutoConnect while continuing sketch execution. The default is false. Type bool Value true Continue the portal function even if the captive portal times out. The STA + SoftAP mode of the ESP module continues and accepts the connection request to the AP. false When the captive portal times out, STA + SoftAP mode of the ESP module is stopped. This is default. Connection request after timed-out With the retainPortal , even if AutoConnect::begin in the setup() is timed out, you can execute the sketch and the portal function as a WiFi connection attempt by calling AutoConnect::handleClient in the loop(). All unresolved addresses redirects to /_ac If you enable the retainPortal option, all unresolved URIs will be redirected to SoftAPIP/_ac . It happens frequently as client devices repeat captive portal probes in particular. To avoid this, you need to exit from the WiFi connection Apps on your device once.","title":" retainPortal"},{"location":"apiconfig.html#staip","text":"Set a static IP address. The IP will behave with STA mode. Type IPAddress","title":" staip"},{"location":"apiconfig.html#stagateway","text":"Set the gateway address when using static IP address. Type IPAddress","title":" staGateway"},{"location":"apiconfig.html#stanetmask","text":"Set the subnetmask when using static IP address. Type IPAddress","title":" staNetmask"},{"location":"apiconfig.html#ticker","text":"Set flicker signal output according to WiFi connection status during AutoConnect::begin behavior. Type bool Value true Output the flicker signal while AutoConnect::begin operation. The AUTOCONNECT_TICKER_PORT macro in the AutoConnectDefs.h header file assigns pins for signal output. The default pin is arduino valiant's LED_BUILTIN. For boards without the LED_BUILTIN pin, assume pin #2. false No flicker signal output.","title":" ticker"},{"location":"apiconfig.html#tickerport","text":"Specifies the GPIO port number to output the flicker signal of the ticker. The default assumes on the board dependent definition LED_BUILTIN macro redefined by AUTOCONNECT_TICKER_PORT in AutoConnectDefs.h . Type uint8_t","title":" tickerPort"},{"location":"apiconfig.html#tickeron","text":"Specifies the active logic level of the flicker signal. This value indicates the active signal level when driving the ticker. Type uint8_t Value LOW A flicker signal is an active-high. HIGH A flicker signal is an active-low.","title":" tickerOn"},{"location":"apiconfig.html#title","text":"Set the menu title. Type String","title":" title"},{"location":"apiconfig.html#autoconnectconfig-example","text":"AutoConnect Portal; AutoConnectConfig Config ( \"\" , \"passpass\" ); // SoftAp name is determined at runtime Config.apid = ESP.hostname(); // Retrieve host name to SotAp identification Config.apip = IPAddress( 192 , 168 , 10 , 101 ); // Sets SoftAP IP address Config.gateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WLAN router IP address Config.netmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.autoReconnect = true; // Enable auto-reconnect Config.autoSave = AC_SAVECREDENTIAL_NEVER; // No save credential Config.boundaryOffet = 64 ; // Reserve 64 bytes for the user data in EEPROM. Config.portalTimeout = 60000 ; // Sets timeout value for the captive portal Config.retainPortal = true; // Retains the portal function after timed-out Config.homeUri = \"/index.html\" ; // Sets home path of the sketch application Config.title = \"My menu\" ; // Customize the menu title Config.staip = IPAddress( 192 , 168 , 10 , 10 ); // Sets static IP Config.staGateway = IPAddress( 192 , 168 , 10 , 1 ); // Sets WiFi router address Config.staNetmask = IPAddress( 255 , 255 , 255 , 0 ); // Sets WLAN scope Config.dns1 = IPAddress( 192 , 168 , 10 , 1 ); // Sets primary DNS address Portal.config(Config); // Configure AutoConnect Portal.begin(); // Starts and behaves captive portal","title":" AutoConnectConfig example"},{"location":"apielements.html","text":"AutoConnectButton \u00b6 Constructor \u00b6 AutoConnectButton( const char * name = \"\" , const char * value = \"\" , const String & action = String(), const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value Value of the element. action Native code of the action script executed when the button is clicked. post Specifies the tag to be output afterward the element. Public member variables \u00b6 action \u00b6 HTML native code of the action script to be executed when the button is clicked. It is mostly used with a JavaScript to activate a script. 1 Type String enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. value \u00b6 Value of the element. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Button AutoConnectCheckbox \u00b6 Constructor \u00b6 AutoConnectCheckbox( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const bool checked = false, const ACPosition_t labelPosition = AC_Behind, const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value Value of the element. label A label string prefixed to the checkbox. check Checked state of the checkbox. labelPosition Specifies the position of the label to generate. post Specifies the tag to be output afterward the element. Public member variables \u00b6 checked \u00b6 It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit. Type bool enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. label \u00b6 A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML < label > tag with an id attribute. The checkbox and the label are connected by the id attribute. Type String labelPosition \u00b6 Specifies the position of the label to generate with ACPostion_t enumeration value. Type ACPosition_t AC_Infront : Place a label in front of the check box. AC_Behind : Place a label behind the check box. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. value \u00b6 Value of the element. It becomes a value attribute of an HTML < input type = \"checkbox\" > tag. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Checkbox AutoConnectElement \u00b6 Constructor \u00b6 AutoConnectElement( const char * name = \"\" , const char * value = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value Value of the element. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. value \u00b6 Value of the element. It is output as HTML as it is as a source for generating HTML code. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Element as<T> \u00b6 AutoConnectElement & as < T > ( void ) Casts the reference to the AutoConnectElement the specified type. Parameter T The element type. AutoConnectElements type such as AutoConnectButton , AutoConnectCheckbox , AutoConnectFile , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectStyle , AutoConnectSubmit , AutoConnectText . Return value A reference to the AutoConnectElement with actual type. AutoConnectFile \u00b6 Constructor \u00b6 AutoConnectFile( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const ACFile_t store = AC_File_FS, const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value File name to be upload. label Label string. store The ACFile_t enumerator that represents the media to save the uploaded file. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. label \u00b6 A label is an optional string. A label is always arranged on the left side of the file input box. Specification of a label will generate an HTML < label > tag with an id attribute. The file input box and the label are connected by the id attribute. Type String mimeType \u00b6 The mime type of the upload file which included as Media type in the http post request. Set by the client (usually the browser) that requested the upload. It is determined by the file type as application/octet-stream , text etc. which is described in IANA Media Type . Type String name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. size \u00b6 Size of the uploading file. Type size_t store \u00b6 Specifies the save destination of the uploaded file. You can use the built-in uploader to save uploaded file to the flash of the ESP8266/ESP32 module or external SD media without writing a dedicated sketch code. It also supports saving to any destination using a custom uploader that inherits from the AutoConnectUploadHandler class. Type ACFile_t AC_File_FS : Save the uploaded file to SPIFFS in the flash. AC_File_SD : Save the uploaded file to SD. AC_File_Extern : Save the file using your own upload handler. value \u00b6 File name to be upload. The value contains the value entered by the client browser to the < input type = \"file\" > tag and is read-only. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectFile. Return value AC_File AutoConnectInput \u00b6 Constructor \u00b6 AutoConnectInput( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const char * pattern = \"\" , const char * placeholder = \"\" , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value Value of the element. label Label string. pattern Regular expression string for checking data format. placeholder A placeholder string. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. label \u00b6 A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. Type String name \u00b6 The element name. Type String pattern \u00b6 A pattern specifies a regular expression that the input-box's value is checked against on form submission. Type String placeholder \u00b6 A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. value \u00b6 Value of the element. It becomes a value attribute of an HTML < input type = \"text\" > tag. An entered text in the custom Web page will be sent with a query string of the form. The value set before accessing the page is displayed as the initial value. Type String Public member functions \u00b6 isValid \u00b6 bool isValid( void ) Evaluate the pattern as a regexp and return whether value matches. Always return true if the pattern is undefined. Return value true The value matches a pattern. false The value does not match a pattern. typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Input AutoConnectRadio \u00b6 Constructor \u00b6 AutoConnectRadio( const char * name = \"\" , std :: vector < String > const & values = {}, const char * label = \"\" , const ACArrange_t order = AC_Vertical, const uint8_t checked = 0 , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. values An array of values of the radio buttons. Specifies a std::vector object. label Label string. order The direction to arrange the radio buttons. checked An index to be checked in the radio buttons. post Specifies the tag to be output afterward the element. Public member variables \u00b6 checked \u00b6 Specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. Type uint8_t enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. label \u00b6 A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Type String name \u00b6 The element name. Type String order \u00b6 Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the order . It is a value of ACArrange_t type and accepts one of the following: Type ACArrange_t AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement. post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. values \u00b6 An array of String type for the radio button options. It is an initialization list can be used. The < input type = \"radio\" > tags will be generated from each entry in the values. Type std::vector<String> Public member functions \u00b6 add \u00b6 void add( const String & value) Adds an option for the radio button. Parameter value An option string to add to the radio button. check \u00b6 void check( const String & value) Indicates the check of the specified option for the radio buttons. You can use the check function for checking dynamically with arbitrary of the radio button. Parameter value An option string to be checked. empty \u00b6 void empty( const size_t reserve = 0 ) Clear the array of option strings that AutoConnectRadio has in the values. When the reserve parameter is specified, a vector container of that size is reserved. The empty function resets the checked value to zero. When the empty function is executed, any button will be turned off. Parameter reserve Reserved size of a container for the radio button option strings. operator [ ] \u00b6 const String & operator [] ( const std :: size_t n) Returns a value string of the index specified by n . Parameter n Index of values array to return. Its base number is 0. Return value A reference of a value string indexed by the specified the n . size \u00b6 size_t size( void ) Returns number of options which contained. Return value Number of options which contained. typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Radio value \u00b6 const String & value( void ) const Returns current checked option of the radio buttons. Return value A String of an option current checked. If there is no checked option, a null string returned. AutoConnectSelect \u00b6 Constructor \u00b6 AutoConnectSelect( const char * name = \"\" , std :: vector < String > const & options = {}, const char * label = \"\" , const uint8_t selected = 0 , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. options An array of options of the select element. Specifies a std::vector object. label Label string. selected An option should be pre-selected when the page loads. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String label \u00b6 A label is an optional string. A label will be arranged in the top of the selection list. Type String options \u00b6 An array of String type for the selection options. It is an initialization list can be used. The < option value > tags will be generated from each entry in the options. Type std::vector<String> post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. selected \u00b6 A selected is an optional value. Specifies 1-based index value of an options array that an option should be pre-selected when the page loads. Type uint8_t Public member functions \u00b6 add \u00b6 void add( const String & option) Adds a selectable option string for the selection list. Parameter option A string of selectable item to be contained in the select element. empty \u00b6 void empty( const size_t reserve = 0 ) Clear the array of options list that AutoConnectSelect has in the options. When the reserve parameter is specified, a vector container of that size is reserved. The empty function resets the selected value to zero. When the empty function is executed, there are no selected options and the first item is placed at the beginning. Parameter reserve Reserved size of a container for the options. operator [ ] \u00b6 const String & operator [] ( const std :: size_t n) Returns an option string of the index specified by n . Parameter n Index of options array to return. Its base number is 0. Return value A reference of a option string indexed by the specified the n . select \u00b6 void select ( const String & value); Selects an option with the value. Parameter value String value that option should be selected in an option array. size \u00b6 size_t size( void ) Returns number of options which contained. Return value Number of options which contained. typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Select value \u00b6 const String & value( void ) const ; Returns current selected option of the select list. Return value A String of an option current selected. If there is no select option, a null string returned. AutoConnectStyle \u00b6 Constructor \u00b6 AutoConnectStyle( const char * name = \"\" , const char * value = \"\" ) Parameters name The element name. value Raw CSS code to insert into a style block in a custom web page to generate. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. name \u00b6 The element name. Type String value \u00b6 Raw CSS code to insert into a style block in a custom web page to generate. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Style AutoConnectSubmit \u00b6 Constructor \u00b6 AutoConnectSubmit( const char * name = \"\" , const char * value = \"\" , char * uri = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value The name of the submit button as an HTML < input type = \"button\" > tag, it will also be the label of the button. uri Destination URI. post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. uri \u00b6 Destination URI. Type String value \u00b6 The name of the submit button. It will also be the label of the button. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Submit AutoConnectText \u00b6 Constructor \u00b6 AutoConnectText( const char * name = \"\" , const char * value = \"\" , const char * style = \"\" , const char * format = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value String of content for the text element. style A style code with CSS format that qualifiers the text. format A pointer to a null-terminated multibyte string specifying how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to C-style printf library functions post Specifies the tag to be output afterward the element. Public member variables \u00b6 enable \u00b6 Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true. format \u00b6 The conversion format when outputting values. The format string conforms to C-style printf library functions. Type String global \u00b6 The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute. name \u00b6 The element name. Type String post \u00b6 Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag. style \u00b6 A style code with CSS format that qualifiers the text. Type String value \u00b6 A content string of the text element. Type String Public member functions \u00b6 typeOf \u00b6 ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Text JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9","title":"AutoConnectElements API"},{"location":"apielements.html#autoconnectbutton","text":"","title":"AutoConnectButton"},{"location":"apielements.html#constructor","text":"AutoConnectButton( const char * name = \"\" , const char * value = \"\" , const String & action = String(), const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value Value of the element. action Native code of the action script executed when the button is clicked. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apielements.html#action","text":"HTML native code of the action script to be executed when the button is clicked. It is mostly used with a JavaScript to activate a script. 1 Type String","title":" action"},{"location":"apielements.html#enable","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#value","text":"Value of the element. Type String","title":" value"},{"location":"apielements.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apielements.html#typeof","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Button","title":" typeOf"},{"location":"apielements.html#autoconnectcheckbox","text":"","title":"AutoConnectCheckbox"},{"location":"apielements.html#constructor_1","text":"AutoConnectCheckbox( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const bool checked = false, const ACPosition_t labelPosition = AC_Behind, const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value Value of the element. label A label string prefixed to the checkbox. check Checked state of the checkbox. labelPosition Specifies the position of the label to generate. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_1","text":"","title":" Public member variables"},{"location":"apielements.html#checked","text":"It indicates the checked status of the checkbox. The value of the checked checkbox element is packed in the query string and sent by submit. Type bool","title":" checked"},{"location":"apielements.html#enable_1","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_1","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#label","text":"A label is an optional string. A label is always arranged on the right side of the checkbox. Specification of a label will generate an HTML < label > tag with an id attribute. The checkbox and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#labelposition","text":"Specifies the position of the label to generate with ACPostion_t enumeration value. Type ACPosition_t AC_Infront : Place a label in front of the check box. AC_Behind : Place a label behind the check box.","title":" labelPosition"},{"location":"apielements.html#name_1","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_1","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#value_1","text":"Value of the element. It becomes a value attribute of an HTML < input type = \"checkbox\" > tag. Type String","title":" value"},{"location":"apielements.html#public-member-functions_1","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_1","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Checkbox","title":" typeOf"},{"location":"apielements.html#autoconnectelement","text":"","title":"AutoConnectElement"},{"location":"apielements.html#constructor_2","text":"AutoConnectElement( const char * name = \"\" , const char * value = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value Value of the element. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_2","text":"","title":" Public member variables"},{"location":"apielements.html#enable_2","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_2","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name_2","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_2","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#value_2","text":"Value of the element. It is output as HTML as it is as a source for generating HTML code. Type String","title":" value"},{"location":"apielements.html#public-member-functions_2","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_2","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Element","title":" typeOf"},{"location":"apielements.html#ast62","text":"AutoConnectElement & as < T > ( void ) Casts the reference to the AutoConnectElement the specified type. Parameter T The element type. AutoConnectElements type such as AutoConnectButton , AutoConnectCheckbox , AutoConnectFile , AutoConnectInput , AutoConnectRadio , AutoConnectSelect , AutoConnectStyle , AutoConnectSubmit , AutoConnectText . Return value A reference to the AutoConnectElement with actual type.","title":" as&lt;T>"},{"location":"apielements.html#autoconnectfile","text":"","title":"AutoConnectFile"},{"location":"apielements.html#constructor_3","text":"AutoConnectFile( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const ACFile_t store = AC_File_FS, const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value File name to be upload. label Label string. store The ACFile_t enumerator that represents the media to save the uploaded file. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_3","text":"","title":" Public member variables"},{"location":"apielements.html#enable_3","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_3","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#label_1","text":"A label is an optional string. A label is always arranged on the left side of the file input box. Specification of a label will generate an HTML < label > tag with an id attribute. The file input box and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#mimetype","text":"The mime type of the upload file which included as Media type in the http post request. Set by the client (usually the browser) that requested the upload. It is determined by the file type as application/octet-stream , text etc. which is described in IANA Media Type . Type String","title":" mimeType"},{"location":"apielements.html#name_3","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_3","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#size","text":"Size of the uploading file. Type size_t","title":" size"},{"location":"apielements.html#store","text":"Specifies the save destination of the uploaded file. You can use the built-in uploader to save uploaded file to the flash of the ESP8266/ESP32 module or external SD media without writing a dedicated sketch code. It also supports saving to any destination using a custom uploader that inherits from the AutoConnectUploadHandler class. Type ACFile_t AC_File_FS : Save the uploaded file to SPIFFS in the flash. AC_File_SD : Save the uploaded file to SD. AC_File_Extern : Save the file using your own upload handler.","title":" store"},{"location":"apielements.html#value_3","text":"File name to be upload. The value contains the value entered by the client browser to the < input type = \"file\" > tag and is read-only. Type String","title":" value"},{"location":"apielements.html#public-member-functions_3","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_3","text":"ACElement_t typeOf( void ) Returns type of AutoConnectFile. Return value AC_File","title":" typeOf"},{"location":"apielements.html#autoconnectinput","text":"","title":"AutoConnectInput"},{"location":"apielements.html#constructor_4","text":"AutoConnectInput( const char * name = \"\" , const char * value = \"\" , const char * label = \"\" , const char * pattern = \"\" , const char * placeholder = \"\" , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. value Value of the element. label Label string. pattern Regular expression string for checking data format. placeholder A placeholder string. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_4","text":"","title":" Public member variables"},{"location":"apielements.html#enable_4","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_4","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#label_2","text":"A label is an optional string. A label is always arranged on the left side of the input box. Specification of a label will generate an HTML < label > tag with an id attribute. The input box and the label are connected by the id attribute. Type String","title":" label"},{"location":"apielements.html#name_4","text":"The element name. Type String","title":" name"},{"location":"apielements.html#pattern","text":"A pattern specifies a regular expression that the input-box's value is checked against on form submission. Type String","title":" pattern"},{"location":"apielements.html#placeholder","text":"A placeholder is an option string. Specification of a placeholder will generate a placeholder attribute for the input tag. Type String","title":" placeholder"},{"location":"apielements.html#post_4","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#value_4","text":"Value of the element. It becomes a value attribute of an HTML < input type = \"text\" > tag. An entered text in the custom Web page will be sent with a query string of the form. The value set before accessing the page is displayed as the initial value. Type String","title":" value"},{"location":"apielements.html#public-member-functions_4","text":"","title":" Public member functions"},{"location":"apielements.html#isvalid","text":"bool isValid( void ) Evaluate the pattern as a regexp and return whether value matches. Always return true if the pattern is undefined. Return value true The value matches a pattern. false The value does not match a pattern.","title":" isValid"},{"location":"apielements.html#typeof_4","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Input","title":" typeOf"},{"location":"apielements.html#autoconnectradio","text":"","title":"AutoConnectRadio"},{"location":"apielements.html#constructor_5","text":"AutoConnectRadio( const char * name = \"\" , std :: vector < String > const & values = {}, const char * label = \"\" , const ACArrange_t order = AC_Vertical, const uint8_t checked = 0 , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. values An array of values of the radio buttons. Specifies a std::vector object. label Label string. order The direction to arrange the radio buttons. checked An index to be checked in the radio buttons. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_5","text":"","title":" Public member variables"},{"location":"apielements.html#checked_1","text":"Specifies the index number (1-based) of the values to be checked. If this parameter is not specified neither item is checked. Type uint8_t","title":" checked"},{"location":"apielements.html#enable_5","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_5","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#label_3","text":"A label is an optional string. A label will be arranged in the left or top of the radio buttons according to the order . Type String","title":" label"},{"location":"apielements.html#name_5","text":"The element name. Type String","title":" name"},{"location":"apielements.html#order","text":"Specifies the direction to arrange the radio buttons. A label will place in the left or the top according to the order . It is a value of ACArrange_t type and accepts one of the following: Type ACArrange_t AC_Horizontal : Horizontal arrangement. AC_Vertical : Vertical arrangement.","title":" order"},{"location":"apielements.html#post_5","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#values","text":"An array of String type for the radio button options. It is an initialization list can be used. The < input type = \"radio\" > tags will be generated from each entry in the values. Type std::vector<String>","title":" values"},{"location":"apielements.html#public-member-functions_5","text":"","title":" Public member functions"},{"location":"apielements.html#add","text":"void add( const String & value) Adds an option for the radio button. Parameter value An option string to add to the radio button.","title":" add"},{"location":"apielements.html#check","text":"void check( const String & value) Indicates the check of the specified option for the radio buttons. You can use the check function for checking dynamically with arbitrary of the radio button. Parameter value An option string to be checked.","title":" check"},{"location":"apielements.html#empty","text":"void empty( const size_t reserve = 0 ) Clear the array of option strings that AutoConnectRadio has in the values. When the reserve parameter is specified, a vector container of that size is reserved. The empty function resets the checked value to zero. When the empty function is executed, any button will be turned off. Parameter reserve Reserved size of a container for the radio button option strings.","title":" empty"},{"location":"apielements.html#operator","text":"const String & operator [] ( const std :: size_t n) Returns a value string of the index specified by n . Parameter n Index of values array to return. Its base number is 0. Return value A reference of a value string indexed by the specified the n .","title":" operator &#91;&nbsp;&#93;"},{"location":"apielements.html#size_1","text":"size_t size( void ) Returns number of options which contained. Return value Number of options which contained.","title":" size"},{"location":"apielements.html#typeof_5","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Radio","title":" typeOf"},{"location":"apielements.html#value_5","text":"const String & value( void ) const Returns current checked option of the radio buttons. Return value A String of an option current checked. If there is no checked option, a null string returned.","title":" value"},{"location":"apielements.html#autoconnectselect","text":"","title":"AutoConnectSelect"},{"location":"apielements.html#constructor_6","text":"AutoConnectSelect( const char * name = \"\" , std :: vector < String > const & options = {}, const char * label = \"\" , const uint8_t selected = 0 , const ACPosterior_t post = AC_Tag_BR) Parameters name The element name. options An array of options of the select element. Specifies a std::vector object. label Label string. selected An option should be pre-selected when the page loads. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_6","text":"","title":" Public member variables"},{"location":"apielements.html#enable_6","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_6","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name_6","text":"The element name. Type String","title":" name"},{"location":"apielements.html#label_4","text":"A label is an optional string. A label will be arranged in the top of the selection list. Type String","title":" label"},{"location":"apielements.html#options","text":"An array of String type for the selection options. It is an initialization list can be used. The < option value > tags will be generated from each entry in the options. Type std::vector<String>","title":" options"},{"location":"apielements.html#post_6","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#selected","text":"A selected is an optional value. Specifies 1-based index value of an options array that an option should be pre-selected when the page loads. Type uint8_t","title":" selected"},{"location":"apielements.html#public-member-functions_6","text":"","title":" Public member functions"},{"location":"apielements.html#add_1","text":"void add( const String & option) Adds a selectable option string for the selection list. Parameter option A string of selectable item to be contained in the select element.","title":" add"},{"location":"apielements.html#empty_1","text":"void empty( const size_t reserve = 0 ) Clear the array of options list that AutoConnectSelect has in the options. When the reserve parameter is specified, a vector container of that size is reserved. The empty function resets the selected value to zero. When the empty function is executed, there are no selected options and the first item is placed at the beginning. Parameter reserve Reserved size of a container for the options.","title":" empty"},{"location":"apielements.html#operator_1","text":"const String & operator [] ( const std :: size_t n) Returns an option string of the index specified by n . Parameter n Index of options array to return. Its base number is 0. Return value A reference of a option string indexed by the specified the n .","title":" operator &#91;&nbsp;&#93;"},{"location":"apielements.html#select","text":"void select ( const String & value); Selects an option with the value. Parameter value String value that option should be selected in an option array.","title":" select"},{"location":"apielements.html#size_2","text":"size_t size( void ) Returns number of options which contained. Return value Number of options which contained.","title":" size"},{"location":"apielements.html#typeof_6","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Select","title":" typeOf"},{"location":"apielements.html#value_6","text":"const String & value( void ) const ; Returns current selected option of the select list. Return value A String of an option current selected. If there is no select option, a null string returned.","title":" value"},{"location":"apielements.html#autoconnectstyle","text":"","title":"AutoConnectStyle"},{"location":"apielements.html#constructor_7","text":"AutoConnectStyle( const char * name = \"\" , const char * value = \"\" ) Parameters name The element name. value Raw CSS code to insert into a style block in a custom web page to generate.","title":" Constructor"},{"location":"apielements.html#public-member-variables_7","text":"","title":" Public member variables"},{"location":"apielements.html#enable_7","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#name_7","text":"The element name. Type String","title":" name"},{"location":"apielements.html#value_7","text":"Raw CSS code to insert into a style block in a custom web page to generate. Type String","title":" value"},{"location":"apielements.html#public-member-functions_7","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_7","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Style","title":" typeOf"},{"location":"apielements.html#autoconnectsubmit","text":"","title":"AutoConnectSubmit"},{"location":"apielements.html#constructor_8","text":"AutoConnectSubmit( const char * name = \"\" , const char * value = \"\" , char * uri = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value The name of the submit button as an HTML < input type = \"button\" > tag, it will also be the label of the button. uri Destination URI. post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_8","text":"","title":" Public member variables"},{"location":"apielements.html#enable_8","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#global_7","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name_8","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_7","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#uri","text":"Destination URI. Type String","title":" uri"},{"location":"apielements.html#value_8","text":"The name of the submit button. It will also be the label of the button. Type String","title":" value"},{"location":"apielements.html#public-member-functions_8","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_8","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Submit","title":" typeOf"},{"location":"apielements.html#autoconnecttext","text":"","title":"AutoConnectText"},{"location":"apielements.html#constructor_9","text":"AutoConnectText( const char * name = \"\" , const char * value = \"\" , const char * style = \"\" , const char * format = \"\" , const ACPosterior_t post = AC_Tag_None) Parameters name The element name. value String of content for the text element. style A style code with CSS format that qualifiers the text. format A pointer to a null-terminated multibyte string specifying how to interpret the value. It specifies the conversion format when outputting values. The format string conforms to C-style printf library functions post Specifies the tag to be output afterward the element.","title":" Constructor"},{"location":"apielements.html#public-member-variables_9","text":"","title":" Public member variables"},{"location":"apielements.html#enable_9","text":"Enable HTML tag generation for the element. Type bool AutoConnect will generate the element into HTML only if the enable attribute is true.","title":" enable"},{"location":"apielements.html#format","text":"The conversion format when outputting values. The format string conforms to C-style printf library functions. Type String","title":" format"},{"location":"apielements.html#global_8","text":"The global attribute copies input values \u200b\u200bbetween elements of the same name on different custom Web pages. Type bool An entered value will be copied to elements of the same name in other AutoConnectAuxes during page transition. However, it will be copied only when the destination element has the true for a global attribute.","title":" global"},{"location":"apielements.html#name_9","text":"The element name. Type String","title":" name"},{"location":"apielements.html#post_8","text":"Specifies a tag to add behind the HTML code generated from the element. Type ACPosterior_t AC_Tag_None : No generate additional tags. AC_Tag_BR : Add a <br> tag to the end of the element. AC_Tag_P : Include the element in the <p> ~ </p> tag.","title":" post"},{"location":"apielements.html#style","text":"A style code with CSS format that qualifiers the text. Type String","title":" style"},{"location":"apielements.html#value_9","text":"A content string of the text element. Type String","title":" value"},{"location":"apielements.html#public-member-functions_9","text":"","title":" Public member functions"},{"location":"apielements.html#typeof_9","text":"ACElement_t typeOf( void ) Returns type of AutoConnectElement. Return value AC_Text JavaScript can be inserted into a custom Web page using AutoConnectElement. \u21a9","title":" typeOf"},{"location":"apiextra.html","text":"Icons \u00b6 The library presents two PNG icons which can be used to embed a hyperlink to the AutoConnect menu. Bar type Cog type To reference the icon, use the AUTOCONNECT_LINK macro in the sketch. It expands into the string literal as an HTML <a></a> tag with PNG embedded of the AutoConnect menu hyperlinks. Icon type is specified by the parameter of the macro. BAR_24 Bars icon, 24x24. BAR_32 Bars icon, 32x32. BAR_48 Bars icon, 48x48. COG_16 Cog icon, 16x16. COG_24 Cog icon, 24x24. COG_32 Cog icon, 32x32. Usage String html = \"<html>\" ; html += AUTOCONNECT_LINK(BAR_32); html += \"</html>\" ; server.send( 200 , \"text/html\" , html);","title":"Something extra"},{"location":"apiextra.html#icons","text":"The library presents two PNG icons which can be used to embed a hyperlink to the AutoConnect menu. Bar type Cog type To reference the icon, use the AUTOCONNECT_LINK macro in the sketch. It expands into the string literal as an HTML <a></a> tag with PNG embedded of the AutoConnect menu hyperlinks. Icon type is specified by the parameter of the macro. BAR_24 Bars icon, 24x24. BAR_32 Bars icon, 32x32. BAR_48 Bars icon, 48x48. COG_16 Cog icon, 16x16. COG_24 Cog icon, 24x24. COG_32 Cog icon, 32x32. Usage String html = \"<html>\" ; html += AUTOCONNECT_LINK(BAR_32); html += \"</html>\" ; server.send( 200 , \"text/html\" , html);","title":" Icons"},{"location":"apiupdate.html","text":"Constructor \u00b6 AutoConnectUpdate \u00b6 AutoConnectUpdate( const String & host, const uint16_t port, const String & uri, const int timeout, const uint8_t ledOn) Parameters host Update server address. Specifies IP address or FQDN. port Specifies HTTP port for the updating process. The default is defined as the AUTOCONNECT_UPDATE_PORT macro in the AutoConnectDefs.h header file. uri Specifies a URI on the update server that has deployed available binary sketch files. timeout Specifies the maximum response time for the update server. The default is defined as the AUTOCONNECT_UPDATE_TIMEOUT macro in the AutoConnectDefs.h header file. ledOn Active signal to light the LED ticker during the update. Specifies HIGH or LOW The AutoConnectUpdate class inherits from the ESP8266HTTPUpdate ( HTTPUpdate for ESP32) class. Public member functions \u00b6 attach \u00b6 void AutoConnectUpdate :: attach(AutoConnect & portal) Attaches the AutoConnectUpdate to the AutoConnect which constitutes the bedrock of the update process. This function creates a dialog page for the update operation as an instance of AutoConnectAux and participates in the AutoConnect menu . Parameter portal Specifies a reference to the AutoConnect instance to attach. disable \u00b6 void AutoConnectUpdate :: disable( const bool activate) Disable the Update item in AutoConnect menu . The AutoConnect::disable function only hides the Update item from the menu, and the AutoConnectUpdate class is still active with the parameter condition. You can use the AutoConnectUpdate::enable function to appear it again in the menu. Parameter activate If specified the true then the Update item will be displayed on the AutoConnect menu and OTA update will be available during the WiFi status is WL_CONNECTED. For the false , the OTA update feature is disabled. enable \u00b6 void AutoConnectUpdate :: enable( void ) Makes AutoConnectUpdate class available by incorporating the OTA update function into the AutoConnect menu . In ordinarily, the AutoConnectUpdate class becomes available by just calling the AutoConnectUpdate::attach function. handleUpdate \u00b6 void AutoConnectUpdate :: handleUpdate( void ) Performs the update process. This function is called by AutoConnect::handleClient when AutoConnectUpdate is enabled. In many cases, sketches do not need to call this function on purpose. isEnabled \u00b6 bool AutoConnectUpdate :: isEnabled( void ) Returns whether AutoConnectUpdate is enabled. rebootOnUpdate \u00b6 void AutoConnectUpdate :: rebootOnUpdate( bool reboot) Specifies whether or not to automatically restart the module as a result of the successful completion of the update process. Parameter reboot If specified the true then the ESP module will reboot after the updating successfully completed. For the false , The module does not reboot automatically. The updated firmware remains stored in the flash update firmware area equipped on the ESP module. The boot process during the next start turn of the module by reset will copy the updated firmware to the actual program area and a new sketch program will start. The default value is the true. This function inherits from the ESP8266HTTPUpdate (HTTPUpdate for ESP32) class. setLedPin \u00b6 void AutoConnectUpdate :: setLedPin( int ledPin, uint8_t ledOn) Sets the port and the ON signal level of the externally connected LED that should act as a ticker during the update process. Parameter ledPin Specifies the PIN connected external LED for the ticker. The default is defined as the AUTOCONNECT_TICKER_PORT macro in the AutoConnectDefs.h header file and it is derived from the board-specific LED_BUILTIN . By default, the AutoConnectUpdate class does not use the ticker for boards without the LED_BUILTIN definition. If you connect the ticker LED externally, you need to specify the PIN using the setLedPin function. ledOn Specifies the the ON signal level of the LED PIN port. It is HIGH or LOW . This function inherits from the ESP8266HTTPUpdate (HTTPUpdate for ESP32) class. status \u00b6 AC_UPDATESTATUS_t AutoConnectUpdate :: status( void ) Returns the update process status transition indicator as an enumerated value of the AC_UPDATESTATUS_t type that indicates the process status of the AutoConnectUpdate class. Return value One of the enumerated values \u200b\u200bindicating the status of the Update class as follows: UPDATE_RESET : Update process ended, need to reset. UPDATE_IDLE : Update process has not started. UPDATE_START : Update process has been started. UPDATE_PROGRESS : Update process has been started. UPDATE_SUCCESS : Update successfully completed. UPDATE_NOAVAIL : No available update. UPDATE_FAIL : Update failed. Public member variables \u00b6 host \u00b6 Update server address. Specifies IP address or FQDN. Type String port \u00b6 HTTP port for the updating process. Type String The default is defined as the AUTOCONNECT_UPDATE_PORT macro in the AutoConnectDefs.h header file. uri \u00b6 URI on the update server that has deployed available binary sketch files. Type String","title":"AutoConnectUpdate API"},{"location":"apiupdate.html#constructor","text":"","title":" Constructor"},{"location":"apiupdate.html#autoconnectupdate","text":"AutoConnectUpdate( const String & host, const uint16_t port, const String & uri, const int timeout, const uint8_t ledOn) Parameters host Update server address. Specifies IP address or FQDN. port Specifies HTTP port for the updating process. The default is defined as the AUTOCONNECT_UPDATE_PORT macro in the AutoConnectDefs.h header file. uri Specifies a URI on the update server that has deployed available binary sketch files. timeout Specifies the maximum response time for the update server. The default is defined as the AUTOCONNECT_UPDATE_TIMEOUT macro in the AutoConnectDefs.h header file. ledOn Active signal to light the LED ticker during the update. Specifies HIGH or LOW The AutoConnectUpdate class inherits from the ESP8266HTTPUpdate ( HTTPUpdate for ESP32) class.","title":"AutoConnectUpdate"},{"location":"apiupdate.html#public-member-functions","text":"","title":" Public member functions"},{"location":"apiupdate.html#attach","text":"void AutoConnectUpdate :: attach(AutoConnect & portal) Attaches the AutoConnectUpdate to the AutoConnect which constitutes the bedrock of the update process. This function creates a dialog page for the update operation as an instance of AutoConnectAux and participates in the AutoConnect menu . Parameter portal Specifies a reference to the AutoConnect instance to attach.","title":" attach"},{"location":"apiupdate.html#disable","text":"void AutoConnectUpdate :: disable( const bool activate) Disable the Update item in AutoConnect menu . The AutoConnect::disable function only hides the Update item from the menu, and the AutoConnectUpdate class is still active with the parameter condition. You can use the AutoConnectUpdate::enable function to appear it again in the menu. Parameter activate If specified the true then the Update item will be displayed on the AutoConnect menu and OTA update will be available during the WiFi status is WL_CONNECTED. For the false , the OTA update feature is disabled.","title":" disable"},{"location":"apiupdate.html#enable","text":"void AutoConnectUpdate :: enable( void ) Makes AutoConnectUpdate class available by incorporating the OTA update function into the AutoConnect menu . In ordinarily, the AutoConnectUpdate class becomes available by just calling the AutoConnectUpdate::attach function.","title":" enable"},{"location":"apiupdate.html#handleupdate","text":"void AutoConnectUpdate :: handleUpdate( void ) Performs the update process. This function is called by AutoConnect::handleClient when AutoConnectUpdate is enabled. In many cases, sketches do not need to call this function on purpose.","title":" handleUpdate"},{"location":"apiupdate.html#isenabled","text":"bool AutoConnectUpdate :: isEnabled( void ) Returns whether AutoConnectUpdate is enabled.","title":" isEnabled"},{"location":"apiupdate.html#rebootonupdate","text":"void AutoConnectUpdate :: rebootOnUpdate( bool reboot) Specifies whether or not to automatically restart the module as a result of the successful completion of the update process. Parameter reboot If specified the true then the ESP module will reboot after the updating successfully completed. For the false , The module does not reboot automatically. The updated firmware remains stored in the flash update firmware area equipped on the ESP module. The boot process during the next start turn of the module by reset will copy the updated firmware to the actual program area and a new sketch program will start. The default value is the true. This function inherits from the ESP8266HTTPUpdate (HTTPUpdate for ESP32) class.","title":" rebootOnUpdate"},{"location":"apiupdate.html#setledpin","text":"void AutoConnectUpdate :: setLedPin( int ledPin, uint8_t ledOn) Sets the port and the ON signal level of the externally connected LED that should act as a ticker during the update process. Parameter ledPin Specifies the PIN connected external LED for the ticker. The default is defined as the AUTOCONNECT_TICKER_PORT macro in the AutoConnectDefs.h header file and it is derived from the board-specific LED_BUILTIN . By default, the AutoConnectUpdate class does not use the ticker for boards without the LED_BUILTIN definition. If you connect the ticker LED externally, you need to specify the PIN using the setLedPin function. ledOn Specifies the the ON signal level of the LED PIN port. It is HIGH or LOW . This function inherits from the ESP8266HTTPUpdate (HTTPUpdate for ESP32) class.","title":" setLedPin"},{"location":"apiupdate.html#status","text":"AC_UPDATESTATUS_t AutoConnectUpdate :: status( void ) Returns the update process status transition indicator as an enumerated value of the AC_UPDATESTATUS_t type that indicates the process status of the AutoConnectUpdate class. Return value One of the enumerated values \u200b\u200bindicating the status of the Update class as follows: UPDATE_RESET : Update process ended, need to reset. UPDATE_IDLE : Update process has not started. UPDATE_START : Update process has been started. UPDATE_PROGRESS : Update process has been started. UPDATE_SUCCESS : Update successfully completed. UPDATE_NOAVAIL : No available update. UPDATE_FAIL : Update failed.","title":" status"},{"location":"apiupdate.html#public-member-variables","text":"","title":" Public member variables"},{"location":"apiupdate.html#host","text":"Update server address. Specifies IP address or FQDN. Type String","title":" host"},{"location":"apiupdate.html#port","text":"HTTP port for the updating process. Type String The default is defined as the AUTOCONNECT_UPDATE_PORT macro in the AutoConnectDefs.h header file.","title":" port"},{"location":"apiupdate.html#uri","text":"URI on the update server that has deployed available binary sketch files. Type String","title":" uri"},{"location":"basicusage.html","text":"Simple usage \u00b6 Embed to the sketches \u00b6 How embed the AutoConnect to the sketches you have. Most simple approach to applying AutoConnect for the existing sketches, follow the below steps. The below sketch is for ESP8266. For ESP32, replace ESP8266WebServer with WebServer and ESP8266WiFi.h with WiFi.h respectively. Insert #include <AutoConnect.h> to behind of #include <ESP8266WebServer.h> . Insert AutoConnect PORTAL(WEBSERVER); to behind of ESP8266WebServer WEBSERVER; declaration. 1 Remove WiFi. begin ( SSID , PSK ) and the subsequent logic for the connection status check. Replace WEBSERVER . begin () to PORTAL . begin () . 2 Replace WEBSERVER . handleClient () to PORTAL . handleClient () . 3 If the connection checks logic is needed, you can check the return value according to PORTAL . begin () with true or false . Basic usage \u00b6 Basic logic sequence for the user sketches \u00b6 1. A typical logic sequence \u00b6 Include headers, ESP8266WebServer.h / WebServer.h and AutoConnect.h Declare an ESP8266WebServer variable for ESP8266 or a WebServer variable for ESP32. Declare an AutoConnect variable. Implement the URL handlers provided for the on method of ESP8266WebServer/WebServer with the function() . setup() 5.1 Sets URL handler the function() to ESP8266WebServer/WebServer by ESP8266WebServer::on / WebServer::on . 5.2 Starts AutoConnect::begin() . 5.3 Check WiFi connection status. loop() 6.1 Do the process for actual sketch. 6.2 Invokes AutoConnect::handleClient() , or invokes ESP8266WebServer::handleClient() / WebServer::handleClient then AutoConnect::handleRequest() . 2. Declare AutoConnect object \u00b6 Two options are available for AutoConnect constructor . AutoConnect VARIABLE ( & ESP8266WebServer); // For ESP8266 AutoConnect VARIABLE ( & WebServer); // For ESP32 or AutoConnect VARIABLE; The parameter with an ESP8266WebServer/WebServer variable: An ESP8266WebServer/WebServer object variable must be declared. AutoConnect uses its variable to handles the AutoConnect menu . With no parameter: The sketch does not declare ESP8266WebServer/WebServer object. In this case, AutoConnect allocates an instance of the ESP8266WebServer/WebServer internally. The logic sequence of the sketch is somewhat different as the above. To register a URL handler function by ESP8266WebServer::on or WebServer::on should be performed after AutoConnect::begin . 3. No need WiFI.begin(...) \u00b6 AutoConnect internally performs WiFi.begin to establish a WiFi connection. There is no need for a general process to establish a connection using WiFi.begin with a sketch code. 4. Alternate ESP8266WebServer::begin() and WebServer::begin() \u00b6 AutoConnect::begin executes ESP8266WebServer::begin / WebServer::begin internally too and it starts the DNS server to behave as a Captive portal. So it is not needed to call ESP8266WebServer::begin / WebServer::begin in the sketch. Why DNS Server starts AutoConnect traps the detection of the captive portal and achieves a connection with the WLAN interactively by the AutoConnect menu. It responds SoftAP address to all DNS queries temporarily to trap. Once a WiFi connection establishes, the DNS server contributed by AutoConnect stops. 5. AutoConnect::begin with SSID and Password \u00b6 SSID and Password can also specify by AutoConnect::begin . ESP8266/ESP32 uses provided SSID and Password explicitly. If the connection false with specified SSID with Password then a captive portal is activated. SSID and Password are not present, ESP8266 SDK will attempt to connect using the still effectual SSID and password. Usually, it succeeds. 6. Use ESP8266WebServer::on and WebServer::on to handle URL \u00b6 AutoConnect is designed to coexist with the process for handling the web pages by user sketches. The page processing function which will send an HTML to the client invoked by the \" on::ESP8266WebServer \" or the \" on::WebServer \" function is the same as when using ESP8266WebServer/WebServer natively. 7. Use either ESP8266WebServer::handleClient()/WebServer::handleClient() or AutoConnect::handleClient() \u00b6 Both classes member function name is the same: handleClient , but the behavior is different. Using the AutoConnect embedded along with ESP8266WebServer::handleClient/WebServer::handleClient has limitations. Refer to the below section for details. ESP8266WebServer/WebServer hosted or parasitic \u00b6 The interoperable process with an ESP8266WebServer/WebServer depends on the parameters of the AutoConnect constructor . Declaration parameter for the constructor Use ESP8266WebServer::handleClient or WebServer::handleClient only Use AutoConnect::handleClient None AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . also to use ESP8266WebServer/WebServer natively, need AutoConnect::host() . AutoConnect menu available. To use ESP8266WebServer/WebServer natively, need AutoConnect::host() . Reference to ESP8266WebServer/WebServer AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . AutoConnect menu available. By declaration for the AutoConnect variable with no parameter : The ESP8266WebServer/WebServer instance is hosted by AutoConnect automatically then the sketches use AutoConnect::host as API to get it after AutoConnect::begin performed. By declaration for the AutoConnect variable with the reference of ESP8266WebServer/WebServer : AutoConnect will use it. The sketch can use it is too. In use ESP8266WebServer::handleClient()/WebServer::handleClient() : AutoConnect menu can be dispatched but not works normally. It is necessary to call AutoConnect::handleRequest after ESP8255WebServer::handleClient / WebServer::handleClient invoking. In use AutoConnect::handleClient() : The handleClient() process and the AutoConnect menu is available without calling ESP8266WebServer::handleClient . Why AutoConnect::handleRequest is needed when using ESP8266WebServer::handleClient/WebServer::handleClient The AutoConnect menu function may affect WiFi connection state. It follows that the menu process must execute outside ESP8266WebServer::handleClient and WebServer::handleClient . AutoConnect::handleClient is equivalent ESP8266WebServer::handleClient and WEbServer::handleClient included AutoConnect::handleRequest . Each VARIABLE conforms to the actual declaration in the sketches. \u21a9 WiFi SSID and Password can be specified AutoConnect::begin() too. \u21a9 Replacement the handleClient method is not indispensable. AutoConnect can still connect with the captive portal as it is ESP8266WebServer::handleClient. But it can not valid AutoConnect menu . \u21a9","title":"Basic usage"},{"location":"basicusage.html#simple-usage","text":"","title":"Simple usage"},{"location":"basicusage.html#embed-to-the-sketches","text":"How embed the AutoConnect to the sketches you have. Most simple approach to applying AutoConnect for the existing sketches, follow the below steps. The below sketch is for ESP8266. For ESP32, replace ESP8266WebServer with WebServer and ESP8266WiFi.h with WiFi.h respectively. Insert #include <AutoConnect.h> to behind of #include <ESP8266WebServer.h> . Insert AutoConnect PORTAL(WEBSERVER); to behind of ESP8266WebServer WEBSERVER; declaration. 1 Remove WiFi. begin ( SSID , PSK ) and the subsequent logic for the connection status check. Replace WEBSERVER . begin () to PORTAL . begin () . 2 Replace WEBSERVER . handleClient () to PORTAL . handleClient () . 3 If the connection checks logic is needed, you can check the return value according to PORTAL . begin () with true or false .","title":" Embed to the sketches"},{"location":"basicusage.html#basic-usage","text":"","title":"Basic usage"},{"location":"basicusage.html#basic-logic-sequence-for-the-user-sketches","text":"","title":" Basic logic sequence for the user sketches"},{"location":"basicusage.html#1-a-typical-logic-sequence","text":"Include headers, ESP8266WebServer.h / WebServer.h and AutoConnect.h Declare an ESP8266WebServer variable for ESP8266 or a WebServer variable for ESP32. Declare an AutoConnect variable. Implement the URL handlers provided for the on method of ESP8266WebServer/WebServer with the function() . setup() 5.1 Sets URL handler the function() to ESP8266WebServer/WebServer by ESP8266WebServer::on / WebServer::on . 5.2 Starts AutoConnect::begin() . 5.3 Check WiFi connection status. loop() 6.1 Do the process for actual sketch. 6.2 Invokes AutoConnect::handleClient() , or invokes ESP8266WebServer::handleClient() / WebServer::handleClient then AutoConnect::handleRequest() .","title":"1. A typical logic sequence"},{"location":"basicusage.html#2-declare-autoconnect-object","text":"Two options are available for AutoConnect constructor . AutoConnect VARIABLE ( & ESP8266WebServer); // For ESP8266 AutoConnect VARIABLE ( & WebServer); // For ESP32 or AutoConnect VARIABLE; The parameter with an ESP8266WebServer/WebServer variable: An ESP8266WebServer/WebServer object variable must be declared. AutoConnect uses its variable to handles the AutoConnect menu . With no parameter: The sketch does not declare ESP8266WebServer/WebServer object. In this case, AutoConnect allocates an instance of the ESP8266WebServer/WebServer internally. The logic sequence of the sketch is somewhat different as the above. To register a URL handler function by ESP8266WebServer::on or WebServer::on should be performed after AutoConnect::begin .","title":"2. Declare AutoConnect object"},{"location":"basicusage.html#3-no-need-wifibegin","text":"AutoConnect internally performs WiFi.begin to establish a WiFi connection. There is no need for a general process to establish a connection using WiFi.begin with a sketch code.","title":"3. No need WiFI.begin(...)"},{"location":"basicusage.html#4-alternate-esp8266webserverbegin-and-webserverbegin","text":"AutoConnect::begin executes ESP8266WebServer::begin / WebServer::begin internally too and it starts the DNS server to behave as a Captive portal. So it is not needed to call ESP8266WebServer::begin / WebServer::begin in the sketch. Why DNS Server starts AutoConnect traps the detection of the captive portal and achieves a connection with the WLAN interactively by the AutoConnect menu. It responds SoftAP address to all DNS queries temporarily to trap. Once a WiFi connection establishes, the DNS server contributed by AutoConnect stops.","title":"4. Alternate ESP8266WebServer::begin() and WebServer::begin()"},{"location":"basicusage.html#5-autoconnectbegin-with-ssid-and-password","text":"SSID and Password can also specify by AutoConnect::begin . ESP8266/ESP32 uses provided SSID and Password explicitly. If the connection false with specified SSID with Password then a captive portal is activated. SSID and Password are not present, ESP8266 SDK will attempt to connect using the still effectual SSID and password. Usually, it succeeds.","title":"5. AutoConnect::begin with SSID and Password"},{"location":"basicusage.html#6-use-esp8266webserveron-and-webserveron-to-handle-url","text":"AutoConnect is designed to coexist with the process for handling the web pages by user sketches. The page processing function which will send an HTML to the client invoked by the \" on::ESP8266WebServer \" or the \" on::WebServer \" function is the same as when using ESP8266WebServer/WebServer natively.","title":"6. Use ESP8266WebServer::on and WebServer::on to handle URL"},{"location":"basicusage.html#7-use-either-esp8266webserverhandleclientwebserverhandleclient-or-autoconnecthandleclient","text":"Both classes member function name is the same: handleClient , but the behavior is different. Using the AutoConnect embedded along with ESP8266WebServer::handleClient/WebServer::handleClient has limitations. Refer to the below section for details.","title":"7. Use either ESP8266WebServer::handleClient()/WebServer::handleClient() or AutoConnect::handleClient()"},{"location":"basicusage.html#esp8266webserverwebserver-hosted-or-parasitic","text":"The interoperable process with an ESP8266WebServer/WebServer depends on the parameters of the AutoConnect constructor . Declaration parameter for the constructor Use ESP8266WebServer::handleClient or WebServer::handleClient only Use AutoConnect::handleClient None AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . also to use ESP8266WebServer/WebServer natively, need AutoConnect::host() . AutoConnect menu available. To use ESP8266WebServer/WebServer natively, need AutoConnect::host() . Reference to ESP8266WebServer/WebServer AutoConnect menu not available. To use AutoConnect menu, need AutoConnect::handleRequest() . AutoConnect menu available. By declaration for the AutoConnect variable with no parameter : The ESP8266WebServer/WebServer instance is hosted by AutoConnect automatically then the sketches use AutoConnect::host as API to get it after AutoConnect::begin performed. By declaration for the AutoConnect variable with the reference of ESP8266WebServer/WebServer : AutoConnect will use it. The sketch can use it is too. In use ESP8266WebServer::handleClient()/WebServer::handleClient() : AutoConnect menu can be dispatched but not works normally. It is necessary to call AutoConnect::handleRequest after ESP8255WebServer::handleClient / WebServer::handleClient invoking. In use AutoConnect::handleClient() : The handleClient() process and the AutoConnect menu is available without calling ESP8266WebServer::handleClient . Why AutoConnect::handleRequest is needed when using ESP8266WebServer::handleClient/WebServer::handleClient The AutoConnect menu function may affect WiFi connection state. It follows that the menu process must execute outside ESP8266WebServer::handleClient and WebServer::handleClient . AutoConnect::handleClient is equivalent ESP8266WebServer::handleClient and WEbServer::handleClient included AutoConnect::handleRequest . Each VARIABLE conforms to the actual declaration in the sketches. \u21a9 WiFi SSID and Password can be specified AutoConnect::begin() too. \u21a9 Replacement the handleClient method is not indispensable. AutoConnect can still connect with the captive portal as it is ESP8266WebServer::handleClient. But it can not valid AutoConnect menu . \u21a9","title":" ESP8266WebServer/WebServer hosted or parasitic"},{"location":"changelog.html","text":"[1.1.0] Oct. 15, 2019 \u00b6 Supports static IPs with the Configure new AP menu. Fixed compilation error that no member named 'printTo' with ArduinoJson 5. [1.0.3] Sept. 30, 2019 \u00b6 Fixed a return of AutoConnectCredential::entries(). [1.0.2] Sept. 19, 2019 \u00b6 Fixed compilation error that no member named 'success' with ArduinoJson 5. Fixed SSID non termination. Fixed compilation error that getBytesLength missing with ESP32. Added #include directive restriction for EEPROM and ESP8266httpUpdate to FAQ. [1.0.1] Sept. 13, 2019 \u00b6 Added a sketch for ESP32 boards that migrates credentials stored in EEPROM partition to the Preferences. [1.0.0] Sept. 7, 2019 \u00b6 Supports Arduino core for ESP32 1.0.3. Supports AutoConnectUpdate for the OTA update . Supports Preferences for saving credentials with ESP32 core 1.0.3 and later. In ESP32, the credentials stored past in EEPROM will lose . Supports AutoConnectAux::isValid function. Supports the global attribute with all AutoConnectElements. [0.9.12] Aug. 18, 2019 \u00b6 Fixed missing captive portal notifications on the newer mobile OS client. As a result of this fix, the SoftAP default IP address and gateway have been changed to 172.217.28.1 . [0.9.11] July 13, 2019 \u00b6 Supports new element as AutoConnectSytle that can insert the custom CSS into AutoConnectAux page. Supports that <br> tags can now be added to each element. Supports that able to place the checkbox label forward or backward. Supports flicker signal output according to the status of WiFi_mode. Supports AutoConnectAux::fetchElement function to retrieve inputted element values via a custom Web page. Fixed bug in AutoConnectCredential when offset is >256. [0.9.10] June 12, 2019 \u00b6 Fixed the unable to get AutoConnectElemets values \u200b\u200bin the sketch with ESP8266 arduino core 2.5.2. [0.9.9] May 25, 2019 \u00b6 Supports ESP8266 Arduino core 2.5.2. Menu text/background color can be statically customized. Added the enable attribute to the AutoConnectElements. This attribute gives dynamically change to the element activation during the sketch executing. Added ID attribute to HTML tag generated from AutoConnectText. Fixed the input box layout collapsed. Fixed that the decoration of AutoConnectButton was disabled. Fixed that the value remains even after clearing the option with AutoConnectSelect. Fixed that an alignment violation exception occurred when loading AutoConnectAux described by JSON with PROGMEM attribute. [0.9.8] May 3, 2019 \u00b6 Supports ArduinoJson 6.9.1 or later. Supports allocating JsonDocument buffer to PSRAM on ESP32 with ArduinoJson 6.10.0 or later. Supports operator [] as a shortcut for AutoConnectAux::getElement function. Supports AutoConnectElement::as<T> function to easily coding for conversion from an AutoConnectElement to an actual type. Supports new element type AutoConnectFile and built-in file uploader. Supports a format attribute with the AutoConnectText element. Supports a selected attribute with the AutoConnectSelect element. Supports multiple element loading with AutoConnectAux::loadElement . Changed menu labels placement in source files structure. Changed API interface of **AutoConnect::where function. Fixed blank page responds with Configure new. Fixed loading elements value missing. Fixed losing elements in saveElement with ArduinoJson V6. Fixed compile error with older than ESP8266 core 2.5.0. [0.9.7] Jan. 25, 2019 \u00b6 Fixed crash in some environments. Thank you @ageurtse Supports AutoConnect menu extension by user sketch with AutoConnectAux . Supports loading and saving of user-defined parameters with JSON format. Improved the WiFi connection sequence at the first WiFi.begin. Even if AutoConnectConfig::autoReconnect is disabled when SSID and PSK are not specified, it will use the information of the last established access point. The autoReconnect option will achieve trying the connect after a previous connection failed. Supports the AutoConnectConfig::immediateStart option and immediately starts the portal without first trying WiFi.begin. You can start the captive portal at any time in combination with the AutoConnectConfig::autoRise option. Improved boot uri after reset. AutoConnectConfig::bootUri can be specified either /_ac or HOME path as the uri to be accessed after invoking Reset from AutoConnect menu. Improved source code placement of predefined macros. Defined common macros have been moved to AutoConnectDefs.h . Supports AutoConnectConfig::hostName . It activates WiFi.hostname() / WiFi.setHostName() . Supports the captive portal time-out. It can be controlled by AutoConnectConfig::portalTimeout and AutoConnectConfig::retainPortal . [0.9.6] Sept.27, 2018. \u00b6 Improvement of RSSI detection for saved SSIDs. Fixed disconnection SoftAP completely at the first connection phase of the AutoConnect::begin . [0.9.5] Aug.27, 2018. \u00b6 Supports ESP32. Fixed that crash may occur if the number of stored credentials in the EEPROM is smaller than the number of found WiFi networks. [0.9.4] May 5, 2018. \u00b6 Automatically focus passphrase after selecting SSID with Configure New AP. Supports AutoConnectConfig::autoReconnect option, it will scan the WLAN when it can not connect to the default SSID, apply the applicable credentials if it is saved, and try reconnecting. [0.9.3] March 23, 2018. \u00b6 Supports a static IP address assignment. [0.9.2] March 19, 2018. \u00b6 Improvement of string literal declaration with the examples, no library change. [0.9.1] March 13, 2018. \u00b6 A release of the stable.","title":"Change log"},{"location":"changelog.html#110-oct-15-2019","text":"Supports static IPs with the Configure new AP menu. Fixed compilation error that no member named 'printTo' with ArduinoJson 5.","title":"[1.1.0] Oct. 15, 2019"},{"location":"changelog.html#103-sept-30-2019","text":"Fixed a return of AutoConnectCredential::entries().","title":"[1.0.3] Sept. 30, 2019"},{"location":"changelog.html#102-sept-19-2019","text":"Fixed compilation error that no member named 'success' with ArduinoJson 5. Fixed SSID non termination. Fixed compilation error that getBytesLength missing with ESP32. Added #include directive restriction for EEPROM and ESP8266httpUpdate to FAQ.","title":"[1.0.2] Sept. 19, 2019"},{"location":"changelog.html#101-sept-13-2019","text":"Added a sketch for ESP32 boards that migrates credentials stored in EEPROM partition to the Preferences.","title":"[1.0.1] Sept. 13, 2019"},{"location":"changelog.html#100-sept-7-2019","text":"Supports Arduino core for ESP32 1.0.3. Supports AutoConnectUpdate for the OTA update . Supports Preferences for saving credentials with ESP32 core 1.0.3 and later. In ESP32, the credentials stored past in EEPROM will lose . Supports AutoConnectAux::isValid function. Supports the global attribute with all AutoConnectElements.","title":"[1.0.0] Sept. 7, 2019"},{"location":"changelog.html#0912-aug-18-2019","text":"Fixed missing captive portal notifications on the newer mobile OS client. As a result of this fix, the SoftAP default IP address and gateway have been changed to 172.217.28.1 .","title":"[0.9.12] Aug. 18, 2019"},{"location":"changelog.html#0911-july-13-2019","text":"Supports new element as AutoConnectSytle that can insert the custom CSS into AutoConnectAux page. Supports that <br> tags can now be added to each element. Supports that able to place the checkbox label forward or backward. Supports flicker signal output according to the status of WiFi_mode. Supports AutoConnectAux::fetchElement function to retrieve inputted element values via a custom Web page. Fixed bug in AutoConnectCredential when offset is >256.","title":"[0.9.11] July 13, 2019"},{"location":"changelog.html#0910-june-12-2019","text":"Fixed the unable to get AutoConnectElemets values \u200b\u200bin the sketch with ESP8266 arduino core 2.5.2.","title":"[0.9.10] June 12, 2019"},{"location":"changelog.html#099-may-25-2019","text":"Supports ESP8266 Arduino core 2.5.2. Menu text/background color can be statically customized. Added the enable attribute to the AutoConnectElements. This attribute gives dynamically change to the element activation during the sketch executing. Added ID attribute to HTML tag generated from AutoConnectText. Fixed the input box layout collapsed. Fixed that the decoration of AutoConnectButton was disabled. Fixed that the value remains even after clearing the option with AutoConnectSelect. Fixed that an alignment violation exception occurred when loading AutoConnectAux described by JSON with PROGMEM attribute.","title":"[0.9.9] May 25, 2019"},{"location":"changelog.html#098-may-3-2019","text":"Supports ArduinoJson 6.9.1 or later. Supports allocating JsonDocument buffer to PSRAM on ESP32 with ArduinoJson 6.10.0 or later. Supports operator [] as a shortcut for AutoConnectAux::getElement function. Supports AutoConnectElement::as<T> function to easily coding for conversion from an AutoConnectElement to an actual type. Supports new element type AutoConnectFile and built-in file uploader. Supports a format attribute with the AutoConnectText element. Supports a selected attribute with the AutoConnectSelect element. Supports multiple element loading with AutoConnectAux::loadElement . Changed menu labels placement in source files structure. Changed API interface of **AutoConnect::where function. Fixed blank page responds with Configure new. Fixed loading elements value missing. Fixed losing elements in saveElement with ArduinoJson V6. Fixed compile error with older than ESP8266 core 2.5.0.","title":"[0.9.8] May 3, 2019"},{"location":"changelog.html#097-jan-25-2019","text":"Fixed crash in some environments. Thank you @ageurtse Supports AutoConnect menu extension by user sketch with AutoConnectAux . Supports loading and saving of user-defined parameters with JSON format. Improved the WiFi connection sequence at the first WiFi.begin. Even if AutoConnectConfig::autoReconnect is disabled when SSID and PSK are not specified, it will use the information of the last established access point. The autoReconnect option will achieve trying the connect after a previous connection failed. Supports the AutoConnectConfig::immediateStart option and immediately starts the portal without first trying WiFi.begin. You can start the captive portal at any time in combination with the AutoConnectConfig::autoRise option. Improved boot uri after reset. AutoConnectConfig::bootUri can be specified either /_ac or HOME path as the uri to be accessed after invoking Reset from AutoConnect menu. Improved source code placement of predefined macros. Defined common macros have been moved to AutoConnectDefs.h . Supports AutoConnectConfig::hostName . It activates WiFi.hostname() / WiFi.setHostName() . Supports the captive portal time-out. It can be controlled by AutoConnectConfig::portalTimeout and AutoConnectConfig::retainPortal .","title":"[0.9.7] Jan. 25, 2019"},{"location":"changelog.html#096-sept27-2018","text":"Improvement of RSSI detection for saved SSIDs. Fixed disconnection SoftAP completely at the first connection phase of the AutoConnect::begin .","title":"[0.9.6] Sept.27, 2018."},{"location":"changelog.html#095-aug27-2018","text":"Supports ESP32. Fixed that crash may occur if the number of stored credentials in the EEPROM is smaller than the number of found WiFi networks.","title":"[0.9.5] Aug.27, 2018."},{"location":"changelog.html#094-may-5-2018","text":"Automatically focus passphrase after selecting SSID with Configure New AP. Supports AutoConnectConfig::autoReconnect option, it will scan the WLAN when it can not connect to the default SSID, apply the applicable credentials if it is saved, and try reconnecting.","title":"[0.9.4] May 5, 2018."},{"location":"changelog.html#093-march-23-2018","text":"Supports a static IP address assignment.","title":"[0.9.3] March 23, 2018."},{"location":"changelog.html#092-march-19-2018","text":"Improvement of string literal declaration with the examples, no library change.","title":"[0.9.2] March 19, 2018."},{"location":"changelog.html#091-march-13-2018","text":"A release of the stable.","title":"[0.9.1] March 13, 2018."},{"location":"colorized.html","text":"AutoConnect menu colorizing \u00b6 You can easily change the color of the AutoConnect menu. Menu colors can be changed statically by the AutoConnect menu color definition determined at compile time. You cannot change the color while the sketch is running. The menu color scheme has been separated to AutoConnectLabels.h placed the AutoConnect library folder. 1 You can change the color scheme of the menu with the following three color codes. The color code also accepts CSS standard color names. 2 In AutoConnectLabels.h you can find three definition macros for menu colors: #define AUTOCONNECT_MENUCOLOR_TEXT Defines the menu text color. #define AUTOCONNECT_MENUCOLOR_BACKGROUND Defines the menu background color. #define AUTOCONNECT_MENUCOLOR_ACTIVE Defines the active menu item background color. Typical color schemes \u00b6 Here are some color schemes picked up. Indigo \u00b6 #define AUTOCONNECT_MENUCOLOR_TEXT \"#ffa500\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#1a237e\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#283593\" Dim-gray \u00b6 #define AUTOCONNECT_MENUCOLOR_TEXT \"#fffacd\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#696969\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#808080\" Brown \u00b6 #define AUTOCONNECT_MENUCOLOR_TEXT \"#e6e6fa\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#3e2723\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#4e342e\" Usually, it will locate to the Arduino/libraries/AutoConnect/src folder of user documents. \u21a9 The W3C HTML and CSS standards have listed only 16 valid color names: aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, and yellow. Major browsers can accept more color names, but they are not web safe in typically. \u21a9","title":"Custom colorized"},{"location":"colorized.html#autoconnect-menu-colorizing","text":"You can easily change the color of the AutoConnect menu. Menu colors can be changed statically by the AutoConnect menu color definition determined at compile time. You cannot change the color while the sketch is running. The menu color scheme has been separated to AutoConnectLabels.h placed the AutoConnect library folder. 1 You can change the color scheme of the menu with the following three color codes. The color code also accepts CSS standard color names. 2 In AutoConnectLabels.h you can find three definition macros for menu colors: #define AUTOCONNECT_MENUCOLOR_TEXT Defines the menu text color. #define AUTOCONNECT_MENUCOLOR_BACKGROUND Defines the menu background color. #define AUTOCONNECT_MENUCOLOR_ACTIVE Defines the active menu item background color.","title":"AutoConnect menu colorizing"},{"location":"colorized.html#typical-color-schemes","text":"Here are some color schemes picked up.","title":"Typical color schemes"},{"location":"colorized.html#indigo","text":"#define AUTOCONNECT_MENUCOLOR_TEXT \"#ffa500\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#1a237e\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#283593\"","title":" Indigo"},{"location":"colorized.html#dim-gray","text":"#define AUTOCONNECT_MENUCOLOR_TEXT \"#fffacd\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#696969\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#808080\"","title":" Dim-gray"},{"location":"colorized.html#brown","text":"#define AUTOCONNECT_MENUCOLOR_TEXT \"#e6e6fa\" #define AUTOCONNECT_MENUCOLOR_BACKGROUND \"#3e2723\" #define AUTOCONNECT_MENUCOLOR_ACTIVE \"#4e342e\" Usually, it will locate to the Arduino/libraries/AutoConnect/src folder of user documents. \u21a9 The W3C HTML and CSS standards have listed only 16 valid color names: aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, and yellow. Major browsers can accept more color names, but they are not web safe in typically. \u21a9","title":" Brown"},{"location":"credit.html","text":"Saved credentials in the flash \u00b6 AutoConnect stores the established WiFi connection in the flash memory of the ESP8266/ESP32 module and equips the class to access the credentials from the sketch. You can read, write or erase the credentials using this class individually. It's AutoConnectCredential class which provides the access method to the saved credentials in the flash. 1 Credentials storage location \u00b6 The location where AutoConnect saves credentials depends on the module type and the AutoConnect library version, also arduino-esp32 core version. In either case, the location is flash memory, but EEPROM and Preferences (in the nvs 2 ) are used depending on the library versions. AutoConnect Arduino core for ESP8266 Arduino core for ESP32 1.0.2 earlier 1.0.3 later v0.9.12 earlier EEPROM EEPROM (partition) Not supported v1.0.0 later Preferences (nvs) (Can be used EEPROM with turning off AUTOCONNECT_USE_PREFERENCES macro) Preferences (nvs) However, sketches do not need to know where to store credentials using the commonly accessible AutoConnectCredential API. If you are using an Arduino core for ESP32 1.0.2 earlier and need to use credentials in EEPROM for backward compatibility, turns off the AUTOCONNECT_USE_PREFERENCES 3 macro definition in AutoConnectCredentials.h file. AutoConnect behaves assuming that credentials are stored in EEPROM if AUTOCONNECT_USE_PREFERENCES is not defined. AutoConnectCredential \u00b6 Include header \u00b6 #include <AutoConnectCredential.h> Constructors \u00b6 AutoConnectCredential(); AutoConnectCredential default constructor. The default offset value is 0. In ESP8266 or ESP32 with arduino core 1.0.2 earlier, if the offset value is 0, the credential area starts from the top of the EEPROM. If you use this area in a user sketch, AutoConnect may overwrite that data. AutoConnectCredential( uint16_t offset); Parameter offset Species offset from the top of the EEPROM for the credential area together. The offset value is from 0 to the flash sector size. This parameter is ignored for AutoConnect v1.0.0 or later with arduino-esp32 core 1.0.3 or later. Public member functions \u00b6 entries \u00b6 uint8_t entries( void ) Returns number of entries as contained credentials. Return value Number of entries as contained credentials. load \u00b6 int8_t load( const char * ssid, station_config_t * config) Load a credential entry and store to config . Parameters ssid SSID to be loaded. config station_config_t Return value Save the specified SSID's credential entry to station_config_t pointed to by the parameter as config . -1 is returned if the SSID is not saved. load \u00b6 bool load( int8_t entry, station_config_t * config) Load a credential entry and store to config . Parameters entry Specifies the index number based 0 to be loaded. config station_config_t Return value Save the specified credential entry to station_config_t pointed to by the parameter as config . -1 is returned if specified number is not saved. save \u00b6 bool save( const station_config_t * config) Save a credential entry. Parameter config station_config_t to be saved. Return value true Successfully saved. false Failed to save. del \u00b6 bool del( const char * ssid) Delete a credential the specified SSID. Parameter ssid SSID to be deleted. Return value true Successfully deleted. false Failed to delete. Clear saved credentials There is no particular API for batch clearing of all credential data stored by AutoConnect. It is necessary to prepare a sketch function that combines several AutoConnectCredential APIs to erase all saved credentials. The following function is an implementation example, and you can use it to achieve batch clearing. void deleteAllCredentials ( void ) { AutoConnectCredential credential; station_config_t config; uint8_t ent = credential.entries(); while (ent -- ) { credential.load( 0 , & config); credential.del(( const char * ) & config.ssid[ 0 ]); } } The data structures \u00b6 station_config_t \u00b6 The saved credential structure is defined as stato_config_t in the AcutoConnectCredential header file. typedef struct { uint8_t ssid[ 32 ]; uint8_t password[ 64 ]; uint8_t bssid[ 6 ]; uint8_t dhcp; /**< 0:DHCP, 1:Static IP */ union _config { uint32_t addr[ 5 ]; struct _sta { uint32_t ip; uint32_t gateway; uint32_t netmask; uint32_t dns1; uint32_t dns2; } sta; } config; } station_config_t; The byte size of station_config_t in program memory and stored credentials is different There is a gap byte for boundary alignment between the dhcp member and the static IP members of the above station_config_t. Its gap byte will be removed with saved credentials on the flash. The credential entry \u00b6 A data structure of the credential saving area in EEPROM as the below. 4 byte offset Length Value 0 8 AC_CREDT 8 1 Number of contained entries (uint8_t) 9 2 Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). 11 variable SSID terminated by 0x00. Max length is 32 bytes. variable variable Password plain text terminated by 0x00. Max length is 64 bytes. variable 6 BSSID variable 1 Flag for DHCP or Static IP (0:DHCP, 1:Static IP) The following IP address entries are stored only for static IPs. variable(1) 4 Station IP address (uint32_t) variable(5) 4 Gateway address (uint32_t) variable(9) 4 Netmask (uint32_t) variable(13) 4 Primary DNS address (uint32_t) variable(17) 4 Secondary IP address (uint32_t) variable variable Contained the next entries. (Continuation SSID+Password+BSSID+DHCP flag+Static IPs(if exists)) variable 1 0x00. End of container. AutoConnectCredential has changed It was lost AutoConnectCredential backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not work properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading. esptool -c esp8266 (or esp32) - p [COM_PORT] erase_flash An example using AutoConnectCredential is provided as an example of a library sketch to delete saved credentials. \u21a9 The namespace for Preferences used by AutoConnect is AC_CREDT . \u21a9 Available only for AutoConnect v1.0.0 and later. \u21a9 There may be 0xff as an invalid data in the credential saving area. The 0xff area would be reused. \u21a9","title":"Saved credentials access"},{"location":"credit.html#saved-credentials-in-the-flash","text":"AutoConnect stores the established WiFi connection in the flash memory of the ESP8266/ESP32 module and equips the class to access the credentials from the sketch. You can read, write or erase the credentials using this class individually. It's AutoConnectCredential class which provides the access method to the saved credentials in the flash. 1","title":"Saved credentials in the flash"},{"location":"credit.html#credentials-storage-location","text":"The location where AutoConnect saves credentials depends on the module type and the AutoConnect library version, also arduino-esp32 core version. In either case, the location is flash memory, but EEPROM and Preferences (in the nvs 2 ) are used depending on the library versions. AutoConnect Arduino core for ESP8266 Arduino core for ESP32 1.0.2 earlier 1.0.3 later v0.9.12 earlier EEPROM EEPROM (partition) Not supported v1.0.0 later Preferences (nvs) (Can be used EEPROM with turning off AUTOCONNECT_USE_PREFERENCES macro) Preferences (nvs) However, sketches do not need to know where to store credentials using the commonly accessible AutoConnectCredential API. If you are using an Arduino core for ESP32 1.0.2 earlier and need to use credentials in EEPROM for backward compatibility, turns off the AUTOCONNECT_USE_PREFERENCES 3 macro definition in AutoConnectCredentials.h file. AutoConnect behaves assuming that credentials are stored in EEPROM if AUTOCONNECT_USE_PREFERENCES is not defined.","title":"Credentials storage location"},{"location":"credit.html#autoconnectcredential","text":"","title":"AutoConnectCredential"},{"location":"credit.html#include-header","text":"#include <AutoConnectCredential.h>","title":" Include header"},{"location":"credit.html#constructors","text":"AutoConnectCredential(); AutoConnectCredential default constructor. The default offset value is 0. In ESP8266 or ESP32 with arduino core 1.0.2 earlier, if the offset value is 0, the credential area starts from the top of the EEPROM. If you use this area in a user sketch, AutoConnect may overwrite that data. AutoConnectCredential( uint16_t offset); Parameter offset Species offset from the top of the EEPROM for the credential area together. The offset value is from 0 to the flash sector size. This parameter is ignored for AutoConnect v1.0.0 or later with arduino-esp32 core 1.0.3 or later.","title":" Constructors"},{"location":"credit.html#public-member-functions","text":"","title":" Public member functions"},{"location":"credit.html#entries","text":"uint8_t entries( void ) Returns number of entries as contained credentials. Return value Number of entries as contained credentials.","title":" entries"},{"location":"credit.html#load","text":"int8_t load( const char * ssid, station_config_t * config) Load a credential entry and store to config . Parameters ssid SSID to be loaded. config station_config_t Return value Save the specified SSID's credential entry to station_config_t pointed to by the parameter as config . -1 is returned if the SSID is not saved.","title":" load"},{"location":"credit.html#load_1","text":"bool load( int8_t entry, station_config_t * config) Load a credential entry and store to config . Parameters entry Specifies the index number based 0 to be loaded. config station_config_t Return value Save the specified credential entry to station_config_t pointed to by the parameter as config . -1 is returned if specified number is not saved.","title":" load"},{"location":"credit.html#save","text":"bool save( const station_config_t * config) Save a credential entry. Parameter config station_config_t to be saved. Return value true Successfully saved. false Failed to save.","title":" save"},{"location":"credit.html#del","text":"bool del( const char * ssid) Delete a credential the specified SSID. Parameter ssid SSID to be deleted. Return value true Successfully deleted. false Failed to delete. Clear saved credentials There is no particular API for batch clearing of all credential data stored by AutoConnect. It is necessary to prepare a sketch function that combines several AutoConnectCredential APIs to erase all saved credentials. The following function is an implementation example, and you can use it to achieve batch clearing. void deleteAllCredentials ( void ) { AutoConnectCredential credential; station_config_t config; uint8_t ent = credential.entries(); while (ent -- ) { credential.load( 0 , & config); credential.del(( const char * ) & config.ssid[ 0 ]); } }","title":" del"},{"location":"credit.html#the-data-structures","text":"","title":"The data structures"},{"location":"credit.html#station_config_t","text":"The saved credential structure is defined as stato_config_t in the AcutoConnectCredential header file. typedef struct { uint8_t ssid[ 32 ]; uint8_t password[ 64 ]; uint8_t bssid[ 6 ]; uint8_t dhcp; /**< 0:DHCP, 1:Static IP */ union _config { uint32_t addr[ 5 ]; struct _sta { uint32_t ip; uint32_t gateway; uint32_t netmask; uint32_t dns1; uint32_t dns2; } sta; } config; } station_config_t; The byte size of station_config_t in program memory and stored credentials is different There is a gap byte for boundary alignment between the dhcp member and the static IP members of the above station_config_t. Its gap byte will be removed with saved credentials on the flash.","title":"  station_config_t"},{"location":"credit.html#the-credential-entry","text":"A data structure of the credential saving area in EEPROM as the below. 4 byte offset Length Value 0 8 AC_CREDT 8 1 Number of contained entries (uint8_t) 9 2 Container size, excluding size of AC_CREDT and size of the number of entries(width for uint16_t type). 11 variable SSID terminated by 0x00. Max length is 32 bytes. variable variable Password plain text terminated by 0x00. Max length is 64 bytes. variable 6 BSSID variable 1 Flag for DHCP or Static IP (0:DHCP, 1:Static IP) The following IP address entries are stored only for static IPs. variable(1) 4 Station IP address (uint32_t) variable(5) 4 Gateway address (uint32_t) variable(9) 4 Netmask (uint32_t) variable(13) 4 Primary DNS address (uint32_t) variable(17) 4 Secondary IP address (uint32_t) variable variable Contained the next entries. (Continuation SSID+Password+BSSID+DHCP flag+Static IPs(if exists)) variable 1 0x00. End of container. AutoConnectCredential has changed It was lost AutoConnectCredential backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not work properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading. esptool -c esp8266 (or esp32) - p [COM_PORT] erase_flash An example using AutoConnectCredential is provided as an example of a library sketch to delete saved credentials. \u21a9 The namespace for Preferences used by AutoConnect is AC_CREDT . \u21a9 Available only for AutoConnect v1.0.0 and later. \u21a9 There may be 0xff as an invalid data in the credential saving area. The 0xff area would be reused. \u21a9","title":"  The credential entry"},{"location":"datatips.html","text":"Convert AutoConnectElements value to actual data type \u00b6 The values in the AutoConnectElements field of the custom Web page are all typed as String. A sketch needs to be converted to an actual data type if the data type required for sketch processing is not a String type. The AutoConnect library does not provide the data conversion utility, and its function depends on Arduino language functions or functions of the type class. However, commonly used data conversion methods are generally similar. Here, represent examples the typical method for the data type conversion for the AutoConnectElements value of custom Web pages. Integer \u00b6 Use int() or toInt() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); int value = input.value.toInt(); You can shorten it and write as like: int value = aux[ \"INPUT\" ].value.toInt(); Float \u00b6 Use float() or toFloat() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); float value = input.value.toFloat(); You can shorten it and write as like: float value = aux[ \"INPUT\" ].value.toFloat(); Date & Time \u00b6 The easiest way is to use the Arduino Time Library . Sketches must accommodate differences in date and time formats depending on the time zone. You can absorb the difference in DateTime format by using sscanf function. 1 #include <TimeLib.h> time_t tm; int Year, Month, Day, Hour, Minute, Second; AutoConnectInput & input = aux.[ \"INPUT\" ].as < AutoConnectInput > (); sscanf(input.value.c_str(), \"%d-%d-%d %d:%d:%d\" , & Year, & Month, & Day, & Hour, & Minute, & Second); tm.Year = CalendarYrToTm(Year); tm.Month = Month; tm.Day = Day; tm.Hour = Hour; tm.Minute = Minute; tm.Second = Second; IP address \u00b6 To convert a String to an IP address, use IPAddress::fromString . To stringize an instance of an IP address, use IPAddress::toString . IPAddress ip; AutoConnectInput & input aux[ \"INPUT\" ].as < AutoConnectInput > (); ip.fromString(input.value); input.value = ip.toString(); Validation for the value \u00b6 To convert input data correctly from the string, it must match its format. The validation implementation with sketches depends on various perspectives. Usually, the tiny devices have no enough power for the lexical analysis completely. But you can reduce the burden for data verification using the pattern of AutoConnectInput. By giving a pattern to AutoConnectInput , you can find errors in data format while typing in custom Web pages. Specifying the input data rule as a regular expression will validate the type match during input. If there is an error in the format during input, the background color of the field will change to pink. Refer to section Handling the custom Web pages . However, input data will be transmitted even if the value does not match the pattern. Sketches require the validation of the received data. You can use the AutoConnectInput::isValid function to validate it. The isValid function validates whether the value member variable matches a pattern and returns true or false. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char input_page[] PROGMEM = R\"raw( [ { \"title\": \"IP Address\", \"uri\": \"/\", \"menu\": true, \"element\": [ { \"name\": \"ipaddress\", \"type\": \"ACInput\", \"label\": \"IP Address\", \"pattern\": \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"SEND\", \"uri\": \"/check\" } ] }, { \"title\": \"IP Address\", \"uri\": \"/check\", \"menu\": false, \"element\": [ { \"name\": \"result\", \"type\": \"ACText\" } ] } ] )raw\" ; AutoConnect portal; String checkIPAddress (AutoConnectAux & aux, PageArgument & args) { AutoConnectAux & input_page = * portal.aux( \"/\" ); AutoConnectInput & ipaddress = input_page[ \"ipaddress\" ].as < AutoConnectInput > (); AutoConnectText & result = aux[ \"result\" ].as < AutoConnectText > (); if (ipaddress.isValid()) { result.value = \"IP Address \" + ipaddress.value + \" is OK.\" ; result.style = \"\" ; } else { result.value = \"IP Address \" + ipaddress.value + \" error.\" ; result.style = \"color:red;\" ; } return String( \"\" ); } void setup () { portal.load(input_page); portal.on( \"/check\" , checkIPAddress); portal.begin(); } void loop () { portal.handleClient(); } Regular Expressions for JavaScript Regular expressions specified in the AutoConnectInput pattern conforms to the JavaScript specification . Here, represent examples the typical regular expression for the input validation. URL \u00b6 ^\\w+([-+.]\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$ DNS hostname \u00b6 ^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$ email address 2 \u00b6 ^[a-zA-Z0-9.!#$%&'*+\\/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*$ IP Address \u00b6 ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ Date as MM/DD/YYYY 3 \u00b6 ^(0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d$ Contain with backquote If that regular expression contains a backquote it must be escaped by backquote duplication. The ssanf library function cannot be used with the old Arduino core. \u21a9 This regular expression does not fully support the format of the e-mail address requested in RFC5322 . \u21a9 This regular expression does not consider semantic constraints. It is not possible to detect errors that do not exist as actual dates. \u21a9","title":"Tips for data conversion"},{"location":"datatips.html#convert-autoconnectelements-value-to-actual-data-type","text":"The values in the AutoConnectElements field of the custom Web page are all typed as String. A sketch needs to be converted to an actual data type if the data type required for sketch processing is not a String type. The AutoConnect library does not provide the data conversion utility, and its function depends on Arduino language functions or functions of the type class. However, commonly used data conversion methods are generally similar. Here, represent examples the typical method for the data type conversion for the AutoConnectElements value of custom Web pages.","title":"Convert AutoConnectElements value to actual data type"},{"location":"datatips.html#integer","text":"Use int() or toInt() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); int value = input.value.toInt(); You can shorten it and write as like: int value = aux[ \"INPUT\" ].value.toInt();","title":" Integer"},{"location":"datatips.html#float","text":"Use float() or toFloat() of String . AutoConnectInput & input = aux.getElement < AutoConnectInput > ( \"INPUT\" ); float value = input.value.toFloat(); You can shorten it and write as like: float value = aux[ \"INPUT\" ].value.toFloat();","title":" Float"},{"location":"datatips.html#date-time","text":"The easiest way is to use the Arduino Time Library . Sketches must accommodate differences in date and time formats depending on the time zone. You can absorb the difference in DateTime format by using sscanf function. 1 #include <TimeLib.h> time_t tm; int Year, Month, Day, Hour, Minute, Second; AutoConnectInput & input = aux.[ \"INPUT\" ].as < AutoConnectInput > (); sscanf(input.value.c_str(), \"%d-%d-%d %d:%d:%d\" , & Year, & Month, & Day, & Hour, & Minute, & Second); tm.Year = CalendarYrToTm(Year); tm.Month = Month; tm.Day = Day; tm.Hour = Hour; tm.Minute = Minute; tm.Second = Second;","title":" Date &amp; Time"},{"location":"datatips.html#ip-address","text":"To convert a String to an IP address, use IPAddress::fromString . To stringize an instance of an IP address, use IPAddress::toString . IPAddress ip; AutoConnectInput & input aux[ \"INPUT\" ].as < AutoConnectInput > (); ip.fromString(input.value); input.value = ip.toString();","title":" IP address"},{"location":"datatips.html#validation-for-the-value","text":"To convert input data correctly from the string, it must match its format. The validation implementation with sketches depends on various perspectives. Usually, the tiny devices have no enough power for the lexical analysis completely. But you can reduce the burden for data verification using the pattern of AutoConnectInput. By giving a pattern to AutoConnectInput , you can find errors in data format while typing in custom Web pages. Specifying the input data rule as a regular expression will validate the type match during input. If there is an error in the format during input, the background color of the field will change to pink. Refer to section Handling the custom Web pages . However, input data will be transmitted even if the value does not match the pattern. Sketches require the validation of the received data. You can use the AutoConnectInput::isValid function to validate it. The isValid function validates whether the value member variable matches a pattern and returns true or false. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> static const char input_page[] PROGMEM = R\"raw( [ { \"title\": \"IP Address\", \"uri\": \"/\", \"menu\": true, \"element\": [ { \"name\": \"ipaddress\", \"type\": \"ACInput\", \"label\": \"IP Address\", \"pattern\": \"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$\" }, { \"name\": \"send\", \"type\": \"ACSubmit\", \"value\": \"SEND\", \"uri\": \"/check\" } ] }, { \"title\": \"IP Address\", \"uri\": \"/check\", \"menu\": false, \"element\": [ { \"name\": \"result\", \"type\": \"ACText\" } ] } ] )raw\" ; AutoConnect portal; String checkIPAddress (AutoConnectAux & aux, PageArgument & args) { AutoConnectAux & input_page = * portal.aux( \"/\" ); AutoConnectInput & ipaddress = input_page[ \"ipaddress\" ].as < AutoConnectInput > (); AutoConnectText & result = aux[ \"result\" ].as < AutoConnectText > (); if (ipaddress.isValid()) { result.value = \"IP Address \" + ipaddress.value + \" is OK.\" ; result.style = \"\" ; } else { result.value = \"IP Address \" + ipaddress.value + \" error.\" ; result.style = \"color:red;\" ; } return String( \"\" ); } void setup () { portal.load(input_page); portal.on( \"/check\" , checkIPAddress); portal.begin(); } void loop () { portal.handleClient(); } Regular Expressions for JavaScript Regular expressions specified in the AutoConnectInput pattern conforms to the JavaScript specification . Here, represent examples the typical regular expression for the input validation.","title":"Validation for the value"},{"location":"datatips.html#url","text":"^\\w+([-+.]\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$","title":" URL"},{"location":"datatips.html#dns-hostname","text":"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$","title":" DNS hostname"},{"location":"datatips.html#email-address-2","text":"^[a-zA-Z0-9.!#$%&'*+\\/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*$","title":" email address 2"},{"location":"datatips.html#ip-address_1","text":"^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$","title":" IP Address"},{"location":"datatips.html#date-as-mmddyyyy-3","text":"^(0[1-9]|1[012])[- \\/.](0[1-9]|[12][0-9]|3[01])[- \\/.](19|20)\\d\\d$ Contain with backquote If that regular expression contains a backquote it must be escaped by backquote duplication. The ssanf library function cannot be used with the old Arduino core. \u21a9 This regular expression does not fully support the format of the e-mail address requested in RFC5322 . \u21a9 This regular expression does not consider semantic constraints. It is not possible to detect errors that do not exist as actual dates. \u21a9","title":" Date as MM/DD/YYYY 3"},{"location":"faq.html","text":"After connected, AutoConnect menu performs but no happens. \u00b6 If you can access the AutoConnect root path as http://ESP8266IPADDRESS/_ac from browser, probably the sketch uses ESP8266WebServer::handleClient() without AutoConnect::handleRequest() . For AutoConnect menus to work properly, call AutoConnect::handleRequest() after ESP8266WebServer::handleClient() invoked, or use AutoConnect::handleClient() . AutoConnect::handleClient() is equivalent ESP8266WebServer::handleClient combined AutoConnect::handleRequest() . See also the explanation here . After updating to AutoConnect v1.0.0, established APs disappear from Open SSIDs with ESP32. \u00b6 Since AutoConnect v1.0.0 for ESP32, the storage location in the flash of established credentials has moved from EEPROM to Preferences. After You update AutoConnect to v1.0.0, past credentials saved by v0.9.12 earlier will not be accessible from the AutoConnect menu - Open SSIDs . You need to transfer once the stored credentials from the EEPROM area to the Preferences area. You can migrate the past saved credentials using CreditMigrate.ino which the examples folder contains. Needs to Arduino core for ESP32 1.0.2 or earlier EEPROM area with arduino-esp32 core 1.0.3 has moved from partition to the nvs . CreditMigrate.ino requires arduino-esp32 core 1.0.2 or earlier to migrate saved credentials. An esp8266ap as SoftAP was connected but Captive portal does not start. \u00b6 Captive portal detection could not be trapped. It is necessary to disconnect and reset ESP8266 to clear memorized connection data in ESP8266. Also, It may be displayed on the smartphone if the connection information of esp8266ap is wrong. In that case, delete the connection information of esp8266ap memorized by the smartphone once. Compile error that 'EEPROM' was not declared in this scope \u00b6 If the user sketch includes the header file as EEPROM.h , this compilation error may occur depending on the order of the #include directives. AutoConnectCredentials.h including in succession linked from AutoConnect.h defines NO_GLOBAL_EEPROM internally, so if your sketch includes EEPROM.h after AutoConnect.h , the EEPROM global variable will be lost. If you use EEPROM with your sketch, declare #include <EEPROM.h> in front of #include <AutoConnect.h> . Compile error that 'ESPhttpUpdate' was not declared in this scope \u00b6 If the user sketch includes the header file as ESP8266httpUpdate.h , this compilation error may occur depending on the order of the #include directives. AutoConnectUpdate.h including in succession linked from AutoConnect.h defines NO_GLOBAL_HTTPUPDATE internally, so if your sketch includes ESP8266httpUpdate.h after AutoConnect.h , the ESPhttpUpdate global variable will be lost. You can avoid a compile error in one of two ways: Disable an AutoConnectUpdate feature if you don't need. You can disable the AutoConnectUpdate feature by commenting out the AUTOCONNECT_USE_UPDATE macro in the AutoConnectDefs.h header file. #define AUTOCONNECT_USE_UPDATE Change the order of #include directives. With the sketch, #include <ESP8266httpUpdate.h> before #include <AutoConnect.h> . Connection lost immediately after establishment with AP \u00b6 A captive portal is disconnected immediately after the connection establishes with the new AP. This is a known problem of ESP32, and it may occur when the following conditions are satisfied at the same time. SoftAP channel on ESP32 and the connecting AP channel you specified are different. (The default channel of SoftAP is 1.) NVS had erased by erase_flash causes the connection data lost. The NVS partition has been moved. Never connected to the AP in the past. There are receivable multiple WiFi signals which are the same SSID with different channels using the WiFi repeater etc. (This condition is loose, it may occur even if there is no WiFi repeater.) Or the using channel of the AP which established a connection is congested with the radio signal on the same band. (If the channel crowd, connections to known APs may also fail.) Other possibilities The above conditions are not absolute. It results from my investigation, and other conditions may exist. To avoid this problem, try changing the channel . ESP32 hardware equips only one RF circuitry for WiFi signal. At the AP_STA mode, ESP32 as an AP attempts connect to another AP on another channel while keeping the connection with the station then the channel switching will occur causes the station may be disconnected. But it may not be just a matter of channel switching causes ESP8266 has the same constraints too. It may be a problem with AutoConnect or the arduino core or SDK issue. This problem will persist until a specific solution. Data saved to EEPROM is different from my sketch wrote. \u00b6 By default, AutoConnect saves the credentials of the established connection into EEPROM. The credential area of EEPROM used by AutoConnect will conflict with data owned by the user sketch if without measures taken. It will destroy the user sketch data and the data stored in EEPROM by AutoConnect with each other. You have the following two options to avoid this conflict: Move the credential saving area of EEPROM. You can protect your data from corruption by notifying AutoConnect where to save credentials. Notification of the save location for the credentials uses AutoConnectConfig::boundaryOffset option. Refer to the chapter on Advanced usage for details. Suppresses the automatic save operation of credentials by AutoConnect. You can completely stop saving the credentials by AutoConnect. However, if you select this option, you lose the past credentials which were able to connect to the AP. Therefore, the effect of the automatic reconnection feature will be lost. If you want to stop the automatic saving of the credentials, uses AutoConnectConfig::autoSave option specifying AC_SAVECREDENTIAL_NEVER . Refer to the chapter on Advanced usage for details. Does not appear esp8266ap in smartphone. \u00b6 Maybe it is successfully connected at the first WiFi.begin . ESP8266 remembers the last SSID successfully connected and will use at the next. It means SoftAP will only start up when the first WiFi.begin() fails. The saved SSID would be cleared by WiFi.disconnect() with WIFI_STA mode. If you do not want automatic reconnection, you can erase the memorized SSID with the following simple sketch. #include <ESP8266WiFi.h> void setup () { delay( 1000 ); Serial.begin( 115200 ); WiFi.mode(WIFI_STA); delay( 100 ); WiFi.begin(); if (WiFi.waitForConnectResult() == WL_CONNECTED) { WiFi.disconnect(); while (WiFi.status() == WL_CONNECTED) delay( 100 ); } Serial.println( \"WiFi disconnected.\" ); } void loop () { delay( 1000 ); } You can interactively check the WiFi state of ESP8266. Please try ESPShaker . It is ESP8266 interactive serial command processor. Does not response from /_ac. \u00b6 Probably WiFi.begin failed with the specified SSID. Activating the debug printing will help you to track down the cause. Hang up after Reset? \u00b6 If ESP8266 hang up after reset by AutoConnect menu, perhaps manual reset is not yet. Especially if it is not manual reset yet after uploading the sketch, the boot mode will stay 'Uart Download'. There is some discussion about this on the Github's ESP8266 core: https://github.com/esp8266/Arduino/issues/1017 1 If you received the following message, the boot mode is still sketch uploaded. It needs to the manual reset once. ets Jan 8 2013,rst cause:2, boot mode:(1,6) or (1,7) ets Jan 8 2013,rst cause:4, boot mode:(1,6) or (1,7) wdt reset The correct boot mode for starting the sketch is (3, x) . ESP8266 Boot Messages It is described by ESP8266 Non-OS SDK API Reference , section A.5. Messages Description rst cause 1: power on 2: external reset 4: hardware watchdog reset boot mode (the first parameter) 1: ESP8266 is in UART-down mode (and downloads firmware into flash). 3: ESP8266 is in Flash-boot mode (and boots up from flash). How can I detect the captive portal starting? \u00b6 You can use the AutoConnect::onDetect exit routine. For more details and an implementation example of the onDetect exit routine, refer to the chapter \" Captive portal start detection \". How change HTTP port? \u00b6 HTTP port number is defined as a macro in AutoConnectDefs.h header file. You can change it directly with several editors and must re-compile. #define AUTOCONNECT_HTTPPORT 80 How change SSID or Password in Captive portal? \u00b6 You can change both by using AutoConnectConfig::apid and AutoConnectConfig::psk . Refer to section Change SSID and Password for SoftAP in Advanced usage . How erase the credentials saved in EEPROM? \u00b6 Make some sketches for erasing the EEPROM area, or some erasing utility is needed. You can prepare the sketch to erase the saved credential with AutoConnectCredential . The AutoConnectCrendential class provides the access method to the saved credential in EEPROM and library source file is including it. Refer to ' Saved credential access ' on section Appendix for details. Hint With the ESPShaker , you can access EEPROM interactively from the serial monitor, and of course you can erase saved credentials. How locate the link button to the AutoConnect menu? \u00b6 Link button to AutoConnect menu can be embedded into Sketch's web page. The root path of the menu is /_ac by default and embed the following <a></a> tag in the generating HTML. < a style = \"background-color:SteelBlue; display:inline-block; padding:7px 13px; text-decoration:none;\" href = \"/_ac\" > MENU </ a > How much memory does AutoConnect consume? \u00b6 Sketch size \u00b6 It increases about 53K bytes compared to the case without AutoConnect. A sketch size of the most simple example introduced in the Getting started is about 330K bytes. (270K byte without AutoConnect) Heap size \u00b6 It consumes about 2K bytes in the static and about 12K bytes are consumed at the moment when menu executed. I cannot complete to Wi-Fi login from smartphone. \u00b6 Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu. I cannot see the custom Web page. \u00b6 If the sketch is correct, a JSON syntax error may have occurred. In this case, activate the AC_DEBUG and rerun. If you take the message of JSON syntax error, the Json Assistant helps syntax checking. This online tool is provided by the author of ArduinoJson and is most consistent for the AutoConnect. Saved credentials are wrong or lost. \u00b6 A structure of AutoConnect saved credentials has changed two times throughout enhancement with v1.0.3 and v1.1.0. In particular, due to enhancements in v1.1.0, AutoConnectCredential data structure has lost the backward compatibility with previous versions. You must erase the flash of the ESP module using the esptool completely to save the credentials correctly with v1.1.0. esptool -c esp8266 (or esp32) -p [COM_PORT] erase_flash Some AutoConnect page is cut off. \u00b6 It may be two possibilities as follows: Packet loss during transmission due to a too weak WiFi signal. Heap is insufficient memory. AutoConnect entrusts HTML generation to PageBuilder that makes heavy use the String::concatenate function and causes memory fragmentation. This is a structural problem with PageBuilder, but it is difficult to solve immediately. If this issue produces with your sketch, Reloading the page may recover. Also, you can check the memory running out status by rebuilding the sketch with PageBuilder's debug log option turned on. If the heap memory is insufficient, the following message is displayed on the serial console. [PB] Failed building, free heap:<Size of free heap> Submit element in a custom Web page does not react. \u00b6 Is there the AutoConnectElements element named SUBMIT in the custom Web page? (case sensitive ignored) AutoConnect does not rely on the input type=submit element for the form submission and uses HTML form element submit function instead. So, the submit function will fail if there is an element named 'submit' in the form. You can not use SUBMIT as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element. Still, not stable with my sketch. \u00b6 If AutoConnect behavior is not stable with your sketch, you can try the following measures. 1. Change WiFi channel \u00b6 Both ESP8266 and ESP32 can only work on one channel at any given moment. This will cause your station to lose connectivity on the channel hosting the captive portal. If the channel of the AP which you want to connect is different from the SoftAP channel, the operation of the captive portal will not respond with the screen of the AutoConnect connection attempt remains displayed. In such a case, please try to configure the channel with AutoConnectConfig to match the access point. AutoConnect portal; AutoConnectConfig config; config.channel = 3 ; // Specifies a channel number that matches the AP portal.config(config); // Apply channel configurration portal.begin(); // Start the portal Channel selection guide Espressif Systems has released a channel selection guide . 2. Change the arduino core version \u00b6 I recommend change installed an arduino core version to the upstream when your sketch is not stable with AutoConnect on each board. with ESP8266 arduino core \u00b6 You can select the lwIP variant to contribute for the stable behavior. The lwIP v2 Lower memory option of Arduino IDE for core version 2.4.2 is based on the lwIP-v2. On the other hand, the core version 2.5.0 upstream is based on the lwIP-2.1.2 stable release. You can select the option from Arduino IDE as Tool menu, if you are using ESP8266 core 2.5.0. It can be select lwIP v2 Lower Memory option. (not lwIP v2 Lower Memory (no features) ) It is expected to improve response performance and stability. with ESP32 arduino core \u00b6 The arduino-esp32 is still under development. It is necessary to judge whether the problem cause of the core or AutoConnect. Trace the log with the esp32 core and the AutoConnect debug option enabled for problem diagnosis and please you check the issue of arduino-esp32 . The problem that your sketch possesses may already have been solved. 3. Turn on the debug log options \u00b6 To fully enable for the AutoConnect debug logging options, change the following two files. AutoConnectDefs.h #define AC_DEBUG PageBuilder.h 2 #define PB_DEBUG 4. Reports the issue to AutoConnect Github repository \u00b6 If you can not solve AutoConnect problems please report to Issues . And please make your question comprehensively, not a statement. Include all relevant information to start the problem diagnostics as follows: 3 Hardware module Arduino core version Including the upstream commit ID if necessary Operating System which you use Your smartphone OS and version (Especially for Android) Your AP information (IP, channel) if related lwIP variant Problem description If you have a STACK DUMP decoded result with formatted by the code block tag The sketch code with formatted by the code block tag (Reduce to the reproducible minimum code for the problem) Debug messages output (Including arduino core) I will make efforts to solve as quickly as possible. But I would like you to know that it is not always possible. Thank you. This issue has been resolved in ESP8266 core 2.5.0 and later. \u21a9 PageBuilder.h exists in the libraries/PageBuilder/src directory under your sketch folder. \u21a9 Without this information, the reproducibility of the problem is reduced, making diagnosis and analysis difficult. \u21a9","title":"FAQ"},{"location":"faq.html#after-connected-autoconnect-menu-performs-but-no-happens","text":"If you can access the AutoConnect root path as http://ESP8266IPADDRESS/_ac from browser, probably the sketch uses ESP8266WebServer::handleClient() without AutoConnect::handleRequest() . For AutoConnect menus to work properly, call AutoConnect::handleRequest() after ESP8266WebServer::handleClient() invoked, or use AutoConnect::handleClient() . AutoConnect::handleClient() is equivalent ESP8266WebServer::handleClient combined AutoConnect::handleRequest() . See also the explanation here .","title":" After connected, AutoConnect menu performs but no happens."},{"location":"faq.html#after-updating-to-autoconnect-v100-established-aps-disappear-from-open-ssids-with-esp32","text":"Since AutoConnect v1.0.0 for ESP32, the storage location in the flash of established credentials has moved from EEPROM to Preferences. After You update AutoConnect to v1.0.0, past credentials saved by v0.9.12 earlier will not be accessible from the AutoConnect menu - Open SSIDs . You need to transfer once the stored credentials from the EEPROM area to the Preferences area. You can migrate the past saved credentials using CreditMigrate.ino which the examples folder contains. Needs to Arduino core for ESP32 1.0.2 or earlier EEPROM area with arduino-esp32 core 1.0.3 has moved from partition to the nvs . CreditMigrate.ino requires arduino-esp32 core 1.0.2 or earlier to migrate saved credentials.","title":" After updating to AutoConnect v1.0.0, established APs disappear from Open SSIDs with ESP32."},{"location":"faq.html#an-esp8266ap-as-softap-was-connected-but-captive-portal-does-not-start","text":"Captive portal detection could not be trapped. It is necessary to disconnect and reset ESP8266 to clear memorized connection data in ESP8266. Also, It may be displayed on the smartphone if the connection information of esp8266ap is wrong. In that case, delete the connection information of esp8266ap memorized by the smartphone once.","title":" An esp8266ap as SoftAP was connected but Captive portal does not start."},{"location":"faq.html#compile-error-that-eeprom-was-not-declared-in-this-scope","text":"If the user sketch includes the header file as EEPROM.h , this compilation error may occur depending on the order of the #include directives. AutoConnectCredentials.h including in succession linked from AutoConnect.h defines NO_GLOBAL_EEPROM internally, so if your sketch includes EEPROM.h after AutoConnect.h , the EEPROM global variable will be lost. If you use EEPROM with your sketch, declare #include <EEPROM.h> in front of #include <AutoConnect.h> .","title":" Compile error that 'EEPROM' was not declared in this scope"},{"location":"faq.html#compile-error-that-esphttpupdate-was-not-declared-in-this-scope","text":"If the user sketch includes the header file as ESP8266httpUpdate.h , this compilation error may occur depending on the order of the #include directives. AutoConnectUpdate.h including in succession linked from AutoConnect.h defines NO_GLOBAL_HTTPUPDATE internally, so if your sketch includes ESP8266httpUpdate.h after AutoConnect.h , the ESPhttpUpdate global variable will be lost. You can avoid a compile error in one of two ways: Disable an AutoConnectUpdate feature if you don't need. You can disable the AutoConnectUpdate feature by commenting out the AUTOCONNECT_USE_UPDATE macro in the AutoConnectDefs.h header file. #define AUTOCONNECT_USE_UPDATE Change the order of #include directives. With the sketch, #include <ESP8266httpUpdate.h> before #include <AutoConnect.h> .","title":" Compile error that 'ESPhttpUpdate' was not declared in this scope"},{"location":"faq.html#connection-lost-immediately-after-establishment-with-ap","text":"A captive portal is disconnected immediately after the connection establishes with the new AP. This is a known problem of ESP32, and it may occur when the following conditions are satisfied at the same time. SoftAP channel on ESP32 and the connecting AP channel you specified are different. (The default channel of SoftAP is 1.) NVS had erased by erase_flash causes the connection data lost. The NVS partition has been moved. Never connected to the AP in the past. There are receivable multiple WiFi signals which are the same SSID with different channels using the WiFi repeater etc. (This condition is loose, it may occur even if there is no WiFi repeater.) Or the using channel of the AP which established a connection is congested with the radio signal on the same band. (If the channel crowd, connections to known APs may also fail.) Other possibilities The above conditions are not absolute. It results from my investigation, and other conditions may exist. To avoid this problem, try changing the channel . ESP32 hardware equips only one RF circuitry for WiFi signal. At the AP_STA mode, ESP32 as an AP attempts connect to another AP on another channel while keeping the connection with the station then the channel switching will occur causes the station may be disconnected. But it may not be just a matter of channel switching causes ESP8266 has the same constraints too. It may be a problem with AutoConnect or the arduino core or SDK issue. This problem will persist until a specific solution.","title":" Connection lost immediately after establishment with AP"},{"location":"faq.html#data-saved-to-eeprom-is-different-from-my-sketch-wrote","text":"By default, AutoConnect saves the credentials of the established connection into EEPROM. The credential area of EEPROM used by AutoConnect will conflict with data owned by the user sketch if without measures taken. It will destroy the user sketch data and the data stored in EEPROM by AutoConnect with each other. You have the following two options to avoid this conflict: Move the credential saving area of EEPROM. You can protect your data from corruption by notifying AutoConnect where to save credentials. Notification of the save location for the credentials uses AutoConnectConfig::boundaryOffset option. Refer to the chapter on Advanced usage for details. Suppresses the automatic save operation of credentials by AutoConnect. You can completely stop saving the credentials by AutoConnect. However, if you select this option, you lose the past credentials which were able to connect to the AP. Therefore, the effect of the automatic reconnection feature will be lost. If you want to stop the automatic saving of the credentials, uses AutoConnectConfig::autoSave option specifying AC_SAVECREDENTIAL_NEVER . Refer to the chapter on Advanced usage for details.","title":" Data saved to EEPROM is different from my sketch wrote."},{"location":"faq.html#does-not-appear-esp8266ap-in-smartphone","text":"Maybe it is successfully connected at the first WiFi.begin . ESP8266 remembers the last SSID successfully connected and will use at the next. It means SoftAP will only start up when the first WiFi.begin() fails. The saved SSID would be cleared by WiFi.disconnect() with WIFI_STA mode. If you do not want automatic reconnection, you can erase the memorized SSID with the following simple sketch. #include <ESP8266WiFi.h> void setup () { delay( 1000 ); Serial.begin( 115200 ); WiFi.mode(WIFI_STA); delay( 100 ); WiFi.begin(); if (WiFi.waitForConnectResult() == WL_CONNECTED) { WiFi.disconnect(); while (WiFi.status() == WL_CONNECTED) delay( 100 ); } Serial.println( \"WiFi disconnected.\" ); } void loop () { delay( 1000 ); } You can interactively check the WiFi state of ESP8266. Please try ESPShaker . It is ESP8266 interactive serial command processor.","title":" Does not appear esp8266ap in smartphone."},{"location":"faq.html#does-not-response-from-95ac","text":"Probably WiFi.begin failed with the specified SSID. Activating the debug printing will help you to track down the cause.","title":" Does not response from /_ac."},{"location":"faq.html#hang-up-after-reset","text":"If ESP8266 hang up after reset by AutoConnect menu, perhaps manual reset is not yet. Especially if it is not manual reset yet after uploading the sketch, the boot mode will stay 'Uart Download'. There is some discussion about this on the Github's ESP8266 core: https://github.com/esp8266/Arduino/issues/1017 1 If you received the following message, the boot mode is still sketch uploaded. It needs to the manual reset once. ets Jan 8 2013,rst cause:2, boot mode:(1,6) or (1,7) ets Jan 8 2013,rst cause:4, boot mode:(1,6) or (1,7) wdt reset The correct boot mode for starting the sketch is (3, x) . ESP8266 Boot Messages It is described by ESP8266 Non-OS SDK API Reference , section A.5. Messages Description rst cause 1: power on 2: external reset 4: hardware watchdog reset boot mode (the first parameter) 1: ESP8266 is in UART-down mode (and downloads firmware into flash). 3: ESP8266 is in Flash-boot mode (and boots up from flash).","title":" Hang up after Reset?"},{"location":"faq.html#how-can-i-detect-the-captive-portal-starting","text":"You can use the AutoConnect::onDetect exit routine. For more details and an implementation example of the onDetect exit routine, refer to the chapter \" Captive portal start detection \".","title":" How can I detect the captive portal starting?"},{"location":"faq.html#how-change-http-port","text":"HTTP port number is defined as a macro in AutoConnectDefs.h header file. You can change it directly with several editors and must re-compile. #define AUTOCONNECT_HTTPPORT 80","title":" How change HTTP port?"},{"location":"faq.html#how-change-ssid-or-password-in-captive-portal","text":"You can change both by using AutoConnectConfig::apid and AutoConnectConfig::psk . Refer to section Change SSID and Password for SoftAP in Advanced usage .","title":" How change SSID or Password in Captive portal?"},{"location":"faq.html#how-erase-the-credentials-saved-in-eeprom","text":"Make some sketches for erasing the EEPROM area, or some erasing utility is needed. You can prepare the sketch to erase the saved credential with AutoConnectCredential . The AutoConnectCrendential class provides the access method to the saved credential in EEPROM and library source file is including it. Refer to ' Saved credential access ' on section Appendix for details. Hint With the ESPShaker , you can access EEPROM interactively from the serial monitor, and of course you can erase saved credentials.","title":" How erase the credentials saved in EEPROM?"},{"location":"faq.html#how-locate-the-link-button-to-the-autoconnect-menu","text":"Link button to AutoConnect menu can be embedded into Sketch's web page. The root path of the menu is /_ac by default and embed the following <a></a> tag in the generating HTML. < a style = \"background-color:SteelBlue; display:inline-block; padding:7px 13px; text-decoration:none;\" href = \"/_ac\" > MENU </ a >","title":" How locate the link button to the  AutoConnect menu?"},{"location":"faq.html#how-much-memory-does-autoconnect-consume","text":"","title":" How much memory does AutoConnect consume?"},{"location":"faq.html#sketch-size","text":"It increases about 53K bytes compared to the case without AutoConnect. A sketch size of the most simple example introduced in the Getting started is about 330K bytes. (270K byte without AutoConnect)","title":"Sketch size"},{"location":"faq.html#heap-size","text":"It consumes about 2K bytes in the static and about 12K bytes are consumed at the moment when menu executed.","title":"Heap size"},{"location":"faq.html#i-cannot-complete-to-wi-fi-login-from-smartphone","text":"Because AutoConnect does not send a login success response to the captive portal requests from the smartphone. The login success response varies iOS, Android and Windows. By analyzing the request URL of different login success inquiries for each OS, the correct behavior can be implemented, but not yet. Please resets ESP8266 from the AutoConnect menu.","title":" I cannot complete to Wi-Fi login from smartphone."},{"location":"faq.html#i-cannot-see-the-custom-web-page","text":"If the sketch is correct, a JSON syntax error may have occurred. In this case, activate the AC_DEBUG and rerun. If you take the message of JSON syntax error, the Json Assistant helps syntax checking. This online tool is provided by the author of ArduinoJson and is most consistent for the AutoConnect.","title":" I cannot see the custom Web page."},{"location":"faq.html#saved-credentials-are-wrong-or-lost","text":"A structure of AutoConnect saved credentials has changed two times throughout enhancement with v1.0.3 and v1.1.0. In particular, due to enhancements in v1.1.0, AutoConnectCredential data structure has lost the backward compatibility with previous versions. You must erase the flash of the ESP module using the esptool completely to save the credentials correctly with v1.1.0. esptool -c esp8266 (or esp32) -p [COM_PORT] erase_flash","title":" Saved credentials are wrong or lost."},{"location":"faq.html#some-autoconnect-page-is-cut-off","text":"It may be two possibilities as follows: Packet loss during transmission due to a too weak WiFi signal. Heap is insufficient memory. AutoConnect entrusts HTML generation to PageBuilder that makes heavy use the String::concatenate function and causes memory fragmentation. This is a structural problem with PageBuilder, but it is difficult to solve immediately. If this issue produces with your sketch, Reloading the page may recover. Also, you can check the memory running out status by rebuilding the sketch with PageBuilder's debug log option turned on. If the heap memory is insufficient, the following message is displayed on the serial console. [PB] Failed building, free heap:<Size of free heap>","title":" Some AutoConnect page is cut off."},{"location":"faq.html#submit-element-in-a-custom-web-page-does-not-react","text":"Is there the AutoConnectElements element named SUBMIT in the custom Web page? (case sensitive ignored) AutoConnect does not rely on the input type=submit element for the form submission and uses HTML form element submit function instead. So, the submit function will fail if there is an element named 'submit' in the form. You can not use SUBMIT as the element name of AutoConnectElements in a custom Web page that declares the AutoConnectSubmit element.","title":" Submit element in a custom Web page does not react."},{"location":"faq.html#still-not-stable-with-my-sketch","text":"If AutoConnect behavior is not stable with your sketch, you can try the following measures.","title":" Still, not stable with my sketch."},{"location":"faq.html#1-change-wifi-channel","text":"Both ESP8266 and ESP32 can only work on one channel at any given moment. This will cause your station to lose connectivity on the channel hosting the captive portal. If the channel of the AP which you want to connect is different from the SoftAP channel, the operation of the captive portal will not respond with the screen of the AutoConnect connection attempt remains displayed. In such a case, please try to configure the channel with AutoConnectConfig to match the access point. AutoConnect portal; AutoConnectConfig config; config.channel = 3 ; // Specifies a channel number that matches the AP portal.config(config); // Apply channel configurration portal.begin(); // Start the portal Channel selection guide Espressif Systems has released a channel selection guide .","title":"1. Change WiFi channel"},{"location":"faq.html#2-change-the-arduino-core-version","text":"I recommend change installed an arduino core version to the upstream when your sketch is not stable with AutoConnect on each board.","title":"2. Change the arduino core version"},{"location":"faq.html#with-esp8266-arduino-core","text":"You can select the lwIP variant to contribute for the stable behavior. The lwIP v2 Lower memory option of Arduino IDE for core version 2.4.2 is based on the lwIP-v2. On the other hand, the core version 2.5.0 upstream is based on the lwIP-2.1.2 stable release. You can select the option from Arduino IDE as Tool menu, if you are using ESP8266 core 2.5.0. It can be select lwIP v2 Lower Memory option. (not lwIP v2 Lower Memory (no features) ) It is expected to improve response performance and stability.","title":"with ESP8266 arduino core"},{"location":"faq.html#with-esp32-arduino-core","text":"The arduino-esp32 is still under development. It is necessary to judge whether the problem cause of the core or AutoConnect. Trace the log with the esp32 core and the AutoConnect debug option enabled for problem diagnosis and please you check the issue of arduino-esp32 . The problem that your sketch possesses may already have been solved.","title":"with ESP32 arduino core"},{"location":"faq.html#3-turn-on-the-debug-log-options","text":"To fully enable for the AutoConnect debug logging options, change the following two files. AutoConnectDefs.h #define AC_DEBUG PageBuilder.h 2 #define PB_DEBUG","title":"3. Turn on the debug log options"},{"location":"faq.html#4-reports-the-issue-to-autoconnect-github-repository","text":"If you can not solve AutoConnect problems please report to Issues . And please make your question comprehensively, not a statement. Include all relevant information to start the problem diagnostics as follows: 3 Hardware module Arduino core version Including the upstream commit ID if necessary Operating System which you use Your smartphone OS and version (Especially for Android) Your AP information (IP, channel) if related lwIP variant Problem description If you have a STACK DUMP decoded result with formatted by the code block tag The sketch code with formatted by the code block tag (Reduce to the reproducible minimum code for the problem) Debug messages output (Including arduino core) I will make efforts to solve as quickly as possible. But I would like you to know that it is not always possible. Thank you. This issue has been resolved in ESP8266 core 2.5.0 and later. \u21a9 PageBuilder.h exists in the libraries/PageBuilder/src directory under your sketch folder. \u21a9 Without this information, the reproducibility of the problem is reduced, making diagnosis and analysis difficult. \u21a9","title":"4. Reports the issue to AutoConnect Github repository"},{"location":"gettingstarted.html","text":"Let's do the most simple sketch \u00b6 Open the Arduino IDE, write the following sketch and upload it. The feature of this sketch is that the SSID and Password are not coded. #include <ESP8266WiFi.h> // Replace with WiFi.h for ESP32 #include <ESP8266WebServer.h> // Replace with WebServer.h for ESP32 #include <AutoConnect.h> ESP8266WebServer Server; // Replace with WebServer for ESP32 AutoConnect Portal (Server); void rootPage () { char content[] = \"Hello, world\" ; Server.send( 200 , \"text/plain\" , content); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); Server.on( \"/\" , rootPage); if (Portal.begin()) { Serial.println( \"WiFi connected: \" + WiFi.localIP().toString()); } } void loop () { Portal.handleClient(); } The above code can be applied to ESP8266. To apply to ESP32, replace ESP8266WebServer class with WebServer and include WiFi.h and WebServer.h of arduino-esp32 appropriately. Run at first \u00b6 After about 30 seconds, if the ESP8266 cannot connect to nearby Wi-Fi spot, you pull out your smartphone and open Wi-Fi settings from the Settings Apps. You can see the esp8266ap 1 in the list of \"CHOOSE A NETWORK...\" . Then tap the esp8266ap and enter password 12345678 , a something screen pops up automatically as shown below. This is the AutoConnect statistics screen. This screen displays the current status of the established connection, WiFi mode, IP address, free memory size, and etc. Also, the hamburger icon is the control menu of AutoConnect seems at the upper right. By tap the hamburger icon, the control menu appears as the below. Join to the new access point \u00b6 Here, tap \"Configure new AP\" to connect the new access point then the SSID configuration screen would be shown. Enter the SSID and Passphrase and tap apply to start connecting the access point. Can be configured with static IP Since v1.1.0, Configure new AP menu can configure for WIFI_STA with static IP. Connection establishment \u00b6 After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI_AP_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step. For one, continues execution of the sketch while keeping this connection. You can access ESP8266 via browser through the established IP address after cancel to \" Log in \" by upper right on the screen. Or, \" RESET \" can be selected. The ESP8266 resets and reboots. After that, immediately before the connection will be restored automatically with WIFI_STA mode. Run for usually \u00b6 The IP address of ESP8266 would be displayed on the serial monitor after connection restored. Please access its address from the browser. The \"Hello, world\" page will respond. It's the page that was handled by in the sketch with \" on \" function of ESP8266WebServer . window.onload = function() { Gifffer(); }; When applied to ESP32, SSID will appear as esp32ap . \u21a9","title":"Getting started"},{"location":"gettingstarted.html#lets-do-the-most-simple-sketch","text":"Open the Arduino IDE, write the following sketch and upload it. The feature of this sketch is that the SSID and Password are not coded. #include <ESP8266WiFi.h> // Replace with WiFi.h for ESP32 #include <ESP8266WebServer.h> // Replace with WebServer.h for ESP32 #include <AutoConnect.h> ESP8266WebServer Server; // Replace with WebServer for ESP32 AutoConnect Portal (Server); void rootPage () { char content[] = \"Hello, world\" ; Server.send( 200 , \"text/plain\" , content); } void setup () { delay( 1000 ); Serial.begin( 115200 ); Serial.println(); Server.on( \"/\" , rootPage); if (Portal.begin()) { Serial.println( \"WiFi connected: \" + WiFi.localIP().toString()); } } void loop () { Portal.handleClient(); } The above code can be applied to ESP8266. To apply to ESP32, replace ESP8266WebServer class with WebServer and include WiFi.h and WebServer.h of arduino-esp32 appropriately.","title":"Let's do the most simple sketch"},{"location":"gettingstarted.html#run-at-first","text":"After about 30 seconds, if the ESP8266 cannot connect to nearby Wi-Fi spot, you pull out your smartphone and open Wi-Fi settings from the Settings Apps. You can see the esp8266ap 1 in the list of \"CHOOSE A NETWORK...\" . Then tap the esp8266ap and enter password 12345678 , a something screen pops up automatically as shown below. This is the AutoConnect statistics screen. This screen displays the current status of the established connection, WiFi mode, IP address, free memory size, and etc. Also, the hamburger icon is the control menu of AutoConnect seems at the upper right. By tap the hamburger icon, the control menu appears as the below.","title":" Run at first"},{"location":"gettingstarted.html#join-to-the-new-access-point","text":"Here, tap \"Configure new AP\" to connect the new access point then the SSID configuration screen would be shown. Enter the SSID and Passphrase and tap apply to start connecting the access point. Can be configured with static IP Since v1.1.0, Configure new AP menu can configure for WIFI_STA with static IP.","title":" Join to the new access point"},{"location":"gettingstarted.html#connection-establishment","text":"After connection established, the current status screen will appear. It is already connected to WLAN with WiFi mode as WIFI_AP_STA and the IP connection status is displayed there including the SSID. Then at this screen, you have two options for the next step. For one, continues execution of the sketch while keeping this connection. You can access ESP8266 via browser through the established IP address after cancel to \" Log in \" by upper right on the screen. Or, \" RESET \" can be selected. The ESP8266 resets and reboots. After that, immediately before the connection will be restored automatically with WIFI_STA mode.","title":" Connection establishment"},{"location":"gettingstarted.html#run-for-usually","text":"The IP address of ESP8266 would be displayed on the serial monitor after connection restored. Please access its address from the browser. The \"Hello, world\" page will respond. It's the page that was handled by in the sketch with \" on \" function of ESP8266WebServer . window.onload = function() { Gifffer(); }; When applied to ESP32, SSID will appear as esp32ap . \u21a9","title":" Run for usually"},{"location":"howtoembed.html","text":"Embed the AutoConnect to the sketch \u00b6 Here hold two case examples. Both examples perform the same function. Only how to incorporate the AutoConnect into the sketch differs. Also included in the sample folder, HandlePortal.ino also shows how to use the PageBuilder library for HTML assemblies. What does this example do? \u00b6 Uses the web interface to light the LED connected to the D0 (sometimes called BUILTIN_LED ) port of the NodeMCU module like the following animation. Access to the ESP8266 module connected WiFi from the browser then the page contains the current value of the D0 port would be displayed. The page has the buttons to switch the port value. The LED will blink according to the value with clicked by the button. This example is a typical sketch of manipulating ESP8266's GPIO via WLAN. Embed AutoConnect library into this sketch. There are few places to be changed. And you can use AutoConnect's captive portal function to establish a connection freely to other WiFi spots. Embed AutoConnect \u00b6 Pattern A. \u00b6 Bind to ESP8266WebServer, performs handleClient with handleRequest. In what situations should the handleRequest be used. It is something needs to be done immediately after the handle client. It is better to call only AutoConnect::handleClient whenever possible. Pattern B. \u00b6 Declare only AutoConnect, performs handleClient. Used with MQTT as a client application \u00b6 The effect of AutoConnect is not only for ESP8266/ESP32 as the web server. It has advantages for something WiFi client as well. For example, AutoConnect is also convenient for publishing MQTT messages from various measurement points. Even if the SSID is different for each measurement point, it is not necessary to modify the sketch. This example tries to publish the WiFi signal strength of ESP8266 with MQTT. It uses the ThingSpeak for MQTT broker. ESP8266 publishes the RSSI value to the channel created on ThingSpeak as MQTT client . This example is well suited to demonstrate the usefulness of AutoConnect, as RSSI values are measured at each access point usually. Just adding a few lines of code makes it unnecessary to upload sketches with the different SSIDs rewrite for each access point. Advance procedures \u00b6 Arduino Client for MQTT - It's the PubSubClient , install it to Arduino IDE. If you have the latest version already, this step does not need. Create a channel on ThingSpeak. Get the Channel API Keys from ThingSpeak, put its keys to the sketch. The ThingSpeak is the open IoT platform. It is capable of sending data privately to the cloud and analyzing, visualizing its data. If you do not have an account of ThingSpeak, you need that account to proceed further. ThingSpeak has the free plan for the account which uses within the scope of this example. 1 You can sign up with the ThingSpeak sign-up page . Whether you should do sign-up or not. You are entrusted with the final judgment of account creation for ThingSpeak. Create an account at your own risk. Create a channel on ThingSpeak \u00b6 Sign in ThingSpeak. Select Channels to show the My Channels , then click New Channel . At the New Channel screen, enter each field as a below. And click Save Channel at the bottom of the screen to save. Name: ESP8266 Signal Strength Description: ESP8266 RSSI publish Field1: RSSI Get Channel ID and API Keys \u00b6 The channel successfully created, you can see the channel status screen as a below. Channel ID is displayed there. 2 Here, switch the channel status tab to API Keys . The API key required to publish the message is the Write API Key . The last key you need is the User API Key and can be confirmed it in the user profile. Pull down Account from the top menu, select My profile . Then you can see the ThingSpeak settings and the User API Key is displayed middle of this screen. The sketch, Publishes messages \u00b6 The complete code of the sketch is mqttRSSI.ino in the AutoConnect repository . Replace the following #define in a sketch with User API Key , Write API Key and Channel ID . After Keys updated, compile the sketch and upload it. #define MQTT_USER_KEY \"****************\" // Replace to User API Key. #define CHANNEL_ID \"******\" // Replace to Channel ID. #define CHANNEL_API_KEY_WR \"****************\" // Replace to the write API Key. Publish messages \u00b6 After upload and reboot complete, the message publishing will start via the access point now set. The message carries RSSI as the current WiFi signal strength. The signal strength variations in RSSI are displayed on ThingSpeak's Channel status screen. How embed to your sketches \u00b6 For the client sketches, the code required to connect to WiFi is the following four parts only. #include directive 3 Include AutoConnect.h header file behind the include of ESP8266WiFi.h . Declare AutoConnect The declaration of the AutoConnect variable is not accompanied by ESP8266WebServer. Invokes \"begin()\" Call AutoConnect::begin . If you need to assign a static IP address, executes AutoConnectConfig before that. Performs \"handleClent()\" in \"loop()\" Invokes AutoConnect::handleClient() at inside loop() to enable the AutoConnect menu. window.onload = function() { Gifffer(); }; As of March 21, 2018. \u21a9 '454951' in the example above, but your channel ID should be different. \u21a9 #include <ESP8266WebServer.h> does not necessary for uses only client. \u21a9","title":"How to embed"},{"location":"howtoembed.html#embed-the-autoconnect-to-the-sketch","text":"Here hold two case examples. Both examples perform the same function. Only how to incorporate the AutoConnect into the sketch differs. Also included in the sample folder, HandlePortal.ino also shows how to use the PageBuilder library for HTML assemblies.","title":"Embed the AutoConnect to the sketch"},{"location":"howtoembed.html#what-does-this-example-do","text":"Uses the web interface to light the LED connected to the D0 (sometimes called BUILTIN_LED ) port of the NodeMCU module like the following animation. Access to the ESP8266 module connected WiFi from the browser then the page contains the current value of the D0 port would be displayed. The page has the buttons to switch the port value. The LED will blink according to the value with clicked by the button. This example is a typical sketch of manipulating ESP8266's GPIO via WLAN. Embed AutoConnect library into this sketch. There are few places to be changed. And you can use AutoConnect's captive portal function to establish a connection freely to other WiFi spots.","title":"What does this example do?"},{"location":"howtoembed.html#embed-autoconnect","text":"","title":"Embed AutoConnect"},{"location":"howtoembed.html#pattern-a","text":"Bind to ESP8266WebServer, performs handleClient with handleRequest. In what situations should the handleRequest be used. It is something needs to be done immediately after the handle client. It is better to call only AutoConnect::handleClient whenever possible.","title":" Pattern A."},{"location":"howtoembed.html#pattern-b","text":"Declare only AutoConnect, performs handleClient.","title":" Pattern B."},{"location":"howtoembed.html#used-with-mqtt-as-a-client-application","text":"The effect of AutoConnect is not only for ESP8266/ESP32 as the web server. It has advantages for something WiFi client as well. For example, AutoConnect is also convenient for publishing MQTT messages from various measurement points. Even if the SSID is different for each measurement point, it is not necessary to modify the sketch. This example tries to publish the WiFi signal strength of ESP8266 with MQTT. It uses the ThingSpeak for MQTT broker. ESP8266 publishes the RSSI value to the channel created on ThingSpeak as MQTT client . This example is well suited to demonstrate the usefulness of AutoConnect, as RSSI values are measured at each access point usually. Just adding a few lines of code makes it unnecessary to upload sketches with the different SSIDs rewrite for each access point.","title":"Used with MQTT as a client application"},{"location":"howtoembed.html#advance-procedures","text":"Arduino Client for MQTT - It's the PubSubClient , install it to Arduino IDE. If you have the latest version already, this step does not need. Create a channel on ThingSpeak. Get the Channel API Keys from ThingSpeak, put its keys to the sketch. The ThingSpeak is the open IoT platform. It is capable of sending data privately to the cloud and analyzing, visualizing its data. If you do not have an account of ThingSpeak, you need that account to proceed further. ThingSpeak has the free plan for the account which uses within the scope of this example. 1 You can sign up with the ThingSpeak sign-up page . Whether you should do sign-up or not. You are entrusted with the final judgment of account creation for ThingSpeak. Create an account at your own risk.","title":"Advance procedures"},{"location":"howtoembed.html#create-a-channel-on-thingspeak","text":"Sign in ThingSpeak. Select Channels to show the My Channels , then click New Channel . At the New Channel screen, enter each field as a below. And click Save Channel at the bottom of the screen to save. Name: ESP8266 Signal Strength Description: ESP8266 RSSI publish Field1: RSSI","title":"Create a channel on ThingSpeak"},{"location":"howtoembed.html#get-channel-id-and-api-keys","text":"The channel successfully created, you can see the channel status screen as a below. Channel ID is displayed there. 2 Here, switch the channel status tab to API Keys . The API key required to publish the message is the Write API Key . The last key you need is the User API Key and can be confirmed it in the user profile. Pull down Account from the top menu, select My profile . Then you can see the ThingSpeak settings and the User API Key is displayed middle of this screen.","title":"Get Channel ID and API Keys"},{"location":"howtoembed.html#the-sketch-publishes-messages","text":"The complete code of the sketch is mqttRSSI.ino in the AutoConnect repository . Replace the following #define in a sketch with User API Key , Write API Key and Channel ID . After Keys updated, compile the sketch and upload it. #define MQTT_USER_KEY \"****************\" // Replace to User API Key. #define CHANNEL_ID \"******\" // Replace to Channel ID. #define CHANNEL_API_KEY_WR \"****************\" // Replace to the write API Key.","title":"The sketch, Publishes messages"},{"location":"howtoembed.html#publish-messages","text":"After upload and reboot complete, the message publishing will start via the access point now set. The message carries RSSI as the current WiFi signal strength. The signal strength variations in RSSI are displayed on ThingSpeak's Channel status screen.","title":"Publish messages"},{"location":"howtoembed.html#how-embed-to-your-sketches","text":"For the client sketches, the code required to connect to WiFi is the following four parts only. #include directive 3 Include AutoConnect.h header file behind the include of ESP8266WiFi.h . Declare AutoConnect The declaration of the AutoConnect variable is not accompanied by ESP8266WebServer. Invokes \"begin()\" Call AutoConnect::begin . If you need to assign a static IP address, executes AutoConnectConfig before that. Performs \"handleClent()\" in \"loop()\" Invokes AutoConnect::handleClient() at inside loop() to enable the AutoConnect menu. window.onload = function() { Gifffer(); }; As of March 21, 2018. \u21a9 '454951' in the example above, but your channel ID should be different. \u21a9 #include <ESP8266WebServer.h> does not necessary for uses only client. \u21a9","title":"How embed to your sketches"},{"location":"license.html","text":"MIT License Copyright \u00a9 2018-2019 Hieromon Ikasamo Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Acknowledgments Each of the following libraries used by AutoConnect is under its license: The Luxbar is licensed under the MIT License. https://github.com/balzss/luxbar ArduinoJson is licensed under the MIT License. https://arduinojson.org/","title":"License"},{"location":"lsbegin.html","text":"AutoConnect::begin logic sequence \u00b6 Several parameters as follows of AutoConnectConfig affect the behavior of AutoConnect::begin function. Each parameter affects the behaves in interacted order with the priority and apply to the logic sequence of AutoConnect::begin . immediateStart : The captive portal start immediately, without first WiFi.begin. autoReconenct : Attempt re-connect with past SSID by saved credential. portalTimeout : Time out limit for the portal. retainPortal : Keep DNS server functioning for the captive portal. You can use these parameters in combination with sketch requirements and need to understand correctly the behavior caused by the parameters. The following chart shows the AutoConnect::begin logic sequence including the effect of these parameters. For example, AutoConnect::begin will not exits without the portalTimeout while the connection not establishes, but WebServer will start to work. A DNS server that detects the probe of the captive portal is also effective. So, your sketch may work seemingly, but it will close with inside a loop of the AutoConnect::begin function. Especially when invoking AutoConnect::begin in the setup() , execution control does not pass to the loop() . As different scenes, you may use the immediateStart effectively. Equipped the external switch to activate the captive portal with the ESP module, combined with the portalTime and the retainPortal it will become WiFi active connection feature. You can start AutoConnect::begin at any point in the loop() , which allows your sketch can behave both the offline mode and the online mode. The retainPortal option allows the DNS server to continue operation after exiting from AutoConnect::begin . AutoConnect traps captive portal detection from the client and redirects it to the AutoConnect menu. That trap will answer all unresolved addresses with SoftAP's IP address. If the URI handler for the source request is undefined, it returns a 302 response with SoftAPIP/_ac to the client. This is the mechanism of AutoConnect's captive portal. Captive portal probes will frequently occur while you are attempting on the client device's WiFi connection Apps and these implementations are varied each OS, so it not realistic to identify all probing URIs. Therefore, while retainPortal is enabled, it is not preferable to executing the sketch under the WiFi connection Apps on the client device. (Probably not work correctly) You need to exit from the WiFi connection Apps once. Please consider these kinds of influence when you make sketches. The AutoConnect::begin 3 rd parameter Another parameter as the 3 rd parameter of AutoConnect::begin related to timeout constrains the connection wait time after WiFi.begin. It is the CONNECTED judgment of the above chart that it has an effect.","title":"Inside AutoConnect::begin"},{"location":"lsbegin.html#autoconnectbegin-logic-sequence","text":"Several parameters as follows of AutoConnectConfig affect the behavior of AutoConnect::begin function. Each parameter affects the behaves in interacted order with the priority and apply to the logic sequence of AutoConnect::begin . immediateStart : The captive portal start immediately, without first WiFi.begin. autoReconenct : Attempt re-connect with past SSID by saved credential. portalTimeout : Time out limit for the portal. retainPortal : Keep DNS server functioning for the captive portal. You can use these parameters in combination with sketch requirements and need to understand correctly the behavior caused by the parameters. The following chart shows the AutoConnect::begin logic sequence including the effect of these parameters. For example, AutoConnect::begin will not exits without the portalTimeout while the connection not establishes, but WebServer will start to work. A DNS server that detects the probe of the captive portal is also effective. So, your sketch may work seemingly, but it will close with inside a loop of the AutoConnect::begin function. Especially when invoking AutoConnect::begin in the setup() , execution control does not pass to the loop() . As different scenes, you may use the immediateStart effectively. Equipped the external switch to activate the captive portal with the ESP module, combined with the portalTime and the retainPortal it will become WiFi active connection feature. You can start AutoConnect::begin at any point in the loop() , which allows your sketch can behave both the offline mode and the online mode. The retainPortal option allows the DNS server to continue operation after exiting from AutoConnect::begin . AutoConnect traps captive portal detection from the client and redirects it to the AutoConnect menu. That trap will answer all unresolved addresses with SoftAP's IP address. If the URI handler for the source request is undefined, it returns a 302 response with SoftAPIP/_ac to the client. This is the mechanism of AutoConnect's captive portal. Captive portal probes will frequently occur while you are attempting on the client device's WiFi connection Apps and these implementations are varied each OS, so it not realistic to identify all probing URIs. Therefore, while retainPortal is enabled, it is not preferable to executing the sketch under the WiFi connection Apps on the client device. (Probably not work correctly) You need to exit from the WiFi connection Apps once. Please consider these kinds of influence when you make sketches. The AutoConnect::begin 3 rd parameter Another parameter as the 3 rd parameter of AutoConnect::begin related to timeout constrains the connection wait time after WiFi.begin. It is the CONNECTED judgment of the above chart that it has an effect.","title":"AutoConnect::begin logic sequence"},{"location":"menu.html","text":"Luxbar The AutoConnect menu is developed using the LuxBar which is licensed under the MIT License. See the License . Where the from \u00b6 The following screen will appear as the AutoConnect menu when you access to AutoConnect root URL via http://{localIP}/_ac . (eg. http://172.217.28.1/_ac ) It is a top page of AutoConnect which shows the current WiFi connection statistics. To invoke the AutoConnect menu, you can t tap at right on top. AutoConnect root URL It is assigned \" /_ac \" located on the local IP address of ESP8266/ESP32 module by default and can be changed with the sketch. A local IP means Local IP at connection established or SoftAP's IP. Right on top \u00b6 Currently, AutoConnect supports four menus. Undermost menu as \"HOME\" returns to the home path of its sketch. Configure new AP : Configure SSID and Password for new access point. Open SSIDs : Opens the past SSID which has been established connection from the flash. Disconnect : Disconnects current connection. Reset... : Rest the ESP8266/ESP32 module. HOME : Return to user home page. Configure new AP \u00b6 It scans all available access points in the vicinity and display it further the WiFi signal strength and security indicator as of the detected AP. Below that, the number of discovered hidden APs will be displayed. Enter SSID and Passphrase and tap \" Apply \" to start a WiFi connection. If you want to configure with static IP, uncheck \" Enable DHCP \". Once the WiFi connection is established, the entered static IP 1 configuration will be stored to the credentials in the flash and restored to the station configuration via the Open SSIDs menu. Open SSIDs \u00b6 After WiFi connected, AutoConnect will automatically save the established SSID and password to the flash on the ESP module. Open SSIDs menu reads the saved SSID credentials and lists them as below. Listed items are clickable buttons and can initiate a connection to its access point. Saved credentials data structure has changed A structure of AutoConnect saved credentials has changed in v1.1.0 and was lost backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not display properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading. esptool -c esp8266 (or esp32) - p [COM_PORT] erase_flash Disconnect \u00b6 It disconnects ESP8266/ESP32 from the current connection. Also, ESP8266/ESP32 can be automatically reset after WiFi cutting by instructing with the sketch using the AutoConnect API . After tapping the Disconnect , you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting to the WLAN. Reset... \u00b6 Resetting the ESP8266/ESP32 module will initiate a reboot. When the module restarting, the esp8266ap or esp32ap access point will disappear from the WLAN and the ESP8266/ESP32 module will begin to reconnect a previous access point with WIFI_STA mode. Not every ESP8266 module will be rebooted normally The Reset menu is using the ESP.reset() function for ESP8266. This is an almost hardware reset. In order to resume the sketch normally, the state of GPIO0 is important. Since this depends on the circuit implementation for each module, not every module will be rebooted normally. See also FAQ . Custom menu items \u00b6 If the sketch has custom Web pages, the AutoConnect menu lines them up with the AutoConnect's items. Details for Custom Web pages in AutoConnect menu . HOME \u00b6 A HOME item at the bottom of the menu list is a link to the home path, and the default URI is / which is defined by AUTOCONNECT_HOMEURI in AutoConnectDefs.h header file. #define AUTOCONNECT_HOMEURI \"/\" Also, you can change the HOME path using the AutoConnect API. The AutoConnect::home function sets the URI as a link of the HOME item in the AutoConnect menu. Attaching to AutoConnect menu \u00b6 The AutoConnect menu can contain your sketch's web pages as extra items as a custom. It works for HTML pages implemented by the ESP8266WebServer::on handler or the WebServer::on handler for ESP32. That is, you can make them invoke the legacy web pages from the AutoConnect menu. The below screen-shot is the result of adding an example sketch for the ESP8266WebServer library known as FSBrowser to the AutoConnect menu item. It can add Edit and List items with little modification to the legacy sketch code. You can improve your sketches by extending the AutoConnect menu by adding the legacy web pages according to the procedure described in section Advanced Usage . AutoConnect does not check the syntax and validity of the entered IP address. If the entered static IPs are incorrect, it cannot connect to the access point. \u21a9","title":"AutoConnect menu"},{"location":"menu.html#where-the-from","text":"The following screen will appear as the AutoConnect menu when you access to AutoConnect root URL via http://{localIP}/_ac . (eg. http://172.217.28.1/_ac ) It is a top page of AutoConnect which shows the current WiFi connection statistics. To invoke the AutoConnect menu, you can t tap at right on top. AutoConnect root URL It is assigned \" /_ac \" located on the local IP address of ESP8266/ESP32 module by default and can be changed with the sketch. A local IP means Local IP at connection established or SoftAP's IP.","title":" Where the from"},{"location":"menu.html#right-on-top","text":"Currently, AutoConnect supports four menus. Undermost menu as \"HOME\" returns to the home path of its sketch. Configure new AP : Configure SSID and Password for new access point. Open SSIDs : Opens the past SSID which has been established connection from the flash. Disconnect : Disconnects current connection. Reset... : Rest the ESP8266/ESP32 module. HOME : Return to user home page.","title":" Right on top"},{"location":"menu.html#configure-new-ap","text":"It scans all available access points in the vicinity and display it further the WiFi signal strength and security indicator as of the detected AP. Below that, the number of discovered hidden APs will be displayed. Enter SSID and Passphrase and tap \" Apply \" to start a WiFi connection. If you want to configure with static IP, uncheck \" Enable DHCP \". Once the WiFi connection is established, the entered static IP 1 configuration will be stored to the credentials in the flash and restored to the station configuration via the Open SSIDs menu.","title":" Configure new AP"},{"location":"menu.html#open-ssids","text":"After WiFi connected, AutoConnect will automatically save the established SSID and password to the flash on the ESP module. Open SSIDs menu reads the saved SSID credentials and lists them as below. Listed items are clickable buttons and can initiate a connection to its access point. Saved credentials data structure has changed A structure of AutoConnect saved credentials has changed in v1.1.0 and was lost backward compatibility. Credentials saved by AutoConnect v1.0.3 (or earlier) will not display properly with AutoConnect v1.1.0. You need to erase the flash of the ESP module using the esptool before the sketch uploading. esptool -c esp8266 (or esp32) - p [COM_PORT] erase_flash","title":" Open SSIDs"},{"location":"menu.html#disconnect","text":"It disconnects ESP8266/ESP32 from the current connection. Also, ESP8266/ESP32 can be automatically reset after WiFi cutting by instructing with the sketch using the AutoConnect API . After tapping the Disconnect , you will not be able to reach the AutoConnect menu. Once disconnected, you will need to set the SSID again for connecting to the WLAN.","title":" Disconnect"},{"location":"menu.html#reset","text":"Resetting the ESP8266/ESP32 module will initiate a reboot. When the module restarting, the esp8266ap or esp32ap access point will disappear from the WLAN and the ESP8266/ESP32 module will begin to reconnect a previous access point with WIFI_STA mode. Not every ESP8266 module will be rebooted normally The Reset menu is using the ESP.reset() function for ESP8266. This is an almost hardware reset. In order to resume the sketch normally, the state of GPIO0 is important. Since this depends on the circuit implementation for each module, not every module will be rebooted normally. See also FAQ .","title":" Reset..."},{"location":"menu.html#custom-menu-items","text":"If the sketch has custom Web pages, the AutoConnect menu lines them up with the AutoConnect's items. Details for Custom Web pages in AutoConnect menu .","title":" Custom menu items"},{"location":"menu.html#home","text":"A HOME item at the bottom of the menu list is a link to the home path, and the default URI is / which is defined by AUTOCONNECT_HOMEURI in AutoConnectDefs.h header file. #define AUTOCONNECT_HOMEURI \"/\" Also, you can change the HOME path using the AutoConnect API. The AutoConnect::home function sets the URI as a link of the HOME item in the AutoConnect menu.","title":" HOME"},{"location":"menu.html#attaching-to-autoconnect-menu","text":"The AutoConnect menu can contain your sketch's web pages as extra items as a custom. It works for HTML pages implemented by the ESP8266WebServer::on handler or the WebServer::on handler for ESP32. That is, you can make them invoke the legacy web pages from the AutoConnect menu. The below screen-shot is the result of adding an example sketch for the ESP8266WebServer library known as FSBrowser to the AutoConnect menu item. It can add Edit and List items with little modification to the legacy sketch code. You can improve your sketches by extending the AutoConnect menu by adding the legacy web pages according to the procedure described in section Advanced Usage . AutoConnect does not check the syntax and validity of the entered IP address. If the entered static IPs are incorrect, it cannot connect to the access point. \u21a9","title":" Attaching to AutoConnect menu"},{"location":"menuize.html","text":"What menus can be made using AutoConnect \u00b6 AutoConnect generates a menu dynamically depending on the instantiated AutoConnectAux at the sketch executing time. Usually, it is a collection of AutoConnectElement . In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. In other words, you can easily create a built-in menu featuring the WiFi connection facility embedding the legacy web pages. Basic mechanism of menu generation \u00b6 The sketch can display the AutoConnect menu by following three patterns depending on AutoConnect-API usage. \u2002 Basic menu It is the most basic menu for only connecting WiFi. Sketch can automatically display this menu with the basic call sequence of the AutoConnect API which invokes AutoConnect::begin and AutoConnect::handleClient . \u2002 Extra menu with custom Web pages which is consisted by AutoConnectElements It is an extended menu that appears when the sketch consists of the custom Web pages with AutoConnectAux and AutoConnectElements. Refer to section Custom Web pages section . \u2002 Extra menu which contains legacy pages It is for the legacy sketches using the on handler of ESP8266WebServer/WebServer(for ESP32) class natively and looks the same as the extra menu as above. The mechanism to generate the AutoConnect menu is simple. It will insert the item as <li> tag generated from the title and uri member variable of the AutoConnectAux object to the menu list of AutoConnect's built-in HTML. Therefore, the legacy sketches can invoke the web pages from the AutoConnect menu with just declaration the title and URI to AutoConnectAux. Place the item for the legacy sketches on the menu \u00b6 To implement this with your sketch, use only the AutoConnectAux constructed with the title and URI of that page. AutoConnectElements is not required. The AutoConnect library package contains an example sketch for ESP8266WebServer known as FSBrowser. Its example is a sample implementation that supports AutoConnect without changing the structure of the original FSBrowser and has the menu item for Edit and List . The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows: Add AutoConnect declaration. Add the menu item named \" Edit \" and \" List \" of AutoConnectAux as each page. Replace the instance of ESP8266WebServer to AutoConnect. Change the menu title to FSBrowser using AutoConnectConfig::title . Join the legacy pages to AutoConnect declared at step #1 using AutoConnect::join . Joining multiple at one time with the list initialization for std::vector . According to the basic procedure of AutoConnect. Establish a connection with AutoConnect::begin and perform AutoConnect::handleClient in loop() . \u2002 Modification for FSBrowser (a part of sketch code) ... and embeds a hyperlink with an icon in the bottom of the body section of index.htm contained in the data folder to jump to the AutoConnect menu. < p style = \"padding-top:15px;text-align:center\" > < a href = \"/_ac\" >< img src = \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAC2klEQVRIS61VvWsUQRSfmU2pon9BUIkQUaKFaCBKgooSb2d3NSSFKbQR/KrEIiIKBiGF2CgRxEpjQNHs7mwOUcghwUQ7g58IsbGxEBWsb2f8zR177s3t3S2cA8ftzPu993vzvoaSnMu2vRKlaqgKp74Q/tE8qjQPyHGcrUrRjwlWShmDbFMURd/a6TcQwNiYUmpFCPElUebcuQ2vz6aNATMVReHEPwzfSSntDcNwNo2rI+DcvQzhpAbA40VKyV0p1Q9snzBG1qYVcYufXV1sREraDcxpyHdXgkfpRBj6Uwm2RsC5dxxmZ9pdOY9cKTISRcHTCmGiUCh4fYyplTwG2mAUbtMTBMHXOgK9QfyXEZr+TkgQ1oUwDA40hEgfIAfj+HuQRaBzAs9eKyUZ5Htx+T3ZODKG8DzOJMANhmGomJVMXPll+hx9UUAlzZrJJ4QNCDG3VEfguu7mcpmcB/gkBOtShhQhchAlu5jlLUgc9ENgyP5gf9+y6LTv+58p5zySkgwzLNOIGc8sEoT1Lc53NMlbCQQuvMxeCME1NNPVVkmH/i3IzzXDtCSA0qQQwZWOCJDY50jsQRjJmkslEOxvTcDRO6zPxOh5xZglKkYLhWM9jMVnkIsTyMT6NBj7IbOCEjm6HxNVVTo2WXqEWJZ1T8rytB6GxizyDkPhWVpBqfiXUtbo/HywYJSpA9kMamNNPZ71R9Hcm+TMHHZNGw3EuraXEUldbfvw25UdOjqOt+JhMwJd7+jSTpZaEiIcaCDwPK83jtWnTkwnunFMtxeL/ge9r4XItt1RNNaj/0GAcV2bR3U5sG3nEh6M61US+Qrfd9Bs31GGulI2GOS/8dgcQZV1w+ApjIxB7TDwF9GcNzJzoA+rD0/8HvPnXQJCt2qFCwbBTfRI7UyXumWVt+HJ9NO4XI++bdsb0YyrqXmlh+AWOLHaLqS5CLQR5EggR3YlcVS9gKeH2hnX8r8Kmi1CAsl36QAAAABJRU5ErkJggg==\" border = \"0\" title = \"AutoConnect menu\" alt = \"AutoConnect menu\" /></ a > </ p > window.onload = function() { Gifffer(); };","title":"Attach the menu"},{"location":"menuize.html#what-menus-can-be-made-using-autoconnect","text":"AutoConnect generates a menu dynamically depending on the instantiated AutoConnectAux at the sketch executing time. Usually, it is a collection of AutoConnectElement . In addition to this, you can generate a menu from only AutoConnectAux, without AutoConnectElements. In other words, you can easily create a built-in menu featuring the WiFi connection facility embedding the legacy web pages.","title":"What menus can be made using AutoConnect"},{"location":"menuize.html#basic-mechanism-of-menu-generation","text":"The sketch can display the AutoConnect menu by following three patterns depending on AutoConnect-API usage. \u2002 Basic menu It is the most basic menu for only connecting WiFi. Sketch can automatically display this menu with the basic call sequence of the AutoConnect API which invokes AutoConnect::begin and AutoConnect::handleClient . \u2002 Extra menu with custom Web pages which is consisted by AutoConnectElements It is an extended menu that appears when the sketch consists of the custom Web pages with AutoConnectAux and AutoConnectElements. Refer to section Custom Web pages section . \u2002 Extra menu which contains legacy pages It is for the legacy sketches using the on handler of ESP8266WebServer/WebServer(for ESP32) class natively and looks the same as the extra menu as above. The mechanism to generate the AutoConnect menu is simple. It will insert the item as <li> tag generated from the title and uri member variable of the AutoConnectAux object to the menu list of AutoConnect's built-in HTML. Therefore, the legacy sketches can invoke the web pages from the AutoConnect menu with just declaration the title and URI to AutoConnectAux.","title":"Basic mechanism of menu generation"},{"location":"menuize.html#place-the-item-for-the-legacy-sketches-on-the-menu","text":"To implement this with your sketch, use only the AutoConnectAux constructed with the title and URI of that page. AutoConnectElements is not required. The AutoConnect library package contains an example sketch for ESP8266WebServer known as FSBrowser. Its example is a sample implementation that supports AutoConnect without changing the structure of the original FSBrowser and has the menu item for Edit and List . The changes I made to adapt the FSBrowser to the AutoConnect menu are slight as follows: Add AutoConnect declaration. Add the menu item named \" Edit \" and \" List \" of AutoConnectAux as each page. Replace the instance of ESP8266WebServer to AutoConnect. Change the menu title to FSBrowser using AutoConnectConfig::title . Join the legacy pages to AutoConnect declared at step #1 using AutoConnect::join . Joining multiple at one time with the list initialization for std::vector . According to the basic procedure of AutoConnect. Establish a connection with AutoConnect::begin and perform AutoConnect::handleClient in loop() . \u2002 Modification for FSBrowser (a part of sketch code) ... and embeds a hyperlink with an icon in the bottom of the body section of index.htm contained in the data folder to jump to the AutoConnect menu. < p style = \"padding-top:15px;text-align:center\" > < a href = \"/_ac\" >< img src = \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAC2klEQVRIS61VvWsUQRSfmU2pon9BUIkQUaKFaCBKgooSb2d3NSSFKbQR/KrEIiIKBiGF2CgRxEpjQNHs7mwOUcghwUQ7g58IsbGxEBWsb2f8zR177s3t3S2cA8ftzPu993vzvoaSnMu2vRKlaqgKp74Q/tE8qjQPyHGcrUrRjwlWShmDbFMURd/a6TcQwNiYUmpFCPElUebcuQ2vz6aNATMVReHEPwzfSSntDcNwNo2rI+DcvQzhpAbA40VKyV0p1Q9snzBG1qYVcYufXV1sREraDcxpyHdXgkfpRBj6Uwm2RsC5dxxmZ9pdOY9cKTISRcHTCmGiUCh4fYyplTwG2mAUbtMTBMHXOgK9QfyXEZr+TkgQ1oUwDA40hEgfIAfj+HuQRaBzAs9eKyUZ5Htx+T3ZODKG8DzOJMANhmGomJVMXPll+hx9UUAlzZrJJ4QNCDG3VEfguu7mcpmcB/gkBOtShhQhchAlu5jlLUgc9ENgyP5gf9+y6LTv+58p5zySkgwzLNOIGc8sEoT1Lc53NMlbCQQuvMxeCME1NNPVVkmH/i3IzzXDtCSA0qQQwZWOCJDY50jsQRjJmkslEOxvTcDRO6zPxOh5xZglKkYLhWM9jMVnkIsTyMT6NBj7IbOCEjm6HxNVVTo2WXqEWJZ1T8rytB6GxizyDkPhWVpBqfiXUtbo/HywYJSpA9kMamNNPZ71R9Hcm+TMHHZNGw3EuraXEUldbfvw25UdOjqOt+JhMwJd7+jSTpZaEiIcaCDwPK83jtWnTkwnunFMtxeL/ge9r4XItt1RNNaj/0GAcV2bR3U5sG3nEh6M61US+Qrfd9Bs31GGulI2GOS/8dgcQZV1w+ApjIxB7TDwF9GcNzJzoA+rD0/8HvPnXQJCt2qFCwbBTfRI7UyXumWVt+HJ9NO4XI++bdsb0YyrqXmlh+AWOLHaLqS5CLQR5EggR3YlcVS9gKeH2hnX8r8Kmi1CAsl36QAAAABJRU5ErkJggg==\" border = \"0\" title = \"AutoConnect menu\" alt = \"AutoConnect menu\" /></ a > </ p > window.onload = function() { Gifffer(); };","title":"Place the item for the legacy sketches on the menu"},{"location":"otabrowser.html","text":"Updates with the Web Browser \u00b6 You can implement the user sketch as described in the ESP8266 Arduino Core documentation to realize using the web browser as an update client. By incorporating the ESP8266HTTPUpdateServer class into AutoConnect, you can operate the dialog page for selecting the updating binary sketch file owned by ESP8266HTTPUpdateServer from the AutoConnect menu. Update feature with a web browser is implemented using ESP8266HTTPUpdateServer class and ESP8266mDNS class. However, ESP32 Arduino core does not provide a class implementation equivalent to ESP8266HTTPUpdateServer . Therefore, it is necessary to implement an HTTPUpdateServer class for ESP32 to realize the update using a Web browser. The AutoConnect library includes an implementation of the HTTPUpdateServer class for ESP32 to make it easy for you to experience . 1 For the client devices equipped with Android OS Depending on the state of Android OS configuration, Bonjour service may not be incorporated. This method does not work with some Android devices as the client. How to embed ESP8266HTTPUpdateServer in AutoConnect \u00b6 To embed the ESP8266HTTPUpdateServer class with AutoConnect into your sketch, basically follow these steps: Include ESP8266mDNS.h and ESP8266HTTPUpdateServer.h , also WiFiClient.h , in addition to the usual directives as ESP8266WebServer.h and AutoConnect.h . Declare an ESP8266WebServer object. (In ESP32, as WebServer) Declare an ESP8266HTTPUpdateServer object. Declare an AutoConnect object with an ESP8266WebServer object as an argument. Declare an AutoConnectAux object for the update operation page. Assign /update to the URI of the update dialog page. Assign any title as the AutoConnect menu for the update dialog page. Declare additional AutoConnectAux pages for your application intention if needed. Perform the following procedure steps in the setup() function: Invokes ESP8288HTTPUpdateServer::setup function, specifies the USERNAME and the PASSWORD as needed. Load the AutoConnectAux pages declared in step #8 for your application. (Except the update dialog page) Join these pages to AutoConnect along with the update dialog page declared in step #5. Invokes AutoConnect::begin function. Call the MDNS.begin and MDNS.addServer functions to start the multi cast DNS service. Perform the following procedure steps in the loop() function: Call the MDNS.update function to parse requests for mDNS. (No needed as ESP32) Invokes AutoConnect::handleClient function. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <ESP8266HTTPUpdateServer.h> // Step #1 #include <ESP8266mDNS.h> // Step #1 #include <WiFiClient.h> // Step #1 #include <AutoConnect.h> static const char HELLO_PAGE[] PROGMEM = R\"( { \"title\": \"Hello world\", \"uri\": \"/\", \"menu\": true, \"element\": [ { \"name\": \"caption\", \"type\": \"ACText\", \"value\": \"<h2>Hello, world</h2>\", \"style\": \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\": \"content\", \"type\": \"ACText\", \"value\": \"In this page, place the custom web page handled by the sketch application.\" } ] } )\" ; ESP8266WebServer httpServer; // Step #2 ESP8266HTTPUpdateServer httpUpdate; // Step #3 AutoConnect portal (httpServer); // Step #4 AutoConnectAux update ( \"/update\" , \"UPDATE\" ); // Step #5, #6, #7 AutoConnectAux hello; // Step #8 void setup () { httpUpdate.setup( & httpServer, \"USERNAME\" , \"PASSWORD\" ); // Step #9.a hello.load(HELLO_PAGE); // Step #9.b portal.join({ hello, update }); // Step #9.c if (portal.begin()) { // Step #9.d if (MDNS.begin( \"esp-webupdate\" )) // Step #9.e MDNS.addService( \"http\" , \"tcp\" , 80 ); // Step #9.e } } void loop () { MDNS.update(); // Step #10.a portal.handleClient(); // Step #10.b } For ESP32 This procedure is equally applicable to ESP32. If the target module is ESP32, change the following items: Change the include directives appropriately for the ESP32 environment. Change ESP8266HTTPUpdaetServer to HTTPUpdateServer using an implementation provided from AutoConnect library example code. Remove MDNS.update line from the sketch code. Share an ESP8266WebServer AutoConnect shares the ESP8266WebServer instance with the ESP8266HTTPUpdateServer class. You can give the same instance as ESP8266WebServer instance given to AutoConnect to ESP8266HTTPUpdateServer class. ESP8266WebServer httpServer; ESP8266HTTPUpdateServer updateServer; AutoConnect portal (httpServer); updateServer( & httpServer); This sharing specification is the same for ESP32. The result of the above sketch should be as follows. 2 How LED ticking during updates You cannot get the ticker with LED during updates by using this way. It is since the current implementation of the ESP8266HTTPUpdateServer class of the Arduino core library does not assign an LED PIN to the ESP8266HTTPUpdate class. How to make the binary sketch \u00b6 Binary sketch files for updating can be retrieved using the Arduino IDE. Open the Sketch menu and select the Export compiled Binary , then starts compilation. When the compilation is complete, a binary sketch will save with the extension .bin in the same folder as the sketch. window.onload = function() { Gifffer(); }; You can find the implementation of the HTTPUpdateServer class in the WebUpdate folder included in the AutoConnect library examples folder . \u21a9 The authentication dialog is displayed first. \u21a9","title":"Using Web Browser"},{"location":"otabrowser.html#updates-with-the-web-browser","text":"You can implement the user sketch as described in the ESP8266 Arduino Core documentation to realize using the web browser as an update client. By incorporating the ESP8266HTTPUpdateServer class into AutoConnect, you can operate the dialog page for selecting the updating binary sketch file owned by ESP8266HTTPUpdateServer from the AutoConnect menu. Update feature with a web browser is implemented using ESP8266HTTPUpdateServer class and ESP8266mDNS class. However, ESP32 Arduino core does not provide a class implementation equivalent to ESP8266HTTPUpdateServer . Therefore, it is necessary to implement an HTTPUpdateServer class for ESP32 to realize the update using a Web browser. The AutoConnect library includes an implementation of the HTTPUpdateServer class for ESP32 to make it easy for you to experience . 1 For the client devices equipped with Android OS Depending on the state of Android OS configuration, Bonjour service may not be incorporated. This method does not work with some Android devices as the client.","title":"Updates with the Web Browser"},{"location":"otabrowser.html#how-to-embed-esp8266httpupdateserver-in-autoconnect","text":"To embed the ESP8266HTTPUpdateServer class with AutoConnect into your sketch, basically follow these steps: Include ESP8266mDNS.h and ESP8266HTTPUpdateServer.h , also WiFiClient.h , in addition to the usual directives as ESP8266WebServer.h and AutoConnect.h . Declare an ESP8266WebServer object. (In ESP32, as WebServer) Declare an ESP8266HTTPUpdateServer object. Declare an AutoConnect object with an ESP8266WebServer object as an argument. Declare an AutoConnectAux object for the update operation page. Assign /update to the URI of the update dialog page. Assign any title as the AutoConnect menu for the update dialog page. Declare additional AutoConnectAux pages for your application intention if needed. Perform the following procedure steps in the setup() function: Invokes ESP8288HTTPUpdateServer::setup function, specifies the USERNAME and the PASSWORD as needed. Load the AutoConnectAux pages declared in step #8 for your application. (Except the update dialog page) Join these pages to AutoConnect along with the update dialog page declared in step #5. Invokes AutoConnect::begin function. Call the MDNS.begin and MDNS.addServer functions to start the multi cast DNS service. Perform the following procedure steps in the loop() function: Call the MDNS.update function to parse requests for mDNS. (No needed as ESP32) Invokes AutoConnect::handleClient function. #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <ESP8266HTTPUpdateServer.h> // Step #1 #include <ESP8266mDNS.h> // Step #1 #include <WiFiClient.h> // Step #1 #include <AutoConnect.h> static const char HELLO_PAGE[] PROGMEM = R\"( { \"title\": \"Hello world\", \"uri\": \"/\", \"menu\": true, \"element\": [ { \"name\": \"caption\", \"type\": \"ACText\", \"value\": \"<h2>Hello, world</h2>\", \"style\": \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\": \"content\", \"type\": \"ACText\", \"value\": \"In this page, place the custom web page handled by the sketch application.\" } ] } )\" ; ESP8266WebServer httpServer; // Step #2 ESP8266HTTPUpdateServer httpUpdate; // Step #3 AutoConnect portal (httpServer); // Step #4 AutoConnectAux update ( \"/update\" , \"UPDATE\" ); // Step #5, #6, #7 AutoConnectAux hello; // Step #8 void setup () { httpUpdate.setup( & httpServer, \"USERNAME\" , \"PASSWORD\" ); // Step #9.a hello.load(HELLO_PAGE); // Step #9.b portal.join({ hello, update }); // Step #9.c if (portal.begin()) { // Step #9.d if (MDNS.begin( \"esp-webupdate\" )) // Step #9.e MDNS.addService( \"http\" , \"tcp\" , 80 ); // Step #9.e } } void loop () { MDNS.update(); // Step #10.a portal.handleClient(); // Step #10.b } For ESP32 This procedure is equally applicable to ESP32. If the target module is ESP32, change the following items: Change the include directives appropriately for the ESP32 environment. Change ESP8266HTTPUpdaetServer to HTTPUpdateServer using an implementation provided from AutoConnect library example code. Remove MDNS.update line from the sketch code. Share an ESP8266WebServer AutoConnect shares the ESP8266WebServer instance with the ESP8266HTTPUpdateServer class. You can give the same instance as ESP8266WebServer instance given to AutoConnect to ESP8266HTTPUpdateServer class. ESP8266WebServer httpServer; ESP8266HTTPUpdateServer updateServer; AutoConnect portal (httpServer); updateServer( & httpServer); This sharing specification is the same for ESP32. The result of the above sketch should be as follows. 2 How LED ticking during updates You cannot get the ticker with LED during updates by using this way. It is since the current implementation of the ESP8266HTTPUpdateServer class of the Arduino core library does not assign an LED PIN to the ESP8266HTTPUpdate class.","title":" How to embed ESP8266HTTPUpdateServer in AutoConnect"},{"location":"otabrowser.html#how-to-make-the-binary-sketch","text":"Binary sketch files for updating can be retrieved using the Arduino IDE. Open the Sketch menu and select the Export compiled Binary , then starts compilation. When the compilation is complete, a binary sketch will save with the extension .bin in the same folder as the sketch. window.onload = function() { Gifffer(); }; You can find the implementation of the HTTPUpdateServer class in the WebUpdate folder included in the AutoConnect library examples folder . \u21a9 The authentication dialog is displayed first. \u21a9","title":" How to make the binary sketch"},{"location":"otaserver.html","text":"Updates with the update server \u00b6 Since the v1.0.0 release, AutoConnect provides new feature for updating sketch firmware of ESP8266 or ESP32 modules via OTA using the AutoConnectUpdate class that is an implementation of the sketch binary update by the HTTP server mentioned in the OTA update of the ESP8266 Arduino Core documentation, which inherits from the ESP8266HTTPUpdate class (as HTTPUpdate class in the case of ESP32). It acts as a client agent for a series of update operations. This method allows you to remotely update the ESP module's firmware beyond the network segments from the update server, as long as you can ensure proper routing and forwarding. If you choose this update method, you need to prepare the server process as a variant of the HTTP server that supplies the binary sketch files to the updating client agent. Its server requires to be able to handle the HTTP headers extended by ESP8266HTTPUpdate class as described in the ESP8266 Arduino Core documentation . There are various implementations of the update server that provide binary sketch files. For example, the ESP8266 Arduino Core documentation suggests an advanced updater php script that can be fully communicated with the client agent using the ESP8266HTTPUpdate class. That is, the update server for AutoConnect must work with the client agent, and its implementation should make the handshake well with the AutoConnectUpdate class which wraps an ESP8266HTTPUpdate class. The AutoConnect library provides an update server script implemented in Python that can combine with the AutoConnectUpdate class. How to embed AutoConnectUpdate to your sketch \u00b6 To embed the AutoConnectUpdate class into your sketch, basically follow these steps: Declare an ESP8266WebServer object. (In ESP32, as WebServer) Declare an AutoConnect object with an ESP8266WebServer object. Declare an AutoConnectUpdate object with the update server address and the HTTP port as parameters. Invokes AutoConnect::begin function. Attach the AutoConnectUpdate object to AutoConnect using AutoConnectUpdate::attach function. Invokes AutoConnect::handleClient function in the loop() . #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> ESP8266WebServer server; // Step #1 AutoConnect portal; // Step #2 AutoConnectUpdate update ( \"192.168.0.100\" , 8000 ); // Step #3 void setup () { if (portal.begin()) { // Step #4 update.attach(portal); // Step #5 } } void loop () { portal.handleClient(); // Step #6 } Behavior of the AutoConnectUpdate class \u00b6 A sketch incorporating the AutoConnectUpdate class has an extended menu item as UPDATE in the AutoConnect menu. UPDATE as menu item will be attached by the AutoConnectUpdate automatically. When an UPDATE item started, its first action is requesting a catalog list of updatable binary sketch files to the update server . Then the update server sends back the catalog list of stored binary sketch files to a client which is the ESP module. The AutoConnectUpdate class will display responded list to a custom Web page 1 on the browser. The substance of Available firmware list is a custom Web page by AutoConnectAux, and you can select the target binary sketch file with the radio button (AutoConnectRadio). A progress bar will appear to notify the updating status once the update has begun. When the update finished, the ESP module will reset automatically to launch a new firmware. The AutoConnectUpdate class performs the above series of operations in conjunction with the update server. All you need to do is attach the AutoConnectUpdate class to AutoConnect and execute the AutoConnect::handleClient function in the loop() . Update server for the AutoConnectUpdate class \u00b6 The above series of operations using AutoConnectUpdate class requires an update server that can work with it. AutoConnect provides an update server script implemented in Python. This server script conforms to a sketch that uses the AutoConnectUpdate class as an update client agent. 2 In the OTA platform, you can place the update server operated by the script in a location that is reachable from the ESP module on the network. updateserver.py [ -h ] [ --port PORT ] [ --bind IP_ADDRESS ] [ --catalog CATALOG ] [ --log LOG_LEVEL ] --help | -h Show help message and exit. --port | -p Specifies PORT number (Default: 8000) --bind | -b Specifies the IP address to which the update server binds. Usually, it is the host address of the update server. When multiple NICs configured, specify one of the IP addresses. (Default: HOST IP or 127.0.0.0) --catalog | -d Specifies the directory path on the update server that contains the binary sketch files. (Default: The current directory) --log | -l Specifies the level of logging output. It accepts the Logging Levels specified in the Python logging module. updateserver.py usage Python First, prepare a Python environment. It is also possible with a tiny single-board computer like the raspberry pi . Popular distributions such as Ubuntu for Linux include Python. You can easily set up a Python 2 or 3 environment. If you are using a Mac, you already have the Python 2 environment. macOS is equipped with Python 2.7 by default. In the case of Windows OS, it is necessary to install the Python environment intentionally. Please refer to the Python official page to install Python in your environment. Deploy the binary sketch files Use the Arduino IDE to output a binary file of sketches and deploy it 3 under the update server. The path which specifies for the --catalog option of updateServer.py is the path of the binary sketch files you deployed. Start updateserver.py For example, to start the update server on the host with IP address 172.16.1.10 using 8080 port 4 , execute the following command: python updateserver.py --port 8080 --bind 172 .16.1.10 --catalog bin --log debug In this example assumes that the binary sketch files are deployed under the path bin from the current directory. Limitations of the updateserver.py The updateserver.py script equips only the minimum facility because it assumes a private small OTA platform without identifying individual modules and version restrictions etc. To operate a larger OTA platform, it is necessary to identify the individual ESP module and to consider version control and security. HTTP contents and the sequence for the AutoConnectUpdate class \u00b6 You can also equip an update server that works with the AutoConnectUpdate class. It can be improved more widely applicable by adding extensions such as version control and authentication to the updateserver.py script. It is necessary to understand the specifications related to HTTP data streams and sequences to enhance the update server that the AutoConnectUpdate class assumes. This section describes the contents of the HTTP data stream required by the communication with AutoConnectUpdate class. To work correctly with the AutoConnectUpdate class, the update server must meet two requirements: The update server notifies the catalog list of updatable binary files which stored in the update server to the client agent. 5 Send an updating binary file and MD5 hash to a client in response to URI request (HTTP GET). 6 Above requirements will be implemented on along the HTTP protocol. The AutoConnectUpdate class requests an update server to notify the client for a catalog list of binary sketch files using an HTTP URL query string. The specifications of the HTTP query and the contents of the catalog list to be returned are as follows: 1. HTTP URL query for the catalog list of the updatable \u00b6 [address]/_catalog?op=list&path=[path] address URL of the update server /_catalog Request path, it is fixed. op Operation command for the update server. Currently, only ' list ' occurs. path Path containing the updatable binary files on the update server. 2. The catalog list content \u00b6 The response (that is, the catalog list) to the above query from the server is the following specification in JSON format. { \"name\" : FILE_NAME , \"type\" : FILE_TYPE , \"date\" : FILE_TIMESTAMP_DATED , \"time\" : FILE_TIMESTAMP_TIMED , \"size\" : FILE_SIZE } name Binary sketch file name for update (String) type One of ' bin ', ' directory ' or ' file '. AutoConnect Update recognizes only file types of ' bin ' as update targets. (String) date File update date. AutoConnect v1.0.0 treats the file update date as an annotation and is not equip the version control feature yet. (String) time File update time. AutoConnect v1.0.0 treats the file update date as an annotation and is not equip the version control feature yet. (String) size File byte count (Numeric) The above JSON object is one entry. The actual catalog list is an array of this entry since it assumes that an update server will provide multiple update binary files in production. The update server should respond with the MIME type specified as application/json for the catalog list. 7 3. The binary sketch file used for updating \u00b6 The AutoConnectUpdate class issues a HTTP GET request with the specified host address and URI. The update server responds by sending back a binary sketch file with the following header: Content-Type: application/octet-stream Content-Disposition: attachment; filename=\"BINARY_SKETCH_FILE_NAME\" Content-Length: LENGTH_OF_CONTENT x-MD5: HEXDIGEST The header x-MD5 is a 128-bit hash value (digest in hexadecimal) that represents the checksum of the binary sketch file for updates required for the ESP8266HTTPUpdate class. window.onload = function() { Gifffer(); }; You can scroll horizontally on the browser to see the timestamp and file size that the catalog list contains. \u21a9 The folders containing the script: For Python2: AUTOCONNECT_LIBRARY_PATH /src/updateserver/python2 For Python3: AUTOCONNECT_LIBRARY_PATH /src/updateserver/python3 \u21a9 Deploying the binary sketch file output by Arduino IDE is usually just copying to the folder for deployment. However, its folder must be accessible from the updateserver.py script. \u21a9 The port of the update server and the port used by the AutoConnectUpdate class must be the same. \u21a9 The client agent is an instance of the AutoConnectUpdate class. \u21a9 The client agent will send its URI request to the update server. \u21a9 It should be represented as Content-Type: application/json in the HTTP response header. \u21a9","title":"Using Update Server"},{"location":"otaserver.html#updates-with-the-update-server","text":"Since the v1.0.0 release, AutoConnect provides new feature for updating sketch firmware of ESP8266 or ESP32 modules via OTA using the AutoConnectUpdate class that is an implementation of the sketch binary update by the HTTP server mentioned in the OTA update of the ESP8266 Arduino Core documentation, which inherits from the ESP8266HTTPUpdate class (as HTTPUpdate class in the case of ESP32). It acts as a client agent for a series of update operations. This method allows you to remotely update the ESP module's firmware beyond the network segments from the update server, as long as you can ensure proper routing and forwarding. If you choose this update method, you need to prepare the server process as a variant of the HTTP server that supplies the binary sketch files to the updating client agent. Its server requires to be able to handle the HTTP headers extended by ESP8266HTTPUpdate class as described in the ESP8266 Arduino Core documentation . There are various implementations of the update server that provide binary sketch files. For example, the ESP8266 Arduino Core documentation suggests an advanced updater php script that can be fully communicated with the client agent using the ESP8266HTTPUpdate class. That is, the update server for AutoConnect must work with the client agent, and its implementation should make the handshake well with the AutoConnectUpdate class which wraps an ESP8266HTTPUpdate class. The AutoConnect library provides an update server script implemented in Python that can combine with the AutoConnectUpdate class.","title":"Updates with the update server"},{"location":"otaserver.html#how-to-embed-autoconnectupdate-to-your-sketch","text":"To embed the AutoConnectUpdate class into your sketch, basically follow these steps: Declare an ESP8266WebServer object. (In ESP32, as WebServer) Declare an AutoConnect object with an ESP8266WebServer object. Declare an AutoConnectUpdate object with the update server address and the HTTP port as parameters. Invokes AutoConnect::begin function. Attach the AutoConnectUpdate object to AutoConnect using AutoConnectUpdate::attach function. Invokes AutoConnect::handleClient function in the loop() . #include <ESP8266WiFi.h> #include <ESP8266WebServer.h> #include <AutoConnect.h> ESP8266WebServer server; // Step #1 AutoConnect portal; // Step #2 AutoConnectUpdate update ( \"192.168.0.100\" , 8000 ); // Step #3 void setup () { if (portal.begin()) { // Step #4 update.attach(portal); // Step #5 } } void loop () { portal.handleClient(); // Step #6 }","title":" How to embed AutoConnectUpdate to your sketch"},{"location":"otaserver.html#behavior-of-the-autoconnectupdate-class","text":"A sketch incorporating the AutoConnectUpdate class has an extended menu item as UPDATE in the AutoConnect menu. UPDATE as menu item will be attached by the AutoConnectUpdate automatically. When an UPDATE item started, its first action is requesting a catalog list of updatable binary sketch files to the update server . Then the update server sends back the catalog list of stored binary sketch files to a client which is the ESP module. The AutoConnectUpdate class will display responded list to a custom Web page 1 on the browser. The substance of Available firmware list is a custom Web page by AutoConnectAux, and you can select the target binary sketch file with the radio button (AutoConnectRadio). A progress bar will appear to notify the updating status once the update has begun. When the update finished, the ESP module will reset automatically to launch a new firmware. The AutoConnectUpdate class performs the above series of operations in conjunction with the update server. All you need to do is attach the AutoConnectUpdate class to AutoConnect and execute the AutoConnect::handleClient function in the loop() .","title":" Behavior of the AutoConnectUpdate class"},{"location":"otaserver.html#update-server-for-the-autoconnectupdate-class","text":"The above series of operations using AutoConnectUpdate class requires an update server that can work with it. AutoConnect provides an update server script implemented in Python. This server script conforms to a sketch that uses the AutoConnectUpdate class as an update client agent. 2 In the OTA platform, you can place the update server operated by the script in a location that is reachable from the ESP module on the network. updateserver.py [ -h ] [ --port PORT ] [ --bind IP_ADDRESS ] [ --catalog CATALOG ] [ --log LOG_LEVEL ] --help | -h Show help message and exit. --port | -p Specifies PORT number (Default: 8000) --bind | -b Specifies the IP address to which the update server binds. Usually, it is the host address of the update server. When multiple NICs configured, specify one of the IP addresses. (Default: HOST IP or 127.0.0.0) --catalog | -d Specifies the directory path on the update server that contains the binary sketch files. (Default: The current directory) --log | -l Specifies the level of logging output. It accepts the Logging Levels specified in the Python logging module. updateserver.py usage Python First, prepare a Python environment. It is also possible with a tiny single-board computer like the raspberry pi . Popular distributions such as Ubuntu for Linux include Python. You can easily set up a Python 2 or 3 environment. If you are using a Mac, you already have the Python 2 environment. macOS is equipped with Python 2.7 by default. In the case of Windows OS, it is necessary to install the Python environment intentionally. Please refer to the Python official page to install Python in your environment. Deploy the binary sketch files Use the Arduino IDE to output a binary file of sketches and deploy it 3 under the update server. The path which specifies for the --catalog option of updateServer.py is the path of the binary sketch files you deployed. Start updateserver.py For example, to start the update server on the host with IP address 172.16.1.10 using 8080 port 4 , execute the following command: python updateserver.py --port 8080 --bind 172 .16.1.10 --catalog bin --log debug In this example assumes that the binary sketch files are deployed under the path bin from the current directory. Limitations of the updateserver.py The updateserver.py script equips only the minimum facility because it assumes a private small OTA platform without identifying individual modules and version restrictions etc. To operate a larger OTA platform, it is necessary to identify the individual ESP module and to consider version control and security.","title":" Update server for the AutoConnectUpdate class"},{"location":"otaserver.html#http-contents-and-the-sequence-for-the-autoconnectupdate-class","text":"You can also equip an update server that works with the AutoConnectUpdate class. It can be improved more widely applicable by adding extensions such as version control and authentication to the updateserver.py script. It is necessary to understand the specifications related to HTTP data streams and sequences to enhance the update server that the AutoConnectUpdate class assumes. This section describes the contents of the HTTP data stream required by the communication with AutoConnectUpdate class. To work correctly with the AutoConnectUpdate class, the update server must meet two requirements: The update server notifies the catalog list of updatable binary files which stored in the update server to the client agent. 5 Send an updating binary file and MD5 hash to a client in response to URI request (HTTP GET). 6 Above requirements will be implemented on along the HTTP protocol. The AutoConnectUpdate class requests an update server to notify the client for a catalog list of binary sketch files using an HTTP URL query string. The specifications of the HTTP query and the contents of the catalog list to be returned are as follows:","title":" HTTP contents and the sequence for the AutoConnectUpdate class"},{"location":"otaserver.html#1-http-url-query-for-the-catalog-list-of-the-updatable","text":"[address]/_catalog?op=list&path=[path] address URL of the update server /_catalog Request path, it is fixed. op Operation command for the update server. Currently, only ' list ' occurs. path Path containing the updatable binary files on the update server.","title":"1. HTTP URL query for the catalog list of the updatable"},{"location":"otaserver.html#2-the-catalog-list-content","text":"The response (that is, the catalog list) to the above query from the server is the following specification in JSON format. { \"name\" : FILE_NAME , \"type\" : FILE_TYPE , \"date\" : FILE_TIMESTAMP_DATED , \"time\" : FILE_TIMESTAMP_TIMED , \"size\" : FILE_SIZE } name Binary sketch file name for update (String) type One of ' bin ', ' directory ' or ' file '. AutoConnect Update recognizes only file types of ' bin ' as update targets. (String) date File update date. AutoConnect v1.0.0 treats the file update date as an annotation and is not equip the version control feature yet. (String) time File update time. AutoConnect v1.0.0 treats the file update date as an annotation and is not equip the version control feature yet. (String) size File byte count (Numeric) The above JSON object is one entry. The actual catalog list is an array of this entry since it assumes that an update server will provide multiple update binary files in production. The update server should respond with the MIME type specified as application/json for the catalog list. 7","title":"2. The catalog list content"},{"location":"otaserver.html#3-the-binary-sketch-file-used-for-updating","text":"The AutoConnectUpdate class issues a HTTP GET request with the specified host address and URI. The update server responds by sending back a binary sketch file with the following header: Content-Type: application/octet-stream Content-Disposition: attachment; filename=\"BINARY_SKETCH_FILE_NAME\" Content-Length: LENGTH_OF_CONTENT x-MD5: HEXDIGEST The header x-MD5 is a 128-bit hash value (digest in hexadecimal) that represents the checksum of the binary sketch file for updates required for the ESP8266HTTPUpdate class. window.onload = function() { Gifffer(); }; You can scroll horizontally on the browser to see the timestamp and file size that the catalog list contains. \u21a9 The folders containing the script: For Python2: AUTOCONNECT_LIBRARY_PATH /src/updateserver/python2 For Python3: AUTOCONNECT_LIBRARY_PATH /src/updateserver/python3 \u21a9 Deploying the binary sketch file output by Arduino IDE is usually just copying to the folder for deployment. However, its folder must be accessible from the updateserver.py script. \u21a9 The port of the update server and the port used by the AutoConnectUpdate class must be the same. \u21a9 The client agent is an instance of the AutoConnectUpdate class. \u21a9 The client agent will send its URI request to the update server. \u21a9 It should be represented as Content-Type: application/json in the HTTP response header. \u21a9","title":"3. The binary sketch file used for updating"},{"location":"otaupdate.html","text":"OTA Updates with AutoConnect \u00b6 AutoConnect provides two type platforms for updating the binary sketch in the ESP8266 or ESP32 module via OTA. They correspond to the Web Browser Update and HTTP Server Update whiches mentioned in the ESP8266 Arduino Core documentation . The update behavior using a web browser as the client that supplies the binary sketch file for update follows the scenario assumed by the ESP8266 Arduino core. Therefore, the user sketch must meet the requirements described in the ESP8266 Arduino Core documentation, but you can easily embed the update feature that able to handle with the web browser by AutoConnect. All you need to do is that join the AutoConnectAux with embedded ESP8266HTTPUpdateServer 1 of the core library to AutoConnect. It is for the only the same network This method can apply only if the client browser and the ESP module belong to the same network segment. It cannot work correctly across networks. Another update method using an update server can be applied more broadly than using a web browser. This method can also update the ESP module over the Internet if you can secure the correct route and transparency between the ESP module and the update server. To configure this platform, you need to have an update server along with using the AutoConnectUpdate class in your sketch. Security Disclaimer The security level of the OTA update platform provided by AutoConnect is very weak. No guarantees as to the level of security for your application by the AutoConnect OTA Update is implied. The AutoConnect library provides an implementation of the HTTPUpdateServer class that ported from ESP8266HTTPUpdateServer class for ESP32 intention. It is contained the WebUpdate under the examples folder. \u21a9","title":"OTA Updates"},{"location":"otaupdate.html#ota-updates-with-autoconnect","text":"AutoConnect provides two type platforms for updating the binary sketch in the ESP8266 or ESP32 module via OTA. They correspond to the Web Browser Update and HTTP Server Update whiches mentioned in the ESP8266 Arduino Core documentation . The update behavior using a web browser as the client that supplies the binary sketch file for update follows the scenario assumed by the ESP8266 Arduino core. Therefore, the user sketch must meet the requirements described in the ESP8266 Arduino Core documentation, but you can easily embed the update feature that able to handle with the web browser by AutoConnect. All you need to do is that join the AutoConnectAux with embedded ESP8266HTTPUpdateServer 1 of the core library to AutoConnect. It is for the only the same network This method can apply only if the client browser and the ESP module belong to the same network segment. It cannot work correctly across networks. Another update method using an update server can be applied more broadly than using a web browser. This method can also update the ESP module over the Internet if you can secure the correct route and transparency between the ESP module and the update server. To configure this platform, you need to have an update server along with using the AutoConnectUpdate class in your sketch. Security Disclaimer The security level of the OTA update platform provided by AutoConnect is very weak. No guarantees as to the level of security for your application by the AutoConnect OTA Update is implied. The AutoConnect library provides an implementation of the HTTPUpdateServer class that ported from ESP8266HTTPUpdateServer class for ESP32 intention. It is contained the WebUpdate under the examples folder. \u21a9","title":"OTA Updates with AutoConnect"},{"location":"wojson.html","text":"Suppress increase in memory consumption \u00b6 Custom Web page processing consumes a lot of memory. AutoConnect will take a whole string of the JSON document for the custom Web pages into memory. The required buffer size for the JSON document of example sketch mqttRSSI reaches approximately 3000 bytes. And actually, it needs twice the heap area. Especially this constraint will be a problem with the ESP8266 which has a heap size poor. AutoConnect can handle custom Web pages without using JSON. In that case, since the ArduinoJson library will not be bound, the sketch size will also be reduced. Writing the custom Web pages without JSON \u00b6 To handle the custom Web pages without using JSON, follow the steps below. Create or define AutoConnectAux for each page. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . In addition to the above procedure, to completely cut off for binding with the ArduinoJson library, turn off the ArduinoJson use indicator which is declared by the AutoConnect definitions . Its declaration is in AutoConnectDefs.h file. 1 // Comment out the AUTOCONNECT_USE_JSON macro to detach the ArduinoJson. #define AUTOCONNECT_USE_JSON JSON processing will be disabled Commenting out the AUTOCONNECT_USE_JSON macro invalidates all functions related to JSON processing. If the sketch is using the JSON function, it will result in a compile error. Implementation example without ArduinoJson \u00b6 The code excluding JSON processing from the mqttRSSI sketch attached to the library is as follows. (It is a part of code. Refer to mqttRSSI_NA.ino for the whole sketch.) The JSON document for mqttRSSI [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"<h2>MQTT broker settings</h2>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"style\" : \"font-family:serif;color:#4682b4;\" }, { \"name\" : \"mqttserver\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"Server\" , \"pattern\" : \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\\\-]*[a-zA-Z0-9])\\\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\\\-]*[A-Za-z0-9])$\" , \"placeholder\" : \"MQTT broker server\" }, { \"name\" : \"channelid\" , \"type\" : \"ACInput\" , \"label\" : \"Channel ID\" , \"pattern\" : \"^[0-9]{6}$\" }, { \"name\" : \"userkey\" , \"type\" : \"ACInput\" , \"label\" : \"User Key\" }, { \"name\" : \"apikey\" , \"type\" : \"ACInput\" , \"label\" : \"API Key\" }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"uniqueid\" , \"type\" : \"ACCheckbox\" , \"value\" : \"unique\" , \"label\" : \"Use APID unique\" , \"checked\" : false }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"label\" : \"Update period\" , \"arrange\" : \"vertical\" , \"checked\" : 1 }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"hostname\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"ESP host name\" , \"pattern\" : \"^([a-zA-Z0-9]([a-zA-Z0-9-])*[a-zA-Z0-9]){1,32}$\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"Save&amp;Start\" , \"uri\" : \"/mqtt_save\" }, { \"name\" : \"discard\" , \"type\" : \"ACSubmit\" , \"value\" : \"Discard\" , \"uri\" : \"/\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"<h4>Parameters saved as:</h4>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"parameters\" , \"type\" : \"ACText\" }, { \"name\" : \"clear\" , \"type\" : \"ACSubmit\" , \"value\" : \"Clear channel\" , \"uri\" : \"/mqtt_clear\" } ] } ] Exclude the JSON and replace to the AutoConnectElements natively // In the declaration, // Declare AutoConnectElements for the page asf /mqtt_setting ACText(header, \"<h2>MQTT broker settings</h2>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(caption, \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"font-family:serif;color:#4682b4;\" ); ACInput(mqttserver, \"\" , \"Server\" , \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9 \\\\ -]*[a-zA-Z0-9]) \\\\ .)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9 \\\\ -]*[A-Za-z0-9])$\" , \"MQTT broker server\" ); ACInput(channelid, \"\" , \"Channel ID\" , \"^[0-9]{6}$\" ); ACInput(userkey, \"\" , \"User Key\" ); ACInput(apikey, \"\" , \"API Key\" ); ACElement(newline, \"<hr>\" ); ACCheckbox(uniqueid, \"unique\" , \"Use APID unique\" ); ACRadio(period, { \"30 sec.\" , \"60 sec.\" , \"180 sec.\" }, \"Update period\" , AC_Vertical, 1 ); ACSubmit(save, \"Start\" , \"mqtt_save\" ); ACSubmit(discard, \"Discard\" , \"/\" ); // Declare the custom Web page as /mqtt_setting and contains the AutoConnectElements AutoConnectAux mqtt_setting ( \"/mqtt_setting\" , \"MQTT Setting\" , true, { header, caption, mqttserver, channelid, userkey, apikey, newline, uniqueid, period, newline, save, discard }); // Declare AutoConnectElements for the page as /mqtt_save ACText(caption2, \"<h4>Parameters available as:</h4>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(parameters); ACSubmit(clear, \"Clear channel\" , \"/mqtt_clear\" ); // Declare the custom Web page as /mqtt_save and contains the AutoConnectElements AutoConnectAux mqtt_save ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, parameters, clear }); // In the setup(), // Join the custom Web pages and performs begin portal.join({ mqtt_setting, mqtt_save }); portal.begin(); Detaching the ArduinoJson library reduces the sketch size by approximately 10K bytes. \u21a9","title":"Custom Web pages w/o JSON"},{"location":"wojson.html#suppress-increase-in-memory-consumption","text":"Custom Web page processing consumes a lot of memory. AutoConnect will take a whole string of the JSON document for the custom Web pages into memory. The required buffer size for the JSON document of example sketch mqttRSSI reaches approximately 3000 bytes. And actually, it needs twice the heap area. Especially this constraint will be a problem with the ESP8266 which has a heap size poor. AutoConnect can handle custom Web pages without using JSON. In that case, since the ArduinoJson library will not be bound, the sketch size will also be reduced.","title":"Suppress increase in memory consumption"},{"location":"wojson.html#writing-the-custom-web-pages-without-json","text":"To handle the custom Web pages without using JSON, follow the steps below. Create or define AutoConnectAux for each page. Create or define AutoConnectElement(s) . Add AutoConnectElement(s) to AutoConnectAux. Create more AutoConnectAux containing AutoConnectElement(s) , if necessary. Register the request handlers for the custom Web pages. Join prepared AutoConnectAux(s) to AutoConnect. Invoke AutoConnect::begin() . In addition to the above procedure, to completely cut off for binding with the ArduinoJson library, turn off the ArduinoJson use indicator which is declared by the AutoConnect definitions . Its declaration is in AutoConnectDefs.h file. 1 // Comment out the AUTOCONNECT_USE_JSON macro to detach the ArduinoJson. #define AUTOCONNECT_USE_JSON JSON processing will be disabled Commenting out the AUTOCONNECT_USE_JSON macro invalidates all functions related to JSON processing. If the sketch is using the JSON function, it will result in a compile error.","title":"Writing the custom Web pages without JSON"},{"location":"wojson.html#implementation-example-without-arduinojson","text":"The code excluding JSON processing from the mqttRSSI sketch attached to the library is as follows. (It is a part of code. Refer to mqttRSSI_NA.ino for the whole sketch.) The JSON document for mqttRSSI [ { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_setting\" , \"menu\" : true , \"element\" : [ { \"name\" : \"header\" , \"type\" : \"ACText\" , \"value\" : \"<h2>MQTT broker settings</h2>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"style\" : \"font-family:serif;color:#4682b4;\" }, { \"name\" : \"mqttserver\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"Server\" , \"pattern\" : \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\\\-]*[a-zA-Z0-9])\\\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\\\-]*[A-Za-z0-9])$\" , \"placeholder\" : \"MQTT broker server\" }, { \"name\" : \"channelid\" , \"type\" : \"ACInput\" , \"label\" : \"Channel ID\" , \"pattern\" : \"^[0-9]{6}$\" }, { \"name\" : \"userkey\" , \"type\" : \"ACInput\" , \"label\" : \"User Key\" }, { \"name\" : \"apikey\" , \"type\" : \"ACInput\" , \"label\" : \"API Key\" }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"uniqueid\" , \"type\" : \"ACCheckbox\" , \"value\" : \"unique\" , \"label\" : \"Use APID unique\" , \"checked\" : false }, { \"name\" : \"period\" , \"type\" : \"ACRadio\" , \"value\" : [ \"30 sec.\" , \"60 sec.\" , \"180 sec.\" ], \"label\" : \"Update period\" , \"arrange\" : \"vertical\" , \"checked\" : 1 }, { \"name\" : \"newline\" , \"type\" : \"ACElement\" , \"value\" : \"<hr>\" }, { \"name\" : \"hostname\" , \"type\" : \"ACInput\" , \"value\" : \"\" , \"label\" : \"ESP host name\" , \"pattern\" : \"^([a-zA-Z0-9]([a-zA-Z0-9-])*[a-zA-Z0-9]){1,32}$\" }, { \"name\" : \"save\" , \"type\" : \"ACSubmit\" , \"value\" : \"Save&amp;Start\" , \"uri\" : \"/mqtt_save\" }, { \"name\" : \"discard\" , \"type\" : \"ACSubmit\" , \"value\" : \"Discard\" , \"uri\" : \"/\" } ] }, { \"title\" : \"MQTT Setting\" , \"uri\" : \"/mqtt_save\" , \"menu\" : false , \"element\" : [ { \"name\" : \"caption\" , \"type\" : \"ACText\" , \"value\" : \"<h4>Parameters saved as:</h4>\" , \"style\" : \"text-align:center;color:#2f4f4f;padding:10px;\" }, { \"name\" : \"parameters\" , \"type\" : \"ACText\" }, { \"name\" : \"clear\" , \"type\" : \"ACSubmit\" , \"value\" : \"Clear channel\" , \"uri\" : \"/mqtt_clear\" } ] } ] Exclude the JSON and replace to the AutoConnectElements natively // In the declaration, // Declare AutoConnectElements for the page asf /mqtt_setting ACText(header, \"<h2>MQTT broker settings</h2>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(caption, \"Publishing the WiFi signal strength to MQTT channel. RSSI value of ESP8266 to the channel created on ThingSpeak\" , \"font-family:serif;color:#4682b4;\" ); ACInput(mqttserver, \"\" , \"Server\" , \"^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9 \\\\ -]*[a-zA-Z0-9]) \\\\ .)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9 \\\\ -]*[A-Za-z0-9])$\" , \"MQTT broker server\" ); ACInput(channelid, \"\" , \"Channel ID\" , \"^[0-9]{6}$\" ); ACInput(userkey, \"\" , \"User Key\" ); ACInput(apikey, \"\" , \"API Key\" ); ACElement(newline, \"<hr>\" ); ACCheckbox(uniqueid, \"unique\" , \"Use APID unique\" ); ACRadio(period, { \"30 sec.\" , \"60 sec.\" , \"180 sec.\" }, \"Update period\" , AC_Vertical, 1 ); ACSubmit(save, \"Start\" , \"mqtt_save\" ); ACSubmit(discard, \"Discard\" , \"/\" ); // Declare the custom Web page as /mqtt_setting and contains the AutoConnectElements AutoConnectAux mqtt_setting ( \"/mqtt_setting\" , \"MQTT Setting\" , true, { header, caption, mqttserver, channelid, userkey, apikey, newline, uniqueid, period, newline, save, discard }); // Declare AutoConnectElements for the page as /mqtt_save ACText(caption2, \"<h4>Parameters available as:</h4>\" , \"text-align:center;color:#2f4f4f;padding:10px;\" ); ACText(parameters); ACSubmit(clear, \"Clear channel\" , \"/mqtt_clear\" ); // Declare the custom Web page as /mqtt_save and contains the AutoConnectElements AutoConnectAux mqtt_save ( \"/mqtt_save\" , \"MQTT Setting\" , false, { caption2, parameters, clear }); // In the setup(), // Join the custom Web pages and performs begin portal.join({ mqtt_setting, mqtt_save }); portal.begin(); Detaching the ArduinoJson library reduces the sketch size by approximately 10K bytes. \u21a9","title":"Implementation example without ArduinoJson"}]}
\ No newline at end of file
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
index 0a54a2c..3645d49 100644
--- a/docs/sitemap.xml
+++ b/docs/sitemap.xml
@@ -2,147 +2,147 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/index.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/gettingstarted.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/menu.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/basicusage.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/advancedusage.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/acintro.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/acelements.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/acjson.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/achandling.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/otaupdate.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/otabrowser.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/otaserver.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/api.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/apiaux.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/apiconfig.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/apielements.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/apiupdate.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/apiextra.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/howtoembed.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/datatips.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/menuize.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/wojson.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/lsbegin.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/credit.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/acupload.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/colorized.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/faq.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/changelog.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>https://Hieromon.github.io/AutoConnect/license.html</loc>
-     <lastmod>2019-09-30</lastmod>
+     <lastmod>2019-10-16</lastmod>
      <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/docs/sitemap.xml.gz b/docs/sitemap.xml.gz
index a669311eeb540f360bbe08ef317145066a99bd9b..daceb3d346a228898350bb73dff8fa3eb45fbb45 100644
GIT binary patch
delta 391
zcmV;20eJqH1DOK{ABzYG*ypB^2OWP_(!;P0j)S5=u@C4zfR-4Wg)F)v9jE>JDs49G
zT%Z7bu`S8O11%A359cXXC(J^e_VupW))gktfzq(A|2#cze%6QXrd@Ir)T%5_vad(g
z`ImF+x;8?J6U@?Z9-R2GyokFFx@~h;cQ;kJE&)EDsy4FkE)k@J_)VC3;?#c(q~p>z
z#O{7ke&CeQtD_X~+>AQK)?GgP8v#To4&Ci`cemMXH@hEY`Z{)9;zvjW9y7jl0Vuw<
z?!S>wlKW@+qHaLdk|$Bfioq;%!nByh^&sRIfdS1DA)Fw2491n7l4dsS!-!=osu(6d
zOPRFGD<MNH6~`=*6_z=GqGfkspLrF`mWhRTGAx9dEZbl?TjqIAM;a^(?N{oVjMte<
z7SEc&EO6vi8K>TG<63?&D9vKJv!*w@n{Z{*4Na6D2eRw)83U=|esGy1gWdD%IdU%N
l!>;fMFLtx{5izpeP9c)VB;Q>AK5l~Ay#u>#<Ql6I003YszYhQa

delta 390
zcmV;10eSwJ1DFE`ABzYG@syE~2OWQwvt5?LaWM=S_5s@m&=O;_kVRLd<7{6)rA>>T
z3lyL)wk4T(pe2Ic!)1=u8M6?lW4&+My29i+P#TZ*pWi=s-|C0{u3K{y)T%5_a;zuS
z<=(k%+ZrLo85U_ck52qlUc}u7UE3V${;n$5HNeYL)kXIGHG-57zX&tWoSJ`;bXtdo
z*nMA>e{f3Z)lmv~X(pXx=dPc<MgY;7L;t1SA9n3w_q8q4x3Sw2KS3Jtl<}z#K=E(q
z-i^GF+?(lxx)D`No<t!l2D8i=(`ptsfRJAWMl?%=aE9bD7*~2qn%S@qBbKeGVwm_S
zWzsIMgbcA%9J54LSeF2bmW6gh=1nkLCKle=un-oqY=iY;nddp3XtXS}U#S-|UT3aZ
zyl4iqz==0yoCm{=Yx%*Tw20}>n*Q0{gd3Y~Xrc@_l3kzA7)TBGgX<C*?4DoGk#jj8
kc7-Q+vYWl<h>`7f3Xwb}`Q-BVd=u3EKhf>Q*Q*i$0DU>ZyZ`_I