oRTP  0.24.0
rtp.h
1 /*
2  The oRTP library is an RTP (Realtime Transport Protocol - rfc3550) stack.
3  Copyright (C) 2001 Simon MORLAT [email protected]
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; /*number of outgoing packets */
66  uint64_t packet_dup_sent; /*number of outgoing duplicate packets */
67  uint64_t sent; /* outgoing total bytes (excluding IP header) */
68  uint64_t packet_recv; /* number of incoming packets */
69  uint64_t packet_dup_recv; /* number of incoming duplicate packets */
70  uint64_t recv; /* incoming bytes of payload and delivered in time to the application */
71  uint64_t hw_recv; /* incoming bytes of payload */
72  uint64_t outoftime; /* number of incoming packets that were received too late */
73  int64_t cum_packet_loss; /* cumulative number of incoming packet lost */
74  uint64_t bad; /* incoming packets that did not appear to be RTP */
75  uint64_t discarded; /* incoming packets discarded because the queue exceeds its max size */
76  uint64_t sent_rtcp_packets; /* outgoing RTCP packets counter (only packets that embed a report block are considered) */
77 } rtp_stats_t;
78 
79 typedef struct jitter_stats
80 {
81  uint32_t jitter; /* interarrival jitter at last emitted sender report */
82  uint32_t max_jitter; /* biggest interarrival jitter (value in stream clock unit) */
83  uint64_t sum_jitter; /* sum of all interarrival jitter (value in stream clock unit) */
84  uint64_t max_jitter_ts; /* date (in ms since Epoch) of the biggest interarrival jitter */
85  float jitter_buffer_size_ms;/* mean jitter buffer size in milliseconds.*/
87 
88 #define RTP_TIMESTAMP_IS_NEWER_THAN(ts1,ts2) \
89  ((uint32_t)((uint32_t)(ts1) - (uint32_t)(ts2))< (uint32_t)(1<<31))
90 
91 #define RTP_TIMESTAMP_IS_STRICTLY_NEWER_THAN(ts1,ts2) \
92  ( ((uint32_t)((uint32_t)(ts1) - (uint32_t)(ts2))< (uint32_t)(1<<31)) && (ts1)!=(ts2) )
93 
94 #define RTP_SEQ_IS_STRICTLY_GREATER_THAN(seq1,seq2)\
95  (((uint16_t)((uint16_t)(seq1) - (uint16_t)(seq2))< (uint16_t)(1<<15)) && (seq1!=seq2))
96 
97 #define TIME_IS_NEWER_THAN(t1,t2) RTP_TIMESTAMP_IS_NEWER_THAN(t1,t2)
98 
99 #define TIME_IS_STRICTLY_NEWER_THAN(t1,t2) RTP_TIMESTAMP_IS_STRICTLY_NEWER_THAN(t1,t2)
100 
101 
102 #ifdef __cplusplus
103 extern "C"{
104 #endif
105 
106 /* packet api */
107 /* the first argument is a mblk_t. The header is supposed to be not splitted */
108 #define rtp_set_markbit(mp,value) ((rtp_header_t*)((mp)->b_rptr))->markbit=(value)
109 #define rtp_set_seqnumber(mp,seq) ((rtp_header_t*)((mp)->b_rptr))->seq_number=(seq)
110 #define rtp_set_timestamp(mp,ts) ((rtp_header_t*)((mp)->b_rptr))->timestamp=(ts)
111 #define rtp_set_ssrc(mp,_ssrc) ((rtp_header_t*)((mp)->b_rptr))->ssrc=(_ssrc)
112 ORTP_PUBLIC void rtp_add_csrc(mblk_t *mp ,uint32_t csrc);
113 #define rtp_set_payload_type(mp,pt) ((rtp_header_t*)((mp)->b_rptr))->paytype=(pt)
114 
115 #define rtp_get_markbit(mp) (((rtp_header_t*)((mp)->b_rptr))->markbit)
116 #define rtp_get_extbit(mp) (((rtp_header_t*)((mp)->b_rptr))->extbit)
117 #define rtp_get_timestamp(mp) (((rtp_header_t*)((mp)->b_rptr))->timestamp)
118 #define rtp_get_seqnumber(mp) (((rtp_header_t*)((mp)->b_rptr))->seq_number)
119 #define rtp_get_payload_type(mp) (((rtp_header_t*)((mp)->b_rptr))->paytype)
120 #define rtp_get_ssrc(mp) (((rtp_header_t*)((mp)->b_rptr))->ssrc)
121 #define rtp_get_cc(mp) (((rtp_header_t*)((mp)->b_rptr))->cc)
122 #define rtp_get_csrc(mp, idx) (((rtp_header_t*)((mp)->b_rptr))->csrc[idx])
123 
124 ORTP_PUBLIC int rtp_get_payload(mblk_t *packet, unsigned char **start);
125 ORTP_PUBLIC int rtp_get_extheader(mblk_t *packet, uint16_t *profile, uint8_t **start_ext);
126 
127 #ifdef __cplusplus
128 }
129 #endif
130 
131 #endif
Definition: str_utils.h:49
Definition: rtp.h:79
Definition: rtp.h:63
Definition: rtp.h:37