share/man/man4/sony.4

   1 .\" $NetBSD: sony.4,v 1.1 2007/12/23 17:39:20 jmcneill 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
  39 Some
  40 .Tn Sony
  41 notebook computers have a controller that handles various built-in
  42 devices.
  43 The
  44 .Nm
  45 driver provides support for accessing/modifying the settings of
  46 some of these devices via the
  47 .Xr sysctl 8
  48 interface.
  49 .Pp
  50 The following
  51 .Xr sysctl 8
  52 variables are available:
  53 .Pp
  54 .Bl -tag -width "hw.sony0.brt [R/W]" -compact
  55 .It Em hw.sony0.brt Bq R/W
  56 Controls current LCD brightness.
  57 Range [0-8].
  58 .It Em hw.sony0.pbr Bq R/W
  59 Controls power on LCD brightness.
  60 Range [0-8].
  61 .It Em hw.sony0.cdp Bq R/W
  62 Controls CD power.
  63 .It Em hw.sony0.pid Bq R/O
  64 Unknown
  65 .It Em hw.sony0.ctr Bq R/W
  66 Unknown
  67 .It Em hw.sony0.pcr Bq R/W
  68 Unknown
  69 .It Em hw.sony0.cmi Bq R/W
  70 Unknown
  71 .It Em hw.sony0.ams Bq R/W
  72 Audio control (mute when 0)
  73 .It Em hw.sony0.hke Bq R/O
  74 Indicates a Host Key Event.
  75 Bits are set when an event occurs and cleared when this value is
  76 read.
  77 The following table describes the bit set for each button pressed:
  78 .Pp
  79 .Bl -tag -width 0x1000 -offset indent -compact
  80 .It Em 0x1000
  81 S1 button
  82 .It Em 0x0800
  83 S2 button
  84 .It Em 0x0200
  85 Fn + F10 (magnify)
  86 .It Em 0x0100
  87 Mute button
  88 .It Em 0x0020
  89 Fn + F12 (suspend to disk)
  90 .It Em 0x0010
  91 Fn + F7 (LCD/external monitor)
  92 .It Em 0x0008
  93 Fn + F6 (brighter backlight)
  94 .It Em 0x0004
  95 Fn + F5 (darker backlight)
  96 .It Em 0x0002
  97 Fn + F4 (volume up)
  98 .It Em 0x0001
  99 Fn + F3 (volume down)
 100 .El
 101 .El
 102 .Sh SEE ALSO
 103 .Xr acpi 4 ,
 104 .Xr spic 4
 105 .Sh HISTORY
 106 The
 107 .Nm
 108 driver
 109 appeared in
 110 .Nx 4.0 .
 111 .Sh AUTHORS
 112 Sami Kantoluoto for the original driver and manual information.
 113 Christos Zoulas for cleaning up the driver and this manual page.
 114 .Sh BUGS
 115 .Bl -bullet
 116 .It
 117 The
 118 .Nm
 119 driver just parses integer values from the
 120 .Xr acpi 4
 121 tree.
 122 It could be more intelligent and parse other controls.
 123 .It
 124 The
 125 .Xr sysctl 8
 126 interface is not great.
 127 The names of the
 128 .Xr sysctl 8
 129 tree are not self-explanatory.
 130 .It
 131 No validity checks are performed on the user input.
 132 Playing with random values and/or unknown controls can harm your
 133 machine.
 134 .It
 135 The name of the driver is too generic.
 136 .El