blackberry smart phone simulator development guide 1001926 0406042642 001 5.0 us

56
BlackBerry Smartphone Simulator Version: 5.0 Development Guide

Upload: sunilcomguy9890

Post on 10-Apr-2015

292 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

BlackBerry Smartphone SimulatorVersion: 5.0

Development Guide

Page 2: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

SWD-1001926-0406042642-001

Page 3: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Contents1 Overview....................................................................................................................................................................................... 5

2 Installation and Configuration.................................................................................................................................................. 6

Installing the BlackBerry Email and MDS Services Simulator Package................................................................................... 6

Download the BlackBerry Email and MDS Services Simulator Package.................................................................................. 6

Install the BlackBerry Email and MDS Services Simulator Package......................................................................................... 6

Install the Java SE Development Kit............................................................................................................................................. 7

Changing configuration options................................................................................................................................................... 7

Managing BlackBerry device profiles........................................................................................................................................... 8

Create a BlackBerry device profile....................................................................................................................................... 8

Edit a BlackBerry device profile............................................................................................................................................ 8

Copy a BlackBerry device profile.......................................................................................................................................... 8

Rename a BlackBerry device profile..................................................................................................................................... 9

Delete a BlackBerry device profile....................................................................................................................................... 9

Starting the BlackBerry Smartphone Simulator.......................................................................................................................... 9

Start the BlackBerry Smartphone Simulator from the BlackBerry Smartphone Simulator launcher........................... 9

Start the BlackBerry Smartphone Simulator from the BlackBerry JDE............................................................................ 9

Start a BlackBerry Smartphone Simulator........................................................................................................................... 10

Start the BlackBerry Smartphone Simulator from the command prompt....................................................................... 10

Start the BlackBerry Smartphone Simulator and open a web page................................................................................. 10

Redirect debug messages to a specified file....................................................................................................................... 10

Changing BlackBerry Smartphone Simulator display options................................................................................................... 10

Show or hide the faceplate.................................................................................................................................................... 10

Display the device in full-screen mode................................................................................................................................ 10

Specify graphics acceleration............................................................................................................................................... 11

Magnify the BlackBerry device image................................................................................................................................. 11

Capturing screen shots.................................................................................................................................................................. 11

Save a screen shot.................................................................................................................................................................. 12

Copy a screen shot to the clipboard..................................................................................................................................... 12

3 Using the BlackBerry Smartphone Simulator......................................................................................................................... 13

Simulating BlackBerry device interaction.................................................................................................................................... 13

Click the screen...................................................................................................................................................................... 13

Touch the screen.................................................................................................................................................................... 13

Page 4: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Perform simultaneous screen touches................................................................................................................................. 13

Changing the BlackBerry device orientation...................................................................................................................... 13

Simulate tilting a BlackBerry device in 3-D space............................................................................................................. 14

Change screen orientation.................................................................................................................................................... 14

Use the trackball.................................................................................................................................................................... 14

Simulating convenience keys................................................................................................................................................ 15

Simulating multi-function keys............................................................................................................................................. 15

Assign a key to the Escape key............................................................................................................................................. 16

Use the trackwheel and keys................................................................................................................................................ 16

BlackBerry Device Software applications..................................................................................................................................... 17

Use the contact list................................................................................................................................................................ 17

Use the calendar.................................................................................................................................................................... 17

Compose an email.................................................................................................................................................................. 17

Simulate an incoming call..................................................................................................................................................... 18

Simulate an outgoing call...................................................................................................................................................... 18

Using voice activated dialing................................................................................................................................................ 19

Use the touch screen............................................................................................................................................................. 19

Use text messaging................................................................................................................................................................ 20

Using the camera................................................................................................................................................................... 20

Recording video...................................................................................................................................................................... 22

Simulate a GPS receiver........................................................................................................................................................ 23

Simulating GPS location information.................................................................................................................................. 23

Managing GPS routes............................................................................................................................................................ 24

Changing BlackBerry device operating conditions..................................................................................................................... 26

Use a single button headset................................................................................................................................................. 26

Use a multiple button headset............................................................................................................................................. 26

Disconnect a headset............................................................................................................................................................. 27

Change holster conditions.................................................................................................................................................... 27

Use a flip device..................................................................................................................................................................... 27

Simulate battery conditions.................................................................................................................................................. 27

Simulate the absence of a SIM card..................................................................................................................................... 27

Simulating network conditions............................................................................................................................................. 28

Simulate supplementary services......................................................................................................................................... 29

Reset the flash memory......................................................................................................................................................... 29

Simulating flash memory....................................................................................................................................................... 29

Page 5: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Simulating a media card........................................................................................................................................................ 30

Simulating a computer connection...................................................................................................................................... 31

Simulating BlackBerry Enterprise Server APIs and IT policies.......................................................................................... 31

Using the BlackBerry Smartphone Simulator in secure mode.......................................................................................... 31

View the event log.................................................................................................................................................................. 32

4 Testing applications using the BlackBerry Smartphone Simulator..................................................................................... 33

Testing GPS applications............................................................................................................................................................... 33

Test MIDlets..................................................................................................................................................................................... 33

Testing applications that require an HTTP connection.............................................................................................................. 33

Start the BlackBerry MDS Simulator and verify that it is running.................................................................................... 34

Connecting the BlackBerry Smartphone Simulator to BlackBerry Enterprise Server or a BlackBerry MDS Simulator

on the same computer........................................................................................................................................................... 34

Configuring the BlackBerry MDS Simulator simulator...................................................................................................... 34

Testing push applications...................................................................................................................................................... 38

Testing messaging applications.................................................................................................................................................... 39

Configure a POP3 and SMTP server connection................................................................................................................ 40

Send a message...................................................................................................................................................................... 40

Receive a message................................................................................................................................................................. 40

Testing BlackBerry Enterprise Server APIs and IT policies......................................................................................................... 41

Test a BlackBerry Smartphone Simulator with a BlackBerry Enterprise Server.............................................................. 41

5 Using the BlackBerry Smartphone Simulator programmatically......................................................................................... 42

Start the BlackBerry Smartphone Simulator controller.............................................................................................................. 42

Send commands to the BlackBerry Smartphone Simulator....................................................................................................... 43

Exit the BlackBerry Smartphone Simulator controller session.................................................................................................. 43

Using test scripts............................................................................................................................................................................ 44

Test BlackBerry Smartphone Simulator events using script............................................................................................. 44

Use BlackBerry Smartphone Simulator controller commands.................................................................................................. 45

Behavior and appearance commands.................................................................................................................................. 46

Location commands............................................................................................................................................................... 47

Keyboard and event commands........................................................................................................................................... 47

Data and phone commands.................................................................................................................................................. 49

BlackBerry device accessory commands............................................................................................................................. 49

