GNU Radio's GSM Package
codec.h
Go to the documentation of this file.
1 /*! \file codec.h */
2 
3 #pragma once
4 
5 #include <stdint.h>
6 #include <stdbool.h>
7 
8 #include <osmocom/core/utils.h>
9 
10 /* TS 101318 Chapter 5.1: 260 bits + 4bit sig */
11 #define GSM_FR_BYTES 33
12 /* TS 101318 Chapter 5.2: 112 bits, no sig */
13 #define GSM_HR_BYTES 14
14 /* TS 101318 Chapter 5.3: 244 bits + 4bit sig */
15 #define GSM_EFR_BYTES 31
16 
17 extern const uint16_t gsm610_bitorder[]; /* FR */
18 extern const uint16_t gsm620_unvoiced_bitorder[]; /* HR unvoiced */
19 extern const uint16_t gsm620_voiced_bitorder[]; /* HR voiced */
20 extern const uint16_t gsm660_bitorder[]; /* EFR */
21 
22 extern const uint16_t gsm690_12_2_bitorder[]; /* AMR 12.2 kbits */
23 extern const uint16_t gsm690_10_2_bitorder[]; /* AMR 10.2 kbits */
24 extern const uint16_t gsm690_7_95_bitorder[]; /* AMR 7.95 kbits */
25 extern const uint16_t gsm690_7_4_bitorder[]; /* AMR 7.4 kbits */
26 extern const uint16_t gsm690_6_7_bitorder[]; /* AMR 6.7 kbits */
27 extern const uint16_t gsm690_5_9_bitorder[]; /* AMR 5.9 kbits */
28 extern const uint16_t gsm690_5_15_bitorder[]; /* AMR 5.15 kbits */
29 extern const uint16_t gsm690_4_75_bitorder[]; /* AMR 4.75 kbits */
30 
31 extern const struct value_string osmo_amr_type_names[];
32 
34  AMR_4_75 = 0,
35  AMR_5_15 = 1,
36  AMR_5_90 = 2,
37  AMR_6_70 = 3,
38  AMR_7_40 = 4,
39  AMR_7_95 = 5,
40  AMR_10_2 = 6,
41  AMR_12_2 = 7,
42  AMR_SID = 8,
47 };
48 
50  AMR_BAD = 0,
51  AMR_GOOD = 1
52 };
53 
54 /*! Check if given AMR Frame Type is a speech frame
55  * \param[in] ft AMR Frame Type
56  * \returns true if AMR with given Frame Type contains voice, false otherwise
57  */
58 static inline bool osmo_amr_is_speech(enum osmo_amr_type ft)
59 {
60  switch (ft) {
61  case AMR_4_75:
62  case AMR_5_15:
63  case AMR_5_90:
64  case AMR_6_70:
65  case AMR_7_40:
66  case AMR_7_95:
67  case AMR_10_2:
68  case AMR_12_2:
69  return true;
70  default:
71  return false;
72  }
73 }
74 
75 bool osmo_fr_check_sid(const uint8_t *rtp_payload, size_t payload_len);
76 bool osmo_hr_check_sid(const uint8_t *rtp_payload, size_t payload_len);
77 int osmo_amr_rtp_enc(uint8_t *payload, uint8_t cmr, enum osmo_amr_type ft,
78  enum osmo_amr_quality bfi);
79 int osmo_amr_rtp_dec(const uint8_t *payload, int payload_len, uint8_t *cmr,
80  int8_t *cmi, enum osmo_amr_type *ft,
81  enum osmo_amr_quality *bfi, int8_t *sti);
AMR_12_2
@ AMR_12_2
Definition: codec.h:41
AMR_SID
@ AMR_SID
Definition: codec.h:42
gsm620_voiced_bitorder
const uint16_t gsm620_voiced_bitorder[]
osmo_amr_type
osmo_amr_type
Definition: codec.h:33
gsm690_10_2_bitorder
const uint16_t gsm690_10_2_bitorder[]
osmo_hr_check_sid
bool osmo_hr_check_sid(const uint8_t *rtp_payload, size_t payload_len)
gsm690_5_15_bitorder
const uint16_t gsm690_5_15_bitorder[]
osmo_fr_check_sid
bool osmo_fr_check_sid(const uint8_t *rtp_payload, size_t payload_len)
AMR_7_95
@ AMR_7_95
Definition: codec.h:39
AMR_NO_DATA
@ AMR_NO_DATA
Definition: codec.h:46
gsm690_6_7_bitorder
const uint16_t gsm690_6_7_bitorder[]
AMR_4_75
@ AMR_4_75
Definition: codec.h:34
AMR_PDC_EFR_SID
@ AMR_PDC_EFR_SID
Definition: codec.h:45
utils.h
AMR_5_15
@ AMR_5_15
Definition: codec.h:35
gsm690_7_4_bitorder
const uint16_t gsm690_7_4_bitorder[]
AMR_6_70
@ AMR_6_70
Definition: codec.h:37
osmo_amr_rtp_enc
int osmo_amr_rtp_enc(uint8_t *payload, uint8_t cmr, enum osmo_amr_type ft, enum osmo_amr_quality bfi)
AMR_7_40
@ AMR_7_40
Definition: codec.h:38
gsm690_7_95_bitorder
const uint16_t gsm690_7_95_bitorder[]
AMR_5_90
@ AMR_5_90
Definition: codec.h:36
gsm610_bitorder
const uint16_t gsm610_bitorder[]
value_string
Definition: utils.h:43
osmo_amr_type_names
const struct value_string osmo_amr_type_names[]
gsm690_12_2_bitorder
const uint16_t gsm690_12_2_bitorder[]
osmo_amr_rtp_dec
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)
AMR_TDMA_EFR_SID
@ AMR_TDMA_EFR_SID
Definition: codec.h:44
gsm660_bitorder
const uint16_t gsm660_bitorder[]
gsm620_unvoiced_bitorder
const uint16_t gsm620_unvoiced_bitorder[]
AMR_10_2
@ AMR_10_2
Definition: codec.h:40
osmo_amr_quality
osmo_amr_quality
Definition: codec.h:49
AMR_BAD
@ AMR_BAD
Definition: codec.h:50
gsm690_4_75_bitorder
const uint16_t gsm690_4_75_bitorder[]
osmo_amr_is_speech
static bool osmo_amr_is_speech(enum osmo_amr_type ft)
Definition: codec.h:58
gsm690_5_9_bitorder
const uint16_t gsm690_5_9_bitorder[]
AMR_GOOD
@ AMR_GOOD
Definition: codec.h:51
AMR_GSM_EFR_SID
@ AMR_GSM_EFR_SID
Definition: codec.h:43