2 * Copyright (C) 1999 Erik Walthinsen <omega@cse.ogi.edu>
3 * Copyright (C) 2005 Edgard Lima <edgard.lima@indt.org.br>
4 * Copyright (C) 2005 Nokia Corporation <kai.vehmanen@nokia.com>
5 * Copyright (C) 2007,2008 Axis Communications <dev-gstreamer@axis.com>
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
29 #include <gst/rtp/gstrtpbuffer.h>
31 #include "gstrtpg726pay.h"
33 GST_DEBUG_CATEGORY_STATIC (rtpg726pay_debug);
34 #define GST_CAT_DEFAULT (rtpg726pay_debug)
36 #define DEFAULT_FORCE_AAL2 TRUE
45 static GstStaticPadTemplate gst_rtp_g726_pay_sink_template =
46 GST_STATIC_PAD_TEMPLATE ("sink",
49 GST_STATIC_CAPS ("audio/x-adpcm, "
50 "channels = (int) 1, "
52 "bitrate = (int) { 16000, 24000, 32000, 40000 }, "
53 "layout = (string) \"g726\"")
56 static GstStaticPadTemplate gst_rtp_g726_pay_src_template =
57 GST_STATIC_PAD_TEMPLATE ("src",
60 GST_STATIC_CAPS ("application/x-rtp, "
61 "media = (string) \"audio\", "
62 "payload = (int) " GST_RTP_PAYLOAD_DYNAMIC_STRING ", "
63 "clock-rate = (int) 8000, "
64 "encoding-name = (string) { \"G726-16\", \"G726-24\", \"G726-32\", \"G726-40\", "
65 " \"AAL2-G726-16\", \"AAL2-G726-24\", \"AAL2-G726-32\", \"AAL2-G726-40\" } ")
68 static void gst_rtp_g726_pay_get_property (GObject * object, guint prop_id,
69 GValue * value, GParamSpec * pspec);
70 static void gst_rtp_g726_pay_set_property (GObject * object, guint prop_id,
71 const GValue * value, GParamSpec * pspec);
73 static gboolean gst_rtp_g726_pay_setcaps (GstRTPBasePayload * payload,
75 static GstFlowReturn gst_rtp_g726_pay_handle_buffer (GstRTPBasePayload *
76 payload, GstBuffer * buffer);
78 #define gst_rtp_g726_pay_parent_class parent_class
79 G_DEFINE_TYPE (GstRtpG726Pay, gst_rtp_g726_pay,
80 GST_TYPE_RTP_BASE_AUDIO_PAYLOAD);
83 gst_rtp_g726_pay_class_init (GstRtpG726PayClass * klass)
85 GObjectClass *gobject_class;
86 GstElementClass *gstelement_class;
87 GstRTPBasePayloadClass *gstrtpbasepayload_class;
89 gobject_class = (GObjectClass *) klass;
90 gstelement_class = (GstElementClass *) klass;
91 gstrtpbasepayload_class = (GstRTPBasePayloadClass *) klass;
93 gobject_class->set_property = gst_rtp_g726_pay_set_property;
94 gobject_class->get_property = gst_rtp_g726_pay_get_property;
96 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_FORCE_AAL2,
97 g_param_spec_boolean ("force-aal2", "Force AAL2",
98 "Force AAL2 encoding for compatibility with bad depayloaders",
99 DEFAULT_FORCE_AAL2, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
101 gst_element_class_add_pad_template (gstelement_class,
102 gst_static_pad_template_get (&gst_rtp_g726_pay_sink_template));
103 gst_element_class_add_pad_template (gstelement_class,
104 gst_static_pad_template_get (&gst_rtp_g726_pay_src_template));
106 gst_element_class_set_details_simple (gstelement_class, "RTP G.726 payloader",
107 "Codec/Payloader/Network/RTP",
108 "Payload-encodes G.726 audio into a RTP packet",
109 "Axis Communications <dev-gstreamer@axis.com>");
111 gstrtpbasepayload_class->set_caps = gst_rtp_g726_pay_setcaps;
112 gstrtpbasepayload_class->handle_buffer = gst_rtp_g726_pay_handle_buffer;
114 GST_DEBUG_CATEGORY_INIT (rtpg726pay_debug, "rtpg726pay", 0,
115 "G.726 RTP Payloader");
119 gst_rtp_g726_pay_init (GstRtpG726Pay * rtpg726pay)
121 GstRTPBaseAudioPayload *rtpbaseaudiopayload;
123 rtpbaseaudiopayload = GST_RTP_BASE_AUDIO_PAYLOAD (rtpg726pay);
125 GST_RTP_BASE_PAYLOAD (rtpg726pay)->clock_rate = 8000;
127 rtpg726pay->force_aal2 = DEFAULT_FORCE_AAL2;
129 /* sample based codec */
130 gst_rtp_base_audio_payload_set_sample_based (rtpbaseaudiopayload);
134 gst_rtp_g726_pay_setcaps (GstRTPBasePayload * payload, GstCaps * caps)
136 gchar *encoding_name;
137 GstStructure *structure;
138 GstRTPBaseAudioPayload *rtpbaseaudiopayload;
143 rtpbaseaudiopayload = GST_RTP_BASE_AUDIO_PAYLOAD (payload);
144 pay = GST_RTP_G726_PAY (payload);
146 structure = gst_caps_get_structure (caps, 0);
148 if (!gst_structure_get_int (structure, "bitrate", &pay->bitrate))
149 pay->bitrate = 32000;
151 GST_DEBUG_OBJECT (payload, "using bitrate %d", pay->bitrate);
155 /* first see what we can do with the bitrate */
156 switch (pay->bitrate) {
158 encoding_name = g_strdup ("G726-16");
159 gst_rtp_base_audio_payload_set_samplebits_options (rtpbaseaudiopayload,
163 encoding_name = g_strdup ("G726-24");
164 gst_rtp_base_audio_payload_set_samplebits_options (rtpbaseaudiopayload,
168 encoding_name = g_strdup ("G726-32");
169 gst_rtp_base_audio_payload_set_samplebits_options (rtpbaseaudiopayload,
173 encoding_name = g_strdup ("G726-40");
174 gst_rtp_base_audio_payload_set_samplebits_options (rtpbaseaudiopayload,
178 goto invalid_bitrate;
181 GST_DEBUG_OBJECT (payload, "selected base encoding %s", encoding_name);
183 /* now see if we need to produce AAL2 or not */
184 peercaps = gst_pad_peer_get_caps (payload->srcpad, NULL);
186 GstCaps *filter, *intersect;
189 GST_DEBUG_OBJECT (payload, "have peercaps %" GST_PTR_FORMAT, peercaps);
191 capsstr = g_strdup_printf ("application/x-rtp, "
192 "media = (string) \"audio\", "
193 "clock-rate = (int) 8000, "
194 "encoding-name = (string) %s; "
195 "application/x-rtp, "
196 "media = (string) \"audio\", "
197 "clock-rate = (int) 8000, "
198 "encoding-name = (string) AAL2-%s", encoding_name, encoding_name);
199 filter = gst_caps_from_string (capsstr);
202 /* intersect to filter */
203 intersect = gst_caps_intersect (peercaps, filter);
204 gst_caps_unref (peercaps);
206 GST_DEBUG_OBJECT (payload, "intersected to %" GST_PTR_FORMAT, intersect);
210 if (gst_caps_is_empty (intersect)) {
211 gst_caps_unref (intersect);
215 structure = gst_caps_get_structure (intersect, 0);
217 /* now see what encoding name we settled on, we need to dup because the
218 * string goes away when we unref the intersection below. */
220 g_strdup (gst_structure_get_string (structure, "encoding-name"));
222 /* if we managed to negotiate to AAL2, we definatly are going to do AAL2
223 * encoding. Else we only encode AAL2 when explicitly set by the
225 if (g_str_has_prefix (encoding_name, "AAL2-"))
228 pay->aal2 = pay->force_aal2;
230 GST_DEBUG_OBJECT (payload, "final encoding %s, AAL2 %d", encoding_name,
233 gst_caps_unref (intersect);
235 /* downstream can do anything but we prefer the better supported non-AAL2 */
236 pay->aal2 = pay->force_aal2;
237 GST_DEBUG_OBJECT (payload, "no peer caps, AAL2 %d", pay->aal2);
240 gst_rtp_base_payload_set_options (payload, "audio", TRUE, encoding_name,
242 res = gst_rtp_base_payload_set_outcaps (payload, NULL);
244 g_free (encoding_name);
251 GST_ERROR_OBJECT (payload, "invalid bitrate %d specified", pay->bitrate);
256 GST_ERROR_OBJECT (payload, "could not negotiate format");
262 gst_rtp_g726_pay_handle_buffer (GstRTPBasePayload * payload, GstBuffer * buffer)
267 pay = GST_RTP_G726_PAY (payload);
273 /* for non AAL2, we need to reshuffle the bytes, we can do this in-place
274 * when the buffer is writable. */
275 buffer = gst_buffer_make_writable (buffer);
277 data = gst_buffer_map (buffer, &len, NULL, GST_MAP_READWRITE);
279 GST_LOG_OBJECT (pay, "packing %u bytes of data", len);
281 /* we need to reshuffle the bytes, output is of the form:
282 * A B C D .. with the number of bits depending on the bitrate. */
283 switch (pay->bitrate) {
289 * |D D|C C|B B|A A| ...
295 *data++ = ((tmp & 0xc0) >> 6) |
296 ((tmp & 0x30) >> 2) | ((tmp & 0x0c) << 2) | ((tmp & 0x03) << 6);
304 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3
305 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
306 * |C C|B B B|A A A|F|E E E|D D D|C|H H H|G G G|F F| ...
307 * |1 2|0 1 2|0 1 2|2|0 1 2|0 1 2|0|0 1 2|0 1 2|0 1|
308 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
312 *data++ = ((tmp & 0xc0) >> 6) |
313 ((tmp & 0x38) >> 1) | ((tmp & 0x07) << 5);
315 *data++ = ((tmp & 0x80) >> 7) |
316 ((tmp & 0x70) >> 3) | ((tmp & 0x0e) << 4) | ((tmp & 0x01) << 7);
318 *data++ = ((tmp & 0xe0) >> 5) |
319 ((tmp & 0x1c) >> 2) | ((tmp & 0x03) << 6);
327 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
328 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
329 * |B B B B|A A A A|D D D D|C C C C| ...
330 * |0 1 2 3|0 1 2 3|0 1 2 3|0 1 2 3|
331 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
335 *data++ = ((tmp & 0xf0) >> 4) | ((tmp & 0x0f) << 4);
343 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
344 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
345 * |B B B|A A A A A|D|C C C C C|B B|E E E E|D D D D|G G|F F F F F|E|H H H H H|G G G|
346 * |2 3 4|0 1 2 3 4|4|0 1 2 3 4|0 1|1 2 3 4|0 1 2 3|3 4|0 1 2 3 4|0|0 1 2 3 4|0 1 2|
347 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
351 *data++ = ((tmp & 0xe0) >> 5) | ((tmp & 0x1f) << 3);
353 *data++ = ((tmp & 0x80) >> 7) |
354 ((tmp & 0x7c) >> 2) | ((tmp & 0x03) << 6);
356 *data++ = ((tmp & 0xf0) >> 4) | ((tmp & 0x0f) << 4);
358 *data++ = ((tmp & 0xc0) >> 6) |
359 ((tmp & 0x3e) << 2) | ((tmp & 0x01) << 7);
361 *data++ = ((tmp & 0xf8) >> 3) | ((tmp & 0x07) << 5);
367 gst_buffer_unmap (buffer, data, len);
371 GST_RTP_BASE_PAYLOAD_CLASS (parent_class)->handle_buffer (payload,
378 gst_rtp_g726_pay_set_property (GObject * object, guint prop_id,
379 const GValue * value, GParamSpec * pspec)
381 GstRtpG726Pay *rtpg726pay;
383 rtpg726pay = GST_RTP_G726_PAY (object);
386 case PROP_FORCE_AAL2:
387 rtpg726pay->force_aal2 = g_value_get_boolean (value);
390 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
396 gst_rtp_g726_pay_get_property (GObject * object, guint prop_id,
397 GValue * value, GParamSpec * pspec)
399 GstRtpG726Pay *rtpg726pay;
401 rtpg726pay = GST_RTP_G726_PAY (object);
404 case PROP_FORCE_AAL2:
405 g_value_set_boolean (value, rtpg726pay->force_aal2);
408 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
414 gst_rtp_g726_pay_plugin_init (GstPlugin * plugin)
416 return gst_element_register (plugin, "rtpg726pay",
417 GST_RANK_SECONDARY, GST_TYPE_RTP_G726_PAY);