git.sur5r.net Git - u-boot/blob - drivers/dma/MCD_dmaApi.c

   1 // SPDX-License-Identifier: GPL-2.0+
   2 /*
   3  * Copyright (C) 2004-2007 Freescale Semiconductor, Inc.
   4  */
   5
   6 /*Main C file for multi-channel DMA API. */
   7
   8 #include <common.h>
   9
  10 #include <MCD_dma.h>
  11 #include <MCD_tasksInit.h>
  12 #include <MCD_progCheck.h>
  13
  14 /********************************************************************/
  15 /* This is an API-internal pointer to the DMA's registers */
  16 dmaRegs *MCD_dmaBar;
  17
  18 /*
  19  * These are the real and model task tables as generated by the
  20  * build process
  21  */
  22 extern TaskTableEntry MCD_realTaskTableSrc[NCHANNELS];
  23 extern TaskTableEntry MCD_modelTaskTableSrc[NUMOFVARIANTS];
  24
  25 /*
  26  * However, this (usually) gets relocated to on-chip SRAM, at which
  27  * point we access them as these tables
  28  */
  29 volatile TaskTableEntry *MCD_taskTable;
  30 TaskTableEntry *MCD_modelTaskTable;
  31
  32 /*
  33  * MCD_chStatus[] is an array of status indicators for remembering
  34  * whether a DMA has ever been attempted on each channel, pausing
  35  * status, etc.
  36  */
  37 static int MCD_chStatus[NCHANNELS] = {
  38         MCD_NO_DMA, MCD_NO_DMA, MCD_NO_DMA, MCD_NO_DMA,
  39         MCD_NO_DMA, MCD_NO_DMA, MCD_NO_DMA, MCD_NO_DMA,
  40         MCD_NO_DMA, MCD_NO_DMA, MCD_NO_DMA, MCD_NO_DMA,
  41         MCD_NO_DMA, MCD_NO_DMA, MCD_NO_DMA, MCD_NO_DMA
  42 };
  43
  44 /* Prototypes for local functions */
  45 static void MCD_memcpy(int *dest, int *src, u32 size);
  46 static void MCD_resmActions(int channel);
  47
  48 /*
  49  * Buffer descriptors used for storage of progress info for single Dmas
  50  * Also used as storage for the DMA for CRCs for single DMAs
  51  * Otherwise, the DMA does not parse these buffer descriptors
  52  */
  53 #ifdef MCD_INCLUDE_EU
  54 extern MCD_bufDesc MCD_singleBufDescs[NCHANNELS];
  55 #else
  56 MCD_bufDesc MCD_singleBufDescs[NCHANNELS];
  57 #endif
  58 MCD_bufDesc *MCD_relocBuffDesc;
  59
  60 /* Defines for the debug control register's functions */
  61 #define DBG_CTL_COMP1_TASK      (0x00002000)
  62 #define DBG_CTL_ENABLE          (DBG_CTL_AUTO_ARM       | \
  63                                  DBG_CTL_BREAK          | \
  64                                  DBG_CTL_INT_BREAK      | \
  65                                  DBG_CTL_COMP1_TASK)
  66 #define DBG_CTL_DISABLE         (DBG_CTL_AUTO_ARM       | \
  67                                  DBG_CTL_INT_BREAK      | \
  68                                  DBG_CTL_COMP1_TASK)
  69 #define DBG_KILL_ALL_STAT       (0xFFFFFFFF)
  70
  71 /* Offset to context save area where progress info is stored */
  72 #define CSAVE_OFFSET            10
  73
  74 /* Defines for Byte Swapping */
  75 #define MCD_BYTE_SWAP_KILLER    0xFFF8888F
  76 #define MCD_NO_BYTE_SWAP_ATALL  0x00040000
  77
  78 /* Execution Unit Identifiers */
  79 #define MAC                     0       /* legacy - not used */
  80 #define LUAC                    1       /* legacy - not used */
  81 #define CRC                     2       /* legacy - not used */
  82 #define LURC                    3       /* Logic Unit with CRC */
  83
  84 /* Task Identifiers */
  85 #define TASK_CHAINNOEU          0
  86 #define TASK_SINGLENOEU         1
  87 #ifdef MCD_INCLUDE_EU
  88 #define TASK_CHAINEU            2
  89 #define TASK_SINGLEEU           3
  90 #define TASK_FECRX              4
  91 #define TASK_FECTX              5
  92 #else
  93 #define TASK_CHAINEU            0
  94 #define TASK_SINGLEEU           1
  95 #define TASK_FECRX              2
  96 #define TASK_FECTX              3
  97 #endif
  98
  99 /*
 100  * Structure to remember which variant is on which channel
 101  * TBD- need this?
 102  */
 103 typedef struct MCD_remVariants_struct MCD_remVariant;
 104 struct MCD_remVariants_struct {
 105         int remDestRsdIncr[NCHANNELS];  /* -1,0,1 */
 106         int remSrcRsdIncr[NCHANNELS];   /* -1,0,1 */
 107         s16 remDestIncr[NCHANNELS];     /* DestIncr */
 108         s16 remSrcIncr[NCHANNELS];      /* srcIncr */
 109         u32 remXferSize[NCHANNELS];     /* xferSize */
 110 };
 111
 112 /* Structure to remember the startDma parameters for each channel */
 113 MCD_remVariant MCD_remVariants;
 114 /********************************************************************/
 115 /* Function: MCD_initDma
 116  * Purpose:  Initializes the DMA API by setting up a pointer to the DMA
 117  *           registers, relocating and creating the appropriate task
 118  *           structures, and setting up some global settings
 119  * Arguments:
 120  *  dmaBarAddr    - pointer to the multichannel DMA registers
 121  *  taskTableDest - location to move DMA task code and structs to
 122  *  flags         - operational parameters
 123  * Return Value:
 124  *  MCD_TABLE_UNALIGNED if taskTableDest is not 512-byte aligned
 125  *  MCD_OK otherwise
 126  */
 127 extern u32 MCD_funcDescTab0[];
 128
 129 int MCD_initDma(dmaRegs * dmaBarAddr, void *taskTableDest, u32 flags)
 130 {
 131         int i;
 132         TaskTableEntry *entryPtr;
 133
 134         /* setup the local pointer to register set */
 135         MCD_dmaBar = dmaBarAddr;
 136
 137         /* do we need to move/create a task table */
 138         if ((flags & MCD_RELOC_TASKS) != 0) {
 139                 int fixedSize;
 140                 u32 *fixedPtr;
 141                 /*int *tablePtr = taskTableDest;TBD */
 142                 int varTabsOffset, funcDescTabsOffset, contextSavesOffset;
 143                 int taskDescTabsOffset;
 144                 int taskTableSize, varTabsSize, funcDescTabsSize,
 145                     contextSavesSize;
 146                 int taskDescTabSize;
 147
 148                 int i;
 149
 150                 /* check if physical address is aligned on 512 byte boundary */
 151                 if (((u32) taskTableDest & 0x000001ff) != 0)
 152                         return (MCD_TABLE_UNALIGNED);
 153
 154                 /* set up local pointer to task Table */
 155                 MCD_taskTable = taskTableDest;
 156
 157                 /*
 158                  * Create a task table:
 159                  * - compute aligned base offsets for variable tables and
 160                  *   function descriptor tables, then
 161                  * - loop through the task table and setup the pointers
 162                  * - copy over model task table with the the actual task
 163                  *   descriptor tables
 164                  */
 165
 166                 taskTableSize = NCHANNELS * sizeof(TaskTableEntry);
 167                 /* align variable tables to size */
 168                 varTabsOffset = taskTableSize + (u32) taskTableDest;
 169                 if ((varTabsOffset & (VAR_TAB_SIZE - 1)) != 0)
 170                         varTabsOffset =
 171                             (varTabsOffset + VAR_TAB_SIZE) & (~VAR_TAB_SIZE);
 172                 /* align function descriptor tables */
 173                 varTabsSize = NCHANNELS * VAR_TAB_SIZE;
 174                 funcDescTabsOffset = varTabsOffset + varTabsSize;
 175
 176                 if ((funcDescTabsOffset & (FUNCDESC_TAB_SIZE - 1)) != 0)
 177                         funcDescTabsOffset =
 178                             (funcDescTabsOffset +
 179                              FUNCDESC_TAB_SIZE) & (~FUNCDESC_TAB_SIZE);
 180
 181                 funcDescTabsSize = FUNCDESC_TAB_NUM * FUNCDESC_TAB_SIZE;
 182                 contextSavesOffset = funcDescTabsOffset + funcDescTabsSize;
 183                 contextSavesSize = (NCHANNELS * CONTEXT_SAVE_SIZE);
 184                 fixedSize =
 185                     taskTableSize + varTabsSize + funcDescTabsSize +
 186                     contextSavesSize;
 187
 188                 /* zero the thing out */
 189                 fixedPtr = (u32 *) taskTableDest;
 190                 for (i = 0; i < (fixedSize / 4); i++)
 191                         fixedPtr[i] = 0;
 192
 193                 entryPtr = (TaskTableEntry *) MCD_taskTable;
 194                 /* set up fixed pointers */
 195                 for (i = 0; i < NCHANNELS; i++) {
 196                         /* update ptr to local value */
 197                         entryPtr[i].varTab = (u32) varTabsOffset;
 198                         entryPtr[i].FDTandFlags =
 199                             (u32) funcDescTabsOffset | MCD_TT_FLAGS_DEF;
 200                         entryPtr[i].contextSaveSpace = (u32) contextSavesOffset;
 201                         varTabsOffset += VAR_TAB_SIZE;
 202 #ifdef MCD_INCLUDE_EU
 203                         /* if not there is only one, just point to the
 204                            same one */
 205                         funcDescTabsOffset += FUNCDESC_TAB_SIZE;
 206 #endif
 207                         contextSavesOffset += CONTEXT_SAVE_SIZE;
 208                 }
 209                 /* copy over the function descriptor table */
 210                 for (i = 0; i < FUNCDESC_TAB_NUM; i++) {
 211                         MCD_memcpy((void *)(entryPtr[i].
 212                                             FDTandFlags & ~MCD_TT_FLAGS_MASK),
 213                                    (void *)MCD_funcDescTab0, FUNCDESC_TAB_SIZE);
 214                 }
 215
 216                 /* copy model task table to where the context saves stuff
 217                    leaves off */
 218                 MCD_modelTaskTable = (TaskTableEntry *) contextSavesOffset;
 219
 220                 MCD_memcpy((void *)MCD_modelTaskTable,
 221                            (void *)MCD_modelTaskTableSrc,
 222                            NUMOFVARIANTS * sizeof(TaskTableEntry));
 223
 224                 /* point to local version of model task table */
 225                 entryPtr = MCD_modelTaskTable;
 226                 taskDescTabsOffset = (u32) MCD_modelTaskTable +
 227                     (NUMOFVARIANTS * sizeof(TaskTableEntry));
 228
 229                 /* copy actual task code and update TDT ptrs in local
 230                    model task table */
 231                 for (i = 0; i < NUMOFVARIANTS; i++) {
 232                         taskDescTabSize =
 233                             entryPtr[i].TDTend - entryPtr[i].TDTstart + 4;
 234                         MCD_memcpy((void *)taskDescTabsOffset,
 235                                    (void *)entryPtr[i].TDTstart,
 236                                    taskDescTabSize);
 237                         entryPtr[i].TDTstart = (u32) taskDescTabsOffset;
 238                         taskDescTabsOffset += taskDescTabSize;
 239                         entryPtr[i].TDTend = (u32) taskDescTabsOffset - 4;
 240                 }
 241 #ifdef MCD_INCLUDE_EU
 242                 /* Tack single DMA BDs onto end of code so API controls
 243                    where they are since DMA might write to them */
 244                 MCD_relocBuffDesc =
 245                     (MCD_bufDesc *) (entryPtr[NUMOFVARIANTS - 1].TDTend + 4);
 246 #else
 247                 /* DMA does not touch them so they can be wherever and we
 248                    don't need to waste SRAM on them */
 249                 MCD_relocBuffDesc = MCD_singleBufDescs;
 250 #endif
 251         } else {
 252                 /* point the would-be relocated task tables and the
 253                    buffer descriptors to the ones the linker generated */
 254
 255                 if (((u32) MCD_realTaskTableSrc & 0x000001ff) != 0)
 256                         return (MCD_TABLE_UNALIGNED);
 257
 258                 /* need to add code to make sure that every thing else is
 259                    aligned properly TBD. this is problematic if we init
 260                    more than once or after running tasks, need to add
 261                    variable to see if we have aleady init'd */
 262                 entryPtr = MCD_realTaskTableSrc;
 263                 for (i = 0; i < NCHANNELS; i++) {
 264                         if (((entryPtr[i].varTab & (VAR_TAB_SIZE - 1)) != 0) ||
 265                             ((entryPtr[i].
 266                               FDTandFlags & (FUNCDESC_TAB_SIZE - 1)) != 0))
 267                                 return (MCD_TABLE_UNALIGNED);
 268                 }
 269
 270                 MCD_taskTable = MCD_realTaskTableSrc;
 271                 MCD_modelTaskTable = MCD_modelTaskTableSrc;
 272                 MCD_relocBuffDesc = MCD_singleBufDescs;
 273         }
 274
 275         /* Make all channels as totally inactive, and remember them as such: */
 276
 277         MCD_dmaBar->taskbar = (u32) MCD_taskTable;
 278         for (i = 0; i < NCHANNELS; i++) {
 279                 MCD_dmaBar->taskControl[i] = 0x0;
 280                 MCD_chStatus[i] = MCD_NO_DMA;
 281         }
 282
 283         /* Set up pausing mechanism to inactive state: */
 284         /* no particular values yet for either comparator registers */
 285         MCD_dmaBar->debugComp1 = 0;
 286         MCD_dmaBar->debugComp2 = 0;
 287         MCD_dmaBar->debugControl = DBG_CTL_DISABLE;
 288         MCD_dmaBar->debugStatus = DBG_KILL_ALL_STAT;
 289
 290         /* enable or disable commbus prefetch, really need an ifdef or
 291            something to keep from trying to set this in the 8220 */
 292         if ((flags & MCD_COMM_PREFETCH_EN) != 0)
 293                 MCD_dmaBar->ptdControl &= ~PTD_CTL_COMM_PREFETCH;
 294         else
 295                 MCD_dmaBar->ptdControl |= PTD_CTL_COMM_PREFETCH;
 296
 297         return (MCD_OK);
 298 }
 299
 300 /*********************** End of MCD_initDma() ***********************/
 301
 302 /********************************************************************/
 303 /* Function:   MCD_dmaStatus
 304  * Purpose:    Returns the status of the DMA on the requested channel
 305  * Arguments:  channel - channel number
 306  * Returns:    Predefined status indicators
 307  */
 308 int MCD_dmaStatus(int channel)
 309 {
 310         u16 tcrValue;
 311
 312         if ((channel < 0) || (channel >= NCHANNELS))
 313                 return (MCD_CHANNEL_INVALID);
 314
 315         tcrValue = MCD_dmaBar->taskControl[channel];
 316         if ((tcrValue & TASK_CTL_EN) == 0) {    /* nothing running */
 317                 /* if last reported with task enabled */
 318                 if (MCD_chStatus[channel] == MCD_RUNNING
 319                     || MCD_chStatus[channel] == MCD_IDLE)
 320                         MCD_chStatus[channel] = MCD_DONE;
 321         } else {                /* something is running */
 322
 323                 /* There are three possibilities: paused, running or idle. */
 324                 if (MCD_chStatus[channel] == MCD_RUNNING
 325                     || MCD_chStatus[channel] == MCD_IDLE) {
 326                         MCD_dmaBar->ptdDebug = PTD_DBG_TSK_VLD_INIT;
 327                         /* This register is selected to know which initiator is
 328                            actually asserted. */
 329                         if ((MCD_dmaBar->ptdDebug >> channel) & 0x1)
 330                                 MCD_chStatus[channel] = MCD_RUNNING;
 331                         else
 332                                 MCD_chStatus[channel] = MCD_IDLE;
 333                         /* do not change the status if it is already paused. */
 334                 }
 335         }
 336         return MCD_chStatus[channel];
 337 }
 338
 339 /******************** End of MCD_dmaStatus() ************************/
 340
 341 /********************************************************************/
 342 /* Function:    MCD_startDma
 343  * Ppurpose:    Starts a particular kind of DMA
 344  * Arguments:
 345  * srcAddr      - the channel on which to run the DMA
 346  * srcIncr      - the address to move data from, or buffer-descriptor address
 347  * destAddr     - the amount to increment the source address per transfer
 348  * destIncr     - the address to move data to
 349  * dmaSize      - the amount to increment the destination address per transfer
 350  * xferSize     - the number bytes in of each data movement (1, 2, or 4)
 351  * initiator    - what device initiates the DMA
 352  * priority     - priority of the DMA
 353  * flags        - flags describing the DMA
 354  * funcDesc     - description of byte swapping, bit swapping, and CRC actions
 355  * srcAddrVirt  - virtual buffer descriptor address TBD
 356  * Returns:     MCD_CHANNEL_INVALID if channel is invalid, else MCD_OK
 357  */
 358
 359 int MCD_startDma(int channel, s8 * srcAddr, s16 srcIncr, s8 * destAddr,
 360                  s16 destIncr, u32 dmaSize, u32 xferSize, u32 initiator,
 361                  int priority, u32 flags, u32 funcDesc
 362 #ifdef MCD_NEED_ADDR_TRANS
 363                  s8 * srcAddrVirt
 364 #endif
 365     )
 366 {
 367         int srcRsdIncr, destRsdIncr;
 368         int *cSave;
 369         short xferSizeIncr;
 370         int tcrCount = 0;
 371 #ifdef MCD_INCLUDE_EU
 372         u32 *realFuncArray;
 373 #endif
 374
 375         if ((channel < 0) || (channel >= NCHANNELS))
 376                 return (MCD_CHANNEL_INVALID);
 377
 378         /* tbd - need to determine the proper response to a bad funcDesc when
 379            not including EU functions, for now, assign a benign funcDesc, but
 380            maybe should return an error */
 381 #ifndef MCD_INCLUDE_EU
 382         funcDesc = MCD_FUNC_NOEU1;
 383 #endif
 384
 385 #ifdef MCD_DEBUG
 386         printf("startDma:Setting up params\n");
 387 #endif
 388         /* Set us up for task-wise priority.  We don't technically need to do
 389            this on every start, but since the register involved is in the same
 390            longword as other registers that users are in control of, setting
 391            it more than once is probably preferable.  That since the
 392            documentation doesn't seem to be completely consistent about the
 393            nature of the PTD control register. */
 394         MCD_dmaBar->ptdControl |= (u16) 0x8000;
 395
 396         /* Not sure what we need to keep here rtm TBD */
 397 #if 1
 398         /* Calculate additional parameters to the regular DMA calls. */
 399         srcRsdIncr = srcIncr < 0 ? -1 : (srcIncr > 0 ? 1 : 0);
 400         destRsdIncr = destIncr < 0 ? -1 : (destIncr > 0 ? 1 : 0);
 401
 402         xferSizeIncr = (xferSize & 0xffff) | 0x20000000;
 403
 404         /* Remember for each channel which variant is running. */
 405         MCD_remVariants.remSrcRsdIncr[channel] = srcRsdIncr;
 406         MCD_remVariants.remDestRsdIncr[channel] = destRsdIncr;
 407         MCD_remVariants.remDestIncr[channel] = destIncr;
 408         MCD_remVariants.remSrcIncr[channel] = srcIncr;
 409         MCD_remVariants.remXferSize[channel] = xferSize;
 410 #endif
 411
 412         cSave =
 413             (int *)(MCD_taskTable[channel].contextSaveSpace) + CSAVE_OFFSET +
 414             CURRBD;
 415
 416 #ifdef MCD_INCLUDE_EU
 417         /* may move this to EU specific calls */
 418         realFuncArray =
 419             (u32 *) (MCD_taskTable[channel].FDTandFlags & 0xffffff00);
 420         /* Modify the LURC's normal and byte-residue-loop functions according
 421            to parameter. */
 422         realFuncArray[(LURC * 16)] = xferSize == 4 ?
 423             funcDesc : xferSize == 2 ?
 424             funcDesc & 0xfffff00f : funcDesc & 0xffff000f;
 425         realFuncArray[(LURC * 16 + 1)] =
 426             (funcDesc & MCD_BYTE_SWAP_KILLER) | MCD_NO_BYTE_SWAP_ATALL;
 427 #endif
 428         /* Write the initiator field in the TCR, and also set the
 429            initiator-hold bit. Note that,due to a hardware quirk, this could
 430            collide with an MDE access to the initiator-register file, so we
 431            have to verify that the write reads back correctly. */
 432
 433         MCD_dmaBar->taskControl[channel] =
 434             (initiator << 8) | TASK_CTL_HIPRITSKEN | TASK_CTL_HLDINITNUM;
 435
 436         while (((MCD_dmaBar->taskControl[channel] & 0x1fff) !=
 437                 ((initiator << 8) | TASK_CTL_HIPRITSKEN | TASK_CTL_HLDINITNUM))
 438                && (tcrCount < 1000)) {
 439                 tcrCount++;
 440                 /*MCD_dmaBar->ptd_tcr[channel] = (initiator << 8) | 0x0020; */
 441                 MCD_dmaBar->taskControl[channel] =
 442                     (initiator << 8) | TASK_CTL_HIPRITSKEN |
 443                     TASK_CTL_HLDINITNUM;
 444         }
 445
 446         MCD_dmaBar->priority[channel] = (u8) priority & PRIORITY_PRI_MASK;
 447         /* should be albe to handle this stuff with only one write to ts reg
 448            - tbd */
 449         if (channel < 8 && channel >= 0) {
 450                 MCD_dmaBar->taskSize0 &= ~(0xf << (7 - channel) * 4);
 451                 MCD_dmaBar->taskSize0 |=
 452                     (xferSize & 3) << (((7 - channel) * 4) + 2);
 453                 MCD_dmaBar->taskSize0 |= (xferSize & 3) << ((7 - channel) * 4);
 454         } else {
 455                 MCD_dmaBar->taskSize1 &= ~(0xf << (15 - channel) * 4);
 456                 MCD_dmaBar->taskSize1 |=
 457                     (xferSize & 3) << (((15 - channel) * 4) + 2);
 458                 MCD_dmaBar->taskSize1 |= (xferSize & 3) << ((15 - channel) * 4);
 459         }
 460
 461         /* setup task table flags/options which mostly control the line
 462            buffers */
 463         MCD_taskTable[channel].FDTandFlags &= ~MCD_TT_FLAGS_MASK;
 464         MCD_taskTable[channel].FDTandFlags |= (MCD_TT_FLAGS_MASK & flags);
 465
 466         if (flags & MCD_FECTX_DMA) {
 467                 /* TDTStart and TDTEnd */
 468                 MCD_taskTable[channel].TDTstart =
 469                     MCD_modelTaskTable[TASK_FECTX].TDTstart;
 470                 MCD_taskTable[channel].TDTend =
 471                     MCD_modelTaskTable[TASK_FECTX].TDTend;
 472                 MCD_startDmaENetXmit((char *)srcAddr, (char *)srcAddr,
 473                                      (char *)destAddr, MCD_taskTable,
 474                                      channel);
 475         } else if (flags & MCD_FECRX_DMA) {
 476                 /* TDTStart and TDTEnd */
 477                 MCD_taskTable[channel].TDTstart =
 478                     MCD_modelTaskTable[TASK_FECRX].TDTstart;
 479                 MCD_taskTable[channel].TDTend =
 480                     MCD_modelTaskTable[TASK_FECRX].TDTend;
 481                 MCD_startDmaENetRcv((char *)srcAddr, (char *)srcAddr,
 482                                     (char *)destAddr, MCD_taskTable,
 483                                     channel);
 484         } else if (flags & MCD_SINGLE_DMA) {
 485                 /* this buffer descriptor is used for storing off initial
 486                    parameters for later progress query calculation and for the
 487                    DMA to write the resulting checksum. The DMA does not use
 488                    this to determine how to operate, that info is passed with
 489                    the init routine */
 490                 MCD_relocBuffDesc[channel].srcAddr = srcAddr;
 491                 MCD_relocBuffDesc[channel].destAddr = destAddr;
 492
 493                 /* definitely not its final value */
 494                 MCD_relocBuffDesc[channel].lastDestAddr = destAddr;
 495
 496                 MCD_relocBuffDesc[channel].dmaSize = dmaSize;
 497                 MCD_relocBuffDesc[channel].flags = 0;   /* not used */
 498                 MCD_relocBuffDesc[channel].csumResult = 0;      /* not used */
 499                 MCD_relocBuffDesc[channel].next = 0;    /* not used */
 500
 501                 /* Initialize the progress-querying stuff to show no
 502                    progress: */
 503                 ((volatile int *)MCD_taskTable[channel].
 504                  contextSaveSpace)[SRCPTR + CSAVE_OFFSET] = (int)srcAddr;
 505                 ((volatile int *)MCD_taskTable[channel].
 506                  contextSaveSpace)[DESTPTR + CSAVE_OFFSET] = (int)destAddr;
 507                 ((volatile int *)MCD_taskTable[channel].
 508                  contextSaveSpace)[DCOUNT + CSAVE_OFFSET] = 0;
 509                 ((volatile int *)MCD_taskTable[channel].
 510                  contextSaveSpace)[CURRBD + CSAVE_OFFSET] =
 511 (u32) & (MCD_relocBuffDesc[channel]);
 512                 /* tbd - need to keep the user from trying to call the EU
 513                    routine when MCD_INCLUDE_EU is not defined */
 514                 if (funcDesc == MCD_FUNC_NOEU1 || funcDesc == MCD_FUNC_NOEU2) {
 515                         /* TDTStart and TDTEnd */
 516                         MCD_taskTable[channel].TDTstart =
 517                             MCD_modelTaskTable[TASK_SINGLENOEU].TDTstart;
 518                         MCD_taskTable[channel].TDTend =
 519                             MCD_modelTaskTable[TASK_SINGLENOEU].TDTend;
 520                         MCD_startDmaSingleNoEu((char *)srcAddr, srcIncr,
 521                                                (char *)destAddr, destIncr,
 522                                                (int)dmaSize, xferSizeIncr,
 523                                                flags, (int *)
 524                                                &(MCD_relocBuffDesc[channel]),
 525                                                cSave, MCD_taskTable, channel);
 526                 } else {
 527                         /* TDTStart and TDTEnd */
 528                         MCD_taskTable[channel].TDTstart =
 529                             MCD_modelTaskTable[TASK_SINGLEEU].TDTstart;
 530                         MCD_taskTable[channel].TDTend =
 531                             MCD_modelTaskTable[TASK_SINGLEEU].TDTend;
 532                         MCD_startDmaSingleEu((char *)srcAddr, srcIncr,
 533                                              (char *)destAddr, destIncr,
 534                                              (int)dmaSize, xferSizeIncr,
 535                                              flags, (int *)
 536                                              &(MCD_relocBuffDesc[channel]),
 537                                              cSave, MCD_taskTable, channel);
 538                 }
 539         } else {                /* chained DMAS */
 540                 /* Initialize the progress-querying stuff to show no
 541                    progress: */
 542 #if 1
 543                 /* (!defined(MCD_NEED_ADDR_TRANS)) */
 544                 ((volatile int *)MCD_taskTable[channel].
 545                  contextSaveSpace)[SRCPTR + CSAVE_OFFSET]
 546                     = (int)((MCD_bufDesc *) srcAddr)->srcAddr;
 547                 ((volatile int *)MCD_taskTable[channel].
 548                  contextSaveSpace)[DESTPTR + CSAVE_OFFSET]
 549                     = (int)((MCD_bufDesc *) srcAddr)->destAddr;
 550 #else
 551                 /* if using address translation, need the virtual addr of the
 552                    first buffdesc */
 553                 ((volatile int *)MCD_taskTable[channel].
 554                  contextSaveSpace)[SRCPTR + CSAVE_OFFSET]
 555                     = (int)((MCD_bufDesc *) srcAddrVirt)->srcAddr;
 556                 ((volatile int *)MCD_taskTable[channel].
 557                  contextSaveSpace)[DESTPTR + CSAVE_OFFSET]
 558                     = (int)((MCD_bufDesc *) srcAddrVirt)->destAddr;
 559 #endif
 560                 ((volatile int *)MCD_taskTable[channel].
 561                  contextSaveSpace)[DCOUNT + CSAVE_OFFSET] = 0;
 562                 ((volatile int *)MCD_taskTable[channel].
 563                  contextSaveSpace)[CURRBD + CSAVE_OFFSET] = (u32) srcAddr;
 564
 565                 if (funcDesc == MCD_FUNC_NOEU1 || funcDesc == MCD_FUNC_NOEU2) {
 566                         /*TDTStart and TDTEnd */
 567                         MCD_taskTable[channel].TDTstart =
 568                             MCD_modelTaskTable[TASK_CHAINNOEU].TDTstart;
 569                         MCD_taskTable[channel].TDTend =
 570                             MCD_modelTaskTable[TASK_CHAINNOEU].TDTend;
 571                         MCD_startDmaChainNoEu((int *)srcAddr, srcIncr,
 572                                               destIncr, xferSize,
 573                                               xferSizeIncr, cSave,
 574                                               MCD_taskTable, channel);
 575                 } else {
 576                         /*TDTStart and TDTEnd */
 577                         MCD_taskTable[channel].TDTstart =
 578                             MCD_modelTaskTable[TASK_CHAINEU].TDTstart;
 579                         MCD_taskTable[channel].TDTend =
 580                             MCD_modelTaskTable[TASK_CHAINEU].TDTend;
 581                         MCD_startDmaChainEu((int *)srcAddr, srcIncr, destIncr,
 582                                             xferSize, xferSizeIncr, cSave,
 583                                             MCD_taskTable, channel);
 584                 }
 585         }
 586         MCD_chStatus[channel] = MCD_IDLE;
 587         return (MCD_OK);
 588 }
 589
 590 /************************ End of MCD_startDma() *********************/
 591
 592 /********************************************************************/
 593 /* Function:    MCD_XferProgrQuery
 594  * Purpose:     Returns progress of DMA on requested channel
 595  * Arguments:   channel - channel to retrieve progress for
 596  *              progRep - pointer to user supplied MCD_XferProg struct
 597  * Returns:     MCD_CHANNEL_INVALID if channel is invalid, else MCD_OK
 598  *
 599  * Notes:
 600  *  MCD_XferProgrQuery() upon completing or after aborting a DMA, or
 601  *  while the DMA is in progress, this function returns the first
 602  *  DMA-destination address not (or not yet) used in the DMA. When
 603  *  encountering a non-ready buffer descriptor, the information for
 604  *  the last completed descriptor is returned.
 605  *
 606  *  MCD_XferProgQuery() has to avoid the possibility of getting
 607  *  partially-updated information in the event that we should happen
 608  *  to query DMA progress just as the DMA is updating it. It does that
 609  *  by taking advantage of the fact context is not saved frequently for
 610  *  the most part. We therefore read it at least twice until we get the
 611  *  same information twice in a row.
 612  *
 613  *  Because a small, but not insignificant, amount of time is required
 614  *  to write out the progress-query information, especially upon
 615  *  completion of the DMA, it would be wise to guarantee some time lag
 616  *  between successive readings of the progress-query information.
 617  */
 618
 619 /* How many iterations of the loop below to execute to stabilize values */
 620 #define STABTIME 0
 621
 622 int MCD_XferProgrQuery(int channel, MCD_XferProg * progRep)
 623 {
 624         MCD_XferProg prevRep;
 625         int again;              /* true if we are to try again to ge
 626                                    consistent results */
 627         int i;                  /* used as a time-waste counter */
 628         int destDiffBytes;      /* Total no of bytes that we think actually
 629                                    got xfered. */
 630         int numIterations;      /* number of iterations */
 631         int bytesNotXfered;     /* bytes that did not get xfered. */
 632         s8 *LWAlignedInitDestAddr, *LWAlignedCurrDestAddr;
 633         int subModVal, addModVal;       /* Mode values to added and subtracted
 634                                            from the final destAddr */
 635
 636         if ((channel < 0) || (channel >= NCHANNELS))
 637                 return (MCD_CHANNEL_INVALID);
 638
 639         /* Read a trial value for the progress-reporting values */
 640         prevRep.lastSrcAddr =
 641             (s8 *) ((volatile int *)MCD_taskTable[channel].
 642                     contextSaveSpace)[SRCPTR + CSAVE_OFFSET];
 643         prevRep.lastDestAddr =
 644             (s8 *) ((volatile int *)MCD_taskTable[channel].
 645                     contextSaveSpace)[DESTPTR + CSAVE_OFFSET];
 646         prevRep.dmaSize =
 647             ((volatile int *)MCD_taskTable[channel].contextSaveSpace)[DCOUNT +
 648                                                                       CSAVE_OFFSET];
 649         prevRep.currBufDesc =
 650             (MCD_bufDesc *) ((volatile int *)MCD_taskTable[channel].
 651                              contextSaveSpace)[CURRBD + CSAVE_OFFSET];
 652         /* Repeatedly reread those values until they match previous values: */
 653         do {
 654                 /* Waste a little bit of time to ensure stability: */
 655                 for (i = 0; i < STABTIME; i++) {
 656                         /* make sure this loop does something so that it
 657                            doesn't get optimized out */
 658                         i += i >> 2;
 659                 }
 660                 /* Check them again: */
 661                 progRep->lastSrcAddr =
 662                     (s8 *) ((volatile int *)MCD_taskTable[channel].
 663                             contextSaveSpace)[SRCPTR + CSAVE_OFFSET];
 664                 progRep->lastDestAddr =
 665                     (s8 *) ((volatile int *)MCD_taskTable[channel].
 666                             contextSaveSpace)[DESTPTR + CSAVE_OFFSET];
 667                 progRep->dmaSize =
 668                     ((volatile int *)MCD_taskTable[channel].
 669                      contextSaveSpace)[DCOUNT + CSAVE_OFFSET];
 670                 progRep->currBufDesc =
 671                     (MCD_bufDesc *) ((volatile int *)MCD_taskTable[channel].
 672                                      contextSaveSpace)[CURRBD + CSAVE_OFFSET];
 673                 /* See if they match: */
 674                 if (prevRep.lastSrcAddr != progRep->lastSrcAddr
 675                     || prevRep.lastDestAddr != progRep->lastDestAddr
 676                     || prevRep.dmaSize != progRep->dmaSize
 677                     || prevRep.currBufDesc != progRep->currBufDesc) {
 678                         /* If they don't match, remember previous values and
 679                            try again: */
 680                         prevRep.lastSrcAddr = progRep->lastSrcAddr;
 681                         prevRep.lastDestAddr = progRep->lastDestAddr;
 682                         prevRep.dmaSize = progRep->dmaSize;
 683                         prevRep.currBufDesc = progRep->currBufDesc;
 684                         again = MCD_TRUE;
 685                 } else
 686                         again = MCD_FALSE;
 687         } while (again == MCD_TRUE);
 688
 689         /* Update the dCount, srcAddr and destAddr */
 690         /* To calculate dmaCount, we consider destination address. C
 691            overs M1,P1,Z for destination */
 692         switch (MCD_remVariants.remDestRsdIncr[channel]) {
 693         case MINUS1:
 694                 subModVal =
 695                     ((int)progRep->
 696                      lastDestAddr) & ((MCD_remVariants.remXferSize[channel]) -
 697                                       1);
 698                 addModVal =
 699                     ((int)progRep->currBufDesc->
 700                      destAddr) & ((MCD_remVariants.remXferSize[channel]) - 1);
 701                 LWAlignedInitDestAddr =
 702                     (progRep->currBufDesc->destAddr) - addModVal;
 703                 LWAlignedCurrDestAddr = (progRep->lastDestAddr) - subModVal;
 704                 destDiffBytes = LWAlignedInitDestAddr - LWAlignedCurrDestAddr;
 705                 bytesNotXfered =
 706                     (destDiffBytes / MCD_remVariants.remDestIncr[channel]) *
 707                     (MCD_remVariants.remDestIncr[channel]
 708                      + MCD_remVariants.remXferSize[channel]);
 709                 progRep->dmaSize =
 710                     destDiffBytes - bytesNotXfered + addModVal - subModVal;
 711                 break;
 712         case ZERO:
 713                 progRep->lastDestAddr = progRep->currBufDesc->destAddr;
 714                 break;
 715         case PLUS1:
 716                 /* This value has to be subtracted from the final
 717                    calculated dCount. */
 718                 subModVal =
 719                     ((int)progRep->currBufDesc->
 720                      destAddr) & ((MCD_remVariants.remXferSize[channel]) - 1);
 721                 /* These bytes are already in lastDestAddr. */
 722                 addModVal =
 723                     ((int)progRep->
 724                      lastDestAddr) & ((MCD_remVariants.remXferSize[channel]) -
 725                                       1);
 726                 LWAlignedInitDestAddr =
 727                     (progRep->currBufDesc->destAddr) - subModVal;
 728                 LWAlignedCurrDestAddr = (progRep->lastDestAddr) - addModVal;
 729                 destDiffBytes = (progRep->lastDestAddr - LWAlignedInitDestAddr);
 730                 numIterations =
 731                     (LWAlignedCurrDestAddr -
 732                      LWAlignedInitDestAddr) /
 733                     MCD_remVariants.remDestIncr[channel];
 734                 bytesNotXfered =
 735                     numIterations * (MCD_remVariants.remDestIncr[channel]
 736                                      - MCD_remVariants.remXferSize[channel]);
 737                 progRep->dmaSize = destDiffBytes - bytesNotXfered - subModVal;
 738                 break;
 739         default:
 740                 break;
 741         }
 742
 743         /* This covers M1,P1,Z for source */
 744         switch (MCD_remVariants.remSrcRsdIncr[channel]) {
 745         case MINUS1:
 746                 progRep->lastSrcAddr =
 747                     progRep->currBufDesc->srcAddr +
 748                     (MCD_remVariants.remSrcIncr[channel] *
 749                      (progRep->dmaSize / MCD_remVariants.remXferSize[channel]));
 750                 break;
 751         case ZERO:
 752                 progRep->lastSrcAddr = progRep->currBufDesc->srcAddr;
 753                 break;
 754         case PLUS1:
 755                 progRep->lastSrcAddr =
 756                     progRep->currBufDesc->srcAddr +
 757                     (MCD_remVariants.remSrcIncr[channel] *
 758                      (progRep->dmaSize / MCD_remVariants.remXferSize[channel]));
 759                 break;
 760         default:
 761                 break;
 762         }
 763
 764         return (MCD_OK);
 765 }
 766
 767 /******************* End of MCD_XferProgrQuery() ********************/
 768
 769 /********************************************************************/
 770 /* MCD_resmActions() does the majority of the actions of a DMA resume.
 771  * It is called from MCD_killDma() and MCD_resumeDma().  It has to be
 772  * a separate function because the kill function has to negate the task
 773  * enable before resuming it, but the resume function has to do nothing
 774  * if there is no DMA on that channel (i.e., if the enable bit is 0).
 775  */
 776 static void MCD_resmActions(int channel)
 777 {
 778         MCD_dmaBar->debugControl = DBG_CTL_DISABLE;
 779         MCD_dmaBar->debugStatus = MCD_dmaBar->debugStatus;
 780         /* This register is selected to know which initiator is
 781            actually asserted. */
 782         MCD_dmaBar->ptdDebug = PTD_DBG_TSK_VLD_INIT;
 783
 784         if ((MCD_dmaBar->ptdDebug >> channel) & 0x1)
 785                 MCD_chStatus[channel] = MCD_RUNNING;
 786         else
 787                 MCD_chStatus[channel] = MCD_IDLE;
 788 }
 789
 790 /********************* End of MCD_resmActions() *********************/
 791
 792 /********************************************************************/
 793 /* Function:    MCD_killDma
 794  * Purpose:     Halt the DMA on the requested channel, without any
 795  *              intention of resuming the DMA.
 796  * Arguments:   channel - requested channel
 797  * Returns:     MCD_CHANNEL_INVALID if channel is invalid, else MCD_OK
 798  *
 799  * Notes:
 800  *  A DMA may be killed from any state, including paused state, and it
 801  *  always goes to the MCD_HALTED state even if it is killed while in
 802  *  the MCD_NO_DMA or MCD_IDLE states.
 803  */
 804 int MCD_killDma(int channel)
 805 {
 806         /* MCD_XferProg progRep; */
 807
 808         if ((channel < 0) || (channel >= NCHANNELS))
 809                 return (MCD_CHANNEL_INVALID);
 810
 811         MCD_dmaBar->taskControl[channel] = 0x0;
 812         MCD_resumeDma(channel);
 813         /*
 814          * This must be after the write to the TCR so that the task doesn't
 815          * start up again momentarily, and before the status assignment so
 816          * as to override whatever MCD_resumeDma() may do to the channel
 817          * status.
 818          */
 819         MCD_chStatus[channel] = MCD_HALTED;
 820
 821         /*
 822          * Update the current buffer descriptor's lastDestAddr field
 823          *
 824          * MCD_XferProgrQuery (channel, &progRep);
 825          * progRep.currBufDesc->lastDestAddr = progRep.lastDestAddr;
 826          */
 827         return (MCD_OK);
 828 }
 829
 830 /************************ End of MCD_killDma() **********************/
 831
 832 /********************************************************************/
 833 /* Function:    MCD_continDma
 834  * Purpose:     Continue a DMA which as stopped due to encountering an
 835  *              unready buffer descriptor.
 836  * Arguments:   channel - channel to continue the DMA on
 837  * Returns:     MCD_CHANNEL_INVALID if channel is invalid, else MCD_OK
 838  *
 839  * Notes:
 840  *  This routine does not check to see if there is a task which can
 841  *  be continued. Also this routine should not be used with single DMAs.
 842  */
 843 int MCD_continDma(int channel)
 844 {
 845         if ((channel < 0) || (channel >= NCHANNELS))
 846                 return (MCD_CHANNEL_INVALID);
 847
 848         MCD_dmaBar->taskControl[channel] |= TASK_CTL_EN;
 849         MCD_chStatus[channel] = MCD_RUNNING;
 850
 851         return (MCD_OK);
 852 }
 853
 854 /********************** End of MCD_continDma() **********************/
 855
 856 /*********************************************************************
 857  * MCD_pauseDma() and MCD_resumeDma() below use the DMA's debug unit
 858  * to freeze a task and resume it.  We freeze a task by breakpointing
 859  * on the stated task.  That is, not any specific place in the task,
 860  * but any time that task executes.  In particular, when that task
 861  * executes, we want to freeze that task and only that task.
 862  *
 863  * The bits of the debug control register influence interrupts vs.
 864  * breakpoints as follows:
 865  * - Bits 14 and 0 enable or disable debug functions.  If enabled, you
 866  *   will get the interrupt but you may or may not get a breakpoint.
 867  * - Bits 2 and 1 decide whether you also get a breakpoint in addition
 868  *   to an interrupt.
 869  *
 870  * The debug unit can do these actions in response to either internally
 871  * detected breakpoint conditions from the comparators, or in response
 872  * to the external breakpoint pin, or both.
 873  * - Bits 14 and 1 perform the above-described functions for
 874  *   internally-generated conditions, i.e., the debug comparators.
 875  * - Bits 0 and 2 perform the above-described functions for external
 876  *   conditions, i.e., the breakpoint external pin.
 877  *
 878  * Note that, although you "always" get the interrupt when you turn
 879  * the debug functions, the interrupt can nevertheless, if desired, be
 880  * masked by the corresponding bit in the PTD's IMR. Note also that
 881  * this means that bits 14 and 0 must enable debug functions before
 882  * bits 1 and 2, respectively, have any effect.
 883  *
 884  * NOTE: It's extremely important to not pause more than one DMA channel
 885  *  at a time.
 886  ********************************************************************/
 887
 888 /********************************************************************/
 889 /* Function:    MCD_pauseDma
 890  * Purpose:     Pauses the DMA on a given channel (if any DMA is running
 891  *              on that channel).
 892  * Arguments:   channel
 893  * Returns:     MCD_CHANNEL_INVALID if channel is invalid, else MCD_OK
 894  */
 895 int MCD_pauseDma(int channel)
 896 {
 897         /* MCD_XferProg progRep; */
 898
 899         if ((channel < 0) || (channel >= NCHANNELS))
 900                 return (MCD_CHANNEL_INVALID);
 901
 902         if (MCD_dmaBar->taskControl[channel] & TASK_CTL_EN) {
 903                 MCD_dmaBar->debugComp1 = channel;
 904                 MCD_dmaBar->debugControl =
 905                     DBG_CTL_ENABLE | (1 << (channel + 16));
 906                 MCD_chStatus[channel] = MCD_PAUSED;
 907
 908                 /*
 909                  * Update the current buffer descriptor's lastDestAddr field
 910                  *
 911                  * MCD_XferProgrQuery (channel, &progRep);
 912                  * progRep.currBufDesc->lastDestAddr = progRep.lastDestAddr;
 913                  */
 914         }
 915         return (MCD_OK);
 916 }
 917
 918 /************************* End of MCD_pauseDma() ********************/
 919
 920 /********************************************************************/
 921 /* Function:    MCD_resumeDma
 922  * Purpose:     Resumes the DMA on a given channel (if any DMA is
 923  *              running on that channel).
 924  * Arguments:   channel - channel on which to resume DMA
 925  * Returns:     MCD_CHANNEL_INVALID if channel is invalid, else MCD_OK
 926  */
 927 int MCD_resumeDma(int channel)
 928 {
 929         if ((channel < 0) || (channel >= NCHANNELS))
 930                 return (MCD_CHANNEL_INVALID);
 931
 932         if (MCD_dmaBar->taskControl[channel] & TASK_CTL_EN)
 933                 MCD_resmActions(channel);
 934
 935         return (MCD_OK);
 936 }
 937
 938 /************************ End of MCD_resumeDma() ********************/
 939
 940 /********************************************************************/
 941 /* Function:    MCD_csumQuery
 942  * Purpose:     Provide the checksum after performing a non-chained DMA
 943  * Arguments:   channel - channel to report on
 944  *              csum - pointer to where to write the checksum/CRC
 945  * Returns:     MCD_ERROR if the channel is invalid, else MCD_OK
 946  *
 947  * Notes:
 948  *
 949  */
 950 int MCD_csumQuery(int channel, u32 * csum)
 951 {
 952 #ifdef MCD_INCLUDE_EU
 953         if ((channel < 0) || (channel >= NCHANNELS))
 954                 return (MCD_CHANNEL_INVALID);
 955
 956         *csum = MCD_relocBuffDesc[channel].csumResult;
 957         return (MCD_OK);
 958 #else
 959         return (MCD_ERROR);
 960 #endif
 961 }
 962
 963 /*********************** End of MCD_resumeDma() *********************/
 964
 965 /********************************************************************/
 966 /* Function:    MCD_getCodeSize
 967  * Purpose:     Provide the size requirements of the microcoded tasks
 968  * Returns:     Size in bytes
 969  */
 970 int MCD_getCodeSize(void)
 971 {
 972 #ifdef MCD_INCLUDE_EU
 973         return (0x2b5c);
 974 #else
 975         return (0x173c);
 976 #endif
 977 }
 978
 979 /********************** End of MCD_getCodeSize() ********************/
 980
 981 /********************************************************************/
 982 /* Function:    MCD_getVersion
 983  * Purpose:     Provide the version string and number
 984  * Arguments:   longVersion - user supplied pointer to a pointer to a char
 985  *                    which points to the version string
 986  * Returns:     Version number and version string (by reference)
 987  */
 988 char MCD_versionString[] = "Multi-channel DMA API Alpha v0.3 (2004-04-26)";
 989 #define MCD_REV_MAJOR   0x00
 990 #define MCD_REV_MINOR   0x03
 991
 992 int MCD_getVersion(char **longVersion)
 993 {
 994         *longVersion = MCD_versionString;
 995         return ((MCD_REV_MAJOR << 8) | MCD_REV_MINOR);
 996 }
 997
 998 /********************** End of MCD_getVersion() *********************/
 999
1000 /********************************************************************/
1001 /* Private version of memcpy()
1002  * Note that everything this is used for is longword-aligned.
1003  */
1004 static void MCD_memcpy(int *dest, int *src, u32 size)
1005 {
1006         u32 i;
1007
1008         for (i = 0; i < size; i += sizeof(int), dest++, src++)
1009                 *dest = *src;
1010 }