Table of Contents

Why do we need thisESP8266_W5100_Manager library

Features

Currently supported Boards

Prerequisites

Installation

Use Arduino Library Manager

Manual Install

VS Code & PlatformIO:

HOWTO FixMultiple Definitions Linker Error

#include<ESP8266_W5100_Manager.hpp>//https://github.com/khoih-prog/ESP8266_W5100_Manager

// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error#include<ESP8266_W5100_Manager.h>//https://github.com/khoih-prog/ESP8266_W5100_Manager

How It Works

HOWTO Basic configurations

1. Using default for every configurable parameter

#include<FS.h>#include<ESP8266WiFi.h>//https://github.com/esp8266/Arduino//needed for library#include<DNSServer.h>#defineUSE_LITTLEFStrue#if USE_LITTLEFS  #include<LittleFS.h>  FS* filesystem =      &LittleFS;  #defineFileFS        LittleFS  #defineFS_Name"LittleFS"#else  FS* filesystem =      &SPIFFS;  #defineFileFS        SPIFFS  #defineFS_Name"SPIFFS"#endif//////////////////////////////////////////////////////////#defineESP_getChipId()   (ESP.getChipId())#defineLED_ON      LOW#defineLED_OFF     HIGH//////////////////////////////////////////////////////////// You only need to format the filesystem once//#define FORMAT_FILESYSTEM       true#defineFORMAT_FILESYSTEMfalse////////////////////////////////////////////////////#include<ESP8266_W5100_Manager.h>//https://github.com/khoih-prog/ESP8266_W5100_Manager#defineHTTP_PORT80

2. Using many configurable parameters

#include<FS.h>#include<ESP8266WiFi.h>//https://github.com/esp8266/Arduino//needed for library#include<DNSServer.h>#defineUSE_LITTLEFStrue#if USE_LITTLEFS  #include<LittleFS.h>  FS* filesystem =      &LittleFS;  #defineFileFS        LittleFS  #defineFS_Name"LittleFS"#else  FS* filesystem =      &SPIFFS;  #defineFileFS        SPIFFS  #defineFS_Name"SPIFFS"#endif//////////////////////////////////////////////////////////#defineESP_getChipId()   (ESP.getChipId())#defineLED_ON      LOW#defineLED_OFF     HIGH//////////////////////////////////////////////////////////////// You only need to format the filesystem once//#define FORMAT_FILESYSTEM       true#defineFORMAT_FILESYSTEMfalse//////////////////////////////////////////////////////////////// Assuming max 49 chars#defineTZNAME_MAX_LEN50#defineTIMEZONE_MAX_LEN50typedefstruct{char TZ_Name[TZNAME_MAX_LEN];// "America/Toronto"char TZ[TIMEZONE_MAX_LEN];// "EST5EDT,M3.2.0,M11.1.0"uint16_t checksum;} EthConfig;EthConfig         Ethconfig;//////////////////////////////////////////////////////////////#defineCONFIG_FILENAMEF("/eth_cred.dat")//////////////////////////////////////////////////////////////// Indicates whether ESP has credentials saved from previous session, or double reset detectedbool initialConfig = false;// Use false if you don't like to display Available Pages in Information Page of Config Portal// Comment out or use true to display Available Pages in Information Page of Config Portal// Must be placed before #include <ESP8266_W5100_Manager.h>#defineUSE_AVAILABLE_PAGEStrue// From v1.0.10 to permit disable/enable StaticIP configuration in Config Portal from sketch. Valid only if DHCP is used.// You'll loose the feature of dynamically changing from DHCP to static IP, or vice versa// You have to explicitly specify false to disable the feature.//#define USE_STATIC_IP_CONFIG_IN_CP          false// Use false to disable NTP config. Advisable when using Cellphone, Tablet to access Config Portal.// See Issue 23: On Android phone ConfigPortal is unresponsive (https://github.com/khoih-prog/ESP_WiFiManager/issues/23)#defineUSE_ESP_ETH_MANAGER_NTPtrue// Just use enough to save memory. On ESP8266, can cause blank ConfigPortal screen// if using too much memory#defineUSING_AFRICAfalse#defineUSING_AMERICAtrue#defineUSING_ANTARCTICAfalse#defineUSING_ASIAfalse#defineUSING_ATLANTICfalse#defineUSING_AUSTRALIAfalse#defineUSING_EUROPEfalse#defineUSING_INDIANfalse#defineUSING_PACIFICfalse#defineUSING_ETC_GMTfalse// Use true to enable CloudFlare NTP service. System can hang if you don't have Internet access while accessing CloudFlare// See Issue #21: CloudFlare link in the default portal (https://github.com/khoih-prog/ESP_WiFiManager/issues/21)#defineUSE_CLOUDFLARE_NTPfalse// New in v1.0.11#defineUSING_CORS_FEATUREtrue//////////////////////////////////////////////////////////////// Use USE_DHCP_IP == true for dynamic DHCP IP, false to use static IP which you have to change accordingly to your network#if (defined(USE_STATIC_IP_CONFIG_IN_CP) && !USE_STATIC_IP_CONFIG_IN_CP)// Force DHCP to be true  #if defined(USE_DHCP_IP)    #undef USE_DHCP_IP  #endif  #defineUSE_DHCP_IPtrue#else// You can select DHCP or Static IP here//#define USE_DHCP_IP     true  #defineUSE_DHCP_IPfalse#endif#if ( USE_DHCP_IP )// Use DHCP  #if (_ESP8266_ETH_MGR_LOGLEVEL_ > 3)    #warning Using DHCP IP  #endif  IPAddress stationIP   = IPAddress(0,0,0,0);  IPAddress gatewayIP   = IPAddress(192,168,2,1);  IPAddress netMask     = IPAddress(255,255,255,0);#else// Use static IP  #if (_ESP8266_ETH_MGR_LOGLEVEL_ > 3)    #warning Using static IP  #endif  IPAddress stationIP   = IPAddress(192,168,2,186);  IPAddress gatewayIP   = IPAddress(192,168,2,1);  IPAddress netMask     = IPAddress(255,255,255,0);#endif//////////////////////////////////////////////////////////////#defineUSE_CONFIGURABLE_DNStrueIPAddress dns1IP      = gatewayIP;IPAddress dns2IP      = IPAddress(8,8,8,8);#include<ESP8266_W5100_Manager.h>//https://github.com/khoih-prog/ESP8266_W5100_Manager#defineHTTP_PORT80///////////////////////////////////////////////////////////////******************************************   // Defined in ESP8266_W5100_Manager.hpp  typedef struct  {    IPAddress _sta_static_ip;    IPAddress _sta_static_gw;    IPAddress _sta_static_sn;    #if USE_CONFIGURABLE_DNS    IPAddress _sta_static_dns1;    IPAddress _sta_static_dns2;    #endif  }  ETH_STA_IPConfig;******************************************/ETH_STA_IPConfig EthSTA_IPconfig;

