ibm-acpi: Remove experimental flag from brightness and volume. Update documentation
Subsystems (2)
cover ibm-acpi: Remove experimental flag from brightness and volume. Update documentation
Hello Borislav.
Since version 0.11 ecdump, brightness, volume and fan a available in ibm-acpi, but only if you set experimental=1 on loading.
You released this version at 2005-03-17. So this is quit some time to see if some of these features make problems.
I think it's ok to make ecdump and fan only available, if loaded with experimental. As ecdump is only for debugging and explore new features and fan stop can damage the hardware.
Both features were tested with various scripts and application for a long time without problems.
Second patch updates the documentation for the first patch.
Third one documents the new wan feature from Jeremy Fitzhardinge. Please review this, as I don't have a device to test this.
Please apply.
regards
Stefan Schmidt
--
Signature · 2 lines
The linux-thinkpad mailing list home page is at: http://mailman.linux-thinkpad.org/mailman/listinfo/linux-thinkpad
PATCH 1/3 ibm-acpi: Get rid of experimental status for brightness and volume.
The brightness and volume features from ibm-acpi are stable. The experimental flag is no more needed.
---
drivers/acpi/ibm_acpi.c +0 -2
@@ -1702,13 +1702,11 @@ .name = "brightness", .read = brightness_read, .write = brightness_write, - .experimental = 1, }, { .name = "volume", .read = volume_read, .write = volume_write, - .experimental = 1, }, { .name = "fan",
--
Signature · 2 lines
The linux-thinkpad mailing list home page is at: http://mailman.linux-thinkpad.org/mailman/listinfo/linux-thinkpad
Re: [Patch 1/3] ibm-acpi: Get rid of experimental status for brightness and volume.
Quoted 4 lines · Stefan Schmidt
The brightness and volume features from ibm-acpi are stable. The experimental flag is no more needed.
Signed-off-by Stefan Schmidt <[email protected]>
Looks good to me. Len, please apply.
drivers/acpi/ibm_acpi.c +0 -2
@@ -1702,13 +1702,11 @@ .name = "brightness", .read = brightness_read, .write = brightness_write, - .experimental = 1, }, { .name = "volume", .read = volume_read, .write = volume_write, - .experimental = 1, }, { .name = "fan",
PATCH 2/3 ibm-acpi: Update documentation for brightness and volume.
In reply to Stefan SchmidtDocument the change of the experimental flag for brightness and volume.
---
Documentation/ibm-acpi.txt +6 -16
@@ -30,8 +30,8 @@ - ACPI sounds - temperature sensors - Experimental: embedded controller register dump - - Experimental: LCD brightness control - - Experimental: volume control + - LCD brightness control + - Volume control - Experimental: fan speed, fan enable/disable A compatibility table by model and feature is maintained on the web
@@ -523,13 +523,8 @@ with this, do send me your results (including some complete dumps with a description of the conditions when they were taken.) -EXPERIMENTAL: LCD brightness control -- /proc/acpi/ibm/brightness ------------------------------------------------------------------ - -This feature is marked EXPERIMENTAL because the implementation -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. +LCD brightness control -- /proc/acpi/ibm/brightness +--------------------------------------------------- This feature allows software control of the LCD brightness on ThinkPad models which don't have a hardware brightness slider. The available
@@ -542,13 +537,8 @@ The <level> number range is 0 to 7, although not all of them may be distinct. The current brightness level is shown in the file. -EXPERIMENTAL: Volume control -- /proc/acpi/ibm/volume ------------------------------------------------------ - -This feature is marked EXPERIMENTAL because the implementation -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. +Volume control -- /proc/acpi/ibm/volume +--------------------------------------- This feature allows volume control on ThinkPad models which don't have a hardware volume knob. The available commands are:
--
Signature · 2 lines
The linux-thinkpad mailing list home page is at: http://mailman.linux-thinkpad.org/mailman/listinfo/linux-thinkpad
Re: [Patch 2/3] ibm-acpi: Update documentation for brightness and volume.
Quoted 3 lines · Stefan Schmidt
Document the change of the experimental flag for brightness and volume.
Signed-off-by Stefan Schmidt <[email protected]>
Looks good to me. Len, please apply.
Borislav
Documentation/ibm-acpi.txt +6 -16
@@ -30,8 +30,8 @@ - ACPI sounds - temperature sensors - Experimental: embedded controller register dump - - Experimental: LCD brightness control - - Experimental: volume control + - LCD brightness control + - Volume control - Experimental: fan speed, fan enable/disable A compatibility table by model and feature is maintained on the web
@@ -523,13 +523,8 @@ with this, do send me your results (including some complete dumps with a description of the conditions when they were taken.) -EXPERIMENTAL: LCD brightness control -- /proc/acpi/ibm/brightness ------------------------------------------------------------------ - -This feature is marked EXPERIMENTAL because the implementation -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. +LCD brightness control -- /proc/acpi/ibm/brightness +--------------------------------------------------- This feature allows software control of the LCD brightness on ThinkPad models which don't have a hardware brightness slider. The available
@@ -542,13 +537,8 @@ The <level> number range is 0 to 7, although not all of them may be distinct. The current brightness level is shown in the file. -EXPERIMENTAL: Volume control -- /proc/acpi/ibm/volume ------------------------------------------------------ - -This feature is marked EXPERIMENTAL because the implementation -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. +Volume control -- /proc/acpi/ibm/volume +--------------------------------------- This feature allows volume control on ThinkPad models which don't have a hardware volume knob. The available commands are:
PATCH 3/3 ibm-acpi: Add documentation for wan feature.
In reply to Stefan SchmidtDocument the wan feature Jeremy Fitzhardinge added to ibm-acpi.
---
Documentation/ibm-acpi.txt +18 -0
@@ -33,6 +33,7 @@ - LCD brightness control - Volume control - Experimental: fan speed, fan enable/disable + - Experimental: WAN enable and disable A compatibility table by model and feature is maintained on the web site, http://ibm-acpi.sf.net/. I appreciate any success or failure
@@ -601,6 +602,23 @@ echo 'level <level>' > /proc/acpi/ibm/thermal +EXPERIMENTAL: WAN -- /proc/acpi/ibm/wan +--------------------------------------- + +This feature is marked EXPERIMENTAL because the implementation +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 shows the presence and current state of a WAN (Sierra +Wireless EV-DO) device. If WAN is installed, the following commands can +be used: + + echo enable > /proc/acpi/ibm/wan + echo disable > /proc/acpi/ibm/wan + +It was tested on a Lenovo Thinkpad X60. It should probably work on other +Thinkpad models which come with this module installed. Multiple Commands, Module Parameters ------------------------------------
--
Signature · 2 lines
The linux-thinkpad mailing list home page is at: http://mailman.linux-thinkpad.org/mailman/listinfo/linux-thinkpad
Re: [Patch 3/3] ibm-acpi: Add documentation for wan feature.
Quoted 3 lines · Stefan Schmidt
Document the wan feature Jeremy Fitzhardinge added to ibm-acpi.
Signed-off-by Stefan Schmidt <[email protected]>
Looks good to me. Len, please apply.
Borislav
Documentation/ibm-acpi.txt +18 -0
@@ -33,6 +33,7 @@ - LCD brightness control - Volume control - Experimental: fan speed, fan enable/disable + - Experimental: WAN enable and disable A compatibility table by model and feature is maintained on the web site, http://ibm-acpi.sf.net/. I appreciate any success or failure
@@ -601,6 +602,23 @@ echo 'level <level>' > /proc/acpi/ibm/thermal +EXPERIMENTAL: WAN -- /proc/acpi/ibm/wan +--------------------------------------- + +This feature is marked EXPERIMENTAL because the implementation +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 shows the presence and current state of a WAN (Sierra +Wireless EV-DO) device. If WAN is installed, the following commands can +be used: + + echo enable > /proc/acpi/ibm/wan + echo disable > /proc/acpi/ibm/wan + +It was tested on a Lenovo Thinkpad X60. It should probably work on other +Thinkpad models which come with this module installed. Multiple Commands, Module Parameters ------------------------------------
Hello Len.
Quoted 11 lines · Stefan Schmidt
Since version 0.11 ecdump, brightness, volume and fan a available in ibm-acpi, but only if you set experimental=1 on loading.
You released this version at 2005-03-17. So this is quit some time to see if some of these features make problems.
I think it's ok to make ecdump and fan only available, if loaded with experimental. As ecdump is only for debugging and explore new features and fan stop can damage the hardware.
Quoted 7 lines
Both features were tested with various scripts and application for a long time without problems.
Second patch updates the documentation for the first patch.
Third one documents the new wan feature from Jeremy Fitzhardinge. Please review this, as I don't have a device to test this.
Any comments about this patches?
The first try of the first patch I sent to Borislav at 2006-08-24, only linux-thinkpad cc'ed this time:
http://marc.theaimsgroup.com/?l=linux-thinkpad&m=115643103426795&w=2
Unfortunately it is not the first time Borislav don't reply on patches. What's the way to go here?
regards
Stefan Schmidt
I've applied 1-3.
Note, however, that the long-term direction is to make these features available under generic sysfs interfaces, rather than under /proc/acpi.
thanks,
-Len