[GP-1195] Cellular debugging - add a query

Define the set of debugging AT commands and a function to execute such
commands. The function executes the commands one-by-one end returns raw command
outputs. To be used by radio-query --diagnostics.

4 files changed, 204 insertions, 2 deletions

diff --git a/src/MTS_IO_CellularRadio.cpp b/src/MTS_IO_CellularRadio.cpp
index 3de96ce..069d5fa 100644
--- a/src/MTS_IO_CellularRadio.cpp
+++ b/src/MTS_IO_CellularRadio.cpp
@@ -1868,4 +1868,65 @@ ICellularRadio::CODE CellularRadio::setPdpContext(const std::string& sId, const
     rc = sendBasicCommand(sCommand, dTimeout);
 
     return rc;
-}
\ No newline at end of file
+}
+
+ICellularRadio::CODE CellularRadio::getDiagnostics(std::string& sReport) {
+    // Clear the original content before using the string as a buffer.
+    sReport.clear();
+
+    // Determine whether the SIM card is locked to select the appropriate
+    // list of commands for this radio.
+    std::string sSimLockStatus;
+    CODE iSimLockRet = getSimLockStatus(sSimLockStatus);
+
+    // Re-use the SIM status detection logic from TelitRadio::getNetworkStatus.
+    // The SIM should be inserted and NOT locked.
+    bool bIsSimReady = (iSimLockRet == CODE::SUCCESS
+                        && sSimLockStatus != "SIM PIN"
+                        && sSimLockStatus != "SIM PUK");
+
+    // Determine the list of diagnostic commands required for this radio.
+    const auto& vCommands = getDiagCommands(bIsSimReady);
+
+    // For all commands - set the maximum timeout to 2 seconds.
+    const int iMaxTimeout = 2000;
+
+    // Allow the radio to ignore up to 2 consecutive queries before giving up.
+    int iMaxNoResponseCount = 2;
+    int iNoResponseCount = 0;
+
+    // Execute each of the commands, add their output to the report.
+    for (const auto& sCmd : vCommands) {
+        // First line - the command to execute.
+        sReport.append(sCmd);
+        sReport.push_back(ICellularRadio::CR);
+        sReport.push_back(ICellularRadio::NL);
+
+        // Execute the command.
+        std::string sResult = sendCommand(sCmd, ICellularRadio::DEFAULT_BAIL_STRINGS, iMaxTimeout);
+
+        // Count the number of commands ignored by the radio.
+        // Normally, the radio should not ignore any of the commands,
+        // but radios have their own bugs.
+        if (sResult.empty()) {
+            printWarning("%s| Failed to execute the [%s] command - no response from the radio in [%d] ms", getName().c_str(), sCmd.c_str(), iMaxTimeout);
+            sResult = "<NO RESPONSE FROM THE RADIO>\r\n";
+            ++iNoResponseCount;
+        } else {
+            iNoResponseCount = 0;
+        }
+
+        // If the radio ignored too many commands - probably it is stuck and will not
+        // return to operation on its own. There is no point in waiting any longer.
+        if (iNoResponseCount >= iMaxNoResponseCount) {
+            printError("%s| Failed to execute the diagnostic commands - the radio has stopped responding", getName().c_str());
+            return CODE::NO_RESPONSE;
+        }
+
+        // Append the command output to the report.
+        sReport.append(sResult);
+    }
+
+    // All commands returned a non-empty output.
+    return CODE::SUCCESS;
+}
diff --git a/src/MTS_IO_LE910Radio.cpp b/src/MTS_IO_LE910Radio.cpp
index ba03c5e..2f1debb 100644
--- a/src/MTS_IO_LE910Radio.cpp
+++ b/src/MTS_IO_LE910Radio.cpp
@@ -165,3 +165,68 @@ ICellularRadio::CODE LE910Radio::getUeModeOfOperation(ICellularRadio::UE_MODES_O
     return rc;
 }
 
+const std::vector<std::string>& LE910Radio::getDiagCommands(bool bIsSimReady) {
+    // Declare as static to initialize only when used, but cache the results.
+    const static std::vector<std::string> vCommands {
+        // Radio model and firmware:
+        "AT+CGMI", "AT+CGMM", "AT+CGMR", "AT#SWPKGV", "AT#CFVR",
+
+        // Current operator profile on the radio side:
+        "AT#FWSWITCH?", "AT+CGSN",
+
+        // SIM card information:
+        "AT#SIMDET?", "AT#CCID", "AT+CPIN?", "AT#PCT",
+
+        // Operating mode of the radio:
+        "AT+CFUN?",
+
+        // Low-level network settings:
+        "AT+WS46?", "AT#RXDIV", "AT#CALLDISA?", "AT+CEMODE?",
+
+        // Data connection configuration:
+        "AT+CGDCONT?", "AT#PDPAUTH?",
+
+        // Registration and connection to the tower:
+        "AT+CIND?", "AT+CSQ", "AT+COPS?", "AT+CREG?", "AT+CGREG?", "AT+CEREG?",
+        "AT#RFSTS", "AT#PSNT?", "AT#MONI",
+
+        // Data connection status:
+        "AT+CGACT?", "AT+CGCONTRDP=1", "AT+CGCONTRDP=2", "AT+CGCONTRDP=3"
+    };
+
+    const static std::vector<std::string> vSimLockedCommands {
+        // Radio model and firmware:
+        "AT+CGMI", "AT+CGMM", "AT+CGMR", "AT#SWPKGV", "AT#CFVR",
+
+        // Current operator profile on the radio side:
+        "AT#FWSWITCH?", "AT+CGSN",
+
+        // SIM card information:
+        "AT#SIMDET?", "AT#CCID", "AT+CPIN?", "AT#PCT",
+
+        // Operating mode of the radio:
+        "AT+CFUN?",
+
+        // Low-level network settings:
+        "AT+WS46?", "AT#RXDIV", "AT#CALLDISA?", "AT+CEMODE?",
+
+        // Data connection configuration:
+        "AT+CGDCONT?", "AT#PDPAUTH?",
+
+        // Registration and connection to the tower.
+        // The same set of commands, but AT#RFSTS is replaced with a dummy command.
+        "AT+CIND?", "AT+CSQ", "AT+COPS?", "AT+CREG?", "AT+CGREG?", "AT+CEREG?",
+        "AT#RFSTS_IGNORED", "AT#PSNT?", "AT#MONI",
+
+        // Data connection status:
+        "AT+CGACT?", "AT+CGCONTRDP=1", "AT+CGCONTRDP=2", "AT+CGCONTRDP=3"
+    };
+
+    // Ignore AT#RFSTS on LE910 radios (mostly legacy ones like LAT1 and LEU1) if
+    // the SIM card is locked by PIN or PUK. Telit Support Portal Case #5069697.
+    if (bIsSimReady) {
+        return vCommands;
+    } else {
+        return vSimLockedCommands;
+    }
+}
diff --git a/src/MTS_IO_QuectelRadio.cpp b/src/MTS_IO_QuectelRadio.cpp
index ae6200e..3a5924c 100644
--- a/src/MTS_IO_QuectelRadio.cpp
+++ b/src/MTS_IO_QuectelRadio.cpp
@@ -1627,4 +1627,48 @@ ICellularRadio::CODE QuectelRadio::setRxDiversity(const Json::Value& jArgs) {
     }
 
     return SUCCESS;
