1 ==================
2 Asus Laptop Extras
3 ==================
4
5 Version 0.1
6
7 August 6, 2009
8
9 Corentin Chary <corentincj@iksaif.net>
10 http://acpi4asus.sf.net/
11
12 This driver provides support for extra featur
13 It may also support some MEDION, JVC or VICTO
14 VICTOR XP7210 for example). It makes all the
15 events (like keyboards).
16
17 On some models adds support for changing the
18 switching the LCD backlight on and off, and m
19 blink those fancy LEDs intended for reporting
20
21 This driver supersedes the old asus_acpi drive
22
23 Requirements
24 ------------
25
26 Kernel 2.6.X sources, configured for your co
27 You also need CONFIG_INPUT and CONFIG_ACPI.
28
29 Status
30 ------
31
32 The features currently supported are the foll
33 detailed description):
34
35 - Fn key combinations
36 - Bluetooth enable and disable
37 - Wlan enable and disable
38 - GPS enable and disable
39 - Video output switching
40 - Ambient Light Sensor on and off
41 - LED control
42 - LED Display control
43 - LCD brightness control
44 - LCD on and off
45
46 A compatibility table by model and feature is
47 site, http://acpi4asus.sf.net/.
48
49 Usage
50 -----
51
52 Try "modprobe asus-laptop". Check your dmesg
53 see some lines like this :
54
55 Asus Laptop Extras version 0.42
56 - L2D model detected.
57
58 If it is not the output you have on your lap
59 DSDT) to me.
60
61 That's all, now, all the events generated by
62 should be reported via netlink events. You c
63 "acpi_genl monitor" (part of the acpica proj
64
65 Hotkeys are also reported as input keys (lik
66 which key are supported using "xev" under X1
67
68 You can get information on the version of yo
69 /sys/devices/platform/asus-laptop/infos entr
70 bug report to do, please include the output
71
72 LEDs
73 ----
74
75 You can modify LEDs be echoing values to `/s
76
77 echo 1 > /sys/class/leds/asus::mail/brigh
78
79 will switch the mail LED on.
80
81 You can also know if they are on/off by read
82 kernel triggers like disk-activity or heartb
83
84 Backlight
85 ---------
86
87 You can control lcd backlight power and brig
88 /sys/class/backlight/asus-laptop/. Brightnes
89
90 Wireless devices
91 ----------------
92
93 You can turn the internal Bluetooth adapter
94 (only on models with Bluetooth). This usuall
95 Same for Wlan adapter.
96
97 Display switching
98 -----------------
99
100 Note: the display switching code is currentl
101
102 Switching works for the following models:
103
104 - L3800C
105 - A2500H
106 - L5800C
107 - M5200N
108 - W1000N (albeit with some glitches)
109 - M6700R
110 - A6JC
111 - F3J
112
113 Switching doesn't work for the following:
114
115 - M3700N
116 - L2X00D (locks the laptop under certain c
117
118 To switch the displays, echo values from 0 t
119 /sys/devices/platform/asus-laptop/display. T
120 is as follows:
121
122 +-------+-----+-----+-----+-----+-----+
123 | Bin | Val | DVI | TV | CRT | LCD |
124 +-------+-----+-----+-----+-----+-----+
125 | 0000 | 0 | | | | |
126 +-------+-----+-----+-----+-----+-----+
127 | 0001 | 1 | | | | X |
128 +-------+-----+-----+-----+-----+-----+
129 | 0010 | 2 | | | X | |
130 +-------+-----+-----+-----+-----+-----+
131 | 0011 | 3 | | | X | X |
132 +-------+-----+-----+-----+-----+-----+
133 | 0100 | 4 | | X | | |
134 +-------+-----+-----+-----+-----+-----+
135 | 0101 | 5 | | X | | X |
136 +-------+-----+-----+-----+-----+-----+
137 | 0110 | 6 | | X | X | |
138 +-------+-----+-----+-----+-----+-----+
139 | 0111 | 7 | | X | X | X |
140 +-------+-----+-----+-----+-----+-----+
141 | 1000 | 8 | X | | | |
142 +-------+-----+-----+-----+-----+-----+
143 | 1001 | 9 | X | | | X |
144 +-------+-----+-----+-----+-----+-----+
145 | 1010 | 10 | X | | X | |
146 +-------+-----+-----+-----+-----+-----+
147 | 1011 | 11 | X | | X | X |
148 +-------+-----+-----+-----+-----+-----+
149 | 1100 | 12 | X | X | | |
150 +-------+-----+-----+-----+-----+-----+
151 | 1101 | 13 | X | X | | X |
152 +-------+-----+-----+-----+-----+-----+
153 | 1110 | 14 | X | X | X | |
154 +-------+-----+-----+-----+-----+-----+
155 | 1111 | 15 | X | X | X | X |
156 +-------+-----+-----+-----+-----+-----+
157
158 In most cases, the appropriate displays must
159 combinations to work. TV-Out may need to be
160
161 Debugging:
162
163 1) Check whether the Fn+F8 key:
164
165 a) does not lock the laptop (try a boot w
166 b) generates events (0x6n, where n is the
167 configuration above)
168 c) actually works
169
170 Record the disp value at every configurat
171 2) Echo values from 0 to 15 to /sys/devices/
172 Record its value, note any change. If not
173 up to 65535.
174 3) Send ANY output (both positive and negati
175 machine is already listed above) to the a
176
177 Note: on some machines (e.g. L3C), after the
178 events are generated and no actual switching
179 like::
180
181 echo $((10#$arg-60)) > /sys/devices/platfo
182
183 will usually do the trick ($arg is the 00000
184
185 Note: there is currently no reliable way to
186 (Centrino) models.
187
188 LED display
189 -----------
190
191 Some models like the W1N have a LED display
192 several items of information.
193
194 LED display works for the following models:
195
196 - W1000N
197 - W1J
198
199 To control the LED display, use the followin
200
201 echo 0x0T000DDD > /sys/devices/platform/as
202
203 where T control the 3 letters display, and D
204 according to the tables below::
205
206 DDD (digits)
207 000 to 999 = display digits
208 AAA = ---
209 BBB to FFF = turn-off
210
211 T (type)
212 0 = off
213 1 = dvd
214 2 = vcd
215 3 = mp3
216 4 = cd
217 5 = tv
218 6 = cpu
219 7 = vol
220
221 For example "echo 0x01000001 >/sys/devices/p
222 would display "DVD001".
223
224 Driver options
225 --------------
226
227 Options can be passed to the asus-laptop driv
228 module argument syntax (<param>=<value> when
229 module or asus-laptop.<param>=<value> on the
230 asus-laptop is statically linked into the ker
231
232 wapf: WAPF defines the behavior o
233 The significance of values
234 most of the time:
235
236 - 0x0 should do nothing
237 - 0x1 should allow to contr
238 - 0x4 should send an ACPI e
239 - 0x5 like 0x1 or 0x4
240
241 The default value is 0x1.
242
243 Unsupported models
244 ------------------
245
246 These models will never be supported by this
247 different mechanism to handle LEDs and extra
248 how it works):
249
250 - ASUS A1300 (A1B), A1370D
251 - ASUS L7300G
252 - ASUS L8400
253
254 Patches, Errors, Questions
255 --------------------------
256
257 I appreciate any success or failure
258 reports, especially if they add to or correct
259 Please include the following information in y
260
261 - Asus model name
262 - a copy of your ACPI tables, using the "acpi
263 - a copy of /sys/devices/platform/asus-laptop
264 - which driver features work and which don't
265 - the observed behavior of non-working featur
266
267 Any other comments or patches are also more t
268
269 acpi4asus-user@lists.sourceforge.net
270
271 http://sourceforge.net/projects/acpi4asus
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.