Developers guide

Chapter 22: Wireless Wide-Area Networking
Access Flags
212 Psion Teklogix Mobile Devices SDK Developers Guide
22.7 Access Flags
The Wireless Manager Control Panel applet and the Mobile Devices SDK are able to read and set
the same WWAN settings. The access flags prevent conflicts between values manipulated by the
Wireless Manager interface and by the Mobile Devices SDK. Most of the WWAN settings can be
queried through both access methods; however, the following four activities can be carried out by
both access methods, and should be carried out by an SDK application only after setting the corre-
sponding access flag:
• Set the network register state
• Set the PIN
• Set provisioned contexts
• Set suppress call notifications
The Mobile Devices SDK can set an access flag corresponding to each of these settings. While the
access flag is set, the Wireless Manager applet user interface cannot change the corresponding set-
ting. While one of these access flags is enabled, the application must handle everything associated
with the associated activity: The user interface is locked out until the access flag is disabled.
Set Register State Access Flag
When GSM radio modem is roaming, there are two courses of action. The first option is that either
the user or the software application selects a network. The second option is that the radio automat-
ically selects a network. An SDK application that explicitly selects a network must set this flag.
When the set register access flag is enabled, the user is prevented from selecting the network
though the Control Panel. The Tools -> Network menu is not available in the Wireless Manager
applet WWAN UI settings screen.
If this flag is set during driver initialization, and the startup registration mode for the modem is
WwanRegisterModeDeregister, then the user interface does not automatically select a network
at startup—this is the case for WORKABOUT PRO expansion boards with Chi Mei modems. In
this case, the network must be explicitly selected through the user interface or via the application.
Set PIN Access Flag
When the Set PIN access flag is enabled, the PIN cannot be entered through the Control Panel.
If this flag is set during driver initialization, then the user interface does not prompt the user for a
PIN or a PUK. The initialization progress status remains at Initializing modem until the applica-
tion that set the flag handles the PIN initialization.
Set Provisioned Contexts Access Flag
If this flag is set during driver initialization, the user interface is not used to set up the data config-
uration profile for the driver. As a result, even though the status is shown as Ready to connect, the
[CONNECT DATA] button is not available. The application that set this flag is responsible for
setting up the data configuration before establishing a packet data connection through RAS.
Set Suppress Call Notifications Access Flag
When this flag is set, the WWAN Control Panel program does not notify the user of the
Psion Teklogix computer when there is an incoming call. When this flag is not set, the WWAN
program always notifies the user of incoming calls—see the user manual for your Psion Teklogix
computer for further details.
This flag works with version 1.10047 and later of the WWANUI Control Panel program, accessed
through the Wireless Manager applet.