6 Provide feedback......................................................................................................................................................................... 51

Page 6: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

7 Legal notice.................................................................................................................................................................................. 52

Page 7: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Overview 1

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 BlackBerrydevices and enables you to load and test your own applications. You can simulate and test various connectivity and state changesusing the BlackBerry Smartphone Simulator. When you use the BlackBerry Smartphone Simulator to perform testing, you mightneed to simulate additional BlackBerry services. The BlackBerry MDS Simulator and the BlackBerry Email Simulator are availablefor this purpose.

Development Guide Overview

5

Page 8: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Installation and Configuration 2

Installing the BlackBerry Email and MDS Services Simulator PackageYou can use the BlackBerry® Email and MDS Services Simulator Package to simulate network connectivity when you want tosimulate email, messaging, or internet browsing using a BlackBerry® Smartphone Simulator.

Download the BlackBerry Email and MDS Services Simulator Package1. In your browser, navigate to www.blackberry.com/developers/downloads.

2. Under Java Application Development, click BlackBerry Smartphone Simulators.

3. In the drop-down list, click the BlackBerry® Email and MDS Services Simulator Package. Click Next.

4. Locate the latest installation file. Click Download.

5. Complete the information on the screen. Click Next.

6. Accept or decline the download agreement. Click Next.

7. On the Software Download for Device Simulators web page, click Download.

8. In the File Download dialog box, click Save.

9. 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 PackageBefore you begin:

To use the BlackBerry® Email and MDS Services Simulator Package you must install the Java® SE Development Kit on yourcomputer. If you do not have the Java SE Development Kit installed on your computer, the BlackBerry Email and MDS ServicesSimulator Package installation file prompts you to download and run the setup application.

1. On the taskbar, click Start > Run.

2. In the Run dialog box, click Browse.

3. Navigate to the location where you saved the BlackBerry Email and MDS Services Simulator Package installation file.

4. Select the installation file. Click Open.

5. Click OK.

6. In the Open File dialog box, click Run.

7. If the Prerequisites Wizard appears, click Next and complete one of the following tasks:

Development Guide Installation and Configuration

6

Page 9: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Task Steps

Install the Java SE Development Kit a. Click Next.

b. Complete the instructions on the screen.

c. In the BlackBerry Email and MDS Services Simulator Package Setup

dialog box, click Finish.

Skip the installation of the Java SE

Development Kit

Click Finish.

8. In the BlackBerry Email and MDS Services Simulator Package Setup Wizard dialog box, click Next.

9. Accept or decline the license agreement. Click Next.

10. In the Select Installation Folder dialog box, click Next.

11. In the Ready to Install dialog box, click Install.

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

Install the Java SE Development KitBefore you begin:

You must download the latest version of the Java® SE Development Kit (JDK). To download the Java SE Development Kit, visitwww.oracle.com

1. Navigate to the location where you saved the Java SE Development Kit installation file, and double-click the installation file.

2. Complete the instructions on the screen to complete the installation.

Changing configuration optionsBy default, after you specify the BlackBerry® device model, the BlackBerry Smartphone Simulator runs using the configurationoptions 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 the BlackBerry® Integrated

Development Environment (BlackBerry

IDE)

You can configure many of the simulator options from the BlackBerry IDE interface

and save them as a new device simulator profile. See the BlackBerry Integrated

Development Environment Online Help for more information about setting and

saving BlackBerry Smartphone Simulator options using the BlackBerry IDE.

Development Guide Install the Java SE Development Kit

7

Page 10: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Configuration method Description

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 BlackBerry device profiles

Create a BlackBerry device profile1. In the BlackBerry® Smartphone Simulator, double-click the fledgelauncher.exe file.

2. In the drop-down list, select Create a new simulator profile.

3. In the Software version drop-down list, select the software version.

4. In the Handheld model drop-down list, select the BlackBerry® device you want to use.

5. In the Profile name field, type a name for this profile.

6. Click Configure.

7. In the Edit simulator profile dialog box, on the Hardware tab, specify the hardware settings for this BlackBerry SmartphoneSimulator.

8. On the Network tab, specify the network settings.

9. On the Advanced tab, specify advanced settings such as LCD timeout, and add command line arguments for the BlackBerrySmartphone Simulator.

10. Click OK.

Edit a BlackBerry device profile1. In the BlackBerry® Smartphone Simulator directory, double-click the fledgelauncher.exe file.

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

3. In the Profile list, select the profile you want to edit.

4. Click Edit.

5. In the Edit simulator profile dialog box, change the settings.

6. Click OK.

Copy a BlackBerry device profile1. In the BlackBerry® Smartphone Simulator directory, double-click the fledgelauncher.exe file.

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

Development Guide Managing BlackBerry device profiles

8

Page 11: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

3. In the Profile list, select the profile you want to copy.

4. Click Copy.

Rename a BlackBerry device profile1. In the BlackBerry® Smartphone Simulator directory, double-click the fledgelauncher.exe file.

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

3. In the Profile list, select the profile you want to copy.

4. Click Rename.

5. Type a new name.

6. Press Enter.

Delete a BlackBerry device profile1. In the BlackBerry® Smartphone Simulator directory, double-click the fledgelauncher.exe file.

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

3. In the Profile list, select the profile you want to delete.

4. Click Delete.

Starting the BlackBerry Smartphone SimulatorThe BlackBerry® Smartphone Simulator is available either as a part of the BlackBerry® Java® Development Environment or as astandalone installation of the BlackBerry simulator package. Visit www.blackberry.com/developers for more information aboutdownloading the BlackBerry Smartphone Simulator.

Start the BlackBerry Smartphone Simulator from the BlackBerry Smartphone Simulatorlauncher1. In the BlackBerry® Smartphone Simulator directory, launch fledgelauncher.exe.

2. In the drop-down list, select Launch a simulator.

3. In the Profile list, select the profile.

4. Click Go.

Start the BlackBerry Smartphone Simulator from the BlackBerry JDEOn the taskbar, click Start --> Programs --> Research In Motion --> BlackBerry JDE 4.7.x --> Device Simulator

Development Guide Starting the BlackBerry Smartphone Simulator

9

Page 12: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Start a BlackBerry Smartphone SimulatorOn the taskbar, click Start --> Programs --> Research In Motion --> BlackBerry Smartphone Simulators 4.x.x --> DeviceSimulators 4.x.x --> device_name

Start the BlackBerry Smartphone Simulator from the command promptAt the command prompt, type:

fledge /handheld=<model_number>

Start the BlackBerry Smartphone Simulator and open a web pageAt the command prompt, type:

fledge /handheld=<model_number> /app-param=url:<URL> /app=jvm.dll

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

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

Changing BlackBerry Smartphone Simulator display options

