17.4. CTI GSM/UMTS/LTE ports diagnostics and statistics

17.4.1. Diagnostics of CTI GSM/UMTS/LTE ports

This command reports the current situation of the device:

[09:21:45] ABILIS_CPX:d d ctip:502

CTIP:502 ----------------------------------------------------------------------
       SIM_3204748405_(EX_RETENOI_3276270837)
       USER:#                                 OPSTATE:UP          STATE:UP
       ------------------------------------------------------------------------
       CH: STATE: [Q932-STATE:] CG: [SG:]               CD: [SD:]              
       ------------------------------------------------------------------------
                         *** All channels disconnected ***                   
       ------------------------------------------------------------------------
       VOICE-STATE:READY       PDN-STATE:READY         SMS-STATE:READY
       ------------------------------------------------------------------------
       NET:WIND                NET-MODE:GSM            ROAMING:NO
       SIGNAL:22               SIGNAL-dbm:-69          RXQUAL:0
       IMEI:357396012653490    IMSI:222881451579032    SIM:8939883345002210328
       SMSC:+393205858500      CODEC-ISO-BW:1304000    SIM-SEL:FIX-SIM-A
       CELL-MODEL:SIM5210      CELL-VER:V1.92          CELL-FEAT:VOICE,DATA,SMS
       CELL:CONNECTED          CELL-STATE:READY        CELL-ERR:NONE
       CODEC:CONNECTED         CODEC-STATE:READY       CODEC-ERR:NONE
       CONTROL:CONNECTED       CONTROL-STATE:READY     CONTROL-ERR:NONE

The meaning:

USER

Name of the user assigned to this port. Max 32 ASCII characters or #. The user must be present and it must not be already assigned to another port.

OPSTATE

The overall state of the port.

VOICE-STATE

The overall state of the GSM VOICE connection:

  • DOWN - Not ready to place or receive VOICE calls, either because of missing connection to the network or for some administratively or configuration reasons.

  • READY - Ready to place and receive VOICE calls.

  • IN-USE - A VOICE connection is ongoing or active.

PDN-STATE

The overall state of the PDN (Packet Data Network) connection:

  • DOWN - Not ready to attach to PDN, either because of missing connection to the network or for some administratively or configuration reasons.

  • READY - Ready to attach to PDN.

  • IN-USE - A PDN connection is ongoing or active.

  • BLOCKED - When the USB MODEM interface is blocked (The state should not survive too long, because safety timer restarts whole USB device after enter this state and timeout).

SMS-STATE

The overall state of the SMS channel:

  • DOWN - Ready to send/receive SMSs.

  • READY - Ready to send/receive SMSs.

NET

The currently used GSM network name.

ROAMING

Shows if the currently used UMTS/GSM network is ROAMING type:

  • N/A - The ROAMING diagnostic isn't valid (when NO SIM card inserted, when no network registered etc).

  • NO - The used network isn't ROAMING type.

  • YES - The used network is ROAMING type.

NET-MODE

Shows if the currently used network is GSM, UMTS or LTE.

SIGNAL

