1.\" $NetBSD: sony.4,v 1.2 2008/04/30 13:10:54 martin Exp $ 2.\" 3.\" Copyright (c) 2005 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Christos Zoulas. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd December 23, 2007 31.Dt SONY 4 32.Os 33.Sh NAME 34.Nm sony 35.Nd Sony Miscellaneous Controller 36.Sh SYNOPSIS 37.Cd "sony* at acpi?" 38.Sh DESCRIPTION 39Some 40.Tn Sony 41notebook computers have a controller that handles various built-in 42devices. 43The 44.Nm 45driver provides support for accessing/modifying the settings of 46some of these devices via the 47.Xr sysctl 8 48interface. 49.Pp 50The following 51.Xr sysctl 8 52variables are available: 53.Pp 54.Bl -tag -width "hw.sony0.brt [R/W]" -compact 55.It Em hw.sony0.brt Bq R/W 56Controls current LCD brightness. 57Range [0-8]. 58.It Em hw.sony0.pbr Bq R/W 59Controls power on LCD brightness. 60Range [0-8]. 61.It Em hw.sony0.cdp Bq R/W 62Controls CD power. 63.It Em hw.sony0.pid Bq R/O 64Unknown 65.It Em hw.sony0.ctr Bq R/W 66Unknown 67.It Em hw.sony0.pcr Bq R/W 68Unknown 69.It Em hw.sony0.cmi Bq R/W 70Unknown 71.It Em hw.sony0.ams Bq R/W 72Audio control (mute when 0) 73.It Em hw.sony0.hke Bq R/O 74Indicates a Host Key Event. 75Bits are set when an event occurs and cleared when this value is 76read. 77The following table describes the bit set for each button pressed: 78.Pp 79.Bl -tag -width 0x1000 -offset indent -compact 80.It Em 0x1000 81S1 button 82.It Em 0x0800 83S2 button 84.It Em 0x0200 85Fn + F10 (magnify) 86.It Em 0x0100 87Mute button 88.It Em 0x0020 89Fn + F12 (suspend to disk) 90.It Em 0x0010 91Fn + F7 (LCD/external monitor) 92.It Em 0x0008 93Fn + F6 (brighter backlight) 94.It Em 0x0004 95Fn + F5 (darker backlight) 96.It Em 0x0002 97Fn + F4 (volume up) 98.It Em 0x0001 99Fn + F3 (volume down) 100.El 101.El 102.Sh SEE ALSO 103.Xr acpi 4 , 104.Xr spic 4 105.Sh HISTORY 106The 107.Nm 108driver 109appeared in 110.Nx 4.0 . 111.Sh AUTHORS 112Sami Kantoluoto for the original driver and manual information. 113Christos Zoulas for cleaning up the driver and this manual page. 114.Sh BUGS 115.Bl -bullet 116.It 117The 118.Nm 119driver just parses integer values from the 120.Xr acpi 4 121tree. 122It could be more intelligent and parse other controls. 123.It 124The 125.Xr sysctl 8 126interface is not great. 127The names of the 128.Xr sysctl 8 129tree are not self-explanatory. 130.It 131No validity checks are performed on the user input. 132Playing with random values and/or unknown controls can harm your 133machine. 134.It 135The name of the driver is too generic. 136.El 137