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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
/**
* Copyright (C) 2010-2012 ARM Limited. All rights reserved.
*
* This program is free software and is provided to you under the terms of the
* GNU General Public License version 2 as published by the Free Software
* Foundation, and any use by you of this program is subject to the terms of
* such GNU licence.
*
* A copy of the licence is included with the program, and can also be obtained
* from Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __MALI_OSK_PROFILING_H__
#define __MALI_OSK_PROFILING_H__
#if MALI_TIMELINE_PROFILING_ENABLED
#if defined (CONFIG_TRACEPOINTS) && !MALI_INTERNAL_TIMELINE_PROFILING_ENABLED
#include "mali_linux_trace.h"
#endif /* CONFIG_TRACEPOINTS && !MALI_INTERNAL_TIMELINE_PROFILING_ENABLED */
#include "mali_cinstr_profiling_events_m200.h"
#define MALI_PROFILING_MAX_BUFFER_ENTRIES 1048576
#define MALI_PROFILING_PP_CORE_COUNTER0_OFFSET(core_number) (((core_number) * 2) + COUNTER_FP0_C0)
#define MALI_PROFILING_PP_CORE_COUNTER1_OFFSET(core_number) (((core_number) * 2) + COUNTER_FP0_C1)
/** @defgroup _mali_osk_profiling External profiling connectivity
* @{ */
/**
* Initialize the profiling module.
* @return _MALI_OSK_ERR_OK on success, otherwise failure.
*/
_mali_osk_errcode_t _mali_osk_profiling_init(mali_bool auto_start);
/*
* Terminate the profiling module.
*/
void _mali_osk_profiling_term(void);
/**
* Start recording profiling data
*
* The specified limit will determine how large the capture buffer is.
* MALI_PROFILING_MAX_BUFFER_ENTRIES determines the maximum size allowed by the device driver.
*
* @param limit The desired maximum number of events to record on input, the actual maximum on output.
* @return _MALI_OSK_ERR_OK on success, otherwise failure.
*/
_mali_osk_errcode_t _mali_osk_profiling_start(u32 * limit);
/**
* Add an profiling event
*
* @param event_id The event identificator.
* @param data0 First data parameter, depending on event_id specified.
* @param data1 Second data parameter, depending on event_id specified.
* @param data2 Third data parameter, depending on event_id specified.
* @param data3 Fourth data parameter, depending on event_id specified.
* @param data4 Fifth data parameter, depending on event_id specified.
* @return _MALI_OSK_ERR_OK on success, otherwise failure.
*/
#if defined (CONFIG_TRACEPOINTS) && !MALI_INTERNAL_TIMELINE_PROFILING_ENABLED
/*
* On platforms where we are using Linux tracepoints and we aren't forcing
* internal profiling we can call through to the tracepoint directly and
* avoid the overhead of the function call.
*/
#define _mali_osk_profiling_add_event(event_id, data0, data1, data2, data3, data4) \
trace_mali_timeline_event((event_id), (data0), (data1), (u32)_mali_osk_get_task(), (data3), (data4))
#else
void _mali_osk_profiling_add_event(u32 event_id, u32 data0, u32 data1, u32 data2, u32 data3, u32 data4);
#endif /* CONFIG_TRACEPOINTS && !MALI_INTERNAL_TIMELINE_PROFILING_ENABLED */
/**
* Report a hardware counter event.
*
* @param counter_id The ID of the counter.
* @param value The value of the counter.
*/
#if defined (CONFIG_TRACEPOINTS) && !MALI_INTERNAL_TIMELINE_PROFILING_ENABLED
/*
* On platforms where we are using Linux tracepoints and we aren't forcing
* internal profiling we can call through to the tracepoint directly and
* avoid the overhead of the function call.
*/
#define _mali_osk_profiling_report_hw_counter trace_mali_hw_counter
#else
void _mali_osk_profiling_report_hw_counter(u32 counter_id, u32 value);
#endif /* CONFIG_TRACEPOINTS && !MALI_INTERNAL_TIMELINE_PROFILING_ENABLED */
/**
* Query a hardware counter. Given a counter ID, check which event the
* counter should report and update the given pointer with that event
* number before returning MALI_TRUE. If the counter has been disabled
* by the profiling tool, returns MALI_FALSE and does not update the
* pointer.
*
* MALI_FALSE is also returned if the counter is not a valid hardware
* counter ID. In this case the event value is not updated.
*
* @param counter_id The counter ID.
* @param event_id A pointer to a u32 value that will be updated with
* the event ID that should be counted, should the counter have been
* enabled by the profiling tool.
*
* @return MALI_TRUE if the counter should be enabled, MALI_FALSE otherwise.
*/
mali_bool _mali_osk_profiling_query_hw_counter(u32 counter_id, u32 *event_id);
/**
* Stop recording profiling data
*
* @param count Returns the number of recorded events.
* @return _MALI_OSK_ERR_OK on success, otherwise failure.
*/
_mali_osk_errcode_t _mali_osk_profiling_stop(u32 * count);
/**
* Retrieves the number of events that can be retrieved
*
* @return The number of recorded events that can be retrieved.
*/
u32 _mali_osk_profiling_get_count(void);
/**
* Retrieve an event
*
* @param index Event index (start with 0 and continue until this function fails to retrieve all events)
* @param timestamp The timestamp for the retrieved event will be stored here.
* @param event_id The event ID for the retrieved event will be stored here.
* @param data The 5 data values for the retrieved event will be stored here.
* @return _MALI_OSK_ERR_OK on success, otherwise failure.
*/
_mali_osk_errcode_t _mali_osk_profiling_get_event(u32 index, u64* timestamp, u32* event_id, u32 data[5]);
/**
* Clear the recorded buffer.
*
* This is needed in order to start another recording.
*
* @return _MALI_OSK_ERR_OK on success, otherwise failure.
*/
_mali_osk_errcode_t _mali_osk_profiling_clear(void);
/**
* Checks if a recording of profiling data is in progress
*
* @return MALI_TRUE if recording of profiling data is in progress, MALI_FALSE if not
*/
mali_bool _mali_osk_profiling_is_recording(void);
/**
* Checks if profiling data is available for retrival
*
* @return MALI_TRUE if profiling data is avaiable, MALI_FALSE if not
*/
mali_bool _mali_osk_profiling_have_recording(void);
/**
* Enable or disable profiling events as default for new sessions (applications)
*
* @param enable MALI_TRUE if profiling events should be turned on, otherwise MALI_FALSE
*/
void _mali_osk_profiling_set_default_enable_state(mali_bool enable);
/**
* Get current default enable state for new sessions (applications)
*
* @return MALI_TRUE if profiling events should be turned on, otherwise MALI_FALSE
*/
mali_bool _mali_osk_profiling_get_default_enable_state(void);
/** @} */ /* end group _mali_osk_profiling */
#endif /* MALI_TIMELINE_PROFILING_ENABLED */
#endif /* __MALI_OSK_PROFILING_H__ */
|
