BlackBerry_Smartphone_Simulator-Development_Guide--simulator-6.0_BETA-US by Odane P. Hamilton

BlackBerry Smartphone Simulator Version: 6.0 BETA Development Guide

Published: 2011-02-17 SWD-1487721-0217093815-001

Contents 1 Overview...........................................................................................................................................................

2 Installation and Configuration.......................................................................................................................... System requirements: BlackBerry Smartphone Simulator............................................................................... Download a BlackBerry Smartphone Simulator................................................................................................ Install a BlackBerry Smartphone Simulator...................................................................................................... Changing configuration options........................................................................................................................ Managing simulator profiles with fledgelauncher.exe..................................................................................... Create and start a simulator profile with fledgelauncher.exe................................................................... Copy a BlackBerry simulator profile.......................................................................................................... Edit a BlackBerry simulator profile............................................................................................................ Rename a BlackBerry simulator profile..................................................................................................... Delete a BlackBerry device profile............................................................................................................. Start the BlackBerry Smartphone Simulator..................................................................................................... Redirect debug messages to a specified file.............................................................................................. Download the BlackBerry Email and MDS Services Simulator Package............................................................ Install the BlackBerry Email and MDS Services Simulator Package.................................................................. Changing BlackBerry Smartphone Simulator display options........................................................................... Show or hide the faceplate........................................................................................................................ Specify graphics acceleration.................................................................................................................... Magnify the BlackBerry device image....................................................................................................... Displaying the device in full-screen mode................................................................................................. Capturing screen shots..................................................................................................................................... Save a screen shot..................................................................................................................................... Copy a screen shot to the clipboard..........................................................................................................

6 6 6 6 7 7 7 8 8 8 8 9 9 10 10 11 11 11 11 12 12 12 12

3 Using the BlackBerry Smartphone Simulator.................................................................................................... Simulating input gestures to a BlackBerry touch screen.................................................................................. Use the trackball............................................................................................................................................... Use the trackwheel and keys............................................................................................................................ Assign a key to the Escape key.......................................................................................................................... Simulating convenience keys............................................................................................................................ Simulating multi-function keys.........................................................................................................................

13 13 14 14 15 15 16

4 BlackBerry Device Software applications.......................................................................................................... Use the contact list........................................................................................................................................... Use the calendar............................................................................................................................................... Compose an email............................................................................................................................................

17 17 17 17

Use text messaging........................................................................................................................................... Simulate an incoming call................................................................................................................................. Simulate an outgoing call.................................................................................................................................. Using voice activated dialing............................................................................................................................ Use voice activated dialing to make a call................................................................................................. Use voice activated dialing to check the device status.............................................................................. Use voice activated dialing to turn voice prompts on or off..................................................................... Using the camera.............................................................................................................................................. Take a picture............................................................................................................................................ Set a picture as the caller ID...................................................................................................................... Set a picture as your Home screen background........................................................................................ View a picture............................................................................................................................................ Rename a picture....................................................................................................................................... Delete a picture......................................................................................................................................... Send a picture in an email message.......................................................................................................... Recording video................................................................................................................................................ Record a video........................................................................................................................................... View a video.............................................................................................................................................. Set video recording options....................................................................................................................... Simulate a GPS receiver.................................................................................................................................... Simulating GPS location information................................................................................................................ Add a GPS location.................................................................................................................................... Change a GPS location............................................................................................................................... Delete a GPS location................................................................................................................................ Managing GPS routes........................................................................................................................................ Simulate a GPS route................................................................................................................................. Create a GPS route using existing locations.............................................................................................. Create a GPS route using a data file.......................................................................................................... Create a GPS route using NMEA 0183 sentences...................................................................................... Create a GPS route using random data..................................................................................................... Change a GPS route................................................................................................................................... Delete a GPS route.................................................................................................................................... Simulate a GPS route.................................................................................................................................

17 18 18 19 19 19 19 19 19 20 20 20 20 21 21 21 21 21 21 22 22 22 22 23 23 23 23 24 24 24 24 25 25

5 Changing BlackBerry device operating conditions............................................................................................ Use a single button headset............................................................................................................................. Use a multiple button headset......................................................................................................................... Disconnect a headset........................................................................................................................................ Change holster conditions................................................................................................................................

26 26 26 26 26

Use a flip device................................................................................................................................................ Simulate battery conditions.............................................................................................................................. Simulate the absence of a SIM card.................................................................................................................. Simulating network conditions......................................................................................................................... Add a network........................................................................................................................................... Set the network signal strength................................................................................................................. Specify the rescan interval for a Wi-Fi network connection...................................................................... Simulate supplementary services..................................................................................................................... Simulating flash memory.................................................................................................................................. Reset the flash memory............................................................................................................................. Simulating a media card................................................................................................................................... Change the media card.............................................................................................................................. Format of a simulated media card............................................................................................................. Simulating a computer connection................................................................................................................... Simulate a USB connection to the computer............................................................................................ Simulating BlackBerry Enterprise Server APIs and IT policies........................................................................... Using the BlackBerry Smartphone Simulator in secure mode.......................................................................... Enable secure mode.................................................................................................................................. View the event log............................................................................................................................................ Changing the BlackBerry device orientation..................................................................................................... Change screen orientation........................................................................................................................

27 27 27 27 27 28 28 28 28 29 29 29 30 30 30 31 31 31 31 32 32

6 Testing applications using the BlackBerry Smartphone Simulator................................................................... Test MIDlets...................................................................................................................................................... Testing GPS applications................................................................................................................................... Testing JavaScript and webpages..................................................................................................................... Testing BlackBerry Enterprise Server APIs and IT policies................................................................................ Test a BlackBerry Smartphone Simulator with a BlackBerry Enterprise Server........................................

33 33 33 33 33 34

7 Testing applications that require an HTTP connection..................................................................................... Start the BlackBerry MDS Simulator and verify that it is running..................................................................... Connecting the BlackBerry Smartphone Simulator to BlackBerry Enterprise Server or a BlackBerry MDS Simulator on the same computer..................................................................................................................... Configuring the BlackBerry MDS Simulator simulator...................................................................................... Configure BlackBerry MDS Simulator properties....................................................................................... BlackBerry MDS Simulator logging properties........................................................................................... BlackBerry MDS Simulator HTTP properties.............................................................................................. BlackBerry MDS Simulator HTTPS properties............................................................................................ Push support..............................................................................................................................................

35 35 35 36 36 36 37 38 39

Testing push applications................................................................................................................................. Configure the BlackBerry MDS Simulator to allow reliable push connections.......................................... Map the internet messaging address to the BlackBerry Smartphone Simulator PIN................................ Change the BlackBerry Smartphone Simulator PIN................................................................................... Testing messaging applications........................................................................................................................ Configure a POP3 and SMTP server connection........................................................................................ Send a message......................................................................................................................................... Receive a message..................................................................................................................................... Testing BlackBerry Enterprise Server APIs and IT policies................................................................................ Simulating BlackBerry Enterprise Server APIs and IT policies....................................................................

39 39 39 40 40 40 41 41 41 42

8 Using the BlackBerry Smartphone Simulator programmatically...................................................................... Start the BlackBerry Smartphone Simulator controller.................................................................................... Send commands to the BlackBerry Smartphone Simulator.............................................................................. Exit the BlackBerry Smartphone Simulator controller session......................................................................... BlackBerry device accessory commands........................................................................................................... Behavior and appearance commands.............................................................................................................. Data and phone commands.............................................................................................................................. Exit the BlackBerry Smartphone Simulator controller session......................................................................... Location commands.......................................................................................................................................... Keyboard and event commands....................................................................................................................... Use BlackBerry Smartphone Simulator controller commands......................................................................... Using test scripts............................................................................................................................................... Test BlackBerry Smartphone Simulator events using script......................................................................

43 43 43 44 44 45 46 47 47 48 49 49 49

9 Troubleshooting................................................................................................................................................ The BlackBerry Smartphone Simulator takes a long time to start.................................................................... I have a JVM error 543...................................................................................................................................... Files in the BlackBerry Smartphone Simulator................................................................................................. The location of user settings.............................................................................................................................

51 51 51 51 52

10 Provide feedback..............................................................................................................................................

11 Legal notice.......................................................................................................................................................

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Overview

The BlackBerry速 Smartphone Simulator enables you to run BlackBerry device applications on your computer. The BlackBerry Smartphone Simulator includes the BlackBerry device applications that are typically available on BlackBerry devices and enables you to load and test your own applications. You can simulate and test various connectivity and state changes using the BlackBerry Smartphone Simulator. When you use the BlackBerry Smartphone Simulator to perform testing, you might need to simulate additional BlackBerry services. The BlackBerry MDS Simulator and the BlackBerry Email Simulator are available for this purpose.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Installation and Configuration

System requirements: BlackBerry Smartphone Simulator Your computer must meet all the following requirements before you install the BlackBerry® Smartphone Simulator: • • • • • • •

Intel® Pentium® 4 processor or equivalent (2 GHz or higher) 512 MB RAM or more 64 MB video card that optionally supports OpenGL® 1.1 or later 2 GB or more available hard disk space Windows Vista® 32-bit or 64-bit, Windows® XP 32-bit or 64-bit, Windows® 7 32-bit or 64-bit, or Windows Server® 2003 32-bit or 64-bit Java® SE Development Kit (JDK) 6.0 or later Microsoft® DirectX® 8.0 or later

