Tutorial Step 2: Building the Custom Run-Time Image for the CEPC (Windows CE 5.0)

Windows CE 5.0
Send Feedback

After you create an OS design, you can build a run-time image based on that OS design.

In this step, you build a run-time image from the MyCEPCOSDesign OS design you created.

Before building the custom run-time image, you must choose a Debug configuration for your OS design. When you choose a Debug configuration, you can later debug your run-time image.

You must also change the value of an environment variable to accommodate the larger run-time image. The size of a run-time image based on a Debug configuration of an OS design is greater than the size of a run-time image based on a Release configuration.

To build the custom run-time image for the CEPC

  1. On the development workstation, from the Platform Builder Build OS menu, choose Set Active Configuration.
  2. From the list of configurations, select CEPC: X86_Debug and then choose OK.
  3. From the Platform menu, choose Settings.
  4. In Configuration, be sure CEPC: x86_Debug is selected.
  5. Choose the Build Options tab and verify that the following check boxes are selected:
    • Enable CE Target Control Support (SYSGEN_SHELL=1)

      Enabling CE Target Control Support for your OS design enables target control support for your OS design and enables kernel independent transport layer (KITL). For more information, see Target Control Service.

    • Enable Eboot Space in Memory (IMGEBOOT=1)

      Selecting this reserves space in the Config.bib file for your OS design, enabling the boot loader to save data that your OS can read at boot time.

    • Enable Full Kernel Mode (no IMGNOTALLKMODE=1)

      Enabling full kernel-mode for your OS design increases system performance in the run-time image. For more information, see Full-Kernel Mode

    • Enable KITL (no IMGNOKITL=1)

      Enabling full kernel-mode for your OS design increases system performance in the run-time image. For more information, see Full-Kernel Mode

    • Run-Time Image Can be Larger than 32 MB (IMGRAM64=1)

      Enabling the run-time image to be larger than 32 MB allows you to have larger run-time images. If your final run-time image requires more than 32 MB of space, the build process might not successfully complete.

    • Enable Kernel Debugger (no IMGNODEBUGGER=1)

      Enabling support for the kernel debugger allows you to debug the run-time image that you create based on your OS design.

  6. Save your changes and close the Platform Settings dialog box , by choosing OK.
  7. From the Build OS menu, verify that the following are selected:
    • Copy Files to Release Directory after Build
    • Make Run-Time Image After Build

    By default, these options are selected when you create a new workspace in Platform Builder.

  8. From the Build OS menu, choose Build and Sysgen.

    Select this option if you want to build all the files in your OS design.

The time required by Platform Builder to build the run-time image depends on the number of Catalog items that are included in the OS design. In this example, you are building a large run-time image based on an OS design which contains many items, so it may take as long as 20 minutes to build the run-time image.

You can observe the build process in Platform Builder. The progress of the build process is displayed on the Build tab of the Output window. When the build is complete, you see the following message: MyCEPCOSDesign - 0 error(s), XX warning(s).

See Also

Tutorial Step 3: Creating a Boot Floppy Disk for the CEPC | Tutorial Step 1: Creating a Custom OS Design for a CEPC | Tutorial: Building a Run-Time Image for a CEPC | Tutorials | Creating an OS Design with the New Platform Wizard | Platform Settings: Build Options Tab

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.