Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

3    Using Palm OS Virtual Phone

Palm OS® Virtual Phone Guide

Palm OS® Developer Suite

Palm OS® Virtual Phone is a standard Windows NT/2000 application. This application displays a log of AT Commands that correspond to the Telephony Manager functions which were called by the application executing in Palm OS Cobalt Simulator.

Every time a Palm OS application calls a Telephony Manager function, the Telephony Manager issues one or more AT commands which are then sent to Virtual Phone. When Virtual Phone receives these AT commands it responses exactly like a real phone.

This chapter explains how you can use the Virtual Phone user interface to test your telephony applications. The chapter has the following organization.

Palm OS Virtual Phone Window
Palm OS Virtual Phone Menu Items
Phone Configuration Dialog Box
Service Configuration Dialog Box
Response Preferences Dialog Box
Options Dialog Box
Profile Setup Dialog Box

Palm OS Virtual Phone Window ^TOP^

The Virtual Phone window, shown in Figure 3.1, displays the text equivalent of the original Telephony Manager function, while the actual AT commands or traces are displayed in the AT Log window.

Figure 3.1  Virtual Phone window

This window displays the Telephony Manager functions that are called and the results of the calls.

Palm OS Virtual Phone Menu Items ^TOP^

Most of Virtual Phone's functions are available through the following menu items.

File Menu ^TOP^

Select File to work with Virtual Phone configuration files (VPC files).

File > New Profile

Select to open the New Profile wizard to create a new Virtual Phone configuration.

File > Open Phone Config

Select to open the Open dialog box, shown in Figure 3.2, to select an existing Virtual Phone configuration file.

Figure 3.2  Open dialog box for Virtual Phone configuration (VPC) files

File > Save Phone Config

Select to save the current Virtual Phone configuration file.

File > Save Phone Config As

Select to open the Save VP State dialog box, shown in Figure 3.3, to save the current Virtual Phone configuration file with a filename that you specify.

Figure 3.3  Save VP State dialog box

File > Exit

Select to exit Virtual Phone.

Connection Menu ^TOP^

Select Connection to connect or disconnect Virtual Phone.

View Menu ^TOP^

Select View to open or arrange the secondary Virtual Phone windows.

View > AT Log

Select to open the AT Log window, shown in Figure 3.4.

Figure 3.4  AT Log window

  • To save the contents of the AT Log window, click the diskette icon in the toolbar.
  • To add a separator line to the window, click the line icon in the toolbar.
  • To clear the contents of the window, click the delete icon (the red X) in the toolbar.
  • To view the contents of the window in hexadecimal format, click the hex icon (the black H) in the toolbar.

View > Auto Arrange AT Log

Select to position the AT Log window below the Virtual Phone window.

View > Auto Arrange AT+CFG

Select to position the AT Log window to the right of the Virtual Phone window, and the Phone Configuration dialog box below the Virtual Phone window.

View > Auto Arrange CFG+AT

Select to position the AT Log window to below the Virtual Phone window, and the Phone Configuration dialog box to the right of the Virtual Phone window.

Tools Menu ^TOP^

The Tools menu, shown in Figure 3.5, provides access to several services.

Figure 3.5  Virtual Phone Tools Menu

Tools > Phone Configuration

Select to open the Phone Configuration dialog box to set and view the settings for basic services of Virtual Phone. See "Phone Configuration Dialog Box" for more information.

Tools > Services

Select to open the Service Configuration dialog box to set and view the settings for PhoneBook, SMS, and Speech services. See "Service Configuration Dialog Box" for more information.

Tools > Send AT Commands

Select to open a dialog box, shown in Figure 3.6, where you can enter AT unsolicited results that you want to send.

Figure 3.6  Send AT Commands dialog box

Tools > Responses Preferences

Select to define the Virtual Phone services, error numbers, and messages. See "Response Preferences Dialog Box" for more information.

Tools > Options

Select to define the options for Profiles, Phone use, and window settings. See "Options Dialog Box" for more information.

Tools > Profile Setup

Select to change or view current Profile settings. See "Profile Setup Dialog Box" for more information.

Palm OS Virtual Phone Toolbar Items ^TOP^

Virtual Phone's provides additional functions through the toolbar shown in Figure 3.7.

Figure 3.7  Virtual Phone toolbar

AT Button

Toggles the display of the AT Log window.

Clear Button

Clears the contents of the Activity Log

Connection Button

Connects or disconnects Virtual Phone.

