summaryrefslogtreecommitdiff
path: root/include/mts/MTS_IO_CellularRadio.h
diff options
context:
space:
mode:
authorMaksym Telychko <maksym.telychko@globallogic.com>2019-06-06 16:03:44 +0300
committerMaksym Telychko <maksym.telychko@globallogic.com>2019-06-06 16:03:44 +0300
commitda563a985ccb0b5f316b44e35aabd511687ff4bf (patch)
tree8c4261bff4b66b16018541004db1cd04258b3ca1 /include/mts/MTS_IO_CellularRadio.h
parent53efcef2e2f521135b323e194c45f1d9fa7b5d5d (diff)
downloadlibmts-io-da563a985ccb0b5f316b44e35aabd511687ff4bf.tar.gz
libmts-io-da563a985ccb0b5f316b44e35aabd511687ff4bf.tar.bz2
libmts-io-da563a985ccb0b5f316b44e35aabd511687ff4bf.zip
[MTS-MTQ] refactoring: added quectel empty classes, CellularRadio moved to TelitRadio
Diffstat (limited to 'include/mts/MTS_IO_CellularRadio.h')
-rw-r--r--include/mts/MTS_IO_CellularRadio.h501
1 files changed, 2 insertions, 499 deletions
diff --git a/include/mts/MTS_IO_CellularRadio.h b/include/mts/MTS_IO_CellularRadio.h
index 007c130..1378612 100644
--- a/include/mts/MTS_IO_CellularRadio.h
+++ b/include/mts/MTS_IO_CellularRadio.h
@@ -29,510 +29,13 @@
#ifndef MTS_IO_CELLULARRADIO_H_
#define MTS_IO_CELLULARRADIO_H_
-#include <mts/MTS_IO_SerialConnection.h>
-#include <mts/MTS_NonCopyable.h>
-#include <mts/MTS_AutoPtr.h>
-#include <mts/MTS_Lock.h>
-#include <mts/MTS_Stdint.h>
-#include <json/json.h>
-#include <string>
-#include <vector>
-#include <functional>
-
-typedef struct
-{
- const char *name;
- int32_t low;
- int32_t high;
-} *pNameRangeMap, nameRangeMap;
-
-static const unsigned int NUM_GSM_BANDS = 7;
-static const unsigned int NUM_WCDMA_BANDS = 6;
-static const unsigned int NUM_LTE_BANDS = 42;
-
-// http://niviuk.free.fr/gsm_band.php
-static const nameRangeMap GSMband[] =
-{
- {"GSM 450", 259, 293}, {"GSM 480", 306, 340},
- {"GSM 750", 438, 511}, {"GSM 850", 128, 251},
- {"GSM 900 P", 1, 124}, {"GSM 900 E/R", 955, 1023},
- {"GSM DCS 1800/1900", 512, 885},
-
-};
-
-// http://niviuk.free.fr/umts_band.php
-static const nameRangeMap WCDMAband[] =
-{
- {"BAND I", 10592, 10838}, {"BAND II", 9662, 9938},
- {"BAND III", 1162, 1513}, {"BAND IV", 1537, 1738},
- {"BAND V", 4357, 4458}, {"BAND VI", 4387, 4413}
-};
-
-// http://niviuk.free.fr/lte_band.php
-static const nameRangeMap EULTRAband[] =
-{
- {"EUTRAN BAND1", 0, 599}, {"EUTRAN BAND2", 600, 1199},
- {"EUTRAN BAND3", 1200, 1949}, {"EUTRAN BAND4", 1950, 2399},
- {"EUTRAN BAND5", 2400, 2649}, {"EUTRAN BAND6", 2650, 2749},
- {"EUTRAN BAND7", 2750, 3449}, {"EUTRAN BAND8", 3450, 3799},
- {"EUTRAN BAND9", 3800, 4149}, {"EUTRAN BAND10", 4150, 4749},
- {"EUTRAN BAND11", 4750, 4999}, {"EUTRAN BAND12", 5000, 5179},
- {"EUTRAN BAND13", 5180, 5279}, {"EUTRAN BAND14", 5280, 5379},
- {"EUTRAN BAND17", 5730, 5849}, {"EUTRAN BAND18", 5850, 5999},
- {"EUTRAN BAND19", 6000, 6149}, {"EUTRAN BAND20", 6150, 6449},
- {"EUTRAN BAND21", 6450, 6525}, {"EUTRAN BAND22", 6600, 7399},
- {"EUTRAN BAND23", 7500, 7699}, {"EUTRAN BAND24", 7700, 8039},
- {"EUTRAN BAND25", 8040, 8689}, {"EUTRAN BAND26", 8690, 9039},
- {"EUTRAN BAND27", 9040, 9209}, {"EUTRAN BAND28", 9210, 9659},
- {"EUTRAN BAND29", 9660, 9769}, {"EUTRAN BAND30", 9770, 9869},
- {"EUTRAN BAND31", 9870, 9919}, {"EUTRAN BAND32", 9920, 10359},
- {"EUTRAN BAND33", 36000, 36199}, {"EUTRAN BAND34", 36200, 36349},
- {"EUTRAN BAND35", 36350, 36949}, {"EUTRAN BAND36", 36950, 37549},
- {"EUTRAN BAND37", 37550, 37749}, {"EUTRAN BAND38", 37750, 38249},
- {"EUTRAN BAND39", 38250, 38649}, {"EUTRAN BAND40", 38650, 39649},
- {"EUTRAN BAND41", 39650, 41589}, {"EUTRAN BAND42", 41590, 43589},
- {"EUTRAN BAND43", 43590, 45589}, {"EUTRAN BAND44", 45590, 46589}
-};
+#include <mts/MTS_IO_ICellularRadio.h>
namespace MTS {
namespace IO {
- class CellularRadio : NonCopyable {
-
- public:
- static const std::string DEFAULT_RADIO_PORT;
- static const std::string DEFAULT_RADIO_DIR;
-
- static const std::string VALUE_UNKNOWN;
- static const std::string VALUE_UNAVAILABLE;
- static const std::string VALUE_NOT_SUPPORTED;
-
- //Special Payload Characters
- static const char ETX; //Ends socket connection
- static const char DLE; //Escapes ETX and DLE within Payload
- static const char CR;
- static const char NL;
- static const char CTRL_Z;
-
- static const std::string RSP_OK;
- static const std::string RSP_ERROR;
-
- //Registration Values
- enum REGISTRATION : uint8_t {
- NOT_REGISTERED = 0,
- REGISTERED = 1,
- SEARCHING=2,
- DENIED=3,
- UNKNOWN=4,
- ROAMING=5
- };
-
- enum SERVICEDOMAIN : uint8_t {
- NO_SERVICE = 0,
- CS_ONLY = 1,
- PS_ONLY = 2,
- CSPS = 3
- };
-
- enum ACTIVEBAND : uint8_t {
- GSM_850 = 0,
- GSM_900 = 1,
- DCS_1800 = 2,
- PCS_1900 = 3
- };
-
- enum CODE : uint8_t {
- SUCCESS = 0,
- ERROR,
- FAILURE,
- NO_RESPONSE,
- NOT_APPLICABLE,
- INVALID_ARGS
- };
-
- enum SIMSTATUS : uint8_t {
- READY = 0,
- LOCKED,
- BLOCKED,
- NOT_INSERTED
- };
-
- static const std::string VALUE_NOT_REGISTERED;
- static const std::string VALUE_REGISTERED;
- static const std::string VALUE_SEARCHING;
- static const std::string VALUE_DENIED;
- static const std::string VALUE_ROAMING;
-
- //Static Data
- static const std::string KEY_TYPE; //!< GSM or CDMA
- static const std::string KEY_CODE; //!< Product Code : H5, H6, C2, EV3, G3
- static const std::string KEY_MODEL; //!< Model : HE910, CE910, DE910, GE910
- static const std::string KEY_MANUFACTURER; //!< Manufacturer: Telit
- static const std::string KEY_HARDWARE; //!< Radio Hardware Version
- static const std::string KEY_FIRMWARE; //!< Radio Firmware Version
- static const std::string KEY_FIRMWARE_BUILD;//!< Radio Firmware Build
- static const std::string KEY_IMEI; //!< International Mobile Station Equipment Identity
- static const std::string KEY_MEID; //!< Mobile Equipment Identifier
- static const std::string KEY_IMSI; //!< International Mobile Subscriber Identity
- static const std::string KEY_MSID; //!< Mobil Station ID (MSID) aka MIN aka MSIN aka Last few digits of IMSI
- static const std::string KEY_MDN; //!< Mobile Directory Number : Actual phone number dialed to reach radio
- static const std::string KEY_CARRIER; //!< Cellular Service Provider (Home Network)
- static const std::string KEY_ICCID; //!< Integrated Circuit Card Identifier
- static const std::string KEY_MSL; //!< Master Subsidy Lock
-
-
- //Network Status Data
- static const std::string KEY_ROAMING; //!< Indicates whether or not using Home Network
- static const std::string KEY_DATETIME; //!< Date and Time from tower
- static const std::string KEY_SERVICE; //!< Service Connection Type [GPRS, EGPRS, WCDMA, HSDPA, 1xRTT, EVDO]
- static const std::string KEY_NETWORK; //!< Cellular Service Provider
- static const std::string KEY_NETWORK_REG; //!< Network Registration
- static const std::string KEY_CID; //!< Cellular ID (Tower) in HEX
- static const std::string KEY_LAC; //!< Location Area Code in HEX
- static const std::string KEY_RAC; //!< Routing Area Code in HEX
- static const std::string KEY_RSSI; //!< Received Signal Strength Indication
- static const std::string KEY_RSSIDBM; //!< Received Signal Strength Indication in dBm
- static const std::string KEY_MCC; //!< Mobile Country Code
- static const std::string KEY_MNC; //!< Mobile Network (Operator) Code
- static const std::string KEY_CHANNEL; //!< ARFCN or UARFCN Assigned Radio Channel
- static const std::string KEY_TXPWR; //!< Transmit Power
- static const std::string KEY_PSC; //!< Active Primary Synchronization Code (PSC)
- static const std::string KEY_ECIO; //!< Active Ec/Io (chip energy per total wideband power in dBm)
- static const std::string KEY_RSCP; //!< Active RSCP (Received Signal Code Power in dBm)
- static const std::string KEY_DRX; //!< Discontinuous reception cycle length (ms)
- static const std::string KEY_MM; //!< Mobility Management State
- static const std::string KEY_RR; //!< Radio Resource State
- static const std::string KEY_NOM; //!< Network Operator Mode
- static const std::string KEY_ABND; //!< Active Band
- static const std::string KEY_BLER; //!< Block Error Rate (percentage)
- static const std::string KEY_SD; //!< Service Domain
- static const std::string KEY_DEBUG; //!< Debug Information
-
- static const std::string KEY_MIP; //!< Mobile IP Information
- static const std::string KEY_MIP_ID; //!< MIP Profile ID
- static const std::string KEY_MIP_ENABLED; //!< MIP Profile Enabled/Disabled
- static const std::string KEY_MIP_NAI; //!< Network Access Identifier
- static const std::string KEY_MIP_HOMEADDRESS; //!< Home Address
- static const std::string KEY_MIP_PRIMARYHA; //!< Primary Home Agent
- static const std::string KEY_MIP_SECONDARYHA; //!< Secondary Home Agent
- static const std::string KEY_MIP_MNAAASPI; //!< Mobile Node Authentication, Authorization, and Accounting Server Security Parameter Index
- static const std::string KEY_MIP_MNHASPI; //!< Mobile Node Home Agent Security Server Parameter Index
- static const std::string KEY_MIP_REVTUN; //!< Reverse Tunneling Enabled
- static const std::string KEY_MIP_MNAAASS; //!< Mobile Node Authentication, Authorization, and Accounting Server Shared Secret
- static const std::string KEY_MIP_MNHASS; //!< Mobile Node Home Agent Shared Secret
-
-
- //Values - Type
- static const std::string VALUE_TYPE_LTE;
- static const std::string VALUE_TYPE_GSM;
- static const std::string VALUE_TYPE_CDMA;
-
- //Values - Carrier
- static const std::string VALUE_CARRIER_VERIZON;
- static const std::string VALUE_CARRIER_AERIS;
- static const std::string VALUE_CARRIER_SPRINT;
- static const std::string VALUE_CARRIER_USCELLULAR;
- static const std::string VALUE_CARRIER_ATT;
- static const std::string VALUE_CARRIER_TMOBILE;
-
- static const std::string VALUE_SD_NO_SERVICE;
- static const std::string VALUE_SD_CS_ONLY;
- static const std::string VALUE_SD_PS_ONLY;
- static const std::string VALUE_SD_CSPS;
-
- static const std::string VALUE_ABND_GSM_850;
- static const std::string VALUE_ABND_GSM_900;
- static const std::string VALUE_ABND_DCS_1800;
- static const std::string VALUE_ABND_PCS_1900;
-
- static const std::vector<std::string> DEFAULT_BAIL_STRINGS;
-
- typedef std::function<bool(const std::string&/*iterationData*/, const std::string&/*allData*/)> IsNeedMoreData;
- typedef std::function<void(const Json::Value&)> UpdateCb;
-
- virtual ~CellularRadio();
-
- virtual bool initialize(uint32_t iTimeoutMillis = 5000);
- virtual bool resetRadio(uint32_t iTimeoutMillis = 5000);
- virtual bool resetConnection(uint32_t iTimeoutMillis = 5000);
- virtual void shutdown();
-
- const std::string& getName() const;
-
- virtual CODE getModel(std::string& sModel);
- static CODE convertModelToType(const std::string& sModel, std::string& sType);
- static CODE convertModelToMtsShortCode(const std::string& sModel, std::string& sCode, CellularRadio *radioObj = NULL);
- static CODE convertServiceDomainToString(SERVICEDOMAIN eSd, std::string& sSd);
- static CODE convertActiveBandToString(ACTIVEBAND eBand, std::string& sBand);
-
- virtual CODE getFirmware(std::string& sFirmware);
- virtual CODE getFirmwareBuild(std::string& sFirmwareBuild);
- virtual CODE getHardware(std::string& sHardware);
- virtual CODE getManufacturer(std::string& sManufacturer);
- virtual CODE getImei(std::string& sImei);
- virtual CODE getMeid(std::string& sMeid);
- virtual CODE getImsi(std::string& sImsi);
- virtual CODE getSimStatus(std::string& sSimStatus);
- virtual CODE getIccid(std::string& sIccid);
- virtual CODE getService(std::string& sService);
- virtual CODE getLac(std::string& sLac);
- virtual CODE getMdn(std::string& sMdn);
- virtual CODE getMsid(std::string& sMsid);
- virtual CODE getType(std::string& sType);
- virtual CODE getCarrier(std::string& sCarrier);
- virtual CODE getNetwork(std::string& sNetwork);
- virtual CODE getTower(std::string& sTower);
- virtual CODE getTime(std::string& sDate, std::string& sTime, std::string& sTimeZone);
- virtual CODE getRoaming(bool& bRoaming);
-
- virtual CODE getSignalStrength(int32_t& iRssi);
- virtual CODE getModemLocation(std::string& sLocation);
- virtual CODE convertSignalStrengthTodBm(const int32_t& iRssi, int32_t& dBm);
- virtual CODE convertdBmToSignalStrength(const int32_t& dBm, int32_t& iRssi);
-
- virtual CODE getRegistration(REGISTRATION& eRegistration);
- virtual CODE convertRegistrationToString(REGISTRATION eRegistration, std::string& sRegistration);
-
- //! Gather details of the radio's Mobile IP Profile
- /*!
- \param Json::Value object that will be populated with MIP data
- \return Returns result code of gathering MIP
- */
- virtual CODE getMipProfile(Json::Value& jMipProfile);
-
- /*
- * jArgs = {
- * "msl" : "Master Subsidy Lock (Aeris, Sprint): STRING"
- * }
- */
- virtual CODE validateMsl(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "mdn" : "Mobile Directory Number : STRING",
- * "msl" : "[OPTIONAL] Master Subsidy Lock (Aeris, Sprint): STRING"
- * }
- */
- virtual CODE setMdn(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "msid" : "Mobil Station ID (MSID) aka MIN aka MSIN : STRING",
- * "msl" : "[OPTIONAL] Master Subsidy Lock (Aeris, Sprint): STRING"
- * }
- */
- virtual CODE setMsid(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "activeProfile" : "Set active profile: STRING"
- * }
- */
- virtual CODE setMipActiveProfile(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "nai" : "Network Access Identifier : STRING"
- * }
- */
- virtual CODE setMipNai(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "homeIp" : "Home Address : STRING"
- * }
- */
- virtual CODE setMipHomeIp(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "primaryHa" : "Primary Home Agent : STRING"
- * }
- */
- virtual CODE setMipPrimaryHa(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "secondaryHa" : "Secondary Home Agent : STRING"
- * }
- */
- virtual CODE setMipSecondaryHa(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "mnAaaSpi" : "Mobile Node Authentication, Authorization, and Accounting Server Security Parameter Index : STRING"
- * }
- */
- virtual CODE setMipMnAaaSpi(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "mnHaSpi" : "Mobile Node Home Agent Security Server Parameter Index : STRING"
- * }
- */
- virtual CODE setMipMnHaSpi(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "revTun" : "[DESCRIPTION] : STRING"
- * }
- */
- virtual CODE setMipRevTun(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "mnAaaSs" : "Mobile Node Authentication, Authorization, and Accounting Server Shared Secret : STRING"
- * }
- */
- virtual CODE setMipMnAaaSs(const Json::Value& jArgs);
-
- /*
- * jArgs = {
- * "mnHaSs" : "Mobile Node Home Agent Shared Secret : STRING"
- * }
- */
- virtual CODE setMipMnHaSs(const Json::Value& jArgs);
-
- /*
- * jArgs = null
- */
- virtual CODE updateDc(const Json::Value& jArgs, UpdateCb& stepCb);
-
- /*
- * jArgs = null
- */
- virtual CODE updatePrl(const Json::Value& jArgs, UpdateCb& stepCb);
-
- /*
- * jArgs = null
- */
- virtual CODE updateFumo(const Json::Value& jArgs, UpdateCb& stepCb);
-
- /*
- * jArgs = {
- * "msl" : "Master Subsidy Lock (Sprint): STRING"
- * }
- */
- virtual CODE resetHfa(const Json::Value& jArgs, UpdateCb& stepCb);
-
- /*
- * jArgs = {
- * "mdn" : "Mobile Directory Number (Aeris): STRING"
- * "msid" : "Mobile Station ID (Aeris): STRING"
- * }
- */
- virtual CODE activate(const Json::Value& jArgs, UpdateCb& stepCb);
-
- /*
- * jArgs = {
- * "enabled" : "RX Diversity Enabled ("0" or "1"): STRING"
- * }
- */
- virtual CODE setRxDiversity(const Json::Value& jArgs)=0;
- /*
- * jArgs = {
- * "fwid" : "Firmware Image To Be Enabled: STRING"
- * }
- */
- virtual CODE setActiveFirmware(const Json::Value& jArgs);
- virtual CODE getActiveFirmware(std::string& sFwId);
-
- virtual CODE getEcho(bool& bEnabled);
- virtual CODE setEcho(bool bEnabled = true);
-
- virtual CODE getStaticInformation(Json::Value& jData);
- virtual CODE getNetworkStatus(Json::Value& jData);
-
- virtual CODE sendBasicCommand(const std::string& sCmd, int32_t timeoutMillis = 100, const char& ESC = CR);
-
- virtual std::string sendCommand(const std::string& sCmd,
- const std::vector<std::string>& vBail = DEFAULT_BAIL_STRINGS,
- int32_t timeoutMillis = 100,
- const char& ESC = CR);
-
-
- static std::string sendCommand(MTS::AutoPtr<MTS::IO::Connection>& apIo,
- const std::string& sCmd,
- const std::vector<std::string>& vBail = DEFAULT_BAIL_STRINGS,
- int32_t timeoutMillis = 100,
- const char& ESC = CR);
-
- virtual std::string sendCommand(const std::string& sCmd,
- IsNeedMoreData& isNeedMoreData,
- int32_t timeoutMillis = 100,
- const char& ESC = CR);
-
- static std::string sendCommand(MTS::AutoPtr<MTS::IO::Connection>& apIo,
- const std::string& sCmd,
- IsNeedMoreData& isNeedMoreData,
- int32_t timeoutMillis = 100,
- const char& ESC = CR);
-
- static CODE test(MTS::AutoPtr<MTS::IO::Connection>& apIo, uint32_t timeoutSeconds = 30);
-
- static std::string extractModelFromResult(const std::string& sResult);
- static std::string getCodeAsString(CODE code);
-
- protected:
-
- CellularRadio(const std::string& sName, const std::string& sRadioPort);
-
- virtual bool getCarrierFromFirmware(const std::string& sFirmware, std::string& sCarrier);
- virtual bool getHardwareVersionFromFirmware(const std::string& sFirmware, std::string& sHardware);
-
- virtual void getCommonNetworkStats(Json::Value& jData);
-
- void initMipProfile(Json::Value& jData);
-
- bool splitAndAssign(const std::string& sLine, const std::string& sKey, Json::Value& jParent, const std::string& sJsonKey, Json::ValueType eType = Json::ValueType::stringValue);
-
-
-
- private:
- class RadioBandMap : NonCopyable {
- public:
- RadioBandMap()
- {
- m_sChannel = CellularRadio::VALUE_UNKNOWN;
- m_iChannel = 0;
- m_sRadioType = CellularRadio::VALUE_UNKNOWN;
- }
-
- RadioBandMap(const std::string &channel, const std::string &radioType) :
- m_sChannel(channel),
- m_sRadioType(radioType)
- {
- m_iChannel = strtol(m_sChannel.c_str(), NULL, 10);
- }
-
- virtual ~RadioBandMap() {}
-
- const char *getRadioBandName();
- const char *getRadioBandName(const std::string &channel, const std::string &radioType);
-
- private:
-
- const char *getLTEBand(const int channel);
- const char *getCDMABand(const int channel);
- const char *getGSMBand(const int channel);
-
- std::string m_sChannel;
- int m_iChannel;
- std::string m_sRadioType;
- };
-
- std::string m_sName;
- std::string m_sRadioPort;
- std::string m_sFirmware;
- std::string m_sCarrier;
- MTS::AutoPtr<MTS::IO::Connection> m_apIo;
-
- bool m_bEchoEnabled;
- bool m_bEnableEchoOnClose;
+ class CellularRadio : public ICellularRadio {
- std::string queryLteLac();
- std::string queryCGREGstring();
- void setCGREG(std::string value);
};
}
}