€•kKŒsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ*/translations/zh_CN/misc-devices/lis3lv02d”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ*/translations/zh_TW/misc-devices/lis3lv02d”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ*/translations/it_IT/misc-devices/lis3lv02d”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ*/translations/ja_JP/misc-devices/lis3lv02d”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ*/translations/ko_KR/misc-devices/lis3lv02d”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ*/translations/sp_SP/misc-devices/lis3lv02d”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒKernel driver lis3lv02d”h]”hŒKernel driver lis3lv02d”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒD/var/lib/git/docbuild/linux/Documentation/misc-devices/lis3lv02d.rst”h KubhŒ paragraph”“”)”}”(hŒSupported chips:”h]”hŒSupported chips:”…””}”(hh¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubhŒ block_quote”“”)”}”(hŒ–* STMicroelectronics LIS3LV02DL, LIS3LV02DQ (12 bits precision) * STMicroelectronics LIS302DL, LIS3L02DQ, LIS331DL (8 bits) and LIS331DLH (16 bits) ”h]”hŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ=STMicroelectronics LIS3LV02DL, LIS3LV02DQ (12 bits precision)”h]”h¸)”}”(hhÖh]”hŒ=STMicroelectronics LIS3LV02DL, LIS3LV02DQ (12 bits precision)”…””}”(hhØhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhhÔubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhhÏubhÓ)”}”(hŒRSTMicroelectronics LIS302DL, LIS3L02DQ, LIS331DL (8 bits) and LIS331DLH (16 bits) ”h]”h¸)”}”(hŒQSTMicroelectronics LIS302DL, LIS3L02DQ, LIS331DL (8 bits) and LIS331DLH (16 bits)”h]”hŒQSTMicroelectronics LIS302DL, LIS3L02DQ, LIS331DL (8 bits) and LIS331DLH (16 bits)”…””}”(hhïhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khhëubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhhÏubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1hÍhŸh¶h KhhÉubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h Khh£hžhubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒWAuthors: - Yan Burman - Eric Piel ”h]”(hŒterm”“”)”}”(hŒAuthors:”h]”hŒAuthors:”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh¶h KhjubhŒ definition”“”)”}”(hhh]”hÎ)”}”(hhh]”(hÓ)”}”(hŒ!Yan Burman ”h]”h¸)”}”(hj6h]”(hŒ Yan Burman <”…””}”(hj8hžhhŸNh NubhŒ reference”“”)”}”(hŒburman.yan@gmail.com”h]”hŒburman.yan@gmail.com”…””}”(hjAhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:burman.yan@gmail.com”uh1j?hj8ubhŒ>”…””}”(hj8hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K hj4ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhj1ubhÓ)”}”(hŒ(Eric Piel ”h]”h¸)”}”(hŒ&Eric Piel ”h]”(hŒ Eric Piel <”…””}”(hjehžhhŸNh Nubj@)”}”(hŒeric.piel@tremplin-utc.net”h]”hŒeric.piel@tremplin-utc.net”…””}”(hjmhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ!mailto:eric.piel@tremplin-utc.net”uh1j?hjeubhŒ>”…””}”(hjehžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K hjaubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhj1ubeh}”(h]”h ]”h"]”h$]”h&]”j Œ-”uh1hÍhŸh¶h K hj.ubah}”(h]”h ]”h"]”h$]”h&]”uh1j,hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh¶h Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhh£hžhhŸNh Nubh¢)”}”(hhh]”(h§)”}”(hŒ Description”h]”hŒ Description”…””}”(hj©hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj¦hžhhŸh¶h Kubh¸)”}”(hXThis driver provides support for the accelerometer found in various HP laptops sporting the feature officially called "HP Mobile Data Protection System 3D" or "HP 3D DriveGuard". It detects automatically laptops with this sensor. Known models (full list can be found in drivers/platform/x86/hp_accel.c) will have their axis automatically oriented on standard way (eg: you can directly play neverball). The accelerometer data is readable via /sys/devices/platform/lis3lv02d. Reported values are scaled to mg values (1/1000th of earth gravity).”h]”hX&This driver provides support for the accelerometer found in various HP laptops sporting the feature officially called “HP Mobile Data Protection System 3D†or “HP 3D DriveGuardâ€. It detects automatically laptops with this sensor. Known models (full list can be found in drivers/platform/x86/hp_accel.c) will have their axis automatically oriented on standard way (eg: you can directly play neverball). The accelerometer data is readable via /sys/devices/platform/lis3lv02d. Reported values are scaled to mg values (1/1000th of earth gravity).”…””}”(hj·hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj¦hžhubh¸)”}”(hŒ8Sysfs attributes under /sys/devices/platform/lis3lv02d/:”h]”hŒ8Sysfs attributes under /sys/devices/platform/lis3lv02d/:”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj¦hžhubj)”}”(hhh]”(j)”}”(hŒHposition - 3D position that the accelerometer reports. Format: "(x,y,z)"”h]”(j)”}”(hŒposition”h]”hŒposition”…””}”(hjÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh¶h KhjÖubj-)”}”(hhh]”hÎ)”}”(hhh]”hÓ)”}”(hŒ=3D position that the accelerometer reports. Format: "(x,y,z)"”h]”h¸)”}”(hjðh]”hŒA3D position that the accelerometer reports. Format: “(x,y,z)—…””}”(hjòhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khjîubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjëubah}”(h]”h ]”h"]”h$]”h&]”j j“uh1hÍhŸh¶h Khjèubah}”(h]”h ]”h"]”h$]”h&]”uh1j,hjÖubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh¶h KhjÓubj)”}”(hŒ¹rate - read reports the sampling rate of the accelerometer device in HZ. write changes sampling rate of the accelerometer device. Only values which are supported by HW are accepted.”h]”(j)”}”(hŒrate”h]”hŒrate”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh¶h K"hjubj-)”}”(hhh]”hÎ)”}”(hhh]”hÓ)”}”(hŒ®read reports the sampling rate of the accelerometer device in HZ. write changes sampling rate of the accelerometer device. Only values which are supported by HW are accepted.”h]”h¸)”}”(hŒ®read reports the sampling rate of the accelerometer device in HZ. write changes sampling rate of the accelerometer device. Only values which are supported by HW are accepted.”h]”hŒ®read reports the sampling rate of the accelerometer device in HZ. write changes sampling rate of the accelerometer device. Only values which are supported by HW are accepted.”…””}”(hj3hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K!hj/ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhj,ubah}”(h]”h ]”h"]”h$]”h&]”j j“uh1hÍhŸh¶h K!hj)ubah}”(h]”h ]”h"]”h$]”h&]”uh1j,hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh¶h K"hjÓhžhubj)”}”(hŒMselftest - performs selftest for the chip as specified by chip manufacturer. ”h]”(j)”}”(hŒselftest”h]”hŒselftest”…””}”(hj]hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh¶h K%hjYubj-)”}”(hhh]”hÎ)”}”(hhh]”hÓ)”}”(hŒBperforms selftest for the chip as specified by chip manufacturer. ”h]”h¸)”}”(hŒAperforms selftest for the chip as specified by chip manufacturer.”h]”hŒAperforms selftest for the chip as specified by chip manufacturer.”…””}”(hjuhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K%hjqubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjnubah}”(h]”h ]”h"]”h$]”h&]”j j“uh1hÍhŸh¶h K%hjkubah}”(h]”h ]”h"]”h$]”h&]”uh1j,hjYubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh¶h K%hjÓhžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhj¦hžhhŸNh Nubh¸)”}”(hXËThis driver also provides an absolute input class device, allowing the laptop to act as a pinball machine-esque joystick. Joystick device can be calibrated. Joystick device can be in two different modes. By default output values are scaled between -32768 .. 32767. In joystick raw mode, joystick and sysfs position entry have the same scale. There can be small difference due to input system fuzziness feature. Events are also available as input event device.”h]”hXËThis driver also provides an absolute input class device, allowing the laptop to act as a pinball machine-esque joystick. Joystick device can be calibrated. Joystick device can be in two different modes. By default output values are scaled between -32768 .. 32767. In joystick raw mode, joystick and sysfs position entry have the same scale. There can be small difference due to input system fuzziness feature. Events are also available as input event device.”…””}”(hj¡hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K'hj¦hžhubh¸)”}”(hXÿSelftest is meant only for hardware diagnostic purposes. It is not meant to be used during normal operations. Position data is not corrupted during selftest but interrupt behaviour is not guaranteed to work reliably. In test mode, the sensing element is internally moved little bit. Selftest measures difference between normal mode and test mode. Chip specifications tell the acceptance limit for each type of the chip. Limits are provided via platform data to allow adjustment of the limits without a change to the actual driver. Seltest returns either "OK x y z" or "FAIL x y z" where x, y and z are measured difference between modes. Axes are not remapped in selftest mode. Measurement values are provided to help HW diagnostic applications to make final decision.”h]”hXSelftest is meant only for hardware diagnostic purposes. It is not meant to be used during normal operations. Position data is not corrupted during selftest but interrupt behaviour is not guaranteed to work reliably. In test mode, the sensing element is internally moved little bit. Selftest measures difference between normal mode and test mode. Chip specifications tell the acceptance limit for each type of the chip. Limits are provided via platform data to allow adjustment of the limits without a change to the actual driver. Seltest returns either “OK x y z†or “FAIL x y z†where x, y and z are measured difference between modes. Axes are not remapped in selftest mode. Measurement values are provided to help HW diagnostic applications to make final decision.”…””}”(hj¯hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K/hj¦hžhubh¸)”}”(hŒ—On HP laptops, if the led infrastructure is activated, support for a led indicating disk protection will be provided as /sys/class/leds/hp::hddprotect.”h]”hŒ—On HP laptops, if the led infrastructure is activated, support for a led indicating disk protection will be provided as /sys/class/leds/hp::hddprotect.”…””}”(hj½hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K;hj¦hžhubh¸)”}”(hXÂAnother feature of the driver is misc device called "freefall" that acts similar to /dev/rtc and reacts on free-fall interrupts received from the device. It supports blocking operations, poll/select and fasync operation modes. You must read 1 bytes from the device. The result is number of free-fall interrupts since the last successful read (or 255 if number of interrupts would not fit). See the freefall.c file for an example on using the device.”h]”hXÆAnother feature of the driver is misc device called “freefall†that acts similar to /dev/rtc and reacts on free-fall interrupts received from the device. It supports blocking operations, poll/select and fasync operation modes. You must read 1 bytes from the device. The result is number of free-fall interrupts since the last successful read (or 255 if number of interrupts would not fit). See the freefall.c file for an example on using the device.”…””}”(hjËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K>hj¦hžhubeh}”(h]”Œ description”ah ]”h"]”Œ description”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒAxes orientation”h]”hŒAxes orientation”…””}”(hjähžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjáhžhhŸh¶h KHubh¸)”}”(hŒÂFor better compatibility between the various laptops. The values reported by the accelerometer are converted into a "standard" organisation of the axes (aka "can play neverball out of the box"):”h]”hŒÊFor better compatibility between the various laptops. The values reported by the accelerometer are converted into a “standard†organisation of the axes (aka “can play neverball out of the boxâ€):”…””}”(hjòhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KJhjáhžhubhÈ)”}”(hX:* When the laptop is horizontal the position reported is about 0 for X and Y and a positive value for Z * 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 laptop is put upside-down, Z becomes negative ”h]”hÎ)”}”(hhh]”(hÓ)”}”(hŒeWhen the laptop is horizontal the position reported is about 0 for X and Y and a positive value for Z”h]”h¸)”}”(hŒeWhen the laptop is horizontal the position reported is about 0 for X and Y and a positive value for Z”h]”hŒeWhen the laptop is horizontal the position reported is about 0 for X and Y and a positive value for Z”…””}”(hj hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KNhjubah}”(h]”h ]”h"]”h$]”h&]”uh1hÒhjubhÓ)”}”(hŒ