Power Button

Turns Virtual Phone on or off, determining whether Virtual Phone can receive AT commands.

CFUN Button

Turns the phone functions on or off (equivalent to processing the AT+CFUN command).

Network Registration Button

Registers the phone to the operator selected (equivalent to processing the AT+COPS=0 command).

Palm OS Virtual Phone Status Bar ^TOP^

The status bar, shown in Figure 3.8, displays information about the current configuration.

  • The communications plug-in link setting
  • The phone plug-in setting
  • The security state (such as Ready, PIN Expected, PUK Expected)

Figure 3.8  Virtual Phone status bar

Phone Configuration Dialog Box ^TOP^

The Phone Configuration dialog box provides access to the phone configuration settings. To open the Phone Configuration dialog box, select Tools > Phone Configuration.

Phonebook Settings
SMS Settings
Data Settings
SIM Settings
GPRS Settings
GPRS PDP Management
Speech Settings
Speech Forwarding
Configuration Settings
Configuration Facilities
Network Settings
Network Notifications
Network Networks
Power Settings
Security Codes
Security Status

Phonebook Settings ^TOP^

Phonebook Settings, shown in Figure 3.9, displays information about the stored phone books, showing the current phonebook and which phonebooks are activated.

Figure 3.9  Phonebook Settings

General

  • Maximum Name Length

    Enter the maximum length of a name associated to a phone number. A maximum of 30 characters is permitted for the name length.

    See TelPhbGetEntryMaxSizes in Exploring Palm OS: Telephony and SMS.

Current Phone Book

The currently selected Phone Book. See TelPhbGetSelectedPhonebook in Exploring Palm OS: Telephony and SMS.

Activated Phone Books

Check to indicate that the phone book is present.

For all of the above see TelPhbGetAvailablePhonebooks in Exploring Palm OS: Telephony and SMS.

SMS Settings ^TOP^

SMS Settings, shown in Figure 3.10, displays information about the SMS features.

Figure 3.10  SMS Settings

The values entered and displayed here are stored in the SMS (Short Message Services) files, SmsStore.db and SmsStoreSend.db.

General setting

  • Call Center

    Enter the phone's service center. See TelCfgSetSmsCenter in Exploring Palm OS: Telephony and SMS.

  • Max SMS Index

    Enter the maximum number of messages to display and store (maximum 500). See TelSmsGetMessageCount in Exploring Palm OS: Telephony and SMS.

MO SMS Service

  • 0 - GPRS
  • 1 - Circuit Switched
  • 2 - GPRS Preferred
  • 3 - Circuit switch preferred

New Message indication

Select the mode for new messages:

  • 0 - Always buffer unsolicited result codes
  • 1 - Discard unsolicited results when link is reserved
  • 2 - Buffer unsolicited results when link is reserved

Indication mode according to SMS type

  • SMS Deliver

    Select the SMS Deliver setting:

    • 0 - No indications are routed
    • 1 - Memory location is routed
    • 2 - PDU is routed
  • SMS Status Report

    Select the SMS Status Report setting:

    • 0 - No indications are routed
    • 1 - Memory location is routed
    • 2 - PDU is routed

Data Settings ^TOP^

Data Settings, shown in Figure 3.11, displays information about the server, server port, communication protocol.

Figure 3.11  Data Settings

Server

These settings are used for data connections (GSM/GPRS). The server specified should be a valid TCP server.

  • Server

    Enter the name of the server.

  • Port

    Enter the port for the server.

  • Protocol

    Select the communication protocol for the server.

SIM Settings ^TOP^

SIM Settings, shown in Figure 3.12, displays SIM properties for the phone you are emulating.

Figure 3.12  SIM Settings

International Mobile Subscriber Identity

  • IMSI - International Subscriber Identity

    Enter the international mobile subscriber identity number corresponding to the SIM card.

Voice Mail Number

  • Number

    Enter the voice mail number for the SIM card.

  • Name

    Enter the voice mail name for the SIM card.

SIM Card

  • Status

    Sim Inserted: Select this setting to indicate whether the SIM card is in use for the emulation.

GPRS Settings ^TOP^

GPRS Settings, shown in Figure 3.13, displays GPRS properties for the phone you are emulating.

Figure 3.13  GPRS Settings

