SMAPI support for Linux - Revision history

Jdthood at 18:04, 7 January 2008

2008-01-07T18:04:25Z

Thinker at 17:00, 26 February 2006

2006-02-26T17:00:52Z

Thinker at 10:00, 11 January 2006

2006-01-11T10:00:00Z

Thinker: Split off tpctl and tp_smapi

2006-01-11T09:58:26Z

Split off tpctl and tp_smapi

Show changes

Thinker: Models

2006-01-11T09:34:53Z

Models

Wyrfel at 00:16, 11 January 2006

2006-01-11T00:16:48Z

Wyrfel: /* Battery charge control features */

2006-01-11T00:07:43Z

‎Battery charge control features

Wyrfel at 00:07, 11 January 2006

2006-01-11T00:07:10Z

Thinker: /* Battery charge control features */

2006-01-10T16:03:52Z

‎Battery charge control features

Thinker at 15:43, 10 January 2006

2006-01-10T15:43:34Z

@@ Line 4: / Line 4: @@
 The SMAPI interfaces has mutated between models and is poorly documented, so Linux support is not exhaustive for most models. There are currently two SMAPI access mechanisms available:
 *[[tp_smapi]] for newer ThinkPad models. This module provides battery information for models produced since 2001 and possibly earlier, and additional features for models produced since 2003.
-*[[tpctl]] with the <tt>thinkpad</tt> kernel module for older ThinkPad models (on modern models, this is mostly superceded by the standardized ACPI interface).
+*[[tpctl]] with the <tt>thinkpad</tt> kernel modules worked on older ThinkPad models but are now obsolete: the drivers no longer build (with the latest Linux versions). On modern ThinkPads tpctl has been superseded by the standardized ACPI subsystem and the tp_smapi driver.
 [[Category:Tools]] [[Category:Patches]]

@@ Line 3: / Line 3: @@
 The SMAPI interfaces has mutated between models and is poorly documented, so Linux support is not exhaustive for most models. There are currently two SMAPI access mechanisms available:
-*[[tp_smapi]] for newer ThinkPad models (extended battery information for models produced since 2001 and possibly earlier; additional features for models produced since 2003)
+*[[tp_smapi]] for newer ThinkPad models. This module provides battery information for models produced since 2001 and possibly earlier, and additional features for models produced since 2003.
-*[[tpctl]] (with the <tt>thinkpad</tt> kernel module) for older ThinkPad models (mostly superceded by ACPI, when available)
+*[[tpctl]] with the <tt>thinkpad</tt> kernel module for older ThinkPad models (on modern models, this is mostly superceded by the standardized ACPI interface).
 [[Category:Tools]] [[Category:Patches]]

@@ Line 1: / Line 1: @@
 ThinkPad laptops include a proprietary interface called SMAPI BIOS (System Management Application Program Interface) which provides some
-hardware control functionality that is not exposed by any other interface (e.g., ACPI).
+hardware control functionality that is not exposed by standard interfaces such as ACPI and APM.
 The SMAPI interfaces has mutated between models and is poorly documented, so Linux support is not exhaustive for most models. There are currently two SMAPI access mechanisms available:

@@ Line 5: / Line 5: @@
 The SMAPI interfaces has mutated between models and is poorly documented, so Linux support is not exhaustive for most models. There are currently two SMAPI access mechanisms available:
-*<tt>thinkpad</tt> and <tt>tpctl</tt> for older ThinkPads
+*<tt>thinkpad</tt> and <tt>tpctl</tt> for older ThinkPads (mostly superceded by ACPI, when available)
-*<tt>tp_smapi</tt> for newer ones (since about R5x, T4x, X4x)
+*<tt>tp_smapi</tt> for newer ones (extended battery information for models produced since 2001 and possibly earlier; additional features for models produced since 2003)
 |}

