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
|
/*
* Copyright (c) 2011-2015, The Linux Foundation. All rights reserved.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 and
* only version 2 as published by the Free Software Foundation.
*
* 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.
*/
/*
* Qualcomm TSENS Header file
*
*/
#ifndef __MSM_TSENS_H
#define __MSM_TSENS_H
#define TSENS_MAX_SENSORS 11
#define TSENS_MTC_ZONE_LOG_SIZE 6
#define TSENS_NUM_MTC_ZONES_SUPPORT 3
#define TSENS_ZONEMASK_PARAMS 3
#define TSENS_ZONELOG_PARAMS 1
#define TSENS_MTC_ZONE_HISTORY_SIZE 3
struct tsens_device {
uint32_t sensor_num;
};
#if defined(CONFIG_THERMAL_TSENS8974)
/**
* tsens_is_ready() - Clients can use this API to check if the TSENS device
* is ready and clients can start requesting temperature reads.
* @return: Returns true if device is ready else returns -EPROBE_DEFER
* for clients to check back after a time duration.
*/
int tsens_is_ready(void);
/**
* tsens_tm_init_driver() - Early initialization for clients to read
* TSENS temperature.
*/
int __init tsens_tm_init_driver(void);
/**
* tsens_get_hw_id_mapping() - Mapping software or sensor ID with the physical
* TSENS sensor. On certain cases where there are more number of
* controllers the sensor ID is used to map the clients software ID
* with the physical HW sensors used by the driver.
* @sensors_sw_id: Client ID.
* @sensor_hw_num: Sensor client ID passed by the driver. This ID is used
* by the driver to map it to the physical HW sensor
* number.
* @return: If the device is not present returns -EPROBE_DEFER
* for clients to check back after a time duration.
* 0 on success else error code on error.
*/
int tsens_get_hw_id_mapping(int sensor_sw_id, int *sensor_hw_num);
/**
* tsens_get_max_sensor_num() - Get the total number of active TSENS sensors.
* The total number received by the client is across multiple
* TSENS controllers if present.
* @tsens_num_sensors: Total number of sensor result to be stored.
*/
int tsens_get_max_sensor_num(uint32_t *tsens_num_sensors);
/**
* tsens_set_mtc_zone_sw_mask() - Mask the MTC threshold level of a zone.
* SW can force the MTC to stop issuing throttling commands that
* correspond to each MTC threshold level by writing the
* corresponding bit in register at any time.
* @zone: Zone ID.
* @th1_enable : Value corresponding to the threshold level.
* @th2_enable : Value corresponding to the threshold level.
*/
int tsens_set_mtc_zone_sw_mask(unsigned int zone , unsigned int th1_enable,
unsigned int th2_enable);
/**
* tsens_get_mtc_zone_log() - Get the log of last 6 commands sent to pulse
* swallower of a zone.
* zone: Zone ID
* @zone_log: Log commands result to be stored.
*/
int tsens_get_mtc_zone_log(unsigned int zone , void *zone_log);
/**
* tsens_mtc_reset_history_counter() - Reset history of throttling commands
* sent to pulse swallower. Tsens controller issues clock
* throttling commands to Pulse swallower to perform HW
* based clock throttling. Reset the history counter of a zone.
* @zone: Zone ID.
*/
int tsens_mtc_reset_history_counter(unsigned int zone);
/**
* tsens_get_mtc_zone_history() - Get the history of throttling commands sent
* to pulse swallower. Tsens controller issues clock throttling
* commands to Pulse swallower to perform HW based clock
* throttling.
* @zone: Zone ID
* @zone_hist: Commands history result to be stored.
*/
int tsens_get_mtc_zone_history(unsigned int zone , void *zone_hist);
/**
* tsens_get_temp() - Obtain the TSENS temperature for the respective sensor.
*
* @dev: Sensor number for which client wants the TSENS temperature
* reading. The ID passed by the sensor could be the sensor ID
* which the driver translates to internally to read the
* respective physical HW sensor from the controller.
* @temp: temperature result to be stored.
* @return: If the device is not present returns -EPROBE_DEFER
* for clients to check back after a time duration.
* 0 on success else error code on error.
*/
int tsens_get_temp(struct tsens_device *dev, int *temp);
#else
static inline int tsens_is_ready(void)
{ return -ENXIO; }
static inline int __init tsens_tm_init_driver(void)
{ return -ENXIO; }
static inline int tsens_get_hw_id_mapping(
int sensor_sw_id, int *sensor_hw_num)
{ return -ENXIO; }
static inline int tsens_get_max_sensor_num(uint32_t *tsens_num_sensors)
{ return -ENXIO; }
static inline int tsens_set_mtc_zone_sw_mask(unsigned int zone ,
unsigned int th1_enable ,
unsigned int th2_enable)
{ return -ENXIO; }
static inline int tsens_get_mtc_zone_log(unsigned int zone , void *zone_log)
{ return -ENXIO; }
static inline int tsens_mtc_reset_history_counter(unsigned int zone)
{ return -ENXIO; }
static inline int tsens_get_temp(struct tsens_device *dev,
int *temp)
{ return -ENXIO; }
static inline int tsens_get_mtc_zone_history(unsigned int zone, void *zone_hist)
{ return -ENXIO; }
#endif
#endif /*MSM_TSENS_H */
|
