Configuring a Connection for Downloading and Debugging
Other versions of this page are also available for the following:
.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.")
.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
With Platform Builder, you can configure settings that affect how a run-time image downloads to a target device and how Platform Builder communicates with the target device after the Windows Embedded CE OS starts up.
To configure a connection for downloading and debugging
From the Target menu, choose Connectivity Options.
Choose Kernel Service Map.
In the Target Device box, choose a target device.
Note
Platform Builder provides a default target device called CE Device that appears in the Target Device box.
Note
To add your device and give it a unique name, see Creating a Named Connection.
In the Download box, choose a download service.
The download service is used for downloading a run-time image to a target device over a specific type of connection, such as an Ethernet connection, a Serial connection, or communications with the Device Emulator. For more information, see Target Device Connectivity Options: Download Service Dialog Box.
To the right of the Download box, choose Settings.
Configure the settings for the download service, and then choose OK.
If a connection to a target device is already configured, the settings associated with the connection to the target device appear in the Download box and the Transport box. If the IP address of the target device changes, then each time you download, you must re-select the settings to reconfigure the target device and reset the IP address.
For an Ethernet connection only, the development workstation and target device must be on the same subnet. Otherwise, you cannot connect to the target device or debug a Windows Embedded CE OS on the target device.
In the Transport box, choose a kernel transport service. This should match the download service that you selected in step 4.
To the right of the Transport box, choose Settings.
If necessary, modify the settings for the kernel transport service, and then choose OK.
The kernel transport service that you select might not have configurable settings, or the kernel transport service might already be configured to use the same settings as the download service. For more information, see Target Device Connectivity Options: Transport Dialog Box.
If your run-time image includes support for one or more debuggers, the debugger driver names will appear as options in the Debugger box, such as KdStub for the kernel debugger.
For the kernel debugger, choose KdStub.
For hardware-assisted debugging, choose the name of the eXDI driver installed by the hardware-assisted debugger you want to use.
- or -
If your run-time image does not include support for a debugger, from the Debugger box, choose None.
Choose Core Service Settings.
To instruct Platform Builder to download a run-time image each time Platform Builder connects with the target device, under Download Image, choose Always.
- or -
To instruct Platform Builder to download a run-time image if the run-time image on the development workstation differs from the run-time image on the target device, under Download Image, choose Only if image changed.
- or -
To instruct Platform Builder to download a run-time image only the first time Platform Builder connects with the target device, under Download Image, choose Only on initial download.
- or -
To instruct Platform Builder to jump to the run-time image on the target device, under Download Image, choose Never (jump to image only).
Choose Apply.