Downloading a Run-Time Image to the x86 Emulator (Windows CE 5.0)
The following procedure shows how to use Platform Builder to download a run-time image to the Emulator. Alternatively, you can run the Emulator from the command line. For information about running the Emulator from the command line, see Emulator Command-Line Launch Options.
Note If you enabled support for a large run-time image in the settings for your OS design because you expect the size of your run-time image to exceed 32 megabytes (MB), you must configure the Emulator to have 64 MB of memory. In the Memory (MB) box of the Emulator Download Settings dialog box described below, enter or select 64. For information about enabling support for a large run-time image, see Enabling a Run-Time Image Size Larger Than 32 MB.
To download a run-time image to the Emulator
- From the Target menu, choose Connectivity Options.
- Choose Kernel Service Map.
- In the Download box, choose Emulator.
- Choose Settings.
- To modify settings for the Emulator, in the Emulator Download Settings dialog box, perform any of the following tasks.
Setting Task Display To specify the Emulator display settings, enter the width and height, in pixels, and the color depth, in bits. In the Width box, enter or select a numerical value between 80 and 1024 that is a multiple of 8. In the Height box, enter a numerical value between 64 and 768. In the Color Depth box, choose 8, 16, or 32.
Emulator skin To apply a skin to the Emulator, select this setting, and then enter the path and file name of the .xml file that contains information for an Emulator skin. Memory (MB) To allocate memory to the Emulator, enter the amount of memory, in megabytes (MB), to allocate for the Emulator. Enter or select a numerical value between 4 and 256. Host key To choose the host key for the Emulator, choose a key from the list. For more information about host keys, see Emulator Key Combinations.
Retain foreground priority To require the Emulator to run at foreground priority at all times, even when it is in the background, select this check box. Ethernet support To specify the level of networking support in the Emulator, choose an entry from the list. If you choose Disabled, then the Emulator does not support networking.
If you choose NAT (Outgoing only), then the Emulator supports outgoing network connections only. Over an Ethernet connection, the Emulator cannot receive information that it did not request. In this mode, servers such as the FTP server and the Web server (HTTPD) do not work correctly. There may also be problems with connecting over a virtual private network (VPN) or connecting with Point-to-Point Tunneling Protocol (PPTP).
If you choose Virtual Switch, then the Emulator uses the first Ethernet adapter that it finds on the development workstation. The Emulator supports incoming network connections.
Serial port 1 (Serial debug output) To map the first virtual communications (COM) port for the Emulator, choose a mapping method from the list. You can map the port to a physical COM port on the development workstation, direct the output of the virtual port to a file, or make the virtual port inactive. If you choose to map the virtual COM port to a physical port, the Emulator attempts to take control of a serial port on the development workstation. If a process on the development workstation locks the serial port, the Emulator fails to take control of it.
For more information, see Emulated Hardware.
Serial port 2 To map the second virtual COM port for the Emulator, choose a mapping method from the list. Parallel port To choose a parallel port for the Emulator, choose a port from the list. - Choose OK.
- In the Transport box, choose Emulator.
- Choose Core Service Settings, and then verify that the settings under Download Image and KITL Settings reflect your preferences.
- Choose Apply.
- From the Target menu, choose Attach Device.
See Also
How to Connect to a Target Device for Debugging
Send Feedback on this topic to the authors