4 This file is part of PulseAudio.
6 Copyright 2006 Lennart Poettering
8 PulseAudio is free software; you can redistribute it and/or modify
9 it under the terms of the GNU Lesser General Public License as published
10 by the Free Software Foundation; either version 2 of the License,
11 or (at your option) any later version.
13 PulseAudio is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public License
19 along with PulseAudio; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
29 #include <sys/socket.h>
30 #include <netinet/in.h>
31 #include <arpa/inet.h>
36 #include <pulse/timeval.h>
37 #include <pulse/util.h>
38 #include <pulse/xmalloc.h>
40 #include <pulsecore/core-error.h>
41 #include <pulsecore/module.h>
42 #include <pulsecore/llist.h>
43 #include <pulsecore/source.h>
44 #include <pulsecore/source-output.h>
45 #include <pulsecore/memblockq.h>
46 #include <pulsecore/log.h>
47 #include <pulsecore/core-util.h>
48 #include <pulsecore/modargs.h>
49 #include <pulsecore/namereg.h>
50 #include <pulsecore/sample-util.h>
51 #include <pulsecore/macro.h>
52 #include <pulsecore/socket-util.h>
54 #include "module-rtp-send-symdef.h"
60 PA_MODULE_AUTHOR("Lennart Poettering");
61 PA_MODULE_DESCRIPTION("Read data from source and send it to the network via RTP/SAP/SDP");
62 PA_MODULE_VERSION(PACKAGE_VERSION
);
63 PA_MODULE_LOAD_ONCE(FALSE
);
65 "source=<name of the source> "
66 "format=<sample format> "
67 "channels=<number of channels> "
69 "destination=<destination IP address> "
71 "mtu=<maximum transfer unit> "
72 "loop=<loopback to local host?>"
75 #define DEFAULT_PORT 46000
77 #define DEFAULT_DESTINATION "224.0.0.56"
78 #define MEMBLOCKQ_MAXLENGTH (1024*170)
79 #define DEFAULT_MTU 1280
80 #define SAP_INTERVAL 5
82 static const char* const valid_modargs
[] = {
97 pa_source_output
*source_output
;
98 pa_memblockq
*memblockq
;
100 pa_rtp_context rtp_context
;
101 pa_sap_context sap_context
;
104 pa_time_event
*sap_event
;
107 /* Called from I/O thread context */
108 static int source_output_process_msg(pa_msgobject
*o
, int code
, void *data
, int64_t offset
, pa_memchunk
*chunk
) {
110 pa_assert_se(u
= PA_SOURCE_OUTPUT(o
)->userdata
);
113 case PA_SOURCE_OUTPUT_MESSAGE_GET_LATENCY
:
114 *((pa_usec_t
*) data
) = pa_bytes_to_usec(pa_memblockq_get_length(u
->memblockq
), &u
->source_output
->sample_spec
);
116 /* Fall through, the default handler will add in the extra
117 * latency added by the resampler */
121 return pa_source_output_process_msg(o
, code
, data
, offset
, chunk
);
124 /* Called from I/O thread context */
125 static void source_output_push(pa_source_output
*o
, const pa_memchunk
*chunk
) {
127 pa_source_output_assert_ref(o
);
128 pa_assert_se(u
= o
->userdata
);
130 if (pa_memblockq_push(u
->memblockq
, chunk
) < 0) {
131 pa_log_warn("Failed to push chunk into memblockq.");
135 pa_rtp_send(&u
->rtp_context
, u
->mtu
, u
->memblockq
);
138 /* Called from main context */
139 static void source_output_kill(pa_source_output
* o
) {
141 pa_source_output_assert_ref(o
);
142 pa_assert_se(u
= o
->userdata
);
144 pa_module_unload_request(u
->module
);
146 pa_source_output_unlink(u
->source_output
);
147 pa_source_output_unref(u
->source_output
);
148 u
->source_output
= NULL
;
151 static void sap_event_cb(pa_mainloop_api
*m
, pa_time_event
*t
, const struct timeval
*tv
, void *userdata
) {
152 struct userdata
*u
= userdata
;
160 pa_sap_send(&u
->sap_context
, 0);
162 pa_gettimeofday(&next
);
163 pa_timeval_add(&next
, SAP_INTERVAL
* PA_USEC_PER_SEC
);
164 m
->time_restart(t
, &next
);
167 int pa__init(pa_module
*m
) {
169 pa_modargs
*ma
= NULL
;
171 uint32_t port
= DEFAULT_PORT
, mtu
;
172 int af
, fd
= -1, sap_fd
= -1;
176 struct sockaddr_in sa4
, sap_sa4
;
177 struct sockaddr_in6 sa6
, sap_sa6
;
178 struct sockaddr_storage sa_dst
;
179 pa_source_output
*o
= NULL
;
186 pa_bool_t loop
= FALSE
;
187 pa_source_output_new_data data
;
191 if (!(ma
= pa_modargs_new(m
->argument
, valid_modargs
))) {
192 pa_log("Failed to parse module arguments");
196 if (!(s
= pa_namereg_get(m
->core
, pa_modargs_get_value(ma
, "source", NULL
), PA_NAMEREG_SOURCE
, 1))) {
197 pa_log("Source does not exist.");
201 if (pa_modargs_get_value_boolean(ma
, "loop", &loop
) < 0) {
202 pa_log("Failed to parse \"loop\" parameter.");
207 pa_rtp_sample_spec_fixup(&ss
);
209 if (pa_modargs_get_sample_spec(ma
, &ss
) < 0) {
210 pa_log("Failed to parse sample specification");
214 if (!pa_rtp_sample_spec_valid(&ss
)) {
215 pa_log("Specified sample type not compatible with RTP");
219 if (ss
.channels
!= cm
.channels
)
220 pa_channel_map_init_auto(&cm
, ss
.channels
, PA_CHANNEL_MAP_AIFF
);
222 payload
= pa_rtp_payload_from_sample_spec(&ss
);
224 mtu
= pa_frame_align(DEFAULT_MTU
, &ss
);
226 if (pa_modargs_get_value_u32(ma
, "mtu", &mtu
) < 0 || mtu
< 1 || mtu
% pa_frame_size(&ss
) != 0) {
227 pa_log("Invalid MTU.");
231 port
= DEFAULT_PORT
+ ((rand() % 512) << 1);
232 if (pa_modargs_get_value_u32(ma
, "port", &port
) < 0 || port
< 1 || port
> 0xFFFF) {
233 pa_log("port= expects a numerical argument between 1 and 65535.");
238 pa_log_warn("Port number not even as suggested in RFC3550!");
240 dest
= pa_modargs_get_value(ma
, "destination", DEFAULT_DESTINATION
);
242 if (inet_pton(AF_INET6
, dest
, &sa6
.sin6_addr
) > 0) {
243 sa6
.sin6_family
= af
= AF_INET6
;
244 sa6
.sin6_port
= htons(port
);
246 sap_sa6
.sin6_port
= htons(SAP_PORT
);
247 } else if (inet_pton(AF_INET
, dest
, &sa4
.sin_addr
) > 0) {
248 sa4
.sin_family
= af
= AF_INET
;
249 sa4
.sin_port
= htons(port
);
251 sap_sa4
.sin_port
= htons(SAP_PORT
);
253 pa_log("Invalid destination '%s'", dest
);
257 if ((fd
= socket(af
, SOCK_DGRAM
, 0)) < 0) {
258 pa_log("socket() failed: %s", pa_cstrerror(errno
));
262 if (connect(fd
, af
== AF_INET
? (struct sockaddr
*) &sa4
: (struct sockaddr
*) &sa6
, af
== AF_INET
? sizeof(sa4
) : sizeof(sa6
)) < 0) {
263 pa_log("connect() failed: %s", pa_cstrerror(errno
));
267 if ((sap_fd
= socket(af
, SOCK_DGRAM
, 0)) < 0) {
268 pa_log("socket() failed: %s", pa_cstrerror(errno
));
272 if (connect(sap_fd
, af
== AF_INET
? (struct sockaddr
*) &sap_sa4
: (struct sockaddr
*) &sap_sa6
, af
== AF_INET
? sizeof(sap_sa4
) : sizeof(sap_sa6
)) < 0) {
273 pa_log("connect() failed: %s", pa_cstrerror(errno
));
278 if (setsockopt(fd
, IPPROTO_IP
, IP_MULTICAST_LOOP
, &j
, sizeof(j
)) < 0 ||
279 setsockopt(sap_fd
, IPPROTO_IP
, IP_MULTICAST_LOOP
, &j
, sizeof(j
)) < 0) {
280 pa_log("IP_MULTICAST_LOOP failed: %s", pa_cstrerror(errno
));
284 /* If the socket queue is full, let's drop packets */
285 pa_make_fd_nonblock(fd
);
286 pa_make_udp_socket_low_delay(fd
);
287 pa_make_fd_cloexec(fd
);
288 pa_make_fd_cloexec(sap_fd
);
290 pa_source_output_new_data_init(&data
);
291 data
.name
= "RTP Monitor Stream";
292 data
.driver
= __FILE__
;
295 pa_source_output_new_data_set_sample_spec(&data
, &ss
);
296 pa_source_output_new_data_set_channel_map(&data
, &cm
);
298 if (!(o
= pa_source_output_new(m
->core
, &data
, 0))) {
299 pa_log("failed to create source output.");
303 o
->parent
.process_msg
= source_output_process_msg
;
304 o
->push
= source_output_push
;
305 o
->kill
= source_output_kill
;
307 u
= pa_xnew(struct userdata
, 1);
312 u
->source_output
= o
;
314 u
->memblockq
= pa_memblockq_new(
326 pa_assert_se((r
= getsockname(fd
, (struct sockaddr
*) &sa_dst
, &k
)) >= 0);
328 n
= pa_sprintf_malloc("PulseAudio RTP Stream on %s", pa_get_fqdn(hn
, sizeof(hn
)));
331 af
== AF_INET
? (void*) &((struct sockaddr_in
*) &sa_dst
)->sin_addr
: (void*) &((struct sockaddr_in6
*) &sa_dst
)->sin6_addr
,
332 af
== AF_INET
? (void*) &sa4
.sin_addr
: (void*) &sa6
.sin6_addr
,
333 n
, port
, payload
, &ss
);
337 pa_rtp_context_init_send(&u
->rtp_context
, fd
, m
->core
->cookie
, payload
, pa_frame_size(&ss
));
338 pa_sap_context_init_send(&u
->sap_context
, sap_fd
, p
);
340 pa_log_info("RTP stream initialized with mtu %u on %s:%u, SSRC=0x%08x, payload=%u, initial sequence #%u", mtu
, dest
, port
, u
->rtp_context
.ssrc
, payload
, u
->rtp_context
.sequence
);
341 pa_log_info("SDP-Data:\n%s\nEOF", p
);
343 pa_sap_send(&u
->sap_context
, 0);
345 pa_gettimeofday(&tv
);
346 pa_timeval_add(&tv
, SAP_INTERVAL
* PA_USEC_PER_SEC
);
347 u
->sap_event
= m
->core
->mainloop
->time_new(m
->core
->mainloop
, &tv
, sap_event_cb
, u
);
349 pa_source_output_put(u
->source_output
);
366 pa_source_output_unlink(o
);
367 pa_source_output_unref(o
);
373 void pa__done(pa_module
*m
) {
377 if (!(u
= m
->userdata
))
381 m
->core
->mainloop
->time_free(u
->sap_event
);
383 if (u
->source_output
) {
384 pa_source_output_unlink(u
->source_output
);
385 pa_source_output_unref(u
->source_output
);
388 pa_rtp_context_destroy(&u
->rtp_context
);
390 pa_sap_send(&u
->sap_context
, 1);
391 pa_sap_context_destroy(&u
->sap_context
);
394 pa_memblockq_free(u
->memblockq
);