Show or hide the faceplateBy default, the BlackBerry® Smartphone Simulator displays the BlackBerry device faceplate. You can hide the faceplate so thatonly the screen is visible.

On the View menu, click LCD Only.

Display the device in full-screen modeFull-screen mode allows you to maximize the view of the BlackBerry® Smartphone Simulator. You can view either the fullBlackBerry device faceplate or only the screen in full-screen mode. Since the BlackBerry Smartphone Simulator only uses integralmultiples of the simulated screen resolution, different screen resolution settings may result in full-screen images that cover alarger percentage of the computer screen.

Development Guide Changing BlackBerry Smartphone Simulator display options

10

Page 13: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

If you are viewing the LCD screen in full-screen mode, the LCD screen stretches to its optimal zoom-level and is padded with ablack background. If you view the BlackBerry device image in full-screen mode, the BlackBerry device image is centered and ispadded with a white background.

1. On the View menu, click Full Screen.

2. To access menu options, move the mouse to the top of the computer screen. The menu appears when the cursor is near thetop of the screen.

3. To exit full-screen mode, on the View menu, click Full Screen.

Specify graphics accelerationYou can use graphics acceleration to help improve the graphics quality in the BlackBerry Smartphone Simulator. You can choosefrom 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. On the View menu, click Graphics Acceleration.

2. 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 imageThe percentage value determines the pixel-to-pixel ratio between the simulated LCD screen and the computer screen. Forexample, 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.

2. Click a percentage.

3. On the View menu, click Smooth Magnified LCD.

Capturing screen shotsThe BlackBerry® Smartphone Simulator can save an image of the BlackBerry device that you simulate including the faceplate,or the screen only.

Development Guide Capturing screen shots

11

Page 14: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

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 theLCD 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 shotOn the Edit menu, click Save Device Snapshot or Save LCD Snapshot.

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

Development Guide Capturing screen shots

12

Page 15: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Using the BlackBerry Smartphone Simulator 3

Simulating BlackBerry device interaction

Click the screenUse the BlackBerry® Smartphone Simulator to simulate a screen click.

Click the left mouse button anywhere within the device screen area.

Touch the screenUse the BlackBerry® Smartphone Simulator to simulate a screen touch.

Click the right mouse button anywhere within the device screen area.

Perform simultaneous screen touchesUse the BlackBerry® Smartphone Simulator to simulate multiple screen touches at the same time.

1. On the Simulate menu, click Multitouch Mode.

2. Click and drag using either the left or right mouse buttons anywhere within the device screen area.

3. Perform the same action elsewhere on the screen to complete the multitouch action.

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

Changing the BlackBerry device orientationBlackBerry® Storm™ 9500 smartphones support displaying screen information in either landscape or portrait mode, dependingon how the physical device is oriented.

Orientation mode Description

Top-Side-Up The device is oriented normally.

Left-Side-Up The device is rotated 90 degrees to the right.

Right-Side-Up The device is rotated 90 degrees to the left.

Bottom-Side-Up The device is rotated 180 degrees, upside-down.

Front-Side-Up The device screen is facing upward.

Development Guide Using the BlackBerry Smartphone Simulator

13

Page 16: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Orientation mode Description

Back-Side-Up The device screen is facing downward.

Simulate tilting a BlackBerry device in 3-D spaceYou can use the tilt feature to view the rotation and tilt of a BlackBerry® device in 3-D space.

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 for a BlackBerry device with an accelerometer

1. On the Simulate menu, click Tilt BlackBerry.

2. Place the mouse pointer at a corner of the device.

The mouse pointer changes to an image of a device.

3. To rotate and tilt the device, press and hold the left mouse button while moving the mouse.

4. To stop rotating and tilting the device, release the mouse button.

Change screen orientationUse the BlackBerry® Smartphone Simulator to simulate a screen orientation change.

1. On the Simulate menu, click Tilt BlackBerry.

2. Select an orientation mode for the BlackBerry® screen.

Use the trackballUse 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 Handheldkeyboard and mouse actions to the following BlackBerry Wireless Handheld functionality:

Development Guide Simulating BlackBerry device interaction

14

Page 17: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Task Keyboard steps Mouse steps with trackball

mode on

Mouse steps with trackball

mode off

Turn trackball mode on or off. Press F12. 1. On the Edit menu, click

Map Middle Mouse

Button > Toggle

Trackball Mode

2. Click the middle mouse

button.

1. On the Edit menu, click

Map Middle Mouse

Button --> Toggle

Trackball Mode.

2. Click the middle mouse

button.

Click the trackball. Press F9. Click the left mouse button. Click the middle mouse

button on the trackball.

Roll the trackball. Press the arrow keys. Move the mouse. Click and drag the mouse on

the trackball.

Press the Escape button. Press ESC. Click the right mouse button. Click the right mouse button

on the trackball.

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

Simulating convenience keysSome BlackBerry® smartphones contain additional keys that are not present on other BlackBerry models. The BlackBerrySmartphone Simulator assigns the device keys to the following computer keyboard procedures:

Active Key Steps

Front Convenience key Press Insert.

Side Convenience key Press PAGE UP.

Currency symbol key (BlackBerry® 8700 Series only) Press F5.

Speaker phone key (BlackBerry® 8700 Series only) Press F6.

Simulating multi-function keysSome BlackBerry® smartphones contain additional keys that are not present on other BlackBerry models. The BlackBerrySmartphone Simulator assigns the device keys to the following computer keyboard procedures:

Development Guide Simulating BlackBerry device interaction

15

Page 18: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Active Key Steps

Menu key Press Insert.

Right Side Convenience key Press \.

Left Side Convenience key Press PAGE UP.

Volume Up key Press F8

Volume Down key Press F7.

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

1. On the Edit menu, click Map Cursor Key to Escape.

2. Select Left or Right.

Use the trackwheel and keysUse the BlackBerry® Smartphone Simulator trackwheel to simulate using the trackwheel on a BlackBerry® device. Note that notall 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 mouseprocedures:

Task Keyboard steps Mouse steps

Roll the trackwheel. Press the UP ARROW or DOWN ARROW

key.

Roll the mouse wheel button.

Click the trackwheel. Press the LEFT ARROW key. Click the mouse wheel button.

Press the Escape key. Press ESC or the RIGHT ARROW key. Click the right mouse button.

Turn on BlackBerry device backlighting. Press PAGE DOWN. Click the Power button on the

BlackBerry Smartphone Simulator

keyboard.

Press the Symbol key. Press DELETE. Click the Symbol key on the BlackBerry

Smartphone Simulator keyboard.

Press the Alt key. Press CTRL. Click the Alt key on the BlackBerry

Smartphone Simulator keyboard.

Development Guide Simulating BlackBerry device interaction

16

Page 19: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Task Keyboard steps Mouse steps

Press the BlackBerry device keys. Press the keys on your computer

