1 files changed, 11 insertions, 60 deletions
diff --git a/Documentation/laptops/thinkpad-acpi.txt b/Documentation/laptops/thinkpad-acpi.txt
index fc15538d8b46..f6f80257addb 100644
--- a/Documentation/laptops/thinkpad-acpi.txt
+++ b/Documentation/laptops/thinkpad-acpi.txt
@@ -960,70 +960,21 @@ Sysfs notes:
        subsystem, and follow all of the hwmon guidelines at
        Documentation/hwmon.
+EXPERIMENTAL: Embedded controller register dump
+-----------------------------------------------
-EXPERIMENTAL: Embedded controller register dump -- /proc/acpi/ibm/ecdump
+This feature is not included in the thinkpad driver anymore.
------------------------------------------------------------------------
+Instead the EC can be accessed through /sys/kernel/debug/ec with
+a userspace tool which can be found here:
-This feature is marked EXPERIMENTAL because the implementation
+ftp://ftp.suse.com/pub/people/trenn/sources/ec
-directly accesses hardware registers and may not work as expected. USE
-WITH CAUTION! To use this feature, you need to supply the
-experimental=1 parameter when loading the module.
-This feature dumps the values of 256 embedded controller
-registers. Values which have changed since the last time the registers
-were dumped are marked with a star:
-[root@x40 ibm-acpi]# cat /proc/acpi/ibm/ecdump
-EC       +00 +01 +02 +03 +04 +05 +06 +07 +08 +09 +0a +0b +0c +0d +0e +0f
-EC 0x00:  a7  47  87  01  fe  96  00  08  01  00  cb  00  00  00  40  00
-EC 0x10:  00  00  ff  ff  f4  3c  87  09  01  ff  42  01  ff  ff  0d  00
-EC 0x20:  00  00  00  00  00  00  00  00  00  00  00  03  43  00  00  80
-EC 0x30:  01  07  1a  00  30  04  00  00 *85  00  00  10  00  50  00  00
-EC 0x40:  00  00  00  00  00  00  14  01  00  04  00  00  00  00  00  00
-EC 0x50:  00  c0  02  0d  00  01  01  02  02  03  03  03  03 *bc *02 *bc
-EC 0x60: *02 *bc *02  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0x70:  00  00  00  00  00  12  30  40 *24 *26 *2c *27 *20  80 *1f  80
-EC 0x80:  00  00  00  06 *37 *0e  03  00  00  00  0e  07  00  00  00  00
-EC 0x90:  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0xa0: *ff  09  ff  09  ff  ff *64  00 *00 *00 *a2  41 *ff *ff *e0  00
-EC 0xb0:  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0xc0:  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0xd0:  03  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0xe0:  00  00  00  00  00  00  00  00  11  20  49  04  24  06  55  03
-EC 0xf0:  31  55  48  54  35  38  57  57  08  2f  45  73  07  65  6c  1a
-This feature can be used to determine the register holding the fan
-speed on some models. To do that, do the following:
+Use it to determine the register holding the fan
+speed on some models. To do that, do the following:
        - make sure the battery is fully charged
        - make sure the fan is running
-        - run 'cat /proc/acpi/ibm/ecdump' several times, once per second or so
+        - use above mentioned tool to read out the EC
-The first step makes sure various charging-related values don't
+Often fan and temperature values vary between
-vary. The second ensures that the fan-related values do vary, since
-the fan speed fluctuates a bit. The third will (hopefully) mark the
-fan register with a star:
-[root@x40 ibm-acpi]# cat /proc/acpi/ibm/ecdump
-EC       +00 +01 +02 +03 +04 +05 +06 +07 +08 +09 +0a +0b +0c +0d +0e +0f
-EC 0x00:  a7  47  87  01  fe  96  00  08  01  00  cb  00  00  00  40  00
-EC 0x10:  00  00  ff  ff  f4  3c  87  09  01  ff  42  01  ff  ff  0d  00
-EC 0x20:  00  00  00  00  00  00  00  00  00  00  00  03  43  00  00  80
-EC 0x30:  01  07  1a  00  30  04  00  00  85  00  00  10  00  50  00  00
-EC 0x40:  00  00  00  00  00  00  14  01  00  04  00  00  00  00  00  00
-EC 0x50:  00  c0  02  0d  00  01  01  02  02  03  03  03  03  bc  02  bc
-EC 0x60:  02  bc  02  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0x70:  00  00  00  00  00  12  30  40  24  27  2c  27  21  80  1f  80
-EC 0x80:  00  00  00  06 *be  0d  03  00  00  00  0e  07  00  00  00  00
-EC 0x90:  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0xa0:  ff  09  ff  09  ff  ff  64  00  00  00  a2  41  ff  ff  e0  00
-EC 0xb0:  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0xc0:  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0xd0:  03  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00
-EC 0xe0:  00  00  00  00  00  00  00  00  11  20  49  04  24  06  55  03
-EC 0xf0:  31  55  48  54  35  38  57  57  08  2f  45  73  07  65  6c  1a
-Another set of values that varies often is the temperature
 readings. Since temperatures don't change vary fast, you can take
 several quick dumps to eliminate them.

diff --git a/Documentation/laptops/thinkpad-acpi.txt b/Documentation/laptops/thinkpad-acpi.txt index fc15538d8b46..f6f80257addb 100644 --- a/Documentation/laptops/thinkpad-acpi.txt +++ b/Documentation/laptops/thinkpad-acpi.txt
@@ -960,70 +960,21 @@ Sysfs notes:
960	subsystem, and follow all of the hwmon guidelines at	960	subsystem, and follow all of the hwmon guidelines at
961	Documentation/hwmon.	961	Documentation/hwmon.
962		962
		963	EXPERIMENTAL: Embedded controller register dump
		964	-----------------------------------------------