-}
\ No newline at end of file
+}
+
+const std::vector<std::string>& QuectelRadio::getDiagCommands(bool) {
+    // Declare as static to initialize only when used, but cache the results.
+    const static std::vector<std::string> vCommands {
+        // Radio model and firmware:
+        "AT+CGMI", "AT+CGMM", "AT+CGMR", "AT+QGMR",
+
+        // Current operator profile on the radio side:
+        "AT+QMBNCFG=\"SELECT\"", "AT+CGSN",
+
+        // SIM card information:
+        "AT+QSIMSTAT?", "AT+QCCID", "AT+CPIN?", "AT+QPINC=\"SC\"",
+
+        // Operating mode of the radio:
+        "AT+CFUN?",
+
+        // Cellular Mode (RAT selection):
+        "AT+QCFG=\"nwscanseq\"", "AT+QCFG=\"nwscanmode\"",
+
+        // Cellular Diversity configuration:
+        "AT+QCFG=\"divctl\",\"lte\"", "AT+QCFG=\"divctl\",\"wcdma\"", "AT+QCFG=\"diversity\"",
+
+        // Voice call support (AT&T, T-Mobile):
+        "AT+QNVFR=\"/nv/item_files/ims/IMS_enable\"",
+        "AT+QNVFR=\"/nv/item_files/modem/mmode/sms_only\"",
+        "AT+QNVR=5280,0",
+
+        // UE Mode of Operation (CEMODE; AT&T):
+        "AT+QCFG=\"servicedomain\"",
+        "AT+QNVFR=\"/nv/item_files/modem/mmode/ue_usage_setting\"",
+
+        // Data connection configuration:
+        "AT+CGDCONT?", "AT+QICSGP=1", "AT+QICSGP=2", "AT+QICSGP=3",
+
+        // Registration and connection to the tower:
+        "AT+CIND?", "AT+CSQ", "AT+COPS?", "AT+CREG?", "AT+CGREG?", "AT+CEREG?",
+        "AT+QENG=\"servingcell\"",
+
+        // Data connection status:
+        "AT+CGACT?", "AT+CGCONTRDP=1", "AT+CGCONTRDP=2", "AT+CGCONTRDP=3"
+    };
+
+    return vCommands;
+}
diff --git a/src/MTS_IO_TelitRadio.cpp b/src/MTS_IO_TelitRadio.cpp
index 2a07939..4a0a8b2 100644
--- a/src/MTS_IO_TelitRadio.cpp
+++ b/src/MTS_IO_TelitRadio.cpp
@@ -1179,3 +1179,35 @@ bool MTS::IO::TelitRadio::isContainsSignChar(const std::string& str) {
 
     return true;
 }
+
+const std::vector<std::string>& TelitRadio::getDiagCommands(bool) {
+    // Declare as static to initialize only when used, but cache the results.
+    const static std::vector<std::string> vCommands {
+        // Radio model and firmware:
+        "AT+CGMI", "AT+CGMM", "AT+CGMR", "AT#SWPKGV", "AT#CFVR",
+
+        // Current operator profile on the radio side:
+        "AT#FWSWITCH?", "AT+CGSN",
+
+        // SIM card information:
+        "AT#SIMDET?", "AT#CCID", "AT+CPIN?", "AT#PCT",
+
+        // Operating mode of the radio:
+        "AT+CFUN?",
+
+        // Low-level network settings:
+        "AT+WS46?", "AT#RXDIV", "AT#CALLDISA?", "AT+CEMODE?",
+
+        // Data connection configuration:
+        "AT+CGDCONT?", "AT#PDPAUTH?",
+
+        // Registration and connection to the tower:
+        "AT+CIND?", "AT+CSQ", "AT+COPS?", "AT+CREG?", "AT+CGREG?", "AT+CEREG?",
+        "AT#RFSTS", "AT#PSNT?", "AT#MONI",
+
+        // Data connection status:
+        "AT+CGACT?", "AT+CGCONTRDP=1", "AT+CGCONTRDP=2", "AT+CGCONTRDP=3"
+    };
+
+    return vCommands;
+}