keyboard.

Click the keys on the BlackBerry

Smartphone Simulator keyboard.

Press the phone/PTT (Push to Talk)

button.

Press PAGE UP. —

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 computerkeyboard.

BlackBerry Device Software applications

Use the contact list1. Open Address Book.

2. On the Address Book menu, click New Address.

3. Type contact information in the appropriate fields.

4. Open the menu.

5. Click Save.

Use the calendar1. Open Calendar.

2. In the Calendar menu, click New.

3. Type appointment information in the appropriate fields the New Appointment screen.

4. Open the menu.

5. Click Save.

Compose an email1. Open Messages.

2. In the Messages menu, click Compose Email.

3. In the To field, type an email address.

4. Set the Cc, Subject, and Body fields.

5. Open the menu.

Development Guide BlackBerry Device Software applications

17

Page 20: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

6. Click Save Draft

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

Simulate an incoming call1. On the Simulate menu, click Incoming Voice Call.

2. In the New Incoming Call dialog box, for the originating phone number, type a new phone number or the phone numberof an existing contact.

3. Set one of the following Caller ID options:

Option Description

Allowed The BlackBerry® device can display the phone number of the originating phone.

Private The phone number of the originating phone is blocked and not available for display on

the BlackBerry device.

Unknown The BlackBerry device cannot determine the phone number of the originating phone.

4. To place the phone call to the BlackBerry Smartphone Simulator, click Create Call.

5. Click Answer or Ignore.

6. End the call by performing one of the following actions:

Task Steps

Simulate the termination of the call by the originating

phone.Click Disconnect.

Simulate a network failure. Set a reason for failure. Click Fail.

Simulate an outgoing call1. Open Call Log.

2. In the Call Log menu, click Call From Address Book.

3. In the Call field, type a new phone number or set a contact.

4. Press the Enter key.

5. Open the menu.

6. Click Continue.

7. In the Call to dialog box, perform one of the following actions:• Click Answer.

Development Guide BlackBerry Device Software applications

18

Page 21: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

• To simulate a failed connection, set a reason for failure. Click Fail.

Using voice activated dialing

Use voice activated dialing to make a call

1. Click the VoiceActivatedDialing icon.

2. Say “Call” and a contact name or number.

3. 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 turn voice prompts on or off

1. Click the VoiceActivatedDialing icon.

2. If prompts are turned on, say “Turn prompts off”.

3. If prompts are turned off, say “Turn prompts on”.

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

1. Click the VoiceActivatedDialing icon.

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

Use the touch screenBlackBerry® Storm™ 9500 Series smartphones support a number of touch actions, including screen touches, clicks, andsimultaneous touches.

Screen touch Description

Click A screen click is performed by gently pressing the screen until you feel a tactile response.

Development Guide BlackBerry Device Software applications

19

Page 22: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Screen touch Description

Touch A screen touch is performed by touching the screen without pressing down on it.

Multiple touch A multitouch action is performed by touching two areas on the screen at the same time.

Each individual touch might also involve sliding your finger across the screen.

Slide A slide is performed by sliding your finger across the screen during a touch action. You

can perform a slide action along with touch or multitouch actions.

Use text messagingYou can use the BlackBerry® Smartphone Simulator to simulate sending an SMS text message to a server side application. Verifythat you have installed the BlackBerry® Java® Development Environment.

1. Click the Call Log icon.

2. Type the destination phone number for the SMS text message.

3. Open the menu.

4. Click SMS <number>.

5. Type your message.

6. Open the menu.

7. Click Send.

Using the camera

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

Take a picture

1. Click the Camera icon.

2. If prompted, to save pictures to the media card on the BlackBerry® Smartphone Simulator, click Yes. To save pictures tothe BlackBerry Smartphone Simulator device memory, click No.

3. To take a picture, click the trackball.

4. To take another picture, click Take Another Picture.

Development Guide BlackBerry Device Software applications

20

Page 23: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

View a pictureWhen an application switches to camera viewfinder mode, the viewfinder displays the picture that you select using the CameraImage menu item. The viewfinder displays the file selector if no picture has been selected before. For best results, select an imageof equal or greater resolution than the camera’s maximum resolution of 1280 by 1024. If you select a picture with a higherresolution or different aspect ratio than the camera, the Camera application displays only the center of the picture.

1. On the Simulation menu, click Camera Image.

2. 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 theBlackBerry Smartphone Simulator.

Set a picture as the caller ID

1. Click Set As.

2. Click Set As Caller ID.

3. In the Username field, type the user name.

4. In the Domain field, type the domain.

5. In the Password field, type the password.

6. Click OK.

Set a picture as your Home screen background

1. Click Set As.

2. Click Set As Home Screen Image.

Rename a picture

1. Click Rename Picture.

2. In the Name field, type a new name.

3. Click OK.

Delete a picture

1. Click Delete Picture.

2. Click Delete to confirm.

Send a picture in an email message

1. Click Send Picture.

Development Guide BlackBerry Device Software applications

21

Page 24: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

2. Click Send As Email.

3. Compose the email message.

Recording video

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

Record a video

1. Click the Video Camera icon.

2. If prompted, to save videos to the media card on the BlackBerry® Smartphone Simulator, click Yes. To save pictures to theBlackBerry Smartphone Simulator device memory, click No.

3. To start recording a video, click the trackball.

4. To stop recording, click the trackball.

View a video

1. Click the Video Camera icon.

2. Click the Menu key.

3. Click View Videos.

Set video recording options

1. Click the Video Camera icon.

2. Click the Menu key.

3. Click Options.

4. Perform any of the following actions:

Task Steps

Set the video light. Specify the Video Light option.

Set the color effect Specify the Color Effect option.

Set the video resolution. Specify the Video Format action.

Development Guide BlackBerry Device Software applications

22

Page 25: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Simulate a GPS receiverA 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 thefollowing actions:

1. On the Simulate menu, click GPS Location.

2. 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 theroute, run the simulation.

A location represents one end point of a path. A route can contain one or more paths. The BlackBerry® Smartphone Simulatoremulates movement between locations on a route across one or more paths. You can create and save multiple locations that youcan simulate.

Add a GPS location

1. In the Location section, click Add.

2. In the Name field, type a name.

3. In the Latitude and Longitude fields, type a latitude and longitude.

4. In the Altitude field, type an altitude.

5. The BlackBerry® Smartphone Simulator specifies the altitude in metres above (or below) the WGS84 ellipsoid. Visitw3sli.wcape.gov.za/Surveys/Mapping/wgs84.htm for more information.

6. In the Satellites field, type the number of satellites that are visible from that location.

7. Click Save.

Change a GPS locationThe valid range for latitude is -90 to 90. The valid range for longitude is -180 to 180.

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

2. Click Edit and change the values in the appropriate fields.

