Unit UART

Return to Unit Reference

Description

---

UART (Universal Asynchronous Receiver Transmitter) devices represent the industry standard serial communications devices that are available on almost every system.

This unit implements the framework for UART devices and provides a standardized API to allow driver specific implementation to be abstracted. All UART devices are also represented as a serial device and this unit handles the relationship between the two devices.

Each UART device returns a set of properties that describe the capabilities of the device and includes a set of flags that indicate what features are supported.

Reads and writes to UART devices are unbuffered and simply pass raw data to and from the caller unless the serial interface is used instead which includes buffering of transmitted and received data. Both reads and writes allow for non blocking so that a caller can avoid waiting for received data to be available or the device to be ready to transmit.

Constants

---

To be documented

Type definitions

---

To be documented

Public variables

---

To be documented

Function declarations

---

Initialization functions

[Expand]

procedure UARTInit;

Description: Initialize the UART unit and UART device table

Note	Called only during system startup

UART functions

[Expand]

function UARTDeviceOpen(UART:PUARTDevice; BaudRate,DataBits,StopBits,Parity,FlowControl:LongWord):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceClose(UART:PUARTDevice):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceRead(UART:PUARTDevice; Buffer:Pointer; Size,Flags:LongWord;var Count:LongWord):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceWrite(UART:PUARTDevice; Buffer:Pointer; Size,Flags:LongWord;var Count:LongWord):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceStatus(UART:PUARTDevice):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceProperties(UART:PUARTDevice; Properties:PUARTProperties):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceCreate:PUARTDevice;

Description: Create a new UART entry

Return	Pointer to new UART entry or nil if UART could not be created

[Expand]

function UARTDeviceCreateEx(Size:LongWord):PUARTDevice;

Description: Create a new UART entry

Size	Size in bytes to allocate for new UART (Including the UART entry)
Return	Pointer to new UART entry or nil if UART could not be created

[Expand]

function UARTDeviceDestroy(UART:PUARTDevice):LongWord;

Description: Destroy an existing UART entry

Note	None documented

[Expand]

function UARTDeviceRegister(UART:PUARTDevice):LongWord;

Description: Register a new UART in the UART table

Note	None documented

[Expand]

function UARTDeviceDeregister(UART:PUARTDevice):LongWord;

Description: Deregister a UART from the UART table

Note	None documented

[Expand]

function UARTDeviceFind(UARTId:LongWord):PUARTDevice;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceFindByName(const Name:String):PUARTDevice; inline;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceFindByDescription(const Description:String):PUARTDevice; inline;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceEnumerate(Callback:TUARTEnumerate; Data:Pointer):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTDeviceNotification(UART:PUARTDevice; Callback:TUARTNotification; Data:Pointer; Notification,Flags:LongWord):LongWord;

Description: To be documented

Note	None documented

UART serial functions

[Expand]

function UARTSerialDeviceOpen(Serial:PSerialDevice; BaudRate,DataBits,StopBits,Parity,FlowControl,ReceiveDepth,TransmitDepth:LongWord):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTSerialDeviceClose(Serial:PSerialDevice):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTSerialDeviceRead(Serial:PSerialDevice; Buffer:Pointer; Size,Flags:LongWord; var Count:LongWord):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTSerialDeviceWrite(Serial:PSerialDevice; Buffer:Pointer; Size,Flags:LongWord; var Count:LongWord):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTSerialDeviceStatus(Serial:PSerialDevice):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTSerialDeviceProperties(Serial:PSerialDevice; Properties:PSerialProperties):LongWord;

Description: To be documented

Note	None documented

UART helper functions

[Expand]

function UARTGetCount:LongWord; inline;

Description: Get the current UART count

Note	None documented

[Expand]

function UARTDeviceGetDefault:PUARTDevice; inline;

Description: Get the current default UART device

Note	None documented

[Expand]

function UARTDeviceSetDefault(UART:PUARTDevice):LongWord;

Description: Set the current default UART device

Note	None documented

[Expand]

function UARTDeviceCheck(UART:PUARTDevice):PUARTDevice;

Description: Check if the supplied UART is in the UART table

Note	None documented

[Expand]

procedure UARTLog(Level:LongWord;UART:PUARTDevice; const AText:String);

Description: To be documented

Note	None documented

[Expand]

procedure UARTLogInfo(UART:PUARTDevice; const AText:String); inline;

Description: To be documented

Note	None documented

[Expand]

procedure UARTLogError(UART:PUARTDevice; const AText:String); inline;

Description: To be documented

Note	None documented

[Expand]

procedure UARTLogDebug(UART:PUARTDevice; const AText:String); inline;

Description: To be documented

Note	None documented

UART serial helper functions

[Expand]

function UARTSerialDeviceReceive(UART:PUARTDevice):LongWord;

Description: To be documented

Note	None documented

[Expand]

function UARTSerialDeviceTransmit(UART:PUARTDevice):LongWord;

Description: To be documented

Note	None documented

Return to Unit Reference