eggPlantdownloads.testplant.com/downloads/EggplantMobileGuide.pdfThe EggPlant: Reference Manual describes the EggPlant interface and scripting processes, and the SenseTalk com-mands,

EggPlant Mobile Guide

eggPlantv10 .23 WindoWs

Copyright 2010 TestPlant Inc. Eggplant Mobile Guide

Trademarks

Eggplant, the Eggplant logos, TestPlant, and the TestPlant logo are trademarks or registered trade-marks of TestPlant Inc. Eggplant Reference Manual, Eggplant: Getting Started, Using Eggplant, SenseTalk Reference Manual, and Eggplant:RiTA Manual are copyrights of TestPlant Inc.

SenseTalk is a trademark or registered trademark of Thoughtful Software, Inc.

Apple, Mac, Macintosh, Mac OS X, and QuickTime are trademarks or registered trademarks of Apple Computer, Inc.

Windows, and Window XP are trademarks or registered trademarks of Microsoft Corporation.

E g g P l a n t : M o b i l e G u i d e 3

w w w . t e s t p l a n t . c o m

Contents

About EggPlant Mobile ..............................................................................................................4Available Systems ................................................................................................................................................. 4Other Mobile VNC Servers .................................................................................................................................... 4Help and Additional Information ............................................................................................................................ 4

Setting up the VNC mobile server: Blackberry ........................................................................5Installing the VNC mobile server ........................................................................................................................... 5Launching the VNC mobile server ......................................................................................................................... 5

Setting up Vine Mobile Server: Symbian S60 ..........................................................................6Installing the VNC mobile server ........................................................................................................................... 6Launching the VNC mobile server ......................................................................................................................... 6

Setting up Vine Mobile Server: Windows Mobile ....................................................................7Installing the VNC mobile server ........................................................................................................................... 7Launching the VNC Mobile Server ........................................................................................................................ 7

Standard VNC Connections .......................................................................................................8Adding a Device to the EggPlant Connection List ................................................................................................. 8Opening a VNC Connection .................................................................................................................................. 9Closing a VNC Connection .................................................................................................................................... 9Further Information ................................................................................................................................................ 9

Reverse connections .................................................................................................................11Opening a Reverse Connection ............................................................................................................................ 11

Device Control ............................................................................................................................12Controlling the Mobile Device Manually ................................................................................................................ 12Automating Device Keystrokes with TypeText ....................................................................................................... 13Automating Touch-Screen Actions ........................................................................................................................ 13

http://www.testplant.com



About EggPlant Mobile

Available SystemsThe VNC mobile server is currently available for the following systems:

BlackBerry OS 4.3 and later

Symbian S60 running on Symbian OS 9.2 and later:

• S60 3rd Edition Feature Pack 1 (3.1) (on Symbian OS 9.2)

• S60 3rd Edition Feature Pack 2 (3.2) (on Symbian OS 9.3)

• S60 5th Edition (5.0) (on Symbian OS 9.4)

Windows Mobile running on WinCE 5.0:

• Windows Mobile 6.0 Standard and Professional

• Windows Mobile 6.1 Standard and Professional

Other Mobile VNC ServersEggPlant is compatible with all standard VNC servers (up to RFB protocol 3.8), including those built for mobile de-vices. If you are using a mobile VNC server that is not part of the EggPlant Mobile extension, EggPlant regards the server as a typical VNC server.

Help and Additional InformationThe following manuals are available through the EggPlant menu and the downloads page of the TestPlant web site.

The EggPlant: Reference Manual describes the EggPlant interface and scripting processes, and the SenseTalk com-mands, functions, and global properties that are unique to EggPlant.

Using EggPlant is a collection of articles that cover a wide range of EggPlant topics.

EggPlant Tutorials is a series of five tutorials that introduce the scripting environment and often-used commands and functions.

The SenseTalk Reference Manual is a comprehensive guide to the SenseTalk scripting language used in EggPlant.

For EggPlant updates, news, discussion forums, and all available support resources, please visit TestPlant support.




Setting up the VNC mobile server: Blackberry

