codec.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stdbool.h>
 
#include <osmocom/core/utils.h>
#include <osmocom/core/bits.h>
 
/* TS 101318 Chapter 5.1: 260 bits + 4bit sig */
#define GSM_FR_BYTES    33
/* TS 101318 Chapter 5.2: 112 bits, no sig */
#define GSM_HR_BYTES    14
/* TS 101318 Chapter 5.3: 244 bits + 4bit sig */
#define GSM_EFR_BYTES   31
 
/* Number of bytes of an GSM_HR RTP payload */
#define GSM_HR_BYTES_RTP_RFC5993 (GSM_HR_BYTES + 1)
#define GSM_HR_BYTES_RTP_TS101318 (GSM_HR_BYTES)
 
extern const uint16_t gsm610_bitorder[];        /* FR */
extern const uint16_t gsm620_unvoiced_bitorder[]; /* HR unvoiced */
extern const uint16_t gsm620_voiced_bitorder[];   /* HR voiced */
extern const uint16_t gsm660_bitorder[];        /* EFR */
 
extern const uint16_t gsm690_12_2_bitorder[];   /* AMR 12.2  kbits */
extern const uint16_t gsm690_10_2_bitorder[];   /* AMR 10.2  kbits */
extern const uint16_t gsm690_7_95_bitorder[];   /* AMR  7.95 kbits */
extern const uint16_t gsm690_7_4_bitorder[];    /* AMR  7.4  kbits */
extern const uint16_t gsm690_6_7_bitorder[];    /* AMR  6.7  kbits */
extern const uint16_t gsm690_5_9_bitorder[];    /* AMR  5.9  kbits */
extern const uint16_t gsm690_5_15_bitorder[];   /* AMR  5.15 kbits */
extern const uint16_t gsm690_4_75_bitorder[];   /* AMR  4.75 kbits */
 
extern const uint8_t osmo_gsm611_silence_frame[GSM_FR_BYTES];
extern const uint8_t osmo_gsm620_silence_frame[GSM_HR_BYTES];
extern const uint8_t osmo_gsm620_homing_frame[GSM_HR_BYTES];
extern const uint8_t osmo_gsm660_homing_frame[GSM_EFR_BYTES];
 
extern const struct value_string osmo_amr_type_names[];
 
enum osmo_amr_type {
       AMR_4_75 = 0,
       AMR_5_15 = 1,
       AMR_5_90 = 2,
       AMR_6_70 = 3,
       AMR_7_40 = 4,
       AMR_7_95 = 5,
       AMR_10_2 = 6,
       AMR_12_2 = 7,
       AMR_SID = 8,
       AMR_GSM_EFR_SID = 9,
       AMR_TDMA_EFR_SID = 10,
       AMR_PDC_EFR_SID = 11,
       AMR_NO_DATA = 15,
};
 
static inline const char *osmo_amr_type_name(enum osmo_amr_type type)
{ return get_value_string(osmo_amr_type_names, type); }
 
enum osmo_amr_quality {
       AMR_BAD = 0,
       AMR_GOOD = 1
};
 
extern const uint8_t gsm690_bitlength[AMR_NO_DATA+1];
 
int osmo_amr_s_to_d(ubit_t *out, const ubit_t *in, uint16_t n_bits, enum osmo_amr_type amr_mode);
int osmo_amr_d_to_s(ubit_t *out, const ubit_t *in, uint16_t n_bits, enum osmo_amr_type amr_mode);
 
static inline bool osmo_amr_is_speech(enum osmo_amr_type ft)
{
        switch (ft) {
        case AMR_4_75:
        case AMR_5_15:
        case AMR_5_90:
        case AMR_6_70:
        case AMR_7_40:
        case AMR_7_95:
        case AMR_10_2:
        case AMR_12_2:
                return true;
        default:
                return false;
        }
}
 
extern const uint8_t osmo_amr_sbits_per_mode[AMR_NO_DATA+1];
extern const uint8_t osmo_amr_params_per_mode[AMR_NO_DATA+1];
 
int osmo_amr_param_to_sbits(ubit_t *s_bits, const uint16_t *param,
                                enum osmo_amr_type mode);
int osmo_amr_sbits_to_param(uint16_t *param, const ubit_t *s_bits,
                                enum osmo_amr_type mode);
 
extern const uint16_t osmo_amr_dhf_4_75[];
extern const uint16_t osmo_amr_dhf_5_15[];
extern const uint16_t osmo_amr_dhf_5_90[];
extern const uint16_t osmo_amr_dhf_6_70[];
extern const uint16_t osmo_amr_dhf_7_40[];
extern const uint16_t osmo_amr_dhf_7_95[];
extern const uint16_t osmo_amr_dhf_10_2[];
extern const uint16_t osmo_amr_dhf_12_2[];
 
/* SID ternary classification per GSM 06.31 & 06.81 section 6.1.1 */
enum osmo_gsm631_sid_class {
       OSMO_GSM631_SID_CLASS_SPEECH  = 0,
       OSMO_GSM631_SID_CLASS_INVALID = 1,
       OSMO_GSM631_SID_CLASS_VALID   = 2,
};
 
bool osmo_fr_check_sid(const uint8_t *rtp_payload, size_t payload_len);
bool osmo_hr_check_sid(const uint8_t *rtp_payload, size_t payload_len);
bool osmo_efr_check_sid(const uint8_t *rtp_payload, size_t payload_len);
 
enum osmo_gsm631_sid_class osmo_fr_sid_classify(const uint8_t *rtp_payload);
enum osmo_gsm631_sid_class osmo_efr_sid_classify(const uint8_t *rtp_payload);
enum osmo_gsm631_sid_class osmo_hr_sid_classify(const uint8_t *rtp_payload,
                                                bool bci_flag,
                                                bool *bfi_from_bci);
 
static inline bool osmo_fr_is_any_sid(const uint8_t *rtp_payload)
{
        enum osmo_gsm631_sid_class sidc;
 
        sidc = osmo_fr_sid_classify(rtp_payload);
        return sidc != OSMO_GSM631_SID_CLASS_SPEECH;
}
 
static inline bool osmo_efr_is_any_sid(const uint8_t *rtp_payload)
{
        enum osmo_gsm631_sid_class sidc;
 
        sidc = osmo_efr_sid_classify(rtp_payload);
        return sidc != OSMO_GSM631_SID_CLASS_SPEECH;
}
 
bool osmo_fr_sid_preen(uint8_t *rtp_payload);
bool osmo_efr_sid_preen(uint8_t *rtp_payload);
 
void osmo_fr_sid_reset(uint8_t *rtp_payload);
void osmo_hr_sid_reset(uint8_t *rtp_payload);
void osmo_efr_sid_reset(uint8_t *rtp_payload);
 
int osmo_amr_rtp_enc(uint8_t *payload, uint8_t cmr, enum osmo_amr_type ft,
                     enum osmo_amr_quality bfi);
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);