Download a BlackBerry Smartphone Simulator 1. 2. 3. 4.

In your browser, navigate to www.blackberry.com/developers/resources. Click BlackBerry smartphone simulators. In the drop-down list, click the BlackBerry® smartphone that you want to simulate. Select either the carrier or the BlackBerry® Device Software version that you want to simulate. A list of available simulator packages appears. 5. Click the installation file that you want. 6. Complete the information on the screen. Click Next. This screen is absent if you are logged in to the BlackBerry® Developer Zone. 7. Accept the download agreement. Click Next. This screen is absent if you are logged in to the BlackBerry Developer Zone. 8. Click Download. 9. In the File Download dialog box, click Save. 10. In the Save As dialog box, specify the location where you want to save the installation file. 11. Click Save.

Install a BlackBerry Smartphone Simulator Before you begin: Download a BlackBerry® Smartphone Simulator installation file. 1. 2. 3.

On the taskbar, click Start > Run. In the Run dialog box, click Browse. Navigate to the BlackBerry Smartphone Simulator installation file. Click OK.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

4. 5. 6. 7. 8. 9.

In the Open File dialog box, click Run. In the BlackBerry Smartphone Simulator Setup dialog box, click Next. Accept the license agreement. Click Next. In the Select Installation Folder dialog box, click Next. In the Ready to Install dialog box, click Install. In the Completing the BlackBerry Simulators Setup Wizard dialog box, click Finish.

Changing configuration options By default, after you specify the BlackBerry® device model, the BlackBerry Smartphone Simulator runs using the configuration options that are typical for that BlackBerry device. However, you can manually set or change many of the configuration options, such as the screen size, the communication port numbers, and the locale. Configuration method Description From an integrated development You can configure many of the simulator settings from the integrated environment such as the development environment interface and save them. See the BlackBerry® WebWorks™ Plug-in or documentation for the plug-in or for the BlackBerry IDE for more the BlackBerry® Integrated information about setting and saving BlackBerry Smartphone Simulator Development Environment options using the BlackBerry IDE. From the command prompt You can use command prompt options to set how the BlackBerry Smartphone Simulator operates. At the command prompt, type fledge / help.

Managing simulator profiles with fledgelauncher.exe The fledgelauncher.exe program uses simulator profiles, which associate the profile name with a model number, a version of the BlackBerry® Device Software, and a list of settings. The settings include information about the network, display, PIN, command line options, and more. You can use a simulator profile to start any frequently-used combinations of settings for a particular BlackBerry® Smartphone Simulator.

Create and start a simulator profile with fledgelauncher.exe 1. 2. 3. 4. 5. 6.

In the BlackBerry® Smartphone Simulator folder, double-click the fledgelauncher.exe file. In the drop-down list, select Create a new simulator profile. In the Software version drop-down list, select the version of the BlackBerry® Device Software that you want to emulate. In the Handheld model drop-down list, select the BlackBerry device that you want to emulate. In the Profile name field, type a name for this profile. Click Configure.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

7. 8. 9. 10. 11.

In the Edit simulator profile dialog box, configure the settings you want for this profile. Click OK. In the drop-down list, select Launch a simulator. In the list of profiles, select the one you created. Click Go.

Copy a BlackBerry simulator profile 1. 2. 3. 4.

In the BlackBerry速 Smartphone Simulator directory, double-click the fledgelauncher.exe file. In the drop-down list, select Manage existing simulator profiles. In the Profile list, select the profile you want to copy. Click Copy.

Edit a BlackBerry simulator profile 1. 2. 3. 4. 5. 6.

Rename a BlackBerry simulator profile 1. 2. 3. 4. 5. 6.

Delete a BlackBerry device profile 1. 2. 3. 4.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Start the BlackBerry Smartphone Simulator For information about starting the BlackBerry速 Smartphone Simulator from a plug-in, see the documentation for that plug-in. To start the BlackBerry Smartphone Simulator, perform one of the following tasks: Task To start the BlackBerry Smartphone Simulator from the Windows速 taskbar To start the BlackBerry Smartphone Simulator from fledgelauncher.exe

To start the BlackBerry Smartphone Simulator from the command prompt

Steps Click Start > Programs > Research In Motion > BlackBerry Smartphone Simulators x.x.x > software_bundle_number > device_name. a.

Navigate to the folder that contains the version of the BlackBerry Smartphone Simulator.

Double-click fledgelauncher.exe.

In the drop-down list, select Manage existing simulator profiles.

In the Profile list, select the profile.

Click Go.

At the command prompt, navigate to the folder that contains the version of the BlackBerry Smartphone Simulator that you want to start.

At the command prompt, type: fledge /handheld=<model_number>

To start the BlackBerry Smartphone Simulator from the command prompt while opening a known webpage

At the command prompt, navigate to the folder that contains the version of the BlackBerry Smartphone Simulator that you want to start.

At the command prompt, type: fledge /handheld=<model_number> /appparam=url:<URL> /app=jvm.dll

From the command prompt while redirecting debug messages to a specified file

At the command prompt, navigate to a folder that contains a BlackBerry Smartphone Simulator.

At the command prompt, type: fledge /handheld=<model_number> /appparam=JvmDebugFile<file_name>

Redirect debug messages to a specified file At the command prompt, type:

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

fledge /handheld=<model_number> /app-param=JvmDebugFile:<file_name>

Download the BlackBerry Email and MDS Services Simulator Package 1. 2. 3. 4. 5. 6. 7. 8. 9.

In your browser, navigate to www.blackberry.com/developers/downloads. Under Java Application Development, click BlackBerry Smartphone Simulators. In the drop-down list, click the BlackBerry速 Email and MDS Services Simulator Package. Click Next. Locate the latest installation file. Click Download. Complete the information on the screen. Click Next. Accept or decline the download agreement. Click Next. On the Software Download for Device Simulators web page, click Download. In the File Download dialog box, click Save. In the Save As dialog box, specify the location where you want to save the installation file. Click Save.

Install the BlackBerry Email and MDS Services Simulator Package Before you begin: To use the BlackBerry速 Email and MDS Services Simulator Package you must install the Java速 SE Development Kit on your computer. If you do not have the Java SE Development Kit installed on your computer, the BlackBerry Email and MDS Services Simulator Package installation file prompts you to download and run the setup application. 1. 2. 3. 4. 5. 6. 7.

On the taskbar, click Start > Run. In the Run dialog box, click Browse. Navigate to the location where you saved the BlackBerry Email and MDS Services Simulator Package installation file. Select the installation file. Click Open. Click OK. In the Open File dialog box, click Run. If the Prerequisites Wizard appears, click Next and complete one of the following tasks: Task Steps Install the Java SE Development Kit a. Click Next.

Complete the instructions on the screen.

In the BlackBerry Email and MDS Services Simulator Package Setup dialog box, click Finish.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Task Steps Skip the installation of the Java SE Click Finish. Development Kit 8. 9. 10. 11. 12.

In the BlackBerry Email and MDS Services Simulator Package Setup Wizard dialog box, click Next. Accept or decline the license agreement. Click Next. In the Select Installation Folder dialog box, click Next. In the Ready to Install dialog box, click Install. In the Completing the BlackBerry Email and MDS Services Simulator Package Setup Wizard dialog box, click Finish.

Changing BlackBerry Smartphone Simulator display options Show or hide the faceplate By default, the BlackBerry® Smartphone Simulator displays the BlackBerry device faceplate. You can hide the faceplate so that only the screen is visible. On the View menu, click LCD Only.

Specify graphics acceleration You can use graphics acceleration to help improve the graphics quality in the BlackBerry Smartphone Simulator. You can choose from four levels of acceleration. Before you begin: Verify that you have the following components installed on your computer: • •

video card that supports OpenGL® 1.1 or later BlackBerry® Smartphone Simulator 2.13 or later

1. 2.

On the View menu, click Graphics Acceleration. Click the level of acceleration that you want.

After you finish: To turn off graphics acceleration, on the View menu, click Graphics Acceleration > Off.

Magnify the BlackBerry device image The percentage value determines the pixel-to-pixel ratio between the simulated LCD screen and the computer screen. For example, at 200 percent zoom level, 4 pixels on the monitor display 1 pixel of the simulated LCD screen. 1.

On the View menu, click Zoom. 11

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

2. 3.

Click a percentage. On the View menu, click Smooth Magnified LCD.

Displaying the device in full-screen mode Full-screen mode allows you to maximize the view of the BlackBerry速 Smartphone Simulator. You can view either the full BlackBerry device faceplate or only the screen in full-screen mode. Since the BlackBerry Smartphone Simulator only uses integral multiples of the simulated screen resolution, different screen resolution settings may result in fullscreen images that cover a larger percentage of the computer screen. If you are viewing the LCD screen in full-screen mode, the LCD screen stretches to its optimal zoom-level and is padded with a black background. If you view the BlackBerry device image in full-screen mode, the BlackBerry device image is centered and is padded with a white background.

Display the device in full-screen mode 1. 2. 3.

