Before using Palm OS® Virtual Phone, you need to create a profile for your Virtual Phone session. Then you need to configure Palm OS Cobalt Simulator to work with Virtual Phone. This chapter describes how to get started.
Creating a Virtual Phone Profile
Configuring Palm OS Cobalt Simulator
Configuring the Phone Preferences
Creating a Virtual Phone Profile
When you run Virtual Phone the first time, Virtual Phone starts by opening the New Profile wizard. The Virtual Phone profile defines the Phone plug-in and the Communication plug-in that are used for this Virtual Phone session.
The first page of the New Profile wizard is the Phone Plugin Selection page, shown in Figure 2.1.
Figure 2.1 Phone Plugin Selection page

This page lets you select a phone plug-in from the list of available plug-ins. Virtual Phone comes with two options (ChiMei and StandardGSM), but licensees can create additional phone plug-ins as well.
For now, select the StandardGSM phone plug-in, and click Next.
The next page of the wizard is the Com Plugin Selection page, shown in Figure 2.2.
Figure 2.2 Com Plugin Selection page

This page lets you choose a Low Link communication option of either Serial and TCP v4.
For now, select the TCP v4 for the Low Link communication plug-in, and select None for the High Link communication plug-in, and click Next.
The next page of the wizard is the TCP Configuration page, shown in Figure 2.3.
Figure 2.3 TCP Configuration page

This page lets you specify the TCP communication port for communication between Virtual Phone and Palm OS Cobalt Simulator. Both tools use the default port setting of 6416
, so accept this value and click Finish.
Next, you need to configure Palm OS Cobalt Simulator to communicate with Virtual Phone.
Configuring Palm OS Cobalt Simulator
Palm OS Cobalt Simulator is a tool that you can use to test Palm OS applications. Simulator includes all of the Palm OS Cobalt system code, compiled to run on Windows.
The Simulator main window looks like the display that runs on a Palm Powered™ device. However, as a Windows-based application, Simulator supports many standard Windows-based user interaction techniques. You can use your mouse to perform actions that you perform with the stylus on handheld devices, and you can use menus to access Simulator functions.
In order to configure Simulator to work with Virtual Phone, right-click the Simulator window to display the pop-up menu. Then select Settings > Communication Ports, as shown in Figure 2.4.
Figure 2.4 Configuring Palm OS Cobalt Simulator

When you select Settings > Communication Ports, the Communication Ports dialog box opens, as shown in Figure 2.5.
Figure 2.5 Palm OS Cobalt Simulator Communication Ports dialog box

Use the Communication Ports dialog box to configure Palm OS Simulator's communication parameters. These parameters must correspond to Virtual Phone's parameters in order to establish communication between the two applications (see "Tools Menu" and "Profile Setup Dialog Box" for more information).
In the previous section, you defined the Virtual Phone communication plug-in to use TCP/IP as the Transport and localhost:6416
as the "Bound to" port. This is Palm OS Cobalt Simulator's default for this communication port.
Configuring the Phone Preferences
To verify that the Palm OS Simulator is configured to communicate with a GSM Phone, first open Palm OS Virtual Phone and click the On button (
) in Virtual Phone's toolbar.
Next, in Palm OS Cobalt Simulator, tap the Prefs application, shown in Figure 2.6.
Figure 2.6 Tap the Prefs application

The Preferences application opens. In the Preferences application, tap Phone Setup, as shown in Figure 2.7
Figure 2.7 Select Phone Setup in the Preference application

The Phone Setup application opens, as shown in Figure 2.8.
Figure 2.8 Phone Setup application

Select Test: Std GSM on Virtual Phone to connect Palm OS Cobalt Simulator with Virtual Phone. Tap Test to test the connection.
You should see a Test Results dialog similar to the one shown in Figure 2.9.
Figure 2.9 Phone connection Test Result dialog

Fixing Connection Problems
Virtual Phone may not be able to establish a connection for several reasons. For example, the specified communications port may already be in use.
If a connection cannot be established, Virtual Phone displays a message dialog box.
You can then either close the application that is preventing the connection and click the reconnect icon, or you can use the Connection > Connect menu. As an alternative, you can go back to the Connection Setup dialog box and change the connection settings.