doc/faq.txt

   1 Psensor Frequently Asked Questions
   2 ==================================
   3
   4 [[S_NoSensors]]
   5 No sensors or only cpu usage is displayed
   6 -----------------------------------------
   7
   8 Psensor is relying on few libraries or softwares for retrieving the information about the computer:
   9
  10         - motherboard and CPUs sensors: the information is retrieved
  11           from the lm-sensors library, it requires that
  12           ‘sensors-detect’ has been run and the kernel module
  13           correctly installed. ‘sensors’ can be used for checking.
  14
  15         - GPUs: it depends on which driver you are using:
  16
  17                 * Opensource drivers (nouveau for Nvidia GPUs or
  18                   radeon/ati for ATI GPUs) is used and support sensor
  19                   monitoring for your GPU, the information is using
  20                   lm-sensors, same steps than above.
  21
  22                 * proprietary driver Nvidia: run ‘nvidia-settings’ to
  23                   check that it supports sensors monitoring.
  24
  25                 * proprietary driver Catalyst/fglx: use ‘aticonfig’ to
  26                   check that it supports sensors monitoring. Important
  27                   note: it requires that you are using a Psensor
  28                   binary compiled with the ATI support.
  29
  30         - HDDs: it uses the hddtemp daemon. Verifies that it is
  31           correctly reporting temperature by using the ‘sudo hddtemp
  32           /dev/sd?’ command. If hddtemp does not support your disk,
  33           you may want to try using the libatasmart support instead
  34           (option –use-libatasmart option).
  35
  36 If the underlying software is reporting sensors which are not
  37 displayed by Psensor, it is probably a bug in Psensor, so please
  38 report it. Otherwise, the issue is on the underlying software itself
  39 and you should contact the corresponding development team or refer to
  40 its documentation.
  41
  42 [[S_ATIMonitoring]]
  43 How to monitor an ATI card using the Catalyst driver?
  44 -----------------------------------------------------
  45
  46 For monitoring ATI card using the proprietary Catalyst driver, Psensor
  47 must be compiled with a proprietary library which is not packaged in
  48 any Linux distribution.
  49
  50 Unfortunely, due to the license of this library, I cannot provide a
  51 compiled version of Psensor, even in a Ubuntu PPA or Ubuntu/Debian
  52 standard repositories. You have to compile Psensor sensor. You can
  53 find the instructions in the section “ATI/AMD GPU Support” of the
  54 README file available in the Psensor source archives.
  55
  56 If you are using the ATI OpenSource driver, it is not needed to
  57 compile Psensor with this proprietary library.
  58
  59 [[S_WrongTemperature]]
  60 The reported temperature is obviously wrong
  61 -------------------------------------------
  62
  63 If the reported temperature is obviously wrong (never change, lower
  64 than the ambiant temperature, negative, higher than the sun
  65 temperature, etc):
  66
  67         - most of the time it is not a bug in Psensor nor in the
  68           underlying monitoring libraries:
  69
  70                 * if the temperature does not change, it might be due
  71                   to an existent sensor not wired by the hardware
  72                   manufacturer.
  73
  74                 * the goal of the sensor is to allow the system to
  75                   detect critical temperature and NOT to report an
  76                   exact temperature. Most sensors report a relative
  77                   temperature. The more it differs from the critical
  78                   temperature , the more it is wrong.
  79
  80         - It is only a bug in Psensor if the underlying libraries
  81           report a different information than Psensor (use the
  82           appropriate command or software: ‘sensors’, ‘aticonfig’ or
  83           ‘hddtemp’ to check). In this case, please report a bug.
  84
  85 [[S_WhatIsTheSensor]]
  86 What is the sensors XXXX?
  87 -------------------------
  88
  89 Since Psensor v0.7.0.4, open the preferences of the sensor (click on
  90 its name in the main window and select the menu item Preferences), and
  91 look at the Chip field.
  92
  93 For older Psensor releases, look at the Id field, if the string is
  94 starting with:
  95
  96         - ‘lmsensor coretemp’: Intel CPU.
  97         - ‘lmsensor k10temp’,'lmsensor k8temp’,'lmsensor fam15h_power’: AMD CPU.
  98         - ‘nvidia’ or ‘lmsensor nouveau’: NVIDIA GPU.
  99         - ‘hdd’: hard disk drive.
 100         - ‘amd’: AMD GPU.
 101         - ‘lmsensor C B’: C is the name of the chip, B the name of the adapter.
 102
 103 For more information about lmsensor devices, see
 104 http://lm-sensors.org/wiki/Devices.
 105
 106 [[S_BugReport]]
 107 How to report a bug?
 108 --------------------
 109
 110 Please use https://bugs.launchpad.net/psensor/+filebug to report bugs
 111 even if it can only reproduced with a non-Ubuntu distribution or a
 112 release not available in the standard Ubuntu repositories.
 113
 114 You can also use
 115 https://bugs.launchpad.net/ubuntu/+source/psensor/+filebug if the bug
 116 can be reproduced with a package from the standard Ubuntu
 117 repositories.
 118
 119 If you don’t want to use the launchpad, you can send me the report by
 120 email to jeanfi@gmail.com.
 121
 122 If the bug is concerning Debian or Ubuntu derivatives distribution,
 123 please add in its description the output of the command ‘apt-cache
 124 policy psensor’.
 125
 126 If it is related to the Psensor source compilation, please add the
 127 full output of the ‘configure’ command.
 128
 129 [[S_SubmitIdea]]
 130 How to send ideas, questions or comments?
 131 -----------------------------------------
 132
 133 Check the FAQ or the TODO pages.
 134
 135 If you don’t find the information, I am always happy to help, you can
 136 contact me:
 137
 138         - by email: (jeanfi@gmail.com), please add “[psensor]” in the
 139           subject, I speak English and French.
 140
 141         - or IRC: I am on the #psensor channel of the irc.freenode.net
 142           server. My nickname is “jfi”. Even if I am most of the time
 143           connected, I may not be in front of the computer or
 144           available, be patient!
 145
 146 [[S_Contribute]]
 147 How to contribute?
 148 ------------------
 149
 150 See http://wpitchoune.net/blog/psensor/how-to-contribute/.
 151
 152 [[S_UbuntuInstall]]
 153 How to install Psensor on Ubuntu?
 154 ---------------------------------
 155
 156 Psensor is in the official repository, search “psensor” in the software center and install it. More information at: http://wpitchoune.net/blog/psensor/ubuntu-integration/.
 157
 158 [[S_DebianInstall]]
 159 How to install Psensor on Debian?
 160 ---------------------------------
 161
 162 Psensor will be in the official repository since Debian 7.0. You can get the last packaged version from the sid repository. More information at: http://packages.qa.debian.org/p/psensor.html.
 163
 164 [[S_PPA]]
 165 What is the difference between the 3 Ubuntu PPAs?
 166 -------------------------------------------------
 167
 168         - ppa:jfi/ppa: last stable version.
 169
 170         - ppa:jfi/psensor-unstable: last development version, no major
 171           bug is expected.
 172
 173         - ppa:jfi/psensor-daily-trunk: build each day directly from
 174           the SVN source repository. It may contain major bugs or
 175           incomplete features. Useful for contributors or testing
 176           whether a bug is fixed.
 177
 178 [[S_ArchLinuxInstall]]
 179 How to install Psensor on ArchLinux?
 180 ------------------------------------
 181
 182 See http://aur.archlinux.org/packages.php?ID=37807.
 183
 184 [[S_OtherInstall]]
 185 How to install Psensor on my Linux distribution?
 186 ------------------------------------------------
 187
 188 Psensor packages are available in the standard repositories of Ubuntu
 189 (since Oneiric) and Debian (since v7) distributions.
 190
 191 For other distributions, you will find the compilation and
 192 installation instructions in the section ‘Installation from source
 193 archive’ in the README file of the source archive. Psensor should
 194 compile in any modern distribution.
 195
 196 [[S_LOG]]
 197 How to log sensors temperatures?
 198 --------------------------------
 199
 200 The best way is probably to use sensord or a custom script based on
 201 the output of the different commands like sensors.
 202
 203 Anyway, as I received several requests about such feature, since the
 204 0.7.0.4 release it is implemented in both psensor ( menu preferences >
 205 sensors > enable log of measures) and psensor-server (–sensor-log-file
 206 option).
 207
 208 [[S_SimilarSoft]]
 209 Is there any other similar softwares?
 210 -------------------------------------
 211
 212 Here is a list of few well-known sensors monitoring softwares:
 213
 214         - for X11: http://freecode.com/projects/xsensors
 215
 216         - for GNOME2: http://sensors-applet.sourceforge.net/
 217
 218         - for Ubuntu Unity: https://launchpad.net/indicator-sensors
 219
 220         - more general, but can be configured to display sensors
 221           information: http://conky.sourceforge.net/