Eboot Code Library

  • Article

The Eboot library, located in %_WINCEROOT%\Public\Common\Oak\Drivers\Ethdbg\Eboot, provides Dynamic Host Configuration Protocol (DHCP), Trivial File Transfer Protocol (TFTP), and User Datagram Protocol (UDP) services. The download protocol used by Platform Builder is TFTP. The intent is to hide all Ethernet details behind the scenes for boot loader development. The Ethernet part of the boot loader can be reduced to the following code:

if (!EbootInitEtherTransport (....)) {
      while (1);  // spin forever
}
// main loop of download
while (EbootEtherReadData (...)) {
      // process the data
      ProcessData (...);
}

The following table shows the Eboot functions typically used by a boot loader.

Function Description
EbootInitEtherTransport Initializes the Ethernet download transport. This involves getting an IP address from a DHCP server, if necessary, and initiating a TFTP connection to Platform Builder on the desktop.
EbootWaitForHostConnect Talks to Platform Builder on the desktop to obtain the contents of an EDBG_OS_CONFIG_DATA structure. The structure contains user settings, or flags, and desktop service IP and Port information that is later used by the OS.
EbootEtherReadData Reads the specified number of bytes from an Ethernet controller, into the caller-provided buffer. The OEM routes the read operation to the correct Ethernet network driver function.

See Also

Boot Loader Support Libraries

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.