Configuration and DDS example/tools updates

- Update DDS example command UI and extract it from example.
 - Unify address handling via DDS properties for dynamic deployment.
 - Update DDS docs with the new approach.
 - Allow `--config-key` to be used to access common config in JSON.
 - Allow common channel properties to be specified for all sockets.
 - Update MQ examples and Tuto3 with new config options.
 - Add start scripts to MQ examples for easier use.

fairmq/deployment/runDDSCommandUI.cxx

@@ -0,0 +1,113 @@
+#include "dds_intercom.h"
+
+#include <termios.h> // raw mode console input
+
+#include <iostream>
+#include <exception>
+#include <sstream>
+#include <thread>
+#include <atomic>
+
+using namespace std;
+using namespace dds::intercom_api;
+
+void PrintControlsHelp()
+{
+    cout << "Use keys to control the devices:" << endl;
+    cout << "[c] check states, [h] help, [p] pause, [r] run, [s] stop, [t] reset task, [d] reset device, [q] end, [j] init task, [i] init device" << endl;
+    cout << "To quit press Ctrl+C" << endl;
+}
+
+int main(int argc, char* argv[])
+{
+    try
+    {
+        CCustomCmd ddsCustomCmd;
+
+        // subscribe to receive messages from DDS
+        ddsCustomCmd.subscribe([](const string& msg, const string& condition, uint64_t senderId)
+        {
+            cout << "Received: \"" << msg << "\"" << endl;
+        });
+
+        char c;
+
+        // setup reading from cin (enable raw mode)
+        struct termios t;
+        tcgetattr(STDIN_FILENO, &t); // get the current terminal I/O structure
+        t.c_lflag &= ~ICANON; // disable canonical input
+        tcsetattr(STDIN_FILENO, TCSANOW, &t); // apply the new settings
+
+        PrintControlsHelp();
+
+        while (cin >> c)
+        {
+            int result = 0; // result of the dds send
+
+            switch (c)
+            {
+                case 'c':
+                    cout << " > checking state of the devices" << endl;
+                    result = ddsCustomCmd.send("check-state", "");
+                    break;
+                case 'i':
+                    cout << " > init devices" << endl;
+                    result = ddsCustomCmd.send("INIT_DEVICE", "");
+                    break;
+                case 'j':
+                    cout << " > init tasks" << endl;
+                    result = ddsCustomCmd.send("INIT_TASK", "");
+                    break;
+                case 'p':
+                    cout << " > pause devices" << endl;
+                    result = ddsCustomCmd.send("PAUSE", "");
+                    break;
+                case 'r':
+                    cout << " > run tasks" << endl;
+                    result = ddsCustomCmd.send("RUN", "");
+                    break;
+                case 's':
+                    cout << " > stop devices" << endl;
+                    result = ddsCustomCmd.send("STOP", "");
+                    break;
+                case 't':
+                    cout << " > reset tasks" << endl;
+                    result = ddsCustomCmd.send("RESET_TASK", "");
+                    break;
+                case 'd':
+                    cout << " > reset devices" << endl;
+                    result = ddsCustomCmd.send("RESET_DEVICE", "");
+                    break;
+                case 'h':
+                    cout << " > help" << endl;
+                    PrintControlsHelp();
+                    break;
+                case 'q':
+                    cout << " > end" << endl;
+                    result = ddsCustomCmd.send("END", "");
+                    break;
+                default:
+                    cout << "Invalid input: [" << c << "]" << endl;
+                    PrintControlsHelp();
+                    break;
+            }
+
+            if (result == 1)
+            {
+                cerr << "Error sending custom command" << endl;
+            }
+        }
+
+        // disable raw mode
+        tcgetattr(STDIN_FILENO, &t); // get the current terminal I/O structure
+        t.c_lflag |= ICANON; // re-enable canonical input
+        tcsetattr(STDIN_FILENO, TCSANOW, &t); // apply the new settings
+    }
+    catch (exception& e)
+    {
+        cerr << "Error: " << e.what() << endl;
+        return EXIT_FAILURE;
+    }
+
+    return EXIT_SUCCESS;
+}