On the View menu, click Full Screen. To access menu options, move the mouse to the top of the computer screen. The menu appears when the cursor is near the top of the screen. To exit full-screen mode, on the View menu, click Full Screen.

Capturing screen shots The BlackBerry速 Smartphone Simulator can save an image of the BlackBerry device that you simulate including the faceplate, or the screen only. By default, the BlackBerry Smartphone Simulator saves the screen shot as the most suitable file type for the content of the image. The BlackBerry Smartphone Simulator saves a screen shot of the BlackBerry device image as a .jpg file, and a screen shot of the LCD as a .png file. You can override the default if you click Browse and set a different file type in the Save as type field.

Save a screen shot On the Edit menu, click Save Device Snapshot or Save LCD Snapshot.

Copy a screen shot to the clipboard On the Edit menu, click Copy Device Snapshot or Copy LCD Snapshot.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Using the BlackBerry Smartphone Simulator

Simulating input gestures to a BlackBerry touch screen Using the mouse, simulate navigation of a BlackBerry速 device with a touch screen using the BlackBerry速 Smartphone Simulator in the following ways: Navigation to simulate Click the screen Drag a finger

Swipe across the screen

Tap the screen Tap the screen twice quickly in the same location Touch the screen Touch and hold screen Touch an item Touch an item Touch and hold finger on an item Touch the screen in two locations at the same time (such as pinch gestures)

BlackBerry Device Software versions 4.71 to 5.1 4.7.1 and later

4.7.1 and later

6.0 and later 6.0 and later

4.71 to 5.1 6.0 and later

4.71 to 5.1 6.0 and later 6.0 and later

4.7.1 and later

Steps Click with the left mouse button on the simulated screen. a.

On the simulated screen, click either mouse button down and hold it.

Move the mouse pointer.

Release the mouse button.

On the simulated screen, click either mouse button down and hold it.

Quickly move the mouse pointer in the desired direction.

c. Let go of the mouse button. With either mouse button, click a spot on the simulated screen. With either mouse button, double-click a spot of the simulated screen. Click with the right mouse button on the simulated screen. a.

On the simulated screen, click either mouse button and hold it.

b. Release the mouse button. Right-click the mouse button on the item. Click either mouse button on the item. a.

On the simulated screen, click either mouse button on the item and hold it.

Release the mouse button.

On the Simulate menu, click Multitouch Mode.

Click and drag using either mouse button anywhere within the simulated screen area.

Perform the same action elsewhere on the screen.

After you complete the second touch, both touches are simulated as if they were started at the same time. 13

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Use the trackball Use the BlackBerry® Smartphone Simulator trackball to simulate using the trackball on a BlackBerry® device. • To navigate between fields, icons, and menu items, roll the trackball. • To select a field or a menu item, click the trackball. BlackBerry Smartphone Simulator for BlackBerry devices that support the trackball assign the BlackBerry Wireless Handheld keyboard and mouse actions to the following BlackBerry Wireless Handheld functionality: Task

Keyboard steps

Mouse steps with trackball Mouse steps with trackball mode on mode off

Turn trackball mode on or off.

Press F12.

On the Edit menu, click Map Middle Mouse Button > Toggle Trackball Mode

2. Click the trackball.

Press F9.

Roll the trackball.

Press the arrow keys.

Press the Escape button.

Press ESC.

Click the middle mouse button. Click the left mouse button. Move the mouse.

Click the right mouse button.

On the Edit menu, click Map Middle Mouse Button > Toggle Trackball Mode.

Click the middle mouse button. Click the middle mouse button on the trackball. Click and drag the mouse on the trackball. Click the right mouse button on the trackball.

Note: Rolling the mouse wheel generates trackwheel rolls not trackball rolls. Although the BlackBerry Smartphone Simulator will appear to be receiving trackball rolls, it is actually a trackwheel event.

Use the trackwheel and keys Use the BlackBerry® Smartphone Simulator trackwheel to simulate using the trackwheel on a BlackBerry® device. Note that not all BlackBerry devices use the keys listed. • To navigate between fields, icons, and menu items, roll the trackwheel. • To set a field or select a menu item, click the trackwheel. The BlackBerry Smartphone Simulator assigns BlackBerry device functionality to the following computer keyboard and mouse procedures: Task Roll the trackwheel.

Keyboard steps Press the UP ARROW or DOWN ARROW key.

Mouse steps Roll the mouse wheel button.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Task Click the trackwheel. Press the Escape key. Turn on BlackBerry device backlighting.

Keyboard steps Press the LEFT ARROW key. Press ESC or the RIGHT ARROW key. Press PAGE DOWN.

Press the Symbol key.

Press DELETE.

Press the Alt key.

Press CTRL.

Press the BlackBerry device keys.

Press the keys on your computer keyboard. Press PAGE UP.

Press the phone/PTT (Push to Talk) button.

Mouse steps Click the mouse wheel button. Click the right mouse button. Click the Power button on the BlackBerry Smartphone Simulator keyboard. Click the Symbol key on the BlackBerry Smartphone Simulator keyboard. Click the Alt key on the BlackBerry Smartphone Simulator keyboard. Click the keys on the BlackBerry Smartphone Simulator keyboard. —

Note: If you press a key on your computer keyboard that does not have directly correspond to a key on the BlackBerry device (such as the number or symbol keys), the BlackBerry Smartphone Simulator inserts the character as it appears on the computer keyboard.

Assign a key to the Escape key BlackBerry® Smartphone Simulator for BlackBerry® devices that do not support the trackball enable you to map the cursor key to the Escape key. 1. 2.

On the Edit menu, click Map Cursor Key to Escape. Select Left or Right.

Simulating convenience keys Some BlackBerry® smartphones contain additional keys that are not present on other BlackBerry models. The BlackBerry Smartphone Simulator assigns the device keys to the following computer keyboard procedures: Active Key Front Convenience key Side Convenience key Currency symbol key (BlackBerry® 8700 Series only)

Steps Press Insert. Press PAGE UP. Press F5.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Active Key Speaker phone key (BlackBerry速 8700 Series only)

Steps Press F6.

Simulating multi-function keys Some BlackBerry速 smartphones contain additional keys that are not present on other BlackBerry models. The BlackBerry Smartphone Simulator assigns the device keys to the following computer keyboard procedures: Active Key Menu key Right Side Convenience key Left Side Convenience key Volume Up key Volume Down key

Steps Press Insert. Press \. Press PAGE UP. Press F8 Press F7.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

BlackBerry Device Software applications

Use the contact list 1. 2. 3. 4. 5.

Open Address Book. On the Address Book menu, click New Address. Type contact information in the appropriate fields. Open the menu. Click Save.

Use the calendar 1. 2. 3. 4. 5.

Open Calendar. In the Calendar menu, click New. Type appointment information in the appropriate fields the New Appointment screen. Open the menu. Click Save.

Compose an email 1. 2. 3. 4. 5. 6.

Open Messages. In the Messages menu, click Compose Email. In the To field, type an email address. Set the Cc, Subject, and Body fields. Open the menu. Click Save Draft

After you finish: The BlackBerry速 Email Simulator is required to simulate sending an email message.

Use text messaging You can use the BlackBerry速 Smartphone Simulator to simulate sending an SMS text message to a server side application. Verify that you have installed the BlackBerry速 Java速 Development Environment. 1. 2. 3. 4. 5.

Click the Call Log icon. Type the destination phone number for the SMS text message. Open the menu. Click SMS <number>. Type your message. 17

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

6. 7.

Open the menu. Click Send.

Simulate an incoming call 1. 2. 3.

On the Simulate menu, click Incoming Voice Call. In the New Incoming Call dialog box, for the originating phone number, type a new phone number or the phone number of an existing contact. Set one of the following Caller ID options: Option Allowed Private Unknown

4. 5. 6.

Description The BlackBerry® device can display the phone number of the originating phone. The phone number of the originating phone is blocked and not available for display on the BlackBerry device. The BlackBerry device cannot determine the phone number of the originating phone.

To place the phone call to the BlackBerry Smartphone Simulator, click Create Call. Click Answer or Ignore. End the call by performing one of the following actions: Task Steps Simulate the termination of the call by the originating Click Disconnect. phone. Simulate a network failure. Set a reason for failure. Click Fail.

Simulate an outgoing call 1. 2. 3. 4. 5. 6. 7.

Open Call Log. In the Call Log menu, click Call From Address Book. In the Call field, type a new phone number or set a contact. Press the Enter key. Open the menu. Click Continue. In the Call to dialog box, perform one of the following actions: • Click Answer. • To simulate a failed connection, set a reason for failure. Click Fail.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Using voice activated dialing Use voice activated dialing to make a call 1. 2. 3.

Click the VoiceActivatedDialing icon. Say “Call” and a contact name or number. When the BlackBerry® Smartphone Simulator prompts you to verify the phone number, perform one of the following actions: • Set the correct phone number from the list and click the trackball. • Say “Yes” when the BlackBerry Smartphone Simulator reads the correct phone number. Say “No” when the BlackBerry Smartphone Simulator reads an incorrect phone number. Say “Repeat” to hear the phone number again. Say “Cancel” if the correct phone number does not appear in the list.

Use voice activated dialing to check the device status When you say “Check Status” the BlackBerry® Smartphone Simulator displays the status of battery, coverage, and signal strength. 1. 2.

