Development Guide

Local Navigation

Configuring the BlackBerry Smartphone Simulator

Settings for the BlackBerry® Smartphone Simulator are associated with a launch configuration. Each launch configuration is associated with a set of projects and a specific version of the BlackBerry® Device Software.

Specify configuration settings for the BlackBerry Smartphone Simulator

  1. In Eclipse®, on the Run menu, click Debug Configurations or Run Configurations.
  2. Expand the BlackBerry Simulator item.
  3. Perform one of the following tasks:
    • To work with an existing launch configuration, under BlackBerry Simulator, click a launch configuration.
    • To work with a new launch configuration, right-click BlackBerry Simulator, and click New.
  4. Click the Simulator tab.
  5. Click the General tab.
Back To Top

Configuration settings for the BlackBerry Smartphone Simulator

Option

Description

Launch Mobile Data System Connection Service (MDS-CS) with simulator

Start the BlackBerry® MDS Connection Service when you start the BlackBerry® Smartphone Simulator. You can use the BlackBerry MDS Connection Service to test network applications, push applications, and browser applications.

Launch app or URL on start up

Specify an application to start or a URL to open when the BlackBerry Smartphone Simulator starts.

Device

Specify the BlackBerry device model that starts when you run an application. The BlackBerry device models that are available are based on the version of the BlackBerry® Device Software that is currently selected.

Automatically use default values for all prompts

Select this option to have all options use the default value.

In the Specify the number of seconds to wait before the automated response is selected field, type the number of seconds that you want the BlackBerry Smartphone Simulator to wait.

PIN

Specify the PIN of the BlackBerry Smartphone Simulator.

ESN

Specify the Electronic Serial Number of the BlackBerry Smartphone Simulator. If unspecified, the number is generated from the PIN.

MEID

Specify the 14-digit hexadecimal CDMA Mobile Equipment Identifier of the BlackBerry Smartphone Simulator.

Enable device security

Specify that the BlackBerry Smartphone Simulator simulates a secure connection.

System locale

Specify the locale of the BlackBerry Smartphone Simulator.

Keypad locale

Specify the locale of the keyboard on the BlackBerry Smartphone Simulator. The default value is en.

Back To Top

Specify the appearance of the BlackBerry Smartphone Simulator

  1. In Eclipse®, on the Run menu, click Debug Configurations or Run Configurations.
  2. Expand the BlackBerry Simulator item.
  3. Perform one of the following tasks:
    • To work with an existing launch configuration, under BlackBerry Simulator, click a launch configuration.
    • To work with a new launch configuration, right-click BlackBerry Simulator, and click New.
  4. Click the Simulator tab.
  5. Click the View tab.
Back To Top

Settings for the appearance of the BlackBerry Smartphone Simulator

Option

Description

Disable automatic backlight shutoff

Specify that the backlighting of the BlackBerry® Smartphone Simulator remains turned on.

Hide network-specific information

Specify that the BlackBerry Smartphone Simulator does not display network information.

Display the LCD only

Specify that the BlackBerry Smartphone Simulator displays only the LCD screen.

LCD zoom

Specify that the BlackBerry Smartphone Simulator displays the LCD screen using a specific zoom level.

Always keep LCD backlight on

Specify that the backlighting remains on after the idle timeout period.

Do not show help for key mappings

Specify that help for key mappings is not displayed.

Back To Top

Specify debugging preferences for the BlackBerry Smartphone Simulator

  1. In Eclipse®, on the Run menu, click Debug Configurations or Run Configurations.
  2. Expand the BlackBerry Simulator item.
  3. Perform one of the following tasks:
    • To work with an existing launch configuration, under BlackBerry Simulator, click a launch configuration.
    • To create a new launch configuration, right-click BlackBerry Simulator, and click New.
  4. Click the Simulator tab.
  5. Click the Debugging tab.
Back To Top

Debugging settings for the BlackBerry Smartphone Simulator

Option

Description

Interrupt debugger on potential deadlock

Stop the application if the JRE™ detects a thread deadlock.

Do not stop execution when an exception is caught by catch(Throwable )