963		965
964	EXPERIMENTAL: Embedded controller register dump -- /proc/acpi/ibm/ecdump	966	This feature is not included in the thinkpad driver anymore.
965	------------------------------------------------------------------------	967	Instead the EC can be accessed through /sys/kernel/debug/ec with
966		968	a userspace tool which can be found here:
967	This feature is marked EXPERIMENTAL because the implementation	969	ftp://ftp.suse.com/pub/people/trenn/sources/ec
968	directly accesses hardware registers and may not work as expected. USE
969	WITH CAUTION! To use this feature, you need to supply the
970	experimental=1 parameter when loading the module.
971
972	This feature dumps the values of 256 embedded controller
973	registers. Values which have changed since the last time the registers
974	were dumped are marked with a star:
975
976	[root@x40 ibm-acpi]# cat /proc/acpi/ibm/ecdump
977	EC +00 +01 +02 +03 +04 +05 +06 +07 +08 +09 +0a +0b +0c +0d +0e +0f
978	EC 0x00: a7 47 87 01 fe 96 00 08 01 00 cb 00 00 00 40 00
979	EC 0x10: 00 00 ff ff f4 3c 87 09 01 ff 42 01 ff ff 0d 00
980	EC 0x20: 00 00 00 00 00 00 00 00 00 00 00 03 43 00 00 80
981	EC 0x30: 01 07 1a 00 30 04 00 00 *85 00 00 10 00 50 00 00
982	EC 0x40: 00 00 00 00 00 00 14 01 00 04 00 00 00 00 00 00
983	EC 0x50: 00 c0 02 0d 00 01 01 02 02 03 03 03 03 bc 02 *bc
984	EC 0x60: 02 bc *02 00 00 00 00 00 00 00 00 00 00 00 00 00
985	EC 0x70: 00 00 00 00 00 12 30 40 24 26 2c 27 20 80 1f 80
986	EC 0x80: 00 00 00 06 37 0e 03 00 00 00 0e 07 00 00 00 00
987	EC 0x90: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
988	EC 0xa0: ff 09 ff 09 ff ff 64 00 00 00 a2 41 ff ff e0 00
989	EC 0xb0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
990	EC 0xc0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
991	EC 0xd0: 03 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
992	EC 0xe0: 00 00 00 00 00 00 00 00 11 20 49 04 24 06 55 03
993	EC 0xf0: 31 55 48 54 35 38 57 57 08 2f 45 73 07 65 6c 1a
994
995	This feature can be used to determine the register holding the fan
996	speed on some models. To do that, do the following:
997		970
		971	Use it to determine the register holding the fan
		972	speed on some models. To do that, do the following:
998	- make sure the battery is fully charged	973	- make sure the battery is fully charged
999	- make sure the fan is running	974	- make sure the fan is running
1000	- run 'cat /proc/acpi/ibm/ecdump' several times, once per second or so	975	- use above mentioned tool to read out the EC
1001		976
1002	The first step makes sure various charging-related values don't	977	Often fan and temperature values vary between
1003	vary. The second ensures that the fan-related values do vary, since
1004	the fan speed fluctuates a bit. The third will (hopefully) mark the
1005	fan register with a star:
1006
1007	[root@x40 ibm-acpi]# cat /proc/acpi/ibm/ecdump
1008	EC +00 +01 +02 +03 +04 +05 +06 +07 +08 +09 +0a +0b +0c +0d +0e +0f
1009	EC 0x00: a7 47 87 01 fe 96 00 08 01 00 cb 00 00 00 40 00
1010	EC 0x10: 00 00 ff ff f4 3c 87 09 01 ff 42 01 ff ff 0d 00
1011	EC 0x20: 00 00 00 00 00 00 00 00 00 00 00 03 43 00 00 80
1012	EC 0x30: 01 07 1a 00 30 04 00 00 85 00 00 10 00 50 00 00
1013	EC 0x40: 00 00 00 00 00 00 14 01 00 04 00 00 00 00 00 00
1014	EC 0x50: 00 c0 02 0d 00 01 01 02 02 03 03 03 03 bc 02 bc
1015	EC 0x60: 02 bc 02 00 00 00 00 00 00 00 00 00 00 00 00 00
1016	EC 0x70: 00 00 00 00 00 12 30 40 24 27 2c 27 21 80 1f 80
1017	EC 0x80: 00 00 00 06 *be 0d 03 00 00 00 0e 07 00 00 00 00
1018	EC 0x90: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
1019	EC 0xa0: ff 09 ff 09 ff ff 64 00 00 00 a2 41 ff ff e0 00
1020	EC 0xb0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
1021	EC 0xc0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
1022	EC 0xd0: 03 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
1023	EC 0xe0: 00 00 00 00 00 00 00 00 11 20 49 04 24 06 55 03
1024	EC 0xf0: 31 55 48 54 35 38 57 57 08 2f 45 73 07 65 6c 1a
1025
1026	Another set of values that varies often is the temperature
1027	readings. Since temperatures don't change vary fast, you can take	978	readings. Since temperatures don't change vary fast, you can take
1028	several quick dumps to eliminate them.	979	several quick dumps to eliminate them.
1029		980