OpenCSD - CoreSight Trace Decode Library  0.14.0
trc_pkt_decode_etmv4i.h
Go to the documentation of this file.
1 /*
2  * \file trc_pkt_decode_etmv4i.h
3  * \brief OpenCSD : ETMv4 instruction decoder
4  *
5  * \copyright Copyright (c) 2015, ARM Limited. All Rights Reserved.
6  */
7 
8 /*
9  * Redistribution and use in source and binary forms, with or without modification,
10  * are permitted provided that the following conditions are met:
11  *
12  * 1. Redistributions of source code must retain the above copyright notice,
13  * this list of conditions and the following disclaimer.
14  *
15  * 2. Redistributions in binary form must reproduce the above copyright notice,
16  * this list of conditions and the following disclaimer in the documentation
17  * and/or other materials provided with the distribution.
18  *
19  * 3. Neither the name of the copyright holder nor the names of its contributors
20  * may be used to endorse or promote products derived from this software without
21  * specific prior written permission.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS' AND
24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
25  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
26  * IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
27  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
28  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
29  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
30  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
32  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33  */
34 
35 #ifndef ARM_TRC_PKT_DECODE_ETMV4I_H_INCLUDED
36 #define ARM_TRC_PKT_DECODE_ETMV4I_H_INCLUDED
37 
41 #include "common/trc_gen_elem.h"
42 #include "common/trc_ret_stack.h"
45 
46 class TrcStackElem;
47 class TrcStackElemParam;
48 class TrcStackElemCtxt;
49 
50 class TrcPktDecodeEtmV4I : public TrcPktDecodeBase<EtmV4ITrcPacket, EtmV4Config>
51 {
52 public:
54  TrcPktDecodeEtmV4I(int instIDNum);
55  virtual ~TrcPktDecodeEtmV4I();
56 
57 protected:
58  /* implementation packet decoding interface */
60  virtual ocsd_datapath_resp_t onEOT();
61  virtual ocsd_datapath_resp_t onReset();
62  virtual ocsd_datapath_resp_t onFlush();
63  virtual ocsd_err_t onProtocolConfig();
64  virtual const uint8_t getCoreSightTraceID() { return m_CSID; };
65 
66  /* local decode methods */
67  void initDecoder(); // initial state on creation (zeros all config)
68  void resetDecoder(); // reset state to start of decode. (moves state, retains config)
69  virtual void onFirstInitOK(); // override to set init related info.
70 
71  ocsd_err_t decodePacket(); // decode packet into trace elements. return true to indicate decode complete - can change FSM to commit state - return is false.
72  ocsd_datapath_resp_t resolveElements(); // commit/cancel trace elements generated from latest / prior packets & send to output - may get wait response, or flag completion.
73  ocsd_err_t commitElements(); // commit elements - process element stack to generate output packets.
75  ocsd_err_t cancelElements(); // cancel elements. These not output
76  ocsd_err_t mispredictAtom(); // mispredict an atom
77  ocsd_err_t discardElements(); // discard elements and flush
78 
79  void doTraceInfoPacket();
80  void updateContext(TrcStackElemCtxt *pCtxtElem, OcsdTraceElement &elem);
81 
82  // process atom will create instruction trace, or no memory access trace output elements.
84 
85  // process an exception element - output instruction trace + exception generic type.
87 
88  // process an element that cannot be cancelled / discarded
90 
91  // process a bad packet
92  ocsd_err_t handleBadPacket(const char *reason);
93 
95  ocsd_err_t addElemTS(TrcStackElemParam *pParamElem, bool withCC);
97 
98 private:
99  void SetInstrInfoInAddrISA(const ocsd_vaddr_t addr_val, const uint8_t isa);
100  const ocsd_isa calcISA(const bool SF, const uint8_t IS) const
101  {
102  if (SF)
103  return ocsd_isa_aarch64;
104  return (IS == 0) ? ocsd_isa_arm : ocsd_isa_thumb2;
105  }
106  typedef enum {
107  WP_NOT_FOUND,
108  WP_FOUND,
109  WP_NACC
110  } WP_res_t;
111 
112  typedef struct {
113  ocsd_vaddr_t st_addr;
114  ocsd_vaddr_t en_addr;
115  uint32_t num_instr;
116  } instr_range_t;
117 
119  ocsd_err_t traceInstrToWP(instr_range_t &instr_range, WP_res_t &WPRes, const bool traceToAddrNext = false, const ocsd_vaddr_t nextAddrMatch = 0);
120 
121  inline const bool WPFound(WP_res_t res) const { return (res == WP_FOUND); };
122  inline const bool WPNacc(WP_res_t res) const { return (res == WP_NACC); };
123 
124  ocsd_err_t returnStackPop(); // pop return stack and update instruction address.
125 
126  void setElemTraceRange(OcsdTraceElement &elemIn, const instr_range_t &addr_range, const bool executed, ocsd_trc_index_t index);
127 
128  ocsd_mem_space_acc_t getCurrMemSpace();
129 
130 //** intra packet state (see ETMv4 spec 6.2.1);
131 
132  // timestamping
133  uint64_t m_timestamp; // last broadcast global Timestamp.
134 
135  // state and context
136  uint32_t m_context_id; // most recent context ID
137  uint32_t m_vmid_id; // most recent VMID
138  bool m_is_secure; // true if Secure
139  bool m_is_64bit; // true if 64 bit
140  uint8_t m_last_IS; // last instruction set value from address packet.
141 
142  // cycle counts
143  int m_cc_threshold;
144 
145  // speculative trace
146  int m_curr_spec_depth;
147  int m_max_spec_depth; // nax depth - from ID reg, beyond which auto-commit occurs
148  int m_unseen_spec_elem; // speculative elements at decode start
149 
151 #ifdef DATA_TRACE_SUPPORTED
152  // data trace associative elements (unsupported at present in the decoder).
153  int m_p0_key;
154  int m_p0_key_max;
155 
156  // conditional non-branch trace - when data trace active (unsupported at present in the decoder)
157  int m_cond_c_key;
158  int m_cond_r_key;
159  int m_cond_key_max_incr;
160 #endif
161 
162  uint8_t m_CSID;
163 
164  bool m_IASize64;
165 
166 //** Other processor state;
167 
168  // trace decode FSM
169  typedef enum {
170  NO_SYNC,
171  WAIT_SYNC,
172  WAIT_TINFO,
173  DECODE_PKTS,
174  RESOLVE_ELEM,
175  } processor_state_t;
176 
177  processor_state_t m_curr_state;
178  unsync_info_t m_unsync_eot_info;
179 
180 //** P0 element stack
181  EtmV4P0Stack m_P0_stack;
182 
183  // element resolution
184  struct {
185  int P0_commit;
186  int P0_cancel;
187  bool mispredict;
188  bool discard;
189  } m_elem_res;
190 
192  const bool isElemForRes() const {
193  return (m_elem_res.P0_commit || m_elem_res.P0_cancel ||
194  m_elem_res.mispredict || m_elem_res.discard);
195  }
196 
197  void clearElemRes() {
198  m_elem_res.P0_commit = 0;
199  m_elem_res.P0_cancel = 0;
200  m_elem_res.mispredict = false;
201  m_elem_res.discard = false;
202  }
203 
204  // packet decode state
205  bool m_need_ctxt;
206  bool m_need_addr;
207  bool m_elem_pending_addr;
208 
209  ocsd_instr_info m_instr_info;
210 
211  ocsd_pe_context m_pe_context;
212  etmv4_trace_info_t m_trace_info;
213 
214  bool m_prev_overflow;
215 
216  TrcAddrReturnStack m_return_stack;
217 
218 //** output element handling
219  OcsdGenElemStack m_out_elem;
220  OcsdTraceElement &outElem() { return m_out_elem.getCurrElem(); };
221 };
222 
223 #endif // ARM_TRC_PKT_DECODE_ETMV4I_H_INCLUDED
224 
225 /* End of File trc_pkt_decode_etmv4i.h */
ocsd_datapath_resp_t
enum _ocsd_datapath_resp_t ocsd_datapath_resp_t
_ocsd_instr_info
Definition: ocsd_if_types.h:382
TrcPktDecodeEtmV4I::addElemTS
ocsd_err_t addElemTS(TrcStackElemParam *pParamElem, bool withCC)
TrcPktDecodeEtmV4I::doTraceInfoPacket
void doTraceInfoPacket()
OcsdTraceElement
Generic trace element class.
Definition: trc_gen_elem.h:49
TrcStackElemParam
Definition: trc_etmv4_stack_elem.h:276
TrcPktDecodeEtmV4I::commitElemOnEOT
ocsd_err_t commitElemOnEOT()
_etmv4_trace_info_t
Definition: trc_pkt_types_etmv4.h:152
TrcPktDecodeEtmV4I::decodePacket
ocsd_err_t decodePacket()
TrcPktDecodeEtmV4I::getCoreSightTraceID
virtual const uint8_t getCoreSightTraceID()
Definition: trc_pkt_decode_etmv4i.h:64
TrcPktDecodeEtmV4I::processPacket
virtual ocsd_datapath_resp_t processPacket()
TrcPktDecodeEtmV4I::P0_commit
int P0_commit
number of elements to commit
Definition: trc_pkt_decode_etmv4i.h:185
OcsdGenElemStack::getCurrElem
OcsdTraceElement & getCurrElem()
get the current element.
Definition: ocsd_gen_elem_stack.h:103
TrcStackElemCtxt
Definition: trc_etmv4_stack_elem.h:164
TrcPktDecodeEtmV4I::onReset
virtual ocsd_datapath_resp_t onReset()
TrcPktDecodeEtmV4I::processTS_CC_EventElem
ocsd_err_t processTS_CC_EventElem(TrcStackElem *pElem)
TrcPktDecodeEtmV4I::discardElements
ocsd_err_t discardElements()
TrcPktDecodeEtmV4I::cancelElements
ocsd_err_t cancelElements()
TrcPktDecodeEtmV4I::discard
bool discard
discard elements
Definition: trc_pkt_decode_etmv4i.h:188
TrcPktDecodeEtmV4I::onFlush
virtual ocsd_datapath_resp_t onFlush()
TrcPktDecodeBase
Definition: trc_pkt_decode_base.h:185
OcsdGenElemStack
Definition: ocsd_gen_elem_stack.h:44
TrcPktDecodeEtmV4I::resetDecoder
void resetDecoder()
ocsd_vaddr_t
uint64_t ocsd_vaddr_t
Definition: ocsd_if_types.h:308
TrcPktDecodeEtmV4I::onFirstInitOK
virtual void onFirstInitOK()
ocsd_err_t
enum _ocsd_err_t ocsd_err_t
ocsd_atm_val
enum _ocsd_atm_val ocsd_atm_val
TrcPktDecodeEtmV4I::addElemCC
ocsd_err_t addElemCC(TrcStackElemParam *pParamElem)
TrcPktDecodeEtmV4I::updateContext
void updateContext(TrcStackElemCtxt *pCtxtElem, OcsdTraceElement &elem)
TrcPktDecodeEtmV4I::mispredictAtom
ocsd_err_t mispredictAtom()
TrcPktDecodeEtmV4I::mispredict
bool mispredict
mispredict latest atom
Definition: trc_pkt_decode_etmv4i.h:187
TrcPktDecodeEtmV4I::processAtom
ocsd_err_t processAtom(const ocsd_atm_val atom)
TrcPktDecodeEtmV4I::initDecoder
void initDecoder()
TrcPktDecodeEtmV4I
Definition: trc_pkt_decode_etmv4i.h:50
unsync_info_t
enum _unsync_info_t unsync_info_t
trc_gen_elem.h
OpenCSD : Decoder Generic trace element output class.
ocsd_isa_thumb2
@ ocsd_isa_thumb2
Definition: ocsd_if_types.h:327
EtmV4P0Stack
Definition: trc_etmv4_stack_elem.h:300
TrcAddrReturnStack
Definition: trc_ret_stack.h:53
ocsd_isa_aarch64
@ ocsd_isa_aarch64
Definition: ocsd_if_types.h:328
TrcPktDecodeEtmV4I::commitElements
ocsd_err_t commitElements()
TrcPktDecodeEtmV4I::~TrcPktDecodeEtmV4I
virtual ~TrcPktDecodeEtmV4I()
_ocsd_pe_context
Definition: ocsd_if_types.h:406
trc_ret_stack.h
trc_cmp_cfg_etmv4.h
ocsd_trc_index_t
uint32_t ocsd_trc_index_t
Definition: ocsd_if_types.h:67
TrcStackElem
Definition: trc_etmv4_stack_elem.h:69
trc_pkt_decode_base.h
OpenCSD : Trace Packet decoder base class.
TrcPktDecodeEtmV4I::addElemEvent
ocsd_err_t addElemEvent(TrcStackElemParam *pParamElem)
ocsd_mem_space_acc_t
enum _ocsd_mem_space_acc_t ocsd_mem_space_acc_t
ocsd_gen_elem_stack.h
TrcPktDecodeEtmV4I::onProtocolConfig
virtual ocsd_err_t onProtocolConfig()
TrcPktDecodeEtmV4I::resolveElements
ocsd_datapath_resp_t resolveElements()
TrcPktDecodeEtmV4I::handleBadPacket
ocsd_err_t handleBadPacket(const char *reason)
ocsd_isa_arm
@ ocsd_isa_arm
Definition: ocsd_if_types.h:326
TrcPktDecodeEtmV4I::P0_cancel
int P0_cancel
elements to cancel
Definition: trc_pkt_decode_etmv4i.h:186
TrcPktDecodeEtmV4I::TrcPktDecodeEtmV4I
TrcPktDecodeEtmV4I()
trc_pkt_elem_etmv4i.h
trc_etmv4_stack_elem.h
ocsd_isa
enum _ocsd_isa ocsd_isa
TrcPktDecodeEtmV4I::processException
ocsd_err_t processException()
TrcPktDecodeEtmV4I::onEOT
virtual ocsd_datapath_resp_t onEOT()