@@ Line 1: / Line 1: @@
-ThinkPad laptops include a proprietary interface called SMAPI BIOS (System Management Application Program Interface) which provides some
+{| width="100%"
 hardware control functionality that is not exposed by any other interface (e.g., ACPI).
 The SMAPI interfaces has mutated between models and is poorly documented, so Linux support is not exhaustive for most models. There are currently two SMAPI access mechanisms available:
 *<tt>thinkpad</tt> and <tt>tpctl</tt> for older ThinkPads
-*<tt>tp_smapi</tt> for newer ones
+*<tt>tp_smapi</tt> for newer ones (since about R5x, T4x, X4x)
 ==Using the <tt>tp_smapi</tt> module==

@@ Line 47: / Line 47: @@
 To unconditionally inhibit charging for 17 minutes:
 :{{cmdroot|echo 17 > /sys/devices/platform/smapi/BAT0/inhibit_charge_minutes}}
-{{HINT|Charge inhibiting can be used to reduce the power draw of the laptop, in order to use a an under-spec power supply that can't handle the combined power draw of running and charging. It can also be used to control which battery is charged when [[using an Ultrabay battery]].}}
+{{HINT|Charge inhibiting can be used to reduce the power draw of the laptop, in order to use a an under-spec power supply that can't handle the combined power draw of running and charging. It can also be used to control which battery is charged when [[How to use UltraBay batteries|using an Ultrabay battery]].}}
 To cancel charge inhibiting:

@@ Line 54: / Line 54: @@
 To force battery discharging even if connected to AC, use one of these:
 :{{cmdroot|echo 1 > /sys/devices/platform/smapi/BAT0/force_discharge1}}
-{{HINT|This can be used to choose which battery is discharged when [[using an Ultrabay battery]].}}
+{{HINT|This can be used to choose which battery is discharged when [[How to use UltraBay batteries|using an UltraBay battery]].}}
 To cancel forced discharge, use one of these:

@@ Line 92: / Line 92: @@
 In all of the above, replace <tt>BAT0</tt> with <tt>BAT1</tt> to address the 2nd battery.
-Note that the battery status readout conflicts with the stock [[HDAPS|hdaps]] driver, so if you use <tt>hdaps</tt> you will need to load <tt>tp_smapi</tt> using {{cmdroot|1=make load HDAPS=1}} (see below).
+Note that the battery status readout conflicts with the stock [[HDAPS|hdaps]] driver, so if you use <tt>hdaps</tt> you will need to load <tt>tp_smapi</tt> using {{cmdroot|1=make load HDAPS=1}} (see [[#Conflict_with_hdaps|Conflict with hdaps]] below).
 ===Optical drive control features===
 To control the speed of the optical drive:
-:{{cmdroot|echo 0 yes_crash_my_computer > /sys/devices/platform/smapi/cd_speed # slow}}
+:{{cmdroot|echo 0 > /sys/devices/platform/smapi/cd_speed # slow}}
-:{{cmdroot|echo 1 yes_crash_my_computer > /sys/devices/platform/smapi/cd_speed # medium}}
+:{{cmdroot|echo 1 > /sys/devices/platform/smapi/cd_speed # medium}}
-:{{cmdroot|echo 2 yes_crash_my_computer > /sys/devices/platform/smapi/cd_speed # fast}}
+:{{cmdroot|echo 2 > /sys/devices/platform/smapi/cd_speed # fast}}
 :{{cmdroot|cat /sys/devices/platform/smapi/cd_speed}}
-{{WARN|Changing the drive speed when a disc is being accessed will hang your computer. This feature is thus '''disabled by default''', but can be enabled using by adding <tt>#define PROVIDE_CD_SPEED</tt> at the top of <tt>tp_smapi.c</tt>. The safe way to set the drive speed is using <tt>hdparm -E num</tt> or <tt>eject -x num</tt> for CD-ROM, and <tt>speedcontrol -x num</tt> (sourcecode [http://safari.iki.fi/speedcontrol.c here]) for DVD. For kernels older than 2.6.15, this may require the [[Problems_with_SATA_and_Linux#No_SMART_support libata pass-through|libata pass-through patch]].}}
 ===Other features===
@@ Line 128: / Line 130: @@
 !           <tt>stop_charge_<br />thresh</tt>
 !                      <tt>inhbit_charge_<br />minutes</tt>
-!                                  <tt>cd_speed</tt><br \><font size="-2">(see note above)</font>
+!                                  <tt>cd_speed</tt><br \><font size="-2">(see [[#Enabling_this_feature|note] above)</font>
 !                                                <tt>force_<br />discharge1</tt>
 !                                                           <tt>force_<br />discharge2</tt>
@@ Line 192: / Line 194: @@
 Please update the above and report your experience on the [[Talk:SMAPI support for Linux|discussion]] page. If the module loads but gives a "<tt>not supported</tt>" or "<tt>not implementeded</tt>" when you try to use some specific file in {{path|/sys/devices/platform/smapi/}}, please report the <tt>dmesg</tt> output and whether the corresponding functionality is available under Windows - maybe your ThinkPad just can't do that.
 ==Using the <tt>thinkpad</tt> module==