Linux Audio

Check our new training course

Loading...
v4.17
 1/* SPDX-License-Identifier: GPL-2.0 */
 2/*
 3 * Copyright(C) 2015 Linaro Limited. All rights reserved.
 4 * Author: Mathieu Poirier <mathieu.poirier@linaro.org>
 5 */
 6
 7#ifndef INCLUDE__UTIL_PERF_CS_ETM_H__
 8#define INCLUDE__UTIL_PERF_CS_ETM_H__
 9
10#include "util/event.h"
11#include "util/session.h"
 
 
12
13/* Versionning header in case things need tro change in the future.  That way
14 * decoding of old snapshot is still possible.
15 */
16enum {
17	/* Starting with 0x0 */
18	CS_HEADER_VERSION_0,
19	/* PMU->type (32 bit), total # of CPUs (32 bit) */
20	CS_PMU_TYPE_CPUS,
21	CS_ETM_SNAPSHOT,
22	CS_HEADER_VERSION_0_MAX,
23};
24
25/* Beginning of header common to both ETMv3 and V4 */
26enum {
27	CS_ETM_MAGIC,
28	CS_ETM_CPU,
29};
30
31/* ETMv3/PTM metadata */
32enum {
33	/* Dynamic, configurable parameters */
34	CS_ETM_ETMCR = CS_ETM_CPU + 1,
35	CS_ETM_ETMTRACEIDR,
36	/* RO, taken from sysFS */
37	CS_ETM_ETMCCER,
38	CS_ETM_ETMIDR,
39	CS_ETM_PRIV_MAX,
40};
41
42/* ETMv4 metadata */
43enum {
44	/* Dynamic, configurable parameters */
45	CS_ETMV4_TRCCONFIGR = CS_ETM_CPU + 1,
46	CS_ETMV4_TRCTRACEIDR,
47	/* RO, taken from sysFS */
48	CS_ETMV4_TRCIDR0,
49	CS_ETMV4_TRCIDR1,
50	CS_ETMV4_TRCIDR2,
51	CS_ETMV4_TRCIDR8,
52	CS_ETMV4_TRCAUTHSTATUS,
53	CS_ETMV4_PRIV_MAX,
54};
55
56/* RB tree for quick conversion between traceID and CPUs */
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
57struct intlist *traceid_list;
58
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
59#define KiB(x) ((x) * 1024)
60#define MiB(x) ((x) * 1024 * 1024)
61
 
 
 
 
62#define CS_ETM_HEADER_SIZE (CS_HEADER_VERSION_0_MAX * sizeof(u64))
63
64static const u64 __perf_cs_etmv3_magic   = 0x3030303030303030ULL;
65static const u64 __perf_cs_etmv4_magic   = 0x4040404040404040ULL;
66#define CS_ETMV3_PRIV_SIZE (CS_ETM_PRIV_MAX * sizeof(u64))
67#define CS_ETMV4_PRIV_SIZE (CS_ETMV4_PRIV_MAX * sizeof(u64))
68
69#ifdef HAVE_CSTRACE_SUPPORT
70int cs_etm__process_auxtrace_info(union perf_event *event,
71				  struct perf_session *session);
 
 
 
 
 
 
 
 
72#else
73static inline int
74cs_etm__process_auxtrace_info(union perf_event *event __maybe_unused,
75			      struct perf_session *session __maybe_unused)
76{
77	return -1;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
78}
79#endif
80
81#endif
v5.4
  1/* SPDX-License-Identifier: GPL-2.0 */
  2/*
  3 * Copyright(C) 2015 Linaro Limited. All rights reserved.
  4 * Author: Mathieu Poirier <mathieu.poirier@linaro.org>
  5 */
  6
  7#ifndef INCLUDE__UTIL_PERF_CS_ETM_H__
  8#define INCLUDE__UTIL_PERF_CS_ETM_H__
  9
 10#include "util/event.h"
 11#include <linux/bits.h>
 12
 13struct perf_session;
 14
 15/* Versionning header in case things need tro change in the future.  That way
 16 * decoding of old snapshot is still possible.
 17 */
 18enum {
 19	/* Starting with 0x0 */
 20	CS_HEADER_VERSION_0,
 21	/* PMU->type (32 bit), total # of CPUs (32 bit) */
 22	CS_PMU_TYPE_CPUS,
 23	CS_ETM_SNAPSHOT,
 24	CS_HEADER_VERSION_0_MAX,
 25};
 26
 27/* Beginning of header common to both ETMv3 and V4 */
 28enum {
 29	CS_ETM_MAGIC,
 30	CS_ETM_CPU,
 31};
 32
 33/* ETMv3/PTM metadata */
 34enum {
 35	/* Dynamic, configurable parameters */
 36	CS_ETM_ETMCR = CS_ETM_CPU + 1,
 37	CS_ETM_ETMTRACEIDR,
 38	/* RO, taken from sysFS */
 39	CS_ETM_ETMCCER,
 40	CS_ETM_ETMIDR,
 41	CS_ETM_PRIV_MAX,
 42};
 43
 44/* ETMv4 metadata */
 45enum {
 46	/* Dynamic, configurable parameters */
 47	CS_ETMV4_TRCCONFIGR = CS_ETM_CPU + 1,
 48	CS_ETMV4_TRCTRACEIDR,
 49	/* RO, taken from sysFS */
 50	CS_ETMV4_TRCIDR0,
 51	CS_ETMV4_TRCIDR1,
 52	CS_ETMV4_TRCIDR2,
 53	CS_ETMV4_TRCIDR8,
 54	CS_ETMV4_TRCAUTHSTATUS,
 55	CS_ETMV4_PRIV_MAX,
 56};
 57
 58/*
 59 * ETMv3 exception encoding number:
 60 * See Embedded Trace Macrocell spcification (ARM IHI 0014Q)
 61 * table 7-12 Encoding of Exception[3:0] for non-ARMv7-M processors.
 62 */
 63enum {
 64	CS_ETMV3_EXC_NONE = 0,
 65	CS_ETMV3_EXC_DEBUG_HALT = 1,
 66	CS_ETMV3_EXC_SMC = 2,
 67	CS_ETMV3_EXC_HYP = 3,
 68	CS_ETMV3_EXC_ASYNC_DATA_ABORT = 4,
 69	CS_ETMV3_EXC_JAZELLE_THUMBEE = 5,
 70	CS_ETMV3_EXC_PE_RESET = 8,
 71	CS_ETMV3_EXC_UNDEFINED_INSTR = 9,
 72	CS_ETMV3_EXC_SVC = 10,
 73	CS_ETMV3_EXC_PREFETCH_ABORT = 11,
 74	CS_ETMV3_EXC_DATA_FAULT = 12,
 75	CS_ETMV3_EXC_GENERIC = 13,
 76	CS_ETMV3_EXC_IRQ = 14,
 77	CS_ETMV3_EXC_FIQ = 15,
 78};
 79
 80/*
 81 * ETMv4 exception encoding number:
 82 * See ARM Embedded Trace Macrocell Architecture Specification (ARM IHI 0064D)
 83 * table 6-12 Possible values for the TYPE field in an Exception instruction
 84 * trace packet, for ARMv7-A/R and ARMv8-A/R PEs.
 85 */
 86enum {
 87	CS_ETMV4_EXC_RESET = 0,
 88	CS_ETMV4_EXC_DEBUG_HALT = 1,
 89	CS_ETMV4_EXC_CALL = 2,
 90	CS_ETMV4_EXC_TRAP = 3,
 91	CS_ETMV4_EXC_SYSTEM_ERROR = 4,
 92	CS_ETMV4_EXC_INST_DEBUG = 6,
 93	CS_ETMV4_EXC_DATA_DEBUG = 7,
 94	CS_ETMV4_EXC_ALIGNMENT = 10,
 95	CS_ETMV4_EXC_INST_FAULT = 11,
 96	CS_ETMV4_EXC_DATA_FAULT = 12,
 97	CS_ETMV4_EXC_IRQ = 14,
 98	CS_ETMV4_EXC_FIQ = 15,
 99	CS_ETMV4_EXC_END = 31,
100};
101
102enum cs_etm_sample_type {
103	CS_ETM_EMPTY,
104	CS_ETM_RANGE,
105	CS_ETM_DISCONTINUITY,
106	CS_ETM_EXCEPTION,
107	CS_ETM_EXCEPTION_RET,
108};
109
110enum cs_etm_isa {
111	CS_ETM_ISA_UNKNOWN,
112	CS_ETM_ISA_A64,
113	CS_ETM_ISA_A32,
114	CS_ETM_ISA_T32,
115};
116
117/* RB tree for quick conversion between traceID and metadata pointers */
118struct intlist *traceid_list;
119
120struct cs_etm_queue;
121
122struct cs_etm_packet {
123	enum cs_etm_sample_type sample_type;
124	enum cs_etm_isa isa;
125	u64 start_addr;
126	u64 end_addr;
127	u32 instr_count;
128	u32 last_instr_type;
129	u32 last_instr_subtype;
130	u32 flags;
131	u32 exception_number;
132	u8 last_instr_cond;
133	u8 last_instr_taken_branch;
134	u8 last_instr_size;
135	u8 trace_chan_id;
136	int cpu;
137};
138
139#define CS_ETM_PACKET_MAX_BUFFER 1024
140
141/*
142 * When working with per-thread scenarios the process under trace can
143 * be scheduled on any CPU and as such, more than one traceID may be
144 * associated with the same process.  Since a traceID of '0' is illegal
145 * as per the CoreSight architecture, use that specific value to
146 * identify the queue where all packets (with any traceID) are
147 * aggregated.
148 */
149#define CS_ETM_PER_THREAD_TRACEID 0
150
151struct cs_etm_packet_queue {
152	u32 packet_count;
153	u32 head;
154	u32 tail;
155	u32 instr_count;
156	u64 timestamp;
157	u64 next_timestamp;
158	struct cs_etm_packet packet_buffer[CS_ETM_PACKET_MAX_BUFFER];
159};
160
161#define KiB(x) ((x) * 1024)
162#define MiB(x) ((x) * 1024 * 1024)
163
164#define CS_ETM_INVAL_ADDR 0xdeadbeefdeadbeefUL
165
166#define BMVAL(val, lsb, msb)	((val & GENMASK(msb, lsb)) >> lsb)
167
168#define CS_ETM_HEADER_SIZE (CS_HEADER_VERSION_0_MAX * sizeof(u64))
169
170#define __perf_cs_etmv3_magic 0x3030303030303030ULL
171#define __perf_cs_etmv4_magic 0x4040404040404040ULL
172#define CS_ETMV3_PRIV_SIZE (CS_ETM_PRIV_MAX * sizeof(u64))
173#define CS_ETMV4_PRIV_SIZE (CS_ETMV4_PRIV_MAX * sizeof(u64))
174
175#ifdef HAVE_CSTRACE_SUPPORT
176int cs_etm__process_auxtrace_info(union perf_event *event,
177				  struct perf_session *session);
178int cs_etm__get_cpu(u8 trace_chan_id, int *cpu);
179int cs_etm__etmq_set_tid(struct cs_etm_queue *etmq,
180			 pid_t tid, u8 trace_chan_id);
181bool cs_etm__etmq_is_timeless(struct cs_etm_queue *etmq);
182void cs_etm__etmq_set_traceid_queue_timestamp(struct cs_etm_queue *etmq,
183					      u8 trace_chan_id);
184struct cs_etm_packet_queue
185*cs_etm__etmq_get_packet_queue(struct cs_etm_queue *etmq, u8 trace_chan_id);
186#else
187static inline int
188cs_etm__process_auxtrace_info(union perf_event *event __maybe_unused,
189			      struct perf_session *session __maybe_unused)
190{
191	return -1;
192}
193
194static inline int cs_etm__get_cpu(u8 trace_chan_id __maybe_unused,
195				  int *cpu __maybe_unused)
196{
197	return -1;
198}
199
200static inline int cs_etm__etmq_set_tid(
201				struct cs_etm_queue *etmq __maybe_unused,
202				pid_t tid __maybe_unused,
203				u8 trace_chan_id __maybe_unused)
204{
205	return -1;
206}
207
208static inline bool cs_etm__etmq_is_timeless(
209				struct cs_etm_queue *etmq __maybe_unused)
210{
211	/* What else to return? */
212	return true;
213}
214
215static inline void cs_etm__etmq_set_traceid_queue_timestamp(
216				struct cs_etm_queue *etmq __maybe_unused,
217				u8 trace_chan_id __maybe_unused) {}
218
219static inline struct cs_etm_packet_queue *cs_etm__etmq_get_packet_queue(
220				struct cs_etm_queue *etmq __maybe_unused,
221				u8 trace_chan_id __maybe_unused)
222{
223	return NULL;
224}
225#endif
226
227#endif