3. Using STA-mode DHCP, but don't like to change to static IP or display in Config Portal

// You'll loose the feature of dynamically changing from DHCP to static IP, or vice versa// You have to explicitly specify false to disable the feature.#defineUSE_STATIC_IP_CONFIG_IN_CPfalse

4. Using STA-mode DHCP, but permit to change to static IP and display in Config Portal

// You'll loose the feature of dynamically changing from DHCP to static IP, or vice versa// You have to explicitly specify false to disable the feature.//#define USE_STATIC_IP_CONFIG_IN_CP          false// Use USE_DHCP_IP == true for dynamic DHCP IP, false to use static IP which you have to change accordingly to your network#if (defined(USE_STATIC_IP_CONFIG_IN_CP) && !USE_STATIC_IP_CONFIG_IN_CP)// Force DHCP to be true  #if defined(USE_DHCP_IP)    #undef USE_DHCP_IP  #endif  #defineUSE_DHCP_IPtrue#else// You can select DHCP or Static IP here  #defineUSE_DHCP_IPtrue#endif

5. Using STA-mode StaticIP, and be able to change to DHCP IP and display in Config Portal

// You'll loose the feature of dynamically changing from DHCP to static IP, or vice versa// You have to explicitly specify false to disable the feature.//#define USE_STATIC_IP_CONFIG_IN_CP          false// Use USE_DHCP_IP == true for dynamic DHCP IP, false to use static IP which you have to change accordingly to your network#if (defined(USE_STATIC_IP_CONFIG_IN_CP) && !USE_STATIC_IP_CONFIG_IN_CP)// Force DHCP to be true  #if defined(USE_DHCP_IP)    #undef USE_DHCP_IP  #endif  #defineUSE_DHCP_IPtrue#else// You can select DHCP or Static IP here  #defineUSE_DHCP_IPfalse#endif

6. Using STA-mode StaticIP and configurable DNS, and be able to change to DHCP IP and display in Config Portal

// You'll loose the feature of dynamically changing from DHCP to static IP, or vice versa// You have to explicitly specify false to disable the feature.//#define USE_STATIC_IP_CONFIG_IN_CP          false// Use USE_DHCP_IP == true for dynamic DHCP IP, false to use static IP which you have to change accordingly to your network#if (defined(USE_STATIC_IP_CONFIG_IN_CP) && !USE_STATIC_IP_CONFIG_IN_CP)// Force DHCP to be true  #if defined(USE_DHCP_IP)    #undef USE_DHCP_IP  #endif  #defineUSE_DHCP_IPtrue#else// You can select DHCP or Static IP here  #defineUSE_DHCP_IPfalse#endif#defineUSE_CONFIGURABLE_DNStrueIPAddress dns1IP      = gatewayIP;IPAddress dns2IP      = IPAddress(8,8,8,8);

7. Using STA-mode StaticIP and auto DNS, and be able to change to DHCP IP and display in Config Portal

// You'll loose the feature of dynamically changing from DHCP to static IP, or vice versa// You have to explicitly specify false to disable the feature.//#define USE_STATIC_IP_CONFIG_IN_CP          false// Use USE_DHCP_IP == true for dynamic DHCP IP, false to use static IP which you have to change accordingly to your network#if (defined(USE_STATIC_IP_CONFIG_IN_CP) && !USE_STATIC_IP_CONFIG_IN_CP)// Force DHCP to be true  #if defined(USE_DHCP_IP)    #undef USE_DHCP_IP  #endif  #defineUSE_DHCP_IPtrue#else// You can select DHCP or Static IP here  #defineUSE_DHCP_IPfalse#endif#defineUSE_CONFIGURABLE_DNSfalse

8. Not using NTP to avoid issue with some WebBrowsers, especially in CellPhone or Tablets.

// Use false to disable NTP config. Advisable when using Cellphone, Tablet to access Config Portal.// See Issue 23: On Android phone ConfigPortal is unresponsive (https://github.com/khoih-prog/ESP_WiFiManager/issues/23)#defineUSE_ESP_ETH_MANAGER_NTPfalse

9. Using NTP feature with CloudFlare. System can hang until you have Internet access for CloudFlare.

// Use false to disable NTP config. Advisable when using Cellphone, Tablet to access Config Portal.// See Issue 23: On Android phone ConfigPortal is unresponsive (https://github.com/khoih-prog/ESP_WiFiManager/issues/23)#defineUSE_ESP_ETH_MANAGER_NTPtrue// Use true to enable CloudFlare NTP service. System can hang if you don't have Internet access while accessing CloudFlare// See Issue #21: CloudFlare link in the default portal (https://github.com/khoih-prog/ESP_WiFiManager/issues/21)#defineUSE_CLOUDFLARE_NTPtrue

10. Using NTP feature without CloudFlare to avoid system hang if no Internet access for CloudFlare.

