Sync usage with man page.
[netbsd-mini2440.git] / dist / ntp / libntp / audio.c
blob3960113890040c43fa6d331ab3112ca9192f3080
1 /* $NetBSD: audio.c,v 1.3 2003/12/04 16:23:36 drochner Exp $ */
3 /*
4 * audio.c - audio interface for reference clock audio drivers
5 */
6 #ifdef HAVE_CONFIG_H
7 # include <config.h>
8 #endif
10 #if defined(HAVE_SYS_AUDIOIO_H) || defined(HAVE_SUN_AUDIOIO_H) || \
11 defined(HAVE_SYS_SOUNDCARD_H) || defined(HAVE_MACHINE_SOUNDCARD_H)
13 #include "audio.h"
14 #include "ntp_stdlib.h"
15 #include "ntp_syslog.h"
16 #ifdef HAVE_UNISTD_H
17 # include <unistd.h>
18 #endif
19 #include <stdio.h>
20 #include "ntp_string.h"
22 #ifdef HAVE_SYS_AUDIOIO_H
23 # include <sys/audioio.h>
24 #endif /* HAVE_SYS_AUDIOIO_H */
26 #ifdef HAVE_SUN_AUDIOIO_H
27 # include <sys/ioccom.h>
28 # include <sun/audioio.h>
29 #endif /* HAVE_SUN_AUDIOIO_H */
31 #ifdef HAVE_SYS_IOCTL_H
32 # include <sys/ioctl.h>
33 #endif /* HAVE_SYS_IOCTL_H */
35 #include <fcntl.h>
37 #ifdef HAVE_MACHINE_SOUNDCARD_H
38 # include <machine/soundcard.h>
39 # define PCM_STYLE_SOUND
40 #else
41 # ifdef HAVE_SYS_SOUNDCARD_H
42 # include <sys/soundcard.h>
43 # define PCM_STYLE_SOUND
44 # endif
45 #endif
47 #ifdef PCM_STYLE_SOUND
48 # include <ctype.h>
49 #endif
52 * Global variables
54 #ifdef HAVE_SYS_AUDIOIO_H
55 static struct audio_device device; /* audio device ident */
56 #endif /* HAVE_SYS_AUDIOIO_H */
57 #ifdef PCM_STYLE_SOUND
58 # define INIT_FILE "/etc/ntp.audio"
59 int agc = SOUND_MIXER_WRITE_RECLEV; /* or IGAIN or LINE */
60 int monitor = SOUND_MIXER_WRITE_VOLUME; /* or OGAIN */
61 int devmask = 0;
62 int recmask = 0;
63 char cf_c_dev[100], cf_i_dev[100], cf_agc[100], cf_monitor[100];
65 const char *m_names[SOUND_MIXER_NRDEVICES] = SOUND_DEVICE_NAMES;
66 #else /* not PCM_STYLE_SOUND */
67 static struct audio_info info; /* audio device info */
68 #endif /* not PCM_STYLE_SOUND */
69 static int ctl_fd; /* audio control file descriptor */
71 #ifdef PCM_STYLE_SOUND
72 static void audio_config_read P((int, char **, char **));
73 static int mixer_name P((const char *, int));
76 int
77 mixer_name(
78 const char *m_name,
79 int m_mask
82 int i;
84 for (i = 0; i < SOUND_MIXER_NRDEVICES; ++i)
85 if (((1 << i) & m_mask)
86 && !strcmp(m_names[i], m_name))
87 break;
89 return (SOUND_MIXER_NRDEVICES == i)
90 ? -1
91 : i
97 * Check:
99 * /etc/ntp.audio# where # is the unit number
100 * /etc/ntp.audio.# where # is the unit number
101 * /etc/ntp.audio
103 * for contents of the form:
105 * idev /dev/input_device
106 * cdev /dev/control_device
107 * agc pcm_input_device {igain,line,line1,...}
108 * monitor pcm_monitor_device {ogain,...}
110 * The device names for the "agc" and "monitor" keywords
111 * can be found by running either the "mixer" program or the
112 * util/audio-pcm program.
114 * Great hunks of this subroutine were swiped from refclock_oncore.c
116 static void
117 audio_config_read(
118 int unit,
119 char **c_dev, /* Control device */
120 char **i_dev /* input device */
123 FILE *fd;
124 char device[20], line[100], ab[100];
126 sprintf(device, "%s%d", INIT_FILE, unit);
127 if ((fd = fopen(device, "r")) == NULL) {
128 printf("audio_config_read: <%s> NO\n", device);
129 sprintf(device, "%s.%d", INIT_FILE, unit);
130 if ((fd = fopen(device, "r")) == NULL) {
131 printf("audio_config_read: <%s> NO\n", device);
132 sprintf(device, "%s.%d", INIT_FILE, unit);
133 if ((fd = fopen(device, "r")) == NULL) {
134 printf("audio_config_read: <%s> NO\n", device);
135 return;
139 printf("audio_config_read: reading <%s>\n", device);
140 while (fgets(line, sizeof line, fd)) {
141 char *cp, *cc, *ca;
142 int i;
144 /* Remove comments */
145 if ((cp = strchr(line, '#')))
146 *cp = '\0';
148 /* Remove any trailing spaces */
149 for (i = strlen(line);
150 i > 0 && isascii((int)line[i - 1]) && isspace((int)line[i - 1]);
152 line[--i] = '\0';
154 /* Remove leading space */
155 for (cc = line; *cc && isascii((int)*cc) && isspace((int)*cc); cc++)
156 continue;
158 /* Stop if nothing left */
159 if (!*cc)
160 continue;
162 /* Uppercase the command and find the arg */
163 for (ca = cc; *ca; ca++) {
164 if (isascii((int)*ca)) {
165 if (islower((int)*ca)) {
166 *ca = toupper(*ca);
167 } else if (isspace((int)*ca) || (*ca == '='))
168 break;
172 /* Remove space (and possible =) leading the arg */
173 for (; *ca && isascii((int)*ca) && (isspace((int)*ca) || (*ca == '=')); ca++)
174 continue;
176 if (!strncmp(cc, "IDEV", (size_t) 4)) {
177 sscanf(ca, "%s", ab);
178 strcpy(cf_i_dev, ab);
179 printf("idev <%s>\n", ab);
180 } else if (!strncmp(cc, "CDEV", (size_t) 4)) {
181 sscanf(ca, "%s", ab);
182 strcpy(cf_c_dev, ab);
183 printf("cdev <%s>\n", ab);
184 } else if (!strncmp(cc, "AGC", (size_t) 3)) {
185 sscanf(ca, "%s", ab);
186 strcpy(cf_agc, ab);
187 printf("agc <%s> %d\n", ab, i);
188 } else if (!strncmp(cc, "MONITOR", (size_t) 7)) {
189 sscanf(ca, "%s", ab);
190 strcpy(cf_monitor, ab);
191 printf("monitor <%s> %d\n", ab, mixer_name(ab, -1));
194 fclose(fd);
195 return;
197 #endif /* PCM_STYLE_SOUND */
200 * audio_init - open and initialize audio device
202 * This code works with SunOS 4.x, Solaris 2.x, and PCM; however, it is
203 * believed generic and applicable to other systems with a minor twid
204 * or two. All it does is open the device, set the buffer size (Solaris
205 * only), preset the gain and set the input port. It assumes that the
206 * codec sample rate (8000 Hz), precision (8 bits), number of channels
207 * (1) and encoding (ITU-T G.711 mu-law companded) have been set by
208 * default.
211 audio_init(
212 char *dname, /* device name */
213 int bufsiz, /* buffer size */
214 int unit /* device unit (0-3) */
217 #ifdef PCM_STYLE_SOUND
218 # define ACTL_DEV "/dev/mixer%d"
219 char actl_dev[30];
220 # ifdef HAVE_STRUCT_SND_SIZE
221 struct snd_size s_size;
222 # endif
223 # ifdef AIOGFMT
224 snd_chan_param s_c_p;
225 # endif
226 #endif
227 int fd;
228 int rval;
229 char *actl =
230 #ifdef PCM_STYLE_SOUND
231 actl_dev
232 #else
233 "/dev/audioctl"
234 #endif
237 #ifdef PCM_STYLE_SOUND
238 (void)sprintf(actl_dev, ACTL_DEV, unit);
240 audio_config_read(unit, &actl, &dname);
241 /* If we have values for cf_c_dev or cf_i_dev, use them. */
242 if (*cf_c_dev)
243 actl = cf_c_dev;
244 if (*cf_i_dev)
245 dname = cf_i_dev;
246 #endif
249 * Open audio device. Do not complain if not there.
251 fd = open(dname, O_RDWR | O_NONBLOCK, 0777);
252 if (fd < 0)
253 return (fd);
256 * Open audio control device.
258 ctl_fd = open(actl, O_RDWR);
259 if (ctl_fd < 0) {
260 msyslog(LOG_ERR, "audio_init: invalid control device <%s>\n", actl);
261 close(fd);
262 return(ctl_fd);
266 * Set audio device parameters.
268 #ifdef PCM_STYLE_SOUND
269 printf("audio_init: <%s> bufsiz %d\n", dname, bufsiz);
270 rval = fd;
272 # ifdef HAVE_STRUCT_SND_SIZE
273 if (ioctl(fd, AIOGSIZE, &s_size) == -1)
274 printf("audio_init: AIOGSIZE: %s\n", strerror(errno));
275 else
276 printf("audio_init: orig: play_size %d, rec_size %d\n",
277 s_size.play_size, s_size.rec_size);
279 s_size.play_size = s_size.rec_size = bufsiz;
280 printf("audio_init: want: play_size %d, rec_size %d\n",
281 s_size.play_size, s_size.rec_size);
283 if (ioctl(fd, AIOSSIZE, &s_size) == -1)
284 printf("audio_init: AIOSSIZE: %s\n", strerror(errno));
285 else
286 printf("audio_init: set: play_size %d, rec_size %d\n",
287 s_size.play_size, s_size.rec_size);
288 # endif /* HAVE_STRUCT_SND_SIZE */
290 # ifdef SNDCTL_DSP_SETFRAGMENT
292 int tmp = (16 << 16) + 6; /* 16 fragments, each 2^6 bytes */
293 if (ioctl(fd, SNDCTL_DSP_SETFRAGMENT, &tmp) == -1)
294 printf("audio_init: SNDCTL_DSP_SETFRAGMENT: %s\n",
295 strerror(errno));
297 # endif /* SNDCTL_DSP_SETFRAGMENT */
299 # ifdef AIOGFMT
300 if (ioctl(fd, AIOGFMT, &s_c_p) == -1)
301 printf("audio_init: AIOGFMT: %s\n", strerror(errno));
302 else
303 printf("audio_init: play_rate %lu, rec_rate %lu, play_format %#lx, rec_format %#lx\n",
304 s_c_p.play_rate, s_c_p.rec_rate, s_c_p.play_format, s_c_p.rec_format);
305 # endif
307 /* Grab the device and record masks */
309 if (ioctl(ctl_fd, SOUND_MIXER_READ_DEVMASK, &devmask) == -1)
310 printf("SOUND_MIXER_READ_DEVMASK: %s\n", strerror(errno));
311 if (ioctl(ctl_fd, SOUND_MIXER_READ_RECMASK, &recmask) == -1)
312 printf("SOUND_MIXER_READ_RECMASK: %s\n", strerror(errno));
314 /* validate and set any specified config file stuff */
315 if (*cf_agc) {
316 int i;
318 i = mixer_name(cf_agc, devmask);
319 if (i >= 0)
320 agc = MIXER_WRITE(i);
321 else
322 printf("input %s not in recmask %#x\n",
323 cf_agc, recmask);
326 if (*cf_monitor) {
327 int i;
329 /* devmask */
330 i = mixer_name(cf_monitor, devmask);
331 if (i >= 0)
332 monitor = MIXER_WRITE(i);
333 else
334 printf("monitor %s not in devmask %#x\n",
335 cf_monitor, devmask);
338 #else /* not PCM_STYLE_SOUND */
339 AUDIO_INITINFO(&info);
340 info.play.gain = AUDIO_MAX_GAIN;
341 info.play.port = AUDIO_SPEAKER;
342 # ifdef HAVE_SYS_AUDIOIO_H
343 info.record.buffer_size = bufsiz;
344 # endif /* HAVE_SYS_AUDIOIO_H */
345 rval = ioctl(ctl_fd, (int)AUDIO_SETINFO, (char *)&info);
346 if (rval < 0) {
347 msyslog(LOG_ERR, "audio: invalid control device parameters\n");
348 close(ctl_fd);
349 close(fd);
350 return(rval);
352 rval = fd;
353 #endif /* not PCM_STYLE_SOUND */
354 return (rval);
359 * audio_gain - adjust codec gains and port
362 audio_gain(
363 int gain, /* volume level (gain) 0-255 */
364 int mongain, /* input to output mix (monitor gain) 0-255 */
365 int port /* selected I/O port: 1 mic/2 line in */
368 int rval;
369 static int o_mongain = -1;
370 static int o_port = -1;
372 #ifdef PCM_STYLE_SOUND
373 int l, r;
375 rval = 0;
377 r = l = 100 * gain / 255; /* Normalize to 0-100 */
378 # ifdef DEBUG
379 if (debug > 1)
380 printf("audio_gain: gain %d/%d\n", gain, l);
381 # endif
382 /* figure out what channel(s) to use. just nuke right for now. */
383 r = 0 ; /* setting to zero nicely mutes the channel */
385 l |= r << 8;
386 if ( cf_agc )
387 rval = ioctl(ctl_fd, agc, &l);
388 else
389 if (port == 2) {
390 rval = ioctl(ctl_fd, SOUND_MIXER_WRITE_LINE, &l);
391 } else {
392 rval = ioctl(ctl_fd, SOUND_MIXER_WRITE_MIC, &l);
394 if (rval == -1) {
395 printf("audio_gain: agc write: %s\n", strerror(errno));
396 return (rval);
399 if (o_mongain != mongain) {
400 r = l = 100 * mongain / 255; /* Normalize to 0-100 */
401 # ifdef DEBUG
402 if (debug > 1)
403 printf("audio_gain: mongain %d/%d\n", mongain, l);
404 # endif
405 l |= r << 8;
406 if ( cf_monitor )
407 rval = ioctl(ctl_fd, monitor, &l );
408 else
409 rval = ioctl(ctl_fd, SOUND_MIXER_WRITE_VOLUME, &l);
410 if (rval == -1) {
411 printf("audio_gain: mongain write: %s\n",
412 strerror(errno));
413 return (rval);
415 o_mongain = mongain;
418 if (o_port != port) {
419 # ifdef DEBUG
420 if (debug > 1)
421 printf("audio_gain: port %d\n", port);
422 # endif
423 l = (1 << ((port == 2) ? SOUND_MIXER_LINE : SOUND_MIXER_MIC));
424 rval = ioctl(ctl_fd, SOUND_MIXER_WRITE_RECSRC, &l);
425 if (rval == -1) {
426 printf("SOUND_MIXER_WRITE_RECSRC: %s\n",
427 strerror(errno));
428 return (rval);
430 # ifdef DEBUG
431 if (debug > 1) {
432 if (ioctl(ctl_fd, SOUND_MIXER_READ_RECSRC, &l) == -1)
433 printf("SOUND_MIXER_WRITE_RECSRC: %s\n",
434 strerror(errno));
435 else
436 printf("audio_gain: recsrc is %d\n", l);
438 # endif
439 o_port = port;
441 #else /* not PCM_STYLE_SOUND */
442 ioctl(ctl_fd, (int)AUDIO_GETINFO, (char *)&info);
443 info.record.encoding = AUDIO_ENCODING_ULAW;
444 info.record.error = 0;
445 info.record.gain = gain;
446 if (o_mongain != mongain)
447 o_mongain = info.monitor_gain = mongain;
448 if (o_port != port)
449 o_port = info.record.port = port;
450 rval = ioctl(ctl_fd, (int)AUDIO_SETINFO, (char *)&info);
451 if (rval < 0) {
452 msyslog(LOG_ERR, "audio_gain: %m");
453 return (rval);
455 rval = info.record.error;
456 #endif /* not PCM_STYLE_SOUND */
457 return (rval);
462 * audio_show - display audio parameters
464 * This code doesn't really do anything, except satisfy curiousity and
465 * verify the ioctl's work.
467 void
468 audio_show(void)
470 #ifdef PCM_STYLE_SOUND
471 int recsrc = 0;
473 printf("audio_show: ctl_fd %d\n", ctl_fd);
474 if (ioctl(ctl_fd, SOUND_MIXER_READ_RECSRC, &recsrc) == -1)
475 printf("SOUND_MIXER_READ_RECSRC: %s\n", strerror(errno));
477 #else /* not PCM_STYLE_SOUND */
478 # ifdef HAVE_SYS_AUDIOIO_H
479 ioctl(ctl_fd, (int)AUDIO_GETDEV, &device);
480 printf("audio: name %s, version %s, config %s\n",
481 device.name, device.version, device.config);
482 # endif /* HAVE_SYS_AUDIOIO_H */
483 ioctl(ctl_fd, (int)AUDIO_GETINFO, (char *)&info);
484 printf(
485 "audio: rate %d, chan %d, prec %d, code %d, gain %d, mon %d, port %d\n",
486 info.record.sample_rate, info.record.channels,
487 info.record.precision, info.record.encoding,
488 info.record.gain, info.monitor_gain, info.record.port);
489 printf(
490 "audio: samples %d, eof %d, pause %d, error %d, waiting %d, balance %d\n",
491 info.record.samples, info.record.eof,
492 info.record.pause, info.record.error,
493 info.record.waiting, info.record.balance);
494 #endif /* not PCM_STYLE_SOUND */
496 #else
497 int audio_bs;
498 #endif /* HAVE_{SYS_AUDIOIO,SUN_AUDIOIO,MACHINE_SOUNDCARD,SYS_SOUNDCARD}_H */