Installing the VNC mobile serverBefore you install the VNC mobile server on your Blackberry, please uninstall any other VNC servers that are pres-ent.

There are two ways to install the VNC mobile server:

Download the VNC mobile server directly to your BlackberryFrom your Blackberry, log in to the TestPlant web site; click the VNC mobile server download link.

Transfer the VNC mobile server from your desktop computerLog in to the TestPlant web site and download the VNC mobile server. Use Blackberry Desktop to transfer the VNC mobile server to your Blackberry.

Launching the VNC mobile serverYou can launch the VNC mobile server as you would launch any Blackberry application:

1 From the Home screen, press the Menu key.

2 Navigate to the VNC mobile server application, and click it.

3 First launch only: You are prompted to verify standard Blackberry security settings.




Setting up Vine Mobile Server: Symbian S60

Installing the VNC mobile serverBefore you install the VNC mobile server on your Symbian device, please uninstall any other VNC servers that are present.


Download the VNC mobile server directly to your Symbian deviceFrom your Symbian device, log in to the TestPlant web site; click the VNC mobile server download link.

Transfer the VNC mobile server from your desktop computerLog in to the TestPlant web site and download the VNC mobile server. Use Nokia PC Suite or similar software to transfer the VNC mobile server to your Symbian device.

Launching the VNC mobile serverYou can launch the VNC mobile server as you would launch any application on your device:

1 Press the Menu key.

2 Select Applications > VNC Mobile Server.

Note: The first time you launch the application, you may have to wait while keys are generated.




Setting up Vine Mobile Server: Windows Mobile

Installing the VNC mobile serverBefore you install the VNC mobile server on your Windows Mobile device, please uninstall any other VNC servers that are present.


Download the VNC mobile server directly to your Windows Mobile deviceFrom your device, log in to the TestPlant web site; click the VNC mobile server download link for your device.

Transfer the VNC mobile server from your desktop computer1 Log in to the TestPlant web site and download the VNC mobile server for your device.

2 Use Microsoft ActiveSync to transfer the VNC mobile server to your device.

3 On the device, navigate to the VNC mobile server file, and select or tap it to install.

Launching the VNC Mobile ServerYou can launch the VNC mobile server as you would launch any application on your device:

1 Press the Menu key.

2 Select Applications > VNC Mobile Server.

Note: The first time you launch the application, you may have to wait while keys are generated.




Standard VNC ConnectionsIf your device is Wi-fi enabled (or connected to a TCP/IP network) you can usually open standard VNC connections from the Connection List in EggPlant. (For more information, see the checklist below.)

First-time connection checklist

Complete the following checklist with each new device. If you cannot perform all of the steps, you will not be able to open standard VNC connections. (See Opening a reverse VNC connection.)

What to do How to do it

Enable your device’s Wi-fi or wired network connection, if possible.

Note: If you are connecting over a cellular data network, you will need to open a reverse connection.

Consult the device manufacturer’s documentation.

Find your IP address. In the VNC mobile server main menu, select Listen. Your IP address is shown at the top of the next screen.

Verify your VNC port number. The default VNC port number is 5900.

If you have changed the VNC port number, you can find it again in the VNC mobile server’s Options or Settings.

Verify that your network security will allow EggPlant to contact your device on the VNC port.

If you are connecting over a local netowrk, you probably don’t need to change any network security settings. To know for certain, try opening a VNC connection or talk to your system administrator.

When your checklist is complete, you can add your device to EggPlant’s Connection List.

Adding a Device to the EggPlant Connection List1 In the Connection menu, choose Connection List.

2 In the Connection List, Click Add.

3 Fill in the text fields with the SUT’s VNC server information:

• Server. The IP address of your device.

• Port. The port number of the VNC server: 5900-5909. (The default value is 5900.)

• Username and Password. By default, the VNC mobile server does not require authentication. If you have changed your security settings to require a user name and password, enter them here.




• Display Name. Any name that helps you identify your device.

• Color Depth. The level of color detail EggPlant uses to draw the device screen. Start with default; if you have a slow VNC connection, reducing the color depth may improve performance. (Note: You must use the same color depth to capture images and run scripts.)

