186a40a4297698ee491c64c66a1da0773a3af1e4
[www.git] / www / psensor / faq.html
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta charset="UTF-8">
5 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
7 <meta name="generator" content="Asciidoctor 1.5.4">
8 <title>Psensor Frequently Asked Questions</title>
9 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700">
10 <link rel="stylesheet" href="./asciidoctor.css">
11 </head>
12 <body class="article">
13 <div id="header">
14 <h1>Psensor Frequently Asked Questions</h1>
15 </div>
16 <div id="content">
17 <div id="preamble">
18 <div class="sectionbody">
19 <div class="paragraph">
20 <p>The last version of this FAQ is available at <a href="http://wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=doc/faq.html;hb=HEAD" class="bare">http://wpitchoune.net/gitweb/?p=psensor.git;a=blob_plain;f=doc/faq.html;hb=HEAD</a>.</p>
21 </div>
22 </div>
23 </div>
24 <div class="sect1">
25 <h2 id="S_NoSensors">No sensors or only cpu usage is displayed</h2>
26 <div class="sectionbody">
27 <div class="paragraph">
28 <p>Psensor is relying on few libraries or softwares for retrieving the
29 information about the computer:</p>
30 </div>
31 <div class="ulist">
32 <ul>
33 <li>
34 <p>motherboard and CPUs sensors: the information is retrieved
35 from the lm-sensors library, it requires that
36 <code>sensors-detect</code> has been run and the kernel module
37 correctly installed. <code>sensors</code> can be used for checking.</p>
38 </li>
39 <li>
40 <p>GPUs: it depends on which driver you are using:</p>
41 <div class="ulist">
42 <ul>
43 <li>
44 <p>Opensource drivers (nouveau for Nvidia GPUs or
45 radeon/ati for ATI GPUs) is used and support sensor
46 monitoring for your GPU, the information is using
47 lm-sensors, same steps than above.</p>
48 </li>
49 <li>
50 <p>proprietary driver Nvidia: run <code>nvidia-settings</code> to
51 check that it supports sensors monitoring.</p>
52 </li>
53 <li>
54 <p>proprietary driver Catalyst/fglx: use <code>aticonfig</code> to
55 check that it supports sensors monitoring. Important
56 note: it requires that you are using a Psensor
57 binary compiled with the ATI support.</p>
58 </li>
59 </ul>
60 </div>
61 </li>
62 </ul>
63 </div>
64 <div class="paragraph">
65 <p>For hard disk drives, psensor can use:</p>
66 </div>
67 <div class="ulist">
68 <ul>
69 <li>
70 <p>udisks2: added since 1.1.2 release. It is the default and
71 recommended provider.</p>
72 </li>
73 <li>
74 <p>hddtemp: verify that it is correctly reporting temperature by
75 using the command: <code>sudo hddtemp /dev/sda</code>. It is the default
76 provider until 1.1.2 release.</p>
77 </li>
78 <li>
79 <p>atasmart library: before the 1.1.2 release it can be enabled
80 by using the command line option <code>--use-libatasmart</code>.</p>
81 </li>
82 </ul>
83 </div>
84 <div class="paragraph">
85 <p>If the underlying software is reporting sensors which are not
86 displayed by Psensor, it is probably a bug in Psensor, so please
87 report it. Otherwise, the issue is on the underlying software itself
88 and you should contact the corresponding development team or refer to
89 its documentation.</p>
90 </div>
91 <div class="paragraph">
92 <p>Since the release 1.1.2, the providers can be enabled or disabled directly
93 from the user interface (<code>Preferences&gt;Provider</code>).</p>
94 </div>
95 </div>
96 </div>
97 <div class="sect1">
98 <h2 id="S_ATIMonitoring">How to monitor an ATI card using the Catalyst driver?</h2>
99 <div class="sectionbody">
100 <div class="paragraph">
101 <p>For monitoring ATI card using the proprietary Catalyst driver, Psensor
102 must be compiled with a proprietary library which is not packaged in
103 any Linux distribution.</p>
104 </div>
105 <div class="paragraph">
106 <p>Unfortunely, due to the license of this library, I cannot provide a
107 compiled version of Psensor, even in a Ubuntu PPA or Ubuntu/Debian
108 standard repositories. You have to compile Psensor sensor. You can
109 find the instructions in the section <code>ATI/AMD GPU Support</code> of the
110 README file available in the Psensor source archives.</p>
111 </div>
112 <div class="paragraph">
113 <p>If you are using the ATI OpenSource driver, it is not needed to
114 compile Psensor with this proprietary library.</p>
115 </div>
116 </div>
117 </div>
118 <div class="sect1">
119 <h2 id="S_WrongTemperature">The reported temperature is obviously wrong</h2>
120 <div class="sectionbody">
121 <div class="paragraph">
122 <p>If the reported temperature is obviously wrong (never change, lower
123 than the ambiant temperature, negative, higher than the sun
124 temperature, etc):</p>
125 </div>
126 <div class="ulist">
127 <ul>
128 <li>
129 <p>most of the time it is not a bug in Psensor nor in the
130 underlying monitoring libraries:</p>
131 <div class="ulist">
132 <ul>
133 <li>
134 <p>if the temperature does not change, it might be due
135 to an existent sensor not wired by the hardware
136 manufacturer.</p>
137 </li>
138 <li>
139 <p>the goal of the sensor is to allow the system to
140 detect critical temperature and NOT to report an
141 exact temperature. Most sensors report a relative
142 temperature. The more it differs from the critical
143 temperature , the more it is wrong.</p>
144 </li>
145 </ul>
146 </div>
147 </li>
148 <li>
149 <p>It is only a bug in Psensor if the underlying libraries
150 report a different information than Psensor (use the
151 appropriate command or software: <code>sensors</code>, <code>aticonfig</code> or
152 <code>hddtemp</code> to check). In this case, please report a bug.</p>
153 </li>
154 </ul>
155 </div>
156 </div>
157 </div>
158 <div class="sect1">
159 <h2 id="S_WhatIsTheSensor">What is the sensors XXXX?</h2>
160 <div class="sectionbody">
161 <div class="paragraph">
162 <p>Since Psensor v0.7.0.4, open the preferences of the sensor (click on
163 its name in the main window and select the menu item Preferences), and
164 look at the Chip field.</p>
165 </div>
166 <div class="paragraph">
167 <p>For older Psensor releases, look at the Id field, if the string is
168 starting with:</p>
169 </div>
170 <div class="ulist">
171 <ul>
172 <li>
173 <p><code>lmsensor coretemp</code>: Intel CPU.</p>
174 </li>
175 <li>
176 <p><code>lmsensor k10temp</code>, <code>lmsensor k8temp</code>, <code>lmsensor fam15h_power</code>: AMD CPU.</p>
177 </li>
178 <li>
179 <p><code>nvidia</code> or <code>lmsensor nouveau</code>: NVIDIA GPU.</p>
180 </li>
181 <li>
182 <p><code>hdd</code>: hard disk drive.</p>
183 </li>
184 <li>
185 <p><code>amd</code>: AMD GPU.</p>
186 </li>
187 <li>
188 <p><code>lmsensor C B</code>: C is the name of the chip, B the name of the adapter.</p>
189 </li>
190 </ul>
191 </div>
192 <div class="paragraph">
193 <p>For more information about lmsensor devices, see
194 <a href="http://lm-sensors.org/wiki/Devices" class="bare">http://lm-sensors.org/wiki/Devices</a>.</p>
195 </div>
196 </div>
197 </div>
198 <div class="sect1">
199 <h2 id="S_BugReport">How to report a bug?</h2>
200 <div class="sectionbody">
201 <div class="paragraph">
202 <p>Please use <a href="https://bugs.launchpad.net/psensor/+filebug" class="bare">https://bugs.launchpad.net/psensor/+filebug</a> to report bugs
203 even if it can only reproduced with a non-Ubuntu distribution or a
204 release not available in the standard Ubuntu repositories.</p>
205 </div>
206 <div class="paragraph">
207 <p>You can also use
208 <a href="https://bugs.launchpad.net/ubuntu/+source/psensor/+filebug" class="bare">https://bugs.launchpad.net/ubuntu/+source/psensor/+filebug</a> if the bug
209 can be reproduced with a package from the standard Ubuntu
210 repositories.</p>
211 </div>
212 <div class="paragraph">
213 <p>If you don’t want to use the launchpad, you can send the report by
214 email to:</p>
215 </div>
216 <div class="ulist">
217 <ul>
218 <li>
219 <p><a href="mailto:psensor-users@googlegroups.com">psensor-users@googlegroups.com</a></p>
220 </li>
221 <li>
222 <p>or <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p>
223 </li>
224 </ul>
225 </div>
226 <div class="paragraph">
227 <p>If the bug is concerning Debian or Ubuntu derivatives distribution,
228 please add in its description the output of the command: <code>apt-cache
229 policy psensor</code>.</p>
230 </div>
231 <div class="paragraph">
232 <p>If it is related to the Psensor source compilation, please add the
233 full output of the <code>configure</code> command.</p>
234 </div>
235 </div>
236 </div>
237 <div class="sect1">
238 <h2 id="S_SubmitIdea">How to send ideas, questions or comments?</h2>
239 <div class="sectionbody">
240 <div class="paragraph">
241 <p>Check the FAQ or the TODO pages.</p>
242 </div>
243 <div class="paragraph">
244 <p>If you don’t find the information, you can send an email to the public
245 mailing-list <a href="mailto:psensor-users@googlegroups.com">psensor-users@googlegroups.com</a> or directly to me:
246 <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p>
247 </div>
248 </div>
249 </div>
250 <div class="sect1">
251 <h2 id="S_Contribute">How to contribute?</h2>
252 <div class="sectionbody">
253 <div class="paragraph">
254 <p>See <a href="http://wpitchoune.net/blog/psensor/how-to-contribute/" class="bare">http://wpitchoune.net/blog/psensor/how-to-contribute/</a>.</p>
255 </div>
256 </div>
257 </div>
258 <div class="sect1">
259 <h2 id="S_UbuntuInstall">How to install Psensor on Ubuntu?</h2>
260 <div class="sectionbody">
261 <div class="paragraph">
262 <p>Psensor is in the official repository, search <code>psensor</code> in the
263 software center and install it. More information at:
264 <a href="http://wpitchoune.net/blog/psensor/ubuntu-integration/" class="bare">http://wpitchoune.net/blog/psensor/ubuntu-integration/</a>.</p>
265 </div>
266 </div>
267 </div>
268 <div class="sect1">
269 <h2 id="S_DebianInstall">How to install Psensor on Debian?</h2>
270 <div class="sectionbody">
271 <div class="paragraph">
272 <p>Psensor is in the official repository since Debian 7.0. You can get
273 the last packaged version from the sid repository. More information
274 at: <a href="http://packages.qa.debian.org/p/psensor.html" class="bare">http://packages.qa.debian.org/p/psensor.html</a>.</p>
275 </div>
276 </div>
277 </div>
278 <div class="sect1">
279 <h2 id="S_PPA">What is the difference between the 3 Ubuntu PPAs?</h2>
280 <div class="sectionbody">
281 <div class="ulist">
282 <ul>
283 <li>
284 <p><code>ppa:jfi/ppa</code>: last stable version.</p>
285 </li>
286 <li>
287 <p><code>ppa:jfi/psensor-unstable</code>: last development version, no
288 major bug is expected.</p>
289 </li>
290 <li>
291 <p><code>ppa:jfi/psensor-daily-trunk</code>: build each day directly from
292 the GIT source repository. It may contain major bugs or
293 incomplete features. Useful for contributors or testing
294 whether a bug is fixed.</p>
295 </li>
296 </ul>
297 </div>
298 </div>
299 </div>
300 <div class="sect1">
301 <h2 id="S_ArchLinuxInstall">How to install Psensor on ArchLinux?</h2>
302 <div class="sectionbody">
303 <div class="paragraph">
304 <p>See <a href="http://aur.archlinux.org/packages.php?ID=37807" class="bare">http://aur.archlinux.org/packages.php?ID=37807</a>.</p>
305 </div>
306 </div>
307 </div>
308 <div class="sect1">
309 <h2 id="S_OtherInstall">How to install Psensor on my Linux distribution?</h2>
310 <div class="sectionbody">
311 <div class="paragraph">
312 <p>Psensor packages are available in the standard repositories of Ubuntu
313 (since Oneiric) and Debian (since v7) distributions.</p>
314 </div>
315 <div class="paragraph">
316 <p>For other distributions, you will find the compilation and
317 installation instructions in the section <code>Installation from source
318 archive</code> in the README file of the source archive. Psensor should
319 compile in any modern distribution.</p>
320 </div>
321 </div>
322 </div>
323 <div class="sect1">
324 <h2 id="S_LOG">How to log sensors temperatures?</h2>
325 <div class="sectionbody">
326 <div class="paragraph">
327 <p>The best way is probably to use sensord or a custom script based on
328 the output of the different commands like <code>sensors</code>.</p>
329 </div>
330 <div class="paragraph">
331 <p>Anyway, as I received several requests about such feature, since the
332 0.7.0.4 release it is implemented in both psensor ( menu preferences &gt;
333 sensors &gt; enable log of measures) and psensor-server
334 (<code>--sensor-log-file</code> option). For psensor the log file is
335 <code>$HOME/.psensor/sensors.log</code>.</p>
336 </div>
337 </div>
338 </div>
339 <div class="sect1">
340 <h2 id="S_NO_GRAPH_DISPLAYED">No graphs are displayed, but the table of the main window is displaying sensors</h2>
341 <div class="sectionbody">
342 <div class="paragraph">
343 <p>In the sensors table of the main window, switch on the checkbox of the last
344 column (named <code>Enabled</code> or <code>Graph</code> depending on the Psensor version).</p>
345 </div>
346 </div>
347 </div>
348 <div class="sect1">
349 <h2 id="S_autostart">Launch Psensor automaticaly on session startup</h2>
350 <div class="sectionbody">
351 <div class="paragraph">
352 <p>Since the version 1.0.1, Psensor is no more started automaticaly by default.</p>
353 </div>
354 <div class="paragraph">
355 <p>Open the <code>Preferences</code> window, select the <code>Startup</code> tab and switch on
356 the option <code>Launch on session startup</code>.</p>
357 </div>
358 <div class="paragraph">
359 <p>This feature is requiring that the Desktop Environment supports the
360 <a href="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">XDG
361 specification</a>.</p>
362 </div>
363 </div>
364 </div>
365 <div class="sect1">
366 <h2 id="S_disk">How to monitor the temperature of a disk with <code>hddtemp</code>?</h2>
367 <div class="sectionbody">
368 <div class="paragraph">
369 <p>Until the release 1.1.2, Psensor is using <code>hddtemp</code> by default to
370 retrieve the temperature of the disks.</p>
371 </div>
372 <div class="paragraph">
373 <p>If <code>hddtemp</code> is installed but no disk temperature is reported, check
374 that the daemon is running by using for example the command <code>ps
375 -eaf|grep hddtemp</code>.
376 It should output something like:</p>
377 </div>
378 <div class="listingblock">
379 <div class="content">
380 <pre>root      1433     1  0 May28 ?        00:00:21 /usr/sbin/hddtemp -d -l 127.0.0.1 -p 7634 -s | /dev/sdb</pre>
381 </div>
382 </div>
383 <div class="paragraph">
384 <p>Depending on the Linux distribution, the installation of the <code>hddtemp</code>
385 package does not enable the hddtemp daemon automaticaly.</p>
386 </div>
387 <div class="paragraph">
388 <p>In this case, edit the file <code>/etc/default/hddtemp</code> and set
389 <code>RUN_DAEMON</code> to <code>"true"</code>. After edition, it should contain the
390 following line:</p>
391 </div>
392 <div class="listingblock">
393 <div class="content">
394 <pre>RUN_DAEMON="true"</pre>
395 </div>
396 </div>
397 <div class="paragraph">
398 <p>For Debian/Ubuntu, you can use at root:</p>
399 </div>
400 <div class="listingblock">
401 <div class="content">
402 <pre>dpkg-reconfigure hddtemp</pre>
403 </div>
404 </div>
405 <div class="paragraph">
406 <p>and reply <code>yes</code> when asked whether hddtemp daemon must be
407 run during the startup.</p>
408 </div>
409 </div>
410 </div>
411 <div class="sect1">
412 <h2 id="S_SimilarSoft">Is there any other similar softwares?</h2>
413 <div class="sectionbody">
414 <div class="paragraph">
415 <p>Here is a list of few well-known sensors monitoring softwares:</p>
416 </div>
417 <div class="ulist">
418 <ul>
419 <li>
420 <p>for X11: <a href="http://freecode.com/projects/xsensors" class="bare">http://freecode.com/projects/xsensors</a></p>
421 </li>
422 <li>
423 <p>for GNOME2: <a href="http://sensors-applet.sourceforge.net/" class="bare">http://sensors-applet.sourceforge.net/</a></p>
424 </li>
425 <li>
426 <p>for Ubuntu Unity: <a href="https://launchpad.net/indicator-sensors" class="bare">https://launchpad.net/indicator-sensors</a></p>
427 </li>
428 <li>
429 <p>more general, but can be configured to display sensors
430 information: <a href="http://conky.sourceforge.net/" class="bare">http://conky.sourceforge.net/</a></p>
431 </li>
432 </ul>
433 </div>
434 </div>
435 </div>
436 <div class="sect1">
437 <h2 id="S_HideSensor">Is it possible to hide sensors in the main window?</h2>
438 <div class="sectionbody">
439 <div class="paragraph">
440 <p>Before v1.1.1, the sensors retrieved from the lm-sensor library can be
441 ignored directly in the lm-sensor configuration. See the manpage
442 of sensors.conf(5).</p>
443 </div>
444 <div class="paragraph">
445 <p>Since v1.1.1, it is possible to hide a sensor, uncheck the setting
446 <em>Display sensor in the list of sensors</em> in the sensor preferences.</p>
447 </div>
448 </div>
449 </div>
450 </div>
451 <div id="footer">
452 <div id="footer-text">
453 Last updated 2016-06-10 11:21:52 CEST
454 </div>
455 </div>
456 </body>
457 </html>