Would you like to tell us how we are doing?

You bet No thanks

Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Changing BlackBerry device operating conditions

Use a single-button headset

  1. On the Simulate menu, click Headset Connected.
  2. In the Headset dialog box, perform one of the following actions:

    Task

    Steps

    Connect a single-button headset.

    1. Select the One button headset inserted option.

    Click the button on a single-button headset.

    1. Click Click.

Use a multibutton headset

  1. On the Simulate menu, click Headset Connected.
  2. Complete one of the following tasks:

    Task

    Steps

    Connect a multibutton headset.

    1. In the Headset dialog box, select the Multibutton headset inserted option.

    Click a button on a multibutton headset.

    1. Under the Multibutton headset inserted option, click one of the buttons.

Disconnect a headset

  1. On the Simulate menu, click Headset Connected.
  2. In the Headset dialog box, select the No headset option.

Change holster conditions

When the BlackBerry device is in the holster, the screen display turns off. By default, the BlackBerry device uses different notifications when in the holster.

On the Simulate menu, click In Holster.

Close a flip screen

When a BlackBerry Pearl Flip Series smartphone is flipped shut, the flip screen displays notifications.
On the Simulate menu, click Flipped.

Open or close a sliding BlackBerry device

When a BlackBerry Torch device is closed, it operates as a touch screen device. When the device is open, it operates as a keyboard device.
On the Simulate menu, click Open slider.

Simulate battery conditions

  1. On the Simulate menu, click Battery Properties.
  2. Set one of the following options:

    Option

    Description

    Full

    The battery level is sufficient for BlackBerry device and network use.

    Low

    The BlackBerry device alerts the user, but remains turned on and can still use the network.

    Very Low

    The BlackBerry device cannot access the network, but the device remains turned on.

    Camera flash is disabled.

    Dead

    The BlackBerry device turns off immediately.

    If you select this option, the BlackBerry Smartphone Simulator shuts down.

    Other

    This option enables you to specify the battery level as a percentage.

Simulate the absence of a SIM card

By default, the BlackBerry Smartphone Simulator for BlackBerry devices simulates the SIM card being present. The BlackBerry Smartphone Simulator allows you to simulate the absence of a SIM card.
  1. On the taskbar, click Start > Run.
  2. Type cmd.
  3. Click OK.
  4. To start the device, type the following command:
    fledge /handheld=<model_number> /no-sim-present

Simulating network conditions

The BlackBerry Smartphone Simulator can simulate various states of network coverage, from a strong signal to a very weak signal. The BlackBerry Smartphone Simulator can also simulate a loss of network coverage.

Add a network

  1. On the Simulate menu, click Network Properties.
  2. Click Add.
  3. Select a network type.
  4. Type the network properties in the dialog.
  5. Click OK.

Set the network signal strength

  1. On the Simulate menu, click Network Properties.
  2. Select the network you want to simulate from the Networks list.
  3. Select or clear the In coverage check box.
  4. Move the Signal strength (RSSI) slide bar to set a value. The signal strength can be between -120 dBm and -40dBm.

Specify the rescan interval for a Wi-Fi network connection

Before you begin:

Install the BlackBerry Smartphone Simulator 2.12 or later for a BlackBerry device that supports Wi-Fi connections.

You can specify how often the BlackBerry Smartphone Simulator scans for Wi-Fi networks. The default interval is five seconds. The range is 5 to 500 seconds.

  1. On the Simulate menu, click Network Properties.
  2. In the Available Network Properties section, select a Wi-Fi network.
  3. In the Global Network Properties section, move the slide bar to the interval that you want.
  4. Click Close.

Simulate supplementary phone services

A number of supplementary phone services, such as call forwarding or call waiting, might be available on a BlackBerry device. You can simulate the availability of these services. By default, the BlackBerry Smartphone Simulator is set up with all supplementary services.
  1. On the Simulate menu, click Provision Supplementary Services.
  2. In the Supplementary Services Provisioned dialog box, enable or disable services.

How the BlackBerry Smartphone Simulator simulates application storage

The BlackBerry device and some of its accessories use application storage, previously called flash memory. For each session, the BlackBerry Smartphone Simulator creates several files named <session_name>*.dmp. Each .dmp file corresponds to a different region of application storage. By default, the session name represents the model number of the BlackBerry device that you are simulating. For example, the application storage session files for a BlackBerry 7100 Series device simulator have names such as 7100-fs.dmp, 7100-nv.dmp, and 7100-as.dmp.

When the BlackBerry Smartphone Simulator starts, it loads the application storage for the device profile. If no files for application storage exist, the BlackBerry Smartphone Simulator creates new files. When the BlackBerry Smartphone Simulator exits, it saves the application storage contents to the .dmp files.

Clear the application storage

  1. Close the BlackBerry Smartphone Simulator.
  2. Restart the BlackBerry Smartphone Simulator using the /clear-flash command prompt option.

Example

fledge /handheld=7730 /serial-port=2 /comm=serial /clear-flash

Simulating BlackBerry Enterprise Server APIs and IT policies

