How to Use the CETK to Test a Driver
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
You can use the Windows Embedded CE 6.0 Test Kit (CETK) (CETK) to test a Windows Embedded CE–based device driver. You can connect the CETK to a Windows Embedded CE–based device and then select a test or tests to run on the target device. The CETK provides tests for several categories of peripheral devices. You should use the CETK to test a device driver after you develop the driver and after you have a run-time image on your target device.
Hardware and Software Assumptions
The target device must include the hardware for which you have developed the driver. Any other hardware or software required by your driver must also be present. For a custom test, the relevant DLLs must be included.
Steps
Note that steps 2, 10, 12, and 13 are optional.
| Step | Topic |
|---|---|
1. Use the Windows Embedded CE OS Design Wizard to select a design template and the initial components for the OS design, or open an existing OS design. Or, If you have already downloaded a run-time image to a Windows Embedded CE powered device, start the device to be tested. |
Creating an OS Design with the Windows Embedded CE OS Design Wizard |
2. (Optional) You may add support for the CETK to the OS design before building a run-time image. After you download a run-time image to a target device, Platform Manager can dynamically add support for the CETK to the running target device by copying the Clientside.exe file to the target device. As an alternative to adding CETK support to the OS design, you can add support for the CETK to a running target device. To do this, copy Clientside.exe to the target device. In %_WINCEROOT%\Others\Wcetk, the Clientside.exe file is located in a directory with a name corresponding to the name of the CPU for your target device. For more information about manually adding support for the CETK, see Running the CETK Tool without the CETK Client in the Run-Time Image. |
Adding Support for the CETK to an OS Design in Platform Builder |
3. Build the OS design into a run-time image if you have not already done so. |
|
4. In the Output window, on the Output tab, verify that the build contains no errors. |
|
5. Choose a download service appropriate for the connection hardware. The download service will download a run-time image to the device to be tested. |
|
6. Set up and configure the connection hardware required for the download service. That hardware connects the device being tested to the development workstation, on which Platform Builder is installed. Examples of connection hardware include cables, a hub, or Ethernet network adapters. |
|
7. If you selected Serial Download Service in step 5, configure the HyperTerminal terminal emulation application to display the serial debug output from the serial port on the device to be tested. This configuration requires a null-modem cable connected to a serial port, such as COM1. |
|
8. Turn on the device to be tested so that it becomes active on the Ethernet network or over the serial connection, and Platform Builder can discover it. |
Not applicable |
9. Download the run-time image onto the device to be tested through the configured connection. |
|
10. (Optional) If you want to define the characteristics of a custom test, create a custom Tux Test Harness (Tux) dynamic-link library (DLL). After creating a Tux DLL, use the User-Defined Test Wizard to add your test to the CETK. The CETK provides a standard set of tests that you can run on your target device. |
|
11. Configure the settings for communication between the CETK and the target device, and then connect the CETK to the target device. |
Connecting the CETK to a Target Device by Using Platform Manager |
12. (Optional) Designate the directory on your development workstation where the CETK stores the results of CETK tests that are run. |
|
13. (Optional) Configure the CETK to consolidate the results of several tests into a .cab file after the tests are complete. You can also choose to encrypt the results of a test. Encryption prepares the results of a test for submission to the Driver Validation Program. For more information about the Driver Validation Program, see this Microsoft Web site. |
|
14. Familiarize yourself with the CETK tests and decide which test or tests you want to run. |
|
15. Run your desired test on your device. You can also run all of the tests that are selected for a target device, or specify which tests you want to run. For more information, see Running CETK Tests. |
|
16. View the results of your test or tests. |
If you select multiple tests to run on the target device, you can save your selection of tests for future use as a test suite. For more information, see Creating a Suite of Tests.