Developers guide

Chapter 22: Wireless Wide-Area Networking
WWAN Driver Status Flags
200 Psion Teklogix Mobile Devices SDK Developers Guide
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 incorrectly 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.