v1.1.2

### Release v1.1.2

1. Add SSL debug feature.
2. Enhance examples.

Author: khoih-prog

README.md

@@ -117,6 +117,11 @@ Check [`EthernetWebServer Library Issue: Support for STM32F Series`](https://git
 ---
 ---
 
+### Release v1.1.2
+
+1. Add SSL debug feature.
+2. Enhance examples.
+
 ### Release v1.1.1
 
 1. Permit sites with "Chain could not be linked to a trust anchor" such as mqtt.thingstream.io.
@@ -1965,6 +1970,11 @@ MQTT Message receive [esp32-sniffer/12345678/ble] Hello from MQTTS_ThingStream_T
 
 ## Releases History
 
+### Release v1.1.2
+
+1. Add SSL debug feature.
+2. Enhance examples.
+
 ### Release v1.1.1
 
 1. Permit sites with "Chain could not be linked to a trust anchor" such as mqtt.thingstream.io.
@@ -2046,6 +2056,7 @@ Submit issues to: [EthernetWebServer_SSL_STM32 issues](https://github.com/khoih-
 3. Support more non-compatible Ethernet Libraries such as Ethernet_Shield_W5200, EtherCard, EtherSia
 4. Add mDNS features.
 5. Use AsyncTCP features from [Phil Bowles' STM32AsyncTCP](https://github.com/philbowles/STM32AsyncTCP).
+6. Add **High-level HTTP (GET, POST, PUT, PATCH, DELETE) and WebSocket Client**
 
 ### DONE
 

examples/MQTTClient_Auth/MQTTClient_Auth.ino

@@ -29,7 +29,14 @@
 #include <PubSubClient.h>
 
 // Update these with values suitable for your network.
-const char* mqttServer = "broker.hivemq.com"; // Broker address
+//const char* mqttServer = "broker.example";        // Broker address
+const char* mqttServer = "broker.emqx.io";        // Broker address
+//const char* mqttServer = "broker.shiftr.io";        // Broker address
+
+const char *ID        = "MQTTClient_SSL-Client";  // Name of our device, must be unique
+const char *TOPIC     = "MQTT_Pub";               // Topic to subcribe to
+const char *subTopic  = "MQTT_Sub";               // Topic to subcribe to
+
 //IPAddress mqttServer(172, 16, 0, 2);
 
 void callback(char* topic, byte* payload, unsigned int length) 
@@ -49,6 +56,49 @@ void callback(char* topic, byte* payload, unsigned int length)
 EthernetClient  ethClient;
 PubSubClient    client(mqttServer, 1883, callback, ethClient);
 
+void reconnect()
+{
+  // Loop until we're reconnected
+  while (!client.connected())
+  {
+    Serial.print("Attempting MQTT connection to ");
+    Serial.print(mqttServer);
+
+    // Attempt to connect
+    if (client.connect("arduino", "try", "try"))
+    {
+      Serial.println("...connected");
+      
+      // Once connected, publish an announcement...
+      String data = "Hello from MQTTClient_SSL on " + String(BOARD_NAME);
+
+      client.publish(TOPIC, data.c_str());
+
+      //Serial.println("Published connection message successfully!");
+      //Serial.print("Subcribed to: ");
+      //Serial.println(subTopic);
+      
+      // This is a workaround to address https://github.com/OPEnSLab-OSU/SSLClient/issues/9
+      //ethClientSSL.flush();
+      // ... and resubscribe
+      client.subscribe(subTopic);
+      // for loopback testing
+      client.subscribe(TOPIC);
+      // This is a workaround to address https://github.com/OPEnSLab-OSU/SSLClient/issues/9
+      //ethClientSSL.flush();
+    }
+    else
+    {
+      Serial.print("...failed, rc=");
+      Serial.print(client.state());
+      Serial.println(" try again in 5 seconds");
+
+      // Wait 5 seconds before retrying
+      delay(5000);
+    }
+  }
+}
+
 void setup()
 {
   // Open serial communications and wait for port to open:
@@ -58,7 +108,25 @@ void setup()
   Serial.print("\nStart MQTTClient_Auth on " + String(BOARD_NAME));
   Serial.println(" with " + String(SHIELD_TYPE));
 
-  ET_LOGWARN3(F("Board :"), BOARD_NAME, F(", setCsPin:"), USE_THIS_SS_PIN);
+#if USE_ETHERNET_WRAPPER
+
+  EthernetInit();
+
+#else
+
+  #if USE_ETHERNET
+    ET_LOGWARN(F("=========== USE_ETHERNET ==========="));
+  #elif USE_ETHERNET2
+    ET_LOGWARN(F("=========== USE_ETHERNET2 ==========="));
+  #elif USE_ETHERNET3
+    ET_LOGWARN(F("=========== USE_ETHERNET3 ==========="));
+  #elif USE_ETHERNET_LARGE
+    ET_LOGWARN(F("=========== USE_ETHERNET_LARGE ==========="));
+  #elif USE_ETHERNET_ESP8266
+    ET_LOGWARN(F("=========== USE_ETHERNET_ESP8266 ==========="));
+  #else
+    ET_LOGWARN(F("========================="));
+  #endif
 
   ET_LOGWARN(F("Default SPI pinout:"));
   ET_LOGWARN1(F("MOSI:"), MOSI);
@@ -67,10 +135,58 @@ void setup()
   ET_LOGWARN1(F("SS:"),   SS);
   ET_LOGWARN(F("========================="));
 
-  #if !(USE_BUILTIN_ETHERNET || USE_UIP_ETHERNET)
+  #if defined(ESP8266)
+    // For ESP8266, change for other boards if necessary
+    #ifndef USE_THIS_SS_PIN
+      #define USE_THIS_SS_PIN   D2    // For ESP8266
+    #endif
+  
+    ET_LOGWARN1(F("ESP8266 setCsPin:"), USE_THIS_SS_PIN);
+  
+    #if ( USE_ETHERNET || USE_ETHERNET_LARGE || USE_ETHERNET2 || USE_ETHERNET_ENC )
+      // For ESP8266
+      // Pin                D0(GPIO16)    D1(GPIO5)    D2(GPIO4)    D3(GPIO0)    D4(GPIO2)    D8
+      // Ethernet           0                 X            X            X            X        0
+      // Ethernet2          X                 X            X            X            X        0
+      // Ethernet3          X                 X            X            X            X        0
+      // EthernetLarge      X                 X            X            X            X        0
+      // Ethernet_ESP8266   0                 0            0            0            0        0
+      // D2 is safe to used for Ethernet, Ethernet2, Ethernet3, EthernetLarge libs
+      // Must use library patch for Ethernet, EthernetLarge libraries
+      Ethernet.init (USE_THIS_SS_PIN);
+    
+    #elif USE_ETHERNET3
+      // Use  MAX_SOCK_NUM = 4 for 4K, 2 for 8K, 1 for 16K RX/TX buffer
+      #ifndef ETHERNET3_MAX_SOCK_NUM
+        #define ETHERNET3_MAX_SOCK_NUM      4
+      #endif
+    
+      Ethernet.setCsPin (USE_THIS_SS_PIN);
+      Ethernet.init (ETHERNET3_MAX_SOCK_NUM);
+    
+    #elif USE_CUSTOM_ETHERNET
+    
+      // You have to add initialization for your Custom Ethernet here
+      // This is just an example to setCSPin to USE_THIS_SS_PIN, and can be not correct and enough
+      Ethernet.init(USE_THIS_SS_PIN);
+    
+    #endif  //( USE_ETHERNET || USE_ETHERNET2 || USE_ETHERNET3 || USE_ETHERNET_LARGE )
+  
+  #elif defined(ESP32)
+  
+    #ifndef USE_THIS_SS_PIN
+      #define USE_THIS_SS_PIN   22    // For ESP32
+    #endif
+  
+    ET_LOGWARN1(F("ESP32 setCsPin:"), USE_THIS_SS_PIN);
+  
     // For other boards, to change if necessary
-    #if ( USE_ETHERNET || USE_ETHERNET_LARGE || USE_ETHERNET2  || USE_ETHERNET_ENC )
-      // Must use library patch for Ethernet, Ethernet2, EthernetLarge libraries
+    #if ( USE_ETHERNET || USE_ETHERNET_LARGE || USE_ETHERNET2 || USE_ETHERNET_ENC )
+      // Must use library patch for Ethernet, EthernetLarge libraries
+      // ESP32 => GPIO2,4,5,13,15,21,22 OK with Ethernet, Ethernet2, EthernetLarge
+      // ESP32 => GPIO2,4,5,15,21,22 OK with Ethernet3
+    
+      //Ethernet.setCsPin (USE_THIS_SS_PIN);
       Ethernet.init (USE_THIS_SS_PIN);
 
     #elif USE_ETHERNET3
@@ -81,39 +197,126 @@ void setup()
 
       Ethernet.setCsPin (USE_THIS_SS_PIN);
       Ethernet.init (ETHERNET3_MAX_SOCK_NUM);
+    
+    #elif USE_CUSTOM_ETHERNET
+    
+      // You have to add initialization for your Custom Ethernet here
+      // This is just an example to setCSPin to USE_THIS_SS_PIN, and can be not correct and enough
+      Ethernet.init(USE_THIS_SS_PIN);
+  
+    #endif  //( USE_ETHERNET || USE_ETHERNET2 || USE_ETHERNET3 || USE_ETHERNET_LARGE )
+  
+  #else   //defined(ESP8266)
+    // unknown board, do nothing, use default SS = 10
+    #ifndef USE_THIS_SS_PIN
+      // Select USE_THIS_SS_PIN as follows
+      //  10    // Most Arduino shields
+      //   5    // MKR ETH shield
+      //   0    // Teensy 2.0
+      //  20    // Teensy++ 2.0
+      //  15    // ESP8266 with Adafruit Featherwing Ethernet
+      //  33    // ESP32 with Adafruit Featherwing Ethernet
+      #define USE_THIS_SS_PIN   10    // For other boards
+    #endif
 
+    ET_LOGWARN3(F("Board :"), BOARD_NAME, F(", setCsPin:"), USE_THIS_SS_PIN);
+  
+    // For other boards, to change if necessary
+    #if ( USE_ETHERNET || USE_ETHERNET_LARGE || USE_ETHERNET2  || USE_ETHERNET_ENC )
+      // Must use library patch for Ethernet, Ethernet2, EthernetLarge libraries
+    
+      Ethernet.init (USE_THIS_SS_PIN);
+    
+    #elif USE_ETHERNET3
+      // Use  MAX_SOCK_NUM = 4 for 4K, 2 for 8K, 1 for 16K RX/TX buffer
+    #ifndef ETHERNET3_MAX_SOCK_NUM
+      #define ETHERNET3_MAX_SOCK_NUM      4
+    #endif
+    
+      Ethernet.setCsPin (USE_THIS_SS_PIN);
+      Ethernet.init (ETHERNET3_MAX_SOCK_NUM);
+    
     #elif USE_CUSTOM_ETHERNET
+    
       // You have to add initialization for your Custom Ethernet here
       // This is just an example to setCSPin to USE_THIS_SS_PIN, and can be not correct and enough
-      //Ethernet.init(USE_THIS_SS_PIN);
-      
-    #endif  //( ( USE_ETHERNET || USE_ETHERNET_LARGE || USE_ETHERNET2  || USE_ETHERNET_ENC )
-  #endif
+      Ethernet.init(USE_THIS_SS_PIN);
+    
+    #endif  //( USE_ETHERNET || USE_ETHERNET2 || USE_ETHERNET3 || USE_ETHERNET_LARGE )
 
+  #endif    //defined(ESP8266)
+
+
+#endif  //USE_ETHERNET_WRAPPER
+
+
   // start the ethernet connection and the server:
   // Use DHCP dynamic IP and random mac
   uint16_t index = millis() % NUMBER_OF_MAC;
   // Use Static IP
   //Ethernet.begin(mac[index], ip);
   Ethernet.begin(mac[index]);
 
-  // you're connected now, so print out the data
-  Serial.print(F("You're connected to the network, IP = "));
+  // Just info to know how to connect correctly
+  Serial.println("=========================");
+  Serial.println("Currently Used SPI pinout:");
+  Serial.print("MOSI:");
+  Serial.println(MOSI);
+  Serial.print("MISO:");
+  Serial.println(MISO);
+  Serial.print("SCK:");
+  Serial.println(SCK);
+  Serial.print("SS:");
+  Serial.println(SS);
+#if USE_ETHERNET3
+  Serial.print("SPI_CS:");
+  Serial.println(SPI_CS);
+#endif
+  Serial.println(F("========================="));
+
+  Serial.print(F("Using mac index = "));
+  Serial.println(index);
+
+  Serial.print(F("Connected! IP address: "));
   Serial.println(Ethernet.localIP());
 
   // Note - the default maximum packet size is 128 bytes. If the
   // combined length of clientId, username and password exceed this use the
   // following to increase the buffer size:
   // client.setBufferSize(255);
+}
+
+#define MQTT_PUBLISH_INTERVAL_MS       5000L
+
+String data         = "Hello from MQTTClient_Auth on " + String(BOARD_NAME) + " with " + String(SHIELD_TYPE);
+const char *pubData = data.c_str();
+
+unsigned long lastMsg = 0;
+
+void loop() 
+{
+  static unsigned long now;
 
-  if (client.connect("arduinoClient", "testuser", "testpass")) 
+  if (!client.connected()) 
   {
-    client.publish("outTopic", "hello world");
-    client.subscribe("inTopic");
+    reconnect();
   }
-}
 
-void loop()
-{
+  // Sending Data
+  now = millis();
+  
+  if (now - lastMsg > MQTT_PUBLISH_INTERVAL_MS)
+  {
+    lastMsg = now;
+
+    if (!client.publish(TOPIC, pubData))
+    {
+      Serial.println("Message failed to send.");
+    }
+
+    Serial.print("Message Send : " + String(TOPIC) + " => ");
+    Serial.println(data);
+  }
+  
   client.loop();
 }