Commit 219beb29 authored by Pavel Machek's avatar Pavel Machek Committed by Linus Torvalds
Browse files

lis3: fix documentation to fit into 80 columns



Fix lis3 documentation to fit into 80 columns.

Signed-off-by: default avatarPavel Machek <pavel@suse.cz>
Cc: Éric Piel <eric.piel@tremplin-utc.net>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
Signed-off-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
parent 9e0c7978
Loading
Loading
Loading
Loading
+17 −13
Original line number Original line Diff line number Diff line
@@ -13,18 +13,21 @@ Author:
Description
Description
-----------
-----------


This driver provides support for the accelerometer found in various HP laptops
This driver provides support for the accelerometer found in various HP
sporting the feature officially called "HP Mobile Data Protection System 3D" or
laptops sporting the feature officially called "HP Mobile Data
"HP 3D DriveGuard". It detect automatically laptops with this sensor. Known models
Protection System 3D" or "HP 3D DriveGuard". It detect automatically
(for now the HP 2133, nc6420, nc2510, nc8510, nc84x0, nw9440 and nx9420) will
laptops with this sensor. Known models (for now the HP 2133, nc6420,
have their axis automatically oriented on standard way (eg: you can directly
nc2510, nc8510, nc84x0, nw9440 and nx9420) will have their axis
play neverball).  The accelerometer data is readable via
automatically oriented on standard way (eg: you can directly play
neverball).  The accelerometer data is readable via
/sys/devices/platform/lis3lv02d.
/sys/devices/platform/lis3lv02d.


Sysfs attributes under /sys/devices/platform/lis3lv02d/:
Sysfs attributes under /sys/devices/platform/lis3lv02d/:
position - 3D position that the accelerometer reports. Format: "(x,y,z)"
position - 3D position that the accelerometer reports. Format: "(x,y,z)"
calibrate - read: values (x, y, z) that are used as the base for input class device operation.
calibrate - read: values (x, y, z) that are used as the base for input
            write: forces the base to be recalibrated with the current position.
		  class device operation.
            write: forces the base to be recalibrated with the current
		  position.
rate - reports the sampling rate of the accelerometer device in HZ
rate - reports the sampling rate of the accelerometer device in HZ


This driver also provides an absolute input class device, allowing
This driver also provides an absolute input class device, allowing
@@ -39,11 +42,12 @@ the accelerometer are converted into a "standard" organisation of the axes
 * When the laptop is horizontal the position reported is about 0 for X and Y
 * When the laptop is horizontal the position reported is about 0 for X and Y
and a positive value for Z
and a positive value for Z
 * If the left side is elevated, X increases (becomes positive)
 * If the left side is elevated, X increases (becomes positive)
 * If the front side (where the touchpad is) is elevated, Y decreases (becomes negative)
 * If the front side (where the touchpad is) is elevated, Y decreases
	(becomes negative)
 * If the laptop is put upside-down, Z becomes negative
 * If the laptop is put upside-down, Z becomes negative


If your laptop model is not recognized (cf "dmesg"), you can send an email to the
If your laptop model is not recognized (cf "dmesg"), you can send an
authors to add it to the database.  When reporting a new laptop, please include
email to the authors to add it to the database.  When reporting a new
the output of "dmidecode" plus the value of /sys/devices/platform/lis3lv02d/position
laptop, please include the output of "dmidecode" plus the value of
in these four cases.
/sys/devices/platform/lis3lv02d/position in these four cases.