1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ 2#ifndef _ULTRASOUND_H_ 3#define _ULTRASOUND_H_ 4/* 5 * ultrasound.h - Macros for programming the Gravis Ultrasound 6 * These macros are extremely device dependent 7 * and not portable. 8 */ 9/* 10 * Copyright (C) by Hannu Savolainen 1993-1997 11 * 12 * OSS/Free for Linux is distributed under the GNU GENERAL PUBLIC LICENSE (GPL) 13 * Version 2 (June 1991). See the "COPYING" file distributed with this software 14 * for more info. 15 */ 16 17 18/* 19 * Private events for Gravis Ultrasound (GUS) 20 * 21 * Format: 22 * byte 0 - SEQ_PRIVATE (0xfe) 23 * byte 1 - Synthesizer device number (0-N) 24 * byte 2 - Command (see below) 25 * byte 3 - Voice number (0-31) 26 * bytes 4 and 5 - parameter P1 (unsigned short) 27 * bytes 6 and 7 - parameter P2 (unsigned short) 28 * 29 * Commands: 30 * Each command affects one voice defined in byte 3. 31 * Unused parameters (P1 and/or P2 *MUST* be initialized to zero). 32 * _GUS_NUMVOICES - Sets max. number of concurrent voices (P1=14-31, default 16) 33 * _GUS_VOICESAMPLE- ************ OBSOLETE ************* 34 * _GUS_VOICEON - Starts voice (P1=voice mode) 35 * _GUS_VOICEOFF - Stops voice (no parameters) 36 * _GUS_VOICEFADE - Stops the voice smoothly. 37 * _GUS_VOICEMODE - Alters the voice mode, don't start or stop voice (P1=voice mode) 38 * _GUS_VOICEBALA - Sets voice balance (P1, 0=left, 7=middle and 15=right, default 7) 39 * _GUS_VOICEFREQ - Sets voice (sample) playback frequency (P1=Hz) 40 * _GUS_VOICEVOL - Sets voice volume (P1=volume, 0xfff=max, 0xeff=half, 0x000=off) 41 * _GUS_VOICEVOL2 - Sets voice volume (P1=volume, 0xfff=max, 0xeff=half, 0x000=off) 42 * (Like GUS_VOICEVOL but doesn't change the hw 43 * volume. It just updates volume in the voice table). 44 * 45 * _GUS_RAMPRANGE - Sets limits for volume ramping (P1=low volume, P2=high volume) 46 * _GUS_RAMPRATE - Sets the speed for volume ramping (P1=scale, P2=rate) 47 * _GUS_RAMPMODE - Sets the volume ramping mode (P1=ramping mode) 48 * _GUS_RAMPON - Starts volume ramping (no parameters) 49 * _GUS_RAMPOFF - Stops volume ramping (no parameters) 50 * _GUS_VOLUME_SCALE - Changes the volume calculation constants 51 * for all voices. 52 */ 53 54#define _GUS_NUMVOICES 0x00 55#define _GUS_VOICESAMPLE 0x01 /* OBSOLETE */ 56#define _GUS_VOICEON 0x02 57#define _GUS_VOICEOFF 0x03 58#define _GUS_VOICEMODE 0x04 59#define _GUS_VOICEBALA 0x05 60#define _GUS_VOICEFREQ 0x06 61#define _GUS_VOICEVOL 0x07 62#define _GUS_RAMPRANGE 0x08 63#define _GUS_RAMPRATE 0x09 64#define _GUS_RAMPMODE 0x0a 65#define _GUS_RAMPON 0x0b 66#define _GUS_RAMPOFF 0x0c 67#define _GUS_VOICEFADE 0x0d 68#define _GUS_VOLUME_SCALE 0x0e 69#define _GUS_VOICEVOL2 0x0f 70#define _GUS_VOICE_POS 0x10 71 72/* 73 * GUS API macros 74 */ 75 76#define _GUS_CMD(chn, voice, cmd, p1, p2) \ 77 {_SEQ_NEEDBUF(8); _seqbuf[_seqbufptr] = SEQ_PRIVATE;\ 78 _seqbuf[_seqbufptr+1] = (chn); _seqbuf[_seqbufptr+2] = cmd;\ 79 _seqbuf[_seqbufptr+3] = voice;\ 80 *(unsigned short*)&_seqbuf[_seqbufptr+4] = p1;\ 81 *(unsigned short*)&_seqbuf[_seqbufptr+6] = p2;\ 82 _SEQ_ADVBUF(8);} 83 84#define GUS_NUMVOICES(chn, p1) _GUS_CMD(chn, 0, _GUS_NUMVOICES, (p1), 0) 85#define GUS_VOICESAMPLE(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICESAMPLE, (p1), 0) /* OBSOLETE */ 86#define GUS_VOICEON(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEON, (p1), 0) 87#define GUS_VOICEOFF(chn, voice) _GUS_CMD(chn, voice, _GUS_VOICEOFF, 0, 0) 88#define GUS_VOICEFADE(chn, voice) _GUS_CMD(chn, voice, _GUS_VOICEFADE, 0, 0) 89#define GUS_VOICEMODE(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEMODE, (p1), 0) 90#define GUS_VOICEBALA(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEBALA, (p1), 0) 91#define GUS_VOICEFREQ(chn, voice, p) _GUS_CMD(chn, voice, _GUS_VOICEFREQ, \ 92 (p) & 0xffff, ((p) >> 16) & 0xffff) 93#define GUS_VOICEVOL(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEVOL, (p1), 0) 94#define GUS_VOICEVOL2(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_VOICEVOL2, (p1), 0) 95#define GUS_RAMPRANGE(chn, voice, low, high) _GUS_CMD(chn, voice, _GUS_RAMPRANGE, (low), (high)) 96#define GUS_RAMPRATE(chn, voice, p1, p2) _GUS_CMD(chn, voice, _GUS_RAMPRATE, (p1), (p2)) 97#define GUS_RAMPMODE(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_RAMPMODE, (p1), 0) 98#define GUS_RAMPON(chn, voice, p1) _GUS_CMD(chn, voice, _GUS_RAMPON, (p1), 0) 99#define GUS_RAMPOFF(chn, voice) _GUS_CMD(chn, voice, _GUS_RAMPOFF, 0, 0) 100#define GUS_VOLUME_SCALE(chn, voice, p1, p2) _GUS_CMD(chn, voice, _GUS_VOLUME_SCALE, (p1), (p2)) 101#define GUS_VOICE_POS(chn, voice, p) _GUS_CMD(chn, voice, _GUS_VOICE_POS, \ 102 (p) & 0xffff, ((p) >> 16) & 0xffff) 103 104#endif 105