Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 1 | /*! \file codec.h */ |
| 2 | |
Sylvain Munaut | 12ba778 | 2014-06-16 10:13:40 +0200 | [diff] [blame] | 3 | #pragma once |
Sylvain Munaut | 1a4ea5b | 2010-10-08 15:09:16 +0200 | [diff] [blame] | 4 | |
| 5 | #include <stdint.h> |
Max | ec8f192 | 2016-05-31 14:50:21 +0200 | [diff] [blame] | 6 | #include <stdbool.h> |
Sylvain Munaut | 1a4ea5b | 2010-10-08 15:09:16 +0200 | [diff] [blame] | 7 | |
Max | 92db150 | 2016-05-25 18:13:51 +0200 | [diff] [blame] | 8 | #include <osmocom/core/utils.h> |
Harald Welte | 5785a4a | 2020-05-13 23:10:31 +0200 | [diff] [blame] | 9 | #include <osmocom/core/bits.h> |
Max | 92db150 | 2016-05-25 18:13:51 +0200 | [diff] [blame] | 10 | |
Vadim Yanitskiy | e094157 | 2017-12-16 01:39:48 +0700 | [diff] [blame] | 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 | |
Diego Elio Pettenò | 23431c7 | 2012-06-29 13:01:27 -0700 | [diff] [blame] | 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 */ |
Sylvain Munaut | 1a4ea5b | 2010-10-08 15:09:16 +0200 | [diff] [blame] | 22 | |
Diego Elio Pettenò | 23431c7 | 2012-06-29 13:01:27 -0700 | [diff] [blame] | 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 */ |
Max | 92db150 | 2016-05-25 18:13:51 +0200 | [diff] [blame] | 31 | |
| 32 | extern const struct value_string osmo_amr_type_names[]; |
| 33 | |
| 34 | enum osmo_amr_type { |
| 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, |
| 44 | AMR_GSM_EFR_SID = 9, |
| 45 | AMR_TDMA_EFR_SID = 10, |
| 46 | AMR_PDC_EFR_SID = 11, |
| 47 | AMR_NO_DATA = 15, |
| 48 | }; |
| 49 | |
Philipp Maier | 2bd4bc9 | 2021-08-23 15:42:51 +0200 | [diff] [blame] | 50 | static inline const char *osmo_amr_type_name(enum osmo_amr_type type) |
| 51 | { return get_value_string(osmo_amr_type_names, type); } |
| 52 | |
Max | 92db150 | 2016-05-25 18:13:51 +0200 | [diff] [blame] | 53 | enum osmo_amr_quality { |
| 54 | AMR_BAD = 0, |
| 55 | AMR_GOOD = 1 |
| 56 | }; |
| 57 | |
Harald Welte | 5785a4a | 2020-05-13 23:10:31 +0200 | [diff] [blame] | 58 | extern const uint8_t gsm690_bitlength[AMR_NO_DATA+1]; |
| 59 | |
| 60 | int osmo_amr_s_to_d(ubit_t *out, const ubit_t *in, uint16_t n_bits, enum osmo_amr_type amr_mode); |
| 61 | int osmo_amr_d_to_s(ubit_t *out, const ubit_t *in, uint16_t n_bits, enum osmo_amr_type amr_mode); |
| 62 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 63 | /*! Check if given AMR Frame Type is a speech frame |
Max | 74a8f08 | 2016-09-27 13:51:51 +0200 | [diff] [blame] | 64 | * \param[in] ft AMR Frame Type |
| 65 | * \returns true if AMR with given Frame Type contains voice, false otherwise |
| 66 | */ |
Max | 2bb65be | 2016-09-28 15:38:55 +0200 | [diff] [blame] | 67 | static inline bool osmo_amr_is_speech(enum osmo_amr_type ft) |
Max | 74a8f08 | 2016-09-27 13:51:51 +0200 | [diff] [blame] | 68 | { |
| 69 | switch (ft) { |
| 70 | case AMR_4_75: |
| 71 | case AMR_5_15: |
| 72 | case AMR_5_90: |
| 73 | case AMR_6_70: |
| 74 | case AMR_7_40: |
| 75 | case AMR_7_95: |
| 76 | case AMR_10_2: |
| 77 | case AMR_12_2: |
| 78 | return true; |
| 79 | default: |
| 80 | return false; |
| 81 | } |
| 82 | } |
| 83 | |
Harald Welte | 6789ba3 | 2017-05-31 02:47:43 +0200 | [diff] [blame] | 84 | bool osmo_fr_check_sid(const uint8_t *rtp_payload, size_t payload_len); |
| 85 | bool osmo_hr_check_sid(const uint8_t *rtp_payload, size_t payload_len); |
Max | 92db150 | 2016-05-25 18:13:51 +0200 | [diff] [blame] | 86 | int osmo_amr_rtp_enc(uint8_t *payload, uint8_t cmr, enum osmo_amr_type ft, |
| 87 | enum osmo_amr_quality bfi); |
| 88 | int osmo_amr_rtp_dec(const uint8_t *payload, int payload_len, uint8_t *cmr, |
| 89 | int8_t *cmi, enum osmo_amr_type *ft, |
| 90 | enum osmo_amr_quality *bfi, int8_t *sti); |