How to Configure and Build a Run-Time Image for a CEPC

  • Article

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

8/27/2008

Before you build a run-time image for a Windows Embedded CE PC-based platform (CEPC), you might have to change settings in the Platform Builder IDE. Whether you do depends on your CEPC hardware requirements and your development goals. Also, you might have to configure your run-time image to reside in a larger amount of RAM than the default amount of 28 MB specified the %_WINCEROOT%\PLATFORM\CEPC\FILES\Config.bib file. If you want to support kernel debugging, profiling, or other build options, you must specify these options in the IDE.

Hardware and Software Assumptions

Steps

Step Topic

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

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

2. Customize your OS design by selecting items from the Catalog or deleting items from your OS design.

Adding an Item from the Catalog

Modifying an OS Design

3. Based on your development goals, configure the settings for your run-time image in the <OSDesignName> Properties dialog box.

Modifying OS Design Settings

4. Choose a Debug or Release 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

Building a Run-Time Image From a Release Configuration

5. Decide whether to enable kernel independent transport layer (KITL) for debugging activities.

Supporting KITL in an OS Design

6. Check the dependencies of the Catalog items in your OS design.

  1. In the Catalog Items View, right-click a Catalog item and select Show Dependencies.
  2. In the Catalog Items Dependencies window, Expand Depends On node to discover which Catalog items that the selected item must include as dependencies. Then, expand Dependency Of to discover which Catalog items must include the selected item as a dependency.

Not applicable

7. Modify the MEMORY section in the %WINCEROOT_%\PLATFORM\CEPC\FILES\Config.bib file by setting the environment variable that specifies the amount of RAM on your CEPC hardware or the amount of RAM you want to simulate.

By default, the %WINCEROOT\PLATFORM\CEPC\FILES\Config.bib file specifies 28 MB of RAM, and then the OEM Adaptation Layer (OAL) scans for additional memory at run time, for up to a total of 64 MB.

  • If your CEPC has 16 MB of RAM, or you want to simulate 16 MB of RAM, set the IMGRAM16 environment variable.
  • If your CEPC has 32 MB of RAM, or you want to simulate 32 MB of RAM, set the IMGRAM32 environment variable.
  • If your CEPC has 64 MB of RAM, or if you want to simulate 64 MB of RAM, from the Project menu, choose Properties. Then, select the Build Options node, select Run-time image can be larger than 32 MB (IMGRAM64=1).
  • If your CEPC has 128 MB of RAM, or if you want to simulate 128 MB of RAM, set the IMGRAM128 environment variable.

Setting or Clearing an Environment Variable (Visual Studio)

Supporting or Simulating More than 64 MB of RAM

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

Building a Run-Time Image

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

Not applicable

10. View the size of the run-time image.

Viewbin Tool

See Also

Tasks

How to Decrease Run-Time Image Size on a CEPC

Concepts

Configuring System Memory
OEMAddressTable

Other Resources

How-to Topics
Binary Image Builder File