Signal quality (0 = -113 dBm or less, 1..30 = -111.. -53 dBm, 31 = -51 dBm, or greater 99 = not known or not detectable, 100 = N/A value when the device isn't connected)

RXQUAL

The value of BER (bit error rate) of the existing call.

IMEI

International Mobile Equipment Identity number.

IMSI

International Mobile Subscriber Identity number.

SIM

SIM card identification number.

SMSC

SMS Center number.

CODEC-ISO-BW

Indicates the bandwidth of the AUDIO-CODEC ISO interface.

CELL-MODEL

The CELL device model currently used by the port:

  • N/A - No device connected.

  • SIM5210 - SimCom 5210 module connected (UMTSBOX2 2011).

  • SIM5218 - SimCom 5218 module connected (UMTSBOX2 2012).

  • UD7200 - UMTSKEY module connected.

  • SIM7230E - SimCom 7230E module connected.

  • SIM7250E - SimCom 7250E module connected.

CELL

Shows if the hot-pluggable device is connected or not:

  • DISCONNECTED - Not connected to CPX.

  • CONNECTED - Connected to CPX.

  • UNAVAIL - No Gsm module is available for this GSM port (USB subsystem decides about the availability).

CELL-STATE

Shows the state of the USB interface of the GSM USB module:

  • INIT - Wait for initialisation.

  • READY - Completely initialised and ready to use.

  • FAILED - Failed because of serious troubles detected on the USB bus.

CELL-ERR

Shows the reason of the not READY GSM module:

  • NONE - No error detected, the GSM module works fine.

  • N/A - Not applicable error, the error is given by values in GsmUsb and GsmUsbState values whose are three states and cannot be expressed by this two state diagnostic. Usually when GSM device is disconnected or its handle isn't available.

  • USB-NO-RESP - USB RTU_NO_RESPONSE error was detected.

  • USB-OVERCUR - USB RTU_OVERCURRENT error was detected.

  • USB-NO-BW - USB RTU_BANDWIDTH error was detected.

  • NO-COM - AT interface doesn't work, detected by the At interface watchdog.

  • NO-SIM - No SIM card is inserted into the module.

  • SIM-LOCK - The CME-ERROR: 252 (SIM BLOCKED) was detected during the checking of the PIN protection state.

  • SIM-ERR - The CME-ERROR: different from 252 was detected during the checking of the PIN protection state.

  • PIN - Waits for PIN enter, the left number of attempts 2 or 1. When the 3 attempts are available the PIN from port configuration is automatically entered.

  • PUK - Waits for PUK enter.

  • PIN2 - Waits for PIN2 enter.

  • PUK2 - Waits for PUK2 enter.

  • NO-SIG - No GSM signal is available. The AT+CSQ command returns the value 99.

  • NO-NET - The GSM network isn't available.

  • NO-REG - The GSM module isn't registered into the network.

  • UNKNOWN - Unknown or not handled error.

CODEC

Shows if the hot-pluggable device is connected or not:

  • DISCONNECTED - The AUDIO module is not connected to CPX.

  • CONNECTED - The AUDIO module is connected to CPX.

  • UNAVAIL - No AUDIO module is available for this GSM port (USB subsystem decides about the availability).

  • INACTIVE - The AUDIO device isn't available because of inactivating state set by S INACT command.

CODEC-STATE

Shows the state of the USB interface of the CODEC module:

  • INIT - Wait for initialisation.

  • READY - Completely initialised and ready to use.

  • FAILED - Failed because of serious troubles detected on the USB bus.

CODEC-ERR

Shows the reason of the not READY GSM codec:

  • NONE - No error detected, the GSM codec works fine.

  • USB-OVERCUR - USB RTU_OVERCURRENT error was detected.

  • USB-NO-BW - USB RTU_BANDWIDTH error was detected.

  • N/A - Not applicable error, the error is given by values in GsmUsb and GsmUsbState values whose are three states and cannot be expressed by this two state diagnostic.

CONTROL

Shows if the hot-pluggable device is connected or not.

CONTROL-STATE

Shows the state of the USB interface of the CONTROL (PIC) module.

CONTROL-ERR

Shows the reason of the not READY GSM CONTROL (PIC).

Diagnostics of a CTI GSM port when a call is running:

[09:23:17] ABILIS_CPX:d d ctip:502

CTIP:502 ----------------------------------------------------------------------
       SIM_xxxxxxxxxx
       USER:#                                 OPSTATE:UP          STATE:UP
       ------------------------------------------------------------------------
       CH: STATE: [Q932-STATE:] CG: [SG:]               CD: [SD:]
       ------------------------------------------------------------------------
       1   07-LOC-ALERT         779                     xxxxxxxxxx
       ------------------------------------------------------------------------
       VOICE-STATE:IN-USE      PDN-STATE:READY         SMS-STATE:READY
       ------------------------------------------------------------------------
       NET:WIND                NET-MODE:GSM            ROAMING:NO
       SIGNAL:22               SIGNAL-dbm:-69          RXQUAL:0
       IMEI:357396012653490    IMSI:222881451579032    SIM:8939883345002210328
       SMSC:+393205858500      CODEC-ISO-BW:1304000    SIM-SEL:FIX-SIM-A
       CELL-MODEL:SIM5210      CELL-VER:V1.92          CELL-FEAT:VOICE,DATA,SMS
       CELL:CONNECTED          CELL-STATE:READY        CELL-ERR:NONE
       CODEC:CONNECTED         CODEC-STATE:READY       CODEC-ERR:NONE
       CONTROL:CONNECTED       CONTROL-STATE:READY     CONTROL-ERR:NONE
[Tip]Tip

CODEC-ISO-BW shows the USB Isochronous bandwidth reserved on the USB controller to serve the CTIP. The audio codec always reserves the bandwidth of TWO CTIP even if one is disabled.

This is what appears in the CTIR Connection (from PBX port group to GSM gateway):

[12:06:44] ABILIS_CPX:d ctic

SES  ID   Type Input    Output   PR  State  Cgi (Calling In)    Cdo (Called Out)
---- ---- ---- -------- -------- --- ------ ------------------- --------------------
2    2    TR   G1       502      3   ACTIVE 711                 3482233445       
d d ctip:<CTIP_number> netscan

Scanning available networks.

Example of NETSCAN:

[10:54:26] ABILIS_CPX:d d ctip:501 netscan

THE COMMAND WILL SEARCH ALL AVAILABLE NETWORKs.
THIS OPERATION MAY TAKE FEW MINUTES.
PROCEED ANYWAY (N/Y)?y

CTIP:501 ----------------------------------------------------------------------
       SIM_xxxxxxxxxx
       USER:#                                 OPSTATE:UP          STATE:UP
       ------------------------------------------------------------------------
       CH: STATE: [Q932-STATE:] CG: [SG:]               CD: [SD:]              
       ------------------------------------------------------------------------
                         *** All channels disconnected ***                   
       ------------------------------------------------------------------------
       VOICE-STATE:READY       PDN-STATE:READY         SMS-STATE:READY
       ------------------------------------------------------------------------
       NET:WIND                NET-MODE:GSM            ROAMING:NO
       SIGNAL:22               SIGNAL-dbm:-69          RXQUAL:0
       IMEI:357396012653300    IMSI:222881672196219    SIM:8939880367011211389
       SMSC:+393205858500      CODEC-ISO-BW:1304000    SIM-SEL:FIX-SIM-A
       CELL-MODEL:SIM5210      CELL-VER:V1.92          CELL-FEAT:VOICE,DATA,SMS
       CELL:CONNECTED          CELL-STATE:READY        CELL-ERR:NONE
       CODEC:CONNECTED         CODEC-STATE:READY       CODEC-ERR:NONE
       CONTROL:CONNECTED       CONTROL-STATE:READY     CONTROL-ERR:NONE
       - Available Networks ---------------------------------------------------
       Status:       Name:             Code:           Mode:
       CURRENT       WIND              22288           GSM       
       AVAILABLE     WIND              22288           UMTS      
       AVAILABLE     3ITA              22299           UMTS      
       FORBIDDEN     OMNITEL           22210           GSM       
       FORBIDDEN     OMNITEL           22210           UMTS      
       FORBIDDEN     TIM               22201           UMTS      
       FORBIDDEN     TIM               22201           GSM       
[Note]Note

If NETSCAN cannot be executed for any reason, e.g. because there is an active call or the module is disconnected, the message *** CANNOT EXECUTE NETSCAN *** is printed.

17.4.2. Statistics of CTI GSM/UMTS/LTE ports

This command can help to understand what is happening, in case of troubles:

d s ctip / d se ctip

Shows the statistics of all the CTI ports such as the number of calls (successful and unsuccessful), the duration of the calls, the number of connection/disconnection of the GSM/UMTS device, the number of connection/disconnection of the audio-codec device and the number of CELL packets exchanged.

d s ctip:<CTIP_number> / d se ctip:<CTIP_number>

Shows the statistics of a single CTI port.

[16:14:19] ABILIS_CPX:d s ctip:501

CTIP:501 ----------------------------------------------------------------------
       SIM-3883634235
       USER:#                                 
       --- Cleared 0 days 19:47:27 ago, on 14/05/2015 at 19:23:22 -------------
       Layer 3 Q.931
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       FAIL-CALL  |          0|          0|SUCC-CALL  |          2|          0|
       TIME-CALL  |         48|          0|
       ------------------------------------------------------------------------
       Layer 2 PDN
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       PDN-CALL   |           |          0|PDN-CHAR   |          0|          0|
       PDN-TIME   |           |          0|PDN-FRM    |          0|          0|
       PDN-TIME-15|           |          0|PDN-LOST   |          0|          0|
                  |           |           |PDN-LONG   |          0|          0|
       ------------------------------------------------------------------------
       Layer 2 SMS
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       SMS        |          0|          0|SMS-FAIL   |          0|          0|
       ------------------------------------------------------------------------
       Layer 1 CELL 
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CELL-DISC  |          0|           |           |           |           |
       CELL-CONN  |          1|           |           |           |           |
       CELL-MRST  |          0|           |           |           |           |
       CELL-ARST  |          0|           |           |           |           |
       CELL-HWRST |          0|           |           |           |           |
       CELL-PCK   |      68796|      34389|           |           |           |
       CELL-OVR   |          0|           |           |           |           |
       ------------------------------------------------------------------------
       CODEC-DISC |          0|           |CONTR-DISC |          0|           |
       CODEC-CONN |          1|           |CONTR-CONN |          1|           |
       CODEC-MRST |          0|           |CONTR-MRST |          0|           |
       CODEC-ARST |          0|           |CONTR-ARST |          0|           |
       CODEC-HWRST|          0|           |           |           |           |
       CODEC-PCK  |   71240766|   71241074|CONTR-PCK  |      71254|      71255|
       CODEC-OVR  |          0|           |CONTR-PCKH |          0|          0|
       CODEC-UND  |           |          0|           |           |           |
       ------------------------------------------------------------------------

With reference to the shown interval of time («Cleared 0 days 19:47:27 ago») these counters show the number of:

FAIL-CALLFailed incoming/outgoing voice calls.
TIME-CALLThe sum of all PDN calls.
SUCC-CALLThe sum of established incoming/outgoing voice calls duration.
PDN-CALLEstablished PDN calls.
PDN-TIMEThe sum of all PDN calls duration.
PDN-TIME-15PDN calls 15 minutes interval counter.
PDN-CHARChars (bytes) received/sent in the incoming/outgoing ASYND HDLC frames.
PDN-FRMIncoming/outgoing ASYNC HDLC frames into/from CELL port.
PDN-LOST IN - HDLC frames received but discarded. OUT - HDLC frames that was not sent within a timeout (1.5 secs), and discarded.
PDN-LONGIN - HDLC frames received discarded because too long. OUT - HDLC frames not sent because too long.
SMSIncoming/outgoing SMS messages.
SMS-FAILDiscarded incoming/outgoing SMS messages.
CELL-DISCDisconnection of the CELL device.
CELL-CONNConnection of the CELL device.
CELL-MRSTManual restarts performed on the CELL module.
CELL-ARSTCELL module auto restarts because of serious troubles on USB interface.
CELL-HWRSTCELL module restarts made by PIC command.
CELL-PCKUSB data blocks received/transmitted from/to the CELL module.
CELL-OVRDetected overruns on Serial to USB interface.
CODEC-DISCAudio codec disconnections from USB.
CODEC-CONNAudio codec connections into USB.
CODEC-MRSTManual restarts performed on the CELL Audio module.
CODEC-ARSTAuto-restarts performed on the CELL Audio module.
CODEC-HWRSTCODEC device restarts made via the PIC device.
CODEC-OVRDetected overruns errors on USB Audio-Codec.
CODEC-UNDDetected USB underrun errors on USB Audio-Codec.
CONTR-DISC PIC chip disconnections from USB.
CONTR-CONNPIC chip connections into USB..
CONTR-MRSTManual restarts performed on the PIC module
CONTR-ARSTAuto-restarts performed on the PIC module
CONTR-PCKUSB packets sent/received into/from the PIC of the CELL device.
CONTR-PCKHHigh priority USB packets sent/received into/from the PIC of the CELL device.