1 ==============================================
2 Sony Programmable I/O Control Device Driver Re
3 ==============================================
4
5 - Copyright (C) 2001-2004 Stelian Pop <
6 - Copyright (C) 2001-2002 Alcôve <www
7 - Copyright (C) 2001 Michael Ashley <m.
8 - Copyright (C) 2001 Junichi Morita <ju
9 - Copyright (C) 2000 Takaya Kinjo <t-ki
10 - Copyright (C) 2000 Andrew Tridgell <t
11
12 This driver enables access to the Sony Program
13 can be found in many Sony Vaio laptops. Some n
14 limited to new FX series laptops, at least the
15 sonypi device and are not supported at all by
16
17 It will give access (through a user space util
18 generate, like:
19
20 - jogdial events (the small wheel on t
21 - capture button events (only on Vaio
22 - Fn keys
23 - bluetooth button (only on C1VR model
24 - programmable keys, back, help, zoom,
25 (when available)
26
27 Those events (see linux/sonypi.h) can be polle
28 /dev/sonypi (major 10, minor auto allocated or
29 A simple daemon which translates the jogdial m
30 can be downloaded at: <http://popies.net/sonyp
31
32 Another option to intercept the events is to g
33 input layer.
34
35 This driver supports also some ioctl commands
36 brightness and querying the batteries charge i
37 commands may be added in the future).
38
39 This driver can also be used to set the camera
40 (brightness, contrast etc), and is used by the
41 Motion Eye camera.
42
43 Please note that this driver was created by re
44 driver and the ACPI BIOS, because Sony doesn't
45 specs for its laptops. If someone convinces th
46
47 Driver options:
48 ---------------
49
50 Several options can be passed to the sonypi dr
51 module argument syntax (<param>=<value> when p
52 module or sonypi.<param>=<value> on the kernel
53 statically linked into the kernel). Those opti
54
55 =============== ======================
56 minor: minor number of the mi
57 default is -1 (automat
58 or kernel logs)
59
60 camera: if you have a PictureB
61 integrated MotionEye c
62 in order to let the dr
63
64 fnkeyinit: on some Vaios (C1VE, C
65 get enabled unless you
66 Do not use this option
67 some Vaio models don't
68 This option is availab
69 compiled without ACPI
70 with it and it shouldn
71 ACPI is already enable
72
73 verbose: set to 1 to print unkn
74 sonypi device.
75 set to 2 to print all
76 sonypi device.
77
78 compat: uses some compatibilit
79 events. If the driver
80 (prior to version 1.5)
81 add this option and re
82
83 mask: event mask telling the
84 reported to the user.
85 some Vaio models where
86 used in other Vaio mod
87 not have a jogdial but
88 programmable keys even
89 set to 0xffffffff, mea
90 will be tried. You can
91 construct your own eve
92 drivers/char/sonypi.h)
93
94 SONYPI_JOGGER_
95 SONYPI_CAPTURE
96 SONYPI_FNKEY_M
97 SONYPI_BLUETOO
98 SONYPI_PKEY_MA
99 SONYPI_BACK_MA
100 SONYPI_HELP_MA
101 SONYPI_LID_MAS
102 SONYPI_ZOOM_MA
103 SONYPI_THUMBPH
104 SONYPI_MEYE_MA
105 SONYPI_MEMORYS
106 SONYPI_BATTERY
107 SONYPI_WIRELES
108
109 useinput: if set (which is the d
110 created, one which int
111 mouse events, the othe
112 keyboard reporting the
113 =============== ======================
114
115 Module use:
116 -----------
117
118 In order to automatically load the sonypi modu
119 lines a configuration file in /etc/modprobe.d/
120
121 alias char-major-10-250 sonypi
122 options sonypi minor=250
123
124 This supposes the use of minor 250 for the son
125
126 # mknod /dev/sonypi c 10 250
127
128 Bugs:
129 -----
130
131 - several users reported that this dri
132 Fn-keys which put the laptop in slee
133 external monitor on/off. There is no
134 driver disables all APM management f
135 ACPI management (and the ACPI core s
136 you have one of those laptops with w
137 continue to use them, don't use this
138
139 - some users reported that the laptop
140 tested) when using the driver with t
141 reproduce it on my laptop and not al
142 This happens because the fnkeyinit p
143 mode (but without additional ACPI co
144 speed handling etc). Use ACPI instea
145 laptop.
146
147 - sonypi lacks the ability to distingu
148 events on some models.
149
150 - some models with the nvidia card (ge
151 different way to adjust the backligh
152 is a userspace utility to adjust the
153 which can be downloaded from
154 https://www.acc.umu.se/~erikw/progra
155
156 - since all development was done by re
157 *absolutely no guarantee* that this
158 laptop. Permanently.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.