Renaming a location will cause routes that contain that location to fail.

3. Click Save.

Development Guide BlackBerry Device Software applications

23

Page 26: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Delete a GPS location

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

2. 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 straightline between two adjacent locations. Each path contains information about the rate of speed used to travel between the pathstart 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 feetper second (f/s). The speed limit in terms of metres per second is 655 m/s, with respective limits set for other rates.

Create a GPS route using existing locations

1. On the Simulate menu, click GPS Location.

2. In the Route section, click Add.

3. Click existing locations.

4. Type a name for the new route

5. Select the starting location of the route.

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

7. Click Insert to insert this location into the route.

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

9. Save the route.

Create a GPS route using a data file

1. On the Simulate menu, click GPS Location.

2. In the Route section, click Add.

3. Click data from a file.

4. From the Import Route dialog-box, select a data file.

5. Type a name for the data file.

6. Save the route.

Create a GPS route using random data

1. On the Simulate menu, click GPS Location.

Development Guide BlackBerry Device Software applications

24

Page 27: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

2. In the Route section, click Add.

3. Select Create route using random route generator.

4. Click OK.

5. In the new dialog, specify the route name, the number of legs, the duration of the route (in seconds), as well as a start andend location. If you generated the route successfully, the New Route dialog displays the route information that you typedin step 3.

Change a GPS route

1. On the Simulate menu, click GPS Location.

2. Set a route to change.

3. Perform one or more of the following procedures:

Task Steps

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

Add a location to the route. a. Click Insert.

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

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

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

change.

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

change to.

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

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

b. Click Delete.

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

5. Click Save.

Delete a GPS route

1. On the Simulate menu, click GPS Location.

2. In the Route drop-down list, click a route to delete.

3. Click Delete.

Development Guide BlackBerry Device Software applications

25

Page 28: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

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

1. On the Simulate menu, click GPS Location.

2. Perform one of the following actions:

Task Steps

Play a route. In the Route section, click the Play (right arrow) icon.

Stop a route. In the Route section, click the Stop (black square) icon.

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

Changing BlackBerry device operating conditions

Use a single button headsetPerform one of the following actions:

Task Steps

Connect a single button

headset.a. On the Simulate menu, click Headset Connected.

b. 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 headsetPerform one of the following actions:

Task Steps

Connect a multibutton

headset.a. On the Simulate menu, click Headset Connected.

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

Click a button on a

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

Development Guide Changing BlackBerry device operating conditions

26

Page 29: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Disconnect a headset1. On the Simulate menu, click Headset Connected.

2. In the Headset dialog box, select the No headset option.

Change holster conditionsWhen the BlackBerry® device is in the holster, the screen display turns off. By default, the BlackBerry device uses differentnotifications when in the holster.

On the Simulate menu, click In Holster.

Use a flip deviceWhen the BlackBerry® 8200 Series smartphone is flipped, the screen display turns off. The BlackBerry device uses the flip screento display notifications.

On the Simulate menu, click Flipped.

Simulate battery conditions1. On the Simulate menu, click Battery Properties.

2. Set one of the following options:

Option Description

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

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

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

Camera flash is disabled.

Dead The BlackBerry device turns off immediately.

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

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

Simulate the absence of a SIM cardThe 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:

Development Guide Changing BlackBerry device operating conditions

27

Page 30: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

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 weaksignal. The BlackBerry Smartphone Simulator can also simulate a loss of network coverage.

Add a network

1. On the Simulate menu, click Network Properties.

2. Click Add.

3. Type the network properties in the dialog.

4. Click OK.

Set the network signal strength

1. On the Simulate menu, click Network Properties.

2. Select the network you want to simulate from the Networks list.

3. If you want to edit the network properties, click Edit and type new values. Click OK.

4. Select or clear the In coverage check box.

5. 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. On the Simulate menu, click Network Properties.

2. In the Available Network Properties section, click a Wi-Fi network.

3. In the Global Network Properties section, move the slide bar to the interval that you want.

4. Click Close.

Development Guide Changing BlackBerry device operating conditions

28

Page 31: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Simulate supplementary servicesA number of supplementary services, such as call forwarding or call waiting, might be available on a BlackBerry® device. You cansimulate the availability of these services. The BlackBerry Smartphone Simulator is set up with all supplementary services bydefault.

1. On the Simulate menu, click Provision Supplementary Services.

2. In the Supplementary Services Provisioned dialog box, enable or disable services.

Reset the flash memory1. Close the BlackBerry® Smartphone Simulator.

2. Restart the BlackBerry Smartphone Simulator using the /clear-flash command prompt option. For example, type thefollowing:

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

After you finish: See BlackBerry Integrated Development Environment Online Help for more information on how to set thisoption using the BlackBerry Integrated Development Environment.

Simulating flash memory

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

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 memorycontents to the .dmp files.

The BlackBerry Smartphone Simulator saves changes to flash memory as you make them. To keep changes from overwriting theoriginal 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 forthe session.

Development Guide Changing BlackBerry device operating conditions

29

Page 32: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Simulating a media card

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

You must clear the existing card image using /clear-sdcard to create a new card with the specified size. If a media card imageexists, 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. On the Simulate menu, click Change SD Card.

2. Complete one of the following tasks:

Task Steps

Specify a new media card. In the Current SD Card list, click a microSD card. To specify no card, click None.

Add a media card to the Current SD

Card list from a file.a. In the SD Card dialog box, click Add File.

b. Navigate to the location of the media card image file.

c. Click the media card image file.

d. Click Open.

Create a new media card. a. In the SD Card dialog box, click Add Directory.

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

c. Click OK.

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

b. Click Yes.

3. Click Close.

Development Guide Changing BlackBerry device operating conditions

30

Page 33: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Simulating a computer connection

Use the BlackBerry® Smartphone Simulator to simulate a serial or USB connection between the BlackBerry device and theBlackBerry® Desktop Software. Typically, you simulate a serial port connection for BlackBerry devices that use a cradle, and aUSB 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 ontothe BlackBerry device that you simulate.

Simulate a USB connection to the computerSimulating a USB cable connection enables you to connect the BlackBerry® Smartphone Simulator to the BlackBerry® DesktopManager. This option is only available for BlackBerry device models that do not use a cradle. By default, the USB cable is notconnected.

1. In the BlackBerry Desktop Manager window, on the Options menu, click Connection options.

2. In the Connection Type drop-down list, click USB.

3. Click Simulation.

4. 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 BlackBerryEnterprise 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 beforeconnecting 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 BlackBerrySmartphone Simulator. You must use the .cod files that are installed on the actual BlackBerry device. To obtain the appropriate .codfiles, 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.

Development Guide Changing BlackBerry device operating conditions

31

Page 34: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

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 logThe 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, placinga phone call, and blinking the LED screen.

