Loadcepc.exe Boot Loader Usage (Windows Embedded CE 6.0)

  • Article

1/6/2010

As a boot loader, Loadcepc.exe specifies the information that is required to connect to the target device by using the parallel, serial, or Ethernet connection method. Loadcepc.exe also loads Ethernet boot loader functionality (Eboot.bin).

For the parallel and serial methods, Loadcepc.exe monitors the available memory space and returns an error if the amount of memory space is exceeded as the run-time image is transferred to the target device.

Loadcepc.exe supports static Internet Protocol (IP) addresses. Loadcepc.exe provides status on the transfer of the run-time image, including the size and a physical start address.

For the Ethernet connection, Loadcepc.exe specifies the debug Ethernet port that is used to transfer the Ethernet debugging services.

Loadcepc [/B:Baud] [/C:Port] [/D:Display}
[/E:IO:IRQ: [DottedDecimalNotation]]
[/H] [/L:DXxDYxBPPP[:PXxPY] [/K] [/N] [/P] [/Q] [/V] [InputFile]

Parameters

  • /B
    Specifies the baud for the communications link. Baud can be 9,600; 19,200; 38,400; 57,600; or 115,200.

    The default value for Baud is 38,400.

    Using the /b option to specify a different baud rate for downloading a run-time image has no effect, because loadcepc.exe ignores this value until downloading is complete. When downloading is complete, serial communication continues at the line rate specified in the /b option.

  • /C
    Specifies the communications port that is used by Loadcepc.exe. Port can be either 1 for COM1: or 2 for COM2:.

    The default value for Port is COM1:.

  • /D
    Specifies the display resolution. Display can be 0 for 320 x 200, 1 for 480 x 240, 2 for 640 x 480, 3 for 800 x 600, 4 for 1024 x 768, or 5 for 240 x 320.

    The default value for Display is dependent on the display driver. Most drivers implement a default value of 0 (320 x 200). See the display driver source code for its default mode.

  • /E
    IO and IRQ should be listed in hexadecimal digits.

    You can specify the optional DottedDecimalNotation on networks that do not support the Dynamic Host Configuration Protocol (DHCP) server.

    The Loadcepc.exe and Eboot.bin files allow you to use the static IP address to boot a CEPC when the DHCP server is not supported; when it is available, this server automatically provides an IP address.

    If a PCI device cannot be found, an NE200-compatible ISA card is assumed.

  • /H
    Displays a Help message.
  • /K
    Support for an RNDIS download.

  • /L:DXxDYxBPP[:PXxPY]
    Causes Loadcepc.exe to skip VESA mode settings and pass command-line parameters in the BOOTARGS structure.

    The following table shows the parameters of the /L argument.

    Parameter Description

    DX

    Sets the displayable area width. X can be any value. Required.

    DY

    Sets the displayable area height. Y can be any value. Required.

    BPP

    Sets the color depth in bits per pixel (BPP).

    Values can be 8, 16, 24, or 32.

    PX

    Sets the physical screen width. X can be any value.

    The default is the next closest value greater than or equal to DX.

    If PX is specified, you must also specify PY.

    Optional.

    PY

    Sets the physical screen height. Y can be any value.

    The default is the next closest value greater than or equal to DY.

    If PY is specified, you must also specify PX.

    Optional.

    The following example shows how to specify a 768 x 576 displayable area with 8bpp color and a 1024 x 768 physical display mode.

    loadcepc /b:38400 /v /e:300:5 /l:768x576x8:1024x768 eboot.bin

  • /N
    Allows a "boot me" network name seed to be specified. This name is passed to the OS, where it is used to establish a KITL connection.

    For example, loadcepc /n:"MYMACHINE" would yield a network name such as "MYMACHINERT12345", where RT would mean RealTek and 12345 is derived from the card's MAC address.

  • /P
    Uses the parallel port to download the run-time image from the development workstation.
  • /Q
    Uses the serial port to download the run-time image from the development workstation.
  • /V
    Displays additional status information while Loadcepc.exe boots.

  • InputFile
    Specifies the file to download from the development workstation.

    The /P option instructs Loadcepc.exe to download whatever the development workstation sends.

    By default, this is the binary run-time image file (Nk.bin).

Error Messages

  • Unrecognized option
    This message appears when you incorrectly type an option for the /B, /C, /D, and /E parameters.

    Be sure to type the correct option, as listed in the preceding section, "Parameters."

  • Unsupported baud rate
    This message appears when you incorrectly type an option for /B.

    Be sure to type the correct option, as listed in the preceding section, "Parameters."

  • HIMEM.SYS must be loaded
    Himem.sys must be included on the Microsoft MS-DOS-based boot disk before a run-time image can be transferred to a target device.

Example

The following code example shows how to use Loadcepc.exe to open a debug Ethernet connection for Ethernet services communication by using the NE2000-compatible Ethernet network card at I/O port 0x320 and interrupt request (IRQ) line 5.

loadcepc /e:320:5

Remarks

The kernel must not be corrupted. If the kernel is corrupted, the run-time image does not transfer.

See Also

Concepts

Load CEPC Tool

Other Resources

OEMInitDebugSerial