Serial Port Driver PDD Functions (Compact 2013)

3/26/2014

The following table shows the serial port driver platform dependent driver (PDD) functions.

Programming element

Description

GetSerialObject

This function returns a pointer to a HWOBJ structure. The structure contains the function pointers and parameters for the hardware interface functions of the relevant lower layer.

HWClearBreak

This function clears an RS-232 line break condition.

HWClearDTR

This function clears the Data Terminal Ready (DTR) signal.

HWClearRTS

This function clears the Request to Send (RTS) signal.

HWClose

This function closes the device initialized by the HWInit function.

HWDeinit

This function is called by the upper layer to de-initialize the hardware when a device driver is unloaded.

HWGetCommProperties

This function retrieves the current properties of the communications device.

HWGetIntrType

This function returns the current interrupt type.

HWGetModemStatus

This function retrieves the modem status.

HWGetRxBufferSize

This function returns the maximum number of bytes that the hardware buffer can hold, not including the padding, stop, and start bits.

HWGetRxStart

This function returns the start of the hardware-receive buffer.

HWGetStatus

This function specifies the hardware status API.

HWInit

This function initializes a serial device.

HWIoctl

This function executes device I/O control (IOCTL) routines.

HWLineIntrHandler

This function handles line interrupts for serial port devices.

HWModemIntrHandler

This function handles the modem interrupt. This function replaces the HWOtherIntrHandler function.

HWOpen

This function is called by the upper layer to open the serial device.

HWOtherIntrHandler

This function has been replaced with HWModemIntrHandler.

HWPostInit

This function performs necessary operations after it initializes all data structures and prepares the serial IST to begin handling interrupts. It is called by the upper layer.

HWPowerOff

This function notifies the platform-dependent driver that the hardware platform is about to enter suspend mode. It is called by the model device driver (MDD).

HWPowerOn

This function notifies the platform-dependent driver that the hardware platform is resuming from suspend mode. It is called by the MDD.

HWPurgeComm

This function purges the communications device.

HWPutBytes

This function writes bytes to hardware. The driver calls this function.

HWReset

This function resets the hardware API.

HWRxIntrHandler

This function handles serial port interrupts.

HWSetBreak

This function sets the line break condition on the transmit line.

HWSetCommTimeouts

This function sets the communications time-out events in response to a call to the SetCommTimeouts function.

HWSetDCB

This function sets the device control block.

HWSetDTR

This function sets the Data Terminal Ready (DTR) signal.

HWSetRTS

This function sets the Request to Send (RTS) signal.

HWTxIntrHandler

This function handles the transmit interrupt for serial port devices.

HWXmitComChar

This function transmits a single character.

See Also

Reference

Serial Port Driver Reference