aboutsummaryrefslogtreecommitdiffstats
path: root/include/osmocom/gapk/codecs.h
blob: 253fb14a928e48f98ba5491fb240a89f3df1d068 (plain)
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
/* Codecs handling */

/*
 * This file is part of gapk (GSM Audio Pocket Knife).
 *
 * gapk is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * gapk is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with gapk.  If not, see <http://www.gnu.org/licenses/>.
 */

#pragma once

#include <stdint.h>

#define FR_CANON_LEN	33
#define HR_CANON_LEN	14
#define EFR_CANON_LEN	31
#define PCM_CANON_LEN	(160*sizeof(uint16_t))
#define HR_REF_ENC_LEN  (20 * sizeof(uint16_t))
#define HR_REF_DEC_LEN  (22 * sizeof(uint16_t))

enum osmo_gapk_codec_type {
	CODEC_INVALID = 0,
	CODEC_PCM,	/* 16 bits PCM samples */
	CODEC_HR,	/* GSM Half Rate codec GSM 06.20 */
	CODEC_FR,	/* GSM Full Rate codec GSM 06.10 */
	CODEC_EFR,	/* GSM Enhanced Full Rate codec GSM 06.60 */
	CODEC_AMR,	/* GSM Adaptive Multi Rate codec GSM 26.071 */
	_CODEC_MAX,
};

/* Need to import here because of enum interdep */
#include <osmocom/gapk/formats.h>

/*! call-back for actual codec conversion function
 *  \param[in] state opaque state pointer (returned by codec->init)
 *  \param[out] dst caller-allocated buffer for output data
 *  \param[in] src input data
 *  \param[in] src_len length of input data \a src
 *  \returns number of output bytes written to \a dst; negative on error */
typedef int (*osmo_gapk_codec_conv_cb_t)(void *state, uint8_t *dst,
	const uint8_t *src, unsigned int src_len);

struct osmo_gapk_codec_desc {
	enum osmo_gapk_codec_type type;
	const char *description;
	const char *name;

	/*!
	 * Canonical frame size (in bytes);
	 * 0 in case of variable length
	 */
	unsigned int canon_frame_len;

	/*! What the encoder provides */
	enum osmo_gapk_format_type codec_enc_format_type;
	/*! What to give the decoder */
	enum osmo_gapk_format_type codec_dec_format_type;

	/* (De)initialization function pointers */
	void *(*codec_init)(void);
	void  (*codec_exit)(void *state);

	/* Encoding / decoding function pointers */
	osmo_gapk_codec_conv_cb_t codec_encode;
	osmo_gapk_codec_conv_cb_t codec_decode;
};

const struct osmo_gapk_codec_desc *
osmo_gapk_codec_get_from_type(enum osmo_gapk_codec_type type);