aboutsummaryrefslogtreecommitdiffstats
path: root/decoder/include/common/ocsd_gen_elem_list.h
blob: 2dab240140bf1ad6568ab4ea1c37243139c7813d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
/*
 * \file       ocsd_gen_elem_list.h
 * \brief      OpenCSD : Generic element output list.
 * 
 * \copyright  Copyright (c) 2016, ARM Limited. All Rights Reserved.
 */

/* 
 * Redistribution and use in source and binary forms, with or without modification, 
 * are permitted provided that the following conditions are met:
 * 
 * 1. Redistributions of source code must retain the above copyright notice, 
 * this list of conditions and the following disclaimer.
 * 
 * 2. Redistributions in binary form must reproduce the above copyright notice, 
 * this list of conditions and the following disclaimer in the documentation 
 * and/or other materials provided with the distribution. 
 * 
 * 3. Neither the name of the copyright holder nor the names of its contributors 
 * may be used to endorse or promote products derived from this software without 
 * specific prior written permission. 
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS' AND 
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 
 * IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
 */ 

#include <list>
#include "trc_gen_elem.h"
#include "comp_attach_pt_t.h"
#include "interfaces/trc_gen_elem_in_i.h"

/*!
 * @class OcsdGenElemList
 * @brief Maintain a list of elements to be output
 * 
 * Each incoming packet can result in multiple output elements.
 * These are stacked in this class prior to entering the output phase of processing.
 *
 * This should remove some of the requirement on the packet processing to be re-enterant,
 * simplifying this code.
 *
 * Last element(s) on this list can be marked pending to allow for later cancellation.
 * (This required for cancel element in ETMv3 exeception branch).
 * 
 * The "list" is actually a ring buffer - maintaining pointers to indicate current valid elements.
 * This buffer can increase on demand, but will only be released at the end of a decode session.
 */
class OcsdGenElemList
{
public:
    OcsdGenElemList();
    ~OcsdGenElemList();

    void initSendIf(componentAttachPt<ITrcGenElemIn> *pGenElemIf);
    void initCSID(const uint8_t CSID) { m_CSID = CSID; };

    void reset();   //!< reset the element list.

    OcsdTraceElement *getNextElem(const ocsd_trc_index_t trc_pkt_idx); //!< get next free element on the stack (add one to the output)
    const int getNumElem() const;                                      //!< return the total number of elements on the stack (inlcuding any pended ones).
    
    const ocsd_gen_trc_elem_t getElemType(const int entryN) const;    //!< get the type for the nth element in the stack (0 indexed)

    void pendLastNElem(int numPend);    //!< Last element to be pended prior to cancel/commit decision.
    void commitAllPendElem();           //!< commit all pended elements.
    void cancelPendElem();              //!< cancel the last pended element on the stack.
    const int numPendElem() const;      //!< return the number of pended elements.

    /*! Send all of the none pended elements
        Stop sending when all sent or _CONT response.
     */
    ocsd_datapath_resp_t sendElements(); 
    const bool elemToSend() const;  //!< true if any none-pending elements left to send.

private:

    void growArray();
    const int getAdjustedIdx(int idxIn) const;  //!< get adjusted index into circular buffer.


    // list element contains pointer and byte index in trace stream
    typedef struct _elemPtr {
        OcsdTraceElement *pElem;        //!< pointer to the listed trace element
        ocsd_trc_index_t trc_pkt_idx;   //!< packet index in the trace stream
    } elemPtr_t;

    elemPtr_t *m_pElemArray;    //!< an array of pointers to elements.
    int m_elemArraySize;        //!< number of element pointers in the array 

    int m_firstElemIdx;        //!< internal index in array of first element in use.
    int m_numUsed;             //!< number of elements in use
    int m_numPend;             //!< internal count of pended elements.

    uint8_t m_CSID;

    componentAttachPt<ITrcGenElemIn> *m_sendIf; //!< element send interface.
};

inline const int OcsdGenElemList::getAdjustedIdx(int idxIn) const
{
    if(idxIn >= m_elemArraySize)
        idxIn -= m_elemArraySize;
    return idxIn;
}

inline const int OcsdGenElemList::getNumElem() const 
{ 
    return m_numUsed; 
}

inline const int OcsdGenElemList::numPendElem() const
{
    return m_numPend;
}

inline void OcsdGenElemList::pendLastNElem(int numPend)
{
    if(numPend >= getNumElem())
        m_numPend = numPend;
}

inline void OcsdGenElemList::commitAllPendElem()
{
     m_numPend = 0;
}

inline void OcsdGenElemList::cancelPendElem()
{
    if(m_numPend > 0)
    {
        m_numUsed -= m_numPend;
    }
}

inline const bool OcsdGenElemList::elemToSend() const
{
    return ((getNumElem() - m_numPend) > 0);
}

inline void OcsdGenElemList::initSendIf(componentAttachPt<ITrcGenElemIn> *pGenElemIf)
{
    m_sendIf = pGenElemIf;
}

/* End of File ocsd_gen_elem_list.h */