share/man/man4/man4.hp700/harmony.4

   1 .\"     $NetBSD$
   2 .\"
   3 .\"     $OpenBSD: harmony.4,v 1.7 2004/03/15 13:27:48 miod Exp $
   4 .\"
   5 .\"
   6 .\" Copyright (c) 2003 Jason L. Wright (jason@thought.net)
   7 .\" All rights reserved.
   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 AUTHOR ``AS IS'' AND ANY EXPRESS OR
  19 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  20 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  21 .\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
  22 .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  23 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  24 .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  26 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  27 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd January 26, 2003
  31 .Dt HARMONY 4 hp700
  32 .Os
  33 .Sh NAME
  34 .Nm harmony
  35 .Nd CS4215/AD1849 audio interface
  36 .Sh SYNOPSIS
  37 .Cd "harmony* at gsc?"
  38 .Cd "audio*   at harmony?"
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 device uses the
  43 .Tn Crystal Semiconductor
  44 .Tn CS4215
  45 16-Bit Multimedia Audio Codec
  46 or
  47 .Tn Analog Devices
  48 .Tn AD1849
  49 .Tn SoundPort(R) Stereo Codec
  50 chip to implement the audio device interface described in
  51 .Xr audio 4 .
  52 This device is found on most
  53 .Tn HP PA-RISC
  54 workstations.
  55 The
  56 .Nm
  57 has a maximum precision of 16 bits and has a stereo input and stereo output.
  58 .Pp
  59 On
  60 .Tn HP 9000/712
  61 models
  62 .Nm
  63 also provides two additional channels for an add-on
  64 card with two fax/voice modems.
  65 .Pp
  66 One of the hardware registers reflects the state of the
  67 .Tn CHI
  68 bus that is used to communicate with the codec and thus
  69 being sampled at a low accuracy secondary frequency
  70 (such as
  71 .Xr timeout 9 )
  72 produces poor quality random bit stream that is fed into the
  73 entropy pool of
  74 .Xr rnd 4 .
  75 .Sh MACHINES
  76 An incomplete list of machines that feature
  77 .Nm
  78 audio:
  79 .Pp
  80 .Bl -bullet -compact
  81 .It
  82 712/*
  83 .It
  84 715/*
  85 .It
  86 725/*
  87 .It
  88 735/*
  89 .It
  90 755/*
  91 .It
  92 B132L[+], B160L, B180L+
  93 .It
  94 C100, C110, C132L, C160[L], C180, C200, C240, C360
  95 .It
  96 J200, J210[XC], J280, J282, J2240
  97 .El
  98 .Sh SEE ALSO
  99 .Xr ioctl 2 ,
 100 .Xr audio 4 ,
 101 .Xr gsc 4 ,
 102 .Xr intro 4 ,
 103 .Xr rnd 4
 104 .Sh HISTORY
 105 Support for
 106 .Nm
 107 first appeared in
 108 .Ox 3.3 .
 109 It was ported to
 110 .Nx 1.6
 111 by Chuck Silvers.
 112 .Sh CAVEATS
 113 To trigger entropy collection
 114 .Tn CHI
 115 bus has to be programmed into the data mode that happens once
 116 a single buffer of data has been played or recorded.