oRTP 0.25.0

- Main Page
- Data Structures
- Files

- File List
- Globals

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; /*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.*/
86 } jitter_stats_t;
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
msgb
Definition: str_utils.h:49
jitter_stats
Definition: rtp.h:79
rtp_stats
Definition: rtp.h:63
rtp_header
Definition: rtp.h:37