Click the VoiceActivatedDialing icon. Say “Check” and say one of the following: • “Battery” • “Coverage” • “My Phone Number” • "Signal strength” • “Status”

Use voice activated dialing to turn voice prompts on or off 1. 2. 3.

Click the VoiceActivatedDialing icon. If prompts are turned on, say “Turn prompts off”. If prompts are turned off, say “Turn prompts on”.

Using the camera Make sure your webcam is connected and functioning properly. If the BlackBerry® Smartphone Simulator does not detect a connected webcam, a prompt appears and you can select a picture file from your hard drive.

Take a picture 1.

Click the Camera icon.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

2. 3. 4.

If prompted, to save pictures to the media card on the BlackBerryÂŽ Smartphone Simulator, click Yes. To save pictures to the BlackBerry Smartphone Simulator device memory, click No. To take a picture, click the trackball. To take another picture, click Take Another Picture.

Set a picture as the caller ID 1. 2. 3. 4. 5. 6.

Click Set As. Click Set As Caller ID. In the Username field, type the user name. In the Domain field, type the domain. In the Password field, type the password. Click OK.

Set a picture as your Home screen background 1. 2.

Click Set As. Click Set As Home Screen Image.

View a picture When an application switches to camera viewfinder mode, the viewfinder displays the picture that you select using the Camera Image menu item. The viewfinder displays the file selector if no picture has been selected before. For best results, select an image of equal or greater resolution than the cameraâ&#x20AC;&#x2122;s maximum resolution of 1280 by 1024. If you select a picture with a higher resolution or different aspect ratio than the camera, the Camera application displays only the center of the picture. 1. 2.

On the Simulation menu, click Camera Image. Select a .jpg file to view.

After you finish: The last picture that you select becomes the default picture that is displayed the next time you start the BlackBerry Smartphone Simulator.

Rename a picture 1. 2. 3.

Click Rename Picture. In the Name field, type a new name. Click OK.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Delete a picture 1. 2.

Click Delete Picture. Click Delete to confirm.

Send a picture in an email message 1.

Click Send Picture.

2. 3.

Click Send As Email. Compose the email message.

Recording video Before you being, ensure that your webcam is connected and functioning properly. If the BlackBerry速 Smartphone Simulator does not detect a connected webcam, a prompt appears and you can select a jpeg file from your hard drive. You can then click on the LCD an drag the image around to record the movements as a video.

Record a video 1. 2. 3. 4.

Click the Video Camera icon. If prompted, to save videos to the media card on the BlackBerry速 Smartphone Simulator, click Yes. To save pictures to the BlackBerry Smartphone Simulator device memory, click No. To start recording a video, click the trackball. To stop recording, click the trackball.

View a video 1. 2. 3.

Click the Video Camera icon. Click the Menu key. Click View Videos.

Set video recording options 1. 2. 3. 4.

Click the Video Camera icon. Click the Menu key. Click Options. Perform any of the following actions:

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Task Set the video light. Set the color effect Set the video resolution.

Steps Specify the Video Light option. Specify the Color Effect option. Specify the Video Format action.

Simulate a GPS receiver A GPS receiver is a device that receives GPS information and transmits it to the BlackBerry速 device through a Bluetooth速 connection. Devices must be running applications with JSR179 in order for this functionality to work properly. To simulate a BlackBerry device that is close enough to a Bluetooth GPS receiver to receive data from the receiver, perform the following actions: 1. 2.

On the Simulate menu, click GPS Location. Set Bluetooth GPS Receiver In Range.

Simulating GPS location information You can simulate movement between fixed GPS locations, create and save several locations along a route. Once you save the route, run the simulation. A location represents one end point of a path. A route can contain one or more paths. The BlackBerry速 Smartphone Simulator emulates movement between locations on a route across one or more paths. You can create and save multiple locations that you can simulate.

Add a GPS location 1. 2. 3. 4. 5. 6. 7.

In the Location section, click Add. In the Name field, type a name. In the Latitude and Longitude fields, type a latitude and longitude. In the Altitude field, type an altitude. The BlackBerry速 Smartphone Simulator specifies the altitude in metres above (or below) the WGS84 ellipsoid. Visit w3sli.wcape.gov.za/Surveys/Mapping/wgs84.htm for more information. In the Satellites field, type the number of satellites that are visible from that location. Click Save.

Change a GPS location The valid range for latitude is -90 to 90. The valid range for longitude is -180 to 180. 1. 22

In the Location drop-down list, select a location.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

2. 3.

Click Edit and change the values in the appropriate fields. Renaming a location will cause routes that contain that location to fail. Click Save.

Delete a GPS location 1. 2.

In the Location drop-down list, click a location to delete. Click Delete.

Managing GPS routes To simulate movement between different GPS locations, set up a route with one or more paths. Each path represents a straight line between two adjacent locations. Each path contains information about the rate of speed used to travel between the path start and end locations. You can use the following rates of speed: metres per second (m/s), kilometres per hour (km/h), metres per hour (m/ h), and feet per second (f/s). The speed limit in terms of metres per second is 655 m/s, with respective limits set for other rates.

Simulate a GPS route Route simulation uses the Haversine formula to calculate the changing GPS coordinates and updates the location, the direction, and the coordinates every second. 1. 2.

On the Simulate menu, click GPS Location. Perform one of the following actions: Task Play a route. Stop a route.

Steps In the Route section, click the Play (right arrow) icon. In the Route section, click the Stop (black square) icon.

To restart the route, stop the simulation. Press the Play Route button.

Create a GPS route using existing locations 1. 2. 3. 4. 5. 6. 7.

On the Simulate menu, click GPS Location. In the Route section, click Add. Click existing locations. Type a name for the new route Select the starting location of the route. Type a speed value and set the rate of speed for the path. Click Insert to insert this location into the route. 23

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

8. 9.

To add additional locations to the route, repeat steps 3 through 5. Save the route.

Create a GPS route using a data file 1. 2. 3. 4. 5. 6.

On the Simulate menu, click GPS Location. In the Route section, click Add. Click data from a file. From the Import Route dialog-box, select a data file. Type a name for the data file. Save the route.

Create a GPS route using NMEA 0183 sentences The BlackBerry Smartphone Simulator accepts GGA and RMC sentences written in the style of NMEA速 0183 V2.3 and later. Before you begin: When using a BlackBerry速 Smartphone Simulator earlier than 6.0.1, make sure the BlackBerry速 MDS Simulator is running. 1. 2. 3. 4.

On the BlackBerry Smartphone Simulator, open Simulate > GPS Location. Under Route, click Add. Choose a data file and click OK. Select the file and click OK.

Create a GPS route using random data 1. 2. 3. 4. 5.

On the Simulate menu, click GPS Location. In the Route section, click Add. Select Create route using random route generator. Click OK. In the new dialog, specify the route name, the number of legs, the duration of the route (in seconds), as well as a start and end location. If you generated the route successfully, the New Route dialog displays the route information that you typed in step 3.

Change a GPS route 1. 2. 3.

On the Simulate menu, click GPS Location. Set a route to change. Perform one or more of the following procedures:

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Task Change the route name.

Steps

Add a location to the route.

Click Insert.

In the Start Location drop-down list, click a location.

Type a speed value and set the rate of speed for the path.

In the text box, under the Name field, set the location you want to change.

In the Start Location drop-down list, click the location you want to change to.

Type a speed value and set the rate of speed for the path.

From the text box, under the Name field, set a location.

Click Delete.

Change a location.

Remove a location. 4. 5.

In the Name field, type a new name for the route.

In the Name field, type a new name for the route. Click Save.

Delete a GPS route 1. 2. 3.

On the Simulate menu, click GPS Location. In the Route drop-down list, click a route to delete. Click Delete.

Simulate a GPS route Route simulation uses the Haversine formula to calculate the changing GPS coordinates and updates the location, the direction, and the coordinates every second. 1. 2.

On the Simulate menu, click GPS Location. Perform one of the following actions: Task Play a route. Stop a route.

Steps In the Route section, click the Play (right arrow) icon. In the Route section, click the Stop (black square) icon.

To restart the route, stop the simulation. Press the Play Route button.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Changing BlackBerry device operating conditions

Use a single button headset Perform one of the following actions: Task Connect a single button headset.

Steps a.

On the Simulate menu, click Headset Connected.

In the Headset dialog box, select the One button headset inserted option.

Click the button on a single button headset.

In the Headset dialog box, click Click.

Use a multiple button headset Perform one of the following actions: Task Connect a multibutton headset. Click a button on a multibutton headset.

Steps a.

On the Simulate menu, click Headset Connected.

In the Headset dialog box, select the Multibutton headset inserted option. Under the Multibutton headset inserted option, click one of buttons.

Disconnect a headset 1. 2.

On the Simulate menu, click Headset Connected. 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.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Use a flip device When a BlackBerry® Pearl™ Flip Series smartphone is flipped shut, the screen display turns off. The BlackBerry device uses the flip screen to display notifications. On the Simulate menu, click Flipped.

Simulate battery conditions 1. 2.

On the Simulate menu, click Battery Properties. Set one of the following options: Option Full Low Very Low