GPRS Network registration

  • State

    Specify the network registration state for the Mobile Equipment (ME).

    • 0 - Not Registered, ME Not Searching.

    • 1 - Registered

      Select this value if the highlighted network is registered to a provider (RegStat=1).

    • 2 - Not Registered, ME Not searching

      Select this value if the network is not registered (RegStat=2).

    • 3 - Registration Denied

      Select this value to simulate a denied registration (RegStat=3).

    • 4 - Unknown

      Select this value if the network is not recognized by Virtual Phone (RegStat=4).

    • 5 - Registered, Roaming

      Select this value if the network is registered as roaming (RegStat=5).

See TelNwkGetNetworkName in Exploring Palm OS: Telephony and SMS.

  • Attach to GPRS Network

    Select to indicate whether the phone is attached to the GPRS network.

Location

  • Cell Id
  • Enter the value of the current cell. This value is a two-byte cell ID in hexadecimal format. See TelNwkGetLocation in Exploring Palm OS: Telephony and SMS.
  • Area Code
  • Enter the value of the cell's area code. This value is a two-byte location area code in hexadecimal format. See TelNwkGetLocation in Exploring Palm OS: Telephony and SMS.

Network Registration Notification

  • Mode
  • Set the network registration notification state.
    • 0 - None

      Select this value to disable the network registration unsolicited results code.

    • 1 - Network Reg.

      Select this value to enable the network registration unsolicited results code.

    • 2 - Network Reg. & Location Info

      Select this value to enable the network registration and location information unsolicited results code.

  • Send Notif

    Click to send a network registration notification. Note that if you modify the Cell ID or Area Code information, you should click Apply before clicking Send Notif.

GPRS Event Reporting

  • Mode

    Select the buffering mode for event reporting.

    • 0 - Buffered
    • 1 - Discard when On Line
    • 2 - Buffer when On Line
  • Bfr

    Select the buffer behavior.

    • 0 - Clear
    • 1 - Flush

GPRS PDP Management ^TOP^

The Phone Configuration dialog box provides one settings page for overall settings, and an additional page for each APN specified.

Figure 3.14  PDP Management

PDP Context Management

The table lists the APN definitions for this Virtual Phone session.

The PDP parameters available depend on the selected PDP type.

Actions

  • Activate
  • Deactivate
  • Add
  • Remove

Unsolicited Result Codes

  • Reject
  • ME Deact
  • ME Detach
  • NW React
  • NW Deact
  • NW Detach

Class

  • Selection
  • NW Class
  • ME Class

Event Buffer

  • Flush Result

Figure 3.15  MyAPN

Each APN defined has a page for defining packet data protocol parameters.

Packet Data Protocol Parameters

  • Context Identifier
  • Type
  • APN
  • Address

Type Parameters

Compression

  • Header
  • Data

Required Quality

  • Precedence
  • Delay
  • Reliability
  • Peak
  • Mean

Minimum Quality

  • Precedence
  • Delay
  • Reliability
  • Peak
  • Mean

Speech Settings ^TOP^

Speech Settings, shown in Figure 3.16, displays properties for speech calls.

Figure 3.16  Speech Settings

Connected Line ID present

  • TA

    Check to show the result code presentation status in the Terminal Adapter (TA) phone book.

  • Nwk

    Check to show the subscriber connected line identification presentation service status in the network phone book.

Calling Line ID Present

  • TA

    Check to show the result code presentation status in the Terminal Adapter (TA) phone book.

  • Nwk

    Check to show the subscriber connected line identification presentation service status in the network phone book.

Calling Line ID Restriction

  • Subscription

    Set according to the subscription of the calling line identification restriction service.

  • On Network

    Set to the subscriber calling line identification restriction service status in the network.

Supplementary Service Notifications

  • +CSSI

    Select to indicate whether +CSSI notifications are supported.

  • +CSSU

    Select to indicate whether +CSSU notifications are supported.

Speech Forwarding ^TOP^

Speech Forwarding, shown in Figure 3.17, displays information about call forwarding settings.

Figure 3.17  Speech Forwarding

