Psion Teklogix 7527S User's Guide download pdf (Page 211)

Chapter 22: Wireless Wide-Area Networking

Initializing WWAN

Psion Teklogix Mobile Devices SDK Developers Guide 199

22.4 Initializing WWAN

Before any of the WWAN functions can be used, you must initialize the WWAN interface.

22.4.1 Checking The Initialization Status Of The WWAN Driver

Use GetReadyState to check the initialization status of the driver. This returns one of

the following:

• C++: A WWAN_READY_STATE structure containing the WWAN driver status flags.

• .NET: A member of the WWAN_READY_STATE_FLAGS enumeration.

22.4.2 WWAN Driver Status Flags

The WWAN status flags indicate the status of the WWAN driver. This WWAN driver status

depends on the status of the modem.

Many WWAN API functions depend on the modem being in the ready state. If the modem is not

ready, they report an error.

There are two methods for finding the modem status. The first is to use API elements that query

the modem status. The second is to register a callback for modem initialization.

This second method—using a callback— is recommended. Repeated queries of modem status can

result in excessive processor activity and a consequent drain on the battery power of the

Psion Teklogix computer. If there is no other activity on the hand-held computer, the processor can

go into an idle state until activated by the callback.

In both cases status bits are returned that indicate which functions are available.

The WWAN driver can be in one or more of the following states:

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 Control Panel 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 HC25 & MC75 only—this should occur only in the

case of a hardware failure.

• An over temperature or under temperature has occurred—Siemens HC25 & MC75 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.

1 2 ... 206 207 208 209 210 211 212 213 214 215 216 ... 261 262

No comments

Psion Teklogix 7527S User's Guide Page 211