// Use false to disable NTP config. Advisable when using Cellphone, Tablet to access Config Portal.// See Issue 23: On Android phone ConfigPortal is unresponsive (https://github.com/khoih-prog/ESP_WiFiManager/issues/23)#defineUSE_ESP_ETH_MANAGER_NTPtrue// Use true to enable CloudFlare NTP service. System can hang if you don't have Internet access while accessing CloudFlare// See Issue #21: CloudFlare link in the default portal (https://github.com/khoih-prog/ESP_WiFiManager/issues/21)#defineUSE_CLOUDFLARE_NTPfalse

11. Setting STA-mode static IP

//ESP8266_W5100_manager.setSTAStaticIPConfig(stationIP, gatewayIP, netMask, dns1IP, dns2IP);ESP8266_W5100_manager.setSTAStaticIPConfig(WM_STA_IPconfig);

12. Using CORS (Cross-Origin Resource Sharing) feature

// Default false for using only whenever necessary to avoid security issue#defineUSING_CORS_FEATUREtrue

// Default false for using only whenever necessary to avoid security issue#defineUSING_CORS_FEATUREtrue...#if USING_CORS_FEATURE  ESP_wifiManager.setCORSHeader("Your Access-Control-Allow-Origin");#endif

// Default false for using only whenever necessary to avoid security issue#defineUSING_CORS_FEATUREfalse

13. How to auto getting _timezoneName

// Use false to disable NTP config. Advisable when using Cellphone, Tablet to access Config Portal.// See Issue 23: On Android phone ConfigPortal is unresponsive (https://github.com/khoih-prog/ESP_WiFiManager/issues/23)#defineUSE_ESP_ETH_MANAGER_NTPtrue

String tempTZ = ESP8266_W5100_manager.getTimezoneName();

14. How to get TZ variable to configure Timezone

// EST5EDT,M3.2.0,M11.1.0 (for America/New_York)// EST5EDT is the name of the time zone// EST is the abbreviation used when DST is off// 6 hours is the time difference from GMT// EDT is the abbreviation used when DST is on// ,M3 is the third month// .2 is the second occurrence of the day in the month// .0 is Sunday// ,M11 is the eleventh month// .1 is the first occurrence of the day in the month// .0 is SundayconfigTime(Ethconfig.TZ,"pool.ntp.org");

constchar * TZ_Result = ESP8266_W5100_manager.getTZ(_timezoneName);

#defineUSING_AMERICAtrue

// Just use enough to save memory. On ESP8266, can cause blank ConfigPortal screen// if using too much memory#defineUSING_AFRICAfalse#defineUSING_AMERICAtrue#defineUSING_ANTARCTICAfalse#defineUSING_ASIAfalse#defineUSING_ATLANTICfalse#defineUSING_AUSTRALIAfalse#defineUSING_EUROPEfalse#defineUSING_INDIANfalse#defineUSING_PACIFICfalse#defineUSING_ETC_GMTfalse

15. How to use the TZ variable to configure Timezone

configTime(Ethconfig.TZ,"pool.ntp.org");

voidprintLocalTime(){statictime_t now;  now =time(nullptr);if ( now >1451602800 )  {    Serial.print("Local Date/Time:");    Serial.print(ctime(&now));  }}

HOWTO Open Config Portal

#include<ESP8266_W5100_Manager.h>//https://github.com/khoih-prog/ESP8266_W5100_Manager#defineHTTP_PORT80WebServerwebServer(HTTP_PORT);ESP8266_W5100_ManagerESP8266_W5100_manager();

ESP8266_W5100_ManagerESP8266_W5100_manager("Personalized-HostName");

ESP8266_W5100_manager.startConfigPortal()

HOWTO Add Dynamic Parameters

1. Determine the variables to be configured via Config Portal (CP)

1. `thingspeakApiKey`,  type `char array`, max length 17 chars, and just arbitrarily selected default value to be "" or "ThingSpeak-APIKey"2. `sensorDht22`,       type `bool`, default to be `true` (DHT22)3. `pinSda`,            type `int`,  default to be `PIN_D2`4. `pinScl`,            type `int`,  default to be `PIN_D1`

#defineAPI_KEY_LEN17// Default configuration valueschar thingspeakApiKey[API_KEY_LEN]  ="";bool sensorDht22                    =true;int pinSda                          = PIN_D2;// Pin D2 mapped to pin GPIO4 of ESP8266int pinScl                          = PIN_D1;// Pin D1 mapped to pin GPIO5 of ESP8266// Any unique string helping you identify the vars#defineThingSpeakAPI_Label"thingspeakApiKey"#defineSensorDht22_Label"SensorDHT22"#definePinSDA_Label"PinSda"#definePinSCL_Label"PinScl"

2. Initialize the variables to prepare for Config Portal (CP)

