1.\" $NetBSD: harmony.4,v 1.2 2017/02/17 22:24:46 christos Exp $ 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 February 17, 2017 31.Dt HARMONY 4 hppa 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 40The 41.Nm 42device uses the 43.Tn Crystal Semiconductor 44.Tn CS4215 4516-Bit Multimedia Audio Codec 46or 47.Tn Analog Devices 48.Tn AD1849 49.Tn SoundPort(R) Stereo Codec 50chip to implement the audio device interface described in 51.Xr audio 4 . 52This device is found on most 53.Tn HP PA-RISC 54workstations. 55The 56.Nm 57has a maximum precision of 16 bits and has a stereo input and stereo output. 58.Pp 59On 60.Tn HP 9000/712 61models 62.Nm 63also provides two additional channels for an add-on 64card with two fax/voice modems. 65.Pp 66One of the hardware registers reflects the state of the 67.Tn CHI 68bus that is used to communicate with the codec and thus 69being sampled at a low accuracy secondary frequency 70(such as 71.Xr timeout 9 ) 72produces poor quality random bit stream that is fed into the 73entropy pool of 74.Xr rnd 4 . 75.Sh MACHINES 76An incomplete list of machines that feature 77.Nm 78audio: 79.Pp 80.Bl -bullet -compact 81.It 82712/* 83.It 84715/* 85.It 86725/* 87.It 88735/* 89.It 90755/* 91.It 92B132L[+], B160L, B180L+ 93.It 94C100, C110, C132L, C160[L], C180, C200, C240, C360 95.It 96J200, J210[XC], J280, J282, J2240 97.El 98.Sh SEE ALSO 99.Xr hppa/ioctl 2 , 100.Xr audio 4 , 101.Xr hppa/gsc 4 , 102.Xr hppa/intro 4 , 103.Xr rnd 4 104.Sh HISTORY 105Support for 106.Nm 107first appeared in 108.Ox 3.3 . 109It was ported to 110.Nx 1.6 111by Chuck Silvers. 112.Sh CAVEATS 113To trigger entropy collection 114.Tn CHI 115bus has to be programmed into the data mode that happens once 116a single buffer of data has been played or recorded. 117