Call Forwarding

  • Reason

    Select the reason for call forwarding:

    • Unconditional

      Select this option to forward always.

    • Busy

      Select this option to forward when the line is busy.

    • No Reply

      Select this option to forward when there is no reply.

    • Not Reachable

      Select this option to forward when the line is not reachable.

  • Class

    Select the call type that you want forwarded:

    • Voice

      Select this option to forward incoming voice calls.

    • Data

      Select this option to forward incoming data calls.

    • Fax

      Select this option to forward incoming fax calls.

    • Sms

      Select this option to forward incoming SMS messages.

    • Data Circuit Sync

      Select this option to forward incoming synchronous data service calls.

    • Data Circuit Async

      Select this option to forward incoming asynchronous data service calls.

    • Dedicated Packet Access

      Select this option to forward incoming dedicated packet access service calls.

    • Dedicated PAD Access

      Select this option to forward incoming dedicated PAD access service calls.

  • Status: Active

    Check to indicate that call forwarding is active.

  • Number

    Enter the phone number of the forwarding address.

  • SubAddr

    Enter the call forwarding subaddress.

  • Time

    Enter the time in seconds to wait before call is forwarded. Note that this setting applies only when Call forwarding by class is set to No Reply.

Configuration Settings ^TOP^

The Configuration Settings, shown in Figure 3.18, provides access to basic Virtual Phone configuration parameters.

See the Information, Power, and Configuration Services in Exploring Palm OS: Telephony and SMS for further details.

Figure 3.18  Configuration Settings

Phone Settings

Enter the information for the phone you want to emulate.

  • Brand

    Enter any name (limited to 30 alphanumeric characters). Use the function TelInfGetInformation to access this information. See the TelInfGetInformation function in Exploring Palm OS: Telephony and SMS.

  • Model

    Enter any model number (limited to 30 alphanumeric characters). Use the function TelInfGetInformation to access this information. See the TelInfGetInformation function in Exploring Palm OS: Telephony and SMS.

  • Revision

    Enter the revision number (limited to 30 alphanumeric characters). Use the function TelInfGetInformation to access this information. See the TelInfGetInformation function in Exploring Palm OS: Telephony and SMS.

  • Number

    Enter the Phone Number (limited to 30 alphanumeric characters) of the "virtual" mobile phone. See the TelCgfGetPhoneNumber function in Exploring Palm OS: Telephony and SMS.

  • Serial Number

    Enter the serial number of the phone you are emulating.

Network Settings

  • Emc Number

    Enter the emergency call number.

Configuration Facilities ^TOP^

Configuration Facilities, shown in Figure 3.19, displays information about the current emulation session.

Figure 3.19  Configuration Facilities

Facilities

  • Select the facility from the list:
    • AI-Bar All Incoming Calls
    • AO-Bar All Outgoing calls
    • FD-SIM fixed dialing memory feature
    • IR-Bar incoming calls when roaming outside the home country
    • OI-Bar Outgoing International calls
    • OX-Bar Outgoing international calls eXcept to home country
    • PF-Lock phone to the first inserted SIM card
    • PS-Lock phone to SIM card
    • SC-SIM asks for password in ME power-up
  • Mode
  • Select this value to indicate whether the facility lock is active.
  • Passwd
  • Enter the facility lock password.
  • Class
  • Select the class of information. Call barring facilities are based on GSM supplementary services (refer GSM 02.88 [6]). The interaction of these with other commands is based on other GSM supplementary services as described in the GSM standard. See the selection descriptions in the Call forwarding by class section.

Network Settings ^TOP^

Network Settings, shown in Figure 3.20, displays properties that simulate network-oriented services, including authorized networks, forbidden networks, current network, signal strength, and search mode.

Figure 3.20  Network Settings

Set the parameters for the network you are emulating.

Signal Strength

Set the signal level you want to test.

  • Entry field

    Enter a numeric value between 0 and 31, with 0 being no signal and 31 being the maximum signal strength. See TelNwkGetSignalLevel in Exploring Palm OS: Telephony and SMS.

  • Not detectable

    If checked, Virtual Phone will issue a 99 for Signal Strength. As specified in the GSM Technical Specification. See TelNwkGetSignalLevel in Exploring Palm OS: Telephony and SMS.

Search Mode

Select how you want Virtual Phone to select a network.

  • Manual

    Select this value if you want Virtual Phone to manually select a network

  • Auto

    Select this value if you want Virtual Phone to automatically select a network.

See TelNwkGetSearchMode in Exploring Palm OS: Telephony and SMS. See kTelNwkManualSearch in Exploring Palm OS: Telephony and SMS.

Network name presentation

Select how you want the network name presented:

  • 0-Long Name
  • 1-Short Name
  • 2-Numeric Name

Network Notifications ^TOP^

Network Notifications, shown in Figure 3.21, displays information about the network location and registration notifications.

Figure 3.21  Network Notifications

Location

