Share via

Cellular Emulator User Interface

  • Article

4/8/2010

The Cellular Emulator UI contains several tabs. The section will cover all the tabs and their functionality.

Status Bar

The status bar includes some global configuration information of Cellular Emulator.

The left panel shows the virtual serial port, which the user should map to Device Emulator serial port 0.

Bb158487.0fb998b6-4676-4062-a03c-a034799ec309(en-us,MSDN.10).gif

The center panel indicates the network type Cellular Emulator is simulating. The value can be 2G or 3G.

The right panel shows the GPRS status of the currently emulated network. If one ore more data channels are created between the Device Emulator and Cellular Emulator then the status will display "Connected", otherwise it will display "Disconnected".

Call Manager

The Call Manager tab is used to show and control voice calls. Since this is a simulated environment, some restraints in real world are not applied. For example:

  • Several incoming calls can be made to Windows Mobile image.
  • There is no max count of concurrent calls.

Bb158487.95890a4e-b6cc-4bfa-b822-3bd37e151aa3(en-us,MSDN.10).gif

Active Calls Panel. All active voice calls are displayed in the list box.

Components of the Active Calls Panel:

ID. The ID of this voice call.

Number. The number of the remote party of a voice call.

Status. Current connection status of a voice call. Can be:

  • Active: The call is connected.
  • Held: The call is on hold.
  • Dialing: An outgoing call that is trying to connect to the remote party.
  • Alerting: The remote party is ringing.
  • Incoming: An incoming call that has not been answered.

Direction. The direction of a voice call.

  • MT: Windows Mobile Terminated (for example, a call from the wireless network to the mobile device)
  • MO: Windows Mobile Oriented (for example, a call from the mobile device to the wireless network)

Drop Call button. Users can simulate a remote hang up by selecting a call in the active call list and click the Drop Call button.

Dial button. Users can simulate an incoming voice call by inputting a valid phone number in the ‘Phone Number’ edit box and click the Dial button.

Dial-Up Server Numbers. Number types:

  • Busy: All voice calls from Windows Mobile that dial to this number will receive a busy result.
  • Reject: All voice calls from Windows Mobile that dial to this number will get rejected.
  • Hang Up After Connect: All voice calls from Windows Mobile that dial to this number will be answered and then disconnected.
  • No Answer: All voice calls from Windows Mobile that dial to this number will keep ringing
  • For numbers not listed, the voice call will be automatically answered.

Network

The Network Selection and GPRS Control panels in the Network tab are useful for simulating some network handover events.

Bb158487.5ea3d8e9-a347-46d8-a5ec-68bcab0001c3(en-us,MSDN.10).gif

  • Switch to 2G. The button will send an event indicating that the radio is registered to a GSM cell which supports GPRS. The status bar will display “Network: 2G”, which indicates current network is configured to 2G.
  • Switch to 3G. The button will send an event indicating that the radio is registered to a UMTS cell. The status bar will display “Network: 3G”, which indicates current network is configured to 3G.
  • Disconnect GPRS. The button will disconnect current GPRS connection if there is one.

The Data Channels panel will list five PPP connections. Once a CSD or GPRS connection is established with Windows Mobile, the detailed information will be shown here. The Active Time is in seconds.

  • Received Data(B): Cellular Emulator receives data in bytes from Windows Mobile
  • Sent Data(B): Cellular Emulator sends data in bytes to Windows Mobile.

SMS

In the Send to device panel, users can use Cellular Emulator UI to simulate an incoming SMS. The context of the SMS can be input and then clicking the Send button would send the message to the Windows Mobile image. Users can also name the interval and repeat count to send multiple messages to a Windows Mobile image.

Bb158487.1a045efc-93c4-446b-88a4-e1a851ed2281(en-us,MSDN.10).gif

Injection

The Injection panel is used to inject an AT command to Cellular Emulator or inject an AT Response or AT Event to Windows Mobile.

Note

As much as possible, the Cellular Emulator implements the AT commands according to 3GPP standards.

Users can input an AT command in the AT Input edit box and click Execute. The result will be shown in the Result and Event edit boxes. The AT commands input here will update the internal status of Cellular Emulator but the responses and events will not be sent to Windows Mobile applications.

To send a predefined AT event, use the drop down list to select one and click Send.

To send a customized AT event, do not specify a predefined event and type a custom event string in the Event text box. Please check the Append <cr><lf>? checkbox when needed.

Bb158487.b98eeaf8-c206-4cab-8edd-3f627728a0fb(en-us,MSDN.10).gif

Configuration

The Configuration panel is used to manage the SIM file and the filters currently in use. For more information, see Cellular Emulator Configuration.

AT log

This window contains all the AT commands history between Cellular Emulator and Windows Mobile applications.

Bb158487.dab6cdb0-aced-4b06-9b4a-788a76b6e3b1(en-us,MSDN.10).gif

If a line begins with the character “>>”, this is a string sent from Windows Mobile to Cellular Emulator. If the line begins with the character “<<”, this is a string sent back from Cellular Emulator.

Time is displayed in this format:

[Day]::[Hour]:[Minute]:[Second]

The “dwLen=” parameter indicates the total number of character this line contains.

“<CR>” and “<LF>” indicate carriage return and line feed, respectively.

See Also

Concepts

Security, GPS and Resolution Awareness Tools

Other Resources

Cellular Emulator