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.