1.\" $NetBSD: harmony.4,v 1.3 2022/05/15 00:06:09 gutteridge 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 May 15, 2022 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 with a maximum 48000 Hz sample rate, 58and has stereo input and stereo output. 59.Pp 60On 61.Tn HP 9000/712 62models 63.Nm 64also provides two additional channels for an add-on 65card with two fax/voice modems. 66.Pp 67One of the hardware registers reflects the state of the 68.Tn CHI 69bus that is used to communicate with the codec and thus 70being sampled at a low accuracy secondary frequency 71(such as 72.Xr timeout 9 ) 73produces a poor quality random bit stream that is fed into the 74entropy pool of 75.Xr rnd 4 . 76.Sh MACHINES 77An incomplete list of machines that feature 78.Nm 79audio: 80.Pp 81.Bl -bullet -compact 82.It 83712/* 84.It 85715/* 86.It 87725/* 88.It 89735/* 90.It 91755/* 92.It 93B132L[+], B160L, B180L+ 94.It 95C100, C110, C132L, C160[L], C180, C200, C240, C360 96.It 97J200, J210[XC], J280, J282, J2240 98.El 99.Sh SEE ALSO 100.Xr hppa/ioctl 2 , 101.Xr audio 4 , 102.Xr hppa/gsc 4 , 103.Xr hppa/intro 4 , 104.Xr rnd 4 105.Sh HISTORY 106Support for 107.Nm 108first appeared in 109.Ox 3.3 . 110It was ported to 111.Nx 1.6 112by Chuck Silvers. 113.Sh CAVEATS 114To trigger entropy collection, the 115.Tn CHI 116bus has to be programmed into the data mode that happens once 117a single buffer of data has been played or recorded. 118