chore: Template NoteSerial

Allows for SoftwareSerial

Author: zfields

src/NoteDefines.h

@@ -18,4 +18,9 @@
     #define NOTE_ARDUINO_NO_DEPRECATED_ATTR
 #endif // __GNUC__ || __clang__
 
+// Switches for enabling/disabling features
+#if defined(ARDUINO_ARCH_AVR) || defined(ARDUINO_ARCH_MEGAAVR) || defined(ARDUINO_ARCH_STM32) || defined(ARDUINO_ARCH_NRF52) || defined(ARDUINO_ARCH_RP2040)
+#define NOTE_ARDUINO_SOFTWARE_SERIAL_SUPPORT
+#endif
+
 #endif // NOTE_DEFINES_H

src/NoteSerial.hpp

@@ -65,8 +65,7 @@ class NoteSerial
                the platform specific UART implementation.
 */
 /******************************************************************************/
-NoteSerial * make_note_serial (
-    NoteSerial::param_t serial_parameters
-);
+template<typename T> NoteSerial * make_note_serial (T & serial_parameters);
+NoteSerial * make_note_serial (nullptr_t);
 
 #endif // NOTE_SERIAL_HPP

src/NoteSerial_Arduino.cpp

@@ -1,26 +1,63 @@
 #include "NoteSerial_Arduino.hpp"
 
+#include "NoteDefines.h"
+
+#ifndef NOTE_MOCK
+#ifdef NOTE_ARDUINO_SOFTWARE_SERIAL_SUPPORT
+#include <SoftwareSerial.h>
+#endif
+#else
+#include "mock/mock-arduino.hpp"
+#endif
+
+// Template Meta-Programming (TMP) to extract the nested template type
+template <typename nested_type>
+struct ExtractNestedTemplateType {
+    // Default case: no extraction
+};
+template <typename nested_type>
+struct ExtractNestedTemplateType<MakeNoteSerial_ArduinoParameters<nested_type>> {
+    using type = nested_type;
+};
+
+// Singleton instance of the NoteSerial_Arduino class
+namespace instance {
+    inline NoteSerial* & note_serial (void) {
+        static NoteSerial* note_serial = nullptr;
+        return note_serial;
+    }
+};
+
 NoteSerial *
 make_note_serial (
-    NoteSerial::param_t serial_parameters_
-)
-{
-    static NoteSerial * note_serial = nullptr;
-    if (!serial_parameters_) {
-        if (note_serial) {
-            delete note_serial;
-            note_serial = nullptr;
-        }
-    } else if (!note_serial) {
-        MakeNoteSerial_ArduinoParameters * arduino_parameters = reinterpret_cast<MakeNoteSerial_ArduinoParameters *>(serial_parameters_);
-        note_serial = new NoteSerial_Arduino(arduino_parameters->hw_serial, arduino_parameters->baud_rate);
+    nullptr_t
+) {
+    NoteSerial* & note_serial = instance::note_serial();
+    if (note_serial) {
+        delete note_serial;
+        note_serial = nullptr;
+    }
+    return note_serial;
+}
+
+template <typename T>
+NoteSerial *
+make_note_serial (
+    T & serial_parameters_
+) {
+    NoteSerial* & note_serial = instance::note_serial();
+    if (!note_serial) {
+        using serial_type = typename ExtractNestedTemplateType<T>::type;
+        note_serial = new NoteSerial_Arduino<serial_type>(serial_parameters_.hw_serial, serial_parameters_.baud_rate);
     }
+
     return note_serial;
 }
 
-NoteSerial_Arduino::NoteSerial_Arduino
+template <typename T>
+NoteSerial_Arduino<T>::NoteSerial_Arduino
 (
-    HardwareSerial & hw_serial_,
+    T & hw_serial_,
     size_t baud_rate_
 ) :
     _notecardSerial(hw_serial_),
@@ -29,31 +66,35 @@ NoteSerial_Arduino::NoteSerial_Arduino
     _notecardSerial.begin(_notecardSerialSpeed);
 }
 
