* [PATCH 1/5] Documentation - Create laptops sub-directory
2008-02-09 1:31 [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
@ 2008-02-09 1:32 ` Carlos Corbacho
2008-02-09 1:32 ` [PATCH 3/5] sony-laptop - Move sony-laptop.txt to Documentation/laptops Carlos Corbacho
` (5 subsequent siblings)
6 siblings, 0 replies; 16+ messages in thread
From: Carlos Corbacho @ 2008-02-09 1:32 UTC (permalink / raw)
To: linux-acpi
Cc: Carlos Corbacho, Randy Dunlap, Henrique de Moraes Holschuh,
Mattia Dongili, Len Brown
There are currently various laptop drivers floating about with no central
place for their documentation, which is currently scattered around the top
level Documentation/ directory.
So, as a first step, lets create a Documentation sub-directory, and update
the relevant index files. The work of then moving the existing laptop
driver related documentation will then be handled later.
Signed-off-by: Carlos Corbacho <carlos@strangeworlds.co.uk>
CC: Randy Dunlap <randy.dunlap@oracle.com>
CC: Henrique de Moraes Holschuh <hmh@hmh.eng.br>
CC: Mattia Dongili <malattia@linux.it>
CC: Len Brown <lenb@kernel.org>
---
Documentation/00-INDEX | 2 ++
Documentation/laptops/00-INDEX | 2 ++
2 files changed, 4 insertions(+), 0 deletions(-)
create mode 100644 Documentation/laptops/00-INDEX
diff --git a/Documentation/00-INDEX b/Documentation/00-INDEX
index 6e9c405..3de34e5 100644
--- a/Documentation/00-INDEX
+++ b/Documentation/00-INDEX
@@ -227,6 +227,8 @@ kref.txt
- docs on adding reference counters (krefs) to kernel objects.
laptop-mode.txt
- how to conserve battery power using laptop-mode.
+laptops/
+ - directory with laptop related info and laptop driver documentation.
ldm.txt
- a brief description of LDM (Windows Dynamic Disks).
leds-class.txt
diff --git a/Documentation/laptops/00-INDEX b/Documentation/laptops/00-INDEX
new file mode 100644
index 0000000..2edb596
--- /dev/null
+++ b/Documentation/laptops/00-INDEX
@@ -0,0 +1,2 @@
+00-INDEX
+ - This file
^ permalink raw reply related [flat|nested] 16+ messages in thread* [PATCH 3/5] sony-laptop - Move sony-laptop.txt to Documentation/laptops
2008-02-09 1:31 [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
2008-02-09 1:32 ` [PATCH 1/5] Documentation - Create laptops sub-directory Carlos Corbacho
@ 2008-02-09 1:32 ` Carlos Corbacho
2008-02-09 1:32 ` [PATCH 4/5] sonypi - Move sonypi.txt " Carlos Corbacho
` (4 subsequent siblings)
6 siblings, 0 replies; 16+ messages in thread
From: Carlos Corbacho @ 2008-02-09 1:32 UTC (permalink / raw)
To: linux-acpi; +Cc: Carlos Corbacho, Len Brown, Randy Dunlap, Mattia Dongili
Also update references to sony-laptop.txt in Kconfig.
Signed-off-by: Carlos Corbacho <carlos@strangeworlds.co.uk>
CC: Len Brown <lenb@kernel.org>
CC: Randy Dunlap <randy.dunlap@oracle.com>
CC: Mattia Dongili <malattia@linux.it>
---
Documentation/00-INDEX | 2 -
Documentation/laptops/00-INDEX | 2 +
Documentation/laptops/sony-laptop.txt | 117 +++++++++++++++++++++++++++++++++
Documentation/sony-laptop.txt | 117 ---------------------------------
drivers/misc/Kconfig | 2 -
5 files changed, 120 insertions(+), 120 deletions(-)
create mode 100644 Documentation/laptops/sony-laptop.txt
delete mode 100644 Documentation/sony-laptop.txt
diff --git a/Documentation/00-INDEX b/Documentation/00-INDEX
index d69b2a3..012ef98 100644
--- a/Documentation/00-INDEX
+++ b/Documentation/00-INDEX
@@ -353,8 +353,6 @@ sh/
- directory with info on porting Linux to a new architecture.
smart-config.txt
- description of the Smart Config makefile feature.
-sony-laptop.txt
- - Sony Notebook Control Driver (SNC) Readme.
sonypi.txt
- info on Linux Sony Programmable I/O Device support.
sound/
diff --git a/Documentation/laptops/00-INDEX b/Documentation/laptops/00-INDEX
index e806b08..c5bac77 100644
--- a/Documentation/laptops/00-INDEX
+++ b/Documentation/laptops/00-INDEX
@@ -1,4 +1,6 @@
00-INDEX
- This file
+sony-laptop.txt
+ - Sony Notebook Control Driver (SNC) Readme.
thinkpad-acpi.txt
- information on the (IBM and Lenovo) ThinkPad ACPI Extras driver.
diff --git a/Documentation/laptops/sony-laptop.txt b/Documentation/laptops/sony-laptop.txt
new file mode 100644
index 0000000..7a5c1a8
--- /dev/null
+++ b/Documentation/laptops/sony-laptop.txt
@@ -0,0 +1,117 @@
+Sony Notebook Control Driver (SNC) Readme
+-----------------------------------------
+ Copyright (C) 2004- 2005 Stelian Pop <stelian@popies.net>
+ Copyright (C) 2007 Mattia Dongili <malattia@linux.it>
+
+This mini-driver drives the SNC and SPIC device present in the ACPI BIOS of the
+Sony Vaio laptops. This driver mixes both devices functions under the same
+(hopefully consistent) interface. This also means that the sonypi driver is
+obsoleted by sony-laptop now.
+
+Fn keys (hotkeys):
+------------------
+Some models report hotkeys through the SNC or SPIC devices, such events are
+reported both through the ACPI subsystem as acpi events and through the INPUT
+subsystem. See the logs of acpid or /proc/acpi/event and
+/proc/bus/input/devices to find out what those events are and which input
+devices are created by the driver.
+
+Backlight control:
+------------------
+If your laptop model supports it, you will find sysfs files in the
+/sys/class/backlight/sony/
+directory. You will be able to query and set the current screen
+brightness:
+ brightness get/set screen brightness (an iteger
+ between 0 and 7)
+ actual_brightness reading from this file will query the HW
+ to get real brightness value
+ max_brightness the maximum brightness value
+
+
+Platform specific:
+------------------
+Loading the sony-laptop module will create a
+/sys/devices/platform/sony-laptop/
+directory populated with some files.
+
+You then read/write integer values from/to those files by using
+standard UNIX tools.
+
+The files are:
+ brightness_default screen brightness which will be set
+ when the laptop will be rebooted
+ cdpower power on/off the internal CD drive
+ audiopower power on/off the internal sound card
+ lanpower power on/off the internal ethernet card
+ (only in debug mode)
+ bluetoothpower power on/off the internal bluetooth device
+ fanspeed get/set the fan speed
+
+Note that some files may be missing if they are not supported
+by your particular laptop model.
+
+Example usage:
+ # echo "1" > /sys/devices/platform/sony-laptop/brightness_default
+sets the lowest screen brightness for the next and later reboots,
+ # echo "8" > /sys/devices/platform/sony-laptop/brightness_default
+sets the highest screen brightness for the next and later reboots,
+ # cat /sys/devices/platform/sony-laptop/brightness_default
+retrieves the value.
+
+ # echo "0" > /sys/devices/platform/sony-laptop/audiopower
+powers off the sound card,
+ # echo "1" > /sys/devices/platform/sony-laptop/audiopower
+powers on the sound card.
+
+Development:
+------------
+
+If you want to help with the development of this driver (and
+you are not afraid of any side effects doing strange things with
+your ACPI BIOS could have on your laptop), load the driver and
+pass the option 'debug=1'.
+
+REPEAT: DON'T DO THIS IF YOU DON'T LIKE RISKY BUSINESS.
+
+In your kernel logs you will find the list of all ACPI methods
+the SNC device has on your laptop. You can see the GCDP/GCDP methods
+used to pwer on/off the CD drive, but there are others.
+
+I HAVE NO IDEA WHAT THOSE METHODS DO.
+
+The sony-laptop driver creates, for some of those methods (the most
+current ones found on several Vaio models), an entry under
+/sys/devices/platform/sony-laptop, just like the 'cdpower' one.
+You can create other entries corresponding to your own laptop methods by
+further editing the source (see the 'sony_nc_values' table, and add a new
+entry to this table with your get/set method names using the
+SNC_HANDLE_NAMES macro).
+
+Your mission, should you accept it, is to try finding out what
+those entries are for, by reading/writing random values from/to those
+files and find out what is the impact on your laptop.
+
+Should you find anything interesting, please report it back to me,
+I will not disavow all knowledge of your actions :)
+
+See also http://www.linux.it/~malattia/wiki/index.php/Sony_drivers for other
+useful info.
+
+Bugs/Limitations:
+-----------------
+
+* This driver is not based on official documentation from Sony
+ (because there is none), so there is no guarantee this driver
+ will work at all, or do the right thing. Although this hasn't
+ happened to me, this driver could do very bad things to your
+ laptop, including permanent damage.
+
+* The sony-laptop and sonypi drivers do not interact at all. In the
+ future, sonypi could use sony-laptop to do (part of) its business.
+
+* spicctrl, which is the userspace tool used to communicate with the
+ sonypi driver (through /dev/sonypi) does not try to use the
+ sony-laptop driver. In the future, spicctrl could try sonypi first,
+ and if it isn't present, try sony-laptop instead.
+
diff --git a/Documentation/sony-laptop.txt b/Documentation/sony-laptop.txt
deleted file mode 100644
index 7a5c1a8..0000000
--- a/Documentation/sony-laptop.txt
+++ /dev/null
@@ -1,117 +0,0 @@
-Sony Notebook Control Driver (SNC) Readme
------------------------------------------
- Copyright (C) 2004- 2005 Stelian Pop <stelian@popies.net>
- Copyright (C) 2007 Mattia Dongili <malattia@linux.it>
-
-This mini-driver drives the SNC and SPIC device present in the ACPI BIOS of the
-Sony Vaio laptops. This driver mixes both devices functions under the same
-(hopefully consistent) interface. This also means that the sonypi driver is
-obsoleted by sony-laptop now.
-
-Fn keys (hotkeys):
-------------------
-Some models report hotkeys through the SNC or SPIC devices, such events are
-reported both through the ACPI subsystem as acpi events and through the INPUT
-subsystem. See the logs of acpid or /proc/acpi/event and
-/proc/bus/input/devices to find out what those events are and which input
-devices are created by the driver.
-
-Backlight control:
-------------------
-If your laptop model supports it, you will find sysfs files in the
-/sys/class/backlight/sony/
-directory. You will be able to query and set the current screen
-brightness:
- brightness get/set screen brightness (an iteger
- between 0 and 7)
- actual_brightness reading from this file will query the HW
- to get real brightness value
- max_brightness the maximum brightness value
-
-
-Platform specific:
-------------------
-Loading the sony-laptop module will create a
-/sys/devices/platform/sony-laptop/
-directory populated with some files.
-
-You then read/write integer values from/to those files by using
-standard UNIX tools.
-
-The files are:
- brightness_default screen brightness which will be set
- when the laptop will be rebooted
- cdpower power on/off the internal CD drive
- audiopower power on/off the internal sound card
- lanpower power on/off the internal ethernet card
- (only in debug mode)
- bluetoothpower power on/off the internal bluetooth device
- fanspeed get/set the fan speed
-
-Note that some files may be missing if they are not supported
-by your particular laptop model.
-
-Example usage:
- # echo "1" > /sys/devices/platform/sony-laptop/brightness_default
-sets the lowest screen brightness for the next and later reboots,
- # echo "8" > /sys/devices/platform/sony-laptop/brightness_default
-sets the highest screen brightness for the next and later reboots,
- # cat /sys/devices/platform/sony-laptop/brightness_default
-retrieves the value.
-
- # echo "0" > /sys/devices/platform/sony-laptop/audiopower
-powers off the sound card,
- # echo "1" > /sys/devices/platform/sony-laptop/audiopower
-powers on the sound card.
-
-Development:
-------------
-
-If you want to help with the development of this driver (and
-you are not afraid of any side effects doing strange things with
-your ACPI BIOS could have on your laptop), load the driver and
-pass the option 'debug=1'.
-
-REPEAT: DON'T DO THIS IF YOU DON'T LIKE RISKY BUSINESS.
-
-In your kernel logs you will find the list of all ACPI methods
-the SNC device has on your laptop. You can see the GCDP/GCDP methods
-used to pwer on/off the CD drive, but there are others.
-
-I HAVE NO IDEA WHAT THOSE METHODS DO.
-
-The sony-laptop driver creates, for some of those methods (the most
-current ones found on several Vaio models), an entry under
-/sys/devices/platform/sony-laptop, just like the 'cdpower' one.
-You can create other entries corresponding to your own laptop methods by
-further editing the source (see the 'sony_nc_values' table, and add a new
-entry to this table with your get/set method names using the
-SNC_HANDLE_NAMES macro).
-
-Your mission, should you accept it, is to try finding out what
-those entries are for, by reading/writing random values from/to those
-files and find out what is the impact on your laptop.
-
-Should you find anything interesting, please report it back to me,
-I will not disavow all knowledge of your actions :)
-
-See also http://www.linux.it/~malattia/wiki/index.php/Sony_drivers for other
-useful info.
-
-Bugs/Limitations:
------------------
-
-* This driver is not based on official documentation from Sony
- (because there is none), so there is no guarantee this driver
- will work at all, or do the right thing. Although this hasn't
- happened to me, this driver could do very bad things to your
- laptop, including permanent damage.
-
-* The sony-laptop and sonypi drivers do not interact at all. In the
- future, sonypi could use sony-laptop to do (part of) its business.
-
-* spicctrl, which is the userspace tool used to communicate with the
- sonypi driver (through /dev/sonypi) does not try to use the
- sony-laptop driver. In the future, spicctrl could try sonypi first,
- and if it isn't present, try sony-laptop instead.
-
diff --git a/drivers/misc/Kconfig b/drivers/misc/Kconfig
index 5716d2e..e3c70cd 100644
--- a/drivers/misc/Kconfig
+++ b/drivers/misc/Kconfig
@@ -183,7 +183,7 @@ config SONY_LAPTOP
screen brightness control, Fn keys and allows powering on/off some
devices.
- Read <file:Documentation/sony-laptop.txt> for more information.
+ Read <file:Documentation/laptops/sony-laptop.txt> for more information.
config SONYPI_COMPAT
bool "Sonypi compatibility"
^ permalink raw reply related [flat|nested] 16+ messages in thread* [PATCH 4/5] sonypi - Move sonypi.txt to Documentation/laptops
2008-02-09 1:31 [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
2008-02-09 1:32 ` [PATCH 1/5] Documentation - Create laptops sub-directory Carlos Corbacho
2008-02-09 1:32 ` [PATCH 3/5] sony-laptop - Move sony-laptop.txt to Documentation/laptops Carlos Corbacho
@ 2008-02-09 1:32 ` Carlos Corbacho
2008-02-09 1:32 ` [PATCH 5/5] acer-wmi - Add documentation Carlos Corbacho
` (3 subsequent siblings)
6 siblings, 0 replies; 16+ messages in thread
From: Carlos Corbacho @ 2008-02-09 1:32 UTC (permalink / raw)
To: linux-acpi; +Cc: Carlos Corbacho, Randy Dunlap, Mattia Dongili, Len Brown
Also update references to sonypi.txt in Kconfig.
Signed-off-by: Carlos Corbacho <carlos@strangeworlds.co.uk>
CC: Randy Dunlap <randy.dunlap@oracle.com>
CC: Mattia Dongili <malattia@linux.it>
CC: Len Brown <lenb@kernel.org>
---
Documentation/00-INDEX | 2 -
Documentation/laptops/00-INDEX | 2 +
Documentation/laptops/sonypi.txt | 152 ++++++++++++++++++++++++++++++++++++++
Documentation/sonypi.txt | 152 --------------------------------------
drivers/char/Kconfig | 2 -
5 files changed, 155 insertions(+), 155 deletions(-)
create mode 100644 Documentation/laptops/sonypi.txt
delete mode 100644 Documentation/sonypi.txt
diff --git a/Documentation/00-INDEX b/Documentation/00-INDEX
index 012ef98..8d55670 100644
--- a/Documentation/00-INDEX
+++ b/Documentation/00-INDEX
@@ -353,8 +353,6 @@ sh/
- directory with info on porting Linux to a new architecture.
smart-config.txt
- description of the Smart Config makefile feature.
-sonypi.txt
- - info on Linux Sony Programmable I/O Device support.
sound/
- directory with info on sound card support.
sparc/
diff --git a/Documentation/laptops/00-INDEX b/Documentation/laptops/00-INDEX
index c5bac77..dbe1759 100644
--- a/Documentation/laptops/00-INDEX
+++ b/Documentation/laptops/00-INDEX
@@ -2,5 +2,7 @@
- This file
sony-laptop.txt
- Sony Notebook Control Driver (SNC) Readme.
+sonypi.txt
+ - info on Linux Sony Programmable I/O Device support.
thinkpad-acpi.txt
- information on the (IBM and Lenovo) ThinkPad ACPI Extras driver.
diff --git a/Documentation/laptops/sonypi.txt b/Documentation/laptops/sonypi.txt
new file mode 100644
index 0000000..4857acf
--- /dev/null
+++ b/Documentation/laptops/sonypi.txt
@@ -0,0 +1,152 @@
+Sony Programmable I/O Control Device Driver Readme
+--------------------------------------------------
+ Copyright (C) 2001-2004 Stelian Pop <stelian@popies.net>
+ Copyright (C) 2001-2002 Alcôve <www.alcove.com>
+ Copyright (C) 2001 Michael Ashley <m.ashley@unsw.edu.au>
+ Copyright (C) 2001 Junichi Morita <jun1m@mars.dti.ne.jp>
+ Copyright (C) 2000 Takaya Kinjo <t-kinjo@tc4.so-net.ne.jp>
+ Copyright (C) 2000 Andrew Tridgell <tridge@samba.org>
+
+This driver enables access to the Sony Programmable I/O Control Device which
+can be found in many Sony Vaio laptops. Some newer Sony laptops (seems to be
+limited to new FX series laptops, at least the FX501 and the FX702) lack a
+sonypi device and are not supported at all by this driver.
+
+It will give access (through a user space utility) to some events those laptops
+generate, like:
+ - jogdial events (the small wheel on the side of Vaios)
+ - capture button events (only on Vaio Picturebook series)
+ - Fn keys
+ - bluetooth button (only on C1VR model)
+ - programmable keys, back, help, zoom, thumbphrase buttons, etc.
+ (when available)
+
+Those events (see linux/sonypi.h) can be polled using the character device node
+/dev/sonypi (major 10, minor auto allocated or specified as a option).
+A simple daemon which translates the jogdial movements into mouse wheel events
+can be downloaded at: <http://popies.net/sonypi/>
+
+Another option to intercept the events is to get them directly through the
+input layer.
+
+This driver supports also some ioctl commands for setting the LCD screen
+brightness and querying the batteries charge information (some more
+commands may be added in the future).
+
+This driver can also be used to set the camera controls on Picturebook series
+(brightness, contrast etc), and is used by the video4linux driver for the
+Motion Eye camera.
+
+Please note that this driver was created by reverse engineering the Windows
+driver and the ACPI BIOS, because Sony doesn't agree to release any programming
+specs for its laptops. If someone convinces them to do so, drop me a note.
+
+Driver options:
+---------------
+
+Several options can be passed to the sonypi driver using the standard
+module argument syntax (<param>=<value> when passing the option to the
+module or sonypi.<param>=<value> on the kernel boot line when sonypi is
+statically linked into the kernel). Those options are:
+
+ minor: minor number of the misc device /dev/sonypi,
+ default is -1 (automatic allocation, see /proc/misc
+ or kernel logs)
+
+ camera: if you have a PictureBook series Vaio (with the
+ integrated MotionEye camera), set this parameter to 1
+ in order to let the driver access to the camera
+
+ fnkeyinit: on some Vaios (C1VE, C1VR etc), the Fn key events don't
+ get enabled unless you set this parameter to 1.
+ Do not use this option unless it's actually necessary,
+ some Vaio models don't deal well with this option.
+ This option is available only if the kernel is
+ compiled without ACPI support (since it conflicts
+ with it and it shouldn't be required anyway if
+ ACPI is already enabled).
+
+ verbose: set to 1 to print unknown events received from the
+ sonypi device.
+ set to 2 to print all events received from the
+ sonypi device.
+
+ compat: uses some compatibility code for enabling the sonypi
+ events. If the driver worked for you in the past
+ (prior to version 1.5) and does not work anymore,
+ add this option and report to the author.
+
+ mask: event mask telling the driver what events will be
+ reported to the user. This parameter is required for
+ some Vaio models where the hardware reuses values
+ used in other Vaio models (like the FX series who does
+ not have a jogdial but reuses the jogdial events for
+ programmable keys events). The default event mask is
+ set to 0xffffffff, meaning that all possible events
+ will be tried. You can use the following bits to
+ construct your own event mask (from
+ drivers/char/sonypi.h):
+ SONYPI_JOGGER_MASK 0x0001
+ SONYPI_CAPTURE_MASK 0x0002
+ SONYPI_FNKEY_MASK 0x0004
+ SONYPI_BLUETOOTH_MASK 0x0008
+ SONYPI_PKEY_MASK 0x0010
+ SONYPI_BACK_MASK 0x0020
+ SONYPI_HELP_MASK 0x0040
+ SONYPI_LID_MASK 0x0080
+ SONYPI_ZOOM_MASK 0x0100
+ SONYPI_THUMBPHRASE_MASK 0x0200
+ SONYPI_MEYE_MASK 0x0400
+ SONYPI_MEMORYSTICK_MASK 0x0800
+ SONYPI_BATTERY_MASK 0x1000
+ SONYPI_WIRELESS_MASK 0x2000
+
+ useinput: if set (which is the default) two input devices are
+ created, one which interprets the jogdial events as
+ mouse events, the other one which acts like a
+ keyboard reporting the pressing of the special keys.
+
+Module use:
+-----------
+
+In order to automatically load the sonypi module on use, you can put those
+lines in your /etc/modprobe.conf file:
+
+ alias char-major-10-250 sonypi
+ options sonypi minor=250
+
+This supposes the use of minor 250 for the sonypi device:
+
+ # mknod /dev/sonypi c 10 250
+
+Bugs:
+-----
+
+ - several users reported that this driver disables the BIOS-managed
+ Fn-keys which put the laptop in sleeping state, or switch the
+ external monitor on/off. There is no workaround yet, since this
+ driver disables all APM management for those keys, by enabling the
+ ACPI management (and the ACPI core stuff is not complete yet). If
+ you have one of those laptops with working Fn keys and want to
+ continue to use them, don't use this driver.
+
+ - some users reported that the laptop speed is lower (dhrystone
+ tested) when using the driver with the fnkeyinit parameter. I cannot
+ reproduce it on my laptop and not all users have this problem.
+ This happens because the fnkeyinit parameter enables the ACPI
+ mode (but without additional ACPI control, like processor
+ speed handling etc). Use ACPI instead of APM if it works on your
+ laptop.
+
+ - sonypi lacks the ability to distinguish between certain key
+ events on some models.
+
+ - some models with the nvidia card (geforce go 6200 tc) uses a
+ different way to adjust the backlighting of the screen. There
+ is a userspace utility to adjust the brightness on those models,
+ which can be downloaded from
+ http://www.acc.umu.se/~erikw/program/smartdimmer-0.1.tar.bz2
+
+ - since all development was done by reverse engineering, there is
+ _absolutely no guarantee_ that this driver will not crash your
+ laptop. Permanently.
diff --git a/Documentation/sonypi.txt b/Documentation/sonypi.txt
deleted file mode 100644
index 4857acf..0000000
--- a/Documentation/sonypi.txt
+++ /dev/null
@@ -1,152 +0,0 @@
-Sony Programmable I/O Control Device Driver Readme
---------------------------------------------------
- Copyright (C) 2001-2004 Stelian Pop <stelian@popies.net>
- Copyright (C) 2001-2002 Alcôve <www.alcove.com>
- Copyright (C) 2001 Michael Ashley <m.ashley@unsw.edu.au>
- Copyright (C) 2001 Junichi Morita <jun1m@mars.dti.ne.jp>
- Copyright (C) 2000 Takaya Kinjo <t-kinjo@tc4.so-net.ne.jp>
- Copyright (C) 2000 Andrew Tridgell <tridge@samba.org>
-
-This driver enables access to the Sony Programmable I/O Control Device which
-can be found in many Sony Vaio laptops. Some newer Sony laptops (seems to be
-limited to new FX series laptops, at least the FX501 and the FX702) lack a
-sonypi device and are not supported at all by this driver.
-
-It will give access (through a user space utility) to some events those laptops
-generate, like:
- - jogdial events (the small wheel on the side of Vaios)
- - capture button events (only on Vaio Picturebook series)
- - Fn keys
- - bluetooth button (only on C1VR model)
- - programmable keys, back, help, zoom, thumbphrase buttons, etc.
- (when available)
-
-Those events (see linux/sonypi.h) can be polled using the character device node
-/dev/sonypi (major 10, minor auto allocated or specified as a option).
-A simple daemon which translates the jogdial movements into mouse wheel events
-can be downloaded at: <http://popies.net/sonypi/>
-
-Another option to intercept the events is to get them directly through the
-input layer.
-
-This driver supports also some ioctl commands for setting the LCD screen
-brightness and querying the batteries charge information (some more
-commands may be added in the future).
-
-This driver can also be used to set the camera controls on Picturebook series
-(brightness, contrast etc), and is used by the video4linux driver for the
-Motion Eye camera.
-
-Please note that this driver was created by reverse engineering the Windows
-driver and the ACPI BIOS, because Sony doesn't agree to release any programming
-specs for its laptops. If someone convinces them to do so, drop me a note.
-
-Driver options:
----------------
-
-Several options can be passed to the sonypi driver using the standard
-module argument syntax (<param>=<value> when passing the option to the
-module or sonypi.<param>=<value> on the kernel boot line when sonypi is
-statically linked into the kernel). Those options are:
-
- minor: minor number of the misc device /dev/sonypi,
- default is -1 (automatic allocation, see /proc/misc
- or kernel logs)
-
- camera: if you have a PictureBook series Vaio (with the
- integrated MotionEye camera), set this parameter to 1
- in order to let the driver access to the camera
-
- fnkeyinit: on some Vaios (C1VE, C1VR etc), the Fn key events don't
- get enabled unless you set this parameter to 1.
- Do not use this option unless it's actually necessary,
- some Vaio models don't deal well with this option.
- This option is available only if the kernel is
- compiled without ACPI support (since it conflicts
- with it and it shouldn't be required anyway if
- ACPI is already enabled).
-
- verbose: set to 1 to print unknown events received from the
- sonypi device.
- set to 2 to print all events received from the
- sonypi device.
-
- compat: uses some compatibility code for enabling the sonypi
- events. If the driver worked for you in the past
- (prior to version 1.5) and does not work anymore,
- add this option and report to the author.
-
- mask: event mask telling the driver what events will be
- reported to the user. This parameter is required for
- some Vaio models where the hardware reuses values
- used in other Vaio models (like the FX series who does
- not have a jogdial but reuses the jogdial events for
- programmable keys events). The default event mask is
- set to 0xffffffff, meaning that all possible events
- will be tried. You can use the following bits to
- construct your own event mask (from
- drivers/char/sonypi.h):
- SONYPI_JOGGER_MASK 0x0001
- SONYPI_CAPTURE_MASK 0x0002
- SONYPI_FNKEY_MASK 0x0004
- SONYPI_BLUETOOTH_MASK 0x0008
- SONYPI_PKEY_MASK 0x0010
- SONYPI_BACK_MASK 0x0020
- SONYPI_HELP_MASK 0x0040
- SONYPI_LID_MASK 0x0080
- SONYPI_ZOOM_MASK 0x0100
- SONYPI_THUMBPHRASE_MASK 0x0200
- SONYPI_MEYE_MASK 0x0400
- SONYPI_MEMORYSTICK_MASK 0x0800
- SONYPI_BATTERY_MASK 0x1000
- SONYPI_WIRELESS_MASK 0x2000
-
- useinput: if set (which is the default) two input devices are
- created, one which interprets the jogdial events as
- mouse events, the other one which acts like a
- keyboard reporting the pressing of the special keys.
-
-Module use:
------------
-
-In order to automatically load the sonypi module on use, you can put those
-lines in your /etc/modprobe.conf file:
-
- alias char-major-10-250 sonypi
- options sonypi minor=250
-
-This supposes the use of minor 250 for the sonypi device:
-
- # mknod /dev/sonypi c 10 250
-
-Bugs:
------
-
- - several users reported that this driver disables the BIOS-managed
- Fn-keys which put the laptop in sleeping state, or switch the
- external monitor on/off. There is no workaround yet, since this
- driver disables all APM management for those keys, by enabling the
- ACPI management (and the ACPI core stuff is not complete yet). If
- you have one of those laptops with working Fn keys and want to
- continue to use them, don't use this driver.
-
- - some users reported that the laptop speed is lower (dhrystone
- tested) when using the driver with the fnkeyinit parameter. I cannot
- reproduce it on my laptop and not all users have this problem.
- This happens because the fnkeyinit parameter enables the ACPI
- mode (but without additional ACPI control, like processor
- speed handling etc). Use ACPI instead of APM if it works on your
- laptop.
-
- - sonypi lacks the ability to distinguish between certain key
- events on some models.
-
- - some models with the nvidia card (geforce go 6200 tc) uses a
- different way to adjust the backlighting of the screen. There
- is a userspace utility to adjust the brightness on those models,
- which can be downloaded from
- http://www.acc.umu.se/~erikw/program/smartdimmer-0.1.tar.bz2
-
- - since all development was done by reverse engineering, there is
- _absolutely no guarantee_ that this driver will not crash your
- laptop. Permanently.
diff --git a/drivers/char/Kconfig b/drivers/char/Kconfig
index f01ac9a..47c6be8 100644
--- a/drivers/char/Kconfig
+++ b/drivers/char/Kconfig
@@ -875,7 +875,7 @@ config SONYPI
Device which can be found in many (all ?) Sony Vaio laptops.
If you have one of those laptops, read
- <file:Documentation/sonypi.txt>, and say Y or M here.
+ <file:Documentation/laptops/sonypi.txt>, and say Y or M here.
To compile this driver as a module, choose M here: the
module will be called sonypi.
-
To unsubscribe from this list: send the line "unsubscribe linux-acpi" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply related [flat|nested] 16+ messages in thread* [PATCH 5/5] acer-wmi - Add documentation
2008-02-09 1:31 [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
` (2 preceding siblings ...)
2008-02-09 1:32 ` [PATCH 4/5] sonypi - Move sonypi.txt " Carlos Corbacho
@ 2008-02-09 1:32 ` Carlos Corbacho
2008-02-09 1:49 ` [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
` (2 subsequent siblings)
6 siblings, 0 replies; 16+ messages in thread
From: Carlos Corbacho @ 2008-02-09 1:32 UTC (permalink / raw)
To: linux-acpi; +Cc: Carlos Corbacho, Len Brown, Randy Dunlap
Add some initial documentation detailing what acer-wmi is, and how to use
it. Update the Kconfig entry with a reference to the documentation.
Signed-off-by: Carlos Corbacho <carlos@strangeworlds.co.uk>
CC: Len Brown <lenb@kernel.org>
CC: Randy Dunlap <randy.dunlap@oracle.com>
---
Documentation/laptops/00-INDEX | 2
Documentation/laptops/acer-wmi.txt | 202 ++++++++++++++++++++++++++++++++++++
drivers/misc/Kconfig | 3 +
3 files changed, 207 insertions(+), 0 deletions(-)
create mode 100644 Documentation/laptops/acer-wmi.txt
diff --git a/Documentation/laptops/00-INDEX b/Documentation/laptops/00-INDEX
index dbe1759..729c2c0 100644
--- a/Documentation/laptops/00-INDEX
+++ b/Documentation/laptops/00-INDEX
@@ -1,5 +1,7 @@
00-INDEX
- This file
+acer-wmi.txt
+ - information on the Acer Laptop WMI Extras driver.
sony-laptop.txt
- Sony Notebook Control Driver (SNC) Readme.
sonypi.txt
diff --git a/Documentation/laptops/acer-wmi.txt b/Documentation/laptops/acer-wmi.txt
new file mode 100644
index 0000000..b066963
--- /dev/null
+++ b/Documentation/laptops/acer-wmi.txt
@@ -0,0 +1,202 @@
+Acer Laptop WMI Extras Driver
+http://code.google.com/p/aceracpi
+Version 0.1
+9th February 2008
+
+Copyright 2007-2008 Carlos Corbacho <carlos@strangeworlds.co.uk>
+
+acer-wmi is a driver to allow you to control various parts of your Acer laptop
+hardware under Linux which are exposed via ACPI-WMI.
+
+This driver completely replaces the old out-of-tree acer_acpi, which I am
+currently maintaining for bug fixes only on pre-2.6.25 kernels. All development
+work is now focused solely on acer-wmi.
+
+Disclaimer
+**********
+
+Acer and Wistron have provided nothing towards the development acer_acpi or
+acer-wmi. All information we have has been through the efforts of the developers
+and the users to discover as much as possible about the hardware.
+
+As such, I do warn that this could break your hardware - this is extremely
+unlikely of course, but please bear this in mind.
+
+Background
+**********
+
+acer-wmi is derived from acer_acpi, originally developed by Mark
+Smith in 2005, then taken over by Carlos Corbacho in 2007, in order to activate
+the wireless LAN card under a 64-bit version of Linux, as acerhk[1] (the
+previous solution to the problem) relied on making 32 bit BIOS calls which are
+not possible in kernel space from a 64 bit OS.
+
+[1] acerhk: http://www.cakey.de/acerhk/
+
+Supported Hardware
+******************
+
+Please see the website for the current list of known working hardare:
+
+http://code.google.com/p/aceracpi/wiki/SupportedHardware
+
+If your laptop is not listed, or listed as unknown, and works with acer-wmi,
+please contact me with a copy of the DSDT.
+
+If your Acer laptop doesn't work with acer-wmi, I would also like to see the
+DSDT.
+
+To send me the DSDT, as root/sudo:
+
+cat /sys/firmware/acpi/DSDT > dsdt
+
+And send me the resulting 'dsdt' file.
+
+Usage
+*****
+
+On Acer laptops, acer-wmi should already be autoloaded based on DMI matching.
+For non-Acer laptops, until WMI based autoloading support is added, you will
+need to manually load acer-wmi.
+
+acer-wmi creates /sys/devices/platform/acer-wmi, and fills it with various
+files whose usage is detailed below, which enables you to control some of the
+following (varies between models):
+
+* the wireless LAN card radio
+* inbuilt Bluetooth adapter
+* inbuilt 3G card
+* mail LED of your laptop
+* brightness of the LCD panel
+
+Wireless
+********
+
+With regards to wireless, all acer-wmi does is enable the radio on the card. It
+is not responsible for the wireless LED - once the radio is enabled, this is
+down to the wireless driver for your card. So the behaviour of the wireless LED,
+once you enable the radio, will depend on your hardware and driver combination.
+
+e.g. With the BCM4318 on the Acer Aspire 5020 series:
+
+ndiswrapper: Light blinks on when transmitting
+bcm43xx/b43: Solid light, blinks off when transmitting
+
+Wireless radio control is unconditionally enabled - all Acer laptops that support
+acer-wmi come with built-in wireless. However, should you feel so inclined to
+ever wish to remove the card, or swap it out at some point, please get in touch
+with me, as we may well be able to gain some data on wireless card detection.
+
+To read the status of the wireless radio (0=off, 1=on):
+cat /sys/devices/platform/acer-wmi/wireless
+
+To enable the wireless radio:
+echo 1 > /sys/devices/platform/acer-wmi/wireless
+
+To disable the wireless radio:
+echo 0 > /sys/devices/platform/acer-wmi/wireless
+
+To set the state of the wireless radio when loading acer-wmi, pass:
+wireless=X (where X is 0 or 1)
+
+Bluetooth
+*********
+
+For bluetooth, this is an internal USB dongle, so once enabled, you will get
+a USB device connection event, and a new USB device appears. When you disable
+bluetooth, you get the reverse - a USB device disconnect event, followed by the
+device disappearing again.
+
+Bluetooth is autodetected by acer-wmi, so if you do not have a bluetooth module
+installed in your laptop, this file won't exist (please be aware that it is
+quite common for Acer not to fit bluetooth to their laptops - so just because
+you have a bluetooth button on the laptop, doesn't mean that bluetooth is
+installed).
+
+For the adventurously minded - if you want to buy an internal bluetooth
+module off the internet that is compatible with your laptop and fit it, then
+it will work just fine with acer-wmi.
+
+To read the status of the bluetooth module (0=off, 1=on):
+cat /sys/devices/platform/acer-wmi/wireless
+
+To enable the bluetooth module:
+echo 1 > /sys/devices/platform/acer-wmi/bluetooth
+
+To disable the bluetooth module:
+echo 0 > /sys/devices/platform/acer-wmi/bluetooth
+
+To set the state of the bluetooth module when loading acer-wmi, pass:
+bluetooth=X (where X is 0 or 1)
+
+3G
+**
+
+3G is currently not autodetected, so the 'threeg' file is always created under
+sysfs. So far, no-one in possession of an Acer laptop with 3G built-in appears to
+have tried Linux, or reported back, so we don't have any information on this.
+
+If you have an Acer laptop that does have a 3G card in, please contact me so we
+can properly detect these, and find out a bit more about them.
+
+To read the status of the 3G card (0=off, 1=on):
+cat /sys/devices/platform/acer-wmi/threeg
+
+To enable the 3G card:
+echo 1 > /sys/devices/platform/acer-wmi/threeg
+
+To disable the 3G card:
+echo 0 > /sys/devices/platform/acer-wmi/threeg
+
+To set the state of the 3G card when loading acer-wmi, pass:
+threeg=X (where X is 0 or 1)
+
+Mail LED
+********
+
+This can be found in most older Acer laptops supported by acer-wmi, and many
+newer ones - it is built into the 'mail' button, and blinks when active.
+
+On newer (WMID) laptops though, we have no way of detecting the mail LED. If
+your laptop identifies itself in dmesg as a WMID model, then please try loading
+acer_acpi with:
+
+force_series=2490
+
+This will use a known alternative method of reading/ writing the mail LED. If
+it works, please report back to me with the DMI data from your laptop so this
+can be added to acer-wmi.
+
+The LED is exposed through the LED subsystem, and can be found in:
+
+/sys/devices/platform/acer-wmi/leds/acer-mail:green/
+
+The mail LED is autodetected, so if you don't have one, the LED device won't
+be registered.
+
+If you have a mail LED that is not green, please report this to me.
+
+Backlight
+*********
+
+The backlight brightness control is available on all acer-wmi supported
+hardware. The maximum brightness level is usually 15, but on some newer laptops
+it's 10 (this is again autodetected).
+
+The backlight is exposed through the backlight subsystem, and can be found in:
+
+/sys/devices/platform/acer-wmi/backlight/acer-wmi/
+
+Credits
+*******
+
+Olaf Tauber, who did the real hard work when he developed acerhk
+http://www.informatik.hu-berlin.de/~tauber/acerhk
+All the authors of laptop ACPI modules in the kernel, whose work
+was an inspiration in the early days of acer_acpi
+Mathieu Segaud, who solved the problem with having to modprobe the driver
+twice in acer_acpi 0.2.
+Jim Ramsay, who added support for the WMID interface
+Mark Smith, who started the original acer_acpi
+
+And the many people who have used both acer_acpi and acer-wmi.
diff --git a/drivers/misc/Kconfig b/drivers/misc/Kconfig
index e3c70cd..e47d424 100644
--- a/drivers/misc/Kconfig
+++ b/drivers/misc/Kconfig
@@ -105,6 +105,9 @@ config ACER_WMI
wireless radio and bluetooth control, and on some laptops,
exposes the mail LED and LCD backlight.
+ For more information about this driver see
+ <file:Documentation/laptops/acer-wmi.txt>
+
If you have an ACPI-WMI compatible Acer/ Wistron laptop, say Y or M
here.
^ permalink raw reply related [flat|nested] 16+ messages in thread* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-09 1:31 [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
` (3 preceding siblings ...)
2008-02-09 1:32 ` [PATCH 5/5] acer-wmi - Add documentation Carlos Corbacho
@ 2008-02-09 1:49 ` Carlos Corbacho
2008-02-09 9:12 ` Len Brown
2008-02-09 4:09 ` Randy Dunlap
2008-02-11 19:23 ` Randy Dunlap
6 siblings, 1 reply; 16+ messages in thread
From: Carlos Corbacho @ 2008-02-09 1:49 UTC (permalink / raw)
To: linux-acpi
Cc: Len Brown, Randy Dunlap, Henrique de Moraes Holschuh,
Mattia Dongili
On Saturday 09 February 2008 01:31:57 Carlos Corbacho wrote:
> thinkpad-acpi - Move thinkpad-acpi.txt to Documentation/laptops
This patch [2/5] doesn't seem to have made it to the list. If it doesn't
appear by the end of Saturday, I'll try resending it.
-Carlos
--
E-Mail: carlos@strangeworlds.co.uk
Web: strangeworlds.co.uk
GPG Key ID: 0x23EE722D
^ permalink raw reply [flat|nested] 16+ messages in thread* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-09 1:49 ` [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
@ 2008-02-09 9:12 ` Len Brown
2008-02-09 18:22 ` Henrique de Moraes Holschuh
2008-02-10 8:09 ` Mattia Dongili
0 siblings, 2 replies; 16+ messages in thread
From: Len Brown @ 2008-02-09 9:12 UTC (permalink / raw)
To: Carlos Corbacho
Cc: linux-acpi, Randy Dunlap, Henrique de Moraes Holschuh,
Mattia Dongili
On Friday 08 February 2008 20:49, Carlos Corbacho wrote:
> On Saturday 09 February 2008 01:31:57 Carlos Corbacho wrote:
> > thinkpad-acpi - Move thinkpad-acpi.txt to Documentation/laptops
>
> This patch [2/5] doesn't seem to have made it to the list. If it doesn't
> appear by the end of Saturday, I'll try resending it.
it was 110K, which exceeded the 100K message size of the list.
i'm fine with these changes if everybody else is.
thanks,
-len
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-09 9:12 ` Len Brown
@ 2008-02-09 18:22 ` Henrique de Moraes Holschuh
2008-02-09 22:04 ` Carlos Corbacho
2008-02-10 8:09 ` Mattia Dongili
1 sibling, 1 reply; 16+ messages in thread
From: Henrique de Moraes Holschuh @ 2008-02-09 18:22 UTC (permalink / raw)
To: Len Brown; +Cc: Carlos Corbacho, linux-acpi, Randy Dunlap, Mattia Dongili
On Sat, 09 Feb 2008, Len Brown wrote:
> On Friday 08 February 2008 20:49, Carlos Corbacho wrote:
> > On Saturday 09 February 2008 01:31:57 Carlos Corbacho wrote:
> > > thinkpad-acpi - Move thinkpad-acpi.txt to Documentation/laptops
> >
> > This patch [2/5] doesn't seem to have made it to the list. If it doesn't
> > appear by the end of Saturday, I'll try resending it.
>
> it was 110K, which exceeded the 100K message size of the list.
>
> i'm fine with these changes if everybody else is.
As I said before, I am OK with them.
BTW Carlos, sending a git diff would have resulted in much smaller diffs
(since git diff can do renames instead of add/delete) :) I believe all of
us can deal just fine with git diffs, so it makes sense to use them in these
cases.
--
"One disk to rule them all, One disk to find them. One disk to bring
them all and in the darkness grind them. In the Land of Redmond
where the shadows lie." -- The Silicon Valley Tarot
Henrique Holschuh
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-09 18:22 ` Henrique de Moraes Holschuh
@ 2008-02-09 22:04 ` Carlos Corbacho
2008-02-09 23:53 ` Henrique de Moraes Holschuh
0 siblings, 1 reply; 16+ messages in thread
From: Carlos Corbacho @ 2008-02-09 22:04 UTC (permalink / raw)
To: Henrique de Moraes Holschuh
Cc: Len Brown, linux-acpi, Randy Dunlap, Mattia Dongili
On Saturday 09 February 2008 18:22:17 Henrique de Moraes Holschuh wrote:
> BTW Carlos, sending a git diff would have resulted in much smaller diffs
> (since git diff can do renames instead of add/delete) :) I believe all of
> us can deal just fine with git diffs, so it makes sense to use them in
> these cases.
I don't quite know what you mean here - experimenting in a tree here, git-diff
doesn't produce any noticeable difference after using git-mv - unless this is
a bug with StackedGit being unable to handle renames/ moves properly?
-Carlos
--
E-Mail: carlos@strangeworlds.co.uk
Web: strangeworlds.co.uk
GPG Key ID: 0x23EE722D
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-09 22:04 ` Carlos Corbacho
@ 2008-02-09 23:53 ` Henrique de Moraes Holschuh
0 siblings, 0 replies; 16+ messages in thread
From: Henrique de Moraes Holschuh @ 2008-02-09 23:53 UTC (permalink / raw)
To: Carlos Corbacho; +Cc: Len Brown, linux-acpi, Randy Dunlap, Mattia Dongili
On Sat, 09 Feb 2008, Carlos Corbacho wrote:
> On Saturday 09 February 2008 18:22:17 Henrique de Moraes Holschuh wrote:
> > BTW Carlos, sending a git diff would have resulted in much smaller diffs
> > (since git diff can do renames instead of add/delete) :) I believe all of
> > us can deal just fine with git diffs, so it makes sense to use them in
> > these cases.
>
> I don't quite know what you mean here - experimenting in a tree here, git-diff
> doesn't produce any noticeable difference after using git-mv - unless this is
> a bug with StackedGit being unable to handle renames/ moves properly?
Randy sent you a much better email than mine about it, but here it goes:
hmh@thorin:/tmp/f$ git init
Initialized empty Git repository in .git/
hmh@thorin:/tmp/f$ cp /var/log/Xorg.0.log .
hmh@thorin:/tmp/f$ git add .
hmh@thorin:/tmp/f$ git commit -m "initial commit"
Created initial commit 4e5f9c4: initial commit
1 files changed, 1260 insertions(+), 0 deletions(-)
create mode 100644 Xorg.0.log
hmh@thorin:/tmp/f$ git mv Xorg.0.log Xorg.1.log
hmh@thorin:/tmp/f$ git commit -m "move commit"
Created commit ed5f8d0: move commit
2 files changed, 1260 insertions(+), 1260 deletions(-)
delete mode 100644 Xorg.0.log
create mode 100644 Xorg.1.log
hmh@thorin:/tmp/f$ git diff HEAD^.. -M
diff --git a/Xorg.0.log b/Xorg.1.log
similarity index 100%
rename from Xorg.0.log
rename to Xorg.1.log
The key is that -M (or -C for that matter). To be even more clear:
hmh@thorin:/tmp/f$ git diff HEAD^.. | wc
2532 20098 134766
hmh@thorin:/tmp/f$ git diff HEAD^.. -M | wc
4 13 103
So I really should have mentioned -M when I talked about git diffs :-(
--
"One disk to rule them all, One disk to find them. One disk to bring
them all and in the darkness grind them. In the Land of Redmond
where the shadows lie." -- The Silicon Valley Tarot
Henrique Holschuh
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-09 9:12 ` Len Brown
2008-02-09 18:22 ` Henrique de Moraes Holschuh
@ 2008-02-10 8:09 ` Mattia Dongili
1 sibling, 0 replies; 16+ messages in thread
From: Mattia Dongili @ 2008-02-10 8:09 UTC (permalink / raw)
To: Len Brown
Cc: Carlos Corbacho, linux-acpi, Randy Dunlap,
Henrique de Moraes Holschuh
On Sat, Feb 09, 2008 at 04:12:57AM -0500, Len Brown wrote:
> On Friday 08 February 2008 20:49, Carlos Corbacho wrote:
> > On Saturday 09 February 2008 01:31:57 Carlos Corbacho wrote:
> > > thinkpad-acpi - Move thinkpad-acpi.txt to Documentation/laptops
> >
> > This patch [2/5] doesn't seem to have made it to the list. If it doesn't
> > appear by the end of Saturday, I'll try resending it.
>
> it was 110K, which exceeded the 100K message size of the list.
>
> i'm fine with these changes if everybody else is.
Ok for me for sonypi.txt and sony-laptop.txt
Cheers
--
mattia
:wq!
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-09 1:31 [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
` (4 preceding siblings ...)
2008-02-09 1:49 ` [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
@ 2008-02-09 4:09 ` Randy Dunlap
2008-02-11 19:23 ` Randy Dunlap
6 siblings, 0 replies; 16+ messages in thread
From: Randy Dunlap @ 2008-02-09 4:09 UTC (permalink / raw)
To: Carlos Corbacho
Cc: linux-acpi, Len Brown, Henrique de Moraes Holschuh,
Mattia Dongili
On Sat, 09 Feb 2008 01:31:57 +0000 Carlos Corbacho wrote:
> The following series implements the proposed creation of Documentation/laptops,
> and the movement of all the laptop driver documentation to this directory. I've
> also taken the opportunity to tack on the acer-wmi documentation in the final
> patch of this series.
>
> Because all the drivers in question go through the ACPI tree anyway, it's
> probably easiest if this change goes through the ACPI tree as well.
>
> This should all be 2.6.25 material, since there is no code change here, just
> rearranging the Documentation files, and updating Kconfig entries where
> required. I've also tested this series against Linus' latest git tree, with no
> problems applying it there.
>
> -Carlos
> ---
>
> Carlos Corbacho (5):
> acer-wmi - Add documentation
> sonypi - Move sonypi.txt to Documentation/laptops
> sony-laptop - Move sony-laptop.txt to Documentation/laptops
> thinkpad-acpi - Move thinkpad-acpi.txt to Documentation/laptops
> Documentation - Create laptops sub-directory
for_each:
Acked-by: Randy Dunlap <randy.dunlap@oracle.com.
Oh. If any of these are purely moved files (from one location to
another), then that should show up in the git-diff diffstat.
(I'm sure that Len knows about this.)
Ah, I finally found Linus's email on this. He says:
Please use "git diff -M --stat --summary" to generate the diffstat: the -M
enables rename detection, and the summary enables a summary of new/deleted
or renamed files.
Thanks.
> Documentation/00-INDEX | 8
> Documentation/laptops/00-INDEX | 10
> Documentation/laptops/acer-wmi.txt | 202 +++++
> Documentation/laptops/sony-laptop.txt | 117 +++
> Documentation/laptops/sonypi.txt | 152 +++
> Documentation/laptops/thinkpad-acpi.txt | 1365 +++++++++++++++++++++++++++++++
> Documentation/sony-laptop.txt | 117 ---
> Documentation/sonypi.txt | 152 ---
> Documentation/thinkpad-acpi.txt | 1365 -------------------------------
> drivers/char/Kconfig | 2
> drivers/misc/Kconfig | 10
> 11 files changed, 1856 insertions(+), 1644 deletions(-)
> create mode 100644 Documentation/laptops/00-INDEX
> create mode 100644 Documentation/laptops/acer-wmi.txt
> create mode 100644 Documentation/laptops/sony-laptop.txt
> create mode 100644 Documentation/laptops/sonypi.txt
> create mode 100644 Documentation/laptops/thinkpad-acpi.txt
> delete mode 100644 Documentation/sony-laptop.txt
> delete mode 100644 Documentation/sonypi.txt
> delete mode 100644 Documentation/thinkpad-acpi.txt
---
~Randy
^ permalink raw reply [flat|nested] 16+ messages in thread* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-09 1:31 [PATCH 0/5] Laptop driver documentation changes for 2.6.25 Carlos Corbacho
` (5 preceding siblings ...)
2008-02-09 4:09 ` Randy Dunlap
@ 2008-02-11 19:23 ` Randy Dunlap
2008-02-11 19:29 ` Carlos Corbacho
6 siblings, 1 reply; 16+ messages in thread
From: Randy Dunlap @ 2008-02-11 19:23 UTC (permalink / raw)
To: Carlos Corbacho
Cc: linux-acpi, Len Brown, Henrique de Moraes Holschuh,
Mattia Dongili
On Sat, 09 Feb 2008 01:31:57 +0000 Carlos Corbacho wrote:
> The following series implements the proposed creation of Documentation/laptops,
> and the movement of all the laptop driver documentation to this directory. I've
> also taken the opportunity to tack on the acer-wmi documentation in the final
> patch of this series.
>
> Because all the drivers in question go through the ACPI tree anyway, it's
> probably easiest if this change goes through the ACPI tree as well.
>
> This should all be 2.6.25 material, since there is no code change here, just
> rearranging the Documentation files, and updating Kconfig entries where
> required. I've also tested this series against Linus' latest git tree, with no
> problems applying it there.
>
Hi,
so should we also move Documentation/laptop-mode.txt to laptops/ dir?
>
> Carlos Corbacho (5):
> acer-wmi - Add documentation
> sonypi - Move sonypi.txt to Documentation/laptops
> sony-laptop - Move sony-laptop.txt to Documentation/laptops
> thinkpad-acpi - Move thinkpad-acpi.txt to Documentation/laptops
> Documentation - Create laptops sub-directory
>
>
> Documentation/00-INDEX | 8
> Documentation/laptops/00-INDEX | 10
> Documentation/laptops/acer-wmi.txt | 202 +++++
> Documentation/laptops/sony-laptop.txt | 117 +++
> Documentation/laptops/sonypi.txt | 152 +++
> Documentation/laptops/thinkpad-acpi.txt | 1365 +++++++++++++++++++++++++++++++
> Documentation/sony-laptop.txt | 117 ---
> Documentation/sonypi.txt | 152 ---
> Documentation/thinkpad-acpi.txt | 1365 -------------------------------
> drivers/char/Kconfig | 2
> drivers/misc/Kconfig | 10
> 11 files changed, 1856 insertions(+), 1644 deletions(-)
> create mode 100644 Documentation/laptops/00-INDEX
> create mode 100644 Documentation/laptops/acer-wmi.txt
> create mode 100644 Documentation/laptops/sony-laptop.txt
> create mode 100644 Documentation/laptops/sonypi.txt
> create mode 100644 Documentation/laptops/thinkpad-acpi.txt
> delete mode 100644 Documentation/sony-laptop.txt
> delete mode 100644 Documentation/sonypi.txt
> delete mode 100644 Documentation/thinkpad-acpi.txt
---
~Randy
^ permalink raw reply [flat|nested] 16+ messages in thread* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-11 19:23 ` Randy Dunlap
@ 2008-02-11 19:29 ` Carlos Corbacho
2008-03-03 22:27 ` Randy Dunlap
0 siblings, 1 reply; 16+ messages in thread
From: Carlos Corbacho @ 2008-02-11 19:29 UTC (permalink / raw)
To: Randy Dunlap
Cc: linux-acpi, Len Brown, Henrique de Moraes Holschuh,
Mattia Dongili, bart
On Monday 11 February 2008 19:23:39 Randy Dunlap wrote:
> On Sat, 09 Feb 2008 01:31:57 +0000 Carlos Corbacho wrote:
> > The following series implements the proposed creation of
> > Documentation/laptops, and the movement of all the laptop driver
> > documentation to this directory. I've also taken the opportunity to tack
> > on the acer-wmi documentation in the final patch of this series.
> >
> > Because all the drivers in question go through the ACPI tree anyway, it's
> > probably easiest if this change goes through the ACPI tree as well.
> >
> > This should all be 2.6.25 material, since there is no code change here,
> > just rearranging the Documentation files, and updating Kconfig entries
> > where required. I've also tested this series against Linus' latest git
> > tree, with no problems applying it there.
>
> Hi,
> so should we also move Documentation/laptop-mode.txt to laptops/ dir?
[CC'ing Bart Samwel on this, as he wrote Documentation/laptop-mode.txt]
Yes, we probably should.
-Carlos
--
E-Mail: carlos@strangeworlds.co.uk
Web: strangeworlds.co.uk
GPG Key ID: 0x23EE722D
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-02-11 19:29 ` Carlos Corbacho
@ 2008-03-03 22:27 ` Randy Dunlap
2008-03-04 8:21 ` Bart Samwel
0 siblings, 1 reply; 16+ messages in thread
From: Randy Dunlap @ 2008-03-03 22:27 UTC (permalink / raw)
To: Carlos Corbacho
Cc: linux-acpi, Len Brown, Henrique de Moraes Holschuh,
Mattia Dongili, bart
On Mon, 11 Feb 2008 19:29:29 +0000 Carlos Corbacho wrote:
> On Monday 11 February 2008 19:23:39 Randy Dunlap wrote:
> > On Sat, 09 Feb 2008 01:31:57 +0000 Carlos Corbacho wrote:
> > > The following series implements the proposed creation of
> > > Documentation/laptops, and the movement of all the laptop driver
> > > documentation to this directory. I've also taken the opportunity to tack
> > > on the acer-wmi documentation in the final patch of this series.
> > >
> > > Because all the drivers in question go through the ACPI tree anyway, it's
> > > probably easiest if this change goes through the ACPI tree as well.
> > >
> > > This should all be 2.6.25 material, since there is no code change here,
> > > just rearranging the Documentation files, and updating Kconfig entries
> > > where required. I've also tested this series against Linus' latest git
> > > tree, with no problems applying it there.
> >
> > Hi,
> > so should we also move Documentation/laptop-mode.txt to laptops/ dir?
>
> [CC'ing Bart Samwel on this, as he wrote Documentation/laptop-mode.txt]
>
> Yes, we probably should.
Hi Bart,
Is that OK with you?
if we move laptop-mode.txt to the Documenation/laptops/ sub-directory?
---
~Randy
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH 0/5] Laptop driver documentation changes for 2.6.25
2008-03-03 22:27 ` Randy Dunlap
@ 2008-03-04 8:21 ` Bart Samwel
0 siblings, 0 replies; 16+ messages in thread
From: Bart Samwel @ 2008-03-04 8:21 UTC (permalink / raw)
To: Randy Dunlap
Cc: Carlos Corbacho, linux-acpi, Len Brown,
Henrique de Moraes Holschuh, Mattia Dongili
Randy Dunlap wrote:
> On Mon, 11 Feb 2008 19:29:29 +0000 Carlos Corbacho wrote:
>
>> On Monday 11 February 2008 19:23:39 Randy Dunlap wrote:
>>> On Sat, 09 Feb 2008 01:31:57 +0000 Carlos Corbacho wrote:
>>>> The following series implements the proposed creation of
>>>> Documentation/laptops, and the movement of all the laptop driver
>>>> documentation to this directory. I've also taken the opportunity to tack
>>>> on the acer-wmi documentation in the final patch of this series.
>>>>
>>>> Because all the drivers in question go through the ACPI tree anyway, it's
>>>> probably easiest if this change goes through the ACPI tree as well.
>>>>
>>>> This should all be 2.6.25 material, since there is no code change here,
>>>> just rearranging the Documentation files, and updating Kconfig entries
>>>> where required. I've also tested this series against Linus' latest git
>>>> tree, with no problems applying it there.
>>> Hi,
>>> so should we also move Documentation/laptop-mode.txt to laptops/ dir?
>> [CC'ing Bart Samwel on this, as he wrote Documentation/laptop-mode.txt]
>>
>> Yes, we probably should.
>
> Hi Bart,
> Is that OK with you?
> if we move laptop-mode.txt to the Documenation/laptops/ sub-directory?
Sounds fine by me!
Cheers,
Bart
^ permalink raw reply [flat|nested] 16+ messages in thread