Use the BlackBerry Enterprise Server to test applications that use the BlackBerry Enterprise Server Extension API, applied IT policies, email and browser messaging, HTTP/TCP connections, or push functionality. You can connect the BlackBerry Smartphone Simulator to an account on a BlackBerry Enterprise Server. You do not require a BlackBerry MDS Simulator or a BlackBerry Email Simulator.

Using the BlackBerry Enterprise Server requires knowledge of BlackBerry Enterprise Server administration. It also introduces a network dependance to testing. Depending on the application you are testing, you might also require the BlackBerry Desktop Manager and the BlackBerry Device Manager.

To use the following programs with the BlackBerry Smartphone Simulator, each of the BlackBerry Enterprise Server, BlackBerry Desktop Manager and BlackBerry Device Manager should be version 4.0 or later.

Use the BlackBerry Smartphone Simulator in secure mode

Before you deploy your application, you should test the application in secure mode.

By default, the BlackBerry Smartphone Simulator has two features that an make it easy to use but that are not found on the BlackBerry device. The simulator does not check for required code signatures on applications and it does not prompt you before connecting to the network. You can disable those features by running the BlackBerry Smartphone Simulator in secure mode.

When you enable BlackBerry Smartphone Simulator secure mode, you cannot use the .cod files that come with the BlackBerry Smartphone Simulator. You must use the .cod files that are installed on the BlackBerry device. To obtain the appropriate .cod files, you can copy BlackBerry device .cod files from your computer to the BlackBerry Smartphone Simulator installation folder.

By default, the location of the installation folder is: C:\Program Files\Common Files\Research In Motion\Shared\Loader Files\<Handheld>\Java.

Enable secure mode

You can only set secure mode as an option from the command prompt.

At the command prompt, start the BlackBerry Smartphone Simulator with the /secure option.

Example: Enabling secure mode with a simulation of the BlackBerry Torch 9800 smartphone

fledge /handheld=9800 /secure

Connect to Bluetooth USB accessories

The BlackBerry Smartphone Simulator can connect to some Bluetooth headsets. To connect through a Bluetooth USB connection, you must have the CSR driver btiasb2.inf installed.

You can only enable a Bluetooth USB connection from the command prompt by using the /bluetooth-usb parameter with the fledge command.

Simulating a USB connection to the computer

Simulating a USB cable connection enables you to connect the BlackBerry Smartphone Simulator to the BlackBerry Desktop Software. You must set up the environment in the BlackBerry Desktop Software and then enable or disable the connection in the BlackBerry Smartphone Simulator.

Because the USB cable connection is simulated, you cannot transfer files between the computer and the BlackBerry Smartphone Simulator.

This option is only available for BlackBerry device models that do not use a cradle.

Simulate a USB connection to the computer

BlackBerry Desktop Software 6.0 and later automatically uses a USB connection.
  1. If you have BlackBerry Desktop Manager version 5.1 or earlier, perform the following:
    1. On the Tools menu, click Connection options.
    2. In the Connection Type drop-down list, click USB.
    3. Click Simulation.
  2. In the BlackBerry Smartphone Simulator, on the Simulate menu, select or clear the USB Cable Connected option.

Simulating a media card

The BlackBerry Smartphone Simulator loads and saves the media card image to <session_name>*.sdcard in the working directory, unless you have set the /sdcard= <path> option. When the BlackBerry Smartphone Simulator starts, it loads the media card image for the BlackBerry device profile. If no image exists or you have specified the /clear-sdcard option, the BlackBerry Smartphone Simulator creates a new media card image when the BlackBerry Smartphone Simulator starts. The size of the media card image is 32MB, unless you specify otherwise using the /sdcard-size=<size> option.

You must clear the existing card image using the /clear-sdcard option to create a new card with the specified size. If a media card image exists, its size will be retained even if you specify a different size using the /sdcard-size option.

The BlackBerry Smartphone Simulator inserts the media card when the BlackBerry Smartphone Simulator unless you specify the /no-sdcard-inserted option.

Simulate a media card with a folder

You can simulate a media card by using an image file of a media card, or a folder. To test SQLite database applications on the BlackBerry Smartphone Simulator, you must simulate a media card by using a folder.
  1. Create a folder on your computer to store files for the media card.
  2. In the BlackBerry Smartphone Simulator, on the Simulate menu, click Change SD Card.
  3. In the list of available media cards, click one.
  4. Click the Mount icon.
  5. Click Close.

Format of a simulated media card

You can create a folder to simulate a media card for use with the BlackBerry Smartphone Simulator, either as a local Windows folder, or in FAT image format.
  • When you use Windows format, the BlackBerry Smartphone Simulator uses a standard folder as the simulated media card. The format is the same between the desktop computer and the simulated smartphone. To use as the simulated media card, the simulator creates a folder named BlackBerry that contains subfolders, such as Music and Pictures.
  • When you use media card image format, the BlackBerry Smartphone Simulator uses an image file as the simulated media card.

On startup, the BlackBerry Smartphone Simulator reads the simulated media card. If you want to add a media file to the simulated media card without using the BlackBerry Smartphone Simulator, you must add it before you start the simulator, or mount the media card folder again.

The BlackBerry Smartphone Simulator saves any database files that it creates to the simulated media card.