Downloading an OS Image to the Emulator

  • Article

Platform Manager provides a download service for the Emulator. For more information about download services, see Download Service Selection. The following procedure shows how to use the download service provided by Platform Manager to download an OS image to the Emulator.

Note   If you enabled support for a large OS image in the settings for your platform because you expect the size of your OS image to exceed 32 megabytes (MB), you must configure the Emulator to have 64 MB of memory. In the Memory (MB) box of the Configure Emulator Download Service dialog box described below, enter or select 64. For information about enabling support for a large OS image, see Enabling an OS Image Size Larger Than 32 MB.

To download an OS image to the Emulator

  1. From the Target menu, choose Configure Remote Connection.
  2. Choose the Services tab.
  3. In the Download box, choose Emulator.
  4. Choose Configure.
  5. To modify settings for the Emulator, in the Configure Emulator Download Service dialog box, perform any of the following tasks.
    Setting Task
    Screen Size (WxHxD) To specify the Emulator display settings, enter the width and height, in pixels, and the color depth, in bits.

    For width, enter or select a numerical value between 80 and 1024 that is a multiple of 8. For height, enter a numerical value between 64 and 768. For color depth, choose 8, 16, or 32.
    Skin File 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 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.

    If you choose Virtual Switch - Fixed IP: IP Address, then the Emulator uses the Ethernet adapter on the development workstation that currently has the specified Internet Protocol (IP) address. The Emulator supports incoming network connections. The IP address may change. The Emulator identifies the Ethernet adapter by the media access control (MAC) address of the Ethernet adapter.
    Serial Port 1 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.
  6. Choose OK.
  7. In the Kernel Transport box, choose Emulator.
  8. Choose the Settings tab.
  9. Under Download/Initialize Device, select the Download Image, Initialize (Jump to Image), and Connect to Device check boxes.
  10. Choose OK.
  11. From the Target menu, choose Download/Initialize.

See Also

Platform Manager | Emulated Hardware | Platform Downloading | How to Use Platform Builder to Connect to Multiple Devices | How to Connect to a Device for Debugging | How to Use Remote Call Profiler to Find Performance Problems

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.