Share via


Command-Line Driver Dependencies (Windows Embedded CE 6.0)

1/6/2010

The command-line driver dependency model is the foundation that the integrated development environment (IDE) driver dependency model is based on.

To include or exclude a specific driver in your OS design (.pbxml file), you must understand the dependencies for that driver. You must know which Sysgen and board support package (BSP) variables you must set or clear to include or exclude the driver.

Often, performing a search of Platform.bib is the best place to begin. Platform.bib contains information about the Catalog items that depend on a given driver. In addition, Platform.bib defines the hardware modules and driver files for the target device.

The following code example shows how a company called MyCompany could use the FILES section of Platform.bib to specify driver files for a product model called the EON that uses an SHx family processor.

Note

Platform Builder does not parse environment variables that are set to string values. Thus, to specify the EON product model, this example creates a variable called MYCOMPANYS_MODEL_EON and sets that variable. In binary image builder (.bib) files, it is recommended to use this format for IF statements.

FILES
;  Name            Path                        Memory Type
;  --------------  ------------------------  -----------
; @CESYSGEN IF CE_MODULES_DEVICE
; @CESYSGEN ENDIF CE_MODULES_DEVICE

;*** MyCompany Additions ***
#include "$(_FLATRELEASEDIR)\mycompany_base.bib"

IF MYCOMPANYS_MODEL_EON
   ddi_gx.dll      $(_FLATRELEASEDIR)\ddi_gx.dll     NK  SH
   e100ce.dll      $(_FLATRELEASEDIR)\e100ce.dll     NK  SH
   wavedev.dll     $(_FLATRELEASEDIR)\wavedev.dll     NK  SH
   com16550.dll    $(_FLATRELEASEDIR)\com16550.dll     NK  SH
   isr16550.dll    $(_FLATRELEASEDIR)\isr16550.dll     NK  SH
   parallel.dll    $(_FLATRELEASEDIR)\parallel.dll     NK  SH
#include "$(_FLATRELEASEDIR)\MyOther.bib"
ENDIF

Cesysgen.bat contains information about the Sysgen variables that set these Catalog items. The default BSP environment variable values are specified in the BSP's batch file, such as Cepc.bat, but you can override them.

The following code example, from %_WINCEROOT%\Platform\CEPC\Files\Platform.bib, shows the nested conditionals around a USB driver, Uhci.dll, that govern its inclusion in a CEPC-based OS design.

; @CESYSGEN IF CE_MODULES_DEVICE
...
; @CESYSGEN IF CE_MODULES_USBD
; USB drivers
IF BSP_NOUSB !
IF IMG_NOUSB !
IF BSP_USB_UHCI
   uhci.dll       $(_FLATRELEASEDIR)\uhci.dll                   NK  SH
ENDIF
...
; @CESYSGEN ENDIF CE_MODULES_USBD
...
; @CESYSGEN ENDIF CE_MODULES_DEVICE

The first two lines specify that the variable CE_MODULES contains "device" and "usbd." Cesysgen.bat, which governs these lines, contains the Sysgen variables that govern the contents of CE_MODULES.

The following code example shows an excerpt from a Cesysgen.bat file. In this example, Cesysgen.bat contains lines to specify that CE_MODULES always contains "device" and that when SYSGEN_USB is set, CE_MODULES also contains "usbd." This means that the driver is not included unless SYSGEN_USB is set.

set CE_MODULES=%CE_MODULES% nk filesys device ...
if "%SYSGEN_USB%"=="1"           set CE_MODULES=%CE_MODULES% usbhost usbd

Finally, the following code example shows the innermost nested conditionals from the earlier Platform.bib example. These ensure that the driver is only included if the variables BSP_NOUSB and IMG_NOUSB are not set, and BSP_USB_UHCI is set.

IF BSP_NOUSB !
IF IMG_NOUSB !
IF BSP_USB_UHCI

In summary, four variables must be set or cleared for a CEPC-based OS design to include the Uhci.dll driver. The following table shows these settings.

Variable Value

SYSGEN_USB

Set

BSP_NOUSB

Not set

IMG_NOUSB

Not set

BSP_USB_UHCI

Set

For more information about Cesysgen conditional statements, see Preprocessing Using Cesysgen Conditionals.

See Also

Concepts

Driver Dependencies
Catalog Item Management
IDE Driver Dependencies

Other Resources

Build System
Cesysgen Batch File