1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
#ifndef _OSMO_ORTP_H
#define _OSMO_ORTP_H
#include <stdint.h>
#include <stdbool.h>
#include <osmocom/core/linuxlist.h>
#include <osmocom/core/select.h>
/* we cannot include ortp/ortp.h here, as they also use 'struct msgb' */
struct _RtpSession;
/*! \brief default duration of a 20ms GSM codec frame */
#define GSM_RTP_DURATION 160
/*! \brief standard payload type for GSM Full Rate (FR) */
#define RTP_PT_GSM_FULL 3
/*! \brief Osmocom pseudo-static paylaod type for Half Rate (HR) */
#define RTP_PT_GSM_HALF 96
/*! \brief Osmocom pseudo-static paylaod type for Enhanced Full Rate (EFR) */
#define RTP_PT_GSM_EFR 97
/*! \brief Osmocom pseudo-static paylaod type for Adaptive Multi Rate (AMR) */
#define RTP_PT_AMR 98
#define GSM_VOICE_SAMPLE_RATE_HZ 8000
#define GSM_VOICE_SAMPLES_PER_MS (GSM_VOICE_SAMPLE_RATE_HZ / 1000)
#define GSM_VOICE_MULTIFRAME 26
#define GSM_RTP_FRAME_DURATION_MS 20
#define GSM_SAMPLES_PER_RTP_FRAME (GSM_RTP_FRAME_DURATION_MS * GSM_VOICE_SAMPLES_PER_MS)
#define GSM_TDMA_FRAME_MS (120 / GSM_VOICE_MULTIFRAME)
#define GSM_MS_TO_SAMPLES(ms) ((ms) * GSM_VOICE_SAMPLES_PER_MS)
#define GSM_FN_TO_MS(fn) ((fn) * GSM_TDMA_FRAME_MS)
/*! \brief Parameter to osmo_rtp_socket_param_set() */
enum osmo_rtp_param {
OSMO_RTP_P_JITBUF = 1,
OSMO_RTP_P_JIT_ADAP,
};
/*! \brief Flag to indicate the socket is in polling-only mode */
#define OSMO_RTP_F_POLL 0x0001
#define OSMO_RTP_F_DISABLED 0x0002
/*! \brief A structure representing one RTP socket */
struct osmo_rtp_socket {
/*! \biref list header for global list of sockets */
struct llist_head list;
/*! \brief libortp RTP session pointer */
struct _RtpSession *sess;
/*! \brief Osmo file descriptor for RTP socket FD */
struct osmo_fd rtp_bfd;
/*! \brief Osmo file descriptor for RTCP socket FD */
struct osmo_fd rtcp_bfd;
/*! \brief callback for incoming data */
void (*rx_cb)(struct osmo_rtp_socket *rs, const uint8_t *payload,
unsigned int payload_len, uint16_t seq_number,
uint32_t timestamp, bool marker);
/*! \brief Receive user timestamp, to be incremented by user */
uint32_t rx_user_ts;
/*! \brief Transmit timestamp, incremented by library */
uint32_t tx_timestamp;
/*! \brief Flags like OSMO_RTP_F_POLL */
unsigned int flags;
void *priv;
};
void osmo_rtp_init(void *ctx);
struct osmo_rtp_socket *osmo_rtp_socket_create(void *talloc_ctx, unsigned int flags);
int osmo_rtp_socket_bind(struct osmo_rtp_socket *rs, const char *ip, int port);
int osmo_rtp_socket_connect(struct osmo_rtp_socket *rs, const char *ip, uint16_t port);
int osmo_rtp_socket_autoconnect(struct osmo_rtp_socket *rs);
int osmo_rtp_socket_set_pt(struct osmo_rtp_socket *rs, int payload_type);
int osmo_rtp_socket_free(struct osmo_rtp_socket *rs);
int osmo_rtp_skipped_frame(struct osmo_rtp_socket *rs, unsigned int duration);
int osmo_rtp_send_frame(struct osmo_rtp_socket *rs, const uint8_t *payload,
unsigned int payload_len, unsigned int duration);
int osmo_rtp_send_frame_ext(struct osmo_rtp_socket *rs, const uint8_t *payload,
unsigned int payload_len, unsigned int duration,
bool marker);
int osmo_rtp_socket_poll(struct osmo_rtp_socket *rs);
int osmo_rtp_get_bound_ip_port(struct osmo_rtp_socket *rs,
uint32_t *ip, int *port);
int osmo_rtp_get_bound_addr(struct osmo_rtp_socket *rs,
const char **addr, int *port);
int osmo_rtp_socket_set_param(struct osmo_rtp_socket *rs,
enum osmo_rtp_param param, int val);
void osmo_rtp_socket_log_stats(struct osmo_rtp_socket *rs,
int subsys, int level,
const char *pfx);
void osmo_rtp_socket_stats(struct osmo_rtp_socket *rs,
uint32_t *sent_packets, uint32_t *sent_octets,
uint32_t *recv_packets, uint32_t *recv_octets,
uint32_t *recv_lost, uint32_t *last_jitter);
void osmo_rtp_set_source_desc(struct osmo_rtp_socket *rs, const char *cname,
const char *name, const char *email, const char *phone,
const char *loc, const char *tool, const char *note);
#endif /* _OSMO_ORTP_H */
|
