oRTP  0.23.0
rtp.h
1 /*
2  The oRTP library is an RTP (Realtime Transport Protocol - rfc3550) stack.
3  Copyright (C) 2001 Simon MORLAT simon.morlat@linphone.org
4 
5  This library is free software; you can redistribute it and/or
6  modify it under the terms of the GNU Lesser General Public
7  License as published by the Free Software Foundation; either
8  version 2.1 of the License, or (at your option) any later version.
9 
10  This library is distributed in the hope that it will be useful,
11  but WITHOUT ANY WARRANTY; without even the implied warranty of
12  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  Lesser General Public License for more details.
14 
15  You should have received a copy of the GNU Lesser General Public
16  License along with this library; if not, write to the Free Software
17  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18 */
19 
20 
21 #ifndef RTP_H
22 #define RTP_H
23 
24 #include <ortp/port.h>
25 #include <ortp/str_utils.h>
26 
27 #define IPMAXLEN 20
28 #define UDP_MAX_SIZE 1500
29 #define RTP_FIXED_HEADER_SIZE 12
30 #define RTP_DEFAULT_JITTER_TIME 80 /*miliseconds*/
31 #define RTP_DEFAULT_MULTICAST_TTL 5 /*hops*/
32 #define RTP_DEFAULT_MULTICAST_LOOPBACK 0 /*false*/
33 #define RTP_DEFAULT_DSCP 0x00 /*best effort*/
34 
35 
36 
37 typedef struct rtp_header
38 {
39 #ifdef ORTP_BIGENDIAN
40  uint16_t version:2;
41  uint16_t padbit:1;
42  uint16_t extbit:1;
43  uint16_t cc:4;
44  uint16_t markbit:1;
45  uint16_t paytype:7;
46 #else
47  uint16_t cc:4;
48  uint16_t extbit:1;
49  uint16_t padbit:1;
50  uint16_t version:2;
51  uint16_t paytype:7;
52  uint16_t markbit:1;
53 #endif
54  uint16_t seq_number;
55  uint32_t timestamp;
56  uint32_t ssrc;
57  uint32_t csrc[16];
58 } rtp_header_t;
59 
60 
61 
62 
63 typedef struct rtp_stats
64 {
65  uint64_t packet_sent;
66  uint64_t sent; /* bytes sent */
67  uint64_t recv; /* bytes of payload received and delivered in time to the application */
68  uint64_t hw_recv; /* bytes of payload received */
69  uint64_t packet_recv; /* number of packets received */
70  uint64_t outoftime; /* number of packets that were received too late */
71  uint64_t cum_packet_loss; /* cumulative number of packet lost */
72  uint64_t bad; /* packets that did not appear to be RTP */
73  uint64_t discarded; /* incoming packets discarded because the queue exceeds its max size */
74  uint64_t sent_rtcp_packets; /* sent RTCP packets counter (only packets that embed a report block are considered) */
75 } rtp_stats_t;
76 
77 typedef struct jitter_stats
78 {
79  uint32_t jitter; /* interarrival jitter at last emitted sender report */
80  uint32_t max_jitter; /* biggest interarrival jitter (value in stream clock unit) */
81  uint64_t sum_jitter; /* sum of all interarrival jitter (value in stream clock unit) */
82  uint64_t max_jitter_ts; /* date (in ms since Epoch) of the biggest interarrival jitter */
83  float jitter_buffer_size_ms; /* mean jitter buffer size in milliseconds.*/
85 
86 #define RTP_TIMESTAMP_IS_NEWER_THAN(ts1,ts2) \
87  ((uint32_t)((uint32_t)(ts1) - (uint32_t)(ts2))< (uint32_t)(1<<31))
88 
89 #define RTP_TIMESTAMP_IS_STRICTLY_NEWER_THAN(ts1,ts2) \
90  ( ((uint32_t)((uint32_t)(ts1) - (uint32_t)(ts2))< (uint32_t)(1<<31)) && (ts1)!=(ts2) )
91 
92 #define TIME_IS_NEWER_THAN(t1,t2) RTP_TIMESTAMP_IS_NEWER_THAN(t1,t2)
93 
94 #define TIME_IS_STRICTLY_NEWER_THAN(t1,t2) RTP_TIMESTAMP_IS_STRICTLY_NEWER_THAN(t1,t2)
95 
96 
97 #ifdef __cplusplus
98 extern "C"{
99 #endif
100 
101 /* packet api */
102 /* the first argument is a mblk_t. The header is supposed to be not splitted */
103 #define rtp_set_markbit(mp,value) ((rtp_header_t*)((mp)->b_rptr))->markbit=(value)
104 #define rtp_set_seqnumber(mp,seq) ((rtp_header_t*)((mp)->b_rptr))->seq_number=(seq)
105 #define rtp_set_timestamp(mp,ts) ((rtp_header_t*)((mp)->b_rptr))->timestamp=(ts)
106 #define rtp_set_ssrc(mp,_ssrc) ((rtp_header_t*)((mp)->b_rptr))->ssrc=(_ssrc)
107 ORTP_PUBLIC void rtp_add_csrc(mblk_t *mp ,uint32_t csrc);
108 #define rtp_set_payload_type(mp,pt) ((rtp_header_t*)((mp)->b_rptr))->paytype=(pt)
109 
110 #define rtp_get_markbit(mp) (((rtp_header_t*)((mp)->b_rptr))->markbit)
111 #define rtp_get_extbit(mp) (((rtp_header_t*)((mp)->b_rptr))->extbit)
112 #define rtp_get_timestamp(mp) (((rtp_header_t*)((mp)->b_rptr))->timestamp)
113 #define rtp_get_seqnumber(mp) (((rtp_header_t*)((mp)->b_rptr))->seq_number)
114 #define rtp_get_payload_type(mp) (((rtp_header_t*)((mp)->b_rptr))->paytype)
115 #define rtp_get_ssrc(mp) (((rtp_header_t*)((mp)->b_rptr))->ssrc)
116 #define rtp_get_cc(mp) (((rtp_header_t*)((mp)->b_rptr))->cc)
117 #define rtp_get_csrc(mp, idx) (((rtp_header_t*)((mp)->b_rptr))->csrc[idx])
118 
119 ORTP_PUBLIC int rtp_get_payload(mblk_t *packet, unsigned char **start);
120 ORTP_PUBLIC int rtp_get_extheader(mblk_t *packet, uint16_t *profile, uint8_t **start_ext);
121 
122 #ifdef __cplusplus
123 }
124 #endif
125 
126 #endif
Definition: str_utils.h:49
Definition: rtp.h:77
Definition: rtp.h:63
Definition: rtp.h:37