How to Configure and Build an OS Image for a CEPC

  • Article

Before building an OS image for a CEPC, you may need to change settings in the Platform Builder IDE to configure your platform for your CEPC hardware requirements and your development goals. If you use a full-featured or a debug configuration, configure your platform to reside in a larger amount of RAM than the default amount of 28 megabytes (MB) specified the 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

To track your progress in the following table, select the check box next to each step.

  Step Topic
1. Use the Platform Wizard to select a configuration and the initial components for your platform.

For more information about the platform creation process, see Platform Creation with the New Platform Wizard.

 Creating a Platform
2. Customize your platform by selecting additional features from the Catalog or deleting features from your platform. Adding a Feature from the Catalog
3. Configure settings for your platform based on your development goals.

For more information about platform settings you can configure, see Platform Settings.

 Modifying Platform Settings
4. Check the dependencies of the features in your platform.
  • You do not need to build your OS image to view the dependencies.
 How to Check the Dependencies of a Feature
5. Modify the MEMORY section in the 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 Config.bib file specifies 28 MB of RAM, and then 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 you want to simulate 64 MB of RAM, from the Platform menu, choose Settings, then from the Build Options tab, select Enable Images Larger than 32 MB.

For information about adding support for more than 64 MB of RAM, see Supporting or Simulating More than 64 MB of RAM.

 Setting or Clearing an Environment Variable
6. Build the OS image.
  • In the Output window, on the Build tab, verify that your build contains no errors.
 Building a Platform
7. View the size of the OS image. Viewbin Tool

See Also

CEPC How-to Topics | How to Decrease Run-Time Image Size on a CEPC | Binary Image Builder File | Configuring System Memory

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.