Configuring the CETK to Communicate with a Target Device
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/27/2008
For the Windows Embedded CE 6.0 Test Kit (CETK) to communicate successfully with a target device, the port number specified in the CETK application on the development workstation must match the port number specified for the target device. After you configure the port number settings, you can start the Clientside.exe application on the target device and establish a connection.
For information about supporting the CETK on your Windows Embedded CE–based device, see Manual Connection of the CETK to a Target Device.
To configure the CETK to communicate with a target device
In the CETK window, from the Server menu, choose Server Settings, and then choose the Communications tab.
In the Port to use to connect to a target device box, type the number of a port for the CETK to use to communicate with the target device.
- or -
Leave the default value in the Port to use to connect to a target device box.
Port 5555 is the default port over which the CETK communicates. If you build support for the CETK into a run-time image, the target device is also configured by default to use port 5555.
To close the Server Settings dialog box and save your changes, choose OK.
If you do not plan to specify a command line parameter when you run Clientside.exe, configure Clientside.exe by editing the Wcetk.txt file in the release directory for your platform.
Note
If you add support for the CETK to the target device by manually copying Clientside.exe to the target device, no Wcetk.txt file exists in the release directory. If you want to use Wcetk.txt, you must create a Wcetk.txt file in the release directory. For information about the contents of Wcetk.txt and to view the contents of a sample Wcetk.txt file, see Wcetk.txt and Clientside.exe Settings for the CETK.
In Wcetk.txt, add a PORTNUMBER=XXX line, where XXX is the number of the port that you specified in the Server Settings dialog box. If there is an existing PORTNUMBER line, delete it, and then save Wcetk.txt.
- or -
Specify settings in the registry for the target device. In the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CETT registry key, create a PortNumber entry with a value that matches the number of the port that you specified in the Server Settings dialog box.
For more information, see Wcetk.txt and Clientside.exe Settings for the CETK.
**If a Windows Embedded CE OS is not already running on the target device, download your run-time image to the target device. **Boot **the run-time image on **the target device.
On the target device, run Clientside.exe. If you did not specify a port number in Wcetk.txt or in the registry for the target device, run the command Clientside /p XXX, where XXX is the number of the port that you specified in the Server Settings dialog box.
**- or -
In Platform Builder, from the Target menu, choose Run Programs, select Clientside.exe, and then choose Run.**
To confirm that you have established communication with the target device, view the CETK window, and then, under Windows Embedded CE Test Server, view the target device.
It might take a few seconds for communication to be established with the target device.