Commit | Line | Data |
---|---|---|
ab5bd206 MD |
1 | Sony Notebook Control Driver (SNC) Readme |
2 | ----------------------------------------- | |
3 | Copyright (C) 2004- 2005 Stelian Pop <stelian@popies.net> | |
4 | Copyright (C) 2007 Mattia Dongili <malattia@linux.it> | |
5 | ||
3d2b8a9f | 6 | This mini-driver drives the SNC and SPIC device present in the ACPI BIOS of the |
7 | Sony Vaio laptops. This driver mixes both devices functions under the same | |
8 | (hopefully consistent) interface. This also means that the sonypi driver is | |
9 | obsoleted by sony-laptop now. | |
ab5bd206 | 10 | |
3d2b8a9f | 11 | Fn keys (hotkeys): |
12 | ------------------ | |
13 | Some models report hotkeys through the SNC or SPIC devices, such events are | |
14 | reported both through the ACPI subsystem as acpi events and through the INPUT | |
15 | subsystem. See the logs of acpid or /proc/acpi/event and | |
16 | /proc/bus/input/devices to find out what those events are and which input | |
54286fd0 MD |
17 | devices are created by the driver. Additionally, loading the driver with the |
18 | debug option will report all events in the kernel log. | |
ab5bd206 MD |
19 | |
20 | Backlight control: | |
21 | ------------------ | |
22 | If your laptop model supports it, you will find sysfs files in the | |
23 | /sys/class/backlight/sony/ | |
24 | directory. You will be able to query and set the current screen | |
25 | brightness: | |
19f59460 | 26 | brightness get/set screen brightness (an integer |
ab5bd206 MD |
27 | between 0 and 7) |
28 | actual_brightness reading from this file will query the HW | |
29 | to get real brightness value | |
30 | max_brightness the maximum brightness value | |
31 | ||
32 | ||
33 | Platform specific: | |
34 | ------------------ | |
35 | Loading the sony-laptop module will create a | |
36 | /sys/devices/platform/sony-laptop/ | |
37 | directory populated with some files. | |
38 | ||
39 | You then read/write integer values from/to those files by using | |
40 | standard UNIX tools. | |
41 | ||
42 | The files are: | |
43 | brightness_default screen brightness which will be set | |
44 | when the laptop will be rebooted | |
45 | cdpower power on/off the internal CD drive | |
46 | audiopower power on/off the internal sound card | |
47 | lanpower power on/off the internal ethernet card | |
48 | (only in debug mode) | |
3d2b8a9f | 49 | bluetoothpower power on/off the internal bluetooth device |
50 | fanspeed get/set the fan speed | |
ab5bd206 MD |
51 | |
52 | Note that some files may be missing if they are not supported | |
53 | by your particular laptop model. | |
54 | ||
55 | Example usage: | |
56 | # echo "1" > /sys/devices/platform/sony-laptop/brightness_default | |
57 | sets the lowest screen brightness for the next and later reboots, | |
58 | # echo "8" > /sys/devices/platform/sony-laptop/brightness_default | |
59 | sets the highest screen brightness for the next and later reboots, | |
60 | # cat /sys/devices/platform/sony-laptop/brightness_default | |
61 | retrieves the value. | |
62 | ||
63 | # echo "0" > /sys/devices/platform/sony-laptop/audiopower | |
64 | powers off the sound card, | |
65 | # echo "1" > /sys/devices/platform/sony-laptop/audiopower | |
66 | powers on the sound card. | |
67 | ||
54286fd0 MD |
68 | |
69 | RFkill control: | |
70 | --------------- | |
71 | More recent Vaio models expose a consistent set of ACPI methods to | |
72 | control radio frequency emitting devices. If you are a lucky owner of | |
73 | such a laptop you will find the necessary rfkill devices under | |
74 | /sys/class/rfkill. Check those starting with sony-* in | |
75 | # grep . /sys/class/rfkill/*/{state,name} | |
76 | ||
77 | ||
ab5bd206 MD |
78 | Development: |
79 | ------------ | |
80 | ||
81 | If you want to help with the development of this driver (and | |
82 | you are not afraid of any side effects doing strange things with | |
83 | your ACPI BIOS could have on your laptop), load the driver and | |
84 | pass the option 'debug=1'. | |
85 | ||
86 | REPEAT: DON'T DO THIS IF YOU DON'T LIKE RISKY BUSINESS. | |
87 | ||
88 | In your kernel logs you will find the list of all ACPI methods | |
54286fd0 MD |
89 | the SNC device has on your laptop. |
90 | ||
91 | * For new models you will see a long list of meaningless method names, | |
92 | reading the DSDT table source should reveal that: | |
93 | (1) the SNC device uses an internal capability lookup table | |
94 | (2) SN00 is used to find values in the lookup table | |
95 | (3) SN06 and SN07 are used to call into the real methods based on | |
96 | offsets you can obtain iterating the table using SN00 | |
97 | (4) SN02 used to enable events. | |
98 | Some values in the capability lookup table are more or less known, see | |
99 | the code for all sony_call_snc_handle calls, others are more obscure. | |
100 | ||
101 | * For old models you can see the GCDP/GCDP methods used to pwer on/off | |
102 | the CD drive, but there are others and they are usually different from | |
103 | model to model. | |
ab5bd206 MD |
104 | |
105 | I HAVE NO IDEA WHAT THOSE METHODS DO. | |
106 | ||
107 | The sony-laptop driver creates, for some of those methods (the most | |
108 | current ones found on several Vaio models), an entry under | |
109 | /sys/devices/platform/sony-laptop, just like the 'cdpower' one. | |
110 | You can create other entries corresponding to your own laptop methods by | |
3d2b8a9f | 111 | further editing the source (see the 'sony_nc_values' table, and add a new |
ab5bd206 | 112 | entry to this table with your get/set method names using the |
3d2b8a9f | 113 | SNC_HANDLE_NAMES macro). |
ab5bd206 MD |
114 | |
115 | Your mission, should you accept it, is to try finding out what | |
116 | those entries are for, by reading/writing random values from/to those | |
117 | files and find out what is the impact on your laptop. | |
118 | ||
119 | Should you find anything interesting, please report it back to me, | |
120 | I will not disavow all knowledge of your actions :) | |
121 | ||
3d2b8a9f | 122 | See also http://www.linux.it/~malattia/wiki/index.php/Sony_drivers for other |
123 | useful info. | |
124 | ||
ab5bd206 MD |
125 | Bugs/Limitations: |
126 | ----------------- | |
127 | ||
128 | * This driver is not based on official documentation from Sony | |
129 | (because there is none), so there is no guarantee this driver | |
130 | will work at all, or do the right thing. Although this hasn't | |
131 | happened to me, this driver could do very bad things to your | |
132 | laptop, including permanent damage. | |
133 | ||
134 | * The sony-laptop and sonypi drivers do not interact at all. In the | |
54286fd0 | 135 | future, sonypi will be removed and replaced by sony-laptop. |
ab5bd206 MD |
136 | |
137 | * spicctrl, which is the userspace tool used to communicate with the | |
54286fd0 MD |
138 | sonypi driver (through /dev/sonypi) is deprecated as well since all |
139 | its features are now available under the sysfs tree via sony-laptop. |