@@ -10,16 +10,16 @@ List: linux-thinkpad@linux-thinkpad.org
1010Description
1111-----------
1212
13- ThinkPad laptops include a proprietary interface called SMAPI BIOS
13+ ThinkPad laptops include a proprietary interface called SMAPI BIOS
1414(System Management Application Program Interface) which provides some
1515hardware control functionality that is not accessible by other means.
1616
17- This driver exposes some features of the SMAPI BIOS through a sysfs
18- interface. It is suitable for newer models, on which SMAPI is invoked
19- through IO port writes. Older models use a different SMAPI interface;
17+ This driver exposes some features of the SMAPI BIOS through a sysfs
18+ interface. It is suitable for newer models, on which SMAPI is invoked
19+ through IO port writes. Older models use a different SMAPI interface;
2020for those, try the "thinkpad" module from the "tpctl" package.
2121
22- WARNING:
22+ WARNING:
2323This driver uses undocumented features and direct hardware access.
2424It thus cannot be guaranteed to work, and may cause arbitrary damage
2525(especially on models it wasn't tested on).
@@ -63,7 +63,7 @@ To delete all autogenerated files:
6363
6464Append "DEBUG=1" to "make load" to load tp_smapi with debug=1.
6565
66- The original kernel tree is never modified by any these commands.
66+ The original kernel tree is never modified by any these commands.
6767The /lib/modules directory is modified only by "make install".
6868
6969
@@ -73,7 +73,7 @@ Module parameters
7373thinkpad_ec module:
7474 force_io=1 lets thinkpad_ec load on some recent ThinkPad models
7575 (e.g., T400 and T500) whose BIOS's ACPI DSDT reserves the ports we need.
76- tp_smapi module:
76+ tp_smapi module:
7777 debug=1 enables verbose dmesg output.
7878
7979
@@ -87,9 +87,9 @@ capacity):
8787# echo 70 > /sys/devices/platform/smapi/BAT0/stop_charge_thresh
8888# cat /sys/devices/platform/smapi/BAT0/*_charge_thresh
8989
90- (This is useful since Li-Ion batteries wear out much faster at very
91- high or low charge levels. The driver will also keeps the thresholds
92- across suspend-to-disk with AC disconnected; this isn't done
90+ (This is useful since Li-Ion batteries wear out much faster at very
91+ high or low charge levels. The driver will also keeps the thresholds
92+ across suspend-to-disk with AC disconnected; this isn't done
9393 automatically by the hardware.)
9494
9595Inhibiting battery charging for 17 minutes (overrides thresholds):
@@ -98,7 +98,7 @@ Inhibiting battery charging for 17 minutes (overrides thresholds):
9898# echo 0 > /sys/devices/platform/smapi/BAT0/inhibit_charge_minutes # stop
9999# cat /sys/devices/platform/smapi/BAT0/inhibit_charge_minutes
100100
101- (This can be used to control which battery is charged when using an
101+ (This can be used to control which battery is charged when using an
102102 Ultrabay battery.)
103103
104104Forcing battery discharging even if AC power available:
@@ -149,7 +149,7 @@ The BAT0/group{0,1,2,3}_voltage attribute refers to the separate cell groups
149149in each battery. For example, on the ThinkPad 600, X3x, T4x and R5x models,
150150the battery contains 3 cell groups in series, where each group consisting of 2
151151or 3 cells connected in parallel. The voltage of each group is given by these
152- attributes, and their sum (roughly) equals the "voltage" attribute.
152+ attributes, and their sum (roughly) equals the "voltage" attribute.
153153(The effective performance of the battery is determined by the weakest group,
154154i.e., the one those voltage changes most rapidly during dis/charging.)
155155
@@ -187,19 +187,19 @@ Works (at least partially) on the following ThinkPad model:
187187Not all functions are available on all models; for detailed status, see:
188188 http://thinkwiki.org/wiki/tp_smapi
189189
190- Please report success/failure by e-mail or on the Wiki.
191- If you get a "not implemented" or "not supported" message, your laptop
190+ Please report success/failure by e-mail or on the Wiki.
191+ If you get a "not implemented" or "not supported" message, your laptop
192192probably just can't do that (at least not via the SMAPI BIOS).
193193For negative reports, follow the bug reporting guidelines below.
194- If you send me the necessary technical data (i.e., SMAPI function
194+ If you send me the necessary technical data (i.e., SMAPI function
195195interfaces), I will support additional models.
196196
197197
198198Conflict with HDAPS
199199-------------------
200200
201201The extended battery status function conflicts with the "hdaps" kernel module
202- (they use the same IO ports).
202+ (they use the same IO ports).
203203
204204You can use HDAPS=1 (see Installation) to get a patched version of hdaps which
205205is compatible with tp_smapi.
@@ -313,12 +313,12 @@ Makefile
313313tp_smapi.c
314314 tp_smapi driver module (main code).
315315thinkpad_ec.*
316- thinkpad_ec driver module (coordinates hardware access between tp_smapi and
316+ thinkpad_ec driver module (coordinates hardware access between tp_smapi and
317317 hdaps)
318318hdaps.c
319319 Modified version of hdaps.c driver from mainline kernel, patched to use
320320 thinkpad_ec and several other improvements.
321- diff/* (excluding above)
321+ diff/* (excluding above)
322322 Used by "make patch" to create a clean stand-alone patch.
323323include/
324324 Contains a symlink to make gcc happy in kernel builds.
@@ -338,18 +338,18 @@ For hints about what may be possible via the SMAPI BIOS and how, see:
338338
339339Note that in the above Technical Reference and in the "thinkpad" module,
340340SMAPI is invoked through a function call to some physical address. However,
341- the interface used by tp_smapi and the above mwave drive, and apparently
342- required by newer ThinkPad, is different: you set the parameters up in the
341+ the interface used by tp_smapi and the above mwave drive, and apparently
342+ required by newer ThinkPad, is different: you set the parameters up in the
343343CPU's registers and write to ports 0xB2 (the APM control port) and 0x4F; this
344344triggers an SMI (System Management Interrupt), causing the CPU to enter
345- SMM (System Management Mode) and run the BIOS firmware; the results are
346- returned in the CPU's registers. It is not clear what is the relation between
347- the two variants of SMAPI, though the assignment of error codes seems to be
345+ SMM (System Management Mode) and run the BIOS firmware; the results are
346+ returned in the CPU's registers. It is not clear what is the relation between
347+ the two variants of SMAPI, though the assignment of error codes seems to be
348348similar.
349349
350- In addition, the embedded controller on ThinkPad laptops has a non-standard
350+ In addition, the embedded controller on ThinkPad laptops has a non-standard
351351interface at IO ports 0x1600-0x161F (mapped to LCP channel 3 of the H8S chip).
352- The interface provides various system management services (currently known:
352+ The interface provides various system management services (currently known:
353353battery information and accelerometer readouts). For more information see the
354354thinkpad_ec module and the H8S hardware documentation:
355355http://documentation.renesas.com/eng/products/mpumcu/rej09b0300_2140bhm.pdf
0 commit comments