libosmocodec  1.4.0.160-7619
Osmocom codec library
codec.h
Go to the documentation of this file.
1 
3 #pragma once
4 
5 #include <stdint.h>
6 #include <stdbool.h>
7 
8 #include <osmocom/core/utils.h>
9 #include <osmocom/core/bits.h>
10 
11 /* TS 101318 Chapter 5.1: 260 bits + 4bit sig */
12 #define GSM_FR_BYTES 33
13 /* TS 101318 Chapter 5.2: 112 bits, no sig */
14 #define GSM_HR_BYTES 14
15 /* TS 101318 Chapter 5.3: 244 bits + 4bit sig */
16 #define GSM_EFR_BYTES 31
17 
18 extern const uint16_t gsm610_bitorder[]; /* FR */
19 extern const uint16_t gsm620_unvoiced_bitorder[]; /* HR unvoiced */
20 extern const uint16_t gsm620_voiced_bitorder[]; /* HR voiced */
21 extern const uint16_t gsm660_bitorder[]; /* EFR */
22 
23 extern const uint16_t gsm690_12_2_bitorder[]; /* AMR 12.2 kbits */
24 extern const uint16_t gsm690_10_2_bitorder[]; /* AMR 10.2 kbits */
25 extern const uint16_t gsm690_7_95_bitorder[]; /* AMR 7.95 kbits */
26 extern const uint16_t gsm690_7_4_bitorder[]; /* AMR 7.4 kbits */
27 extern const uint16_t gsm690_6_7_bitorder[]; /* AMR 6.7 kbits */
28 extern const uint16_t gsm690_5_9_bitorder[]; /* AMR 5.9 kbits */
29 extern const uint16_t gsm690_5_15_bitorder[]; /* AMR 5.15 kbits */
30 extern const uint16_t gsm690_4_75_bitorder[]; /* AMR 4.75 kbits */
31 
32 extern const struct value_string osmo_amr_type_names[];
33 
35  AMR_4_75 = 0,
36  AMR_5_15 = 1,
37  AMR_5_90 = 2,
38  AMR_6_70 = 3,
39  AMR_7_40 = 4,
40  AMR_7_95 = 5,
41  AMR_10_2 = 6,
42  AMR_12_2 = 7,
43  AMR_SID = 8,
48 };
49 
51  AMR_BAD = 0,
52  AMR_GOOD = 1
53 };
54 
55 extern const uint8_t gsm690_bitlength[AMR_NO_DATA+1];
56 
57 int osmo_amr_s_to_d(ubit_t *out, const ubit_t *in, uint16_t n_bits, enum osmo_amr_type amr_mode);
58 int osmo_amr_d_to_s(ubit_t *out, const ubit_t *in, uint16_t n_bits, enum osmo_amr_type amr_mode);
59 
64 static inline bool osmo_amr_is_speech(enum osmo_amr_type ft)
65 {
66  switch (ft) {
67  case AMR_4_75:
68  case AMR_5_15:
69  case AMR_5_90:
70  case AMR_6_70:
71  case AMR_7_40:
72  case AMR_7_95:
73  case AMR_10_2:
74  case AMR_12_2:
75  return true;
76  default:
77  return false;
78  }
79 }
80 
81 bool osmo_fr_check_sid(const uint8_t *rtp_payload, size_t payload_len);
82 bool osmo_hr_check_sid(const uint8_t *rtp_payload, size_t payload_len);
83 int osmo_amr_rtp_enc(uint8_t *payload, uint8_t cmr, enum osmo_amr_type ft,
84  enum osmo_amr_quality bfi);
85 int osmo_amr_rtp_dec(const uint8_t *payload, int payload_len, uint8_t *cmr,
86  int8_t *cmi, enum osmo_amr_type *ft,
87  enum osmo_amr_quality *bfi, int8_t *sti);
const uint16_t gsm690_10_2_bitorder[]
Definition: gsm690.c:77
bool osmo_fr_check_sid(const uint8_t *rtp_payload, size_t payload_len)
Check whether RTP frame contains FR SID code word according to TS 101 318 §5.1.2.
Definition: gsm610.c:309
const uint8_t gsm690_bitlength[AMR_NO_DATA+1]
These constants refer to the length of one "AMR core frame" as per TS 26.101 Section 4....
Definition: gsm690.c:223
const uint16_t gsm690_7_4_bitorder[]
Definition: gsm690.c:128
const uint16_t gsm690_5_9_bitorder[]
Definition: gsm690.c:171
const uint16_t gsm690_4_75_bitorder[]
Definition: gsm690.c:208
const uint16_t gsm690_5_15_bitorder[]
Definition: gsm690.c:190
int osmo_amr_d_to_s(ubit_t *out, const ubit_t *in, uint16_t n_bits, enum osmo_amr_type amr_mode)
Convert from d-bits to s-bits (codec input).
Definition: gsm690.c:308
int osmo_amr_rtp_enc(uint8_t *payload, uint8_t cmr, enum osmo_amr_type ft, enum osmo_amr_quality bfi)
Encode various AMR parameters from RTP payload (RFC 4867)
Definition: gsm690.c:412
osmo_amr_type
Definition: codec.h:34
@ AMR_NO_DATA
Definition: codec.h:47
@ AMR_4_75
Definition: codec.h:35
@ AMR_12_2
Definition: codec.h:42
@ AMR_7_40
Definition: codec.h:39
@ AMR_10_2
Definition: codec.h:41
@ AMR_6_70
Definition: codec.h:38
@ AMR_GSM_EFR_SID
Definition: codec.h:44
@ AMR_PDC_EFR_SID
Definition: codec.h:46
@ AMR_SID
Definition: codec.h:43
@ AMR_5_90
Definition: codec.h:37
@ AMR_5_15
Definition: codec.h:36
@ AMR_7_95
Definition: codec.h:40
@ AMR_TDMA_EFR_SID
Definition: codec.h:45
static bool osmo_amr_is_speech(enum osmo_amr_type ft)
Check if given AMR Frame Type is a speech frame.
Definition: codec.h:64
int osmo_amr_rtp_dec(const uint8_t *payload, int payload_len, uint8_t *cmr, int8_t *cmi, enum osmo_amr_type *ft, enum osmo_amr_quality *bfi, int8_t *sti)
Decode various AMR parameters from RTP payload (RFC 4867) acording to 3GPP TS 26.101.
Definition: gsm690.c:364
const struct value_string osmo_amr_type_names[]
Definition: gsm690.c:334
const uint16_t gsm690_7_95_bitorder[]
Definition: gsm690.c:105
int osmo_amr_s_to_d(ubit_t *out, const ubit_t *in, uint16_t n_bits, enum osmo_amr_type amr_mode)
Convert from S-bits (codec output) to d-bits.
Definition: gsm690.c:282
const uint16_t gsm620_unvoiced_bitorder[]
Definition: gsm620.c:37
const uint16_t gsm610_bitorder[]
Definition: gsm610.c:40
const uint16_t gsm690_12_2_bitorder[]
Definition: gsm690.c:45
const uint16_t gsm690_6_7_bitorder[]
Definition: gsm690.c:150
osmo_amr_quality
Definition: codec.h:50
@ AMR_BAD
Definition: codec.h:51
@ AMR_GOOD
Definition: codec.h:52
bool osmo_hr_check_sid(const uint8_t *rtp_payload, size_t payload_len)
Check whether RTP frame contains HR SID code word according to TS 101 318 §5.2.2.
Definition: gsm620.c:283
const uint16_t gsm620_voiced_bitorder[]
Definition: gsm620.c:156
const uint16_t gsm660_bitorder[]
Definition: gsm660.c:38
uint8_t ubit_t