2 * RTP H264 Protocol (RFC3984)
3 * Copyright (c) 2006 Ryan Martell.
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg 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 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 * @brief H.264 / RTP Code (RFC3984)
25 * @author Ryan Martell <rdm4@martellventures.com>
29 * This currently supports packetization mode:
30 * Single Nal Unit Mode (0), or
31 * Non-Interleaved Mode (1). It currently does not support
32 * Interleaved Mode (2). (This requires implementing STAP-B, MTAP16, MTAP24, FU-B packet types)
35 * 1) RTCP sender reports for udp streams are required..
41 #include "bitstream.h"
44 #include <sys/types.h>
45 #include <sys/socket.h>
46 #include <netinet/in.h>
49 # include <arpa/inet.h>
51 # include "barpainet.h"
55 #include "rtp_internal.h"
60 RTP/H264 specific private data.
62 typedef struct h264_rtp_extra_data
{
63 unsigned long cookie
; ///< sanity check, to make sure we get the pointer we're expecting.
65 //sdp setup parameters
66 uint8_t profile_idc
; ///< from the sdp setup parameters.
67 uint8_t profile_iop
; ///< from the sdp setup parameters.
68 uint8_t level_idc
; ///< from the sdp setup parameters.
69 int packetization_mode
; ///< from the sdp setup parameters.
71 int packet_types_received
[32];
73 } h264_rtp_extra_data
;
75 #define MAGIC_COOKIE (0xdeadbeef) ///< Cookie for the extradata; to verify we are what we think we are, and that we haven't been freed.
76 #define DEAD_COOKIE (0xdeaddead) ///< Cookie for the extradata; once it is freed.
78 /* ---------------- private code */
79 static void sdp_parse_fmtp_config_h264(AVStream
* stream
,
80 h264_rtp_extra_data
* h264_data
,
81 char *attr
, char *value
)
83 AVCodecContext
*codec
= stream
->codec
;
84 assert(codec
->codec_id
== CODEC_ID_H264
);
85 assert(h264_data
!= NULL
);
87 if (!strcmp(attr
, "packetization-mode")) {
88 av_log(NULL
, AV_LOG_DEBUG
, "H.264/RTP Packetization Mode: %d\n", atoi(attr
));
89 h264_data
->packetization_mode
= atoi(attr
);
92 0 or not present: Single NAL mode (Only nals from 1-23 are allowed)
93 1: Non-interleaved Mode: 1-23, 24 (STAP-A), 28 (FU-A) are allowed.
94 2: Interleaved Mode: 25 (STAP-B), 26 (MTAP16), 27 (MTAP24), 28 (FU-A), and 29 (FU-B) are allowed.
96 if (h264_data
->packetization_mode
> 1)
97 av_log(stream
, AV_LOG_ERROR
,
98 "H.264/RTP Interleaved RTP mode is not supported yet.");
99 } else if (!strcmp(attr
, "profile-level-id")) {
100 if (strlen(value
) == 6) {
102 // 6 characters=3 bytes, in hex.
107 buffer
[0] = value
[0]; buffer
[1] = value
[1]; buffer
[2] = '\0';
108 profile_idc
= strtol(buffer
, NULL
, 16);
109 buffer
[0] = value
[2]; buffer
[1] = value
[3];
110 profile_iop
= strtol(buffer
, NULL
, 16);
111 buffer
[0] = value
[4]; buffer
[1] = value
[5];
112 level_idc
= strtol(buffer
, NULL
, 16);
114 // set the parameters...
115 av_log(NULL
, AV_LOG_DEBUG
,
116 "H.264/RTP Profile IDC: %x Profile IOP: %x Level: %x\n",
117 profile_idc
, profile_iop
, level_idc
);
118 h264_data
->profile_idc
= profile_idc
;
119 h264_data
->profile_iop
= profile_iop
;
120 h264_data
->level_idc
= level_idc
;
122 } else if (!strcmp(attr
, "sprop-parameter-sets")) {
123 uint8_t start_sequence
[]= { 0, 0, 1 };
124 codec
->extradata_size
= 0;
125 codec
->extradata
= NULL
;
128 char base64packet
[1024];
129 uint8_t decoded_packet
[1024];
130 uint32_t packet_size
;
131 char *dst
= base64packet
;
133 while (*value
&& *value
!= ','
134 && (dst
- base64packet
) < sizeof(base64packet
) - 1) {
142 packet_size
= av_base64_decode(decoded_packet
, base64packet
, sizeof(decoded_packet
));
144 uint8_t *dest
= av_malloc(packet_size
+sizeof(start_sequence
)+codec
->extradata_size
);
147 if(codec
->extradata_size
)
150 memcpy(dest
, codec
->extradata
, codec
->extradata_size
);
151 av_free(codec
->extradata
);
154 memcpy(dest
+codec
->extradata_size
, start_sequence
, sizeof(start_sequence
));
155 memcpy(dest
+codec
->extradata_size
+sizeof(start_sequence
), decoded_packet
, packet_size
);
157 codec
->extradata
= dest
;
158 codec
->extradata_size
+= sizeof(start_sequence
)+packet_size
;
160 av_log(NULL
, AV_LOG_ERROR
, "H.264/RTP Unable to allocate memory for extradata!");
164 av_log(NULL
, AV_LOG_DEBUG
, "H.264/RTP Extradata set to %p (size: %d)!", codec
->extradata
, codec
->extradata_size
);
168 // return 0 on packet, no more left, 1 on packet, 1 on partial packet...
169 static int h264_handle_packet(RTPDemuxContext
* s
,
171 uint32_t * timestamp
,
175 // h264_rtp_extra_data *data = s->dynamic_protocol_context;
176 uint8_t nal
= buf
[0];
177 uint8_t type
= (nal
& 0x1f);
179 uint8_t start_sequence
[]= {0, 0, 1};
182 assert(data
->cookie
== MAGIC_COOKIE
);
185 if (type
>= 1 && type
<= 23)
186 type
= 1; // simplify the case. (these are all the nal types used internally by the h264 codec)
188 case 0: // undefined;
193 av_new_packet(pkt
, len
+sizeof(start_sequence
));
194 memcpy(pkt
->data
, start_sequence
, sizeof(start_sequence
));
195 memcpy(pkt
->data
+sizeof(start_sequence
), buf
, len
);
197 data
->packet_types_received
[nal
& 0x1f]++;
201 case 24: // STAP-A (one packet, multiple nals)
202 // consume the STAP-A NAL
205 // first we are going to figure out the total size....
211 for(pass
= 0; pass
<2; pass
++) {
212 const uint8_t *src
= buf
;
216 uint16_t nal_size
= BE_16(src
); // this going to be a problem if unaligned (can it be?)
218 // consume the length of the aggregate...
222 if (nal_size
<= src_len
) {
225 total_length
+= sizeof(start_sequence
)+nal_size
;
229 memcpy(dst
, start_sequence
, sizeof(start_sequence
));
230 dst
+= sizeof(start_sequence
);
231 memcpy(dst
, src
, nal_size
);
233 data
->packet_types_received
[*src
& 0x1f]++;
238 av_log(NULL
, AV_LOG_ERROR
,
239 "nal size exceeds length: %d %d\n", nal_size
, src_len
);
242 // eat what we handled...
247 av_log(NULL
, AV_LOG_ERROR
,
248 "Consumed more bytes than we got! (%d)\n", src_len
);
249 } while (src_len
> 2); // because there could be rtp padding..
252 // now we know the total size of the packet (with the start sequences added)
253 av_new_packet(pkt
, total_length
);
256 assert(dst
-pkt
->data
==total_length
);
266 av_log(NULL
, AV_LOG_ERROR
,
267 "Unhandled type (%d) (See RFC for implementation details\n",
272 case 28: // FU-A (fragmented nal)
274 len
--; // skip the fu_indicator
276 // these are the same as above, we just redo them here for clarity...
277 uint8_t fu_indicator
= nal
;
278 uint8_t fu_header
= *buf
; // read the fu_header.
279 uint8_t start_bit
= (fu_header
& 0x80) >> 7;
280 // uint8_t end_bit = (fu_header & 0x40) >> 6;
281 uint8_t nal_type
= (fu_header
& 0x1f);
282 uint8_t reconstructed_nal
;
284 // reconstruct this packet's true nal; only the data follows..
285 reconstructed_nal
= fu_indicator
& (0xe0); // the original nal forbidden bit and NRI are stored in this packet's nal;
286 reconstructed_nal
|= (nal_type
& 0x1f);
288 // skip the fu_header...
294 data
->packet_types_received
[nal_type
& 0x1f]++;
297 // copy in the start sequence, and the reconstructed nal....
298 av_new_packet(pkt
, sizeof(start_sequence
)+sizeof(nal
)+len
);
299 memcpy(pkt
->data
, start_sequence
, sizeof(start_sequence
));
300 pkt
->data
[sizeof(start_sequence
)]= reconstructed_nal
;
301 memcpy(pkt
->data
+sizeof(start_sequence
)+sizeof(nal
), buf
, len
);
303 av_new_packet(pkt
, len
);
304 memcpy(pkt
->data
, buf
, len
);
309 case 30: // undefined
310 case 31: // undefined
312 av_log(NULL
, AV_LOG_ERROR
, "Undefined type (%d)", type
);
320 /* ---------------- public code */
321 static void *h264_new_extradata()
323 h264_rtp_extra_data
*data
=
324 av_mallocz(sizeof(h264_rtp_extra_data
) +
325 FF_INPUT_BUFFER_PADDING_SIZE
);
328 data
->cookie
= MAGIC_COOKIE
;
334 static void h264_free_extradata(void *d
)
336 h264_rtp_extra_data
*data
= (h264_rtp_extra_data
*) d
;
340 for (ii
= 0; ii
< 32; ii
++) {
341 if (data
->packet_types_received
[ii
])
342 av_log(NULL
, AV_LOG_DEBUG
, "Received %d packets of type %d\n",
343 data
->packet_types_received
[ii
], ii
);
348 assert(data
->cookie
== MAGIC_COOKIE
);
350 // avoid stale pointers (assert)
351 data
->cookie
= DEAD_COOKIE
;
353 // and clear out this...
357 static int parse_h264_sdp_line(AVStream
* stream
, void *data
,
360 AVCodecContext
*codec
= stream
->codec
;
361 h264_rtp_extra_data
*h264_data
= (h264_rtp_extra_data
*) data
;
362 const char *p
= line
;
364 assert(h264_data
->cookie
== MAGIC_COOKIE
);
366 if (strstart(p
, "framesize:", &p
)) {
370 // remove the protocol identifier..
371 while (*p
&& *p
== ' ') p
++; // strip spaces.
372 while (*p
&& *p
!= ' ') p
++; // eat protocol identifier
373 while (*p
&& *p
== ' ') p
++; // strip trailing spaces.
374 while (*p
&& *p
!= '-' && (buf1
- dst
) < sizeof(buf1
) - 1) {
379 // a='framesize:96 320-240'
380 // set our parameters..
381 codec
->width
= atoi(buf1
);
382 codec
->height
= atoi(p
+ 1); // skip the -
383 codec
->pix_fmt
= PIX_FMT_YUV420P
;
384 } else if (strstart(p
, "fmtp:", &p
)) {
388 // remove the protocol identifier..
389 while (*p
&& *p
== ' ') p
++; // strip spaces.
390 while (*p
&& *p
!= ' ') p
++; // eat protocol identifier
391 while (*p
&& *p
== ' ') p
++; // strip trailing spaces.
393 /* loop on each attribute */
394 while (rtsp_next_attr_and_value
395 (&p
, attr
, sizeof(attr
), value
, sizeof(value
))) {
396 /* grab the codec extra_data from the config parameter of the fmtp line */
397 sdp_parse_fmtp_config_h264(stream
, h264_data
, attr
, value
);
399 } else if (strstart(p
, "cliprect:", &p
)) {
400 // could use this if we wanted.
403 av_set_pts_info(stream
, 33, 1, 90000); // 33 should be right, because the pts is 64 bit? (done elsewhere; this is a one time thing)
405 return 0; // keep processing it the normal way...
409 This is the structure for expanding on the dynamic rtp protocols (makes everything static. yay!)
411 RTPDynamicProtocolHandler ff_h264_dynamic_handler
= {