Serial Port Driver Samples

You have the option of staying with the old serial port model, or switching to the new model. To use the new model, you must modify two build variables, as follows:

  • Change the TARGETLIBS variable from Com_mdd.lib to Com_mdd2.lib.
  • Add the string "-DUSE_NEW_SERIAL_MODEL" to the CDEFINES variable in the SOURCES file.

In the lower layer, the HWTxIntrHandler function must map to the SL_TxIntrEx function instead of SL_TxIntr, for backward compatibility. See the Com16650 sample driver in %_WINCEROOT%\Public\Common\Oak\Drivers\Serial\COM16550.

The following illustration shows how the different serial driver modules combine to form a serial driver.

The following table shows the serial port driver sample code locations and their descriptions.

Location Description
%_WINCEROOT%\Public\Common\Oak\Drivers\Serial\2890_SER USB function driver for Netchip NET2890 exposes the serial interface.
%_WINCEROOT%\Public\Common\Oak\Drivers\Serial\COM16550 Lower layer.
%_WINCEROOT%\Public\Common\Oak\Drivers\Serial\COM_CARD Lower layer sample code to support the 16550 UART and PC Card–based serial ports.
%_WINCEROOT%\Public\Common\Oak\Drivers\Serial\COM_MDD Upper layer that addresses some transmission performance issues in the original upper layer but requires some modifications to existing lower layers.
%_WINCEROOT%\Public\Common\Oak\Drivers\Serial\COM_MDD2 Upper layer that addresses some transmission performance issues in the original upper layer but requires some modifications to existing lower layers.
%_WINCEROOT%\Public\Common\Oak\Drivers\Serial\ISR16550 Sample installable ISR for the SER16550 serial library.
%_WINCEROOT%\Public\Common\Oak\Drivers\Serial\SER16550 Library for supporting 16550-compatible UARTs is included. The lower layers use this.
%_WINCEROOT%\Public\Common\Oak\Drivers\Serial\SER_CARD Lower layer sample code to support the 16550 UART and PC Card–based serial ports.
%_WINCEROOT%\Public\Common\Oak\Drivers\Serial\SER_CARD2 Lower layer sample code to support the 16550 UART and PC Card–based serial ports.
%_WINCEROOT%\Platform\ARMIntegrator\Drivers\Serial Legacy lower layer.
%_WINCEROOT%\Platform\Aspen\Drivers\Serial Legacy lower layer.
%_WINCEROOT%\Platform\Eagle\Drivers\Serial Legacy lower layer.
%_WINCEROOT%\Platform\Keywest\Drivers\Serial Legacy lower layer.
%_WINCEROOT%\Platform\SA11X0BD\Drivers\Serial Legacy lower layer.

See Also

Serial Port Drivers | Serial Port Driver Registry Settings | Power Management in Serial Port Drivers | Automatic Detection of Docking for Serial Ports | Serial Port Driver Architecture

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.