v1.3.0 to support core v2.0.0

#### Releases v1.3.0

##### Warning: Releases v1.3.0+ can be used for either ESP32 core v2.0.0+ or v1.0.6-. Default is v2.0.0+ now

1. Making compatible either with breaking core v2.0.0+ or core v1.0.6-
2. Renew examples

Author: khoih-prog

README.md

@@ -12,6 +12,7 @@
 
 * [Table of contents](#table-of-contents)
 * [Why do we need this AsyncWebServer_WT32_ETH01 library](#why-do-we-need-this-asyncwebserver_wt32_eth01-library)
+  * [Important notes](#Important-notes)
   * [Features](#features)
   * [Why Async is better](#why-async-is-better)
   * [Currently supported Boards](#currently-supported-boards)
@@ -97,6 +98,25 @@
 
 ### Why do we need this [AsyncWebServer_WT32_ETH01 library](https://github.com/khoih-prog/AsyncWebServer_WT32_ETH01)
 
+#### Important notes
+
+ESP32 Core v2.0.0 introduces new `arduino_event_id_t` enum, breaking almost all `WT32_ETH01` codes written for core v1.0.6-.
+
+It's really strange to define that breaking enum `arduino_event_id_t` in [**WiFiGeneric.h**#L36-L78](https://github.com/espressif/arduino-esp32/blob/master/libraries/WiFi/src/WiFiGeneric.h#L36-L78), compared to the old `system_event_id_t`, now placed in [**esp_event_legacy.h**#L29-L63](https://github.com/espressif/arduino-esp32/blob/master/tools/sdk/esp32/include/esp_event/include/esp_event_legacy.h#L29-L63)
+
+It's better to preserve the old enum order and just adding new items **to do no harm to pre-2.0.0 codes**
+
+- Releases v1.2.5- to be used for ESP32 core v1.0.6- only
+- Releases v1.3.0+ can be used for either ESP32 core v2.0.0+ or v1.0.6-. **Default is using core v2.0.0+**
+
+To use with core v1.0.6-, just define in your sketch
+
+```
+#define USING_CORE_ESP32_CORE_V200_PLUS       false
+```
+
+---
+
 #### Features
 
 This library is based on, modified from:
@@ -134,9 +154,11 @@ to apply the better and faster **asynchronous** feature of the **powerful** [ESP
 
 ## Prerequisites
 
- 1. [`Arduino IDE 1.8.16+`](https://www.arduino.cc/en/Main/Software)
- 2. [`ESP32 Core 2.0.0+`](https://github.com/espressif/arduino-esp32) for ESP32-based boards. [![Latest release](https://img.shields.io/github/release/espressif/arduino-esp32.svg)](https://github.com/espressif/arduino-esp32/releases/latest/)
- 3. [`AsyncTCP library v1.1.1+`](https://github.com/me-no-dev/AsyncTCP).
+ 1. [`Arduino IDE 1.8.16+` for Arduino](https://www.arduino.cc/en/Main/Software)
+ 2. [`ESP32 Core 2.0.0+`](https://github.com/espressif/arduino-esp32) for ESP32-based WT32_ETH01 boards using release v1.3.0+. [![Latest release](https://img.shields.io/github/release/espressif/arduino-esp32.svg)](https://github.com/espressif/arduino-esp32/releases/latest/)
+ 3. [`ESP32 Core 1.0.6-`](https://github.com/espressif/arduino-esp32) for ESP32-based WT32_ETH01 boards using release v1.2.5- [![Latest release](https://img.shields.io/github/release/espressif/arduino-esp32.svg)](https://github.com/espressif/arduino-esp32/releases/latest/)
+ 
+ 4. [`AsyncTCP library v1.1.1+`](https://github.com/me-no-dev/AsyncTCP).
 
 ---
 
@@ -1328,6 +1350,9 @@ build_flags =
   #error This code is designed for WT32_ETH01 to run on ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+// Uncomment to use ESP32 core v1.0.6-
+//#define USING_CORE_ESP32_CORE_V200_PLUS     false
+
 #include <Arduino.h>
 
 #define _ASYNC_WEBSERVER_LOGLEVEL_       4
@@ -1488,12 +1513,12 @@ You can access the Async Advanced WebServer @ the server IP
 
 #### 1. AsyncMultiWebServer_WT32_ETH01 on WT32-ETH01 with ETH_PHY_LAN8720
 
-Following are debug terminal output and screen shots when running example [AsyncMultiWebServer_WT32_ETH01](examples/AsyncMultiWebServer_WT32_ETH01) on WT32-ETH01 with ETH_PHY_LAN8720 to demonstrate the operation of 3 independent AsyncWebServers on 3 different ports and how to handle the complicated AsyncMultiWebServers.
+Following are debug terminal output and screen shots when running example [AsyncMultiWebServer_WT32_ETH01](examples/AsyncMultiWebServer_WT32_ETH01) on WT32-ETH01 with ETH_PHY_LAN8720, using EP32 core v2.0.0, to demonstrate the operation of 3 independent AsyncWebServers on 3 different ports and how to handle the complicated AsyncMultiWebServers.
 
 
 ```
 Starting AsyncMultiWebServer_WT32_ETH01 on WT32-ETH01 with ETH_PHY_LAN8720
-AsyncWebServer_WT32_ETH01 v1.2.5
+AsyncWebServer_WT32_ETH01 v1.3.0 for core v2.0.0+
 ETH MAC: A8:03:2A:A1:61:73, IPv4: 192.168.2.232
 FULL_DUPLEX, 100Mbps
 

changelog.md

@@ -11,6 +11,7 @@
 ## Table of contents
 
 * [Changelog](#changelog)
+  * [Releases v1.3.0](#releases-v130)
   * [Releases v1.2.5](#releases-v125)
   * [Releases v1.2.4](#releases-v124)
   * [Releases v1.2.3](#releases-v123)
@@ -21,8 +22,18 @@
 
 ## Changelog
 
+#### Releases v1.3.0
+
+##### Warning: Releases v1.3.0+ can be used for either ESP32 core v2.0.0+ or v1.0.6-. Default is v2.0.0+ now
+
+1. Making compatible either with breaking core v2.0.0+ or core v1.0.6-
+2. Renew examples
+
+
 ### Releases v1.2.5
 
+##### Warning: Releases v1.2.5- to be used for ESP32 core v1.0.6- only
+
 1. Update `platform.ini` and `library.json` to use original `khoih-prog` instead of `khoih.prog` after PIO fix
 
 

examples/AsyncFSBrowser_WT32_ETH01/AsyncFSBrowser_WT32_ETH01.ino

@@ -19,7 +19,10 @@
     #error Must use ESP32 core v1.0.6-, with MBEDTLS_VERSION_NUMBER < v2.7.0
   #endif
 
-#endif  
+#endif
+
+// Uncomment to use ESP32 core v1.0.6-
+//#define USING_CORE_ESP32_CORE_V200_PLUS     false
 
 #include <Arduino.h>
 

examples/AsyncMultiWebServer_WT32_ETH01/AsyncMultiWebServer_WT32_ETH01.ino

@@ -14,6 +14,9 @@
   #error This code is designed for WT32_ETH01 to run on ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+// Uncomment to use ESP32 core v1.0.6-
+//#define USING_CORE_ESP32_CORE_V200_PLUS     false
+
 #include <Arduino.h>
 
 #define _ASYNC_WEBSERVER_LOGLEVEL_       4

examples/AsyncSimpleServer_WT32_ETH01/AsyncSimpleServer_WT32_ETH01.ino

@@ -27,6 +27,9 @@
   #error This code is designed for WT32_ETH01 to run on ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+// Uncomment to use ESP32 core v1.0.6-
+//#define USING_CORE_ESP32_CORE_V200_PLUS     false
+
 #include <Arduino.h>
 
 #define _ASYNC_WEBSERVER_LOGLEVEL_       4

examples/Async_AdvancedWebServer/Async_AdvancedWebServer.ino

@@ -42,6 +42,9 @@
   #error This code is designed for WT32_ETH01 to run on ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+// Uncomment to use ESP32 core v1.0.6-
+//#define USING_CORE_ESP32_CORE_V200_PLUS     false
+
 #include <Arduino.h>
 
 #define _ASYNC_WEBSERVER_LOGLEVEL_       4

examples/Async_HelloServer/Async_HelloServer.ino

@@ -14,6 +14,9 @@
   #error This code is designed for WT32_ETH01 to run on ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+// Uncomment to use ESP32 core v1.0.6-
+//#define USING_CORE_ESP32_CORE_V200_PLUS     false
+
 #include <Arduino.h>
 
 #define _ASYNC_WEBSERVER_LOGLEVEL_       4

examples/Async_HelloServer2/Async_HelloServer2.ino

@@ -14,6 +14,9 @@
   #error This code is designed for WT32_ETH01 to run on ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+// Uncomment to use ESP32 core v1.0.6-
+//#define USING_CORE_ESP32_CORE_V200_PLUS     false
+
 #include <Arduino.h>
 
 #define _ASYNC_WEBSERVER_LOGLEVEL_       4

examples/Async_PostServer/Async_PostServer.ino

@@ -14,6 +14,9 @@
   #error This code is designed for WT32_ETH01 to run on ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+// Uncomment to use ESP32 core v1.0.6-
+//#define USING_CORE_ESP32_CORE_V200_PLUS     false
+
 #include <Arduino.h>
 
 #define _ASYNC_WEBSERVER_LOGLEVEL_       4

examples/Async_RegexPatterns_WT32_ETH01/Async_RegexPatterns_WT32_ETH01.ino

@@ -33,6 +33,9 @@
   #error This code is designed for WT32_ETH01 to run on ESP32 platform! Please check your Tools->Board setting.
 #endif
 
+// Uncomment to use ESP32 core v1.0.6-
+//#define USING_CORE_ESP32_CORE_V200_PLUS     false
+
 #include <Arduino.h>
 
 #define _ASYNC_WEBSERVER_LOGLEVEL_       4