Add a new message to request the resending of a message

Author: Patrick Bechon

src/KerbalSimpit.cpp

@@ -85,6 +85,10 @@ void KerbalSimpit::deregisterChannel(byte channelID)
   _send(DEREGISTER_MESSAGE, &channelID, 1);
 }
 
+void KerbalSimpit::requestMessageOnChannel(byte channelID){
+  _send(REQUEST_MESSAGE, &channelID, 1);
+}
+
 void KerbalSimpit::printToKSP(String msg){
 	printToKSP(msg, 0);
 }

src/KerbalSimpit.h

@@ -138,6 +138,14 @@ class KerbalSimpit
   void printToKSP(String msg);
   void printToKSP(String msg, byte options);
 
+  /**
+   * Ask Simpit to resend a message on the given channel (useful for channels that only send on change).
+   * When subscribing on a channel, a message is automatically sent so there is no need to call this during init.
+   * May not work on all channels.
+   * @param channelID The channel ID to request from (taken from the OutboundPackets enum). Use 0 as a special value for all channels
+   */
+  void requestMessageOnChannel(byte channelID);
+
   /**
    * Number of message dropped due to corrupted packet (missing data or bad checksum).
    * This may not be accurate in all cases, some packets can be lost without being noticed here in case of extreme congestion.

src/KerbalSimpitMessageTypes.h

@@ -238,6 +238,10 @@ enum InboundPackets
     /** Deregister, indicate that no further messages
       for the given channel should be sent. */
     DEREGISTER_MESSAGE = 9,
+    /** Request a new message to be sent on this channel (used for channel that only send message on request).
+     *  If requested on the channel 0, it will trigger a new message on all subscribed channels. 
+     *  May not work on all channels. */
+    REQUEST_MESSAGE = 29,
     // Custom action packets activate and deactivate custom action groups
     /** Activate the given Custom Action Group(s). */
     CAGACTIVATE_MESSAGE = 10,