• Skip Availability Check. When this checkbox is selected, EggPlant does not “look for” this device unless you try to open a connection or check availability manually.

• Connect Securely (SSH). When this checkbox is selected, EggPlant connects to your device through an SSH host. To use SSH encryption, your device must have a secure connection to a computer that can host an SSH tunnel. When you select the Connect Securely checkbox, the panel expands to include SSH login information. Enter the IP address of your SSH host, and your user name and password on the SSH host.

4 Save your information.

Opening a VNC ConnectionThere are several ways to open a VNC Connection:

• In the Connection List, double-click the name of your device.

• Select the device and click Connect.

• Select the device and choose Connection menu > Connect.

• Insert a Connect command into your script. (For more information see the Connect command in the EggPlant Reference Manual.

Tip: If you are running a script that switches between multiple devices, you can save execution time by keeping both (or all) connections open, rather than disconnecting and re-connecting with each switch.

Closing a VNC ConnectionThere are two ways to close a VNC Connection manually:

• In the Connection List, select the device and click the Disconnect button.

• While the SUT’s Viewer window is the active window, choose Connection menu > Disconnect.

• Insert a Disconnect command into your script. (For more information see the Disconnect command in the EggPlant Reference Manual.

Note: Closing a Viewer window does not close your VNC connection with the corresponding SUT.

Further Information• EggPlant Reference Manual: The Connection List


E g g P l a n t : M o b i l e G u i d e 1 0


• Using EggPlant: Troubleshooting Connection Issues




Reverse connectionsReverse connections differ from standard VNC connections in just one way: instead of EggPlant initiating a connec-tion with your device, the device initiates a connection with EggPlant. The distinction is useful for devices that cannot accept incoming VNC connections.

If your device’s network security cannot be modified to allow incoming VNC connections, use a reverse connection.

Note: If you are connecting over a cellular data network, your cellular service provider controls your network security; and you almost certainly need to use a reverse connection.

Opening a Reverse Connection1 Verify that your network security will allow the EggPlant computer to receive connections on port 5501.

2 Have EggPlant listen for mobile connections. In VNC preferences, select the “Listen for mobile connections” checkbox.

3 On your device, in the VNC server’s main menu, choose Connect.

4 You are prompted to enter an address. Enter the IP address or host name of your EggPlant computer.




Device ControlThis section explains how mobile device controls correspond to EggPlant’s mouse and keyboard events.

Controlling the Mobile Device ManuallyWhen you are manually controlling your mobile device through EggPlant, you can generate most keystrokes by pressing the corresponding computer key. (For example, when you press the “m” key on your computer keyboard, an “m” keystroke is produced on the device.)

Device-Specific KeysFor the controls that are not present on a computer keyboard, such as the trackball and Menu key, EggPlant substi-tutes a computer key. (For example, Keypad + represents the Volume up button. To engage the device’s Volume up button, you press the + key on your computer keypad.) Specific device key mappings are shown at the end of this section:

• Blackberry key mapping

• Symbian S60 key mapping

• Windows Mobile key mapping

The Mobile ButtonsIn addition to the keyboard controls, the Viewer window has a set of “Mobile Buttons” that represent common mobile device buttons. To control the device, click these buttons as you would press the corresponding buttons on the actual device.

To show or hide the Mobile Buttons, click the Mobile button in the Viewer window toolbar or choose Control menu > Toggle Mobile Buttons.

Mobile Buttons

Touch-Screen ControlsIn EggPlant, you can produce a device’s touch-screen actions with mouse movements and clicks. When the mouse button is pressed, the device registers your finger on the screen at the same point as the mouse cursor. When the mouse button is up, mouse cursor movements have no effect on the device cursor.




Automating Device Keystrokes with TypeTextIn EggPlant scripts, the TypeText command generates keystrokes– both character keystrokes, such as letters, and “functional” keystrokes, such as the Escape key.

Typing CharactersTo produce text on the device, use the TypeText command with a quoted text string.

Example: TypeText “3140 Main Street” // Types this text on the device.

Pressing Functional KeysEach functional key has an assigned keyword to use with the TypeText command. To produce functional keystrokes on the device, use the TypeText command with the corresponding keyword.

Example: TypeText DownArrow // Sends a down arrow keystroke, which corresponds to the device’s “trackball down” action.

TypeText AltKey, “d” //Holds the AltKey, and sends a d keystroke.

Recording TypeText StatementsIn the Viewer window, you can create TypeText statements by recording your keystrokes and Mobile Button clicks.

Recording KeystrokesIn Capture mode, press the spacebar or type any panel to open the TypeText panel.

When the TypeText panel is open, your keystrokes are inserted into the text field. Non-character keys (and quota-tion marks) are inserted as TypeText keywords; character keys are inserted as literal text. As you are typing, you can select and edit your text in the text field.

To insert the TypeText statement into your script, click the Insert button.

Recording Mobile ButtonsIn Capture mode, clicking a Mobile Button inserts a corresponding TypeText command into your script. For example, clicking the call button inserts TypeText CallButton into your script. (The TypeText panel does not open.)

Automating Touch-Screen ActionsEach of the mouse events you use to operate a device’s touch screen has a corresponding script command, shown in the table below. (The commands are all standard mouse commands, which can be used in any EggPlant script.)




Touch-screen mappingTouch-screen control Corresponding mouse action EggPlant command

Tap Click ClickDouble tap Double-click DoubleClickDrag and drop/ Slide Drag and drop DragAndDrop

Example: Click “Application_folder” //”Taps” the image of the application folder.

For more information, see “Mouse Commands and Functions” in the EggPlant Reference Manual.

Blackberry control mappingBlackberry control Corresponding computer key TypeText keyword

End/Power key Keypad . EndButton, KeypadDecimalEscape key Escape EscapeMenu key Home MenuButton, HomeKeySend key Keypad Enter CallButton, KeypadEnterTrackball down Down arrow DownArrowTrackball left Left arrow LeftArrowTrackball right Right arrow RightArrowTrackball up Up arrow UpArrowTrackball click F5 SelectButton, F5Volume up Keypad + VolumeUpButton, KeypadPlusVolume down Keypad - VolumeDownButton, KeypadMinus

Symbian S60 control mappingSymbian S60 control Corresponding computer key TypeText keywords

Call key Keypad Enter CallButton, KeypadEnterClear key Escape EscapeDown scroll key Down arrow DownArrowEnd key Keypad Delete EndButton, KeypadDecimalKeypad 0-9 Keypad 0-9 Keypad0- Keypad9 (Num Lock on)Keypad * Keypad * Star, KeypadTimesKeypad # Keypad / Pound, KeypadDivideLeft scroll key Left arrow LeftArrowLeft selection key F1 LeftSelectButton, F1Menu key Home MenuButton, HomeKeyRight scroll key Right arrow RightArrow




Symbian S60 control Corresponding computer key TypeText keywords

Right selection key F2 RightSelectButton, F2Select F5 SelectButton, F5Up scroll key Up arrow UpArrowVolume up Keypad + VolumeUpButton, KeypadPlusVolume down Keypad - VolumeDownButton, KeypadMinus

Windows Mobile control mappingWindows Mobile control Corresponding computer key TypeText keywords

Back Escape EscapeCenter OK F5 SelectButton, F5End Keypad . EndButton, KeypadDecimalHome Home MenuButton, HomeKeyLeft soft key F1 LeftSelectButton, F1Navigation down Down arrow DownArrowNavigation left Left arrow LeftArrowNavigation right Right arrow RightArrowNavigation up Up arrow UpArrowPhone keypad 0-9 Keypad 0-9 Keypad0- Keypad9 (Num Lock on)Phone keypad * Keypad * Star, KeypadTimesPhone keypad # Keypad / Pound, KeypadDivideRight soft key F2 RightSelectButton, F2Talk/Send Keypad Enter CallButton, KeypadEnterVolume up Keypad + VolumeUpButton, KeypadPlusVolume down Keypad - VolumeDownButton, KeypadMinus





Documents

eggPlantdownloads.testplant.com/downloads/EggplantMobileGuide.pdfThe EggPlant: Reference Manual describes the EggPlant interface and scripting processes, and the SenseTalk com-mands,