usbdrv/peripheral/pdd/pil/src/queue.cpp
author hgs
Wed, 25 Aug 2010 15:55:37 +0800
changeset 41 4ac512a68352
parent 33 089413cdde3c
child 59 bbdce6bffaad
permissions -rw-r--r--
201033_04
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
33
089413cdde3c 201028_02
hgs
parents:
diff changeset
     1
// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
089413cdde3c 201028_02
hgs
parents:
diff changeset
     2
// All rights reserved.
089413cdde3c 201028_02
hgs
parents:
diff changeset
     3
// This component and the accompanying materials are made available
089413cdde3c 201028_02
hgs
parents:
diff changeset
     4
// under the terms of the License "Eclipse Public License v1.0"
089413cdde3c 201028_02
hgs
parents:
diff changeset
     5
// which accompanies this distribution, and is available
089413cdde3c 201028_02
hgs
parents:
diff changeset
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
089413cdde3c 201028_02
hgs
parents:
diff changeset
     7
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
     8
// Initial Contributors:
089413cdde3c 201028_02
hgs
parents:
diff changeset
     9
// Nokia Corporation - initial contribution.
089413cdde3c 201028_02
hgs
parents:
diff changeset
    10
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    11
// Contributors:
089413cdde3c 201028_02
hgs
parents:
diff changeset
    12
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    13
// Description:
089413cdde3c 201028_02
hgs
parents:
diff changeset
    14
// e32\drivers\usbcc\queue.cpp
089413cdde3c 201028_02
hgs
parents:
diff changeset
    15
// Platform independent layer (PIL) of the USB Device controller driver:
089413cdde3c 201028_02
hgs
parents:
diff changeset
    16
// Simple singly linked list + its iterator.
089413cdde3c 201028_02
hgs
parents:
diff changeset
    17
// 
089413cdde3c 201028_02
hgs
parents:
diff changeset
    18
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    19
089413cdde3c 201028_02
hgs
parents:
diff changeset
    20
/**
089413cdde3c 201028_02
hgs
parents:
diff changeset
    21
 @file queue.cpp
089413cdde3c 201028_02
hgs
parents:
diff changeset
    22
 @internalTechnology
089413cdde3c 201028_02
hgs
parents:
diff changeset
    23
*/
089413cdde3c 201028_02
hgs
parents:
diff changeset
    24
//#include <drivers/usbc.h>
089413cdde3c 201028_02
hgs
parents:
diff changeset
    25
#include <usb/usbc.h>
089413cdde3c 201028_02
hgs
parents:
diff changeset
    26
089413cdde3c 201028_02
hgs
parents:
diff changeset
    27
089413cdde3c 201028_02
hgs
parents:
diff changeset
    28
void TSglQueLink::Enque(TSglQueLink* aLink)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    29
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    30
// Enque this after aLink.
089413cdde3c 201028_02
hgs
parents:
diff changeset
    31
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    32
    {
089413cdde3c 201028_02
hgs
parents:
diff changeset
    33
    iNext = aLink->iNext;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    34
    aLink->iNext = this;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    35
    }
089413cdde3c 201028_02
hgs
parents:
diff changeset
    36
089413cdde3c 201028_02
hgs
parents:
diff changeset
    37
089413cdde3c 201028_02
hgs
parents:
diff changeset
    38
TSglQueBase::TSglQueBase(TInt aOffset)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    39
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    40
// Constructor
089413cdde3c 201028_02
hgs
parents:
diff changeset
    41
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    42
    : iHead(NULL), iLast((TSglQueLink*) &iHead), iOffset(aOffset), iElements(0)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    43
    {
089413cdde3c 201028_02
hgs
parents:
diff changeset
    44
    // ESQueOffsetNotAligned
089413cdde3c 201028_02
hgs
parents:
diff changeset
    45
    __ASSERT_ALWAYS((iOffset % 4 == 0), Kern::Fault(KUsbPILPanicCat, __LINE__));
089413cdde3c 201028_02
hgs
parents:
diff changeset
    46
    }
089413cdde3c 201028_02
hgs
parents:
diff changeset
    47
089413cdde3c 201028_02
hgs
parents:
diff changeset
    48
089413cdde3c 201028_02
hgs
parents:
diff changeset
    49
void TSglQueBase::DoAddLast(TAny* aPtr)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    50
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    51
// Add the object at the end of the queue.
089413cdde3c 201028_02
hgs
parents:
diff changeset
    52
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    53
    {
089413cdde3c 201028_02
hgs
parents:
diff changeset
    54
    TSglQueLink* pL = PtrAdd((TSglQueLink*) aPtr, iOffset);
089413cdde3c 201028_02
hgs
parents:
diff changeset
    55
    pL->Enque(iLast);
089413cdde3c 201028_02
hgs
parents:
diff changeset
    56
    iLast = pL;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    57
    iElements++;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    58
    __ASSERT_DEBUG((iElements > 0), Kern::Fault(KUsbPILPanicCat, __LINE__));
089413cdde3c 201028_02
hgs
parents:
diff changeset
    59
    }
089413cdde3c 201028_02
hgs
parents:
diff changeset
    60
