The bottom area of the GPRS Modem Configuration view (or Gprs Platform Service Plugin view) contains data from the low-level GPRS modem driver (“GPRSD”) on the JACE, on two separate tabs.
This debug-level information updates only when you load or refresh
this view. The two tabs are:
In the GPRS Modem Configuration platform view in AX-3.4 and early AX-3.5 builds, all the “GPRS Status tab” data is available at the bottom of the view, but
there are no tabs. Data in the “GPRS Runtime Data” tab is found instead in the property sheet of the station’s GprsPlatformService. See GprsPlatformService (early) for related details.
This tab shows debug-level data, organized from top-to-bottom, in the following sections:
This section in the GPRS Status tab shows “PPP” (point to point protocol) related data, including the following:
engineState
Current state of the pppd control engine, as one of the following:
UNMOUNTED — a transitional state that should occur only when the driver starts. If it remains in this state, then the binaries necessary to run the pppd stack could not be loaded. When binaries successfully load, this state changes to INITIALIZING MODEM.
INITIALIZING MODEM — AT commands are being sent to the modem in order to set it up for GPRS connection over port ASC0. If successful, the state changes to STOPPED.
STOPPED — modem has been initialized successfully, and is ready to connect. This is the normal state for the engine in cases where “Enable use of PPP on ASC0” is set to false, else this is a transitional state if that Provider Configuration property is true. If conditions allow a connection, then AT commands are set to the modem to attach to the GPRS provider network, upon which the state transitions to CONNECTED.
CONNECTED — modem has successfully connected to the GPRS network, and is attempting to initialize the PPP stack. If successful, the state transitions to PPPD_SPAWNED.
PPPD_SPAWNED — The PPP stack has been loaded and initialized with successful negotiation of the LCP parameters, and authentication to the server was performed. The PPP connection is now operational and ready to accept IP packets. This is the normal state when a PPP connection has been established.
DISCONNECTING — if the PPP stack detects that no packets have been transmitted within the “Max PPP idle time before disconnecting”, then the PPP stack terminates, and the engine enters this state. While in this state, AT commands are sent to hang up the GPRS connection. If successful, the state then transitions to DISCONNECTED.
DISCONNECTED — the pppd engine stays in this state for “Min time before reconnecting” time, upon which time the state transitions to STOPPED, and the cycle repeats.
ifName
Interface name associated with the PPP stack. Will be blank until a PPP session is active.
ttyName
Name of the serial interface device the PPP connection uses on the JACE. This is physically tied to ASC0 on the modem.
speed
Actual baud rate the JACE’s serial interface uses to talk to the GPRS modem option’s UART.
connectedLocalIPAddress
Address assigned to the PPP stack, usually set during LCP negotiation in the PPP connection process.
connectedRemoteIpAddress
Address of the PPP server that is connected to.
nameServer(s)
DNS servers for the connected PPP server and original (before PPP connection) gateway.
defaultGateway
Gateway address that the JACE IP stack uses to forward packets. Should be the same as the connectedRemoteIpAddress if a PPP session is active, and “Switch gateway on PPP connection” is set true.
originalGateway
If “Switch gateway on PPP connection” is set true, this address is the gateway in use before PPP was started. Once PPP terminates, this address is written back to the “defaultGateway” of the IP stack.
lastConnectTime
Last time (local time) that a PPP session was established.
lastDisconnectTime
Time of the last PPP disconnect, for any reason.
lastError
Reason for last PPP termination.
lastErrorTime
Time of the last error that caused PPP termination.
pppdSpawnPid
Process ID in the JACE of the pppd process.
pppdSpawnCount
Number of times the pppd process has spawned.
lcp negotiate failures
Number of times LCP negotiations failed to complete with success.
modem shutoff commands
Number of times the AT^SMSO command was sent as a result of the “Max number of times LCP can fail before modem reset” property threshold being reached. See related Provider Configuration property.
This section in the GPRS Status tab shows data about the installed GPRS modem option, including the following:
manufacturer — the manufacturer of the installed modem, read via AT command during initialization of the modem.
model — the installed modem’s model number.
firmware — the installed modem’s firmware revision level.
imei — “international mobile equipment identity”.
imsi — “international mobile subscriber identity”.
SIM card status — status of SIM card, such as “SIM initialization completed”.
SIM card ID— the ID number of the installed SIM card.
lastFailedScriptCmd / lastFailedScriptCmdResult / lastFailedScriptCmdTime — these values are set if an AT command sent to the modem returns an “error” response.
CEER— extended error report values from the AT+CEER command. For details on interpreting this value, refer to the Siemens document TC63_ATC_V02.500 TC63 AT Command Set.
optionBoardResets — number of times the modem has been reset by the AT^SMSO command.
lastOptionBoardResetTime — time of the last reset by the AT^SMSO command.
This section in the GPRS Status tab shows data about failed SMS messages, including:
lastFailedSmsCmd / lastFailedSmsCmdResult / lastFailedSmsCmdTime — these values are set if an SMS message fails to be sent.
This section in the GPRS Status tab shows various data, with various following descriptions using terms ME (mobile equipment), MS (mobile station), PLMN (public land mobile network):
signal quality
The estimated BER (bit error rate) on the received signal. Valid values are 0—7, with 0 as less than 0.1% BER (fewest errors) and 7 as greater than 15% BER. A 99 value means this has not been read yet.
registration
If false, then not registered on any provider network, or if true and “roam” is false, then registered to home network, of if true and “roam” is true, then registered to another network.
roam
If false, then registered to home network or not registered, of if true then registered to another network.
rssi
Received single strength indicator, where:
0: signal strength <= 112 dbm
1—4: signal strength in 15 db steps
5: signal strength >= -51 dbm
sms full
If true, sms memory space is full; if false, sms memory space is not full.
cons
The “enhanced operator name string”.
nitz
The “network identity and time zone” information.
band
Currently selected frequency band or band combination.
CREG:
Network Registration Status, as one of the following:
0: Not Registered — ME is currently not searching for new operator. Normally, status 0 occurs temporarily between two network phases (status 2). However, if it persists, one of the following reasons may apply:
If automatic network selection is active, there is probably (either) no SIM card available, no PIN entered, or no valid Home PLMN entry found on the SIM.
If manual network selection is active and the selected network is available, login fails due to one of the following: #11 PLMN not allowed, #12 Location area not allowed, #13 Roaming not allowed in this location area.
In either case, user intervention is required. Yet, emergency call can be made if any network is available.
1: Registered to home network.
2: Not Registered — but ME is currently searching for a new operator. The ME searches for an available network. Failure to log in until after more than a minute may be due to one of the following reasons:
No network available or insufficient Rx level.
The ME has no access rights to the networks available.
Networks from the SIM list of allowed networks are around, but login fails due to one of the following: #11 PLMN not allowed, #12 Location area not allowed, #13 Roaming not allowed in this location area.
After this, the search will be resumed (if automatic network search is enabled).
The Home PLMN or allowed PLMN is available, but login is rejected by the cell (reasons: Access Class or LAC). If at least one network is available, emergency calls can be made.
3: Registration denied — Authentication or registration fails after Location Update Reject due to one of the following reasons:
#2...IMSI unknown at HLR.
#3...Illegal MS
#6...Illegal ME
Either the SIM or the MS or the ME are unable to log into any network. No further attempt is made to search or log into a network. User intervention is required. Emergency calls can be made, if any network is available.
4: Unknown (not used).
5: Registered, roaming. The ME is registered at a foreign network (national or international network).
CCREG:
GPRS Network Registration Status, as one of the following:
0: Not Registered — ME is not currently searching an operator to register to. The ME is in GMM state GMM-NULL or GMM-DEREGISTERED-INITIATED. GPRS service is disabled, the ME is allowed to attach to GPRS if requested by the user.
1: Registered to home network. The ME is in GMM state GMM-REGISTERED or GMM-ROUTING-AREA-UPDATING_INITIATED on the home PLMN.
2: Not Registered — But ME is currently trying to attach or searching an operator to register to. The ME is in GMM state GMM-DEREGISTERED or GMM-REGISTERED-INITIATED. The GPRS service is enabled, but an allowable PLMN is currently not available. The ME will start a GPRS attach as soon as an allowable PLMN is available.
3: Registration denied — The ME is in GMM state GMM-NULL. The GPRS service is disabled, the ME is not allowed to attach to GPRS if requested by the user.
4: Unknown
5: Registered, roaming — The ME is in GMM state GMM-REGISTERED or GMM-ROUNTING-AREA-UPDATING-INITIATED on a visited PLMN.
MONI
Monitor idle mode and dedicated mode. See section 8.9.1 in the Siemens document TC63 AT Command Set for full explanations of fields in this entry.
SMONG
GPRS Monitor, supplies GPRS specific cell information.
modem voltage
Modem supply voltage as measured by the GPRS modem.
This tab shows runtime data about the modem connection. For descriptions of the properties shown, see Properties of GprsPlatformService.
Copyright © 2000-2014 Tridium Inc. All rights reserved.