Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 150 lines (105 sloc) 4.562 kb
49668a1 @ceferron update READEME marking optional, and required packages
ceferron authored
1 Building & Installing PowerTOP
64d88a1 @fenrus75 add internationalisation support
authored
2 ------------------------------
3
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
4 To build and install PowerTOP type the following commands,
5 ./configure
6 ./make
7 ./make install
64d88a1 @fenrus75 add internationalisation support
authored
8
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
9 Note: For Android (running Intel Architecture ) there is a Android.mk
10 that was provided by community members, and at this time is supported
11 mostly by community members.
64d88a1 @fenrus75 add internationalisation support
authored
12
13 Build dependencies
14 ------------------
15
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
16 PowerTOP uses C++, and expects g++ and libstdc++ to be functional
5674c86 @ceferron update configure to check for both packages and lib, for distros that do...
ceferron authored
17 along with a glibc/pthreadsi, autoconf, automake, and libtool in the
18 development environment.
19
64d88a1 @fenrus75 add internationalisation support
authored
20
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
21 in addition to that, PowerTOP requires the following components:
64d88a1 @fenrus75 add internationalisation support
authored
22
ec62f9f @ceferron update readme
ceferron authored
23 pciutils-devel (is only required if you have PCI)
49668a1 @ceferron update READEME marking optional, and required packages
ceferron authored
24 ncurses-devel (required)
25 libnl-devel (required)
ec62f9f @ceferron update readme
ceferron authored
26 kernel version => 2.6.38
6db164d @fenrus75 more text
authored
27
3f5bccb @magnoliatitanium Android Support
magnoliatitanium authored
28
29 Build PowerTop for Android LollyPop
30 ------------------------------------
31
32 1. Obtain pciutils and ncurses libraries.
33 Skip this step if they are already in the tree.
34
35 pciutils: Clone
36 https://github.com/trevd/android_external_pciutils
37 into external/pciutils
38
39 ncurses: Clone
40 https://github.com/cvpcs/android_external_libncurses
41 into external/ncurses
42
43 2. Run
44 ./src/csstoh.sh src/powertop.css src/css.h
45 to generate the css.h header file.
46
47 3. Apply patches inside patches/Android
48
49 4. PowerTop can be built with top level make,
50 or by doing "mm".
51
52 The resulting binary is under $ANDROID_PRODUCT_OUT/system/bin/powertop
53
54
687eb8d README: add needed kernel options
Henry Gebhardt authored
55 Kernel Parameters:
56 ------------------
57
58 PowerTOP needs some kernel config options enabled in order function properly.
59 As of linux-3.3.0 these are (list probably incomplete):
60
61 CONFIG_NO_HZ
62 CONFIG_HIGH_RES_TIMERS
63 CONFIG_HPET_TIMER
64 CONFIG_CPU_FREQ_GOV_ONDEMAND
65 CONFIG_USB_SUSPEND
66 CONFIG_SND_AC97_POWER_SAVE
67 CONFIG_TIMER_STATS
68 CONFIG_PERF_EVENTS
69 CONFIG_PERF_COUNTERS
70 CONFIG_TRACEPOINTS
71 CONFIG_TRACING
72 CONFIG_EVENT_POWER_TRACING_DEPRECATED
6be3148 @jnikula README: add CONFIG_X86_MSR to the list of required kernel config options
jnikula authored
73 CONFIG_X86_MSR
caec6fe @ceferron add time date to html file name
ceferron authored
74 ACPI_PROCFS_POWER
a00c9de @sergey-senozhatsky README: add CONFIG_DEBUG_FS to Kernel Parameters
sergey-senozhatsky authored
75 CONFIG_DEBUG_FS
687eb8d README: add needed kernel options
Henry Gebhardt authored
76
2b2223a Update README with configs
Srinivas Pandruvada authored
77 Use these configs from linux-3.13.rc1
78 CONFIG_POWERCAP
79 CONFIG_INTEL_RAPL
80
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
81 The patches in the patches/ sub-directory are required for PowerTOP to function
687eb8d README: add needed kernel options
Henry Gebhardt authored
82 fully.
83
84
85
6db164d @fenrus75 more text
authored
86 Outputting a report
87 -------------------
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
88 When invoking PowerTOP without arguments, PowerTOP starts in interactive mode.
89 However, for reporting bugs etc there is a special reporting modes:
90
91 For an HTML formatted report simply execute PowerTOP with the following,
6db164d @fenrus75 more text
authored
92
93 powertop --html
94
95 which will create a "powertop.html" file which is static and can be sent to
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
96 others to help diagnose power issues. Additionally has the feature of showing
cb809ee Fix a few minor spelling mistakes/typos
Colin Ian King authored
97 the tunables executions within the report as a reference.
6db164d @fenrus75 more text
authored
98
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
99 Note for the developers: If you make changes on the report format please
99f24ee powertop: generate valid HTML report
Márton Németh authored
100 make sure that the output can be cleanly validated by the W3C Markup
101 Validation Service and W3C CSS Validation Service:
102 * http://validator.w3.org/#validate_by_upload
103 * http://jigsaw.w3.org/css-validator/#validate_by_upload
6db164d @fenrus75 more text
authored
104
6c2965f Fix CSV typo in README
Colin Ian King authored
105 For a CSV formatted report, simply execute PowerTOP with the following,
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
106
107 Powertop --csv
108
109 which will create a “powertop.csv” file which is static and can be used in
110 reporting, diagnoses, and analytical data analysis.
111
112 Also you can set the number of iterations, and duration of test, in which case
113 all reports will time stamp for you.
6db164d @fenrus75 more text
authored
114
115 Calibrating & Power Numbers
116 ---------------------------
117 PowerTOP will, when running on battery, track your power consumption as well
118 as your activity on the system. Once there are sufficient such measurements,
119 PowerTOP can start to report power estimates for various activities.
120 You can help get this estimation more accurate by running a calibration
121 cycle:
122
123 powertop --calibrate
124
125 at least once; this will cycle through various display brightness levels
126 (including "off") as well as USB device activities and some other workloads.
127
128
fc0eae5 @fenrus75 mention the iw code in the README
authored
129 Code from other open source projects
130 ------------------------------------
131 PowerTOP contains some code from other open source projects; we'd like to
132 thank the authors of those projects for their work.
133 Specifically PowerTOP contains code from
134
efba72d @ceferron This is the inital Auto Tools work, along with some small updates.
ceferron authored
135 Parse Event Library - Copyright 2009, 2010 Red Hat Inc Steven Rosted <srostedt@redhat.com>
fc0eae5 @fenrus75 mention the iw code in the README
authored
136 nl80211 userspace tool - Copyright 2007, 2008 Johannes Berg <johannes@sipsolutions.net>
137
138
a051925 @fenrus75 more Extech integration
authored
139 Extech Power Analyzer / Datalogger support
140 ------------------------------------------
141 I use, and our analysis teams use, the Extech Power Analyzer/Datalogger
142 (model number 380803) quite a lot, and PowerTOP supports using this
143 device over the serial cable. Just pass the device node on the command line
144 like this
145
146 powertop --extech=/dev/ttyUSB0
147
148 (where ttyUSB0 is the devicenode of the serial-to-usb adapter on my system)
149
Something went wrong with that request. Please try again.