Set the location information for the current cell and its area code.

  • Cell Id

    Enter the value of the current Cell. This value is a two-byte cell ID in hexadecimal format. See TelNwkGetLocation in Exploring Palm OS: Telephony and SMS.

  • Area Code

    Enter the value of the Cell's area code. This value is a two-byte location area code in hexadecimal format. See TelNwkGetLocation in Exploring Palm OS: Telephony and SMS.

Network Registration Notification State

Set the network registration notification state.

  • 0 - None

    Select this value to disable the network registration unsolicited results code.

  • 1 - Network Reg.

    Select this value to enable the network registration unsolicited results code.

  • 2 - Network Reg. & Location Info

    Select this value to enable the network registration and location information unsolicited results code.

  • Send Notif button

    Click to send a network registration notification. Note that if you modify the Cell ID or Area Code information, you should click Apply before clicking Send Notif.

Network Networks ^TOP^

Network Networks, shown in Figure 3.22, displays information about the networks used for this Virtual Phone session.

Figure 3.22  Network Networks

See the Telephony Network section in Exploring Palm OS: Telephony and SMS for further details.

Networks

Specify the networks for your phone.

  • Current List

    Select a list of network from either the Available Networks list or the Preferred Networks list. Select Modify List to display the Network List Management dialog box.

    A network is defined by its SimId, Id, Short Name and Name. Virtual Phone stores these values in the AvailableNwk.db file. See AvailableNwk.db file, in the NWK section, variable name Num. See TelNwkGetNetworks in Exploring Palm OS: Telephony and SMS.

    • SimId

      The order number of the operator in the SIM available/preferred operator list.

    • Id

      This is a hexadecimal value five digits long. The first three digits represent the country code; the next two digits represent the network name. The normal numeric format is the GSM Location Area Identification number, which consists of a three-digit (BCD) country code plus a two-digit (BCD) network code.

      See the AvailableNwk.db or PreferredNwk.db file, in the NWK section, variable name Id. See TelNwkGetNetworks in Exploring Palm OS: Telephony and SMS.

    • Short Name

      An abbreviation of the Name with a maximum 8 alphanumeric characters. See the AvailableNwk.db or PreferredNwk.db file, in the NWK section, variable name Sname.

    • Name

      The normal maximum value for name is 16 alphanumeric characters. Some operators restrict this value to 6 or 8 characters, while some networks allow more than 16 characters for the long name. See the AvailableNwk.db or PreferredNwk.db file, in the NWK section, variable name Lname. See TelNwkGetNetworks in Exploring Palm OS: Telephony and SMS.

      See TelNwkGetNetworks in Exploring Palm OS: Telephony and SMS.

  • State

    Select the state of the network that is selected in the table. There are four options:

    • Unknown

      Select this value if the network unknown (Stat=0).

    • Available

      Select this value if the selected network is available (Stat=1).

    • Current

      Select this value if the highlighted network is currently selected (Stat=2).

    • Forbidden

      Select this value if the network is unavailable for security reasons (Stat=3).

      See the AvailableNwk.db or PreferredNwk.db file, in the NWK section, variable name Stat. See TelNwkSelectNetwork in the Telephony Manager chapter in Exploring Palm OS: Telephony and SMS.

  • ME Reg State

    Select the ME (Mobile Equipment, that is the GSM phone) network registration status.

    • 1 - Registered

      Select this value if the highlighted network is registered to a provider (RegStat=1).

    • 2 - Not Registered, ME Not searching

      Select this value if the network is not registered (RegStat=2).

    • 3 - Registration Denied

      Select this value if the network is secured and registration is rejected (RegStat=3).

    • 4 - Unknown

      Select this value if the network is not recognized by Virtual Phone (RegStat=4).

    • 5 - Registered, Roaming

      Select this value if the network is registered as roaming (RegStat=5).

      See TelNwkGetNetworkName in Exploring Palm OS: Telephony and SMS.

Power Settings ^TOP^

Use Power Settings, shown in Figure 3.23, to enter the power information for the phone you are emulating.

Figure 3.23  Power Settings

Power management

  • Phone Functionality Value

    Enter a number indicating the phone functionality status as defined in ETSI standard (see AT+CFUN command).

  • Battery state

    Enter the battery conditions you are testing.

    • Powered

      Select to indicate that the battery is present and that the Battery Level setting should be taken into consideration.

    • Not Powered

      Select to indicate that the battery is present but its power level is zero.

    • No Battery

      Select to indicate that no battery is present.

    • Battery Fault

      Select to simulate a battery fault condition.

      See TelPowGetBatteryStatus in Exploring Palm OS: Telephony and SMS.

  • Battery level

    Select the battery range from 0% (for no power) to 100% (for full power). See TelPowGetPowerLevel in Exploring Palm OS: Telephony and SMS.

