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_C5402_MCBSP (Software IOM driver for c5402 using the MCBSP) 

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

USAGE
-----
This device driver is the lower level software based uart mini-driver for the
TMS320C5402 and uses the generic UARTHW driver to transfer data to and from the McBsp. Because this driver is dependent on the higher level 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_c5402_mcbsp.l54 and uartmd.l54 which are located in 
ddk/lib directory.

DESCRIPTION
-----------
UARTHW_C5402_MCBSP is an software based uart IOM driver for the Texas 
Instrument TMS320C5402.  The driver is implemented by using McBsp to simulate a
UART.

FILES
-----
- uarthw_c5402_mcbsp.pjt: project file for building the driver library for near 
	model on the dsk5402 platform. 
- uarthw_c5402_mcbspf.pjt: project file for building the driver library for 
	far model on the dsk5402 platform. 
- uarthw_c54xx_mcbsp.c: lower level chip specific uart implementation
- uarthw_mcbsp.c: lower level generic mcbsp software implementation
- ddk/include/uarthw_mcbsp.h: lower level generic mcbsp 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: 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 c5402 software 
    uart is using McBsp port1, Dma Channel 4 and 5, CPU set at 100Mhz, and 
    the baud rate set at 115200.

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