Quick Start to CTK (Compact 2013)
3/26/2014
This topic provides a quick introduction to the Windows Embedded Compact Test Kit (CTK). The steps in this topic guide you through the process of connecting to a device, creating a test pass template, creating a test pass, running a simple test, and viewing the results of the test. At the end of each set of steps is a link to the actual topic for more detailed information.
Steps to Use the CTK
- Step 1: Connect to a Device
- Step 2: Create a Test Pass Template
- Step 3: Create a Test Pass from the Template
- Step 4: Run a Test
- Step 5: View Test Results
Step 1: Connect to a Device
A device must be running and attached to Platform Builder before you can connect to the device from the Windows Embedded Compact Test Kit (CTK). If you prefer, you can create a test pass template before you connect to a device. For information, see Step 2, Create a Test Pass Template.
To connect to a device
In the CTK, on the Connection menu, click Connect to Device.
Select the device that you want to connect to from the Select a Device dialog box, and then click OK.
The Connecting to device dialog box appears and displays the name of the device that you are trying to connect to and the progress of the connection attempt. If the connection to the device is successful, the Connection Output window displays the Successfully established connection message. If a device has previously been connected to, the Test pass display window opens and displays a No test pass message or a default test pass.
For more information, see Connect to a Device.
You are now ready to create a test pass template if you haven’t done so already.
Step 2: Create a Test Pass Template
Before creating a test pass, you must create a template to base the test pass on.
To create a test pass template
On the File menu, point to New, and then click Test Pass Template.
The Test Manager window appears, displaying the Test Case Explorer on the left side of the window and two tabs on the right side, Test Case Information and Test Pass Templates.
On the Test Pass Templates tab, under Edit Templates, click the New button.
In the new template name text box that appears, type Registry APIs to rename the template from New Template.
In the Test Manager window, in the Test Case Explorer tree view pane, expand Windows Embedded Test Catalog.
In the catalog tree, double-click the File System folder, and then double-click Registry.
Click Registry API and Functionality Test, and then click the Add button to add the selected test to the new Registry APIs template.
Click Done to exit Test Manager. Your template will be saved.
For more information, see Create a Test Pass.
You are now ready to create a test pass from the template you just created.
Step 3: Create a Test Pass from the Template
After you create the test pass template and connect to a device, you can create a test pass.
To create a test pass from a template
On the View menu, click Test Pass Templates View.
In the Test Case Explorer window, on the Test Pass Templates View tab, click the Registry APIs template.
Right-click the highlighted Registry APIs template, and then click Use as Current Test Pass.
Note
If Use as Current Test Pass is not available on the shortcut menu, you probably are not connected to a device.
Note
If a test pass already appears in the Test pass display window, you will be asked if you want to save the current test pass before a new test pass is created.
In the Test pass display window, click the new test pass Windows Embedded, and then type Registry API Test Pass to rename it.
For more information, see Create a Test Pass.
Step 4: Run a Test
You can run the test after you add the Registry API and Functionality Test test to a test pass.
To run a test
In the Test pass display window, expand the Registry API Test Pass test pass tree.
Right-click Registry API and Functionality Test, and then click Run Test.
When the Test pass display window changes from Registry API and Functionality Test [In Progress] to Registry API and Functionality Test [Passed], the test run is complete and you are ready to view the results of the completed test.
The green status bar at the bottom of the Windows Embedded CTK main window displays the progress of the test. As the test runs, Kernel Independent Transport Layer (KITL) debug message output is displayed in the Connection Output window.
For more information, see Run a Test.
Step 5: View Test Results
After the test run is complete, you are ready to view the results of the test.
To view the results for a test
In the Test pass display window, select Registry API and Functionality Test [Passed], right-click and then select View Test Results.
On the Registry API and Functionality Test results tab that opens, select Common Results View and locate the completed test run in the Test Case Results History table, and click the folder icon in the Log File(s) column.
In the Windows Explorer window that opens, locate the folder that contains the log files for the test run and open the results.log file to view the test debug output in Tux test harness (Tux) format.
Note
The test result logs are stored at the following location: C:\Users<username>\Compact Test Kit\results.
For more information, see View Test Results.