Security Codes ^TOP^

Security Codes, shown in Figure 3.24, displays information about security settings used for this emulation session.

Figure 3.24  Security Codes

You can change the values of these codes using Telephony Manager functions or directly in this dialog box. To change an authentication code, see TelStyChangeAuthenticationCode in Exploring Palm OS: Telephony and SMS.

PIN 1

  • Value

    Enter the primary Personal Identification Number (PIN), between 4-digits and 8-digits long. See TelStyEnterAuthenticationCode in Exploring Palm OS: Telephony and SMS.

  • Num tries

    Enter the number of times that a user can attempt to enter the PIN 1 value.

PIN 2

  • Value

    Enter the secondary Personal Identification Number between, 4-digits and 8-digits long. See TelStyEnterAuthenticationCode in Exploring Palm OS: Telephony and SMS.

  • Num tries

    Enter the number of times that a user can attempt to enter the PIN 2 value.

PUK 1

  • Value

    Enter the primary Personal Universal Key (PUK). This value is a mandatory 8-digits long. See TelStyEnterAuthenticationCode in Exploring Palm OS: Telephony and SMS.

  • Num tries

    Enter the number of times that a user can attempt to enter the PUK 1 value.

PUK 2

  • Value

    Enter the secondary Personal Universal Key (PUK). This value is a mandatory 8-digits long. See TelStyEnterAuthenticationCode in Exploring Palm OS: Telephony and SMS.

  • Num tries

    Enter the number of times that a user can attempt to enter the PUK 2 value.

Reset State

Click to reset the security values to the default state.

Security Status ^TOP^

Use Security Status to set the security for this Virtual Phone session.

Figure 3.25  Security Status

Actual Security Status

Enter the security state of the phone. See TelStyGetAuthenticationState in Exploring Palm OS: Telephony and SMS.

  • Ready

    Select this value if Virtual Phone is ready to receive AT commands. State=0.

    In this state, Virtual Phone answers "Ready" to any +CPIN? command, and does not apply PIN Security before answering other AT commands.

    See kTelStyReady in Exploring Palm OS: Telephony and SMS.

  • PIN1 expected

    Select this value to indicate that Virtual Phone should expect a primary Personal Identification Number (PIN). State=1. See kTelStyPin1CodeId in Exploring Palm OS: Telephony and SMS.

  • PUK1 expected

    Select this value to indicate that Virtual Phone should expect the primary Personal Universal Key (PUK). State=3. See kTelStyPuk1CodeId in Exploring Palm OS: Telephony and SMS.

  • Phone to SIM expected

    Select this value to indicate that Virtual Phone should expect the Phone to Subscriber Identification Module (SIM) code. State=5. See kTelStyPhoneToSimCodeId in Exploring Palm OS: Telephony and SMS.

  • Phone to First SIM expected

    Select this value to indicate that Virtual Phone should expect the Phone to First SIM Key (PH-FSIM PIN).

  • PIN2 expected

    Select this value to indicate that Virtual Phone should expect a secondary Personal Identification Number (PIN). State=2. See kTelStyPin2CodeId in Exploring Palm OS: Telephony and SMS.

  • PUK2 expected

    Select this value to indicate that Virtual Phone should expect the secondary Personal Universal Key (PUK). State=4. See kTelStyPuk2CodeId in Exploring Palm OS: Telephony and SMS.

Lock SIM Card

Check to activate PIN1 security.

Service Configuration Dialog Box ^TOP^

To open the Service Configuration dialog box, select Tools > Services. The Service Configuration dialog box displays settings for PhoneBook, SMS, and Speech.

PhoneBook
SMS PDU Viewer
SMS PDU Manager
SMS Storage - Received
SMS Storage - Sent
Speech New Call
Speech Manage Calls

PhoneBook ^TOP^

The PhoneBook page, shown in Figure 3.26, displays information about each of the active phonebooks.

Figure 3.26  PhoneBook

