readme.txt

DM642的串口驱动源码

#
#  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.11.00.00 11-04-03 (ddk-b13)"
TITLE
-----
UARTHW_DSK5402 (IOM driver for DSK5402 Hardware UART) 

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

USAGE
-----
This device driver is the lower level mini-driver for the hardware uart on 
the TMS320C5402 DSK and uses the generic UARTHW driver to transfer data to 
and from the hardware uart. Because this driver is dependent on the generic 
UARTMD driver, an application must link both the libraries from this driver and from the generic driver in order for it to function correctly. These two 
libraries are called uarthw_dsk5402.l54 and uartmd.l54 which are located in 
ddk/lib directory.

DESCRIPTION
-----------
UARTHW_DSK5402 is an IOM driver for the Texas Instrument 5402 DSK. This 
board has hardware 16550 UART on it. The driver is implemented using this
hardware. 

FILES
-----
- uarthw_dsk5402.pjt: project file for building the driver library for near 
	model on the dsk5402 platform. 
- uarthw_dsk5402f.pjt: project file for building the driver library for 
	far model on the dsk5402 platform. 
- uarthw_dsk5402.c: lower level hardware uart implementation
- ddk/include/uarthw_dsk5402.h: lower level driver interface header file
- ddk/include/uarthw.h: higher level generic driver 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: How do I use the default uart parameters? 
Q2: How do I change the uart parameters?
Q3: Where can I find the documentation for writing IOM drivers?

---
Q1: How do I use the default uart parameters? 
A1: Specify a NULL value to the User-Defined Device parameter when you add the 
    driver from the Configuration Tools. The default value for uart are 115200
    baud, 8 bit word size, 1 stop bit, no parity and no flow control.

Q2: How do I change the uart parameters?
A2: The uart parameters can be changed as follows:

    1) Static way:
       -----------
       You need to define the uart structure with all the fields before main() 
       in the application.
       
       Example:

	   UARTHW_DSK5402_Params myParams = {
	   			UARTHW_DSK5402_BAUD_115200
	   			UARTHW_DSK5402_WORD8
	   			UARTHW_DSK5402_DISABLE_PARITY
	   			UARTHW_DSK5402_STOP1
	   			UARTHW_DSK5402_FLOW_NONE};
	   
	   Pass "_myParams" to the User-Defined Device parameter.
       
Q3: Where can I find the documentation for writing IOM drivers?
A3: The literature number is SPRU616, DSP/BIOS Device Driver Developer's Guide.