Description The battery level is sufficient for BlackBerry® device and network use. The BlackBerry device alerts the user, but remains turned on and can still use the network. The BlackBerry device cannot access the network, but the device remains turned on.

Dead

Camera flash is disabled. The BlackBerry device turns off immediately.

Other

If you select this option, the BlackBerry Smartphone Simulator shuts down. This option enables you to specify the battery level as a percentage.

Simulate the absence of a SIM card The BlackBerry® Smartphone Simulator for BlackBerry devices with SIM cards allow you to simulate the absence of a SIM card. By default, the BlackBerry Smartphone Simulator simulates the SIM card being present. At the command prompt, type the following command when you start the device: 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. 2.

On the Simulate menu, click Network Properties. Click Add.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

3. 4.

Type the network properties in the dialog. Click OK.

Set the network signal strength 1. 2. 3. 4. 5.

On the Simulate menu, click Network Properties. Select the network you want to simulate from the Networks list. If you want to edit the network properties, click Edit and type new values. Click OK. Select or clear the In coverage check box. 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 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. Before you begin: Install the BlackBerry Smartphone Simulator 2.12 or later for a BlackBerry device that supports Wi-Fi connections. 1. 2. 3. 4.

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

Simulate supplementary services A number of supplementary services, such as call forwarding or call waiting, might be available on a BlackBerry速 device. You can simulate the availability of these services. The BlackBerry Smartphone Simulator is set up with all supplementary services by default. 1. 2.

On the Simulate menu, click Provision Supplementary Services. In the Supplementary Services Provisioned dialog box, enable or disable services.

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

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

When the BlackBerry Smartphone Simulator starts, it loads the flash memory for the device profile; if no flash memory files exist, the BlackBerry Smartphone Simulator creates new files. When the BlackBerry Smartphone Simulator exits, it saves flash memory contents to the .dmp files. The BlackBerry Smartphone Simulator saves changes to flash memory as you make them. To keep changes from overwriting the original file system, use the /load-filesystem=<session-name>-fs.dmp option. The file system will be saved to <session-name>-fs.dmp. To specify a unique session name, use the /session command prompt option. When you reset the flash memory, the BlackBerry Smartphone Simulator removes application data and clears the .dmp files for the session.

Reset the flash memory 1. 2.

Close the BlackBerry速 Smartphone Simulator. Restart the BlackBerry Smartphone Simulator using the /clear-flash command prompt option. For example, type the following: fledge /handheld=7730 /serial-port=2 /comm=serial /clear-flash

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 / clear-sdcard, 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 /sdcardsize=<size> . You must clear the existing card image using /clear-sdcard 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 command. The BlackBerry Smartphone Simulator inserts the media card when the BlackBerry Smartphone Simulator unless you specify /no-sdcard-inserted.

Change the media card 1. 2.

On the Simulate menu, click Change SD Card. Complete one of the following tasks: Task Steps Specify a new media card. In the Current SD Card list, click a media card. To specify no card, click None. Add a media card to the Current a. In the SD Card dialog box, click Add SD Image. SD Card list from a file. b. Navigate to the location of the media card image file.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Task

Create a new media card.

Delete a media card 3.

Steps c.

Click the media card image file.

Click Open.

In the SD Card dialog box, click Mount Directory.

Navigate to the location where you want to save the media card image.

Click OK.

In the Current SD Card list, click the media card.

Click Yes.

Click Close.

Format of a simulated media card You can create a file folder to simulate a media card for use with the BlackBerry® Smartphone Simulator in either standard Windows® format, or in ISO® media card image format. • When you use Windows format, the BlackBerry Smartphone Simulator uses a standard file folder as the simulated media card. The format is the same between the desktop computer and the simulated smartphone. • When you use ISO media card image format, the BlackBerry Smartphone Simulator uses an image file as the simulated media card. The BlackBerry Smartphone Simulator reads the simulated media card when it starts. If you want to add a media file to the simulated media card, you must add it before starting the BlackBerry Smartphone Simulator.

Simulating a computer connection Use the BlackBerry® Smartphone Simulator to simulate a serial or USB connection between the BlackBerry device and the BlackBerry® Desktop Software. Typically, you simulate a serial port connection for BlackBerry devices that use a cradle, and a USB connection for BlackBerry devices that do not use a cradle. After you set this option, you can perform any of the BlackBerry® Desktop Manager operations, such as loading applications onto the BlackBerry device that you simulate.

Simulate a USB connection to the computer Simulating a USB cable connection enables you to connect the BlackBerry® Smartphone Simulator to the BlackBerry® Desktop Manager. This option is only available for BlackBerry device models that do not use a cradle. By default, the USB cable is not connected. 1. 2. 3.

In the BlackBerry Desktop Manager window, on the Options menu, click Connection options. In the Connection Type drop-down list, click USB. Click Simulation.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

To connect or disconnect the USB cable, set the USB cable connected option.

Simulating BlackBerry Enterprise Server APIs and IT policies To test applications that use BlackBerry® Enterprise Server Extension API, applied IT policies, email and browser messaging, HTTP/TCP connections, or push functionality, use the BlackBerry Smartphone Simulator to connect to an account on a BlackBerry Enterprise Server. The BlackBerry Smartphone Simulator requires the BlackBerry Enterprise Server, BlackBerry® Desktop Manager and BlackBerry® Device Manager must be version 4.0 or later.

Using the BlackBerry Smartphone Simulator in secure mode By default, the BlackBerry® Smartphone Simulator does not check for required code signatures and it does not prompt you before connecting to the network. Before you deploy your application, test it in secure mode using the BlackBerry Smartphone Simulator. When you enable BlackBerry Smartphone Simulator security, you cannot use the .cod files that come with the BlackBerry Smartphone Simulator. You must use the .cod files that are installed on the actual BlackBerry device. To obtain the appropriate .cod files, copy BlackBerry device .cod files from your computer to the BlackBerry Smartphone Simulator installation folder. By default, the installation folder exists in the following location: C:\Program Files\Common Files\Research In Motion \Shared\Loader Files\Handheld\Java.

Enable secure mode Set the /secure option when you start the BlackBerry® Smartphone Simulator. For example, type the following command: fledge /handheld=7730 /secure

View the event log The event log window displays information about events that occur between a simulated BlackBerry® device and its environment. The BlackBerry Smartphone Simulator logs event messages for events including when you simulate playing audio files, placing a phone call, and blinking the LED screen. From the Tools menu, click Show Event Log.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Changing the BlackBerry device orientation BlackBerry速 touch screen smartphones support displaying screen information in either landscape or portrait mode, depending on how the physical device is oriented. Orientation mode Top-Side-Up Left-Side-Up Right-Side-Up Bottom-Side-Up Front-Side-Up Back-Side-Up

Description The device is oriented normally. The device is rotated 90 degrees to the right. The device is rotated 90 degrees to the left. The device is rotated 180 degrees, upside-down. The device screen is facing upward. The device screen is facing downward.

Change screen orientation Use the BlackBerry速 Smartphone Simulator to simulate a screen orientation change. 1. 2.

On the Simulate menu, click Tilt BlackBerry. Select an orientation mode for the BlackBerry速 screen.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Testing applications using the BlackBerry Smartphone Simulator

Test MIDlets If the MIDlet is contained in .jad and .jar files, you need to convert these files to a .cod file before loading the .cod file to the BlackBerry® Smartphone Simulator. You can use the BlackBerry® MDS Simulator to convert the .jad and .jar files to a .cod file. 1. 2. 3. 4. 5. 6.

Place the .jad and .jar files on a web server. Start the BlackBerry MDS Simulator. Start the BlackBerry Smartphone Simulator. On the BlackBerry Smartphone Simulator screen, click the Browser icon. Use the browser to navigate to the location of the application .jad file. Download the .jad file to the BlackBerry Smartphone Simulator.

After you finish: The BlackBerry Smartphone Simulator will automatically load the .cod file on start up. See the BlackBerry Java Development Environment Development Guide for more information about converting .jad and .jar files.

Testing GPS applications You may test GPS applications using the BlackBerry® Smartphone Simulator. A GPS application on the BlackBerry Smartphone Simulator can access GPS data such as the direction, the speed, and the number of visible satellites (satellites provide GPS information). The GPS application the BlackBerry Smartphone Simulator and should function the same as when the GPS application runs on a BlackBerry device. The currently simulated location determines the number of satellites that are visible. When you create a new location, the value you specify in the Visible satellites field becomes the default value for that field.

Testing JavaScript and webpages In order to test the appearance of a webpage on the BlackBerry® Browser, you must save the file as a BlackBerry® WebWorks™ application before you run it in the BlackBerry® Smartphone Simulator.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Server Extension Application Programming Interface (API), and applied IT policies. This option requires knowledge of BlackBerry Enterprise Server administration, and introduces network dependency to testing. You will not require a BlackBerry® MDS Simulator or an BlackBerry® Email Simulator.

Test a BlackBerry Smartphone Simulator with a BlackBerry Enterprise Server 1. 2. 3. 4.

From the BlackBerry® Java® Development Environment (BlackBerry IDE) or from the start menu, run the BlackBerry Smartphone Simulator. On the Home screen, click the Turn Wireless Off icon. From the taskbar, click Start > Programs > BlackBerry > Desktop Manager. From the BlackBerry Smartphone Simulator taskbar, perform one of the following actions: • Click Simulate > USB Connected. • Click Simulate > Serial Connected.

