# 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.
QA
---
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.
我要上传