v1.4.1 for ESP8266 using W5x00/ENC28J60 Ethernet

#### Releases v1.4.1

1. Initial coding to port [ESPAsyncWebServer](https://github.com/me-no-dev/ESPAsyncWebServer) to ESP8266 boards using W5x00 / ENC28J60 Ethernet.
2. Add more examples.
3. Add debugging features.
4. Bump up to v1.4.1 to sync with [AsyncWebServer_WT32_ETH01 v1.4.1](https://github.com/khoih-prog/AsyncWebServer_WT32_ETH01).

Author: khoih-prog

CONTRIBUTING.md

@@ -0,0 +1,54 @@
+## Contributing to AsyncWebServer_Ethernet
+
+### Reporting Bugs
+
+Please report bugs in AsyncWebServer_Ethernet if you find them.
+
+However, before reporting a bug please check through the following:
+
+* [Existing Open Issues](https://github.com/khoih-prog/AsyncWebServer_Ethernet/issues) - someone might have already encountered this.
+
+If you don't find anything, please [open a new issue](https://github.com/khoih-prog/AsyncWebServer_Ethernet/issues/new).
+
+### How to submit a bug report
+
+Please ensure to specify the following:
+
+* Arduino IDE version (e.g. 1.8.19) or Platform.io version
+* Board Core Version (e.g. ESP8266 core v3.0.2)
+* Contextual information (e.g. what you were trying to achieve)
+* Simplest possible steps to reproduce
+* Anything that might be relevant in your opinion, such as:
+  * Operating system (Windows, Ubuntu, etc.) and the output of `uname -a`
+  * Network configuration
+
+
+### Example
+
+```
+Arduino IDE version: 1.8.19
+ESP8266_NODEMCU_ESP12E using ESP8266_W5500 Ethernet
+ESP8266 core v3.0.2
+OS: Ubuntu 20.04 LTS
+Linux xy-Inspiron-3593 5.13.0-39-generic #44~20.04.1-Ubuntu SMP Thu Mar 24 16:43:35 UTC 2022 x86_64 x86_64 x86_64 GNU/Linux
+
+Context:
+I encountered a crash while trying to use the Timer Interrupt.
+
+Steps to reproduce:
+1. ...
+2. ...
+3. ...
+4. ...
+```
+
+### Sending Feature Requests
+
+Feel free to post feature requests. It's helpful if you can explain exactly why the feature would be useful.
+
+There are usually some outstanding feature requests in the [existing issues list](https://github.com/khoih-prog/AsyncWebServer_Ethernet/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement), feel free to add comments to them.
+
+### Sending Pull Requests
+
+Pull Requests with changes and fixes are also welcome!
+

LICENSE

@@ -1,7 +1,7 @@
                     GNU GENERAL PUBLIC LICENSE
                        Version 3, 29 June 2007
 
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
@@ -645,7 +645,7 @@ the "copyright" line and a pointer to where the full notice is found.
     GNU General Public License for more details.
 
     You should have received a copy of the GNU General Public License
-    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 Also add information on how to contact you by electronic and paper mail.
 
@@ -664,11 +664,11 @@ might be different; for a GUI interface, you would use an "about box".
   You should also get your employer (if you work as a programmer) or school,
 if any, to sign a "copyright disclaimer" for the program, if necessary.
 For more information on this, and how to apply and follow the GNU GPL, see
-<https://www.gnu.org/licenses/>.
+<http://www.gnu.org/licenses/>.
 
   The GNU General Public License does not permit incorporating your program
 into proprietary programs.  If your program is a subroutine library, you
 may consider it more useful to permit linking proprietary applications with
 the library.  If this is what you want to do, use the GNU Lesser General
 Public License instead of this License.  But first, please read
-<https://www.gnu.org/licenses/why-not-lgpl.html>.
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.

README.md

@@ -0,0 +1,28 @@
+# AsyncWebServer_Ethernet
+
+[![arduino-library-badge](https://www.ardu-badge.com/badge/AsyncWebServer_Ethernet.svg?)](https://www.ardu-badge.com/AsyncWebServer_Ethernet)
+[![GitHub release](https://img.shields.io/github/release/khoih-prog/AsyncWebServer_Ethernet.svg)](https://github.com/khoih-prog/AsyncWebServer_Ethernet/releases)
+[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](#Contributing)
+[![GitHub issues](https://img.shields.io/github/issues/khoih-prog/AsyncWebServer_Ethernet.svg)](http://github.com/khoih-prog/AsyncWebServer_Ethernet/issues)
+
+---
+---
+
+## Table of contents
+
+* [Changelog](#changelog)
+  * [Releases v1.4.1](#releases-v141)
+
+---
+---
+
+## Changelog
+
+#### Releases v1.4.1
+
+1. Initial coding to port [ESPAsyncWebServer](https://github.com/me-no-dev/ESPAsyncWebServer) to ESP8266 boards using W5x00 / ENC28J60 Ethernet.
+2. Add more examples.
+3. Add debugging features.
+4. Bump up to v1.4.1 to sync with [AsyncWebServer_WT32_ETH01 v1.4.1](https://github.com/khoih-prog/AsyncWebServer_WT32_ETH01).
+
+

changelog.md

@@ -0,0 +1,202 @@
+/****************************************************************************************************************************
+  AsyncMultiWebServer.h
+  
+  For ESP8266 using W5x00/ENC8266 Ethernet
+   
+  AsyncWebServer_Ethernet is a library for the Ethernet with lwIP_5100, lwIP_5500 or lwIP_enc28j60 library
+  
+  Based on and modified from ESPAsyncWebServer (https://github.com/me-no-dev/ESPAsyncWebServer)
+  Built by Khoi Hoang https://github.com/khoih-prog/AsyncWebServer_Ethernet
+  Licensed under GPLv3 license
+ *****************************************************************************************************************************/
+
+#include "defines.h"
+
+#include <AsyncWebServer_Ethernet.h>
+
+unsigned int    analogReadPin []  = { 12, 13, 14 };
+
+#define BUFFER_SIZE       512
+
+#define HTTP_PORT1        8080
+#define HTTP_PORT2        8081
+#define HTTP_PORT3        8082
+
+AsyncWebServer* server1;
+AsyncWebServer* server2;
+AsyncWebServer* server3;
+
+AsyncWebServer*  multiServer  []  = { server1, server2, server3 };
+uint16_t        http_port     []  = { HTTP_PORT1, HTTP_PORT2, HTTP_PORT3 };
+
+#define NUM_SERVERS     ( sizeof(multiServer) / sizeof(AsyncWebServer*) )
+
+unsigned int serverIndex;
+
+String createBuffer()
+{
+  char temp[BUFFER_SIZE];
+
+  memset(temp, 0, sizeof(temp));
+
+  int sec = millis() / 1000;
+  int min = sec / 60;
+  int hr = min / 60;
+  int day = hr / 24;
+
+  snprintf(temp, BUFFER_SIZE - 1,
+           "<html>\
+<head>\
+<meta http-equiv='refresh' content='5'/>\
+<title>%s</title>\
+<style>\
+body { background-color: #cccccc; font-family: Arial, Helvetica, Sans-Serif; Color: #000088; }\
+</style>\
+</head>\
+<body>\
+<h1>Hello from %s</h1>\
+<h2>running AsyncWebServer_Ethernet</h2>\
+<h3>on %s</h3>\
+<h3>Uptime: %d d %02d:%02d:%02d</h3>\
+</body>\
+</html>", BOARD_NAME, BOARD_NAME, SHIELD_TYPE, day, hr, min % 60, sec % 60);
+
+  return temp;
+}
+
+
+void handleRoot(AsyncWebServerRequest * request)
+{
+  String message = createBuffer();
+  request->send(200, F("text/html"), message);
+}
+
+String createNotFoundBuffer(AsyncWebServerRequest * request)
+{
+  String message;
+
+  message.reserve(500);
+
+  message = F("File Not Found\n\n");
+
+  message += F("URI: ");
+  message += request->url();
+  message += F("\nMethod: ");
+  message += (request->method() == HTTP_GET) ? F("GET") : F("POST");
+  message += F("\nArguments: ");
+  message += request->args();
+  message += F("\n");
+
+  for (uint8_t i = 0; i < request->args(); i++)
+  {
+    message += " " + request->argName(i) + ": " + request->arg(i) + "\n";
+  }
+
+  return message;
+}
+
+void handleNotFound(AsyncWebServerRequest * request)
+{
+  String message = createNotFoundBuffer(request);
+  request->send(404, F("text/plain"), message);
+}
+
+void initEthernet()
+{
+  SPI.begin();
+  SPI.setClockDivider(SPI_CLOCK_DIV4);
+  SPI.setBitOrder(MSBFIRST);
+  SPI.setDataMode(SPI_MODE0);
+
+#if !USING_DHCP
+  eth.config(localIP, gateway, netMask, gateway);
+#endif
+  
+  eth.setDefault();
+  
+  if (!eth.begin()) 
+  {
+    Serial.println("No Ethernet hardware ... Stop here");
+    
+    while (true) 
+    {
+      delay(1000);
+    }
+  } 
+  else 
+  {
+    Serial.print("Connecting to network : ");
+    
+    while (!eth.connected()) 
+    {
+      Serial.print(".");
+      delay(1000);
+    }
+  }
+ 
+  Serial.println();
+
+#if USING_DHCP  
+  Serial.print("Ethernet DHCP IP address: ");
+#else
+  Serial.print("Ethernet Static IP address: ");
+#endif
+  
+  Serial.println(eth.localIP());
+}
+
+void setup()
+{
+  Serial.begin(115200);
+  while (!Serial && millis() < 5000);
+
+  delay(200);
+
+  Serial.print("\nStart AsyncMultiWebServer on "); Serial.print(BOARD_NAME);
+  Serial.print(" with "); Serial.println(SHIELD_TYPE);
+  Serial.println(ASYNC_WEBSERVER_ETHERNET_VERSION);
+
+  initEthernet();
+  
+  for (serverIndex = 0; serverIndex < NUM_SERVERS; serverIndex++)
+  {
+    multiServer[serverIndex] = new AsyncWebServer(http_port[serverIndex]);  
+
+    if (multiServer[serverIndex])
+    {
+      Serial.printf("Initialize multiServer OK, serverIndex = %d, port = %d\n", serverIndex, http_port[serverIndex]);
+    }
+    else
+    {
+      Serial.printf("Error initialize multiServer, serverIndex = %d\n", serverIndex);
+
+      while(1);
+    }
+
+    multiServer[serverIndex]->on("/", HTTP_GET, [](AsyncWebServerRequest * request)
+    {
+      handleRoot(request);
+    });
+
+    multiServer[serverIndex]->on("/hello", HTTP_GET, [](AsyncWebServerRequest * request) 
+    {     
+      String message = F("Hello from AsyncWebServer using built-in LAN8742A Ethernet, running on ");
+      message       += BOARD_NAME;
+      
+      request->send(200, "text/plain", message);
+    });
+      
+    multiServer[serverIndex]->onNotFound([](AsyncWebServerRequest * request) 
+    {
+      handleNotFound(request);
+    });
+
+    multiServer[serverIndex]->begin();
+
+    Serial.printf("HTTP server started at ports %d\n", http_port[serverIndex]);
+  }
+}
+
+void loop()
+{
+}

examples/AsyncMultiWebServer/AsyncMultiWebServer.ino

@@ -0,0 +1,73 @@
+/****************************************************************************************************************************
+  defines.h
+  
+  For ESP8266 using W5x00/ENC8266 Ethernet
+   
+  AsyncWebServer_Ethernet is a library for the Ethernet with lwIP_5100, lwIP_5500 or lwIP_enc28j60 library
+  
+  Based on and modified from ESPAsyncWebServer (https://github.com/me-no-dev/ESPAsyncWebServer)
+  Built by Khoi Hoang https://github.com/khoih-prog/AsyncWebServer_Ethernet
+  Licensed under GPLv3 license
+ ***************************************************************************************************************************************/
+
+#ifndef defines_h
+#define defines_h
+
+#if defined(ESP8266)
+  #define LED_ON      LOW
+  #define LED_OFF     HIGH
+#else
+  #error Only ESP8266
+#endif  
+
+#define _AWS_ETHERNET_LOGLEVEL_               1
+
+//////////////////////////////////////////////////////////
+
+#define USING_W5500         true
+#define USING_W5100         false
+#define USING_ENC28J60      false
+
+#include <SPI.h>
+
+#define CSPIN       16      // 5
+
+#if USING_W5500
+  #include "W5500lwIP.h"
+  #define SHIELD_TYPE       "ESP8266_W5500 Ethernet"
+  
+  Wiznet5500lwIP eth(CSPIN); 
+   
+#elif USING_W5100
+  #include <W5100lwIP.h>
+  #define SHIELD_TYPE       "ESP8266_W5100 Ethernet"
+  
+  Wiznet5100lwIP eth(CSPIN);
+
+#elif USING_ENC28J60
+  #include <ENC28J60lwIP.h>
+  #define SHIELD_TYPE       "ESP8266_ENC28J60 Ethernet"
+  
+  ENC28J60lwIP eth(CSPIN);
+#else
+  // default if none selected
+  #include "W5500lwIP.h"
+
+  Wiznet5500lwIP eth(CSPIN);
+#endif
+
+#include <WiFiClient.h> // WiFiClient (-> TCPClient)
+
+using TCPClient = WiFiClient;
+
+//////////////////////////////////////////////////////////
+
+#define USING_DHCP        true
+
+#if !USING_DHCP
+  IPAddress localIP(192, 168, 2, 222);
+  IPAddress gateway(192, 168, 2, 1);
+  IPAddress netMask(255, 255, 255, 0);
+#endif
+
+#endif    //defines_h