voidloop(){// is configuration portal requested?if ((digitalRead(TRIGGER_PIN) == LOW) || (digitalRead(TRIGGER_PIN2) == LOW))  {    Serial.println("\nConfiguration portal requested.");digitalWrite(LED_BUILTIN, LED_ON);// turn the LED on by making the voltage LOW to tell us we are in configuration mode.//Local initialization. Once its business is done, there is no need to keep it around    ESP8266_W5100_ManagerESP8266_W5100_manager("ConfigOnSwitchFS");//Check if there is stored WiFi router/password credentials.//If not found, device will remain in configuration mode until switched off via webserver.    Serial.print("Opening configuration portal.");        ...// The addition of dynamic vars will be somewhere here    }

2.1 Use the following simple constructor for simple variables such asthingspeakApiKey,pinSda andpinScl :

ESP8266_EMParameter(constchar *id,constchar *placeholder,constchar *defaultValue,int length);

2.2 For example, to create a newESP8266_EMParameter objectp_thingspeakApiKey forthingspeakApiKey,

ESP8266_EMParameterp_thingspeakApiKey(ThingSpeakAPI_Label,"Thingspeak API Key", thingspeakApiKey, API_KEY_LEN);

- p_thingspeakApiKey                  : ESP8266_EMParameter class object reference that stores the new Custom Parameter- id => ThingSpeakAPI_Label           : var ref to Json associative name and HTML element ID for the new Custom Paramerter you just defined in step 1- placeholder => "Thingspeak API Key" : HTML input placeholder and/or label element text the user sees in the configuration interface for this Custom Parameter- defaultValue => thingspeakApiKey    : variable for storing the value of your Custom Parameter in the file system or default value when no data is entered- length  => API_KEY_LEN              : max allowed length you want for this Custom Parameter to have

// I2C SCL and SDA parameters are integers so we need to convert them to char array but// no other special considerationschar convertedValue[3];sprintf(convertedValue,"%d", pinSda);ESP8266_EMParameterp_pinSda(PinSDA_Label,"I2C SDA pin", convertedValue,3);sprintf(convertedValue,"%d", pinScl);ESP8266_EMParameterp_pinScl(PinSCL_Label,"I2C SCL pin", convertedValue,3);

- p_pinSda / p_pinScl                         : ESP8266_EMParameter class object reference that stores the new Custom Parameter- id => PinSDA_Label/PinSCL_Label             : var ref to Json associative name and HTML element ID for the new Custom Paramerter you just defined in step 1- placeholder => "I2C SDA pin"/"I2C SCL pin"  : HTML input placeholder and/or label element text the user sees in the configuration interface for this Custom Parameter- defaultValue => convertedValue              : variable for storing the value of your Custom Parameter in the file system or default value when no data is entered- length  => 3                                : max allowed length you want for this Custom Parameter to have

2.3 Use the more complex following constructor for variables such assensorDht22:

ESP8266_EMParameter(constchar *id,constchar *placeholder,constchar *defaultValue,int length,constchar *custom,int labelPlacement);

2.4 For example, to create a newESP8266_EMParameter objectp_sensorDht22 forsensorDht22,

ESP8266_EMParameterp_sensorDht22(SensorDht22_Label,"DHT-22 Sensor","T",2, customhtml, WFM_LABEL_AFTER);

- p_sensorDht22                       : ESP8266_EMParameter class object reference that stores the new Custom Parameter- id => SensorDht22_Label             : var ref to Json associative name and HTML element ID for the new Custom Paramerter you just defined in step 1- placeholder => "DHT-22 Sensor"      : HTML input placeholder and/or label element text the user sees in the configuration interface for this Custom Parameter- defaultValue => "T"                 : variable for storing the value of your Custom Parameter in the file system or default value when no data is entered ("T" means `true`)- length  => 2                        : max allowed length you want for this Custom Parameter to have- custom => customhtml                : custom HTML code to add element type, e.g. `checkbox`, and `checked` when `sensorDht22 == true`- labelPlacement => WFM_LABEL_AFTER   : to place label after

char customhtml[24] ="type=\"checkbox\"";if (sensorDht22){strcat(customhtml," checked");}

3. Add the variables to Config Portal (CP)

3.1 addParameter() function Prototype:

//adds a custom parameterbooladdParameter(ESP8266_EMParameter *p);

3.2 Code to add variables to CP

//add all parameters hereESP8266_W5100_manager.addParameter(&p_thingspeakApiKey);ESP8266_W5100_manager.addParameter(&p_sensorDht22);ESP8266_W5100_manager.addParameter(&p_pinSda);ESP8266_W5100_manager.addParameter(&p_pinScl);

4. Save the variables configured in Config Portal (CP)

4.1 Getting variables' data from CP

// Getting posted form values and overriding local variables parameters// Config file is written regardless the connection statestrcpy(thingspeakApiKey, p_thingspeakApiKey.getValue());sensorDht22 = (strncmp(p_sensorDht22.getValue(),"T",1) ==0);pinSda = atoi(p_pinSda.getValue());pinScl = atoi(p_pinScl.getValue());

// Writing JSON config file to flash for next bootwriteConfigFile();

5. Write to FS (SPIFFS, LittleFS, etc.) using JSON format

boolwriteConfigFile(){  Serial.println("Saving config file");#if (ARDUINOJSON_VERSION_MAJOR >= 6)  DynamicJsonDocumentjson(1024);#else  DynamicJsonBuffer jsonBuffer;  JsonObject& json = jsonBuffer.createObject();#endif// JSONify local configuration parameters  json[ThingSpeakAPI_Label] = thingspeakApiKey;  json[SensorDht22_Label] = sensorDht22;  json[PinSDA_Label] = pinSda;  json[PinSCL_Label] = pinScl;// Open file for writing  File f = FileFS.open(CONFIG_FILE,"w");if (!f)  {    Serial.println("Failed to open config file for writing");returnfalse;  }#if (ARDUINOJSON_VERSION_MAJOR >= 6)serializeJsonPretty(json, Serial);// Write data to file and close itserializeJson(json, f);#else  json.prettyPrintTo(Serial);// Write data to file and close it  json.printTo(f);#endif  f.close();  Serial.println("\nConfig file was successfully saved");returntrue;}

5.1 Create a DynamicJsonDocument Object

DynamicJsonDocumentjson(1024);

5.2 Fill the DynamicJsonDocument Object with data got from Config Portal

json[Unique_Label] = Value_For_Unique_Label;

// JSONify local configuration parametersjson[ThingSpeakAPI_Label] = thingspeakApiKey;json[SensorDht22_Label]   = sensorDht22;json[PinSDA_Label]        = pinSda;json[PinSCL_Label]        = pinScl;

5.3 Open file to write the Jsonified data

#include<SPIFFS.h>FS* filesystem =      &SPIFFS;#defineFileFS        SPIFFSconstchar* CONFIG_FILE ="/ConfigSW.json";

// Open file for writingFile f = FileFS.open(CONFIG_FILE,"w");if (!f){  Serial.println("Failed to open config file for writing");returnfalse;}

5.4 Write the Jsonified data to CONFIG_FILE

// Write data to file and close itserializeJson(json, f);

5.5 Close CONFIG_FILE to flush and save the data

f.close();

6. Read from FS using JSON format

boolreadConfigFile(){// this opens the config file in read-mode  File f = FileFS.open(CONFIG_FILE,"r");if (!f)  {    Serial.println("Configuration file not found");returnfalse;  }else  {// we could open the filesize_t size = f.size();// Allocate a buffer to store contents of the file.    std::unique_ptr<char[]>buf(newchar[size +1]);// Read and store file contents in buf    f.readBytes(buf.get(), size);// Closing file    f.close();// Using dynamic JSON buffer which is not the recommended memory model, but anyway// See https://github.com/bblanchon/ArduinoJson/wiki/Memory%20model#if (ARDUINOJSON_VERSION_MAJOR >= 6)    DynamicJsonDocumentjson(1024);auto deserializeError =deserializeJson(json, buf.get());if ( deserializeError )    {      Serial.println("JSON parseObject() failed");returnfalse;    }serializeJson(json, Serial);#else    DynamicJsonBuffer jsonBuffer;// Parse JSON string    JsonObject& json = jsonBuffer.parseObject(buf.get());// Test if parsing succeeds.if (!json.success())    {      Serial.println("JSON parseObject() failed");returnfalse;    }    json.printTo(Serial);#endif// Parse all config file parameters, override// local config variables with parsed valuesif (json.containsKey(ThingSpeakAPI_Label))    {strcpy(thingspeakApiKey, json[ThingSpeakAPI_Label]);    }if (json.containsKey(SensorDht22_Label))    {      sensorDht22 = json[SensorDht22_Label];    }if (json.containsKey(PinSDA_Label))    {      pinSda = json[PinSDA_Label];    }if (json.containsKey(PinSCL_Label))    {      pinScl = json[PinSCL_Label];    }  }  Serial.println("\nConfig file was successfully parsed");returntrue;}

6.1 Open CONFIG_FILE to read

// this opens the config file in read-modeFile f = FileFS.open(CONFIG_FILE,"r");

if (!f){  Serial.println("Configuration file not found");returnfalse;}

6.2 Open CONFIG_FILE to read

// we could open the filesize_t size = f.size();// Allocate a buffer to store contents of the file.std::unique_ptr<char[]>buf(newchar[size +1]);

// Read and store file contents in buff.readBytes(buf.get(), size);// Closing filef.close();

6.3 Populate the just-read Jsonified data into the DynamicJsonDocument json object

DynamicJsonDocumentjson(1024);

auto deserializeError = deserializeJson(json, buf.get());

if ( deserializeError ){  Serial.println("JSON parseObject() failed");returnfalse;}serializeJson(json, Serial);

6.4 Parse the Jsonified data from the DynamicJsonDocument json object to store into corresponding parameters

if (json.containsKey(ThingSpeakAPI_Label))

// Parse all config file parameters, override// local config variables with parsed valuesif (json.containsKey(ThingSpeakAPI_Label)){strcpy(thingspeakApiKey, json[ThingSpeakAPI_Label]);}if (json.containsKey(SensorDht22_Label)){  sensorDht22 = json[SensorDht22_Label];}if (json.containsKey(PinSDA_Label)){  pinSda = json[PinSDA_Label];}if (json.containsKey(PinSCL_Label)){  pinScl = json[PinSCL_Label];}

6.5 Then what to do now

The application will use DHTsensor (either DHT11or DHT22) and need to connect to ThingSpeak with unique user's API Key. The DHT sensor is connected to the ESP boards using SDA/SCL pins which also need to be configurable.

So, how it works?

Documentation

Password protect the configuration Access Point

Callbacks

Save settings

ESP8266_W5100_manager.setSaveConfigCallback(saveConfigCallback);

//flag for saving databool shouldSaveConfig =false;//callback notifying us of the need to save configvoidsaveConfigCallback () {  Serial.println("Should save config");  shouldSaveConfig =true;}

ConfigPortal Timeout

ESP8266_W5100_manager.setConfigPortalTimeout(120);

On Demand ConfigPortal

voidloop(){// is configuration portal requested?if ((digitalRead(TRIGGER_PIN) == LOW) || (digitalRead(TRIGGER_PIN2) == LOW))  {    Serial.println(F("\nConfiguration portal requested."));digitalWrite(LED_BUILTIN, LED_ON);// turn the LED on by making the voltage LOW to tell us we are in configuration mode.//Local initialization. Once its business is done, there is no need to keep it around// Use this to default DHCP hostname to ESP8266-XXXXXX//ESP8266_W5100_Manager ESP8266_W5100_manager;// Use this to personalize DHCP hostname (RFC952 conformed)    ESP8266_W5100_ManagerESP8266_W5100_manager("ConfigOnSwitch");#if !USE_DHCP_IP#if USE_CONFIGURABLE_DNS// Set static IP, Gateway, Subnetmask, DNS1 and DNS2    ESP8266_W5100_manager.setSTAStaticIPConfig(stationIP, gatewayIP, netMask, dns1IP, dns2IP);#else// Set static IP, Gateway, Subnetmask, Use auto DNS1 and DNS2.    ESP8266_W5100_manager.setSTAStaticIPConfig(stationIP, gatewayIP, netMask);#endif#endif#if USING_CORS_FEATURE    ESP8266_W5100_manager.setCORSHeader("Your Access-Control-Allow-Origin");#endif//Check if there is stored credentials.//If not found, device will remain in configuration mode until switched off via webserver.    Serial.println(F("Opening configuration portal."));if (loadConfigData())    {//If no access point name has been previously entered disable timeout.      ESP8266_W5100_manager.setConfigPortalTimeout(120);      Serial.println(F("Got stored Credentials. Timeout 120s for Config Portal"));    }else    {// Enter CP only if no stored SSID on flash and file      ESP8266_W5100_manager.setConfigPortalTimeout(0);      Serial.println(F("Open Config Portal without Timeout: No stored Credentials."));      initialConfig =true;    }//Starts an access point//and goes into a blocking loop awaiting configurationif (!ESP8266_W5100_manager.startConfigPortal())      Serial.println(F("Not connected to ETH network but continuing anyway."));else    {      Serial.println(F("ETH network connected...yeey :)"));      Serial.print(F("Local IP:"));      Serial.println(eth.localIP());    }#if USE_ESP_ETH_MANAGER_NTP    String tempTZ = ESP8266_W5100_manager.getTimezoneName();if (strlen(tempTZ.c_str()) <sizeof(Ethconfig.TZ_Name) -1)strcpy(Ethconfig.TZ_Name, tempTZ.c_str());elsestrncpy(Ethconfig.TZ_Name, tempTZ.c_str(),sizeof(Ethconfig.TZ_Name) -1);constchar * TZ_Result = ESP8266_W5100_manager.getTZ(Ethconfig.TZ_Name);if (strlen(TZ_Result) <sizeof(Ethconfig.TZ) -1)strcpy(Ethconfig.TZ, TZ_Result);elsestrncpy(Ethconfig.TZ, TZ_Result,sizeof(Ethconfig.TZ_Name) -1);if (strlen(Ethconfig.TZ_Name) >0 )    {LOGERROR3(F("Saving current TZ_Name ="), Ethconfig.TZ_Name,F(", TZ ="), Ethconfig.TZ);configTime(Ethconfig.TZ,"pool.ntp.org");    }else    {LOGERROR(F("Current Timezone Name is not set. Enter Config Portal to set."));    }#endif    ESP8266_W5100_manager.getSTAStaticIPConfig(EthSTA_IPconfig);saveConfigData();#if !USE_DHCP_IP// Reset to use new Static IP, if different from current eth.localIP()if (eth.localIP() != EthSTA_IPconfig._sta_static_ip)    {      Serial.print(F("Current IP ="));      Serial.print(eth.localIP());      Serial.print(F(". Reset to take new IP ="));      Serial.println(EthSTA_IPconfig._sta_static_ip);      ESP.reset();delay(2000);    }#endifdigitalWrite(LED_BUILTIN, LED_OFF);// Turn led off as we are not in configuration mode.  }// put your main code here, to run repeatedlycheck_status();}

Custom Parameters

Custom IP Configuration

Custom Station (client) Static IP Configuration

ESP8266_W5100_manager.setSTAStaticIPConfig(IPAddress(192,168,2,186), IPAddress(192,168,2,1), IPAddress(255,255,255,0));

Custom HTML, CSS, Javascript

ESP8266_W5100_manager.setCustomHeadElement("<style>html{filter: invert(100%); -webkit-filter: invert(100%);}</style>");

ESP8266_EMParametercustom_text("<p>This is just a text paragraph</p>");ESP8266_W5100_manager.addParameter(&custom_text);

ESP8266_EMParametercustom_mqtt_server("server","mqtt server","iot.eclipse",40," readonly");

How to connect W5100 to ESP8266

// Using GPIO4, GPIO16, or GPIO5#defineCSPIN16

Examples

ExampleConfigOnSwitch

Debug Terminal Output Samples

1. ConfigOnDoubleReset_TZ using LittleFS on ESP8266_DEV with ESP8266_W5100

1.1 DRD => Config Portal

Starting ConfigOnDoubleReset_TZ using LittleFS on ESP8266_NODEMCU_ESP12E with ESP8266_W5100 EthernetESP8266_W5100_Manager v1.0.0ESP_DoubleResetDetector v1.3.2[EM] RFC925 Hostname = ConfigOnDoubleReset_TZ[EM] setSTAStaticIPConfig[EM] Set CORS Header to :  Your Access-Control-Allow-Origin[EM] LoadCfgFile [EM] OK[EM] stationIP = 192.168.2.186 , gatewayIP = 192.168.2.1[EM] netMask = 255.255.255.0[EM] dns1IP = 192.168.2.1 , dns2IP = 8.8.8.8Got stored Credentials. Timeout 120s for Config Portal[EM] Current TZ_Name = America/New_York , TZ =  EST5EDT,M3.2.0,M11.1.0[EM] Default SPI pinout:[EM] MOSI: 13[EM] MISO: 12[EM] SCK: 14[EM] CS: 16[EM] =========================Connecting to network : Ethernet Static IP address: 192.168.2.186LittleFS Flag read = 0xD0D01234doubleResetDetectedSaving config file...Saving config file OKOpen Config Portal without Timeout: Double Reset DetectedStarting configuration portal @ 192.168.2.186_domainName = *_resolvedIP = 192.168.2.186_port = 53[EM] _configPortalStart millis() = 354[EM] Config Portal IP address = 192.168.2.186[EM] HTTP server started[EM] startConfigPortal : Enter loop[EM] handleRoot[EM] captivePortal: hostHeader =  192.168.2.186[EM] Handle ETH[EM] Static IP = 192.168.2.186[EM] Sent config page[EM] ETH save[EM] TZ name = America/New_York[EM] New Static IP = 192.168.2.188[EM] New Static Gateway = 192.168.2.1[EM] New Static Netmask = 255.255.255.0[EM] New Static DNS1 = 192.168.2.1[EM] New Static DNS2 = 8.8.8.8[EM] Sent eth save page[EM] stopConfigPortalETH network connected...yeey :)[EM] Saving current TZ_Name = America/New_York , TZ =  EST5EDT,M3.2.0,M11.1.0[EM] getSTAStaticIPConfig[EM] SaveCfgFile [EM] stationIP = 192.168.2.188 , gatewayIP = 192.168.2.1[EM] netMask = 255.255.255.0[EM] dns1IP = 192.168.2.1 , dns2IP = 8.8.8.8[EM] OKCurrent IP = 192.168.2.186. Reset to take new IP = 192.168.2.188ets Jan  8 2013,rst cause:2, boot mode:(3,6)

1.2. Get new Static IP after reset

Starting ConfigOnDoubleReset_TZ using LittleFS on ESP8266_NODEMCU_ESP12E with ESP8266_W5100 EthernetESP8266_W5100_Manager v1.0.0ESP_DoubleResetDetector v1.3.2[EM] RFC925 Hostname = ConfigOnDoubleReset_TZ[EM] setSTAStaticIPConfig[EM] Set CORS Header to :  Your Access-Control-Allow-Origin[EM] LoadCfgFile [EM] OK[EM] stationIP = 192.168.2.188 , gatewayIP = 192.168.2.1[EM] netMask = 255.255.255.0[EM] dns1IP = 192.168.2.1 , dns2IP = 8.8.8.8Got stored Credentials. Timeout 120s for Config Portal[EM] Current TZ_Name = America/New_York , TZ =  EST5EDT,M3.2.0,M11.1.0[EM] Default SPI pinout:[EM] MOSI: 13[EM] MISO: 12[EM] SCK: 14[EM] CS: 16[EM] =========================Connecting to network : Ethernet Static IP address: 192.168.2.188LittleFS Flag read = 0xD0D04321No doubleResetDetectedSaving config file...Saving config file OKAfter waiting 0.00 secs more in setup(), connection result is connected. Local IP: 192.168.2.188[EM] freeing allocated params!Stop doubleResetDetectingSaving config file...Saving config file OKLocal Date/Time: Sun Dec 11 20:09:39 2022Local Date/Time: Sun Dec 11 20:10:39 2022

2. ConfigOnSwichFS using LittleFS on ESP8266_DEV with ESP8266_W5100

Starting ConfigOnSwichFS using LittleFS on ESP8266_NODEMCU_ESP12E with ESP8266_W5100 EthernetESP8266_W5100_Manager v1.0.0{"thingspeakApiKey":"","SensorDHT22":true,"PinSda":4,"PinScl":5}Config file was successfully parsed[EM] RFC925 Hostname = ConfigOnSwitchFS[EM] setSTAStaticIPConfig[EM] Set CORS Header to :  Your Access-Control-Allow-Origin[EM] LoadCfgFile [EM] OK[EM] stationIP = 192.168.2.186 , gatewayIP = 192.168.2.1[EM] netMask = 255.255.255.0[EM] dns1IP = 192.168.2.1 , dns2IP = 8.8.8.8Got stored Credentials. Timeout 120s for Config PortalCurrent Timezone is not set. Enter Config Portal to set.[EM] Default SPI pinout:[EM] MOSI: 13[EM] MISO: 12[EM] SCK: 14[EM] CS: 16[EM] =========================Connecting to network : Ethernet Static IP address: 192.168.2.186After waiting 0.00 secs more in setup(), connection result is connected. Local IP: 192.168.2.186[EM] freeing allocated params!Configuration portal requested.[EM] RFC925 Hostname = ConfigOnSwitchFSOpening configuration portal. [EM] LoadCfgFile [EM] OK[EM] stationIP = 192.168.2.186 , gatewayIP = 192.168.2.1[EM] netMask = 255.255.255.0[EM] dns1IP = 192.168.2.1 , dns2IP = 8.8.8.8Got stored Credentials. Timeout 120s for Config Portal[EM] Adding parameter thingspeakApiKey[EM] Adding parameter SensorDHT22[EM] Adding parameter PinSda[EM] Adding parameter PinScl[EM] setSTAStaticIPConfig for USE_CONFIGURABLE_DNS[EM] Set CORS Header to :  Your Access-Control-Allow-Origin[EM] _configPortalStart millis() = 26788[EM] Config Portal IP address = 192.168.2.186[EM] HTTP server started[EM] startConfigPortal : Enter loop[EM] handleRoot[EM] request host IP = 192.168.2.186[EM] Info[EM] Info page sent[EM] handleRoot[EM] request host IP = 192.168.2.186[EM] Handle ETH[EM] Static IP = 192.168.2.186[EM] Sent config page[EM] ETH save[EM] TZ = America/Toronto[EM] Parameter and value : thingspeakApiKey [EM] Parameter and value : SensorDHT22 T[EM] Parameter and value : PinSda 4[EM] Parameter and value : PinScl 5[EM] New Static IP = 192.168.2.186[EM] New Static Gateway = 192.168.2.1[EM] New Static Netmask = 255.255.255.0[EM] New Static DNS1 = 192.168.2.1[EM] New Static DNS2 = 8.8.8.8[EM] Sent eth save page[EM] stopConfigPortalETH network connected...yeey :)Local IP: 192.168.2.186[EM] Saving current TZ_Name = America/Toronto , TZ =  EST5EDT,M3.2.0,M11.1.0[EM] getSTAStaticIPConfig[EM] SaveCfgFile [EM] stationIP = 192.168.2.186 , gatewayIP = 192.168.2.1[EM] netMask = 255.255.255.0[EM] dns1IP = 192.168.2.1 , dns2IP = 8.8.8.8[EM] OKSaving config file{  "thingspeakApiKey": "",  "SensorDHT22": true,  "PinSda": 4,  "PinScl": 5}Config file was successfully savedCurrent IP = 192.168.2.186. Reset to take new IP = 192.168.2.186ets Jan  8 2013,rst cause:2, boot mode:(3,6)...Starting ConfigOnSwichFS using LittleFS on ESP8266_NODEMCU_ESP12E with ESP8266_W5100 EthernetESP8266_W5100_Manager v1.0.0{"thingspeakApiKey":"","SensorDHT22":true,"PinSda":4,"PinScl":5}Config file was successfully parsed[EM] RFC925 Hostname = ConfigOnSwitchFS[EM] setSTAStaticIPConfig[EM] Set CORS Header to :  Your Access-Control-Allow-Origin[EM] LoadCfgFile [EM] OK[EM] stationIP = 192.168.2.186 , gatewayIP = 192.168.2.1[EM] netMask = 255.255.255.0[EM] dns1IP = 192.168.2.1 , dns2IP = 8.8.8.8Got stored Credentials. Timeout 120s for Config Portal[EM] Current TZ_Name = America/Toronto , TZ =  EST5EDT,M3.2.0,M11.1.0[EM] Default SPI pinout:[EM] MOSI: 13[EM] MISO: 12[EM] SCK: 14[EM] CS: 16[EM] =========================Connecting to network : Ethernet Static IP address: 192.168.2.186After waiting 0.00 secs more in setup(), connection result is connected. Local IP: 192.168.2.186[EM] freeing allocated params!Local Date/Time: Sun Dec 11 20:19:39 2022Local Date/Time: Sun Dec 11 20:20:39 2022

3. ESP8266_FSWebServer_DRD using LittleFS on ESP8266_DEV with ESP8266_W5100

for file in `\ls -A1`; do curl -F "file=@$PWD/$file" 192.168.2.186/edit; done

Starting ESP_FSWebServer_DRDusing LittleFS on ESP8266_NODEMCU_ESP12E with ESP8266_W5100 EthernetESP8266_W5100_Manager v1.0.0ESP_DoubleResetDetector v1.3.2Opening / directoryFS File: PM2_5_Log.csv, size: 40BFS File: drd.dat, size: 4BFS File: eth_cred.dat, size: 142BFS File: timezone.dat, size: 32B[EM] RFC925 Hostname = ESP-FSWebServerDRD[EM] setSTAStaticIPConfig[EM] Set CORS Header to :  Your Access-Control-Allow-Origin[EM] LoadCfgFile [EM] OK[EM] stationIP =192.168.2.186 , gatewayIP =192.168.2.1[EM] netMask =255.255.255.0[EM] dns1IP =192.168.2.1 , dns2IP =8.8.8.8[EM] Default SPI pinout:[EM] MOSI:13[EM] MISO:12[EM] SCK:14[EM] CS:16[EM] =========================Connecting to network : Ethernet Static IP address:192.168.2.186LittleFS Flag read =0xD0D04321No doubleResetDetectedSaving config file...Saving config file OKAfter waiting0.00 secs more insetup(), connection result is connected. Local IP: 192.168.2.186HTTP server started @ 192.168.2.186===============================================================Open http://192.168.2.186/edit.htm to see the file browserUsing username = admin and password = admin===============================================================[EM] freeing allocated params!Stop doubleResetDetectingSaving config file...Saving config file OKhandleFileRead: /handleFileRead: /edit.htmhandleFileRead: /edit.htmhandleFileRead: /handleFileUpload Name: /CanadaFlag_1.pnghandleFileUpload Size: 41214handleFileUpload Name: /CanadaFlag_2.pnghandleFileUpload Size: 8311handleFileUpload Name: /CanadaFlag_3.jpghandleFileUpload Size: 11156handleFileUpload Name: /edit.htm.gzhandleFileUpload Size: 4116handleFileUpload Name: /favicon.icohandleFileUpload Size: 1150handleFileUpload Name: /graphs.js.gzhandleFileUpload Size: 1971handleFileUpload Name: /index.htmhandleFileUpload Size: 3721handleFileRead: /handleFileRead: /graphs.jshandleFileRead: /edit.htmhandleFileRead: /index.htmhandleFileList: /handleFileRead: /CanadaFlag_1.png

Starting ESP_FSWebServer_DRD using LittleFS on ESP8266_NODEMCU_ESP12E with ESP8266_W5100 EthernetESP8266_W5100_Manager v1.0.0ESP_DoubleResetDetector v1.3.2Opening / directoryFS File: CanadaFlag_1.png, size: 40.25KBFS File: CanadaFlag_2.png, size: 8.12KBFS File: CanadaFlag_3.jpg, size: 10.89KBFS File: PM2_5_Log.csv, size: 40BFS File: drd.dat, size: 4BFS File: edit.htm.gz, size: 4.02KBFS File: eth_cred.dat, size: 142BFS File: favicon.ico, size: 1.12KBFS File: graphs.js.gz, size: 1.92KBFS File: index.htm, size: 3.63KBFS File: timezone.dat, size: 32B[EM] RFC925 Hostname = ESP-FSWebServerDRD[EM] setSTAStaticIPConfig[EM] Set CORS Header to :  Your Access-Control-Allow-Origin[EM] LoadCfgFile [EM] OK[EM] stationIP = 192.168.2.186 , gatewayIP = 192.168.2.1[EM] netMask = 255.255.255.0[EM] dns1IP = 192.168.2.1 , dns2IP = 8.8.8.8[EM] Default SPI pinout:[EM] MOSI: 13[EM] MISO: 12[EM] SCK: 14[EM] CS: 16[EM] =========================Connecting to network : Ethernet Static IP address: 192.168.2.186LittleFS Flag read = 0xD0D04321No doubleResetDetectedSaving config file...Saving config file OKAfter waiting 0.00 secs more in setup(), connection result is connected. Local IP: 192.168.2.186HTTP server started @ 192.168.2.186===============================================================Open http://192.168.2.186/edit.htm to see the file browserUsing username = admin and password = admin===============================================================[EM] freeing allocated params!

Debug

ESP8266_W5100_manager.setDebugOutput(false);

// Use from 0 to 4. Higher number, more debugging messages and memory usage.#define_ESP8266_ETH_MGR_LOGLEVEL_3

Troubleshooting

Issues

Contributions and Thanks

Contributing

License and credits

Copyright