v1.0.1 to use SPI_DMA_CH_AUTO

#### Releases v1.0.1

1. Using `SPI_DMA_CH_AUTO` instead of manually selected
2. Add example [multiFileProject]](https://github.com/khoih-prog/WebServer_ESP32_SC_W5500/tree/main/examples/multiFileProject)

Author: khoih-prog

README.md

@@ -25,6 +25,7 @@
   * [VS Code & PlatformIO](#vs-code--platformio)
 * [Libraries' Patches](#libraries-patches)
   * [1. For fixing ESP32 compile error](#1-for-fixing-esp32-compile-error)
+* [HOWTO Fix `Multiple Definitions` Linker Error](#howto-fix-multiple-definitions-linker-error)
 * [HOWTO Use analogRead() with ESP32 running WiFi and/or BlueTooth (BT/BLE)](#howto-use-analogread-with-esp32-running-wifi-andor-bluetooth-btble)
   * [1. ESP32 has 2 ADCs, named ADC1 and ADC2](#1--esp32-has-2-adcs-named-adc1-and-adc2)
   * [2. ESP32 ADCs functions](#2-esp32-adcs-functions)
@@ -50,6 +51,7 @@
     * [12. WebClient](examples/WebClient)
     * [13. WebClientRepeating](examples/WebClientRepeating)
     * [14. WebServer](examples/WebServer)
+    * [15. **multiFileProject**](examples/multiFileProject)
 * [Example AdvancedWebServer](#example-advancedwebserver)
   * [File AdvancedWebServer.ino](#file-advancedwebserverino)
 * [Debug Terminal Output Samples](#debug-terminal-output-samples)
@@ -100,7 +102,7 @@ Please also check these twin libraries
 1. [WebServer_WT32_ETH01](https://github.com/khoih-prog/WebServer_WT32_ETH01) for ESP32-based `WT32_ETH01` using `LwIP LAN8720`
 2. [WebServer_ESP32_ENC](https://github.com/khoih-prog/WebServer_ESP32_ENC) for ESP32-boards using `LwIP ENC28J60`
 3. [WebServer_ESP32_W5500](https://github.com/khoih-prog/WebServer_ESP32_W5500) for ESP32-boards using `LwIP W5500`
-
+4. [WebServer_ESP32_SC_ENC](https://github.com/khoih-prog/WebServer_ESP32_SC_ENC) for ESP32_S3-boards using `LwIP ENC28J60`
 
 
 #### Currently supported Boards
@@ -111,6 +113,23 @@ This [**WebServer_ESP32_SC_W5500** library](https://github.com/khoih-prog/WebSer
 
  Hopefully the `ESP32_S2` and `ESP32_C3-based` boards will be supported in the near future to use `LwIP W5500 or ENC28J60 Ethernet`
 
+
+#### ESP32S3_DEV
+
+<p align="center">
+    <img src="https://github.com/khoih-prog/WebServer_ESP32_SC_W5500/raw/main/pics/ESP32S3_DEV.png">
+</p> 
+
+#### W5500
+
+<p align="center">
+    <img src="https://github.com/khoih-prog/WebServer_ESP32_SC_W5500/raw/main/pics/W5500.png">
+</p>
+ 
+<p align="center">
+    <img src="https://github.com/khoih-prog/WebServer_ESP32_SC_W5500/raw/main/pics/W5500_small.png">
+</p> 
+ 
 ---
 ---
 
@@ -157,6 +176,32 @@ To fix [`ESP32 compile error`](https://github.com/espressif/arduino-esp32), just
 - [Server.h](LibraryPatches/esp32/cores/esp32/Server.h)
 
 
+---
+---
+
+
+### HOWTO Fix `Multiple Definitions` Linker Error
+
+The current library implementation, using `xyz-Impl.h` instead of standard `xyz.cpp`, possibly creates certain `Multiple Definitions` Linker error in certain use cases.
+
+You can include this `.hpp` file
+
+```cpp
+// Can be included as many times as necessary, without `Multiple Definitions` Linker Error
+#include "WebServer_ESP32_SC_W5500.hpp"     //https://github.com/khoih-prog/WebServer_ESP32_SC_W5500
+```
+
+in many files. But be sure to use the following `.h` file **in just 1 `.h`, `.cpp` or `.ino` file**, which must **not be included in any other file**, to avoid `Multiple Definitions` Linker Error
+
+```cpp
+// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
+#include "WebServer_ESP32_SC_W5500.h"           //https://github.com/khoih-prog/WebServer_ESP32_SC_W5500
+```
+
+Check the new [**multiFileProject** example](examples/multiFileProject) for a `HOWTO` demo.
+
+
+
 ---
 ---
 
@@ -358,6 +403,52 @@ void serveStatic();
 size_t streamFile();
 ```
 
+
+---
+---
+
+### How to connect W5500 to ESP32_S3
+
+You can change the `INT` pin to another one. Default is `GPIO4`
+
+```cpp
+// Must connect INT to GPIOxx or not working
+#define INT_GPIO            4
+```
+
+---
+
+
+#### ESP32S3_DEV
+
+<p align="center">
+    <img src="https://github.com/khoih-prog/WebServer_ESP32_SC_W5500/raw/main/pics/ESP32S3_DEV.png">
+</p> 
+
+#### W5500
+
+<p align="center">
+    <img src="https://github.com/khoih-prog/WebServer_ESP32_SC_W5500/raw/main/pics/W5500.png">
+</p>
+ 
+<p align="center">
+    <img src="https://github.com/khoih-prog/WebServer_ESP32_SC_W5500/raw/main/pics/W5500_small.png">
+</p> 
+ 
+
+
+|W5500|<--->|ESP32_S3|
+|:-:|:-:|:-:|
+|MOSI|<--->|GPIO11|
+|MISO|<--->|GPIO13|
+|SCK|<--->|GPIO12|
+|SS|<--->|GPIO10|
+|INT|<--->|GPIO4|
+|RST|<--->|RST|
+|GND|<--->|GND|
+|3.3V|<--->|3.3V|
+
+
 ---
 ---
 
@@ -379,7 +470,7 @@ size_t streamFile();
 12. [WebClient](examples/WebClient)
 13. [WebClientRepeating](examples/WebClientRepeating)
 14. [WebServer](examples/WebServer)
-
+15. [**multiFileProject**](examples/multiFileProject)
 
 ---
 ---
@@ -406,7 +497,7 @@ The following are debug terminal output and screen shot when running example [Ad
 
 ```cpp
 Start AdvancedWebServer on ESP32S3_DEV with ESP32_S3_W5500
-WebServer_ESP32_SC_W5500 v1.0.0 for core v2.0.0+
+WebServer_ESP32_SC_W5500 v1.0.1 for core v2.0.0+
 [EWS] Default SPI pinout:
 [EWS] SPI_HOST: 2
 [EWS] MOSI: 11
@@ -434,7 +525,7 @@ The terminal output of **ESP32S3_DEV with W5500** running [MQTT_ThingStream exam
 
 ```cpp
 Start MQTT_ThingStream on ESP32S3_DEV with ESP32_S3_W5500
-WebServer_ESP32_SC_W5500 v1.0.0 for core v2.0.0+
+WebServer_ESP32_SC_W5500 v1.0.1 for core v2.0.0+
 [EWS] Default SPI pinout:
 [EWS] SPI_HOST: 2
 [EWS] MOSI: 11
@@ -467,7 +558,7 @@ The terminal output of **ESP32S3_DEV with W5500** running [MQTTClient_Auth examp
 
 ```cpp
 Start MQTTClient_Auth on ESP32S3_DEV with ESP32_S3_W5500
-WebServer_ESP32_SC_W5500 v1.0.0 for core v2.0.0+
+WebServer_ESP32_SC_W5500 v1.0.1 for core v2.0.0+
 [EWS] Default SPI pinout:
 [EWS] SPI_HOST: 2
 [EWS] MOSI: 11
@@ -497,7 +588,7 @@ The terminal output of **ESP32S3_DEV with W5500** running [MQTTClient_Basic exam
 
 ```cpp
 Start MQTTClient_Basic on ESP32S3_DEV with ESP32_S3_W5500
-WebServer_ESP32_SC_W5500 v1.0.0 for core v2.0.0+
+WebServer_ESP32_SC_W5500 v1.0.1 for core v2.0.0+
 [EWS] Default SPI pinout:
 [EWS] SPI_HOST: 2
 [EWS] MOSI: 11
@@ -527,7 +618,7 @@ The terminal output of **ESP32S3_DEV with W5500** running [WebClient example](ex
 
 ```cpp
 Start WebClient on ESP32S3_DEV with ESP32_S3_W5500
-WebServer_ESP32_SC_W5500 v1.0.0 for core v2.0.0+
+WebServer_ESP32_SC_W5500 v1.0.1 for core v2.0.0+
 [EWS] Default SPI pinout:
 [EWS] SPI_HOST: 2
 [EWS] MOSI: 11
@@ -613,7 +704,7 @@ The terminal output of **ESP32S3_DEV with W5500** running [UDPSendReceive exampl
 
 ```cpp
 Start UDPSendReceive on ESP32S3_DEV with ESP32_S3_W5500
-WebServer_ESP32_SC_W5500 v1.0.0 for core v2.0.0+
+WebServer_ESP32_SC_W5500 v1.0.1 for core v2.0.0+
 [EWS] Default SPI pinout:
 [EWS] SPI_HOST: 2
 [EWS] MOSI: 11
@@ -683,11 +774,14 @@ Submit issues to: [WebServer_ESP32_SC_W5500 issues](https://github.com/khoih-pro
 
 1. Bug Searching and Killing
 2. Add support to **ESP32_S2 and ESP32_C3-based boards** using `LwIP W5500 Ethernet`
-3. Add support to **ESP32_S2/S3 and ESP32_C3-based boards** using `LwIP ENC28J60 Ethernet`
+3. Add support to **ESP32_S2 and ESP32_C3-based boards** using `LwIP ENC28J60 Ethernet`
 
 ### DONE
 
  1. Add support to **ESP32S3-based boards** using `LwIP W5500 Ethernet`
+ 2. Using `SPI_DMA_CH_AUTO` instead of manually selected
+ 3. Add example [multiFileProject]](https://github.com/khoih-prog/WebServer_ESP32_SC_W5500/tree/main/examples/multiFileProject)
+
 
 ---
 ---
@@ -728,7 +822,7 @@ If you want to contribute to this project:
 
 ## Copyright
 
-- Copyright (c) 2016- Hristo Gochkov
+- Copyright (c) 2016- Ivan Grokhotkov
 
 - Copyright (c) 2022- Khoi Hoang
 

changelog.md

@@ -16,12 +16,18 @@
 
 * [Changelog](#changelog)
   * [Releases v1.0.0](#releases-v100)
+  * [Releases v1.0.1](#releases-v101)
 
 ---
 ---
 
 ## Changelog
 
+#### Releases v1.0.1
+
+1. Using `SPI_DMA_CH_AUTO` instead of manually selected
+2. Add example [multiFileProject]](https://github.com/khoih-prog/WebServer_ESP32_SC_W5500/tree/main/examples/multiFileProject)
+
 #### Releases v1.0.0
 
 1. Initial coding to support ESP32_S3-based boards using `LwIP W5500 Ethernet`.

examples/multiFileProject/multiFileProject.cpp

@@ -0,0 +1,15 @@
+/****************************************************************************************************************************
+  multiFileProject.cpp
+  For Ethernet shields using ESP32_SC_W5500 (ESP32_S2/3, ESP32_C3 + LwIP W5500)
+
+  WebServer_ESP32_SC_W5500 is a library for the ESP32_S2/3, ESP32_C3 with LwIP Ethernet W5500
+
+  Based on and modified from ESP8266 https://github.com/esp8266/Arduino/releases
+  Built by Khoi Hoang https://github.com/khoih-prog/WebServer_ESP32_SC_W5500
+  Licensed under GPLv3 license
+
+*****************************************************************************************************************************/
+
+// To demo how to include files in multi-file Projects
+
+#include "multiFileProject.h"

examples/multiFileProject/multiFileProject.h

@@ -0,0 +1,37 @@
+/****************************************************************************************************************************
+  multiFileProject.h
+  For Ethernet shields using ESP32_SC_W5500 (ESP32_S2/3, ESP32_C3 + LwIP W5500)
+
+  WebServer_ESP32_SC_W5500 is a library for the ESP32_S2/3, ESP32_C3 with LwIP Ethernet W5500
+
+  Based on and modified from ESP8266 https://github.com/esp8266/Arduino/releases
+  Built by Khoi Hoang https://github.com/khoih-prog/WebServer_ESP32_SC_W5500
+  Licensed under GPLv3 license
+
+*****************************************************************************************************************************/
+
+// To demo how to include files in multi-file Projects
+
+#pragma once
+
+#define _ETHERNET_WEBSERVER_LOGLEVEL_       1
+
+//////////////////////////////////////////////////////////
+
+// Optional values to override default settings
+// Don't change unless you know what you're doing
+//#define ETH_SPI_HOST        SPI3_HOST
+//#define SPI_CLOCK_MHZ       25
+
+// Must connect INT to GPIOxx or not working
+//#define INT_GPIO            4
+
+//#define MISO_GPIO           19
+//#define MOSI_GPIO           23
+//#define SCK_GPIO            18
+//#define CS_GPIO             5
+
+//////////////////////////////////////////////////////////
+
+// Can be included as many times as necessary, without `Multiple Definitions` Linker Error
+#include "WebServer_ESP32_SC_W5500.hpp"

examples/multiFileProject/multiFileProject.ino

@@ -0,0 +1,38 @@
+/****************************************************************************************************************************
+  multiFileProject.ino
+  For Ethernet shields using ESP32_SC_W5500 (ESP32_S2/3, ESP32_C3 + LwIP W5500)
+
+  WebServer_ESP32_SC_W5500 is a library for the ESP32_S2/3, ESP32_C3 with LwIP Ethernet W5500
+
+  Based on and modified from ESP8266 https://github.com/esp8266/Arduino/releases
+  Built by Khoi Hoang https://github.com/khoih-prog/WebServer_ESP32_SC_W5500
+  Licensed under GPLv3 license
+
+*****************************************************************************************************************************/
+
+// To demo how to include files in multi-file Projects
+
+#include "multiFileProject.h"
+
+// Can be included as many times as necessary, without `Multiple Definitions` Linker Error
+#include "WebServer_ESP32_SC_W5500.h"
+
+void setup()
+{
+  Serial.begin(115200);
+
+  while (!Serial);
+
+  delay(500);
+
+  Serial.println("\nStart multiFileProject");
+  Serial.println(WEBSERVER_ESP32_SC_W5500_VERSION);
+
+
+  Serial.print("You're OK now");
+}
+
+void loop()
+{
+  // put your main code here, to run repeatedly:
+}

library.json

@@ -1,6 +1,6 @@
 {
   "name": "WebServer_ESP32_SC_W5500",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "keywords": "WebServer, Ethernet, MQTT, MQTTS, HTTP, HTTPS, SSL, Arduino, ESP32, ESP32-S3, ESP32-S2, ESP32-C3, W5500, HTTP-Client, WebSocket-Client, MQTT-Client, server, client, websocket, LittleFS, SPIFFS, ThingStream",
   "description": "Simple Ethernet WebServer, HTTP/HTTPS Client wrapper library for ESP32_S2, S3 and C3 boards using W5500 with LwIP Ethernet library. The WebServer supports HTTP(S) GET and POST requests, provides argument parsing, handles one client at a time. It provides HTTP(S), MQTT(S) Client and supports WebServer serving from LittleFS/SPIFFS",
   "authors":

library.properties

@@ -1,5 +1,5 @@
 name=WebServer_ESP32_SC_W5500
-version=1.0.0
+version=1.0.1
 author=Khoi Hoang
 license=GPLv3
 maintainer=Khoi Hoang <[email protected]>