Configuring the simulator

Connect the controller to the simulator

The controller is an application that lets you simulate physical properties and features of a BlackBerry 10 device, such as orientation, sensors, battery, location, and near field communication (NFC). The controller also lets you change the size of the BlackBerry 10 device simulator so that it fits on your computer screen. To use the controller, you must connect it to the IP address of the simulator. After you connect the controller to the simulator, you can use the Device menu to control the simulator or use the View menu to see the log files that you generate with your actions on the simulator. The simulator setup application installs the controller setup application in a controllers folder.

  1. Open the controller:
    • In Windows, click Start > BlackBerry 10 Simulator > Controller.

    • In Linux, navigate to the folder where you installed the simulator and run the controller file.

    • In Mac OS, navigate to the location where you installed the simulator, right-click .vmware, click View package contents, and extract the contents of the controllers folder. Double-click the controller application.

    When you open the controller with one simulator running, the controller should automatically connect to the simulator. If you have two or more simulators running, the controller should open a dialog box for you to select the simulator you want to connect to.

  2. If the controller doesn't automatically connect to the simulator, you can connect manually. Click the Refresh button in the bottom right corner of the controller.

    Screen showing the simulator's Refresh button.

  3. Select the simulator in the Auto Discover area.

    If you are running multiple instances of the simulator, select the address of the simulator that you want to control from the IP address drop-down list.

    Note that the simulator's IP address is displayed in the bottom of the simulator window.

Change the zoom level

To change the size of the simulator so that it fits on your computer monitor:

  1. In the controller, click Utilities.
  2. In the Zoom slider, change the percentage to reduce or increase the simulator size.
  3. Click Apply.

Screen showing the simulator's zoom controls.

At a 70% zoom level, the simulator fits on most computer monitors. This is the default zoom level.

Other options:

  • Use the diagonal bars on the lower right corner to drag the window to the size that you want. This will only resize the simulator's window, but not the simulator.

  • Use the ves-zoom <percentage> command in a Telnet or Putty window.

Change the simulator's PIN

You can change the PIN of a simulator so that you can simulate multiple devices. To change the PIN, in the controller window, click Utilities. Enter a valid PIN and click Apply. You can verify that your new PIN was set using the options menu in the simulator.

Screen showing the Device PIN field.

Set mouse and touch inputs

You can restrict the simulator to accept only mouse inputs, only touch inputs, or both. In the controller, click Utilities and choose the type of input you would like from the drop-down list.

Screen showing the simulator's input selections.

Connect to the simulator using Telnet or FTP

You can connect to the BlackBerry 10 simulator with the IP address of the simulator and a devuser account using Telnet or FTP. You don't require SSH keys and you don't need to use BlackBerry Connect. To FTP to the simulator, you can use FileZilla or any FTP application. To connect to the simulator using Telnet, you can use Putty or any other Telnet application. You can use devuser as the username and password to connect.

Get the IP address of your simulator

To Telnet or FTP to the simulator, you need to get the simulator's IP address, which is displayed in the lower left corner of the simulator's screen. This is the same IP address that you can find in the controller's Connect dialog box.

This is the IP address that you use with Momentics IDE if you want to deploy your application to the simulator.

Screen showing the simulator's IP address.

Do not use the IP address (169.254 …)  found under System Settings > Security and Privacy > Development Mode for either Momentics IDE or to Telnet/FTP to the simulator.

Telnet to the simulator

  1. In a command window, type Telnet <IP address of a simulator>.
  2. When you are prompted for the login, type devuser.
  3. When you are prompted for the password, type devuser.

For versions of Windows later than Windows XP, you must enable Telnet separately.



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus