Defines | Data Structures | Typedefs | Enumerations

ires_edma3Chan.h File Reference


Detailed Description

IRES EDMA3CHAN PROTOCOL Interface Definitions - Allows algorithms to request and receive handles representing EDMA3 resources associated with a single EDMA3 channel.

#include <ti/xdais/xdas.h>
#include <ti/xdais/ires_common.h>
Include dependency graph for ires_edma3Chan.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Defines

#define IRES_EDMA3CHAN_PROTOCOLNAME   "ti.sdo.fc.ires.edma3chan"
 Name used to describe this protocol.
#define EDMA3CHAN_MODNAME   "ti.sdo.fc.ires.edma3chan"
 Name to pass to Diags_setMask() to enable logging for EDMA3CHAN functions. For example, Diags_setMask(EDMA3CHAN_MODNAME"+EX1234567"); turns on all Log statements in this module. Diags_setMask() must be called after initialization to take effect.
#define EDMA3CHAN_GTNAME   "ti.sdo.fc.ires.edma3chan"
 Name used to describe the GT module.
#define IRES_EDMA3CHAN_PROTOCOLREVISION_1_0_0   {1, 0, 0}
 Protocol Revision for the 1.0.0 version of resource.
#define IRES_EDMA3CHAN_SETPROTOCOLREVISION_1_0_0(rev)
#define IRES_EDMA3CHAN_PROTOCOLREVISION_2_0_0   {2, 0, 0}
 Protocol Revision for the 2.0.0 version of resource.
#define IRES_EDMA3CHAN_SETPROTOCOLREVISION_2_0_0(rev)
#define IRES_EDMA3CHAN_MAXPARAMS   512
 Maximum number of params and tccs that can be requested in one handle.
#define IRES_EDMA3CHAN_MAXTCCS   32
#define IRES_EDMA3CHAN_NUMDESTTYPES   8
#define IRES_EDMA3CHAN_PARAM_ANY   512
 Macros to represent different PaRam, Channel and tcc types.
#define IRES_EDMA3CHAN_PARAM_NONE   513
#define IRES_EDMA3CHAN_TCC_ANY   514
#define IRES_EDMA3CHAN_TCC_NONE   515
#define IRES_EDMA3CHAN_EDMACHAN_ANY   516
#define IRES_EDMA3CHAN_QDMACHAN_ANY   516
#define IRES_EDMA3CHAN_CHAN_NONE   518

Data Structures

struct  IRES_EDMA3CHAN_PaRamStruct
 Representation of actual PaRam structure. More...
struct  IRES_EDMA3CHAN_ProtocolArgs
 EDMA3 Linked Transfer Protocol Arguments definition. When requesting resources on a device on which DCHMAP feature does not exist, please follow these rules:- 1. Break up requests into LOGICAL channel requests and requests for PaRams. 2. Logical Qdma/Edma channel => Q/E channel + PaRam + TCC 3. Avoid requesting EDMA3 resources of specific number, for most transfers an "ANY" type request should be sufficient 4. For linked transfers, request a Logical channel in one descriptor, and "N" contiguous Params in another descriptor 5. If a logical channel request is combined with a request for multiple Params or Tccs, this might result in an in-efficient allocation of resources, and in some cases, simplyfying assumptions about the resource requests may be made by the allocator. More...
struct  IRES_EDMA3CHAN_Obj
 IRES_EDMA3CHAN_Obj extends the generic IRES_Obj structure that is returned back to the algorithm requesting the resource. More...
struct  IRES_EDMA3CHAN_EDMA3ShadowRegister
 IRES_EDMA3CHAN_EDMA3ShadowRegister defines the shadow register part of the EDMA3 CC Register Layer defined below. More...
struct  IRES_EDMA3CHAN_EDMA3DraeRegister
 IRES_EDMA3CHAN_EDMA3DraeRegister defines the Region Enable register part of the EDMA3 CC Register Layer defined below. More...
