/*============================================================================ Copyright (c) 2022 Quectel Wireless Solution, Co., Ltd. All Rights Reserved. Quectel Wireless Solution Proprietary and Confidential. =============================================================================*/ #ifndef __QL_NW_H__ #define __QL_NW_H__ #ifdef __cplusplus extern "C" { #endif #define QL_NW_IND_VOICE_REG_EVENT_FLAG (1 << 0) //VOICE注册事件 #define QL_NW_IND_DATA_REG_EVENT_FLAG (1 << 1) //DATA注册事件 #define QL_NW_IND_SIGNAL_STRENGTH_EVENT_FLAG (1 << 2) //信号强度事件 #define QL_NW_IND_NITZ_TIME_UPDATE_EVENT_FLAG (1 << 3) //时间跟新事件 #define QL_NW_CELL_MAX_NUM 10 #define QL_NW_MCC_MAX_LEN 3 #define QL_NW_MNC_MAX_LEN 3 #define QL_NW_LONG_EONS_MAX_LEN 32 #define QL_NW_SHORT_EONS_MAX_LEN 32 #define QL_NW_REG_ON_FLAG 0x01 #define QL_NW_REG_OFF_FLAG 0x02 typedef enum { QUEC_NW_CMD_RESP_DATE_REG_STATUS_NO_LTE, QUEC_NW_EVENT_DATE_REG_STATUS_NO_LTE, QUEC_NW_CMD_RESP_DATE_REG_STATUS_LTE, QUEC_NW_EVENT_DATE_REG_STATUS_LTE,//3 QUEC_NW_CMD_RESP_VOICE_REG_STATUS, QUEC_NW_EVENT_VOICE_REG_STATUS,//5 QUEC_NW_CMD_RESP_NITZ, QUEC_NW_EVENT_NITZ, QUEC_NW_CMD_RESP_SIGNAL_STRENGTH, QUEC_NW_EVENT_SIGNAL_STRENGTH, QUEC_NW_CMD_RESP_OPERATOR, QUEC_NW_EVENT_GSM_ENGMODE_INFO, QUEC_NW_EVENT_LTE_ENGMODE_INTERRAT_INFO, //Mia.zhong @20201209 修复API无法获取邻区信息的问题 QUEC_NW_EVENT_UMTS_ENGMODE_SVCCELL_INFO, QUEC_NW_EVENT_UMTS_ENGMODE_INTRAFREQ_INFO, QUEC_NW_EVENT_UMTS_ENGMODE_INTERFREQ_INFO, QUEC_NW_EVENT_LTE_ENGMODE_SVCCELL_INFO, QUEC_NW_EVENT_LTE_ENGMODE_INTRAFREQ_INFO, QUEC_NW_EVENT_LTE_ENGMODE_INTERFREQ_INFO, QUEC_NW_EVENT_OPERATOR_STATUS, QUEC_NW_EVENT_ACT_INFO, QUEC_NW_EVENT_DETACHED_INFO, }QUEC_NW_EVENT_FLAG_E; typedef struct { unsigned short mcc; unsigned short mnc; char apn[64]; }QUEC_APN_LIST_T; typedef enum { QL_NW_SUCCESS, QL_NW_GENERIC_FAILURE, }QL_NW_ERROR_CODE; typedef enum { QL_NW_PREF_NET_TYPE_GSM = 0, /**< GSM */ QL_NW_PREF_NET_TYPE_UMTS, /**< UMTS . not supported in EC100Y and EC200S*/ QL_NW_PREF_NET_TYPE_GSM_UMTS, /**< GSM_UMTS, auto. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_GSM_UMTS_PREF_GSM, /**< GSM_UMTS, GSM preferred. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_GSM_UMTS_PREF_UMTS, /**< GSM_UMTS, UMTS preferred. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_LTE, /**< LTE */ QL_NW_PREF_NET_TYPE_GSM_LTE_AUTO, /**< GSM_LTE, auto, single link */ QL_NW_PREF_NET_TYPE_GSM_LTE_PREF_GSM, /**< GSM_LTE, GSM preferred, single link */ QL_NW_PREF_NET_TYPE_GSM_LTE_PREF_LTE, /**< GSM_LTE, LTE preferred, single link */ QL_NW_PREF_NET_TYPE_UMTS_LTE_AUTO, /**< UMTS_LTE, auto, single link. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_UMTS_LTE_PREF_UMTS, /**< UMTS_LTE, UMTS preferred, single link. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_UMTS_LTE_PREF_LTE, /**< UMTS_LTE, LTE preferred, single link . not supported in EC100Y and EC200S*/ QL_NW_PREF_NET_TYPE_GSM_UMTS_LTE_AUTO, /**< GSM_UMTS_LTE, auto, single link. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_GSM_UMTS_LTE_PREF_GSM, /**< GSM_UMTS_LTE, GSM preferred, single link. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_GSM_UMTS_LTE_PREF_UMTS, /**< GSM_UMTS_LTE, UMTS preferred, single link. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_GSM_UMTS_LTE_PREF_LTE, /**< GSM_UMTS_LTE, LTE preferred, single link. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_GSM_LTE_DUALLINK, /**< GSM_LTE, dual link */ QL_NW_PREF_NET_TYPE_UMTS_LTE_DUALLINK, /**< UMTS_LTE, dual link. not supported in EC100Y and EC200S */ QL_NW_PREF_NET_TYPE_GSM_UMTS_LTE_DUALLINK, /**< GSM_UMTS_LTE, dual link. not supported in EC100Y and EC200S */ } QL_NW_PREFERRED_NETWORK_TYPE; typedef struct { QL_NW_PREFERRED_NETWORK_TYPE preferred_nw_mode; //首选的网络制式，见 QL_NW_PREFERRED_NETWORK_TYPE int roaming_pref; //漫游开关。 0 关； 1 开 }QL_NW_CONFIG_INFO_T; typedef struct { char nitz_time[32]; //格式：format: YY/MM/DD HH:MM:SS '+/-'TZ daylight, 18/09/19 07:40:18 +32 00. unsigned long abs_time; //0表示不可用 unsigned char leap_sec; //0表示不可用 }QL_NW_NITZ_TIME_INFO_T; typedef struct { char long_eons[QL_NW_LONG_EONS_MAX_LEN+1]; char short_eons[QL_NW_SHORT_EONS_MAX_LEN+1]; char mcc[QL_NW_MCC_MAX_LEN+1]; char mnc[QL_NW_MNC_MAX_LEN+1]; }QL_NW_OPERATOR_INFO_T; typedef enum { QL_NW_ACCESS_TECH_GSM = 0, QL_NW_ACCESS_TECH_GSM_COMPACT = 1, QL_NW_ACCESS_TECH_UTRAN = 2, QL_NW_ACCESS_TECH_GSM_wEGPRS = 3, QL_NW_ACCESS_TECH_UTRAN_wHSDPA = 4, QL_NW_ACCESS_TECH_UTRAN_wHSUPA = 5, QL_NW_ACCESS_TECH_UTRAN_wHSDPA_HSUPA = 6, QL_NW_ACCESS_TECH_E_UTRAN = 7, QL_NW_ACCESS_TECH_UTRAN_HSPAP = 8, QL_NW_ACCESS_TECH_E_UTRAN_CA = 9, QL_NW_ACCESS_TECH_NONE = 10, }QL_NW_ACCESS_TECHNOLOGY; typedef struct { int status; //0：未知的网络；1：可用的网络；2：当前的网络；3：禁止使用的网络 QL_NW_OPERATOR_INFO_T operator_name; //运营商信息，见QL_NW_OPERATOR_INFO_T。 QL_NW_ACCESS_TECHNOLOGY act; //注网制式，见QL_NW_RADIO_TECH_TYPE_T。 }QL_NW_SCAN_ENTRY_INFO_T; typedef enum { QL_NW_RADIO_TECH_UNKNOWN = 0, QL_NW_RADIO_TECH_GPRS = 1, QL_NW_RADIO_TECH_EDGE = 2, QL_NW_RADIO_TECH_UMTS = 3, QL_NW_RADIO_TECH_IS95A = 4, QL_NW_RADIO_TECH_IS95B = 5, QL_NW_RADIO_TECH_1xRTT = 6, QL_NW_RADIO_TECH_HSDPA = 9, QL_NW_RADIO_TECH_HSUPA = 10, QL_NW_RADIO_TECH_HSPA = 11, QL_NW_RADIO_TECH_EHRPD = 13, QL_NW_RADIO_TECH_LTE = 14, QL_NW_RADIO_TECH_HSPAP = 15, // HSPA+ QL_NW_RADIO_TECH_GSM = 16, QL_NW_RADIO_TECH_TD_SCDMA = 17, QL_NW_RADIO_TECH_IWLAN = 18, QL_NW_RADIO_TECH_LTEP = 19, QL_NW_RADIO_TECH_DC_HSPA = 20 } QL_NW_RADIO_TECHNOLOGY; typedef enum { QL_NW_REG_STATE_NOT_REGISTERED=0, //not registered, MT is not currently searching an operator to register to QL_NW_REG_STATE_HOME_NETWORK=1, //registered, home network QL_NW_REG_STATE_TRYING_ATTACH_OR_SEARCHING=2, //not registered, but MT is currently trying to attach or searching an operator to register to QL_NW_REG_STATE_DENIED=3, //registration denied QL_NW_REG_STATE_UNKNOWN=4, //unknown QL_NW_REG_STATE_ROAMING=5, //registered, roaming QL_NW_REG_STATE_HOME_NETWORK_SMS_ONLY=6, //registered for “SMS only”, home network (not applicable) QL_NW_REG_STATE_ROAMING_SMS_ONLY=7,// registered for “SMS only”, roaming (not applicable) QL_NW_REG_STATE_ATTACHED_EMERGENCY_ONLY=8, //attached for emergency bearer services only QL_NW_REG_STATE_HOME_NETWORK_CSFB_NOT_PREFERRED=9, //registered for “CSFB not preferred”, home network (not applicable) QL_NW_REG_STATE_ROAMING_CSFB_NOT_PREFERRED=10,//registered for “CSFB not preferred”, roaming (not applicable) QL_NW_REG_STATE_EMERGENCY_ONLY=11,//emergency bearer services only }QL_NW_REG_STATE; typedef struct { QL_NW_REG_STATE state; //注册状态 int lac; int cid; QL_NW_ACCESS_TECHNOLOGY rat; int rejectCause; //注册被拒绝的原因 int psc; //Primary Scrambling Code //char act[10]; // Network access technology (GSM, WCDMA, LTE etc.) } QL_NW_COMMON_REG_STATUS_INFO_T; typedef struct { QL_NW_COMMON_REG_STATUS_INFO_T voice_reg; //VOICE注册信息，见QL_NW_COMMON_REG_STATUS_INFO_T QL_NW_COMMON_REG_STATUS_INFO_T data_reg; //DATA注册信息。 }QL_NW_REG_STATUS_INFO_T; typedef struct { int nw_selection_mode; //0 自动；1手动 char mcc[QL_NW_MCC_MAX_LEN+1]; char mnc[QL_NW_MNC_MAX_LEN+1]; QL_NW_ACCESS_TECHNOLOGY act; //selection 制式，见QL_NW_ACCESS_TECHNOLOGY。 }QL_NW_SELECTION_INFO_T; typedef struct { int rssi; int bitErrorRate; int rscp; int ecno; } QL_NW_GW_SIGNAL_STRENGTH_INFO_T; typedef struct { int rssi; int rsrp; int rsrq; int cqi; } QL_NW_LTE_SIGNAL_STRENGTH_INFO_T; typedef struct { QL_NW_GW_SIGNAL_STRENGTH_INFO_T GW_SignalStrength; QL_NW_LTE_SIGNAL_STRENGTH_INFO_T LTE_SignalStrength; }QL_NW_SIGNAL_STRENGTH_INFO_T; typedef struct { int flag; /**Cell type, 0:present,1:neighbor.*/ int cid; /**Cell ID, (0 indicates information is not represent).*/ int mcc; /**This field should be ignored when cid is not present*/ int mnc; /**This field should be ignored when cid is not present*/ int lac; /**Location area code.(This field should be ignord when cid is not present). */ int arfcn; /**Absolute RF channel number. */ char bsic; /**Base station identity code. (0 indicates information is not present). */ int rssi; /**< Receive signal strength, Value range: rxlev-111 for dbm format */ }QL_MCM_NW_GSM_CELL_INFO_T; typedef struct { int flag; /**Cell type, 0:present,1:inter,2:intra.*/ int cid; /**Cell ID, (0 indicates information is not represent).*/ int lcid; /**UTRAN Cell ID (0 indicates information is not present). */ int mcc; /**This field should be ignored when cid is not present*/ int mnc; /**This field should be ignored when cid is not present*/ int lac; /**Location area code. (This field should be ignored when cid is not present). */ int uarfcn; /**UTRA absolute RF channel number. */ int psc; /**Primary scrambling code. */ int rssi; /**< Receive signal strength, Value range: rscp-115 for dbm format */ }QL_MCM_NW_UMTS_CELL_INFO_T; typedef enum { QL_NW_CELL_PRESENT, QL_NW_CELL_NEIGHBORING, QL_NW_CELL_NEIGHBORING_INTRAR, QL_NW_CELL_NEIGHBORING_INTER, }QL_NW_CELL_TYPE_E; typedef struct { UINT32 flag; /**Cell type, 0:present,1:inter,2:intra.*/ UINT32 cid; /**