src/lib/psensor.h

   1 /*
   2  * Copyright (C) 2010-2016 jeanfi@gmail.com
   3  *
   4  * This program is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU General Public License as
   6  * published by the Free Software Foundation; either version 2 of the
   7  * License, or (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful, but
  10  * WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  17  * 02110-1301 USA
  18  */
  19 #ifndef _PSENSOR_PSENSOR_H_
  20 #define _PSENSOR_PSENSOR_H_
  21
  22 #include <config.h>
  23
  24 #include <bool.h>
  25 #include <measure.h>
  26 #include <plog.h>
  27
  28 enum psensor_type {
  29         /* type of sensor values */
  30         SENSOR_TYPE_TEMP = 0x00001,
  31         SENSOR_TYPE_RPM = 0x00002,
  32         SENSOR_TYPE_PERCENT = 0x00004,
  33
  34         /* Whether the sensor is remote */
  35         SENSOR_TYPE_REMOTE = 0x00008,
  36
  37         /* Libraries used for retrieving sensor information */
  38         SENSOR_TYPE_LMSENSOR = 0x00100,
  39         SENSOR_TYPE_NVCTRL = 0x00200,
  40         SENSOR_TYPE_GTOP = 0x00400,
  41         SENSOR_TYPE_ATIADL = 0x00800,
  42         SENSOR_TYPE_ATASMART = 0x01000,
  43         SENSOR_TYPE_HDDTEMP = 0x02000,
  44         SENSOR_TYPE_UDISKS2 = 0x800000,
  45         SENSOR_TYPE_BCM2835 = 0x1000000,
  46
  47         /* Type of HW component */
  48         SENSOR_TYPE_HDD = 0x04000,
  49         SENSOR_TYPE_CPU = 0x08000,
  50         SENSOR_TYPE_GPU = 0x10000,
  51         SENSOR_TYPE_FAN = 0x20000,
  52
  53         SENSOR_TYPE_GRAPHICS = 0x40000,
  54         SENSOR_TYPE_VIDEO = 0x80000,
  55         SENSOR_TYPE_PCIE = 0x100000,
  56         SENSOR_TYPE_MEMORY = 0x200000,
  57         SENSOR_TYPE_AMBIENT = 0x400000,
  58
  59         /* Combinations */
  60         SENSOR_TYPE_HDD_TEMP = (SENSOR_TYPE_HDD | SENSOR_TYPE_TEMP),
  61         SENSOR_TYPE_CPU_USAGE = (SENSOR_TYPE_CPU | SENSOR_TYPE_PERCENT)
  62 };
  63
  64 struct psensor {
  65         /* Human readable name of the sensor.  It may not be uniq. */
  66         char *name;
  67
  68         /* Uniq id of the sensor */
  69         char *id;
  70
  71         /* Name of the chip. */
  72         char *chip;
  73
  74         /* Maximum length of 'values' */
  75         int values_max_length;
  76
  77         /*
  78          * Last registered measures of the sensor.  Index 0 for the
  79          * oldest measure.
  80          */
  81         struct measure *measures;
  82
  83         /* see psensor_type */
  84         unsigned int type;
  85
  86         double max;
  87
  88         double min;
  89
  90         /* The highest value detected during this session. */
  91         double sess_highest;
  92
  93         /* The lowest value detected during this session. */
  94         double sess_lowest;
  95
  96         double alarm_high_threshold;
  97         double alarm_low_threshold;
  98
  99         /* Whether an alarm is raised for this sensor */
 100         bool alarm_raised;
 101
 102         void (*cb_alarm_raised)(struct psensor *, void *);
 103         void *cb_alarm_raised_data;
 104
 105 #ifdef HAVE_LIBATIADL
 106         /* AMD id for the aticonfig */
 107         int amd_id;
 108 #endif
 109
 110         void *provider_data;
 111         void (*provider_data_free_fct)(void *);
 112 };
 113
 114 struct psensor *psensor_create(char *id,
 115                                char *name,
 116                                char *chip,
 117                                unsigned int type,
 118                                int values_max_length);
 119
 120 void psensor_values_resize(struct psensor *s, int new_size);
 121
 122 void psensor_free(struct psensor *sensor);
 123
 124 void psensor_list_free(struct psensor **sensors);
 125 int psensor_list_size(struct psensor **sensors);
 126
 127 struct psensor *psensor_list_get_by_id(struct psensor **sensors,
 128                                        const char *id);
 129
 130 int is_temp_type(unsigned int type);
 131
 132 double get_min_temp(struct psensor **sensors);
 133 double get_max_temp(struct psensor **sensors);
 134
 135 double get_min_rpm(struct psensor **sensors);
 136 double get_max_rpm(struct psensor **sensors);
 137
 138 /*
 139  * Converts the value of a sensor to a string.
 140  *
 141  * parameter 'type' is SENSOR_TYPE_LMSENSOR_TEMP, SENSOR_TYPE_NVIDIA,
 142  * or SENSOR_TYPE_LMSENSOR_FAN
 143  */
 144 char *psensor_value_to_str(unsigned int type,
 145                            double value,
 146                            int use_celsius);
 147
 148 char *psensor_measure_to_str(const struct measure *m,
 149                              unsigned int type,
 150                              unsigned int use_celsius);
 151
 152 struct psensor **psensor_list_add(struct psensor **sensors,
 153                                   struct psensor *sensor);
 154
 155 void psensor_list_append(struct psensor ***sensors, struct psensor *sensor);
 156
 157 struct psensor **psensor_list_copy(struct psensor **);
 158
 159 void psensor_set_current_value(struct psensor *sensor, double value);
 160 void psensor_set_current_measure(struct psensor *sensor, double value,
 161                                  struct timeval tv);
 162
 163 double psensor_get_current_value(const struct psensor *);
 164
 165 struct measure *psensor_get_current_measure(struct psensor *sensor);
 166
 167 /* Returns a string representation of a psensor type. */
 168 const char *psensor_type_to_str(unsigned int type);
 169
 170 const char *psensor_type_to_unit_str(unsigned int type, int use_celsius);
 171
 172 double get_max_value(struct psensor **sensors, int type);
 173
 174 char *psensor_current_value_to_str(const struct psensor *, unsigned int);
 175
 176 void psensor_log_measures(struct psensor **sensors);
 177
 178 #endif