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
|
/*
*
* (C) COPYRIGHT 2015-2016 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 _KBASE_VINSTR_H_
#define _KBASE_VINSTR_H_
#include <mali_kbase.h>
#include <mali_kbase_hwcnt_reader.h>
/*****************************************************************************/
struct kbase_vinstr_context;
struct kbase_vinstr_client;
/*****************************************************************************/
/**
* kbase_vinstr_init() - initialize the vinstr core
* @kbdev: kbase device
*
* Return: pointer to the vinstr context on success or NULL on failure
*/
struct kbase_vinstr_context *kbase_vinstr_init(struct kbase_device *kbdev);
/**
* kbase_vinstr_term() - terminate the vinstr core
* @vinstr_ctx: vinstr context
*/
void kbase_vinstr_term(struct kbase_vinstr_context *vinstr_ctx);
/**
* kbase_vinstr_hwcnt_reader_setup - configure hw counters reader
* @vinstr_ctx: vinstr context
* @setup: reader's configuration
*
* Return: zero on success
*/
int kbase_vinstr_hwcnt_reader_setup(
struct kbase_vinstr_context *vinstr_ctx,
struct kbase_uk_hwcnt_reader_setup *setup);
/**
* kbase_vinstr_legacy_hwc_setup - configure hw counters for dumping
* @vinstr_ctx: vinstr context
* @cli: pointer where to store pointer to new vinstr client structure
* @setup: hwc configuration
*
* Return: zero on success
*/
int kbase_vinstr_legacy_hwc_setup(
struct kbase_vinstr_context *vinstr_ctx,
struct kbase_vinstr_client **cli,
struct kbase_uk_hwcnt_setup *setup);
/**
* kbase_vinstr_hwcnt_kernel_setup - configure hw counters for kernel side
* client
* @vinstr_ctx: vinstr context
* @setup: reader's configuration
* @kernel_buffer: pointer to dump buffer
*
* setup->buffer_count and setup->fd are not used for kernel side clients.
*
* Return: pointer to client structure, or NULL on failure
*/
struct kbase_vinstr_client *kbase_vinstr_hwcnt_kernel_setup(
struct kbase_vinstr_context *vinstr_ctx,
struct kbase_uk_hwcnt_reader_setup *setup,
void *kernel_buffer);
/**
* kbase_vinstr_hwc_dump - issue counter dump for vinstr client
* @cli: pointer to vinstr client
* @event_id: id of event that triggered hwcnt dump
*
* Return: zero on success
*/
int kbase_vinstr_hwc_dump(
struct kbase_vinstr_client *cli,
enum base_hwcnt_reader_event event_id);
/**
* kbase_vinstr_hwc_clear - performs a reset of the hardware counters for
* a given kbase context
* @cli: pointer to vinstr client
*
* Return: zero on success
*/
int kbase_vinstr_hwc_clear(struct kbase_vinstr_client *cli);
/**
* kbase_vinstr_try_suspend - try suspending operation of a given vinstr context
* @vinstr_ctx: vinstr context
*
* Return: 0 on success, or negative if state change is in progress
*
* Warning: This API call is non-generic. It is meant to be used only by
* job scheduler state machine.
*
* Function initiates vinstr switch to suspended state. Once it was called
* vinstr enters suspending state. If function return non-zero value, it
* indicates that state switch is not complete and function must be called
* again. On state switch vinstr will trigger job scheduler state machine
* cycle.
*/
int kbase_vinstr_try_suspend(struct kbase_vinstr_context *vinstr_ctx);
/**
* kbase_vinstr_suspend - suspends operation of a given vinstr context
* @vinstr_ctx: vinstr context
*
* Function initiates vinstr switch to suspended state. Then it blocks until
* operation is completed.
*/
void kbase_vinstr_suspend(struct kbase_vinstr_context *vinstr_ctx);
/**
* kbase_vinstr_resume - resumes operation of a given vinstr context
* @vinstr_ctx: vinstr context
*
* Function can be called only if it was preceded by a successful call
* to kbase_vinstr_suspend.
*/
void kbase_vinstr_resume(struct kbase_vinstr_context *vinstr_ctx);
/**
* kbase_vinstr_dump_size - Return required size of dump buffer
* @kbdev: device pointer
*
* Return : buffer size in bytes
*/
size_t kbase_vinstr_dump_size(struct kbase_device *kbdev);
/**
* kbase_vinstr_detach_client - Detach a client from the vinstr core
* @cli: pointer to vinstr client
*/
void kbase_vinstr_detach_client(struct kbase_vinstr_client *cli);
#endif /* _KBASE_VINSTR_H_ */
|