From the Tools menu, click Show Event Log.

Development Guide Changing BlackBerry device operating conditions

32

Page 35: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Testing applications using the BlackBerry SmartphoneSimulator

4

Testing GPS applicationsYou may test GPS applications using the BlackBerry® Smartphone Simulator. A GPS application on the BlackBerry SmartphoneSimulator can access GPS data such as the direction, the speed, and the number of visible satellites (satellites provide GPSinformation). The GPS application the BlackBerry Smartphone Simulator and should function the same as when the GPSapplication runs on a BlackBerry device.

The currently simulated location determines the number of satellites that are visible. When you create a new location, the valueyou specify in the Visible satellites field becomes the default value for that field.

Test MIDletsIf 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 theBlackBerry® Smartphone Simulator. You can use the BlackBerry® MDS Simulator to convert the .jad and .jar files to a .cod file.

1. Place the .jad and .jar files on a web server.

2. Start the BlackBerry MDS Simulator.

3. Start the BlackBerry Smartphone Simulator.

4. On the BlackBerry Smartphone Simulator screen, click the Browser icon.

5. Use the browser to navigate to the location of the application .jad file.

6. 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 applications that require an HTTP connectionThe 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 thatrequire an HTTP connection, you will require the BlackBerry Smartphone Simulator and the BlackBerry MDS Simulator. TheBlackBerry MDS Simulator is available for download from the BlackBerry Developer Zone web site at http://www.blackberry.com/developers/resources.

Development Guide Testing applications using the BlackBerry Smartphone Simulator

33

Page 36: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

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. On the taskbar, click Start > Programs > Research In Motion > BlackBerry Email and MDS Services Simulators > MDS.

2. Start the BlackBerry® Smartphone Simulator.

3. In the BlackBerry Smartphone Simulator, open the BlackBerry Browser.

4. Open the menu.

5. Click Go To.

6. Type http://www.blackberry.com/go/mobile/.

7. Click OK.

After you finish:

If the BlackBerry home page appears, the BlackBerry® MDS Simulator is working.

If the browser cannot connect to the BlackBerry MDS Simulator, verify that you started the BlackBerry MDS Simulator.

See Mobile Data Service Simulator does not launch for possible causes of the BlackBerry MDS Simulator not starting correctlyand their resolutions.

Connecting the BlackBerry Smartphone Simulator to BlackBerry Enterprise Server or aBlackBerry 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 addressto establish a connection between a BlackBerry Smartphone Simulator and a BlackBerry® Enterprise Server or a BlackBerry MDSSimulator that is installed on the same computer as the BlackBerry Smartphone Simulator.

Configuring the BlackBerry MDS Simulator simulator

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

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

Development Guide Testing applications that require an HTTP connection

34

Page 37: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

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

Configure BlackBerry MDS Simulator properties

1. In a text editor, open the rimpublic.property file from the Program Files\Research In Motion\BlackBerry Email and MDSServices Simulators 4.1.2\MDS\config\ folder.

2. Configure the file settings as necessary.

3. Restart the BlackBerry® MDS Simulator.

BlackBerry MDS Simulator logging properties

Property Description Default

Logging.file.log.level Specify the type of information to record,

if you enable logging:

• 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

4

Logging.console.log.level Specify the type of information that

appears in the console, if you enable

logging. See the description for the

Logging.level property.

4

application.handler.http.l

ogging

Set to TRUE or FALSE to enable or

disable HTTP standard logging (HTTP

headers only).

FALSE

Development Guide Testing applications that require an HTTP connection

35

Page 38: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Property Description Default

application.handler.http.

logging.verbose

Set to TRUE or FALSE to enable or

disable HTTP debug logging (HTTP data

as well as headers). Set this parameter

to TRUE only when necessary to debug

a specific problem.

FALSE

BlackBerry MDS Simulator HTTP properties

Property Description Default

Logging.file.log.levelappl

ication.handler.http.Cooki

eSupport

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.

TRUE

application.handler.http.A

uthenticationSupport

Set to TRUE or FALSE to enable or

disable storage of user authentication

information.

TRUE

application.handler.http.A

uthenticationTimeout

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.

3600000

application.handler.http.d

evice.connection.timeout

Specify the length of time (in

milliseconds) before a BlackBerry device

connection attempt expires.

140000

application.handler.http.s

erver.connection.timeout

Specify the length of time (in

milliseconds) before a server connection

attempt expires.

150000

http.proxyHost This is the HTTP proxy host name. n/a

Development Guide Testing applications that require an HTTP connection

36

Page 39: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Property Description Default

http.proxyPort This is the HTTP proxy port number. This

is also used by Sun implementations of

HTTP URL connections.

n/a

BlackBerry MDS Simulator HTTPS properties

Property Description Default

application.handler.https.

allowUntrustedServer

To enable the connection service to

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.

FALSE

Parameter Description Default

application.handler.ldap.D

EFAULT_SERVER

Specifies the default LDAP directory

server to which to send LDAP queries

localhost

application.handler.ldap.D

EFAULT_PORT

Specifies the default port to which

BlackBerry MDS Services should send

LDAP queries

389

application.handler.ldap.D

EFAULT_QUERY

Specifies a default LDAP query —

application.handler.ldap.D

EFAULT_LIMIT

Specifies a default limit for the number

of concurrent LDAP queries that

BlackBerry MDS Services supports

20

application.handler.ldap.C

OMPRESSION

Specifies whether or not BlackBerry

MDS Services supports compression of

LDAP queries

TRUE

application.handler.ldap.l

ogging

Specifies whether or not BlackBerry

MDS Services logs all LDAP queries

FALSE

Development Guide Testing applications that require an HTTP connection

37

Page 40: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Parameter Description Default

UDP.receive.port Specifies the port on which to listen to

receive UDP packets

19781

UDP.send.default.port Specifies the default port on which to

send UDP packets

19780

UDP.send.default.host This parameter specifies the default host

to which to send UDP packets.

This must be set to localhost.

localhost

Push support

Do not change push application connection service properties.

Property Description Default

WebServer.listen.host This property defines the computer on

which the connection service listens for

HTTP POST requests from push

applications.

localhost

WebServer.listen.port This property defines the port number on

which the connection service listens for

HTTP POST requests from push

applications.

8080

Testing push applications

Configure the BlackBerry MDS Simulator to allow reliable push connectionsThe BlackBerry® MDS Simulator supports pushing to multiple recipients using multiple email addresses or PIN numbers. To testreliable push applications, add information to the rimpublic.properties file.

1. Open the rimpublic.property file.

2. 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.

Development Guide Testing applications that require an HTTP connection

38

Page 41: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

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 thepersonal identification number (PIN) of their BlackBerry devices. Using the BlackBerry Smartphone Simulator, you can simulatethe mapping between internet messaging addresses and PINs.

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

