Target Control Service (Windows CE 5.0)

Enabling the Target Control Service (Windows CE 5.0)

To enable the target control service, you must first build a run-time image that supports the tool. When you enable Target Control, Platform Builder includes shell.exe, in the run-time image.

By default, a run-time image that supports Target Control includes KITL, regardless of the build options you choose.

For more information about enabling Target Control during the build process, see How to Use the IDE to Create, Customize, and Build a Run-Time Image.

When enabled, Target Control runs independently as a connectivity service. For general information about connectivity services, see Core Connectivity Overview.

To enable the target control service

1. In the command-line window, type
   Set IMGNOKITL = 
   

   This enables KITL transport support in the run-time image

2. From the Platform menu, choose Settings.
3. On the Build Options tab, select one or more of the following options.
   • Enable CE Target Control Support

     Select before building the run-time image to allow the Target Control service to connect and pass information from the target device to the host. Target Control requires a KITL transport.

   • Enable KITL

     Select to enable KITL as a transport layer for communication between the development workstation and the target device for debugging.

4. From the Target menu, choose Connectivity Options.
5. Choose Core Service Settings.
6. Choose the following KITL settings:
   • To instruct Platform Builder to boot the target device in active KITL mode, choose Enable KITL on device boot.
   • To enable loading files in the flat release directory from the target device, choose Enable access to desktop files.
7. Choose OK.

Target Control Service (Windows CE 5.0)

You can use the Target Control service to transfer files to a target device, to access files on the development workstation from a target device, and to debug applications.

If enabled during the build process, Target Control starts by default when you download a run-time image to a target device over an Ethernet connection, a USB connection, a serial port connection, or a connection to the Emulator.

Windows CE Target Control provides the following functionality.

Functionality	Description
Display the Target Control window	Opens the Target Control window for entering Target Control commands. For more information, Target Control Window.
Reset a device	Resets the target device.
Run programs	Selects an application to run on the target device.
View CE information	Opens the following view windows: Debug Zones Dialog Box Processes Window Threads Window Modules and Symbols Window Exceptions Dialog Box

When you enable Target Control, Platform Builder includes the shell tool, shell.exe, in the run-time image. The release directory on the development workstation includes a Shell.exe file, FSAUXIN that serves as a command interpreter. Shell.exe periodically polls the FSAUXIN file and executes any commands in it.

The development workstation writes commands to the FSAUXIN file, and the Shell.exe process on the target device executes the commands. Messages are sent to Shell.exe on the target device by adding commands to the FSAUXIN file.

Shell.exe sends the output of commands over a KITL stream named CESH.