4 This file is part of PulseAudio.
6 Copyright 2004-2006 Lennart Poettering
7 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
9 PulseAudio is free software; you can redistribute it and/or modify
10 it under the terms of the GNU Lesser General Public License as published
11 by the Free Software Foundation; either version 2 of the License,
12 or (at your option) any later version.
14 PulseAudio is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 General Public License for more details.
19 You should have received a copy of the GNU Lesser General Public License
20 along with PulseAudio; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
39 #include <pulse/pulseaudio.h>
41 #define TIME_EVENT_USEC 50000
43 #if PA_API_VERSION < 9
44 #error Invalid PulseAudio API version
47 static enum { RECORD
, PLAYBACK
} mode
= PLAYBACK
;
49 static pa_context
*context
= NULL
;
50 static pa_stream
*stream
= NULL
;
51 static pa_mainloop_api
*mainloop_api
= NULL
;
53 static void *buffer
= NULL
;
54 static size_t buffer_length
= 0, buffer_index
= 0;
56 static pa_io_event
* stdio_event
= NULL
;
58 static char *stream_name
= NULL
, *client_name
= NULL
, *device
= NULL
;
60 static int verbose
= 0;
61 static pa_volume_t volume
= PA_VOLUME_NORM
;
63 static pa_sample_spec sample_spec
= {
64 .format
= PA_SAMPLE_S16LE
,
69 static pa_channel_map channel_map
;
70 static int channel_map_set
= 0;
72 /* A shortcut for terminating the application */
73 static void quit(int ret
) {
75 mainloop_api
->quit(mainloop_api
, ret
);
78 /* Write some data to the stream */
79 static void do_stream_write(size_t length
) {
83 if (!buffer
|| !buffer_length
)
87 if (l
> buffer_length
)
90 if (pa_stream_write(stream
, (uint8_t*) buffer
+ buffer_index
, l
, NULL
, 0, PA_SEEK_RELATIVE
) < 0) {
91 fprintf(stderr
, "pa_stream_write() failed: %s\n", pa_strerror(pa_context_errno(context
)));
102 buffer_index
= buffer_length
= 0;
106 /* This is called whenever new data may be written to the stream */
107 static void stream_write_callback(pa_stream
*s
, size_t length
, void *userdata
) {
111 mainloop_api
->io_enable(stdio_event
, PA_IO_EVENT_INPUT
);
116 do_stream_write(length
);
119 /* This is called whenever new data may is available */
120 static void stream_read_callback(pa_stream
*s
, size_t length
, void *userdata
) {
125 mainloop_api
->io_enable(stdio_event
, PA_IO_EVENT_OUTPUT
);
127 if (pa_stream_peek(s
, &data
, &length
) < 0) {
128 fprintf(stderr
, "pa_stream_peek() failed: %s\n", pa_strerror(pa_context_errno(context
)));
133 assert(data
&& length
);
136 fprintf(stderr
, "Buffer overrun, dropping incoming data\n");
137 if (pa_stream_drop(s
) < 0) {
138 fprintf(stderr
, "pa_stream_drop() failed: %s\n", pa_strerror(pa_context_errno(context
)));
144 buffer
= pa_xmalloc(buffer_length
= length
);
145 memcpy(buffer
, data
, length
);
150 /* This routine is called whenever the stream state changes */
151 static void stream_state_callback(pa_stream
*s
, void *userdata
) {
154 switch (pa_stream_get_state(s
)) {
155 case PA_STREAM_CREATING
:
156 case PA_STREAM_TERMINATED
:
159 case PA_STREAM_READY
:
161 const pa_buffer_attr
*a
;
163 fprintf(stderr
, "Stream successfully created.\n");
165 if (!(a
= pa_stream_get_buffer_attr(s
)))
166 fprintf(stderr
, "pa_stream_get_buffer_attr() failed: %s\n", pa_strerror(pa_context_errno(pa_stream_get_context(s
))));
169 if (mode
== PLAYBACK
)
170 fprintf(stderr
, "Buffer metrics: maxlength=%u, tlength=%u, prebuf=%u, minreq=%u\n", a
->maxlength
, a
->tlength
, a
->prebuf
, a
->minreq
);
172 assert(mode
== RECORD
);
173 fprintf(stderr
, "Buffer metrics: maxlength=%u, fragsize=%u\n", a
->maxlength
, a
->fragsize
);
182 case PA_STREAM_FAILED
:
184 fprintf(stderr
, "Stream error: %s\n", pa_strerror(pa_context_errno(pa_stream_get_context(s
))));
189 /* This is called whenever the context status changes */
190 static void context_state_callback(pa_context
*c
, void *userdata
) {
193 switch (pa_context_get_state(c
)) {
194 case PA_CONTEXT_CONNECTING
:
195 case PA_CONTEXT_AUTHORIZING
:
196 case PA_CONTEXT_SETTING_NAME
:
199 case PA_CONTEXT_READY
: {
202 assert(c
&& !stream
);
205 fprintf(stderr
, "Connection established.\n");
207 if (!(stream
= pa_stream_new(c
, stream_name
, &sample_spec
, channel_map_set
? &channel_map
: NULL
))) {
208 fprintf(stderr
, "pa_stream_new() failed: %s\n", pa_strerror(pa_context_errno(c
)));
212 pa_stream_set_state_callback(stream
, stream_state_callback
, NULL
);
213 pa_stream_set_write_callback(stream
, stream_write_callback
, NULL
);
214 pa_stream_set_read_callback(stream
, stream_read_callback
, NULL
);
216 if (mode
== PLAYBACK
) {
218 if ((r
= pa_stream_connect_playback(stream
, device
, NULL
, 0, pa_cvolume_set(&cv
, sample_spec
.channels
, volume
), NULL
)) < 0) {
219 fprintf(stderr
, "pa_stream_connect_playback() failed: %s\n", pa_strerror(pa_context_errno(c
)));
224 if ((r
= pa_stream_connect_record(stream
, device
, NULL
, 0)) < 0) {
225 fprintf(stderr
, "pa_stream_connect_record() failed: %s\n", pa_strerror(pa_context_errno(c
)));
233 case PA_CONTEXT_TERMINATED
:
237 case PA_CONTEXT_FAILED
:
239 fprintf(stderr
, "Connection failure: %s\n", pa_strerror(pa_context_errno(c
)));
250 /* Connection draining complete */
251 static void context_drain_complete(pa_context
*c
, void *userdata
) {
252 pa_context_disconnect(c
);
255 /* Stream draining complete */
256 static void stream_drain_complete(pa_stream
*s
, int success
, void *userdata
) {
260 fprintf(stderr
, "Failed to drain stream: %s\n", pa_strerror(pa_context_errno(context
)));
265 fprintf(stderr
, "Playback stream drained.\n");
267 pa_stream_disconnect(stream
);
268 pa_stream_unref(stream
);
271 if (!(o
= pa_context_drain(context
, context_drain_complete
, NULL
)))
272 pa_context_disconnect(context
);
275 fprintf(stderr
, "Draining connection to server.\n");
279 /* New data on STDIN **/
280 static void stdin_callback(pa_mainloop_api
*a
, pa_io_event
*e
, int fd
, pa_io_event_flags_t f
, void *userdata
) {
283 assert(a
== mainloop_api
&& e
&& stdio_event
== e
);
286 mainloop_api
->io_enable(stdio_event
, PA_IO_EVENT_NULL
);
290 if (!stream
|| pa_stream_get_state(stream
) != PA_STREAM_READY
|| !(l
= w
= pa_stream_writable_size(stream
)))
293 buffer
= pa_xmalloc(l
);
295 if ((r
= read(fd
, buffer
, l
)) <= 0) {
298 fprintf(stderr
, "Got EOF.\n");
303 if (!(o
= pa_stream_drain(stream
, stream_drain_complete
, NULL
))) {
304 fprintf(stderr
, "pa_stream_drain(): %s\n", pa_strerror(pa_context_errno(context
)));
309 pa_operation_unref(o
);
314 fprintf(stderr
, "read() failed: %s\n", strerror(errno
));
318 mainloop_api
->io_free(stdio_event
);
330 /* Some data may be written to STDOUT */
331 static void stdout_callback(pa_mainloop_api
*a
, pa_io_event
*e
, int fd
, pa_io_event_flags_t f
, void *userdata
) {
333 assert(a
== mainloop_api
&& e
&& stdio_event
== e
);
336 mainloop_api
->io_enable(stdio_event
, PA_IO_EVENT_NULL
);
340 assert(buffer_length
);
342 if ((r
= write(fd
, (uint8_t*) buffer
+buffer_index
, buffer_length
)) <= 0) {
343 fprintf(stderr
, "write() failed: %s\n", strerror(errno
));
346 mainloop_api
->io_free(stdio_event
);
354 if (!buffer_length
) {
357 buffer_length
= buffer_index
= 0;
361 /* UNIX signal to quit recieved */
362 static void exit_signal_callback(pa_mainloop_api
*m
, pa_signal_event
*e
, int sig
, void *userdata
) {
364 fprintf(stderr
, "Got signal, exiting.\n");
368 /* Show the current latency */
369 static void stream_update_timing_callback(pa_stream
*s
, int success
, void *userdata
) {
370 pa_usec_t latency
, usec
;
376 pa_stream_get_time(s
, &usec
) < 0 ||
377 pa_stream_get_latency(s
, &latency
, &negative
) < 0) {
378 fprintf(stderr
, "Failed to get latency: %s\n", pa_strerror(pa_context_errno(context
)));
383 fprintf(stderr
, "Time: %0.3f sec; Latency: %0.0f usec. \r",
384 (float) usec
/ 1000000,
385 (float) latency
* (negative
?-1:1));
388 /* Someone requested that the latency is shown */
389 static void sigusr1_signal_callback(pa_mainloop_api
*m
, pa_signal_event
*e
, int sig
, void *userdata
) {
394 pa_operation_unref(pa_stream_update_timing_info(stream
, stream_update_timing_callback
, NULL
));
397 static void time_event_callback(pa_mainloop_api
*m
, pa_time_event
*e
, const struct timeval
*tv
, void *userdata
) {
400 if (stream
&& pa_stream_get_state(stream
) == PA_STREAM_READY
) {
402 if (!(o
= pa_stream_update_timing_info(stream
, stream_update_timing_callback
, NULL
)))
403 fprintf(stderr
, "pa_stream_update_timing_info() failed: %s\n", pa_strerror(pa_context_errno(context
)));
405 pa_operation_unref(o
);
408 pa_gettimeofday(&next
);
409 pa_timeval_add(&next
, TIME_EVENT_USEC
);
411 m
->time_restart(e
, &next
);
414 static void help(const char *argv0
) {
416 printf("%s [options]\n\n"
417 " -h, --help Show this help\n"
418 " --version Show version\n\n"
419 " -r, --record Create a connection for recording\n"
420 " -p, --playback Create a connection for playback\n\n"
421 " -v, --verbose Enable verbose operations\n\n"
422 " -s, --server=SERVER The name of the server to connect to\n"
423 " -d, --device=DEVICE The name of the sink/source to connect to\n"
424 " -n, --client-name=NAME How to call this client on the server\n"
425 " --stream-name=NAME How to call this stream on the server\n"
426 " --volume=VOLUME Specify the initial (linear) volume in range 0...65536\n"
427 " --rate=SAMPLERATE The sample rate in Hz (defaults to 44100)\n"
428 " --format=SAMPLEFORMAT The sample type, one of s16le, s16be, u8, float32le,\n"
429 " float32be, ulaw, alaw (defaults to s16ne)\n"
430 " --channels=CHANNELS The number of channels, 1 for mono, 2 for stereo\n"
432 " --channel-map=CHANNELMAP Channel map to use instead of the default\n",
446 int main(int argc
, char *argv
[]) {
447 pa_mainloop
* m
= NULL
;
449 char *bn
, *server
= NULL
;
450 pa_time_event
*time_event
= NULL
;
452 static const struct option long_options
[] = {
453 {"record", 0, NULL
, 'r'},
454 {"playback", 0, NULL
, 'p'},
455 {"device", 1, NULL
, 'd'},
456 {"server", 1, NULL
, 's'},
457 {"client-name", 1, NULL
, 'n'},
458 {"stream-name", 1, NULL
, ARG_STREAM_NAME
},
459 {"version", 0, NULL
, ARG_VERSION
},
460 {"help", 0, NULL
, 'h'},
461 {"verbose", 0, NULL
, 'v'},
462 {"volume", 1, NULL
, ARG_VOLUME
},
463 {"rate", 1, NULL
, ARG_SAMPLERATE
},
464 {"format", 1, NULL
, ARG_SAMPLEFORMAT
},
465 {"channels", 1, NULL
, ARG_CHANNELS
},
466 {"channel-map", 1, NULL
, ARG_CHANNELMAP
},
470 if (!(bn
= strrchr(argv
[0], '/')))
475 if (strstr(bn
, "rec") || strstr(bn
, "mon"))
477 else if (strstr(bn
, "cat") || strstr(bn
, "play"))
480 while ((c
= getopt_long(argc
, argv
, "rpd:s:n:hv", long_options
, NULL
)) != -1) {
489 printf("pacat "PACKAGE_VERSION
"\nCompiled with libpulse %s\nLinked with libpulse %s\n", pa_get_headers_version(), pa_get_library_version());
503 device
= pa_xstrdup(optarg
);
508 server
= pa_xstrdup(optarg
);
512 pa_xfree(client_name
);
513 client_name
= pa_xstrdup(optarg
);
516 case ARG_STREAM_NAME
:
517 pa_xfree(stream_name
);
518 stream_name
= pa_xstrdup(optarg
);
526 int v
= atoi(optarg
);
527 volume
= v
< 0 ? 0 : v
;
532 sample_spec
.channels
= atoi(optarg
);
535 case ARG_SAMPLEFORMAT
:
536 sample_spec
.format
= pa_parse_sample_format(optarg
);
540 sample_spec
.rate
= atoi(optarg
);
544 if (!pa_channel_map_parse(&channel_map
, optarg
)) {
545 fprintf(stderr
, "Invalid channel map\n");
557 if (!pa_sample_spec_valid(&sample_spec
)) {
558 fprintf(stderr
, "Invalid sample specification\n");
562 if (channel_map_set
&& channel_map
.channels
!= sample_spec
.channels
) {
563 fprintf(stderr
, "Channel map doesn't match sample specification\n");
568 char t
[PA_SAMPLE_SPEC_SNPRINT_MAX
];
569 pa_sample_spec_snprint(t
, sizeof(t
), &sample_spec
);
570 fprintf(stderr
, "Opening a %s stream with sample specification '%s'.\n", mode
== RECORD
? "recording" : "playback", t
);
573 if (!(optind
>= argc
)) {
574 if (optind
+1 == argc
) {
577 if ((fd
= open(argv
[optind
], mode
== PLAYBACK
? O_RDONLY
: O_WRONLY
|O_TRUNC
|O_CREAT
, 0666)) < 0) {
578 fprintf(stderr
, "open(): %s\n", strerror(errno
));
582 if (dup2(fd
, mode
== PLAYBACK
? 0 : 1) < 0) {
583 fprintf(stderr
, "dup2(): %s\n", strerror(errno
));
590 stream_name
= pa_xstrdup(argv
[optind
]);
593 fprintf(stderr
, "Too many arguments.\n");
599 client_name
= pa_xstrdup(bn
);
602 stream_name
= pa_xstrdup(client_name
);
604 /* Set up a new main loop */
605 if (!(m
= pa_mainloop_new())) {
606 fprintf(stderr
, "pa_mainloop_new() failed.\n");
610 mainloop_api
= pa_mainloop_get_api(m
);
612 r
= pa_signal_init(mainloop_api
);
614 pa_signal_new(SIGINT
, exit_signal_callback
, NULL
);
615 pa_signal_new(SIGTERM
, exit_signal_callback
, NULL
);
617 pa_signal_new(SIGUSR1
, sigusr1_signal_callback
, NULL
);
620 signal(SIGPIPE
, SIG_IGN
);
623 if (!(stdio_event
= mainloop_api
->io_new(mainloop_api
,
624 mode
== PLAYBACK
? STDIN_FILENO
: STDOUT_FILENO
,
625 mode
== PLAYBACK
? PA_IO_EVENT_INPUT
: PA_IO_EVENT_OUTPUT
,
626 mode
== PLAYBACK
? stdin_callback
: stdout_callback
, NULL
))) {
627 fprintf(stderr
, "io_new() failed.\n");
631 /* Create a new connection context */
632 if (!(context
= pa_context_new(mainloop_api
, client_name
))) {
633 fprintf(stderr
, "pa_context_new() failed.\n");
637 pa_context_set_state_callback(context
, context_state_callback
, NULL
);
639 /* Connect the context */
640 pa_context_connect(context
, server
, 0, NULL
);
645 pa_gettimeofday(&tv
);
646 pa_timeval_add(&tv
, TIME_EVENT_USEC
);
648 if (!(time_event
= mainloop_api
->time_new(mainloop_api
, &tv
, time_event_callback
, NULL
))) {
649 fprintf(stderr
, "time_new() failed.\n");
654 /* Run the main loop */
655 if (pa_mainloop_run(m
, &ret
) < 0) {
656 fprintf(stderr
, "pa_mainloop_run() failed.\n");
662 pa_stream_unref(stream
);
665 pa_context_unref(context
);
668 assert(mainloop_api
);
669 mainloop_api
->io_free(stdio_event
);
673 assert(mainloop_api
);
674 mainloop_api
->time_free(time_event
);
686 pa_xfree(client_name
);
687 pa_xfree(stream_name
);