1. Open the rimpublic.property file.

2. 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 [email protected]:

Simulator.2100000a=localhost:81, [email protected]

3. Change the email address so that when a push application sends data to the email address, pushed data is sent to theaddress 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. In the BlackBerry® Integrated Development Environment, on the Edit menu, click Preferences.

2. Click the Simulator tab.

3. Click the General tab.

4. 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 applicationsThe BlackBerry® Email Simulator is designed to send and receive messages between the BlackBerry Smartphone Simulator andeither 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 athttp://www.blackberry.com/developers.

Development Guide Testing messaging applications

39

Page 42: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Configure a POP3 and SMTP server connection1. On the taskbar, click Start > Programs > Research In Motion > BlackBerry Email and MDS Services Simulators 4.1.2

> ESS.

2. In the BlackBerry® Email Simulator window, ensure the Connected mode option radio button is selected.

3. In the Outgoing field, type the host name of the SMTP server that your email account uses.

4. In the Incoming field, type the host name of the POP3 server that your email account uses.

5. In the User name field, type the user name with which to connect to your email account.

6. In the Password field, type the password with which to connect to your email account.

7. 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 message1. Start the BlackBerry® Email Simulator.

2. In the BlackBerry Email Simulator window, ensure the Standalone mode option radio button is selected.

3. Click Launch.

4. Start the BlackBerry Smartphone Simulator.

5. Navigate to the Messages icon.

6. Open the Messages application.

7. Open the menu.

8. Click Compose Email.

9. In the To field, type an email address.

10. Fill in the Cc, Subject, and Body fields.

11. Open the menu.

12. Click Send.

Receive a message1. Start the BlackBerry® Email Simulator.

2. In the BlackBerry Email Simulator window, ensure the Standalone mode option radio button is selected.

3. Click Launch.

Development Guide Testing messaging applications

40

Page 43: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

4. Start the BlackBerry Email Simulator.

5. When the BlackBerry Email Simulator receives an email, open the Messages application.

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

Test a BlackBerry Smartphone Simulator with a BlackBerry Enterprise Server1. From the BlackBerry® Java® Development Environment (BlackBerry IDE) or from the start menu, run the BlackBerry

Smartphone Simulator.

2. On the Home screen, click the Turn Wireless Off icon.

3. From the taskbar, click Start --> Programs --> BlackBerry --> Desktop Manager.

4. From the BlackBerry Smartphone Simulator taskbar, perform one of the following actions:• Click Simulate --> USB Connected.• Click Simulate --> Serial Connected.

5. Click Yes.

6. Follow the instructions to generate a new encryption key.

7. 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 thenbe 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.

Development Guide Testing BlackBerry Enterprise Server APIs and IT policies

41

Page 44: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Using the BlackBerry Smartphone Simulatorprogrammatically

5

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

Action Description

Issue device commands. 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 controllerBlackBerry® Smartphone Simulator controller commands have the following format:fledgecontroller /session={name} [/execute={command}] [/timeout={time-in-seconds}] [/get-sessions]

Invocation Method Example Description

/execute fledgecontroller

/session=7290

/execute=BatteryLevel(5)

The BlackBerry Smartphone Simulator

controller issues the BatteryLevel(5) command

to the BlackBerry Smartphone Simulator for

the BlackBerry® 7290 of wireless devices and

exits.

Standard input fledgecontroller

/session=7290

...

...

If you do not use the /execute command, the

BlackBerry Smartphone Simulator controller

sends commands from standard input to the

Development Guide Using the BlackBerry Smartphone Simulator programmatically

42

Page 45: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Invocation Method Example Description

BatteryLevel(5) BlackBerry Smartphone Simulator. You must

manually exit the BlackBerry Smartphone

Simulator controller session.

Send commands to the BlackBerry Smartphone SimulatorThe BlackBerry® Smartphone Simulator interface reflects the commands you type. The following instructions assume that youhave 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:

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

2. Start the BlackBerry Smartphone Simulator. For example, at the command prompt, type the following:

fledge /handheld=7290

3. Connect the BlackBerry Smartphone Simulator controller to a running BlackBerry Smartphone Simulator:

fledgecontroller /session=7290

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

BatteryLevel(5)

Exit the BlackBerry Smartphone Simulator controller sessionPerform one of the following actions:

Action Description

End the session connection. Perform one of the following actions:

• At the command prompt, type quit.

• Press CTRL+Z.

Development Guide Send commands to the BlackBerry Smartphone Simulator

43

Page 46: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Action Description

End the session and close the

BlackBerry® Smartphone

Simulator.

At the command prompt, type exit.

Using test scriptsThe BlackBerry® Smartphone Simulator controller command prompt tool can be utilized within scripts for automated tests. Whenevents 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 GUItests are not required.

Test BlackBerry Smartphone Simulator events using script1. 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)

KeyRelease(ESCAPE)

Exit

2. Save the command file in the same directory of your BlackBerry® installation:

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

3. 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

4. In the .bat file, write instructions for connecting the BlackBerry Smartphone Simulator controller to the session, inputtingdata from the command file and directing output to a text file. (In this example, the name of the output file is out.txt). Forexample:

FledgeController.exe /session=test < PhoneTest.txt > out.txt

Development Guide Using test scripts

44

Page 47: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Note: .bat instructions in the example assume that you create the .bat file in the same location as the fledge.exe file. Ifyou save the .bat file to a different location, include path location information for fledge.exe and fledgeController.exe inthe .bat file.

5. Save the .bat file in the bin directory of your BlackBerry installation:

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

6. 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

7. 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 allcommands in the command file are issued, the BlackBerry Smartphone Simulator closes and messages are written to the textfile. 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

Use BlackBerry Smartphone Simulator controller commandsTo view a list of commands for controlling the BlackBerry® Smartphone Simulator, perform one of the following actions:

Action Description

View a list of commands from

the BlackBerry Smartphone

Simulator.

On the Help menu, click Controller Command Help.

View a list of commands from

a command prompt.At the command prompt, type help.

Development Guide Use BlackBerry Smartphone Simulator controller commands

45

Page 48: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Action Description

For more information on running the BlackBerry Smartphone Simulator controller, type

FledgeController /help.

Behavior and appearance commandsUse application commands to control the behaviour and appearance of the BlackBerry® Smartphone Simulator.

Action Application command Parameter

Display help on BlackBerry

Smartphone Simulator

controller commands.

Help

Pause the BlackBerry

Smartphone Simulator

controller for the given time.

Pause (int time) time : Type the the number of seconds to

pause the BlackBerry Smartphone Simulator

controller.

Exit the BlackBerry

Smartphone Simulator.

Exit (bool save-flash) save-flash : The default value of true saves

your changes to simulated flash memory before

