FreeCalypso > hg > gsm-codec-lib

annotate README @ 640:e0e5905261e2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
document tw5b-dump and tw5c-dump
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 20 Mar 2026 06:43:50 +0000
parents d71ef85036e4
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
206
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
1 Themyscira Wireless GSM codec libraries & utilities package
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
2 ===========================================================
0
b45bb0f9bdfc README: indicate purpose and scope of this repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
206
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
4 Themyscira Wireless, a technical initiative of the Women's Republic of
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
5 Themyscira, is proud to present this package of GSM codec libraries and
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
6 associated command line test and development utilities. The present package
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
7 provides the following linkable C libraries, intended to be usable by any
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
8 application that needs GSM codec functionality:
0
b45bb0f9bdfc README: indicate purpose and scope of this repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
10 libgsmfr2 This library implements the original GSM-FR codec, consisting
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
11 of not only the basic transcoding functions of GSM 06.10, but
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
12 also all Rx DTX handler functions that are required for a speech
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
13 decoder receiving a stream of frames from a radio interface,
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
14 either MS or network side. This library is a replacement for
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
15 classic libgsm, providing proper reset logic, homing functions
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
16 and the Rx DTX handler block.
206
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
17
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
18 libgsmefr This library implements GSM-EFR codec, based on the reference
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
19 code from ETSI (GSM 06.53). The bit-exact version of GSM-EFR
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
20 implemented here is the original one, not the AMR-EFR hybrid
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
21 that was made into a permissible implementation option after
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
22 the development of AMR.
206
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
23
637
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
24 libgsmhr1 This library implements GSM-HR codec, based on the reference
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
25 code from ETSI (GSM 06.06). In addition to standard speech
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
26 encoder and decoder functions, our library includes many
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
27 supporting utility functions and a TFO transform implementation.
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
28
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
29 libtwamr This library implements 3GPP AMR-NB codec, based on the official
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
30 reference code (TS 26.073). Both VAD versions are included,
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
31 selected by the user application at run time, and I/O functions
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
32 are provided for both 3GPP test sequence format and the more
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
33 practical format of IETF RFC 4867. This library can also be
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
34 used to implement AMR-EFR hybrid operation if no DTX is needed
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
35 in the encoder and if the input to the decoder contains no SID
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
36 frames.
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
37
637
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
38 The libraries provided here are intended for multiple purposes - here are some
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
39 of them:
0
b45bb0f9bdfc README: indicate purpose and scope of this repository
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40
637
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
41 * They are used as part of Themyscira Wireless MGW (media gateway)
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
42 implementation, providing the necessary speech transcoder between a GSM
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
43 network and G.711-based PSTN.
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
44
637
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
45 * TFO transforms implemented in these libraries are needed in order to make a
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
46 proper interface from an incoming RTP stream to an Abis-DL link driving a
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
47 traditional E1 BTS.
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
48
637
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
49 * They are useful in many varied study and exploration workings, as part of
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
50 experiments where it becomes necessary to model, simulate or replicate
d71ef85036e4 README: add libgsmhr1
Mychaela Falconia <falcon@freecalypso.org>
parents: 451
diff changeset
51 bit-exact operation of someone else's network element.
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
52
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
53 Each of our Themyscira core libraries is free-standing and independent of the
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
54 others. The dependency on classic libgsm (by way of <gsm.h> header file) that
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
55 existed in previous versions of Themyscira gsm-codec-lib suite has been
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
56 eliminated; the present version has zero dependencies.
206
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
57
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
58 Included command line utilities
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
59 ===============================
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
60
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
61 In addition to the set of core libraries, the present package includes a number
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
62 of command line utilities, falling into the following groups:
206
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
63
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
64 * Some utilities specifically exercise and test our core libraries;
206
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
65
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
66 * Some utilities are not specifically for library testing but make use of
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
67 these libraries;
206
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
68
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
69 * Some utilities are included because they implement some closely related and
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
70 relevant debug and development functionality, even though they don't link
451
614ae8dc6807 README: update for libgsmfr2+libgsmefr+libtwamr set
Mychaela Falconia <falcon@freecalypso.org>
parents: 206
diff changeset
71 with any of the included core libraries.
206
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
72
1b8cb3490d48 README: update for work approaching release
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
73 Please see the included documentation in the doc subdirectory.