Add support for broadcast messages

library.properties

@@ -1,5 +1,5 @@
 name=DCCEXProtocol
-version=0.0.9
+version=0.0.10
 author=Peter Cole, Peter Akers <[email protected]>
 maintainer=Peter Cole, Peter Akers <[email protected]>
 sentence=DCC-EX Native Protocol implementation

src/DCCEXProtocol.cpp

@@ -547,6 +547,12 @@ void DCCEXProtocol::_processCommand() {
         }
         break;
 
+      case 'm':   // Broadcast message
+        if (DCCEXInbound::isTextParameter(0)) {
+          _processMessage();
+        }
+        break;
+
       case 'I':   // Turntable broadcast
         if (DCCEXInbound::getParameterCount()==3) {
           _processTurntableBroadcast();
@@ -650,6 +656,10 @@ void DCCEXProtocol::_processServerDescription() { //<iDCCEX version / microproce
   // console->println(F("processServerDescription(): end"));
 }
 
+void DCCEXProtocol::_processMessage() { //<m "message">
+  _delegate->receivedMessage(DCCEXInbound::getSafeText(0));
+}
+
 char* DCCEXProtocol::_nextServerDescriptionParam(char* description, int startAt, bool lookingAtVersionNumber) {
   char _tempString[MAX_SERVER_DESCRIPTION_PARAM_LENGTH];
   int i = 0; 

src/DCCEXProtocol.h

@@ -31,6 +31,7 @@
 /*
 Version information:
 
+0.0.10  - Add support for broadcast messages
 0.0.9   - if loco is selected by address and that loco is in the roster (with the same DCC Address), updated and send speed commands for both
 0.0.8   - No functional changes, add cross-platform and unit testing capabilities (credit to higaski)
 0.0.7   - Add isFunctionMomentary(int function);
@@ -119,6 +120,10 @@ class DCCEXProtocolDelegate {
   /// @param patch Patch version of EX-CommandStation (eg. 5.0.7 returns 7)
   virtual void receivedServerVersion(int major, int minor, int patch) {}
 
+  /// @brief Notify when a broadcast message has been received
+  /// @param message message that has been broadcast
+  virtual void receivedMessage(char* message) {}
+
   /// @brief Notify when the roster list is received
   virtual void receivedRosterList() {}
 
@@ -424,6 +429,7 @@ class DCCEXProtocol {
     void _sendCommand();
     void _processCommand();
     void _processServerDescription();
+    void _processMessage();
     char* _nextServerDescriptionParam(char* description, int startAt, bool lookingAtVersionNumber);
 
     // Consist/loco methods