Quelle  edma.h   Sprache: C

/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
 *  TI EDMA definitions
 *
 *  Copyright (C) 2006-2013 Texas Instruments.
 */

/*
 * This EDMA3 programming framework exposes two basic kinds of resource:
 *
 *  Channel Triggers transfers, usually from a hardware event but
 * also manually or by "chaining" from DMA completions.
 * Each channel is coupled to a Parameter RAM (PaRAM) slot.
 *
 *  Slot Each PaRAM slot holds a DMA transfer descriptor (PaRAM
 * "set"), source and destination addresses, a link to a
 * next PaRAM slot (if any), options for the transfer, and
 * instructions for updating those addresses.  There are
 * more than twice as many slots as event channels.
 *
 * Each PaRAM set describes a sequence of transfers, either for one large
 * buffer or for several discontiguous smaller buffers.  An EDMA transfer
 * is driven only from a channel, which performs the transfers specified
 * in its PaRAM slot until there are no more transfers.  When that last
 * transfer completes, the "link" field may be used to reload the channel's
 * PaRAM slot with a new transfer descriptor.
 *
 * The EDMA Channel Controller (CC) maps requests from channels into physical
 * Transfer Controller (TC) requests when the channel triggers (by hardware
 * or software events, or by chaining).  The two physical DMA channels provided
 * by the TCs are thus shared by many logical channels.
 *
 * DaVinci hardware also has a "QDMA" mechanism which is not currently
 * supported through this interface.  (DSP firmware uses it though.)
 */

#ifndef EDMA_H_
#define EDMA_H_

enum dma_event_q {
 EVENTQ_0 = 0,
 EVENTQ_1 = 1,
 EVENTQ_2 = 2,
 EVENTQ_3 = 3,
 EVENTQ_DEFAULT = -1
};

#define EDMA_CTLR_CHAN(ctlr, chan) (((ctlr) << 16) | (chan))
#define EDMA_CTLR(i)   ((i) >> 16)
#define EDMA_CHAN_SLOT(i)  ((i) & 0xffff)

#define EDMA_FILTER_PARAM(ctlr, chan) ((int[]) { EDMA_CTLR_CHAN(ctlr, chan) })

struct edma_rsv_info {

 const s16 (*rsv_chans)[2];
 const s16 (*rsv_slots)[2];
};

struct dma_slave_map;

/* platform_data for EDMA driver */
struct edma_soc_info {
 /*
 * Default queue is expected to be a low-priority queue.
 * This way, long transfers on the default queue started
 * by the codec engine will not cause audio defects.
 */
 enum dma_event_q default_queue;

 /* Resource reservation for other cores */
 struct edma_rsv_info *rsv;

 /* List of channels allocated for memcpy, terminated with -1 */
 s32   *memcpy_channels;

 s8 (*queue_priority_mapping)[2];
 const s16 (*xbar_chans)[2];

 const struct dma_slave_map *slave_map;
 int slavecnt;
};

#endif