1 =========================================
2 Sony Notebook Control Driver (SNC) Readme
3 =========================================
4
5 - Copyright (C) 2004- 2005 Stelian Pop<
6 - Copyright (C) 2007 Mattia Dongili <ma
7
8 This mini-driver drives the SNC and SPIC devic
9 Sony Vaio laptops. This driver mixes both devi
10 (hopefully consistent) interface. This also me
11 obsoleted by sony-laptop now.
12
13 Fn keys (hotkeys):
14 ------------------
15
16 Some models report hotkeys through the SNC or
17 reported both through the ACPI subsystem as ac
18 subsystem. See the logs of /proc/bus/input/dev
19 events are and which input devices are created
20 Additionally, loading the driver with the debu
21 in the kernel log.
22
23 The "scancodes" passed to the input system (th
24 are indexes to the table "sony_laptop_input_ke
25 module. For example the "FN/E" key combinatio
26 generates the scancode 20 (0x14).
27
28 Backlight control:
29 ------------------
30 If your laptop model supports it, you will fin
31 /sys/class/backlight/sony/
32 directory. You will be able to query and set t
33 brightness:
34
35 ====================== ==============
36 brightness get/set screen
37 between 0 and
38 actual_brightness reading from t
39 to get real br
40 max_brightness the maximum br
41 ====================== ==============
42
43
44 Platform specific:
45 ------------------
46 Loading the sony-laptop module will create a
47 /sys/devices/platform/sony-laptop/
48 directory populated with some files.
49
50 You then read/write integer values from/to tho
51 standard UNIX tools.
52
53 The files are:
54
55 ====================== ==============
56 brightness_default screen brightn
57 when the lapto
58 cdpower power on/off t
59 audiopower power on/off t
60 lanpower power on/off t
61 (only in debug
62 bluetoothpower power on/off t
63 fanspeed get/set the fa
64 ====================== ==============
65
66 Note that some files may be missing if they ar
67 by your particular laptop model.
68
69 Example usage::
70
71 # echo "1" > /sys/devices/platform/son
72
73 sets the lowest screen brightness for the next
74
75 ::
76
77 # echo "8" > /sys/devices/platform/son
78
79 sets the highest screen brightness for the nex
80
81 ::
82
83 # cat /sys/devices/platform/sony-lapto
84
85 retrieves the value
86
87 ::
88
89 # echo "0" > /sys/devices/platform/son
90
91 powers off the sound card
92
93 ::
94
95 # echo "1" > /sys/devices/platform/son
96
97 powers on the sound card.
98
99
100 RFkill control:
101 ---------------
102 More recent Vaio models expose a consistent se
103 control radio frequency emitting devices. If y
104 such a laptop you will find the necessary rfki
105 /sys/class/rfkill. Check those starting with s
106
107 # grep . /sys/class/rfkill/*/{state,na
108
109
110 Development:
111 ------------
112
113 If you want to help with the development of th
114 you are not afraid of any side effects doing s
115 your ACPI BIOS could have on your laptop), loa
116 pass the option 'debug=1'.
117
118 REPEAT:
119 **DON'T DO THIS IF YOU DON'T LIKE RISK
120
121 In your kernel logs you will find the list of
122 the SNC device has on your laptop.
123
124 * For new models you will see a long list of m
125 reading the DSDT table source should reveal
126
127 (1) the SNC device uses an internal capability
128 (2) SN00 is used to find values in the lookup
129 (3) SN06 and SN07 are used to call into the re
130 offsets you can obtain iterating the table
131 (4) SN02 used to enable events.
132
133 Some values in the capability lookup table are
134 the code for all sony_call_snc_handle calls, o
135
136 * For old models you can see the GCDP/GCDP met
137 the CD drive, but there are others and they
138 model to model.
139
140 **I HAVE NO IDEA WHAT THOSE METHODS DO.**
141
142 The sony-laptop driver creates, for some of th
143 current ones found on several Vaio models), an
144 /sys/devices/platform/sony-laptop, just like t
145 You can create other entries corresponding to
146 further editing the source (see the 'sony_nc_v
147 entry to this table with your get/set method n
148 SNC_HANDLE_NAMES macro).
149
150 Your mission, should you accept it, is to try
151 those entries are for, by reading/writing rand
152 files and find out what is the impact on your
153
154 Should you find anything interesting, please r
155 I will not disavow all knowledge of your actio
156
157 See also http://www.linux.it/~malattia/wiki/in
158 useful info.
159
160 Bugs/Limitations:
161 -----------------
162
163 * This driver is not based on official documen
164 (because there is none), so there is no guar
165 will work at all, or do the right thing. Alt
166 happened to me, this driver could do very ba
167 laptop, including permanent damage.
168
169 * The sony-laptop and sonypi drivers do not in
170 future, sonypi will be removed and replaced
171
172 * spicctrl, which is the userspace tool used t
173 sonypi driver (through /dev/sonypi) is depre
174 its features are now available under the sys
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.