REST -> RPC Migration (#84)

* migrate away from REST API for inter-dvmhost operations towards a custom UDP RPC framework;

* replace config parameters for REST API in some places with properly named RPC; swap peer Network, FNE DiagNetwork and FNENetwork over from if-else-if ladders to switch statements (switch statements perform logically better after compilation because the compiler tends to optimize these into jump-tables which execute faster);

* continued work on inter-dvmhost REST to RPC transition;

* update build bumper for R04G20 to R04G21;

* cleanup config file;

* clean up doc/commenting;

Author: gatekeep

configs/config.example.yml

@@ -36,6 +36,9 @@ log:
 # Network Configuration
 #
 network:
+    #
+    # FNE Configuration
+    #
     # Flag indicating whether or not host networking is enabled.
     enable: true
     # Network Peer ID
@@ -77,6 +80,21 @@ network:
     # Flag indicating whether or not verbose debug logging is enabled.
     debug: false
 
+    #
+    # RPC Configuration
+    #
+    # IP address of the network interface to listen for RPC calls on (or 0.0.0.0 for all).
+    rpcAddress: 127.0.0.1
+    # Port number for RPC calls to listen on.
+    rpcPort: 9890
+    # RPC access password.
+    rpcPassword: "ULTRA-VERY-SECURE-DEFAULT"
+    # Flag indicating whether or not verbose RPC debug logging is enabled.
+    rpcDebug: false
+
+    #
+    # REST API Configuration
+    #
     # Flag indicating whether or not REST API is enabled.
     restEnable: false
     # IP address of the network interface to listen for REST API on (or 0.0.0.0 for all).
@@ -392,14 +410,12 @@ system:
         #   These parameters should be left default for dedicated control channels.
         #
         controlCh:
-            # REST API IP Address for control channel. (If blank, notifications are disabled.)
-            restAddress: 
-            # REST API Port number for control channel. (If 0, notifications are disabled.)
-            restPort: 0
-            # REST API access password for control channel.
-            restPassword: "PASSWORD"
-            # Flag indicating whether or not REST API is operating in SSL mode.
-            restSsl: false
+            # RPC IP Address for control channel. (If blank, notifications are disabled.)
+            rpcAddress: 127.0.0.1
+            # RPC Port number for control channel. (If 0, notifications are disabled.)
+            rpcPort: 0
+            # RPC access password for control channel.
+            rpcPassword: "ULTRA-VERY-SECURE-DEFAULT"
             # Flag indicating voice channels will notify the control channel of traffic status.
             notifyEnable: true
             # Amount of time between network presence announcements. (seconds)
@@ -414,14 +430,12 @@ system:
             - channelId: 2
               # Channel Number (used to calculate actual host frequency based on the identity table).
               channelNo: 1
-              # REST API IP Address for voice channel.
-              restAddress: 127.0.0.1
-              # REST API Port number for voice channel.
-              restPort: 9990
-              # REST API access password for voice channel.
-              restPassword: "PASSWORD"
-              # Flag indicating whether or not REST API is operating in SSL mode.
-              restSsl: false
+              # RPC IP Address for voice channel.
+              rpcAddress: 127.0.0.1
+              # RPC Port number for voice channel.
+              rpcPort: 9890
+              # RPC access password for voice channel.
+              rpcPassword: "ULTRA-VERY-SECURE-DEFAULT"
 
         secure:
             # AES-128 16-byte Key (used for LLA)

src/common/Defines.h

@@ -108,7 +108,7 @@ typedef unsigned long long  ulong64_t;
 #define __EXE_NAME__ ""
 
 #define VERSION_MAJOR       "04"
-#define VERSION_MINOR       "20"
+#define VERSION_MINOR       "21"
 #define VERSION_REV         "G"
 
 #define __NETVER__ "DVM_R" VERSION_MAJOR VERSION_REV VERSION_MINOR
@@ -153,6 +153,7 @@ typedef unsigned long long  ulong64_t;
 const uint32_t  REMOTE_MODEM_PORT = 3334;
 const uint32_t  TRAFFIC_DEFAULT_PORT = 62031;
 const uint32_t  REST_API_DEFAULT_PORT = 9990;
+const uint32_t  RPC_DEFAULT_PORT = 9890;
 
 /**
  * @brief Operational Host States

src/common/lookups/ChannelLookup.h

@@ -61,12 +61,12 @@ namespace lookups
          * @brief Initializes a new instance of the VoiceChData class.
          * @param chId Voice Channel Identity.
          * @param chNo Voice Channel Number.
-         * @param address REST API Address.
-         * @param port REST API Port.
-         * @param password REST API Password.
+         * @param address RPC/REST API Address.
+         * @param port RPC/REST API Port.
+         * @param password RPC/REST API Password.
          * @param ssl Flag indicating REST is using SSL.
          */
-        VoiceChData(uint8_t chId, uint32_t chNo, std::string address, uint16_t port, std::string password, bool ssl) :
+        VoiceChData(uint8_t chId, uint32_t chNo, std::string address, uint16_t port, std::string password, bool ssl = false) :
             m_chId(chId),
             m_chNo(chNo),
             m_address(address),
@@ -116,15 +116,15 @@ namespace lookups
          */
         __READONLY_PROPERTY_PLAIN(uint32_t, chNo);
         /**
-         * @brief REST API Address.
+         * @brief RPC/REST API Address.
          */
         __PROPERTY_PLAIN(std::string, address);
         /**
-         * @brief REST API Port.
+         * @brief RPC/REST API Port.
          */
         __PROPERTY_PLAIN(uint16_t, port);
         /**
-         * @brief REST API Password.
+         * @brief RPC/REST API Password.
          */
         __READONLY_PROPERTY_PLAIN(std::string, password);
         /**