Share via

Starting the CETK

  • Article

Before you use the CETK, you must add support for the CETK tests to your platform. You can add this support to your platform prior to building it.

The CETK requires an Ethernet connection from the target device to the network on which the development workstation resides. You cannot run the CETK tests over a debug Ethernet connection.

To add the CETK tests to your platform in Platform Builder

  1. In the Catalog, expand the Device Drivers node, and then right-click on Windows CE Test Kit.
  2. Choose Add to Platform.
  3. From the Build menu, choose Build Platform to build the OS image for your platform.
  4. After the OS image builds, download the OS image to a Windows CE-based device.

After you download the OS image to the target device, you can run the CETK client software on the downloaded OS.

To run the CETK client software on a target device connected to a development workstation running Platform Builder

  1. In the Platform Builder integrated development environment (IDE), from the Target menu, choose Run Programs.
  2. Select Clientside.exe, and then choose Run.

You can now run the CETK tool on your development workstation.

To run the CETK tool on your development workstation

  1. Choose Start, and then choose All Programs.
  2. Choose MicrosoftWindows CE .NET 4.2, and then choose Windows CE .NET 4.2 Test Kit.

To run the CETK tool without adding the CETK client software to your OS image

  1. Copy the Clientside.exe file to your Windows CE-based device.

    On the development workstation, the Clientside.exe file is located at %_WINCEROOT%\Others\Wcetk\<CPU>.

  2. On your Windows CE-based device, from the Start menu, choose Run and then type the location of the Clientside.exe file followed by the name and port number of the CETK server.

    For example, by typing clientside /n=machine1 /p=5555 you can run the Clientside.exe executable and connect to machine1 using port number 5555. If you edit the command line for Clientside.exe in this fashion, you must specify at least a server name or address and a port number.

    - or -

    Edit the Wcetk.txt file located in the directory in which the Clientside.exe file resides. Platform Builder creates a Wcetk.txt file in the release directory for your platform if you add support for the CETK to the platform prior to building the platform.

    - or -

    Create a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CETT registry key on the target device, or modify this registry key if it already exists. Clientside.exe reads settings from this registry key only if both command-line options and a Wcetk.txt file are not found.

    On the development workstation, you can modify the registry of the target device by editing the Common.reg or Platform.reg file, or by editing the Project.reg file for your platform. The settings in the Project.reg file are specific to the OS image being built, so you can edit the Project.reg file without affecting the overall behavior of Platform Builder. The settings in the Common.reg and Platform.reg files affect all OS images built on the development workstation.

    When you build the OS image for the platform, the information from the .reg file is built into the OS image. As an alternative, you can use the Remote Registry Editor tool to modify the registry of a target device while the target device runs.

    The following table shows the settings that you can specify in a Wcetk.txt file. For each setting, the table also shows the equivalent command-line option for Clientside.exe and the equivalent registry entry on the target device.

    Wcetk.txt setting Equivalent Clientside.exe option Equivalent target device registry entry Description
    SERVERNAME 
    /n
    		 ServerName, with REG_SZ data type. Computer name of the CETK server. The computer name must resolve to an Internet Protocol (IP) address. You cannot specify both SERVERNAME and SERVERIP for the CETK server.
    SERVERIP 
    /i
    		 ServerIP, with REG_SZ data type. IP address of the CETK server. You cannot specify both SERVERNAME and SERVERIP for the CETK server.
    PORTNUMBER 
    /p
    		 PortNumber, with REG_DWORD data type. Number of the port over which the CETK server communicates with the target device. You can find the port number in the Server Settings dialog box. For more information, see CETK Tool Operation.
    AUTORUN 
    /a
    		 Not applicable. You cannot automatically start running tests using registry settings. When assigned a value of 1, the target device automatically starts running tests after the connection to the CETK server is established and detection of peripheral devices completes. If you specify any value not equal to 1, the target device connects and peripheral devices are detected, but tests do not launch without manual input.
    DEFAULTSUITE 
    /s
    		 DefaultSuite, with REG_SZ data type. Name of a test suite. If you do not specify a test suite, the default tests are selected. For more information about test suites, see Creating a Suite of Tests.

    Note   You can add comments to a Wcetk.txt file. A comment line begins with a semicolon.

    The following text shows the contents of a sample Wcetk.txt file.

    SERVERNAME=MyWorkstation
PORTNUMBER=5555
AUTORUN=0
DEFAULTSUITE=My Suite

The CETK searches for a Wcetk.txt file when you specify no command-line options for Clientside.exe. The CETK looks first for the Wcetk.txt file in the root directory and the Windows directory on the target device. If the CETK does not find a Wcetk.txt file in either of these locations, it then looks for the file in the release directory on the development workstation.

See Also

How to Use the CETK to Test a Driver | Configuring the CETK to Communicate with a Target Device | Windows CE .NET Test Kit

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.