Add support for ESPSoftwareSerial

Author: PaulZC

src/SparkFun_u-blox_SARA-R5_Arduino_Library.cpp

@@ -3246,8 +3246,12 @@ SARA_R5_error_t SARA_R5::init(unsigned long baud,
 
     if (_printDebug == true) _debugPort->println(F("Begin module init."));
 
-    if(hwAvailable() == -1)
-        beginSerial(baud); // If port is null, begin serial
+    // There's no 'easy' way to tell if the serial port has already been begun for us.
+    // We have to assume it has not been begun and so do it here.
+    // For special cases like Software Serial on ESP32, we need to begin _and_ end the port externally
+    // _before_ calling the SARA_R5 .begin.
+    // See SARA-R5_Example2_Identification_ESPSoftwareSerial for more details.
+    beginSerial(baud);
 
     if (initType == SARA_R5_INIT_AUTOBAUD)
     {

src/SparkFun_u-blox_SARA-R5_Arduino_Library.h

@@ -43,11 +43,31 @@
 #endif
 
 #ifdef ARDUINO_ARCH_ESP32                  // ESP32 based boards
+// Check to see if ESP Software Serial has been included
+// Note: you need to #include <SoftwareSerial.h> at the very start of your script,
+// _before_ the #include <SparkFun_u-blox_SARA-R5_Arduino_Library.h>, for this to work.
+// See SARA-R5_Example2_Identification_ESPSoftwareSerial for more details.
+#if __has_include( <SoftwareSerial.h> )
+#define SARA_R5_SOFTWARE_SERIAL_ENABLED // Enable software serial
+#else
 #define SARA_R5_SOFTWARE_SERIAL_ENABLEDx // Disable software serial
 #endif
+#endif
+
+#ifdef ARDUINO_ARCH_ESP8266                // ESP8266 based boards
+// Check to see if ESP Software Serial has been included
+// Note: you need to #include <SoftwareSerial.h> at the very start of your script,
+// _before_ the #include <SparkFun_u-blox_SARA-R5_Arduino_Library.h>, for this to work.
+// See SARA-R5_Example2_Identification_ESPSoftwareSerial for more details.
+#if __has_include( <SoftwareSerial.h> )
+#define SARA_R5_SOFTWARE_SERIAL_ENABLED // Enable software serial
+#else
+#define SARA_R5_SOFTWARE_SERIAL_ENABLEDx // Disable software serial
+#endif
+#endif
 
 #ifdef SARA_R5_SOFTWARE_SERIAL_ENABLED
-#include <SoftwareSerial.h>
+#include <SoftwareSerial.h> // SoftwareSerial.h is guarded. It is OK to include it twice.
 #endif
 
 #include <IPAddress.h>