How to Develop an OS Design by Using a Design Template

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/27/2008

To create a run-time image on a Windows Embedded CE PC-based hardware platform (CEPC), you can start to build an operating system (OS) design either by using the Windows Embedded CE OS Design Wizard that includes a preconfigured design template, or by manually selecting the necessary Catalog items from the Catalog.

This topic describes how to build an OS design by using a design template from the Windows Embedded CE OS Design Wizard.

Hardware and Software Assumptions

  • Your Platform Builder installation includes the CEPC x86 board support package (BSP).
  • You have a CEPC that is already configured. For more information, see How to Set Up a CEPC. **
  • You have a boot disk for the CEPC. For more information, see Creating a Boot Floppy Disk for an x86 SDB.
  • Your CEPC hardware meets one of the following requirements:
    • Your CEPC has 32 MB RAM for a typical run-time image built from a Release configuration.
    • Your CEPC has 64 MB RAM for a typical run-time image built from a Debug configuration. Run-time images built from Debug configurations can be larger than those built from release configurations, and can require more memory to run.
  • If you plan to create your OS by using the Digital Media Receiver design template, the sound and video hardware in your CEPC is supported by a driver included with Windows Embedded CE, as listed in Windows Embedded CE Drivers.
    To use a driver not included with Windows Embedded CE, add it to the Catalog in Platform Builder. For more information, see How to Add a Device Driver to the Catalog.
  • If you plan to create your OS by using the Set-Top Box design template, your test equipment meets the audio and video requirements of your design. The default Set-Top Box design template includes drivers and software support for standard VGA. However, to test a design template that uses a TV-style interface, you must include a TV-style monitor and appropriate drivers together with your test hardware. For more information about Windows Embedded CE multimedia support, see Encoded Media.

Steps

Step Related information

1. Use the Windows Embedded CE OS Design Wizard to select a design template and the initial components for your OS design.

For the BSP page, the following list shows the options that you have:

  • If you are targeting a CEPC, choose CEPC x86.
  • If you are targeting a Device Emulator, choose Emulator x86.

Creating an OS Design with the Windows Embedded CE OS Design Wizard

2. (Optional) Customize the OS design.

Customizing an OS Design

3. Choose a Debug configuration to target when Platform Builder builds the OS design into a run-time image.

To use the kernel debugger, make sure that support for the kernel debugger is enabled.

Levels of Debugging Support

Building a Run-Time Image From a Debug Configuration

4. If you expect the size of either the debug or the release run-time image to exceed 32 MB, enable support for a large run-time image in the settings for the OS design.

Cc440210.note(en-US,WinEmbedded.60).gifNote:
Debug run-time images are typically larger than release run-time images. If you choose a debug configuration and the OS design contains many features, it is likely that the size of the run-time image will exceed 32 MB.

Enabling a Run-Time Image Size Larger Than 32 MB

5. Build the OS design into a run-time image.

Building a Run-Time Image

6. In the Output window, on the Output tab, verify that the build contains no errors.

Build Error Debugging Process

7. (For CEPCs) Choose a download service appropriate for the connection hardware. The download service will download a run-time image to the target device.

Download Service Selection

8. (For CEPCs) Set up and configure the connection hardware required for the download service. That hardware connects the target device to the development workstation, on which Platform Builder is installed. Examples of connection hardware include cables, a hub, or Ethernet network adapters.

Hardware Configuration

9. (For CEPCs) If you selected Serial Download Service in step 7, configure the HyperTerminal terminal-emulation application to display the serial debug output from the serial port on the target device.

This configuration requires a null-modem cable connected to a serial port, such as COM1.

Configuring HyperTerminal for BSPs

10. (For CEPCs) Turn on the CEPC so that it becomes active on the Ethernet network or over the serial connection, and Platform Builder can discover it.

No further information

11. (For CEPCs) Configure the connection to the target device.

For connecting to a CEPC, choose the appropriate topic based on whether the development workstation and the CEPC are connected by an Ethernet network or a serial-port connection.

Configuring an Ethernet Remote Connection

Configuring a Serial Remote Connection

12. (For Device Emulator) Configure the connection to the target device.

For connecting to the Device Emulator, complete the following tasks:

  • Configure DMA connectivity.
  • If the Device Emulator needs a network connection, enable emulation of the PCMCIA NE2000 adapter.
  • Configure property settings for the Device Emulator.

Configuring DMA Connectivity Settings for the Device Emulator

Configuring Network Connectivity for a KITL over DMA Device Emulator Image

Configuring Property Settings for the Device Emulator

13. Download the run-time image.

  • For a CEPC, download the run-time image to the CEPC.
  • For the Device Emulator, download the run-time image to the Emulator.

Downloading a Run-Time Image to a CEPC

Downloading a Run-Time Image to the Device Emulator

14. Test the run-time image.

  • (Optional) If your OS design supports Windows Media Audio, to play one of the system sounds by using Windows Media Player, browse to the \Windows directory and double-click the .wav file you want.
  • If your run-time image connects to the Internet, test your new OS on the CEPC. For more information, see Testing an Internet connection from a CEPC
  • If your run-time image connects to the local network, test your OS design by accessing the local network. For more information, see How to Add a CEPC to an Ethernet Network.

Debugging and Testing a Run-Time Image

Tools for Testing from the CETK

15. (Optional) Create an application for your OS design.

How to Develop an Application for a CEPC

16. (Optional) Create end-user documentation for the target device.

Creating End-User Documentation for an OS Design

See Also

Concepts

Developing a Target Device by Using a Design Template

Other Resources

How-to Topics
Developing a Target Device