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
|
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
/*
*
* (C) COPYRIGHT 2020-2023 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.
*
*/
#ifndef _KBASE_CSF_FIRMWARE_CFG_H_
#define _KBASE_CSF_FIRMWARE_CFG_H_
#include <mali_kbase.h>
#include "mali_kbase_csf_firmware.h"
#include <linux/firmware.h>
#define CONFIGURATION_ENTRY_NAME_OFFSET (0xC)
/**
* kbase_csf_firmware_cfg_init - Create the sysfs directory for configuration
* options present in firmware image.
*
* @kbdev: Pointer to the Kbase device
*
* This function would create a sysfs directory and populate it with a
* sub-directory, that would contain a file per attribute, for every
* configuration option parsed from firmware image.
*
* Return: The initialization error code.
*/
int kbase_csf_firmware_cfg_init(struct kbase_device *kbdev);
/**
* kbase_csf_firmware_cfg_term - Delete the sysfs directory that was created
* for firmware configuration options.
*
* @kbdev: Pointer to the Kbase device
*
*/
void kbase_csf_firmware_cfg_term(struct kbase_device *kbdev);
/**
* kbase_csf_firmware_cfg_option_entry_parse() - Process a
* "configuration option" section.
*
* @kbdev: Kbase device structure
* @fw: Firmware image containing the section
* @entry: Pointer to the section
* @size: Size (in bytes) of the section
* @updatable: Indicates if entry can be updated with FIRMWARE_CONFIG_UPDATE
*
* Read a "configuration option" section adding it to the
* kbase_device:csf.firmware_config list.
*
* Return: 0 if successful, negative error code on failure
*/
int kbase_csf_firmware_cfg_option_entry_parse(struct kbase_device *kbdev,
const struct kbase_csf_mcu_fw *const fw,
const u32 *entry, unsigned int size, bool updatable);
#ifdef CONFIG_MALI_HOST_CONTROLS_SC_RAILS
/**
* kbase_csf_firmware_cfg_enable_host_ctrl_sc_rails() - Enable the config in FW to support
* Host based control of SC power rails
*
* Look for the config entry that enables support in FW for the Host based
* control of shader core power rails and set it before the intial boot
* or reload of firmware.
*
* @kbdev: Kbase device structure
*
* Return: 0 if successful, negative error code on failure
*/
int kbase_csf_firmware_cfg_enable_host_ctrl_sc_rails(struct kbase_device *kbdev);
#endif
/**
* kbase_csf_firmware_cfg_find_config_address() - Get a FW config option address
*
* @kbdev: Kbase device structure
* @name: Name of cfg option to find
* @addr: Pointer to store the address
*
* Return: 0 if successful, negative error code on failure
*/
int kbase_csf_firmware_cfg_find_config_address(struct kbase_device *kbdev, const char *name,
u32 *addr);
/**
* kbase_csf_firmware_cfg_fw_wa_enable() - Enable firmware workarounds configuration.
*
* @kbdev: Kbase device structure
*
* Look for the config entry that enables support in FW for workarounds and set it according to
* the firmware workaround configuration before the initial boot or reload of firmware.
*
* Return: 0 if successful, negative error code on failure
*/
int kbase_csf_firmware_cfg_fw_wa_enable(struct kbase_device *kbdev);
/**
* kbase_csf_firmware_cfg_fw_wa_init() - Initialize firmware workarounds configuration.
*
* @kbdev: Kbase device structure
*
* Retrieve and save the firmware workarounds configuration from device-tree "quirks_ext" property.
* Then, look for the config entry that enables support in FW for workarounds and set it according
* to the configuration before the initial firmware boot.
*
* Return: 0 if successful, negative error code on failure
*/
int kbase_csf_firmware_cfg_fw_wa_init(struct kbase_device *kbdev);
/**
* kbase_csf_firmware_cfg_fw_wa_term - Delete local cache for firmware workarounds configuration.
*
* @kbdev: Pointer to the Kbase device
*
*/
void kbase_csf_firmware_cfg_fw_wa_term(struct kbase_device *kbdev);
#endif /* _KBASE_CSF_FIRMWARE_CFG_H_ */
|
