
Chapter 19: Wireless Wide-Area Networking
WWAN Driver Status Flags
201
Psion Mobile Devices Developers Guide
Shutdown
This flag is set when the WWAN driver detects that the modem has been shut down. If the modem power
has been removed through the GUI Power applet, or through the SDK then the shutdown flag is expected.
In most other cases, the modem requires a repair.
Possible reasons for a modem shutdown are:
• An over voltage has occurred—Siemens, and Cinterion, modems only—this should occur only in the case
of a hardware failure.
• An over temperature or under temperature has occurred—Siemens, and Cinterion, modems only.
•A SetPinState has resulted in the modem no longer being accessible; for example, trying to
enable/disable/change the PIN too many times with the wrong PIN.
After rebooting the modem the Personal Unblocking Key (PUK) is required.
• The serial driver has reported an error. One cause of this is that power has been removed from
the modem.
• On startup the serial driver could not be opened or the modem never activates the CTS signal.
Phone book ready
This flag must be set for phone book calls to be successful.
SMS store ready
The WWAN driver can send, retrieve, or delete SMS messages. The SMS capabilities or SMS configuration of
the modem can be queried. This flag must be set for the following functions to be successful:
• ReadSms
• SendSms
• DeleteSms
• SetSmsConfiguation
• GetSmsConfiguration
Initialized
The WWAN driver and the modem are ready to access the network. When the driver is in this state the
following calls can proceed:
• SetRegisterState
• SetProvisionedContexts
• GetAvailableNetworks
The following functions may return incomplete data, if the driver is not initialized:
• GetDeviceCaps
• GetSIMID
No SIM
A SIM card is not detected.
Bad SIM
The SIM card is invalid. This is usually a hardware problem. Some modems set this state if the SIM card
is missing.
Depending on the startup timing, this status may be returned if the SIM card has not been activated on
the network.
If a PIN is entered incorrectly three times in succession, the PUK is requested. If the PUK is entered incor-
rectly 10 times in succession, the SIM card is permanently disabled, and it must be replaced.
Failure
The modem has failed. This occurs before the modem enters Shutdown status. In this state a limited
number of query commands are successful. This status usually indicates a hardware failure.
This status is set if the driver cannot communicate with the modem. It is also set if an initialization
command, which should always succeed, returns an error.
Comentarios a estos manuales