sonypi.txt
上传用户:lgb322
上传日期:2013-02-24
资源大小:30529k
文件大小:4k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. Sony Programmable I/O Control Device Driver Readme
  2. --------------------------------------------------
  3. Copyright (C) 2001 Stelian Pop <stelian.pop@fr.alcove.com>, Alc魐e
  4. Copyright (C) 2001 Michael Ashley <m.ashley@unsw.edu.au>
  5. Copyright (C) 2001 Junichi Morita <jun1m@mars.dti.ne.jp>
  6. Copyright (C) 2000 Takaya Kinjo <t-kinjo@tc4.so-net.ne.jp>
  7. Copyright (C) 2000 Andrew Tridgell <tridge@samba.org>
  8. This driver enables access to the Sony Programmable I/O Control Device which
  9. can be found in many (all ?) Sony Vaio laptops.
  10. It will give access (through a user space utility) to some events those laptops
  11. generate, like:
  12. - jogdial events (the small wheel on the side of Vaios)
  13. - capture button events (only on Vaio Picturebook series)
  14. - Fn keys
  15. - bluetooth button (only on C1VR model)
  16. - back button (PCG-GR7/K model)
  17. - lid open/close events (Z600NE model)
  18. Those events (see linux/sonypi.h) can be polled using the character device node
  19. /dev/sonypi (major 10, minor auto allocated or specified as a option).
  20. A simple daemon which translates the jogdial movements into mouse wheel events
  21. can be downloaded at: <http://www.alcove-labs.org/en/software/sonypi/>
  22. This driver supports also some ioctl commands for setting the LCD screen
  23. brightness and querying the batteries charge information (some more 
  24. commands may be added in the future).
  25. This driver can also be used to set the camera controls on Picturebook series
  26. (brightness, contrast etc), and is used by the video4linux driver for the 
  27. Motion Eye camera.
  28. Please note that this driver was created by reverse engineering the Windows
  29. driver and the ACPI BIOS, because Sony doesn't agree to release any programming
  30. specs for its laptops. If someone convinces them to do so, drop me a note.
  31. Module options:
  32. ---------------
  33. Several options can be passed to the sonypi driver, either by adding them
  34. to /etc/modules.conf file, when the driver is compiled as a module or by
  35. adding the following to the kernel command line (in your bootloader):
  36. sonypi=minor[[[[,camera],fnkeyinit],verbose],compat]
  37. where:
  38. minor:  minor number of the misc device /dev/sonypi, 
  39. default is -1 (automatic allocation, see /proc/misc
  40. or kernel logs)
  41. camera: if you have a PictureBook series Vaio (with the
  42. integrated MotionEye camera), set this parameter to 1
  43. in order to let the driver access to the camera
  44. fnkeyinit: on some Vaios (C1VE, C1VR etc), the Fn key events don't
  45. get enabled unless you set this parameter to 1.
  46. Do not use this option unless it's actually necessary,
  47. some Vaio models don't deal well with this option.
  48. This option is available only if the kernel is 
  49. compiled without ACPI support (since it conflicts
  50. with it and it shouldn't be required anyway if 
  51. ACPI is already enabled).
  52. verbose: print unknown events from the sonypi device
  53. compat: uses some compatibility code for enabling the sonypi
  54. events. If the driver worked for you in the past
  55. (prior to version 1.5) and does not work anymore,
  56. add this option and report to the author.
  57. Module use:
  58. -----------
  59. In order to automatically load the sonypi module on use, you can put those
  60. lines in your /etc/modules.conf file:
  61. alias char-major-10-250 sonypi
  62. options sonypi minor=250
  63. This supposes the use of minor 250 for the sonypi device:
  64. # mknod /dev/sonypi c 10 250
  65. Bugs:
  66. -----
  67. - several users reported that this driver disables the BIOS-managed
  68.   Fn-keys which put the laptop in sleeping state, or switch the
  69.   external monitor on/off. There is no workaround yet, since this
  70.   driver disables all APM management for those keys, by enabling the
  71.   ACPI management (and the ACPI core stuff is not complete yet). If
  72.   you have one of those laptops with working Fn keys and want to 
  73.   continue to use them, don't use this driver.
  74. - some users reported that the laptop speed is lower (dhrystone
  75.   tested) when using the driver with the fnkeyinit parameter. I cannot
  76.   reproduce it on my laptop and not all users have this problem.
  77.   This happens because the fnkeyinit parameter enables the ACPI 
  78.   mode (but without additionnal ACPI control, like processor 
  79.   speed handling etc). Use ACPI instead of APM if it works on your
  80.   laptop.
  81. - since all development was done by reverse engineering, there is
  82.   _absolutely no guarantee_ that this driver will not crash your
  83.   laptop. Permanently.