#
#  Copyright 2003 by Texas Instruments Incorporated.
#  All rights reserved. Property of Texas Instruments Incorporated.
#  Restricted rights to use, duplicate or disclose this code are
#  granted through contract.
#  
#
# "@(#) DDK 1.10.00.23 07-02-03 (ddk-b12)"
TITLE
-----
UARTMD (generic higher level device driver for UARTs)

DOCUMENTATION
-------------
The documentation for this device driver can be found at:
	/ddk/docs/uart.pdf

USAGE
-----
This device driver is written in conformance to the DSP/BIOS IOM device driver
model and handles events coming from the lower level driver in a generic way
to allow data to be transmitted and recieved. It must be used with a 
uart specific lower level device driver. 

DESCRIPTION
-----------
UARTMD is a higher level generic device driver to be used with the the following lower level device drivers: 
UARTHW_DSK5402, UARTHW_C5402_MCBSP, UARTHW_C5510_MCBSP, and UARTHW_C6X1X_MCBSP.

FILES
-----
- uartmd*.pjt: project files for building a library for the appropriate
       architecture 
- uartmd.c: generic higher level driver implementation 
- circ.c: internal buffer handling implementation 
- circ.h: internal buffer handling interface header file
- ddk/include/uart.h: generic driver interface header file
- readme.txt: this file

NOTES
-----
- Files in the library are compiled with "no optimization switch" turned on, 
  and the same is true for the project files. If you plan to use this module 
  in a project release, you should rebuild the library with optimization 
  turned on.

Known Problems At Release
-------------------------
- None.

Q&A
---
Q1: Where can I find the documentation for writing IOM drivers?

---
Q1: Where can I find the documentation for writing IOM drivers?
A1: The literature number is SPRU616, DSP/BIOS Device Driver Developer's Guide.