5. 6. 7.

Click Yes. Follow the instructions to generate a new encryption key. In the Initial Plug-in: Verifying Applications dialog box, click Cancel.

After you finish: When the initial synchronization with the computer is complete, the enterprise activation starts. You will then be able to simulate use of the BlackBerry® Enterprise Server Extension API, applied IT policies, email traffic, browser traffic, HTTP/TCP connections, BlackBerry Application Mobility Suite, and push functionality.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Testing applications that require an HTTP connection

The BlackBerry® MDS Simulator is designed to simulate the BlackBerry MDS Connection Service component of the BlackBerry® Enterprise Server. Using the BlackBerry Smartphone Simulator with the BlackBerry MDS Simulator enables you to test network, push, and browser applications that are designed for use with a BlackBerry Enterprise Server. If you are testing applications that require an HTTP connection, you will require the BlackBerry Smartphone Simulator and the BlackBerry MDS Simulator. You can download the BlackBerry Smartphone Simulator and the BlackBerry MDS Simulator by visiting www.blackberry.com/developers/downloads.

Start the BlackBerry MDS Simulator and verify that it is running Before you begin: You must stop the Email service if it is running. 1. 2. 3. 4. 5. 6. 7.

On the taskbar, click Start > Programs > Research In Motion > BlackBerry Email and MDS Services Simulators > MDS. Start the BlackBerry® Smartphone Simulator. In the BlackBerry Smartphone Simulator, open the BlackBerry Browser. Open the menu. Click Go To. Type http://www.blackberry.com/go/mobile/. Click OK. If the BlackBerry home page appears, the BlackBerry® MDS Simulator is working.

After you finish: For possible causes of the BlackBerry MDS Simulator not starting correctly and their resolutions, visit www.blackberry.com/go/developerkb to read the Developer Knowledge Base article DB-00054 Mobile Data Service Simulator does not launch.

Connecting the BlackBerry Smartphone Simulator to BlackBerry Enterprise Server or a BlackBerry MDS Simulator on the same computer Due to a security enhancement in the BlackBerry® MDS Simulator, you must use the fully qualified computer name or IP address to establish a connection between a BlackBerry Smartphone Simulator and a BlackBerry® Enterprise Server or a BlackBerry MDS Simulator that is installed on the same computer as the BlackBerry Smartphone Simulator.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Configuring the BlackBerry MDS Simulator simulator The default values for the BlackBerry® MDS Simulator parameters are appropriate in most cases; however, you can change parameters to set the following features: • • • • •

logging HTTP support HTTPS support push support email-to-PIN mappings.

In a production environment, the BlackBerry® Enterprise Server system administrator sets the BlackBerry MDS Connection Service parameters using the BlackBerry device management software. Contact your system administrator for more information.

Configure BlackBerry MDS Simulator properties 1. 2.

In a text editor, open the rimpublic.property file from the Program Files\Research In Motion\BlackBerry Email and MDS Services Simulators 4.1.2\MDS\config\ folder. Configure the file settings as necessary.

Restart the BlackBerry® MDS Simulator.

BlackBerry MDS Simulator logging properties Property Logging.file.log.level

Description Specify the type of information to record, if you enable logging:

•

Logging.console.log.level

1 — logs information about events only, such as connection service start or stop • 2 — logs events and errors • 3 — logs events, errors, and warnings • 4 — logs events, errors, warnings and debug messages Specify the type of information that appears in the console, if you enable logging. See the description for the Logging.level property.

Default

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Property application.handler.http.l ogging application.handler.http. logging.verbose

Description Default Set to TRUE or FALSE to enable or FALSE disable HTTP standard logging (HTTP headers only). Set to TRUE or FALSE to enable or FALSE disable HTTP debug logging (HTTP data as well as headers). Set this parameter to TRUE only when necessary to debug a specific problem.

BlackBerry MDS Simulator HTTP properties Property Logging.file.log.levelappl ication.handler.http.Cooki eSupport

application.handler.http.A uthenticationSupport application.handler.http.A uthenticationTimeout

application.handler.http.d evice.connection.timeout application.handler.http.s erver.connection.timeout application.handler.http.p roxyHost

Description To enable the connection service to store cookies on behalf of the BlackBerry速 device, set this property to TRUE. To store cookies on the BlackBerry device, set this property to FALSE. Set to TRUE or FALSE to enable or disable storage of user authentication information. If HTTP authentication is set to TRUE, specify the length of time (in milliseconds) before the authentication information becomes invalid. This timer resets whenever the user requests authentication information for a particular domain. Specify the length of time (in milliseconds) before a BlackBerry device connection attempt expires. Specify the length of time (in milliseconds) before a server connection attempt expires. This is the HTTP proxy host name.

Default TRUE

TRUE

3600000

140000

150000

You must specify a value for hostname.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Property application.handler.http.p roxyPort

application.handler.http.p roxyEnabled

Description Default This is the HTTP proxy port number. You must specify a value for This is also used by Sun hostport. implementations of HTTP URL connections. This specifies whether a proxy is You must specify a value of TRUE or enabled. FALSE.

BlackBerry MDS Simulator HTTPS properties Property application.handler.https. allowUntrustedServer

Parameter application.handler.ldap.D EFAULT_SERVER application.handler.ldap.D EFAULT_PORT application.handler.ldap.D EFAULT_QUERY application.handler.ldap.D EFAULT_LIMIT

application.handler.ldap.C OMPRESSION application.handler.ldap.l ogging UDP.receive.port

Description Default To enable the connection service to FALSE connect to untrusted servers, set this property to TRUE. To restrict access to trusted servers only, set this property to FALSE. A server is trusted if its certificate is installed on the BlackBerry MDS Server host machine. Description Specifies the default LDAP directory server to which to send LDAP queries Specifies the default port to which BlackBerry MDS Services should send LDAP queries Specifies a default LDAP query

Default

Specifies a default limit for the number of concurrent LDAP queries that BlackBerry MDS Services supports Specifies whether or not BlackBerry MDS Services supports compression of LDAP queries Specifies whether or not BlackBerry MDS Services logs all LDAP queries Specifies the port on which to listen to receive UDP packets

localhost 389

â&#x20AC;&#x201D;

TRUE

FALSE 19781

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Parameter UDP.send.default.port UDP.send.default.host

Description Default Specifies the default port on which 19780 to send UDP packets This parameter specifies the default localhost host to which to send UDP packets. This must be set to localhost.

Push support Do not change push application connection service properties. Property WebServer.listen.host

WebServer.listen.port

Description Default This property defines the computer localhost on which the connection service listens for HTTP POST requests from push applications. This property defines the port 8080 number on which the connection service listens for HTTP POST requests from push applications.

Testing push applications Configure the BlackBerry MDS Simulator to allow reliable push connections The BlackBerry速 MDS Simulator supports pushing to multiple recipients using multiple email addresses or PIN numbers. To test reliable push applications, add information to the rimpublic.properties file. 1. 2.

Open the rimpublic.property file. Add the following line to the file: push.application.reliable.ports=<####>

where <####> represents the port on which the BlackBerry device application listens for a push request.

Map the internet messaging address to the BlackBerry Smartphone Simulator PIN In a production environment, the BlackBerry速 Enterprise Server automatically maps user internet messaging addresses to the personal identification number (PIN) of their BlackBerry devices. Using the BlackBerry Smartphone Simulator, you can simulate the mapping between internet messaging addresses and PINs.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

You only need to set internet messaging address to PIN mappings if you are testing a push application. See the BlackBerry Application Developer Guide Volume 1: Fundamentals for more information. 1. 2.

Open the rimpublic.property file. In the [Simulator] section, add or change entries. Entries have the following format: Simulator.<PIN>=<host>:<port>, <email_address>

For example, the following entry assigns PIN 2100000a to email address user2100000a@pushme.com: Simulator.2100000a=localhost:81, user2100000a@pushme.com

Change the email address so that when a push application sends data to the email address, pushed data is sent to the address of the specified BlackBerry Smartphone Simulator.

After you finish: The default PIN for the BlackBerry Smartphone Simulator is 2100000a. You can change this setting using the /pin command prompt option.

Change the BlackBerry Smartphone Simulator PIN 1. 2. 3. 4.

In the BlackBerry® Integrated Development Environment, on the Edit menu, click Preferences. Click the Simulator tab. Click the General tab. In the PIN field, type the new PIN.

After you finish: The port must match the value set in the IPPP.push.listen.tcp.port parameter. The default is 81.

Testing messaging applications The BlackBerry® Email Simulator is designed to send and receive messages between the BlackBerry Smartphone Simulator and either a messaging application, such as Microsoft® Outlook®, or POP3 and SMTP servers. You do not require a BlackBerry® Enterprise Server. The BlackBerry Email Simulator is available for download from the BlackBerry Developer Zone web site at http://www.blackberry.com/developers.

Configure a POP3 and SMTP server connection 1. 2. 3. 4. 5. 40

