v1.4.0 to support QNEthernet

### Major Release v1.4.0

1. Add support to [QNEthernet Library](https://github.com/ssilverman/QNEthernet) for Teensy 4.1 built-in Ethernet
2. Fix bug in non-blocking connection
3. Add new feature to permit using either server's hostname, such as `your_account.duckdns.org`, or server's IPAddress, such as IPAddress(192,168,2,112)
4. Update examples with new features, bug-fixes, etc.

Author: khoih-prog

CONTRIBUTING.md

@@ -15,7 +15,7 @@ If you don't find anything, please [open a new issue](https://github.com/khoih-p
 Please ensure to specify the following:
 
 * Arduino IDE version (e.g. 1.8.15) or Platform.io version
-* `SAMD` Core Version (e.g. Arduino SAMD core v1.8.11, Adafruit SAMD core v1.7.4, Seeed Studio SAMD v1.8.1)
+* Board Core Version (e.g. Arduino SAMDUE core v1.6.12, ESP8266 core v3.0.2, ArduinoCore-mbed v2.4.1, etc.)
 * 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:
@@ -27,12 +27,13 @@ Please ensure to specify the following:
 
 ```
 Arduino IDE version: 1.8.15
-Arduino SAMD Core Version 1.8.11
+RASPBERRY_PI_PICO board
+ArduinoCore-mbed v2.4.1
 OS: Ubuntu 20.04 LTS
 Linux xy-Inspiron-3593 5.4.0-81-generic #91-Ubuntu SMP Thu Jul 15 19:09:17 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux
 
 Context:
-The board couldn't autoreconnect to Local Blynk Server after router power recycling.
+I encountered a crash while trying to use the Timer Interrupt.
 
 Steps to reproduce:
 1. ...

README.md

@@ -1,8 +1,8 @@
 {
   "name": "MySQL_MariaDB_Generic",
-  "version": "1.3.1",
-  "keywords": "Communication, Database, Storage, MySQL, MariaDB, wt32-eth01, Teensy, SAMD, SAM DUE, nRF52, W5x00, ENC28J60, Ethernet, wifi, wifinina, lan8720, rp2040, nano-33-iot, nano-rp2040-connect, native-ethernet, rpi-pico, Arduino, AVR",
-  "description": "Connects to MySQL or MariaDB using ESP8266/ESP32, WT32_ETH01 (ESP32 + LAN8720A), nRF52, SAMD21/SAMD51, STM32F/L/H/G/WB/MP1, Teensy, SAM DUE, Mega, RP2040-based boards, etc. with W5x00, ENC28J60 Ethernet, Teensy 4.1 NativeEthernet or WiFiNINA modules/shields. W5x00 can use Ethernet, EthernetLarge, Ethernet2 or Ethernet3 library. ENC28J60 can use either EthernetENC or UIPEthernet Library",
+  "version": "1.4.0",
+  "keywords": "Communication, Database, Storage, MySQL, MariaDB, wt32-eth01, Teensy, SAMD, SAM DUE, nRF52, W5x00, ENC28J60, Ethernet, wifi, wifinina, lan8720, rp2040, nano-33-iot, nano-rp2040-connect, QNEthernet, native-ethernet, rpi-pico, Arduino, AVR",
+  "description": "Connects to MySQL or MariaDB using ESP8266/ESP32, WT32_ETH01 (ESP32 + LAN8720A), nRF52, SAMD21/SAMD51, STM32F/L/H/G/WB/MP1, Teensy, SAM DUE, Mega, RP2040-based boards, etc. with W5x00, ENC28J60 Ethernet, Teensy 4.1 NativeEthernet/QNEthernet or WiFiNINA modules/shields. W5x00 can use Ethernet, EthernetLarge, Ethernet2 or Ethernet3 library. ENC28J60 can use either EthernetENC or UIPEthernet Library. Now accepting server's hostname, besides IPAddress",
   "authors": [
     {
       "name":  "Dr. Charles Bell",
@@ -102,6 +102,10 @@
       "name": "EthernetLarge",
       "version": ">=2.0.0",
       "platforms": ["*"]
+    },
+    {
+      "name": "QNEthernet",
+      "version": "https://github.com/ssilverman/QNEthernet"
     }
   ],
   "frameworks": "*",

library.json

@@ -1,11 +1,11 @@
 name=MySQL_MariaDB_Generic
-version=1.3.1
+version=1.4.0
 author=Dr. Charles Bell <[email protected]>, Khoi Hoang <[email protected]>
 maintainer=Khoi Hoang <[email protected]>
-sentence=Connects to MySQL or MariaDB using ESP8266/ESP32, WT32_ETH01 (ESP32 + LAN8720A), nRF52, SAMD21/SAMD51, STM32F/L/H/G/WB/MP1, Teensy, SAM DUE, Mega, RP2040-based boards, etc. with W5x00 or ENC28J60 Ethernet or WiFiNINA modules/shields. W5x00 can use Ethernet, EthernetLarge, Ethernet2 or Ethernet3 library. ENC28J60 can use either EthernetENC or UIPEthernet Library
-paragraph=You can use this library to connect your Arduino project directly to a MySQL / MariaDB server without using an intermediate computer or a web-based or cloud-based service. Having direct access to a database server means you can store data acquired from your project as well as check values stored in tables on the server. This also means you can setup your own, local MySQL / MariaDB server to store your data further removing the need for Internet connectivity. If that is not an issue, you can still connect to and store data on a MySQL / MariaDB server via your network, Internet, or even in the cloud!
+sentence=Connects to MySQL or MariaDB using ESP8266/ESP32, WT32_ETH01 (ESP32 + LAN8720A), nRF52, SAMD21/SAMD51, STM32F/L/H/G/WB/MP1, Teensy, SAM DUE, Mega, RP2040-based boards, etc. with W5x00 or ENC28J60 Ethernet, Teensy 4.1 NativeEthernet/QNEthernet or WiFiNINA modules/shields. W5x00 can use Ethernet, EthernetLarge, Ethernet2 or Ethernet3 library. ENC28J60 can use either EthernetENC or UIPEthernet Library
+paragraph=You can use this library to connect your Arduino project directly to a MySQL / MariaDB server without using an intermediate computer or a web-based or cloud-based service. Having direct access to a database server means you can store data acquired from your project as well as check values stored in tables on the server. This also means you can setup your own, local MySQL / MariaDB server to store your data further removing the need for Internet connectivity. If that is not an issue, you can still connect to and store data on a MySQL / MariaDB server via your network, Internet, or even in the cloud! Now accepting server's hostname, besides IPAddress
 category=Communication
 url=https://github.com/khoih-prog/MySQL_MariaDB_Generic
 architectures=*
-depends=WiFiNINA_Generic,WebServer_WT32_ETH01,Ethernet,EthernetLarge,Ethernet2,Ethernet3,EthernetENC,UIPEthernet,WiFiEspAT,NativeEthernet
+depends=WiFiNINA_Generic,WebServer_WT32_ETH01,Ethernet,EthernetLarge,Ethernet2,Ethernet3,EthernetENC,UIPEthernet,WiFiEspAT,NativeEthernet, QNEthernet
 includes=MySQL_Generic.h

library.properties

@@ -44,8 +44,10 @@ lib_deps =
   EthernetENC@~2.0.0
   UIPEthernet@~2.0.8
   WiFiEspAT@~1.3.1
+  https://github.com/ssilverman/QNEthernet  
 ;  STM32duino STM32Ethernet@~1.2.0
 ;  STM32duino LwIP@~2.1.2
+;
 ; PlatformIO 5.x  
 ; khoih.prog/WiFiNINA_Generic@~1.8.12
 ; khoih.prog/WebServer_WT32_ETH01@~1.2.0
@@ -58,7 +60,7 @@ lib_deps =
 ; jandrassy/WiFiEspAT@~1.3.1
 ; stm32duino/STM32duino LwIP@~2.1.2
 ; stm32duino/STM32duino STM32Ethernet@~1.2.0
-
+; https://github.com/ssilverman/QNEthernet
 
 
 build_flags =

platformio/platformio.ini

@@ -11,7 +11,7 @@
   
   Built by Khoi Hoang https://github.com/khoih-prog/MySQL_MariaDB_Generic
   Licensed under MIT license
-  Version: 1.3.1
+  Version: 1.4.0
 
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -24,13 +24,14 @@
   1.2.0   K Hoang      20/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720A)
   1.3.0   K Hoang      30/08/2021 Add support to Teensy 4.1 using NativeEthernet
   1.3.1   K Hoang      31/08/2021 Remove unnecessary SPI-bus code in NativeEthernet examples
+  1.4.0   K Hoang      05/09/2021 Add support to Teensy 4.1 using QNEthernet
  **********************************************************************************************************************************/
 
 #ifndef MYSQL_GENERIC_H
 #define MYSQL_GENERIC_H
 
 #if ( USE_ETHERNET || USE_ETHERNET_LARGE || USE_ETHERNET2 || USE_ETHERNET3 || USE_ETHERNET_ENC || USE_ETHERNET_ESP8266 || \
-      USE_UIP_ETHERNET || USE_NATIVE_ETHERNET || USE_CUSTOM_ETHERNET )
+      USE_UIP_ETHERNET || USE_NATIVE_ETHERNET || USE_QN_ETHERNET || USE_CUSTOM_ETHERNET )
 
   #include "MySQL_Generic_Ethernet.h"
 

src/MySQL_Generic.h

@@ -13,7 +13,7 @@
   
   Built by Khoi Hoang https://github.com/khoih-prog/MySQL_MariaDB_Generic
   Licensed under MIT license
-  Version: 1.3.1
+  Version: 1.4.0
 
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -26,6 +26,7 @@
   1.2.0   K Hoang      20/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720A)
   1.3.0   K Hoang      30/08/2021 Add support to Teensy 4.1 using NativeEthernet
   1.3.1   K Hoang      31/08/2021 Remove unnecessary SPI-bus code in NativeEthernet examples
+  1.4.0   K Hoang      05/09/2021 Add support to Teensy 4.1 using QNEthernet
  **********************************************************************************************************************************/
 
 /*********************************************************************************************************************************
@@ -66,6 +67,12 @@ class MySQL_Connection : public MySQL_Packet
 
     Connection_Result connectNonBlocking(IPAddress server, int port, char *user, char *password, char *db = NULL);
 
+    // KH, add to use hostname. from v1.4.0
+    bool connect(const char *hostname, int port, char *user, char *password, char *db = NULL);
+    
+    Connection_Result connectNonBlocking(const char *hostname, int port, char *user, char *password, char *db = NULL);
+    ////////
+    
     int connected() 
     {
       return client->connected();

src/MySQL_Generic_Connection.h

@@ -13,7 +13,7 @@
   
   Built by Khoi Hoang https://github.com/khoih-prog/MySQL_MariaDB_Generic
   Licensed under MIT license
-  Version: 1.3.1
+  Version: 1.4.0
 
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -26,6 +26,7 @@
   1.2.0   K Hoang      20/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720A)
   1.3.0   K Hoang      30/08/2021 Add support to Teensy 4.1 using NativeEthernet
   1.3.1   K Hoang      31/08/2021 Remove unnecessary SPI-bus code in NativeEthernet examples
+  1.4.0   K Hoang      05/09/2021 Add support to Teensy 4.1 using QNEthernet
  **********************************************************************************************************************************/
 
 /*********************************************************************************************************************************
@@ -49,7 +50,7 @@
 
 #include <MySQL_Generic_Encrypt_Sha1.h>
 
-#define MAX_CONNECT_ATTEMPTS      5      //3
+#define MAX_CONNECT_ATTEMPTS      10  //5      //3
 #define CONNECT_DELAY_MS          1000   //500
 #define SUCCESS                   1
 
@@ -85,10 +86,12 @@ bool MySQL_Connection::connect(IPAddress server, int port, char *user, char *pas
   while (retries++ < MAX_CONNECT_ATTEMPTS)
   {
     connected = client->connect(server, port);
+    
+    MYSQL_LOGDEBUG1("connected =", connected);
 
     if (connected != SUCCESS)
     {
-      MYSQL_LOGERROR1("Can't connect. Retry #", retries);
+      MYSQL_LOGDEBUG1("Can't connect. Retry #", retries);
       delay(CONNECT_DELAY_MS);
     }
     else
@@ -148,26 +151,32 @@ Connection_Result MySQL_Connection::connectNonBlocking(IPAddress server, int por
   if (db)
     MYSQL_LOGERROR1("Using Database:", db);
 
-  while (retries++ < MAX_CONNECT_ATTEMPTS)
+  while (retries < MAX_CONNECT_ATTEMPTS)
   {  
     if ( (now == 0) || ( millis() - now ) > CONNECT_DELAY_MS )
     {
       now = millis();
 
       connected = client->connect(server, port);
+      
+      retries++;
+      
+      MYSQL_LOGDEBUG1("connected =", connected);
 
       if (connected == SUCCESS)
       {
         break;
       }
       else
       {
-        MYSQL_LOGERROR1("Can't connect. Retry #", retries);
-        //return RESULT_PENDING;
+        MYSQL_LOGDEBUG1("Can't connect. Retry #", retries);
       }     
     }
     else
-      return RESULT_PENDING;
+    {
+      //delay(CONNECT_DELAY_MS);
+      yield();
+    }
   }
 
   if (connected != SUCCESS)
@@ -208,6 +217,156 @@ Connection_Result MySQL_Connection::connectNonBlocking(IPAddress server, int por
   return RESULT_OK;
 }
 
+//////////////////////////////////////////////////////////////
+// KH, add to use hostname. from v1.4.0
+
+bool MySQL_Connection::connect(const char *hostname, int port, char *user, char *password, char *db)
+{
+  int connected = 0;
+  int retries = 0;
+  
+  MYSQL_LOGERROR3("Connecting to Server:", hostname, ", Port = ", port);
+  
+  if (db)
+    MYSQL_LOGERROR1("Using Database:", db);
+
+  // Retry up to MAX_CONNECT_ATTEMPTS times.
+  while (retries++ < MAX_CONNECT_ATTEMPTS)
+  {
+    connected = client->connect(hostname, port);
+    
+    MYSQL_LOGDEBUG1("connected =", connected);
+
+    if (connected != SUCCESS)
+    {
+      MYSQL_LOGDEBUG1("Can't connect. Retry #", retries);
+      delay(CONNECT_DELAY_MS);
+    }
+    else
+    {
+      break;
+    }
+  }
+
+  if (connected != SUCCESS)
+    return false;
+
+  MYSQL_LOGERROR("Connect OK. Try reading packets");
+
+  if ( !read_packet() )
+  {
+    MYSQL_LOGERROR("Can't connect. Error reading packets");
+    return false;
+  }
+
+  MYSQL_LOGERROR("Try parsing packets");
+
+  parse_handshake_packet();
+
+  MYSQL_LOGERROR("Try send_authentication packets");
+
+  send_authentication_packet(user, password, db);
+   
+  if ( !read_packet() )
+  {
+    MYSQL_LOGERROR("Can't connect. Error reading auth packets");
+    return false;
+  }
+
+  if (get_packet_type() != MYSQL_OK_PACKET)
+  {
+    parse_error_packet();
+    return false;
+  }
+
+  MYSQL_LOGERROR1("Connected. Server Version =", server_version);
+
+  free(server_version); // don't need it anymore
+
+  return true;
+}
+
+Connection_Result MySQL_Connection::connectNonBlocking(const char *hostname, int port, char *user, char *password, char *db)
+{
+  int connected = 0;
+  int retries   = 0;
+  
+  long now = 0;
+  
+  MYSQL_LOGERROR3("Connecting to Server:", hostname, ", Port = ", port);
+  
+  if (db)
+    MYSQL_LOGERROR1("Using Database:", db);
+  
+  while (retries < MAX_CONNECT_ATTEMPTS)
+  {  
+    if ( (now == 0) || ( millis() - now ) > CONNECT_DELAY_MS )
+    {
+      now = millis();
+      
+      connected = client->connect(hostname, port);
+      
+      retries++;
+      
+      MYSQL_LOGDEBUG1("connected =", connected);
+
+      if (connected == SUCCESS)
+      {
+        break;
+      }
+      else
+      {
+        MYSQL_LOGDEBUG1("Can't connect. Retry #", retries);
+      }     
+    }
+    else
+    {
+      //delay(CONNECT_DELAY_MS);
+      yield();
+    }
+  }
+
+  if (connected != SUCCESS)
+    return RESULT_FAIL;
+
+  MYSQL_LOGERROR("Connect OK. Try reading packets");
+
+  if ( !read_packet() )
+  {
+    MYSQL_LOGERROR("Can't connect. Error reading packets");
+    return RESULT_FAIL;
+  }
+
+  MYSQL_LOGERROR("Try parsing packets");
+
+  parse_handshake_packet();
+
+  MYSQL_LOGERROR("Try send_authentication packets");
+
+  send_authentication_packet(user, password, db);
+  
+  if ( !read_packet() )
+  {
+    MYSQL_LOGERROR("Can't connect. Error reading auth packets");
+    return RESULT_FAIL;
+  }
+
+  if (get_packet_type() != MYSQL_OK_PACKET)
+  {
+    parse_error_packet();
+    return RESULT_FAIL;
+  }
+
+  MYSQL_LOGERROR1("Connected. Server Version =", server_version);
+
+  free(server_version); // don't need it anymore
+
+  return RESULT_OK;
+}
+
+
+//////////////////////////////////////////////////////////////
+
 /*
   close - cancel the connection
 

src/MySQL_Generic_Connection_Impl.h

@@ -13,7 +13,7 @@
   
   Built by Khoi Hoang https://github.com/khoih-prog/MySQL_MariaDB_Generic
   Licensed under MIT license
-  Version: 1.3.1
+  Version: 1.4.0
 
   Version Modified By   Date      Comments
   ------- -----------  ---------- -----------
@@ -26,6 +26,7 @@
   1.2.0   K Hoang      20/07/2021 Add support to WT32_ETH01 (ESP32 + LAN8720A)
   1.3.0   K Hoang      30/08/2021 Add support to Teensy 4.1 using NativeEthernet
   1.3.1   K Hoang      31/08/2021 Remove unnecessary SPI-bus code in NativeEthernet examples
+  1.4.0   K Hoang      05/09/2021 Add support to Teensy 4.1 using QNEthernet
  **********************************************************************************************************************************/
 
 /*********************************************************************************************************************************