readme.txt

C64XX DSP串口的PCI程序

#
#  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
-----
c64xx_pci (generic pci mini driver)


USAGE
-----
The driver is used to allow the DSP to perform PCI master data tranfers on a PCI bus. It is 
typically used by other DSP device drivers to perform block transfers to other PCI bus 
devices or memories.


DESCRIPTION
-----------
This is an DSP/BIOS IOM mini driver for the C64xx devices that contain a PCI peripheral, 
such as the C6415 or C6416 DSPs. It does data master transfers between DSP and other 
devices/memory on the pci bus.  The PCI peripheral device does not perform the system PCI 
bus arbitration, but relies on a PCI host such as a PC.

FILES
-----
- c64xx_pci.pjt: project file for building the driver library.
- c64xx_pci.c: implementation of the driver.
- ../include/c64xx_pci.h: driver header file.
- readme.txt: this file


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

- This driver's EEPROM related control functions are one to one CSL calls. Refer to the 
  CSL API manual for the definitions of status/data. Some macros (PCI_xxxx) are from the 
  CSL, so you will need to include <csl_pci.h> in your code.

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



Q&A
---

Q1: How do I change default pci queue priority?
A1: Instead of passing NULL to IOM_create()'s optArgs parameter, define 
    C64XX_PCI_Attrs and pass it as optArgs. 

---
Q2: How do I change the C64XX_PCI_DevParams parameters?
A2: - Step 1, You need to define the parameter structure with 
         all the fields in your application file before main().

         Example: different EDMA interrupt id.

         C64XX_PCI_DevParams myParams = { \
            C64XX_PCI_VERSION_1,          \
            6,                            \
            -1,                           \
            NULL,                         \
            C64XX_PCI_INTR_MASK_DEFAULT   \
         };
       
         This example sets PCI interrupt id to 6 and not register Error Events.
	 PCI interrupt will be plugged into hwi6.

    - Step 2, Pass "_myParams" to the User-Defined Device parameter.


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