struct  IRES_EDMA3CHAN_EDMA3RegisterLayer
struct  IRES_EDMA3CHAN_Properties
 Static Resource Properties. More...
struct  IRES_EDMA3CHAN2_Obj
 IRES_EDMA3CHAN2_Obj corresponds to version IRES_EDMA3CHAN_PROTOCOLREVISION_2_0_0. It has been enhanced * from the IRES_EDMA3CHAN_Obj. More...

Typedefs

typedef struct IRES_EDMA3CHAN_ObjIRES_EDMA3CHAN_Handle
 Handle to "logical" EDMA3CHAN resource, version {1,0,0}.
typedef struct
IRES_EDMA3CHAN2_Obj
IRES_EDMA3CHAN2_Handle
 Handle to "logical" EDMA3CHAN resource, version {2,0,0}.
typedef struct
IRES_EDMA3CHAN_PaRamStruct 
IRES_EDMA3CHAN_PaRamStruct
 Representation of actual PaRam structure.
typedef struct
IRES_EDMA3CHAN_ProtocolArgs 
IRES_EDMA3CHAN_ProtocolArgs
 EDMA3 Linked Transfer Protocol Arguments definition. When requesting resources on a device on which DCHMAP feature does not exist, please follow these rules:- 1. Break up requests into LOGICAL channel requests and requests for PaRams. 2. Logical Qdma/Edma channel => Q/E channel + PaRam + TCC 3. Avoid requesting EDMA3 resources of specific number, for most transfers an "ANY" type request should be sufficient 4. For linked transfers, request a Logical channel in one descriptor, and "N" contiguous Params in another descriptor 5. If a logical channel request is combined with a request for multiple Params or Tccs, this might result in an in-efficient allocation of resources, and in some cases, simplyfying assumptions about the resource requests may be made by the allocator.
typedef struct IRES_EDMA3CHAN_Obj IRES_EDMA3CHAN_Obj
 IRES_EDMA3CHAN_Obj extends the generic IRES_Obj structure that is returned back to the algorithm requesting the resource.
typedef struct
IRES_EDMA3CHAN_EDMA3ShadowRegister 
IRES_EDMA3CHAN_EDMA3ShadowRegister
 IRES_EDMA3CHAN_EDMA3ShadowRegister defines the shadow register part of the EDMA3 CC Register Layer defined below.
typedef struct
IRES_EDMA3CHAN_EDMA3DraeRegister 
IRES_EDMA3CHAN_EDMA3DraeRegister
 IRES_EDMA3CHAN_EDMA3DraeRegister defines the Region Enable register part of the EDMA3 CC Register Layer defined below.
typedef struct
IRES_EDMA3CHAN_EDMA3RegisterLayer 
IRES_EDMA3CHAN_EDMA3RegisterLayer
typedef struct
IRES_EDMA3CHAN_Properties 
IRES_EDMA3CHAN_Properties
 Static Resource Properties.
typedef enum
IRES_EDMA3CHAN_DmaDestType 
IRES_EDMA3CHAN_DmaDestType
 Describes the Destination type of DMA writes This information is used to distribute different types of DMA writes to different EDMA3 Queues.
typedef struct IRES_EDMA3CHAN2_Obj IRES_EDMA3CHAN2_Obj
 IRES_EDMA3CHAN2_Obj corresponds to version IRES_EDMA3CHAN_PROTOCOLREVISION_2_0_0. It has been enhanced * from the IRES_EDMA3CHAN_Obj.

Enumerations

enum  IRES_EDMA3CHAN_DmaDestType {
  INTMEMORY0 = 0,
  INTMEMORY1 = 1,
  INTMEMORY2 = 2,
  EXTMEMORY0 = 3,
  EXTMEMORY1 = 4,
  EXTMEMORY2 = 5,
  OTHER0 = 6,
  OTHER1 = 7
}
 

Describes the Destination type of DMA writes This information is used to distribute different types of DMA writes to different EDMA3 Queues.

More...
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines

Copyright 2010, Texas Instruments Incorporated