[GP-1111] mPower R. Apr 2021: +CEMODE shall be set to CEMODE=2

Added an ability to read the PLMN ID (MCC/MNC combination) of the home
carrier from the SIM.

SIM PLMN ID is a part of the IMSI that contains identifier of the home
network. PLMN ID in turn consists of 3-digit MCC (country code) and
2-or-3-digit MNC (network code). The length of the MNC is stored in the
SIM Elementary File called "Administrative Data" (EFad for short).

The purpose of the new functions is to extract PLMN ID from the SIM
if this information is available.

1 files changed, 15 insertions, 0 deletions

diff --git a/include/mts/MTS_IO_ICellularRadio.h b/include/mts/MTS_IO_ICellularRadio.h
index e638e8b..bed4dab 100644
--- a/include/mts/MTS_IO_ICellularRadio.h
+++ b/include/mts/MTS_IO_ICellularRadio.h
@@ -151,6 +151,7 @@ namespace MTS {
                 static const char *KEY_MSL;           //!< Master Subsidy Lock
                 static const char *KEY_SUPPORTED_CELL_MODES;  //!< Comma-separated list of all supported cellular modes (2g,3g,4g)
                 static const char *KEY_SIM_CARRIER_CODE;  //!< Unique carrier identifier based on the SIM card information.
+                static const char *KEY_SIM_MCC_MNC;   //!< MCC/MNC of the home network from the SIM.
 
 
                 //Network Status Data
@@ -576,6 +577,20 @@ namespace MTS {
 
                 virtual CODE setUeModeOfOperation(ICellularRadio::UE_MODES_OF_OPERATION mode) = 0;
                 virtual CODE getUeModeOfOperation(ICellularRadio::UE_MODES_OF_OPERATION& mode) = 0;
+
+                /**
+                 * @brief getSimMccMnc - get MCC/MNC (PLMN code) of the home network from the SIM.
+                 *
+                 * @param sPlmnId - a string to be filled with the MCC/MNC combination,
+                 *        example: "310410" (for AT&T), "90118" (for WMS).
+                 * @return CODE::SUCCESS when fetched successfully,
+                 *         CODE::NOT_APPLICABLE when the modem doesn't support this feature,
+                 *         CODE::NO_RESPONSE when the modem doesn't respond,
+                 *         CODE::ERROR when the radio returns "ERROR" (SIM card removed, SIM card locked etc),
+                 *         CODE::FAILURE otherwise (unexpected response, no data in SIM etc).
+                 */
+                virtual CODE getSimMccMnc(std::string& sMccMnc) = 0;
+                virtual CODE getSimMccMnc(std::string& sMcc, std::string& sMnc) = 0;
         };
     }
 }