See TelPhbGetAvailablePhonebooks in Exploring Palm OS: Telephony and SMS for information on phone books.

  • Write Protected

    Check to indicate that the phone book is write protected.

  • Total Entries

    Enter the maximum number of entries allowed in the phone book.

  • Total Used

    Enter the number of entries used in the phonebook.

  • Add button

    To manually add an entry in the phone book, click Add. This generates an index entry for the item, and you can click on the fields in the table to add data.

  • Remove button

    To remove an entry, select the entry and click Remove.

  • Remove All button

    To remove all entries in the phone book, click Remove All.

  • Populate button

    To add random data to the phone book, click Populate.

SMS PDU Viewer ^TOP^

Use PDU Viewer, shown in Figure 3.27, to create a new SMS delivery message, which is an SMS message received by Virtual Phone from the GSM network. The message is stored in the first available location in the SmsStore.db file.

Figure 3.27  PDU Viewer

PDU Viewer

  • PDU

    Enter the PDU (Protocol Data Unit) for this message.

Action

  • Direction

    Select whether this is an incoming message or an outgoing message.

    • Incoming SMS (SC to MS) - Select if this is an incoming message.
    • Outgoing SMS (MS to SC) - Select if this is an outgoing message.
  • Decode

    Click to decode this message.

SMS PDU Manager ^TOP^

Use the PDU Manager page to set options for the SMS Center.

Figure 3.28  PDU Manager

SMS Center

  • Configured in MS

    Check to indicate that the SMS Center is configured in the MS (Mobile Station).

  • Address

    Enter the address of the SMS Center. This option is available when the SMS Center is configured in MS checkbox is not selected.

  • TON

    Select the "Type of Numbering (TON)" phone number format:

    • Unknown - Address octet 129 ISDN
    • International - Address octet 145 ISDN
    • National - Address octet 161 ISDN
  • Message Parameters

    Enter the other message data in the scrollable table.

  • Create PDU button

    Click to create a PDU.

  • Reset

    Click to reset the data to the default data.

  • Receive PDU button

    Click to receive a PDU.

With the default Virtual Phone configuration, you can create a standard SMS message by clicking Receive PDU. Virtual Phone creates a Class 1 SMS text message with the text "Hello world!"

To create a multiple-part SMS message, simply add enough characters to the message.

SMS Storage - Received ^TOP^

The Storage - Received page keeps a record of SMS messages you have received.

Figure 3.29  Storage - Received

Messages

  • Id

    The identification number of the message.

  • Type

    The message type.

  • Multi Part

    Indicates whether the SMS is composed of several parts. For a single-part message, the field says None. For a multiple-part message, the field contains a relative number indicating the part displayed, such as 1/3 for the first part of a three-part message.

  • Status

    Indicates the status of the message: received unread, received read, stored unsent, or stored sent.

  • Message Text

    Content of the SMS message.

  • Refresh button

    Click to refresh the messages table.

  • Delete button

    Click to delete a selected message. To select a message, either use Ctrl+A or else Ctrl-click the message.

SMS Storage - Sent ^TOP^

The Storage - Sent page keeps a record of SMS messages you have sent.

Figure 3.30  Storage - Sent

Messages

  • Id

    The identification number of the message.

  • Multi Part

    The SMS is composed of several parts.

  • Status

    Indicates the status of the message: received unread, received read, stored unsent, or stored sent.

  • Report Status

    The SMS contains a status report request.

  • Message Text

    Content of the SMS message.

  • Refresh List button

    Click to refresh the messages table.

  • Send Report button

    Click to send an SMS status report for the selected SMS message (if applicable).

  • Delete button

    Click to delete a selected message. To select a message, either use Ctrl+A or else Ctrl-click the message.

Speech New Call ^TOP^

Use the New Call page to create a new call.

Figure 3.31  New Call

New Incoming Call

  • Name

    Enter the name for the incoming call.

  • Number

    Enter the phone number for the incoming call.

  • Forwarded

    Check if you want this call treated as a forwarded incoming call.

  • Start

    Click to make the call you have created.

Speech Manage Calls ^TOP^

The Manage Calls page allows you to change the state of calls that you have placed or received.

Figure 3.32  Manage Calls

Response Preferences Dialog Box ^TOP^

To open the Response Preferences dialog box, select Tools > Response Preferences. Use this screen to select an error which will systematically be returned by a service.

Figure 3.33  Response Preferences Dialog Box

The following list associates a Virtual Phone service to a Telephony Manager function as supported by a standard GSM phone driver.

Table 3.1  Virtual Phone Services and Telephony Manager Functions 

Services

Associated Functions

Accept Call

TelSpcAcceptCall