On the taskbar, click Start > Programs > Research In Motion > BlackBerry Email and MDS Services Simulators 4.1.2 > ESS. In the BlackBerry® Email Simulator window, ensure the Connected mode option radio button is selected. In the Outgoing field, type the host name of the SMTP server that your email account uses. In the Incoming field, type the host name of the POP3 server that your email account uses. In the User name field, type the user name with which to connect to your email account.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

6. 7.

In the Password field, type the password with which to connect to your email account. In the Poll inbox field, specify how often, in seconds, the email server simulator checks your inbox for new messages. 8. In the Name field, type the name to display in outgoing messages. 9. In the Email field, type the email address to display in outgoing messages. 10. In the PIN field, type the personal information number (PIN) that the BlackBerry Smartphone Simulator uses. By default, the PIN is 0x2100000A.

Send a message 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12.

Start the BlackBerry® Email Simulator. In the BlackBerry Email Simulator window, ensure the Standalone mode option radio button is selected. Click Launch. Start the BlackBerry Smartphone Simulator. Navigate to the Messages icon. Open the Messages application. Open the menu. Click Compose Email. In the To field, type an email address. Fill in the Cc, Subject, and Body fields. Open the menu. Click Send.

Receive a message 1. 2. 3. 4. 5.

Testing BlackBerry Enterprise Server APIs and IT policies The BlackBerry® Smartphone Simulator can connect to an account on the BlackBerry® Enterprise Server. If you have access to a BlackBerry Enterprise Server, you can simulate all the functionality that is available when connecting a BlackBerry device to a BlackBerry Enterprise Server. Use this option to simulate use of the BlackBerry Enterprise Server Extension Application Programming Interface (API), and applied IT policies. This option requires knowledge of BlackBerry Enterprise Server administration, and introduces network dependency to testing. You will not require a BlackBerry® MDS Simulator or an BlackBerry® Email Simulator. 41

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Simulating BlackBerry Enterprise Server APIs and IT policies To test applications that use BlackBerry速 Enterprise Server Extension API, applied IT policies, email and browser messaging, HTTP/TCP connections, or push functionality, use the BlackBerry Smartphone Simulator to connect to an account on a BlackBerry Enterprise Server. The BlackBerry Smartphone Simulator requires the BlackBerry Enterprise Server, BlackBerry速 Desktop Manager and BlackBerry速 Device Manager must be version 4.0 or later.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Using the BlackBerry Smartphone Simulator programmatically

The BlackBerry® Smartphone Simulator controller is a command prompt tool that is used to programmatically control the BlackBerry Smartphone Simulator. Use the BlackBerry Smartphone Simulator controller commands to instruct the BlackBerry Smartphone Simulator to perform the following actions: Action Issue device commands.

Description Issue commands manipulating the BlackBerry Smartphone Simulator (for example, close the BlackBerry Smartphone Simulator, hide the BlackBerry Smartphone Simulator window). Generate external events. Simulate events generated externally from the BlackBerry device (for example, an incoming phone call, moving between GPS locations).

Start the BlackBerry Smartphone Simulator controller BlackBerry® Smartphone Simulator controller commands have the following format: fledgecontroller /session={name} [/execute={command}] [/timeout={time-in-seconds}] [/ get-sessions]

Invocation Method

Example

/execute

fledgecontroller /session=7290 /execute=BatteryLevel(5)

Standard input

fledgecontroller /session=7290 ... ... BatteryLevel(5)

Description The BlackBerry Smartphone Simulator controller issues the BatteryLevel(5) command to the BlackBerry Smartphone Simulator for the BlackBerry® 7290 of wireless devices and exits. If you do not use the /execute command, the BlackBerry Smartphone Simulator controller sends commands from standard input to the BlackBerry Smartphone Simulator. You must manually exit the BlackBerry Smartphone Simulator controller session.

Send commands to the BlackBerry Smartphone Simulator The BlackBerry® Smartphone Simulator interface reflects the commands you type. The following instructions assume that you have the BlackBerry® Java® Development Environment (BlackBerry JDE) installed on your computer. 1.

At the command prompt, type an instruction for moving to the bin directory of your BlackBerry JDE installation:

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

cd \Program Files\Research In Motion\BlackBerry JDE 4.2.0\bin

Start the BlackBerry Smartphone Simulator. For example, at the command prompt, type the following: fledge /handheld=7290

Connect the BlackBerry Smartphone Simulator controller to a running BlackBerry Smartphone Simulator: fledgecontroller /session=7290

Type a BlackBerry Smartphone Simulator controller command (one per line). For example, at the command prompt type the following: BatteryLevel(5)

Exit the BlackBerry Smartphone Simulator controller session Perform one of the following actions: Action End the session connection. End the session and close the BlackBerry® Smartphone Simulator.

Description Perform one of the following actions: • •

At the command prompt, type quit. Press CTRL+Z. At the command prompt, type exit.

BlackBerry device accessory commands Use peripheral commands to generate BlackBerry® device peripheral events. Action Peripheral command Set the charge level of the BatteryLevel (int level) battery. Set battery charging on or BatteryCharge (bool charging) off. Connect or disconnect the external headset.

HeadsetConnection (bool connected)

Parameter level : Type the charge level of the battery. charging : Type true to simulate battery charging. Set this parameter to false to simulate the battery not charging. connected : Type true to simulate a connection to the external headset. If you type false, a connection to the external headset is not simulated.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Action Hang up a remote phone. Press or release the button on the external headset.

Peripheral command RemoteCallDisconnection (string number) HeadsetClick (bool pressed)

Holster or unholster the BlackBerry device.

Holster (bool holstered)

Insert or remove the SIM card.

SimInsertion (bool inserted)

Parameter number : Type the phone number to disconnect from. pressed - When this parameter is set to true, the button appears pressed; when it is set to false, the button does not appear pressed. holstered - When this parameter is set to true, the BlackBerry device is in the holster; when it is set to false, the BlackBerry device is not in the holster. inserted - When this parameter is set to true, the SIM card is inserted; when it is set to false, the SIM card is not inserted.

Behavior and appearance commands Use application commands to control the behaviour and appearance of the BlackBerry速 Smartphone Simulator. Action Application command Display help on BlackBerry Help Smartphone Simulator controller commands. Pause the BlackBerry Pause (int time) Smartphone Simulator controller for the given time. Exit the BlackBerry Exit (bool save-flash) Smartphone Simulator.

Terminate the BlackBerry Smartphone Simulator process.

Kill

Reset the simulator. Get the ID of the BlackBerry Smartphone Simulator process.

Reset GetPid

Parameter

time : Type the the number of seconds to

pause the BlackBerry Smartphone Simulator controller. save-flash : The default value of true saves your changes to simulated flash memory before closing the BlackBerry Smartphone Simulator.

Type this command to clean up without saving simulated flash memory. If the clean up process fails, the process is terminated.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Action View or hide the main window.

Application command

Move the main BlackBerry Smartphone Simulator window to the foreground.

WindowRaise

Move the main BlackBerry Smartphone Simulator window behind all other windows. Allow another application to obtain the foreground window focus from the BlackBerry Smartphone Simulator. Load a Java® application in .cod format.

WindowLower

WindowShow (bool show = true)

Parameter show : The default value of true displays the main window. To hide the main window, set this parameter to false.

Windows will usually block this command unless the application with focus calls the AllowSetForegroundWindow API.

AllowFocusChange

LoadCod (Path filename)

filename : Type the full path to the .cod

file of the application.

Data and phone commands Use network commands to generate data and phone events. Action Network command Set network coverage NetworkCoverage (int RSSI) level. Simulate a remote phone RemoteCallAnswer that answers a call placed from the BlackBerry® device. Place a new call from a RemoteCallCreation (string remote phone to the number, presentationBlackBerry device. indicator-types presentationindicator = PI_ALLOWED)

Hang up a remote phone.

RemoteCallDisconnection (string number)

Parameter RSSI : Type the dB level, with -40 being strong and -256 being out of coverage

•

number : Type the phone number

that you want to call. •

presentation-indicator : Type a value to control the display of the caller ID. By default, this parameter is set to the constant PI_ALLOWED. number : Type the phone number to disconnect from.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Action Generate a call failure.

Network command

Parameter

RemoteCallFailure (string number, reason-types reason)

•

• Provision a supplementary service.

SupplementaryServiceProvision ing (service-types service, bool provisioned)

• •

number : Type the phone number to

use for the remote call failure simulation. reason : Type a reason for the remote call failure. service : Type the supplementary service type to simulate. provisioned - Set this parameter to true to make the service appear provisioned. Set this parameter to false to make the service appear not provisioned.

Exit the BlackBerry Smartphone Simulator controller session Perform one of the following actions: Action End the session connection. End the session and close the BlackBerry® Smartphone Simulator.

Description Perform one of the following actions: • •

At the command prompt, type quit. Press CTRL+Z. At the command prompt, type exit.

Location commands Use environment commands to control the surrounding environment of the BlackBerry® device. Action Environment command Change the GPS location of Location (double latitude, double longitude, short the BlackBerry device. altitude = 0)

Parameter • •

latitude : Type a latitude value between 89.99 and -90.00 degrees. longitude : Type a longitude value between 179.99 and -180.00 degrees.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Action

Environment command

Parameter â&#x20AC;˘

altitude : Type an altitude in

metres above (or below if negative) the WGS84 ellipsoid. By default, this parameter is set to 0.

