Configuring an Ethernet Remote Connection
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
When you configure an Ethernet remote connection, you must configure your target device and development workstation with a suitable IP address. By default, the sample BSPs are enabled to use the Ethernet download service. For more information, see TCP/IP and the DHCP Client.
For more information about the types of Ethernet connections, see Ethernet Connection Options.
The VMINI Ethernet sharing library enables a debug Ethernet card to be used for both downloading and debugging a run-time image. The VMINI Ethernet sharing library is enabled by default. Therefore, you do not have to free an Ethernet controller for product Ethernet.
The VMINI Ethernet sharing library is in %_WINCEROOT%\Public\Common\Oak\Drivers\Ethdbg\VMINI.
If you want to use a built-in Ethernet port for product Ethernet, you must disable Ethernet downloading. For information about other BSPs, see Supported Board Support Packages.
Note
To select the target device after Platform Builder discovers it on the Ethernet network, you must know the alpha-numeric device ID for your device.
To configure an Ethernet remote connection
Set or clear environment variables based on the type of Ethernet card by doing one of the following:
- For PCI-based NE2000 network adapters, verify that BSP_NIC_NE2000_PCI is set and BSP_NIC_NE2000_ISA is cleared.
- For ISA-based NE2000 network adapters, verify that BSP_NIC_NE2000_ISA is set and BSP_NIC_NE2000_PCI is cleared.
For more information about how to set and clear environment variables, Setting or Clearing an Environment Variable (Visual Studio)
From the Target menu, choose Connectivity Options to open the Target Device Connectivity Options window.
Under Device Configuration, choose Add Device. Type a descriptive name for the device, and choose Add.
Under Service Configuration, choose Kernel Service Map. In the Target Device box, choose the descriptive name.
From the Download list, select Ethernet, and then choose Settings.
Start the target device.
In the Ethernet Download Settings window, look for the alpha-numeric device ID of your target device to appear in the Active Devices list. When the alpha-numeric device ID appears, select it.
If the alpha-numeric device ID does not appear in the Active Devices list, you might have to restart your target device so that Platform Builder can discover it and its device ID appears in the Active Devices list.
To apply the configured settings to your target device and return to the Target Device Connectivity Options window, choose OK.
In the Kernel Service Map page, locate the Transport list and select Ethernet. Then, choose Settings.
Verify that your target device appears as the selected device in the Ethernet KITL Settings window. Then, choose OK.
To save your settings, choose Apply. Then, choose Close.
See Also
Tasks
How to Configure and Download a Run-Time Image to a CEPC
Configuring a Serial Remote Connection