closing the BlackBerry Smartphone Simulator.

Terminate the BlackBerry

Smartphone Simulator

process.

Kill

Type this command to clean up without

saving simulated flash memory. If the clean

up process fails, the process is terminated.

Reset the simulator. Reset

Get the ID of the BlackBerry

Smartphone Simulator

process.

GetPid

View or hide the main

window.

WindowShow (bool show = true) show : The default value of true displays the

main window. To hide the main window, set this

parameter to false.

Move the main BlackBerry

Smartphone Simulator

window to the foreground.

WindowRaise

Windows will usually block this command

unless the application with focus calls the

AllowSetForegroundWindow API.

Development Guide Use BlackBerry Smartphone Simulator controller commands

46

Page 49: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Action Application command Parameter

Move the main BlackBerry

Smartphone Simulator

window behind all other

windows.

WindowLower

Allow another application to

obtain the foreground

window focus from the

BlackBerry Smartphone

Simulator.

AllowFocusChange

Load a Java® application

in .cod format.

LoadCod (Path filename) filename : Type the full path to the .cod file

of the application.

Location commandsUse environment commands to control the surrounding environment of the BlackBerry® device.

Action Environment command Parameter

Change the GPS location of

the BlackBerry device.Location (double latitude, double longitude, short altitude = 0)

• latitude : Type a latitude value

between 89.99 and -90.00 degrees.

• longitude : Type a longitude value

between 179.99 and -180.00 degrees.

• 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 commandsUse input commands to generate keyboard and input BlackBerry® device events.

Development Guide Use BlackBerry Smartphone Simulator controller commands

47

Page 50: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Action Input command Parameter

Press a key. KeyPress (key-types key) key : Type the key that you wish to use for a

press key event.

Release a key. KeyRelease (key-types key) key : Type the key that you wish to use for a

release key event.

Enter a character string into

the applications (even if

characters contained in the

string do not correspond to

keys on the BlackBerry

device).

StringInjection (string string) string : Type the character string to enter

into the application.

Press a pre-translated key. PreTranslatedKeyPress (char

key)

key : Type the key that you wish to use for a

press pre-translated key event.

Release a pre-translated key. PreTranslatedKeyRelease (char

key)

key : Type the key that you wish to use for a

release pre-translated key event.

Press the trackwheel. ThumbwheelPress

Release the trackwheel. ThumbwheelRelease

Roll the trackwheel. ThumbwheelRoll (int movement) 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.

Press the trackball. TrackballPress

Release the trackball. TrackballRelease

Roll the trackball. TrackballRoll (int x-delta, int

y-delta)

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.

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.

Development Guide Use BlackBerry Smartphone Simulator controller commands

48

Page 51: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Data and phone commandsUse network commands to generate data and phone events.

Action Network command Parameter

Set network coverage level. NetworkCoverage (int RSSI) RSSI : Type the dB level, with -40 being strong

and -256 being out of coverage

Simulate a remote phone that

answers a call placed from

the BlackBerry® device.

RemoteCallAnswer

Place a new call from a

remote phone to the

BlackBerry device.

RemoteCallCreation (string

number, presentation-

indicator-types presentation-

indicator = PI_ALLOWED)

• 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.

Hang up a remote phone. RemoteCallDisconnection

(string number)

number : Type the phone number to

disconnect from.

Generate a call failure. RemoteCallFailure (string

number, reason-types reason)• number : Type the phone number to use

for the remote call failure simulation.

• reason : Type a reason for the remote

call failure.

Provision a supplementary

service.

SupplementaryServiceProvision

ing (service-types service, bool

provisioned)

• 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.

BlackBerry device accessory commandsUse peripheral commands to generate BlackBerry® device peripheral events.

Development Guide Use BlackBerry Smartphone Simulator controller commands

49

Page 52: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Action Peripheral command Parameter

Set the charge level of the

battery.

BatteryLevel (int level) level : Type the charge level of the battery.

Set battery charging on or off. BatteryCharge (bool charging) charging : Type true to simulate battery

charging. Set this parameter to false to

simulate the battery not charging.

Connect or disconnect the

external headset.

HeadsetConnection (bool

connected)

connected : Type true to simulate a

connection to the external headset. If you type

false, a connection to the external headset is

not simulated.

Hang up a remote phone. RemoteCallDisconnection

(string number)

number : Type the phone number to

disconnect from.

Press or release the button on

the external headset.

HeadsetClick (bool pressed) pressed - When this parameter is set to true,

the button appears pressed; when it is set to

false, the button does not appear pressed.

Holster or unholster the

BlackBerry device.

Holster (bool holstered) 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.

Insert or remove the SIM

card.

SimInsertion (bool inserted) 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.

Development Guide Use BlackBerry Smartphone Simulator controller commands

50

Page 53: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Provide feedback 6

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

Development Guide Provide feedback

51

Page 54: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Legal notice 7

©2010 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, SureType®, SurePress™ andrelated 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, andWindows 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 madeavailable 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 thisdocumentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation maydescribe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information thatis 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 servicesincluding components and content such as content protected by copyright and/or third-party web sites (collectively the "ThirdParty 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 Servicesin 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, INCLUDINGWITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OFDURABILITY, 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 DEALINGOR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCEOF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, AREHEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONSMAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENTPERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENTTHEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROMTHE 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 LIABLEFOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCEDHEREIN 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

Development Guide Legal notice

52

Page 55: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMSASSOCIATED 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 OFSUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARYLOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISEDOF THE POSSIBILITY OF SUCH DAMAGES.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHEROBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITYFOR NEGLIGENCE OR STRICT LIABILITY.

THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THECAUSE 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 BREACHESOR 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 AIRTIMESERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIRRESPECTIVE 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 LIABILITYARISING 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 yourairtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internet browsingfunctionality with a subscription to the BlackBerry® Internet Service. Check with your service provider for availability, roamingarrangements, service plans and features. Installation or use of Third Party Products and Services with RIM's products and servicesmay require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third partyrights. You are solely responsible for determining whether to use Third Party Products and Services and if any third party licensesare required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products andServices until all necessary licenses have been acquired. Any Third Party Products and Services that are provided with RIM'sproducts 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 relationthereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to the terms of separatelicenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or otheragreement with RIM.

Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server, BlackBerry® DesktopSoftware, and/or BlackBerry® Device Software.

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 WARRANTIESPROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.

Research In Motion Limited295 Phillip StreetWaterloo, ON N2L 3W8

Development Guide Legal notice

53

Page 56: Blackberry Smart Phone Simulator Development Guide 1001926 0406042642 001 5.0 US

Canada

Research In Motion UK Limited Centrum House 36 Station Road Egham, Surrey TW20 9LF United Kingdom

Published in Canada

Development Guide Legal notice

54