Add Entry

TelPhbAddEntry

Auto Operator Select

TelNwkSetSearchMode

Call Number

TelSpcCallNumber

Change Authentication Code

TelStyChangeAuthenticationCode

Close Line and Reject Call

TelSpcCloseLine or TelSpcRejectCall

Delete Entry

TelPhbDeleteEntry

Delete Message

TelSmsDeleteMessage

Enter Authentication Code

TelStyEnterAuthentication

Get Authentication State

TelStyGetAuthenticationState

Get Available Storage

TelSmsGetAvailableStorage

Get Available Phone Books

TelPhbGetAvailablePhonebook

Get Battery State

TelPowGetBatteryStatus

Get Brand Number

TelInfGetInformation

Get Call State

TelGetCallState

Get Entries

TelPhbGetEntries

Get Entry Max Sizes

TelPhbGetEntryMaxSizes

Get Location

TelNwkGetLocation

Get Model Number

TelInfGetInformation

Get Networks

TelNwkGetNetworks

Get Phone Number

TelCgfGetPhoneNumber

Get Revision

TelInfGetInformation

Get Selected Phone Book

TelPhbGetSelectedPhonebook

Get Selected Network

TelNwkGetSelectedNetwork

Get Selected Storage

TelSmsGetSelectedStorage

Get Signal Level

TelNwkGetSignalLevel

Get Sms Center

TelCgfGetSmsCenter

Hold Line

TelSpcHoldLine

Mute

TelSndMute

Operator Select

TelNwkSelectNetwork

Read Message

TelSmsReadMessage

Read Messages

TelSmsReadMessages

Select Phone Book

TelPhbSelectPhonebook

Select Storage

TelSmsSelectStorage

Send Burst DTMF

TelSpcSendBurstDTMF

Send Short Message

TelSmsSendMessage

Set Sms Center

TelCgfSetSmsCenter

Response Configuration

  • According to Phone's State

    Select this option to return a value according to the current state of Virtual Phone.

  • Reply with Error

    Use this option to return the selected error message.

Table 3.2  GSM Errors 

GSM Error Number

Error

Telephony Constant

0

Phone failure

telErrCommandFailed

1

No connection to phone

telErrPhoneComm

2

Phone-adapter link reserved

telErrPhoneComm

3

Operation not allowed

telErrCommandFailed

4

Operation not supported

telErrFeatureNotSupported

5

PH-SIM PIN required

telErrPhoneToSIMPINRequired

10

SIM not inserted

telErrNoSIMInserted

11

SIM PIN required

telErrPINRequired

12

SIM PUK required

telErrPUKRequired

13

SIM failure

telErrSIMFailure

14

SIM busy

telErrSIMBusy

15

SIM wrong

telErrSIMWrong

16

Incorrect password

telErrPassword

17

SIM PIN2 required

telErrPIN2Required

18

SIM PUK2 required

telErrPUK2Required

20

Memory full

telErrPhoneMemAllocation

21

Invalid index

telErrInvalidIndex

22

Not found

telErrEntryNotFound

23

Memory failure

telErrPhoneMemFailure

24

Text string too long

telErrInvalidString

25

Invalid characters in text string

telErrInvalidString

26

Dial string too long

telErrInvalidDial

27

Invalid characters in dial string

telErrInvalidDial

30

No network service

telerrNonetwork

31

Network time-out

telErrNetworkTimeOut

100

Unknown

telErrUnknown

Error

The command is not supported.

No response

The phone received no response; equivalent to a telErrTimeOut

Options Dialog Box ^TOP^

Use the Options dialog box to set general options for Virtual Phone. To open the Options dialog box, select Tools > Options.

Profiles Options
Phone Options
Dialog Options

Profiles Options ^TOP^

Use the Profiles page to set options for when you start and exit Virtual Phone.

Figure 3.34  Options - Profiles

Phone Options ^TOP^

Use the Phone page to set options for general phone simulation.

Figure 3.35  Options - Phone

Dialog Options ^TOP^

Use the Dialog page to set options for how Virtual Phone windows are handled at start-up.

Figure 3.36  Options - Dialog

Profile Setup Dialog Box ^TOP^

The Profile Setup allows you to change the settings that get written to the Virtual Phone configuration file (VPC) when you run the New Profile wizard (described in "Creating a Virtual Phone Profile"). To open the Profile Setup dialog box, select Tools > Profile Setup.

Figure 3.37  Profile Setup Dialog box