You can produce automated tests by including the BlackBerry Smartphone Simulator controller tool within batch files. The BlackBerry Smartphone Simulator controller tool issues commands to the BlackBerry Smartphone Simulator. The controller tool is designed to enable you to test events that normally would only be perceived visually or audibly. When the BlackBerry Smartphone Simulator receives events or carries out commands, the controller tool presents messages on standard output. You do not require tools that automate GUI tests.

For example, you can use test scripts to test your application on several models of the BlackBerry device simultaneously.

The BlackBerry Smartphone Simulator controller tool accepts commands from either standard input or from a text file. You must connect the controller tool to a simulator session. You can create a .bat file that contains both the instructions for starting the simulator and the controller tool commands, or you can divide them into separate files. You must issue one controller tool command per line.

The BlackBerry Smartphone Simulator controller tool commands are like function calls. Optional parameters are at the end of the command and can be omitted if the default parameter is acceptable for your needs. Case is not important. White space around the parentheses is not important.

When you disconnect the controller tool from the BlackBerry Smartphone Simulator, the simulator still reflects the events that happened. For example, if you set the battery level to a new value, the simulator continues to reflect that value until the level is set again or the simulator is started again.