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
184
185
186
|
/*
* Copyright 2004-2009 Freescale Semiconductor, Inc. All Rights Reserved.
*/
/*
* The code contained herein is licensed under the GNU General Public
* License. You may obtain a copy of the GNU General Public License
* Version 2 or later at the following locations:
*
* http://www.opensource.org/licenses/gpl-license.html
* http://www.gnu.org/copyleft/gpl.html
*/
#ifndef __ASM_ARCH_MXC_DPTC_H__
#define __ASM_ARCH_MXC_DPTC_H__
#include <mach/dvfs_dptc_struct.h>
/*!
* DPTC proc file system entry name
*/
#define PROC_NODE_NAME "dptc"
int __init init_dptc_controller(dvfs_dptc_params_s * params);
/*!
* This function enables the DPTC module. this function updates the DPTC
* thresholds, updates the PMIC, unmasks the DPTC interrupt and enables
* the DPTC module
*
* @param params pointer to the DVFS & DPTC driver parameters structure.
*
* @return 0 if DPTC module was enabled else returns -EINVAL.
*/
int start_dptc(dvfs_dptc_params_s * params);
/*!
* This function disables the DPTC module.
*
* @param params pointer to the DVFS & DPTC driver parameters structure.
*
* @return 0 if DPTC module was disabled else returns -EINVAL.
*/
int stop_dptc(dvfs_dptc_params_s * params);
/*!
* This function updates the drivers current working point index. This index is
* used for access the current DTPC table entry and it corresponds to the
* current CPU working point measured by the DPTC hardware.
*
* @param params pointer to the DVFS & DPTC driver parameters structure.
* @param new_wp New working point index value to be set.
*
*/
void set_dptc_wp(dvfs_dptc_params_s * params, int new_wp);
/*!
* This function updates the DPTC threshold registers.
*
* @param dvfs_dptc_tables_ptr pointer to the DPTC translation table.
* @param wp current wp value.
* @param freq_index translation table index of the current CPU
* frequency.
*
*/
void update_dptc_thresholds(dvfs_dptc_tables_s * dptc_tables_ptr,
int wp, int freq_index);
/*!
* This function adds a new entry to the DPTC log buffer.
*
* @param params pointer to the DVFS & DPTC driver parameters structure.
* @param dptc_log pointer to the DPTC log buffer structure.
* @param wp value of the working point index written
* to the log buffer.
* @param freq_index value of the frequency index written to
* the log buffer.
*
* @return number of log buffer entries.
*
*/
void add_dptc_log_entry(dvfs_dptc_params_s * params,
dptc_log_s * dptc_log, int wp, int freq_index);
/*!
* This function updates the CPU voltage, produced by PMIC, by calling PMIC
* driver functions.
*
* @param dptc_tables_ptr pointer to the DPTC translation table.
* @param wp current wp value.
*/
void set_pmic_voltage(dvfs_dptc_tables_s * dptc_tables_ptr, int wp);
/*!
* This function enables the DPTC reference circuits.
*
* @param params pointer to the DVFS & DPTC driver parameters structure.
* @param rc_state each high bit specifies which
* reference circuite to enable.
* @return 0 on success, error code on failure
*/
int enable_ref_circuits(dvfs_dptc_params_s * params, unsigned char rc_state);
/*!
* This function disables the DPTC reference circuits.
*
* @param params pointer to the DVFS & DPTC driver parameters structure.
* @param rc_state each high bit specifies which
* reference circuite to disable
* @return 0 on success, error code on failure
*/
int disable_ref_circuits(dvfs_dptc_params_s * params, unsigned char rc_state);
/*!
* This function is the DPTC Interrupt handler.
* This function wakes-up the dptc_workqueue_handler function that handles the
* DPTC interrupt.
*/
void dptc_irq(void);
/*!
* This function updates the drivers current frequency index.This index is
* used for access the current DTPC table entry and it corresponds to the
* current CPU frequency (each CPU frequency has a separate index number
* according to the loaded DPTC table).
*
* @param params pointer to the DVFS & DPTC driver parameters structure.
* @param freq_index New frequency index value to be set.
*
* @return 0 if the frequency index was updated (the new index is a
* valid index and the DPTC module isn't active) else returns
* -EINVAL.
*
*/
int set_dptc_curr_freq(dvfs_dptc_params_s * params, unsigned int freq_index);
#ifdef CONFIG_MXC_DVFS_SDMA
/*
* DPTC SDMA callback.
* Updates the PMIC voltage
*
* @param params pointer to the DVFS & DPTC driver parameters structure.
*/
void dptc_sdma_callback(dvfs_dptc_params_s * params);
#endif
/*!
* This function is called to put the DPTC in a low power state.
*
* @param pdev the device structure used to give information on which
* device to suspend (not relevant for DPTC)
* @param state the power state the device is entering
*
* @return The function always returns 0.
*/
int mxc_dptc_suspend(struct platform_device *pdev, pm_message_t state);
/*!
* This function is called to put the DPTC in a low power state.
*
*/
void dptc_suspend(void);
/*!
* This function is called to resume the DPTC from a low power state.
*
* @param pdev the device structure used to give information on which
* device to suspend (not relevant for DPTC)
*
* @return The function always returns 0.
*/
int mxc_dptc_resume(struct platform_device *dev);
/*!
* This function is called to resume the DPTC from a low power state.
*
*/
void dptc_resume(void);
/*!
* This function initializes DPTC according to turbo mode status
*
* @param status Turbo mode disable, 1 - turbo mode enabled
*
*/
void dptc_set_turbo_mode(unsigned int status);
#endif /* __ASM_ARCH_MXC_DPTC_H__ */
|
