IMG Environment Variables

  • Article

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

Windows Mobile Not SupportedWindows Embedded CE Supported

8/27/2008

IMG environment variables remove modules from your operating system design, but leave the associated registry entries in your design intact.

These variables are available for your convenience. Do not include them in a shipped product.

If you set or unset an IMG environment variable in your operating system design, you do not have to perform a full rebuild of your run-time image. Instead, you can run the Make Binary Image tool (Makeimg.exe) to create the new run-time image.

The following table shows all IMG environment variables.

Environment variable Description

IMGAUTH

Makes it possible to key run-time images to a specific device, thus ensuring that the images are flashed only on that device.

When the device is booted, it validates the run-time image signature by making sure that the signature matches the hardware device ID.

IMGAUTOFLUSH

Enables automatic flushing of events to the release directory.

This variable must be used together with IMGCELOGENABLE. For more information, see CeLog Tools.

IMGCELOGENABLE

Adds CELog.dll to the operating system design and initializes event logging when the run-time image boots.

IMGEBOOT

Reserves space for the boot loader in ROM.

IMGFLASH

This environment variable is dependent on the specific board support package (BSP) implementation.

IMGHDSTUB

Adds operating system awareness for hardware-assisted debugging.

IMGNODEBUGGER

Excludes debugger support from the operating system design.

When set to 0, the operating system design must also contain the following files if you want the debugger to run: Hd.dll, Kd.dll, OsAxsT0.dll, and OsAxsT1.dll.

IMGNOKITL

Selects a kernel that is not Kernel Independent Transport Layer (KITL) -enabled.

IMGSHIMENABLE

Includes the kernel-side portion of the Application Verifier tool (AppVerifier) in the run-time image.

If this variable is included in the run-time image, it loads at boot time.

For more information, see Application Verifier Tool.

The following table shows the additional IMG environment variables that you can use in Windows Embedded CE 6.0.

Environment variable Description

IMGDUALPORTRIL

Configures the RIL driver to use a MUX driver instead of a raw serial driver.

IMGKCOVER

Enables code coverage.

IMGMULTIBIN

Enables multi-XIP regions in the run-time image.

IMGNOLOC

Excludes localization functionality from the run-time image.

IMGNORDPINGWE

Enables the RDP core, Mstscax.dlll, to be hosted in the same process as the container application, Cetsc.exe, for debugging and testing.

IMGNOREDIR

Excludes redir from the operating system design.

IMGNOSHAREETH

Excludes VMINI support from the operating system design.

Setting this environment variable might require you to perform a rebuild of the BSP. To rebuild the BSP:

  1. Do either of the following:

    • From a command prompt build window, navigate to the root directory for the BSP and enter the following command:

      build -c
    • From the Build menu in the IDE, choose Global Build Settings, and then verify that Make Run-Time Image After Build and Copy Files to Release Directory After Build are selected.
  2. On the Build menu, choose Rebuild <OS Design>.

IMGNOTAHOMA

Excludes the Tahoma true-type font from the operating system design.

IMGOSCAPTURE

Adds OSCapture.exe to the operating system design. It starts buffering events in RAM when the run-time image boots.

For more information, see CeLog Tools.

IMGPROFILER

Selects a profiling-enabled kernel.

IMGRAM16

Configures the run-time image for 16 MB of RAM.

IMGRAM32

Configures the run-time image for 32 MB of RAM.

IMGRAM64

Configures the run-time image for 64 MB of RAM.

IMGRAM128

Configures the run-time image for 128 MB of RAM.

IMGRAM256

Configures the run-time image for 256 MB of RAM.

IMGRAM512

Configures the run-time image for 512 MB of RAM.

IMGRILCOM1

Configures the RIL driver to open COM1 instead of COM2 for the AT command/response port.

IMGSIGN

Includes the signature extension block in the ROM header.

IMGTINYFSRAM

Sets FSRAMPERCENT, which minimizes the amount of RAM that is allocated for the file system.

For more information, see Binary Image Builder File and FSRAMPERCENT.

IMGTRUSTROMONLY

Sets ROMFLAGS, which configures the run-time image to trust only modules in ROM.

For more information, see Binary Image Builder File and ROMFLAGS.

See Also

Concepts

Environment Variables
BSP Environment Variables
BSP_NO Environment Variables
PRJ Environment Variables
Miscellaneous Environment Variables