089413cdde3c 201028_02
hgs
parents:
diff changeset
    61
089413cdde3c 201028_02
hgs
parents:
diff changeset
    62
void TSglQueBase::DoRemove(TAny* aPtr)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    63
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    64
// Remove the object from the queue.
089413cdde3c 201028_02
hgs
parents:
diff changeset
    65
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    66
    {
089413cdde3c 201028_02
hgs
parents:
diff changeset
    67
    TSglQueLink* pP = (TSglQueLink*) (&iHead);
089413cdde3c 201028_02
hgs
parents:
diff changeset
    68
    TSglQueLink* pL = PtrAdd((TSglQueLink*) aPtr, iOffset);
089413cdde3c 201028_02
hgs
parents:
diff changeset
    69
    TSglQueLink* pN = pP->iNext;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    70
    while (pN)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    71
        {
089413cdde3c 201028_02
hgs
parents:
diff changeset
    72
        if (pN == pL)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    73
            {
089413cdde3c 201028_02
hgs
parents:
diff changeset
    74
            pP->iNext = pN->iNext;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    75
            if (iLast == pL)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    76
                {
089413cdde3c 201028_02
hgs
parents:
diff changeset
    77
                iLast = pP;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    78
                if (iLast == NULL)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    79
                    iLast = (TSglQueLink*) (&iHead);
089413cdde3c 201028_02
hgs
parents:
diff changeset
    80
                }
089413cdde3c 201028_02
hgs
parents:
diff changeset
    81
            iElements--;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    82
            __ASSERT_DEBUG((iElements >= 0), Kern::Fault(KUsbPILPanicCat, __LINE__));
089413cdde3c 201028_02
hgs
parents:
diff changeset
    83
            return;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    84
            }
089413cdde3c 201028_02
hgs
parents:
diff changeset
    85
        pP = pN;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    86
        pN = pP->iNext;
089413cdde3c 201028_02
hgs
parents:
diff changeset
    87
        }
089413cdde3c 201028_02
hgs
parents:
diff changeset
    88
    // This doesn't have to indicate an error (but might):
089413cdde3c 201028_02
hgs
parents:
diff changeset
    89
    __KTRACE_OPT(KPANIC, Kern::Printf("TSglQueBase::DoRemove: ESQueLinkNotQueued"));
089413cdde3c 201028_02
hgs
parents:
diff changeset
    90
    }
089413cdde3c 201028_02
hgs
parents:
diff changeset
    91
089413cdde3c 201028_02
hgs
parents:
diff changeset
    92
089413cdde3c 201028_02
hgs
parents:
diff changeset
    93
TSglQueIterBase::TSglQueIterBase(TSglQueBase& aQue)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    94
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    95
// Constructor.
089413cdde3c 201028_02
hgs
parents:
diff changeset
    96
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
    97
    : iOffset(aQue.iOffset), iHead(aQue.iHead), iNext(aQue.iHead)
089413cdde3c 201028_02
hgs
parents:
diff changeset
    98
    {
089413cdde3c 201028_02
hgs
parents:
diff changeset
    99
    }
089413cdde3c 201028_02
hgs
parents:
diff changeset
   100
089413cdde3c 201028_02
hgs
parents:
diff changeset
   101
089413cdde3c 201028_02
hgs
parents:
diff changeset
   102
void TSglQueIterBase::SetToFirst()
089413cdde3c 201028_02
hgs
parents:
diff changeset
   103
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
   104
// Start from the beginning of the que.
089413cdde3c 201028_02
hgs
parents:
diff changeset
   105
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
   106
    {
089413cdde3c 201028_02
hgs
parents:
diff changeset
   107
    iNext = iHead->iNext;
089413cdde3c 201028_02
hgs
parents:
diff changeset
   108
    }
089413cdde3c 201028_02
hgs
parents:
diff changeset
   109
089413cdde3c 201028_02
hgs
parents:
diff changeset
   110
089413cdde3c 201028_02
hgs
parents:
diff changeset
   111
TAny* TSglQueIterBase::DoPostInc()
089413cdde3c 201028_02
hgs
parents:
diff changeset
   112
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
   113
// Return the current pointer and increment.
089413cdde3c 201028_02
hgs
parents:
diff changeset
   114
//
089413cdde3c 201028_02
hgs
parents:
diff changeset
   115
    {
089413cdde3c 201028_02
hgs
parents:
diff changeset
   116
    TAny* pN = iNext;
089413cdde3c 201028_02
hgs
parents:
diff changeset
   117
    if (pN == NULL)
089413cdde3c 201028_02
hgs
parents:
diff changeset
   118
        return NULL;
089413cdde3c 201028_02
hgs
parents:
diff changeset
   119
    iNext = iNext->iNext;
089413cdde3c 201028_02
hgs
parents:
diff changeset
   120
    return PtrSub(pN, iOffset);
089413cdde3c 201028_02
hgs
parents:
diff changeset
   121
    }
089413cdde3c 201028_02
hgs
parents:
diff changeset
   122
089413cdde3c 201028_02
hgs
parents:
diff changeset
   123
089413cdde3c 201028_02
hgs
parents:
diff changeset
   124
//---