On the device, start the OS.

Copy TCPBootstrapA.exe from your development computer to the device. On your development computer, this file is in C:\Program Files\Microsoft Remote Framework Tools\1.10\target\wce700\<Hardware Platform>. For example, for the vCEPC, which is based on the x86 hardware platform, the location of TCPBootstrapA.exe is C:\Program Files\Microsoft Remote Framework Tools\1.10\target\wce700\x86.

Alternatively, you can incorporate the file into the OS by following the instructions in How to Incorporate Files into an OS. If you add a file to the OS, you must rebuild the OS, but after it is rebuilt, you will not need to manually copy the file each time.

On the device, at a command prompt, type: TCPBootstrapA.exe

Note:

To prevent the TCP Bootstrap service on the device from prompting for connection confirmation, you can start TCPBootstrapA.exe on the device by typing: TCPBootstrapA.exe /acceptall After you finish using the Remote Tools Framework, you may want to shut down the TCP Bootstrap service on the device for security reasons. To do so, open a different Command Prompt window and type TCPBootstrapA.exe /shutdown or type TCPBootstrapA.exe and then, in the TCP Bootstrap dialog box that appears, click Yes to confirm that you want to shut it down.

On the development computer, start the Remote Tools Shell. To access the Remote Tools Shell, click Start, then All Programs, then Microsoft Remote Tools Framework 1.10, and then Remote Tools Shell.

In the Remote Tools Shell, click Connection, and then click Manage Devices.

Expand Windows CE, click Windows CE Device, and then click Properties.

Select Show all registered transports and Show all registered bootstraps.

Under Transport, select TCP Connect Transport.

Under Startup, select TCP Bootstrap, and then click Configure.

Your device appears under Active Devices. Double-click it to select it as the target device, and then click OK.

Note:

If your device did not appear under Active Devices, verify that you started tcpbootstrapa.exe (or tcpbootstrapa.exe /acceptall) on the device. Also, verify that your development computer and your device are on the same subnet (if not, you must have a router that forwards broadcasts). If you cannot get your device to appear under Active Devices, try the CoreCon connection method described later in this article.

Click OK as needed to exit the configuration dialog boxes.

On the development computer, in the Remote Tools Shell, start a remote tool by doing one of the following:

• Click File, click Collect Live Data, and then click a remote tool from the list.
• In the Remote Tools Shell window, in the Collect Live Data pane (which is below the Getting Started pane), click a remote tool.

 An Options dialog box appears.

In the Options dialog box, expand Physically Connected Devices, select Mobile and Embedded Device, and then click OK.

Important:
Always select Mobile and Embedded Device, even if you are using a vCEPC or if you have created a custom device that shows up in the device list.

On the device, in the TCP Bootstrap, A connection request has been received. Allow the client to connect? dialog box, click Yes.

Note:
This dialog box will not appear if you used the /acceptall option when starting TCPBootstrapA.exe.

The development computer and the device establish a connection, and the remote tool is started.

On the device, start the OS.

Copy the CoreCon files from your development computer to the device (if they are not already on the device). 

On your development computer, these files are automatically installed when you install Visual Studio 2008. They typically install to C:\Program Files\Common Files\Microsoft Shared\CoreCon\1.0\Target\Wce400\<Hardware Platform>. For example, for the vCEPC, which is based on the x86 hardware platform, these files are in C:\Program Files\Common Files\Microsoft Shared\CoreCon\1.0\Target\Wce400\x86.

The CoreCon files to copy to your device are:

• clientshutdown.exe
• CMAccept.exe
• ConmanClient2.exe
• eDbgTL.dll
• TcpConnectionA.dll

Alternatively, you can incorporate the CoreCon files into the OS by following the instructions in How to Incorporate Files into an OS. If you add the files to the OS, you must rebuild the OS, but after it is rebuilt, you will not need to manually copy the files each time.

On the device, at a command prompt, type ipconfig to get the IP address of the device. The Command Prompt window displays the Ethernet adapter settings. Make a note of the IPv4 address. (If the Ethernet adapter settings are not displayed, your OS may not include support for ipconfig, which is provided through the Network Utilities catalog item (SYSGEN_NETUTILS).)

In Visual Studio, click Tools, and then click Options.

In the Options dialog box, expand Device Tools, and then click Devices.

Under Show devices for platform, select All Platforms.

From the Devices list, select Windows CE Device, and click Properties.

Important:
Always select Windows CE Device even if devices you have created show up in the device list.

Under Transport, select TCP Connect Transport, click Configure, select Use specific IP address, and enter the device’s IP address that you obtained in a previous step.

Under Bootstrapper, select TCP Bootstrap.

Click OK as needed to exit the Options dialog box.

On the development computer, start the Remote Tools Shell. To access the Remote Tools Shell, click Start, then All Programs, then Microsoft Remote Tools Framework 1.10, and then Remote Tools Shell.

On the device, at a command prompt, type: ConmanClient2

On the device, open another Command Prompt window and type CMAccept. CMAccept temporarily disables the device’s security to enable the development computer to connect to the device.

Important:

Quickly move to the next step because you have only three minutes to initiate a connection between your development computer and your device. The three-minute window is enforced by CMAccept. CMAccept temporarily disables the device’s security, so it only runs for three minutes before it returns (it also returns once a connection is established). You can eliminate the CMAccept step by disabling security on the device during development. To do so, set HLKM\System\CoreConOverrideSecurity = 1 DWORD value in the registry. For information on how to change registry settings, see the video Compact 7 OS Design - Editing the registry. Disabling security exposes your device to malicious attack and we do not recommend it unless you have provided appropriate safeguards.

On the development computer, in the Remote Tools Shell, start a remote tool by doing one of the following:

• Click File, click Collect Live Data, and then click a remote tool from the list.
• In the Remote Tools Shell window, in the Collect Live Data pane (which is below the Getting Started pane), click a remote tool.

An Options dialog box appears.

In the Options dialog box, expand Physically Connected Devices, select Mobile and Embedded Device, and then click OK. The development computer and the device establish a connection, and the remote tool is started. (If a connection cannot be established, it may be because the three-minute connection initiation window has expired. On the device, restart CMAccept and try to connect again.)

Important:
Always select Mobile and Embedded Device, even if you are using vCEPC or if you have created a custom device that shows up in the device list.

After you establish the initial connection between your development computer and the device, you can use different remote tools that you access through that instance of the Remote Tools Shell. (If you close and restart the Remote Tools Shell, or if you start another instance of the Remote Tools Shell, you will need to restart CMAccept.)