README 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. TMON - A Monitoring and Testing Tool for Linux kernel thermal subsystem
  2. Why TMON?
  3. ==========
  4. Increasingly, Linux is running on thermally constrained devices. The simple
  5. thermal relationship between processor and fan has become past for modern
  6. computers.
  7. As hardware vendors cope with the thermal constraints on their products, more
  8. and more sensors are added, new cooling capabilities are introduced. The
  9. complexity of the thermal relationship can grow exponentially among cooling
  10. devices, zones, sensors, and trip points. They can also change dynamically.
  11. To expose such relationship to the userspace, Linux generic thermal layer
  12. introduced sysfs entry at /sys/class/thermal with a matrix of symbolic
  13. links, trip point bindings, and device instances. To traverse such
  14. matrix by hand is not a trivial task. Testing is also difficult in that
  15. thermal conditions are often exception cases that hard to reach in
  16. normal operations.
  17. TMON is conceived as a tool to help visualize, tune, and test the
  18. complex thermal subsystem.
  19. Files
  20. =====
  21. tmon.c : main function for set up and configurations.
  22. tui.c : handles ncurses based user interface
  23. sysfs.c : access to the generic thermal sysfs
  24. pid.c : a proportional-integral-derivative (PID) controller
  25. that can be used for thermal relationship training.
  26. Requirements
  27. ============
  28. Depends on ncurses
  29. Build
  30. =========
  31. $ make
  32. $ sudo ./tmon -h
  33. Usage: tmon [OPTION...]
  34. -c, --control cooling device in control
  35. -d, --daemon run as daemon, no TUI
  36. -l, --log log data to /var/tmp/tmon.log
  37. -h, --help show this help message
  38. -t, --time-interval set time interval for sampling
  39. -v, --version show version
  40. -g, --debug debug message in syslog
  41. 1. For monitoring only:
  42. $ sudo ./tmon