-NoteSerial_Arduino::~NoteSerial_Arduino (
+template <typename T>
+NoteSerial_Arduino<T>::~NoteSerial_Arduino (
     void
 )
 {
     _notecardSerial.end();
 }
 
+template <typename T>
 size_t
-NoteSerial_Arduino::available (
+NoteSerial_Arduino<T>::available (
     void
 )
 {
     return _notecardSerial.available();
 }
 
+template <typename T>
 char
-NoteSerial_Arduino::receive (
+NoteSerial_Arduino<T>::receive (
     void
 )
 {
     return _notecardSerial.read();
 }
 
+template <typename T>
 bool
-NoteSerial_Arduino::reset (
+NoteSerial_Arduino<T>::reset (
     void
 )
 {
@@ -63,8 +104,9 @@ NoteSerial_Arduino::reset (
     return true;
 }
 
+template <typename T>
 size_t
-NoteSerial_Arduino::transmit (
+NoteSerial_Arduino<T>::transmit (
     uint8_t *buffer,
     size_t size,
     bool flush
@@ -77,3 +119,12 @@ NoteSerial_Arduino::transmit (
     }
     return result;
 }
+
+// Explicitly instantiate the classes and methods for the supported types
+template class NoteSerial_Arduino<HardwareSerial>;
+template NoteSerial * make_note_serial<MakeNoteSerial_ArduinoParameters<HardwareSerial>>(MakeNoteSerial_ArduinoParameters<HardwareSerial> &);
+
+#ifdef NOTE_ARDUINO_SOFTWARE_SERIAL_SUPPORT
+template class NoteSerial_Arduino<SoftwareSerial>;
+template NoteSerial * make_note_serial<MakeNoteSerial_ArduinoParameters<SoftwareSerial>>(MakeNoteSerial_ArduinoParameters<SoftwareSerial> &);
+#endif

src/NoteSerial_Arduino.hpp

@@ -9,30 +9,32 @@
 #include "mock/mock-arduino.hpp"
 #endif
 
+template <typename T>
 struct MakeNoteSerial_ArduinoParameters {
     MakeNoteSerial_ArduinoParameters (
-        HardwareSerial & hw_serial_,
+        T & hw_serial_,
         size_t baud_rate_
     ) :
         hw_serial(hw_serial_),
         baud_rate(baud_rate_)
     { }
-    HardwareSerial & hw_serial;
+    T & hw_serial;
     size_t baud_rate;
 };
 
+template <typename T>
 class NoteSerial_Arduino final : public NoteSerial
 {
 public:
-    NoteSerial_Arduino(HardwareSerial & hw_serial_, size_t baud_rate_);
+    NoteSerial_Arduino(T & hw_serial_, size_t baud_rate_);
     ~NoteSerial_Arduino(void);
     size_t available(void) override;
     char receive(void) override;
     bool reset(void) override;
     size_t transmit(uint8_t * buffer, size_t size, bool flush) override;
 
 private:
-    HardwareSerial & _notecardSerial;
+    T & _notecardSerial;
     const int _notecardSerialSpeed;
 };
 

src/Notecard.h

@@ -35,6 +35,9 @@
 
 #ifdef ARDUINO
 #include <Arduino.h>
+#ifdef NOTE_ARDUINO_SOFTWARE_SERIAL_SUPPORT
+#include <SoftwareSerial.h>
+#endif
 #include <Wire.h>
 #include "NoteSerial_Arduino.hpp"
 #endif
@@ -63,9 +66,15 @@ class Notecard
         begin(make_note_i2c(&wirePort), i2cAddress, i2cMax);
     }
     inline void begin(HardwareSerial &serial, uint32_t speed = 9600) {
-        MakeNoteSerial_ArduinoParameters arduino_parameters(serial, speed);
-        begin(make_note_serial(&arduino_parameters));
+        MakeNoteSerial_ArduinoParameters<HardwareSerial> arduino_parameters(serial, speed);
+        begin(make_note_serial<MakeNoteSerial_ArduinoParameters<HardwareSerial>>(arduino_parameters));
+    }
+#ifdef NOTE_ARDUINO_SOFTWARE_SERIAL_SUPPORT
+    inline void begin(SoftwareSerial &serial, uint32_t speed = 9600) {
+        MakeNoteSerial_ArduinoParameters<SoftwareSerial> arduino_parameters(serial, speed);
+        begin(make_note_serial<MakeNoteSerial_ArduinoParameters<SoftwareSerial>>(arduino_parameters));
     }
+#endif
     inline void setDebugOutputStream(Stream &dbgserial) {
         setDebugOutputStream(make_note_log(&dbgserial));
     }