Keyboard and event commands Use input commands to generate keyboard and input BlackBerryÂŽ device events. Action Press a key.

Input command

Release a key.

KeyRelease (key-types key)

KeyPress (key-types key)

Enter a character string StringInjection (string into the applications (even string) if characters contained in the string do not correspond to keys on the BlackBerry device). Press a pre-translated key. PreTranslatedKeyPress (char Release a pre-translated key. Press the trackwheel. Release the trackwheel. Roll the trackwheel.

Press the trackball. Release the trackball. Roll the trackball.

key) PreTranslatedKeyRelease (char key) ThumbwheelPress ThumbwheelRelease ThumbwheelRoll (int movement)

TrackballPress TrackballRelease TrackballRoll (int x-delta, int y-delta)

Parameter key : Type the key that you wish to use for a press key event. key : Type the key that you wish to use for a release key event. string : Type the character string to enter into the application.

key : Type the key that you wish to use for a press pre-translated key event. key : Type the key that you wish to use for a release pre-translated key event.

movement : Type the number of clicks to roll the thumbwheel. Type positive values to indicate downward rolls and type negative value to indicate upward rolls.

x-delta : Type the number of clicks to roll the trackball in the left or right direction. Type positive values to indicate right rolls and type negative values to indicate left rolls.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Action

Input command

Parameter y-delta : Type the number of clicks to

roll the trackball in the up or down direction. Type positive values to indicate upward rolls and type negative values to indicate downward rolls.

Use BlackBerry Smartphone Simulator controller commands To view a list of commands for controlling the BlackBerry速 Smartphone Simulator, perform one of the following actions: Action Description View a list of commands On the Help menu, click Controller Command Help. from the BlackBerry Smartphone Simulator. View a list of commands At the command prompt, type help. from a command prompt. For more information on running the BlackBerry Smartphone Simulator controller, type FledgeController /help.

Using test scripts The BlackBerry速 Smartphone Simulator controller command prompt tool can be utilized within scripts for automated tests. When events inside the BlackBerry Smartphone Simulator occur, the BlackBerry Smartphone Simulator controller prints out messages. This is designed to enable you to test events that normally would only be perceived visually or audibly. Tools that automate GUI tests are not required.

Test BlackBerry Smartphone Simulator events using script 1.

Create a command file. For example, in a text file called PhoneTest.txt, type the following instructions: Pause(45) RemoteCallCreation("555-1234") Pause(2) ThumbwheelPress ThumbwheelRelease Pause(10) KeyPress(ESCAPE) Pause(2)

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

KeyRelease(ESCAPE) Exit

Save the command file in the same directory of your BlackBerry速 installation: cd \Program Files\Research In Motion\BlackBerry JDE 4.2.0\bin

Create a .bat file with instructions for starting the BlackBerry Smartphone Simulator and creating a session. For example, in a file called PhoneTest.bat, type the following instruction: start fledge.exe /c fledge-settings.conf /handheld=7290 /session=test

In the .bat file, write instructions for connecting the BlackBerry Smartphone Simulator controller to the session, inputting data from the command file and directing output to a text file. (In this example, the name of the output file is out.txt). For example: FledgeController.exe /session=test < PhoneTest.txt > out.txt

Note: .bat instructions in the example assume that you create the .bat file in the same location as the fledge.exe file. If you save the .bat file to a different location, include path location information for fledge.exe and fledgeController.exe in the .bat file. Save the .bat file in the bin directory of your BlackBerry installation: cd \Program Files\Research In Motion\BlackBerry JDE 4.2.0\bin

At a command prompt, move to the bin directory of your BlackBerry installation. For example, type: cd \Program Files\Research In Motion\BlackBerry JDE 4.2.0\bin

Start the .bat file. For example type: PhoneTest.bat

After you finish: The BlackBerry Smartphone Simulator controller starts and issues commands to the BlackBerry Smartphone Simulator. After all commands in the command file are issued, the BlackBerry Smartphone Simulator closes and messages are written to the text file. In the current example, out.txt contains the following messages: FledgeController.exe /session=test < PhoneTest.txt > out.txt Audio: alert stopped Connecting to Fledge session "test"... connected. Buzzer: alert started Buzzer: alert stopped Audio: alert started Disconnected

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Troubleshooting

The BlackBerry Smartphone Simulator takes a long time to start Possible cause After the BlackBerry® Smartphone Simulator loads, the BlackBerry Smartphone Simulator loads the BlackBerry® Java® Virtual Machine and the .cod files. If you had to end the If the account cannot save to the default folder, the BlackBerry® Smartphone Simulator saves user settings to <user_temporary_folder> program unexpectedly or if you have never run this version of the simulator program on your computer before, the simulator must also link the files of the simulated file system together and to the BlackBerry Smartphone Simulator.

Possible solution Avoid recreating and linking the file system. If possible, do not delete any *.dmp files in the folder that contains the BlackBerry Smartphone Simulator.

Possible solution Load a .cod file while the BlackBerry Smartphone Simulator runs, with File > Load BlackBerry Application or Theme.

I have a JVM error 543 Possible cause The file system is from a previous instance of the BlackBerry® Smartphone Simulator.

Possible solution

Try one of the following: • From the BlackBerry Smartphone Simulator, select File > Reset. • At the command prompt, add the /reset-filesystem option to the command line. • Delete the *.dmp files.

Files in the BlackBerry Smartphone Simulator File *.alx <versionnumber>.bat *.dmp *.debug clean.bat fledge.dat

Description Desktop deployment files for each application Batch file to start the BlackBerry® Smartphone Simulator Dump files, the simulated file system and, if it exists, the media card Debugging versions of the files Batch file to clean up the simulator folder BlackBerry Smartphone Simulator program and essential files 51

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

File fledge.exe

Description

fledgeversionnumber.dll fledgeextractor.exe fledgelauncher.exe fledge-user.chm fledgecontroller.dll fledgecontroller.exe ide-update.bat _manifest Java\*.cod

BlackBerry Smartphone Simulator launcher, useful if you create simulator profiles BlackBerry Smartphone Simulator user help file BlackBerry Smartphone Simulator controller files, for issuing commands through the BlackBerry® Java® Development Environment Batch file to update the the IDE.jar file of the BlackBerry JDE with newer BlackBerry Smartphone Simulator options Master list of files, used when cleaning the directory Application .cod files

The location of user settings The computer operating system determines the location of the files that contain the settings for the user. For all operating systems, if the account cannot save to the default folder, the BlackBerry® Smartphone Simulator saves user settings to <user_temporary_folder>. Operating system Windows® XP and Windows Vista® Windows® 7

Location C:\Documents and Settings\<user_name>\net\rim\fledge-2\*.conf C:\Users\<user_name>\net\rim\fledge-2\*.conf

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Provide feedback

To provide feedback on this deliverable, visit www.blackberry.com/docsfeedback.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

Legal notice

息2011 Research In Motion Limited. All rights reserved. BlackBerry速, RIM速, Research In Motion速, and related trademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S. and countries around the world. Casira End Point is a trademark of Bluetooth Designer. Java is a trademark of Sun Microsystems, Inc. Microsoft, Outlook, and Windows are trademarks of Microsoft Corporation.All other trademarks are the property of their respective owners. This documentation including all documentation incorporated by reference herein such as documentation provided or made available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition, endorsement, guarantee, representation, or warranty of any kind by Research In Motion Limited and its affiliated companies ("RIM") and RIM assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in this documentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation may describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information that is contained in this documentation; however, RIM makes no commitment to provide any such changes, updates, enhancements, or other additions to this documentation to you in a timely manner or at all. This documentation might contain references to third-party sources of information, hardware or software, products or services including components and content such as content protected by copyright and/or third-party web sites (collectively the "Third Party Products and Services"). RIM does not control, and is not responsible for, any Third Party Products and Services including, without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Services in this documentation does not imply endorsement by RIM of the Third Party Products and Services or the third party in any way. EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NONPERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHER OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE OR STRICT LIABILITY. THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B) TO RIM AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS. IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE, AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY ARISING FROM OR RELATED TO THE DOCUMENTATION. Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your airtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internet browsing functionality with a subscription to the BlackBerry速 Internet Service. Check with your service provider for availability, roaming arrangements, service plans and features. Installation or use of Third Party Products and Services with RIM's products and services may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third party rights. You are solely responsible for determining whether to use Third Party Products and Services and if any third party licenses are required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products and Services until all necessary licenses have been acquired. Any Third Party Products and Services that are provided with RIM's products and services are provided as a convenience to you and are provided "AS IS" with no express or implied conditions, endorsements, guarantees, representations, or warranties of any kind by RIM and RIM assumes no liability whatsoever, in relation thereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to the terms of separate licenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or other agreement with RIM. Certain features outlined in this documentation require a minimum version of BlackBerry速 Enterprise Server, BlackBerry速 Desktop Software, and/or BlackBerry速 Device Software.

RIM Confidential and Proprietary Information - Beta Customers Only. Content and software are subject to change.

The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION. Research In Motion Limited 295 Phillip Street Waterloo, ON N2L 3W8 Canada Research In Motion UK Limited Centrum House 36 Station Road Egham, Surrey TW20 9LF United Kingdom Published in Canada