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
|
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
/*
*
* (C) COPYRIGHT 2011-2015, 2017, 2019-2022 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 license.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, you can access it online at
* http://www.gnu.org/licenses/gpl-2.0.html.
*
*/
/**
* DOC: Base kernel property query APIs
*/
#ifndef _KBASE_GPUPROPS_H_
#define _KBASE_GPUPROPS_H_
#include "mali_kbase_gpuprops_types.h"
/* Forward definition - see mali_kbase.h */
struct kbase_device;
/**
* KBASE_UBFX32 - Extracts bits from a 32-bit bitfield.
* @value: The value from which to extract bits.
* @offset: The first bit to extract (0 being the LSB).
* @size: The number of bits to extract.
*
* Context: @offset + @size <= 32.
*
* Return: Bits [@offset, @offset + @size) from @value.
*/
/* from mali_cdsb.h */
#define KBASE_UBFX32(value, offset, size) \
(((u32)(value) >> (u32)(offset)) & (u32)((1ULL << (u32)(size)) - 1))
/**
* kbase_gpuprops_set - Set up Kbase GPU properties.
* @kbdev: The struct kbase_device structure for the device
*
* Set up Kbase GPU properties with information from the GPU registers
*/
void kbase_gpuprops_set(struct kbase_device *kbdev);
/**
* kbase_gpuprops_set_features - Set up Kbase GPU properties
* @kbdev: Device pointer
*
* This function sets up GPU properties that are dependent on the hardware
* features bitmask. This function must be preceeded by a call to
* kbase_hw_set_features_mask().
*
* Return: Zero on success, Linux error code on failure
*/
int kbase_gpuprops_set_features(struct kbase_device *kbdev);
/**
* kbase_gpuprops_update_l2_features - Update GPU property of L2_FEATURES
* @kbdev: Device pointer
*
* This function updates l2_features and the log2 cache size.
* The function expects GPU to be powered up and value of pm.active_count
* to be 1.
*
* Return: Zero on success, Linux error code for failure
*/
int kbase_gpuprops_update_l2_features(struct kbase_device *kbdev);
/**
* kbase_gpuprops_populate_user_buffer - Populate the GPU properties buffer
* @kbdev: The kbase device
*
* Fills prop_buffer with the GPU properties for user space to read.
*
* Return: MALI_ERROR_NONE on success. Any other value indicates failure.
*/
int kbase_gpuprops_populate_user_buffer(struct kbase_device *kbdev);
/**
* kbase_gpuprops_free_user_buffer - Free the GPU properties buffer.
* @kbdev: kbase device pointer
*
* Free the GPU properties buffer allocated from
* kbase_gpuprops_populate_user_buffer.
*/
void kbase_gpuprops_free_user_buffer(struct kbase_device *kbdev);
/**
* kbase_device_populate_max_freq - Populate max gpu frequency.
* @kbdev: kbase device pointer
*
* Populate the maximum gpu frequency to be used when devfreq is disabled.
*
* Return: 0 on success and non-zero value on failure.
*/
int kbase_device_populate_max_freq(struct kbase_device *kbdev);
/**
* kbase_gpuprops_update_core_props_gpu_id - break down gpu id value
* @gpu_props: the &base_gpu_props structure
*
* Break down gpu_id value stored in base_gpu_props::raw_props.gpu_id into
* separate fields (version_status, minor_revision, major_revision, product_id)
* stored in base_gpu_props::core_props.
*/
void kbase_gpuprops_update_core_props_gpu_id(
struct base_gpu_props * const gpu_props);
/**
* kbase_gpuprops_set_max_config - Set the max config information
* @kbdev: Device pointer
* @max_config: Maximum configuration data to be updated
*
* This function sets max_config in the kbase_gpu_props.
*/
void kbase_gpuprops_set_max_config(struct kbase_device *kbdev,
const struct max_config_props *max_config);
/**
* kbase_gpuprops_get_curr_config_props - Get the current allocated resources
* @kbdev: The &struct kbase_device structure for the device
* @curr_config: The &struct curr_config_props structure to receive the result
*
* Fill the &struct curr_config_props structure with values from the GPU
* configuration registers.
*
* Return: Zero on success, Linux error code on failure
*/
int kbase_gpuprops_get_curr_config_props(struct kbase_device *kbdev,
struct curr_config_props * const curr_config);
/**
* kbase_gpuprops_req_curr_config_update - Request Current Config Update
* @kbdev: The &struct kbase_device structure for the device
*
* Requests the current configuration to be updated next time the
* kbase_gpuprops_get_curr_config_props() is called.
*
* Return: Zero on success, Linux error code on failure
*/
int kbase_gpuprops_req_curr_config_update(struct kbase_device *kbdev);
#endif /* _KBASE_GPUPROPS_H_ */
|
