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 controller setup application is installed in a controllers folder when you run the simulator setup application.
- 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.
If the controller doesn't automatically connect to the simulator, you can connect manually. Click Connection > Connect.
In the Connect to Simulator dialog box, click Refresh.
Select the simulator in the Auto Discover area to add it to the IP Address list.
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-left corner of the simulator window.
Connected to <IP address> appears on the status bar at the bottom of the controller window.
Change the zoom level
To change the size of the simulator so that it fits on your computer monitor:
- In the controller, click Device > Change Zoom Level.
- In the Zoom level field, enter a percentage to reduce or increase the simulator size.
- Click Apply.
At a 70% zoom level, the simulator fits on most computer monitors. This is the default zoom level.
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, and 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 Device > Change PIN. Enter a valid PIN and click Apply. You can verify that your new PIN was set using the options menu in the simulator.
Set mouse and touch inputs
You can restrict the simulator to accept only mouse inputs, only touch inputs, or both. In the controller, click Device > Mouse in the controller window to change settings.
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 do not 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 QNX Momentics IDE if you want to deploy your application to the simulator.
Do not use the IP address (169.254 …) found under System Settings > Security and Privacy > Development Mode for either QNX Momentics IDE or to Telnet/FTP to the simulator.
Telnet to the simulator
- In a command window, type Telnet <IP address of a simulator>.
- When you are prompted for the login, type devuser.
- When you are prompted for the password, type devuser.
For versions of Windows later than Windows XP, Telnet needs to be enabled separately.