Continue running the application when an exception is caught by a catch(Throwable th) block.

Back To Top

Specify network settings for the BlackBerry Smartphone Simulator

  1. In Eclipse®, on the Run menu, click Debug Configurations or Run Configurations.
  2. Expand the BlackBerry Simulator item.
  3. Perform one of the following tasks:
    • To work with an existing launch configuration, under BlackBerry Simulator, click a launch configuration.
    • To create a new launch configuration, right-click BlackBerry Simulator, and click New.
  4. Click the Simulator tab.
  5. Click the Network tab.
Back To Top

Network settings for the BlackBerry Smartphone Simulator

Option

Description

Disable Registration

Prevent the BlackBerry® Smartphone Simulator from registering with the wireless network.

Network

Specify a string that describes one of the available networks. Use the following format: "{param}:value;{param}:value".

Start with radio off

Start the BlackBerry Smartphone Simulator with the wireless transceiver turned off.

Phone number

Specify the phone number of the BlackBerry Smartphone Simulator.

Automatically answer outgoing calls

Specify that the BlackBerry Smartphone Simulator answers outgoing calls automatically.

IMEI

Specify the International Mobile Equipment Identity of the BlackBerry Smartphone Simulator.

ICCID (GPRS)

Specify the 19 or 20-digit serial number of the simulated SIM card.

IMSI (GPRS)

Specify a 15-digit number to designate the subscriber.

Simulate SIM not present

Specify that the BlackBerry Smartphone Simulator reports the SIM card as not inserted.

IP Address

For a computer with multiple network interfaces, specify the interface that the BlackBerry Smartphone Simulator uses for network operations.

Ignore UDP port conflicts

Suppress warnings that the BlackBerry Smartphone Simulator produces when it cannot bind to a selected port.

SMS source port

Specify the UDP port number that the BlackBerry Smartphone Simulator uses to receive SMS text messages.

SMS destination port

Specify the UDP port that the BlackBerry Smartphone Simulator uses to send SMS text messages.

PDE port

Specify the PDE port number that the BlackBerry Smartphone Simulator uses for GPS access. This setting is only for BlackBerry devices that operate on the CDMA network.

Back To Top

Specify ports for the BlackBerry Smartphone Simulator

  1. In Eclipse, on the Run menu, click Debug Configurations or Run Configurations.
  2. Expand the BlackBerry Simulator item.
  3. Perform one of the following tasks:
    • To work with an existing launch configuration, under BlackBerry Simulator, click a launch configuration.
    • To work with a new launch configuration, right-click BlackBerry Simulator, and click New.
  4. Click the Simulator tab.
  5. Click the Ports tab.
Back To Top

Port settings for the BlackBerry Smartphone Simulator

Option

Description

USB cable connected

Specify that the BlackBerry® Smartphone Simulator is connected to the USB port of a computer.

Bluetooth test board port

Specify the port number that a Bluetooth® test board is connected to.

Back To Top

Specify memory settings for theBlackBerry Smartphone Simulator

  1. In Eclipse®, on the Run menu, click Debug Configurations or Run Configurations.
  2. Expand the BlackBerry Simulator item.
  3. Perform one of the following tasks:
    • To work with an existing launch configuration, under BlackBerry Simulator, click a launch configuration.
    • To create a new launch configuration, right-click BlackBerry Simulator, and click New.
  4. Click the Simulator tab.
  5. Click the Memory tab.
Back To Top

Memory settings for the BlackBerry Smartphone Simulator

Option

Description

Application heap size (bytes)

Specify the amount of RAM on a BlackBerry® Smartphone Simulator that Java® can use for all memory allocation. By default, the BlackBerry Smartphone Simulator configures an amount that is based on the BlackBerry Smartphone Simulator type.

Branding data

Specify the data that the BlackBerry Smartphone Simulator uses for the branding sector of the BlackBerry Smartphone Simulator flash memory.

Reset the file system on startup

Specify that the BlackBerry Smartphone Simulator deletes file system data when it starts.

Reset NVRAM on startup

Specify that the BlackBerry Smartphone Simulator deletes system non-volatile storage data when it starts.

File system size (bytes)

Specify the amount of simulated flash memory that the BlackBerry Smartphone Simulator uses as the file system. The BlackBerry Smartphone Simulator uses an amount that is based on the BlackBerry Smartphone Simulator type.

Do not save flash data on simulator exit

Specify that the BlackBerry Smartphone Simulator does not save changes to flash memory when it closes.

Do not compact file system on exit

Specify that the BlackBerry Smartphone Simulator does not compact the file system data when it closes.

Simulate no SD Card inserted

Specify that the BlackBerry Smartphone Simulator does not create files that represent media card data.

Clear SD Card on startup

Specify that the BlackBerry Smartphone Simulator creates a new media card file instead of using an existing media card file when starting.

SD Card size

Specify the size for new media cards that a BlackBerry Smartphone Simulator uses. The default size is 32 MB.

SD Card image

Specify that the BlackBerry Smartphone Simulator uses an existing media card data file as the media card.

Use PC file system for media card files

Specify that the BlackBerry Smartphone Simulator uses a folder on the hard disk drive of the computer as the media card.

PC file system path for media card files

Specify the root folder location of the media card file that the BlackBerry Smartphone Simulator uses. The BlackBerry Smartphone Simulator uses this location when the "Use PC file system for SD Card files" option is selected. The default path is <working directory>/sdcard).

Back To Top

Specify advanced features for the BlackBerry Smartphone Simulator

  1. In Eclipse®, on the Run menu, click Debug Configurations or Run Configurations.
  2. Expand the BlackBerry Simulator item.
  3. Perform one of the following tasks:
    • To work with an existing launch configuration, under BlackBerry Simulator, click a launch configuration.
    • To create a new launch configuration, right-click BlackBerry Simulator, select New.
  4. Click the Simulator tab.
  5. Click the Advanced tab.
Back To Top

Advanced settings for the BlackBerry Smartphone Simulator

Option

Description

Do not simulate using an authentic RIM battery

Specify that the BlackBerry® Smartphone Simulator identifies the battery as a third-party battery.

Do not use PC numpad as trackball

Specify that the BlackBerry Smartphone Simulator does not use the numeric keyboard on the computer to simulate the trackball.

Command Line

View the command line settings that you can use to start the BlackBerry Smartphone Simulator .

Back To Top

Specify a BlackBerry device for a BlackBerry Smartphone Simulator launch configuration

  1. In Eclipse® , on the Run menu, click Debug Configurations or Run Configurations.
  2. Expand the BlackBerry Simulator item.
  3. Perform one of the following tasks:
    • To work with an existing launch configuration, under BlackBerry Simulator, click a launch configuration.
    • To create a new launch configuration, right-click BlackBerry Simulator, select New.
  4. Click the Simulator tab.
  5. Click the General tab.
  6. In the Device drop-down list, select a BlackBerry® device.
Back To Top

Specify a BlackBerry Smartphone Simulator that is installed outside of the Eclipse environment

You can download and install a BlackBerry® Smartphone Simulator that is compatible with the BlackBerry JRE™ of your BlackBerry application project outside of the Eclipse® IDE and use it in the BlackBerry® Java® Plug-in for Eclipse®. To download a BlackBerry Smartphone Simulator installation file, visit www.blackberry.com/developers/resources.

  1. On the Run menu, click Run Configurations or Debug Configurations.
  2. Click the configuration that you want to use, or create a new configuration.
  3. Click the Simulator Tab.
  4. In the Device drop-down list, click a BlackBerry device from the BlackBerry Smartphone Simulator set that you installed.
  5. Click Run or Debug.
Back To Top

Run a BlackBerry device application in the BlackBerry Smartphone Simulator

The BlackBerry® Smartphone Simulator displays icons on the Home Screen or in the Downloads folder for all BlackBerry device applications that are installed. When you select an icon, the name of the application appears at the bottom of the BlackBerry device screen.
  1. In the Package Explorer view, right-click a project.
  2. Click Run As > BlackBerry Simulator.
  3. In the BlackBerry Smartphone Simulator, click the application icon.
Back To Top

Was this information helpful? Send us your comments.