annotate CHANGES @ 642:4122baa843c5 default tip

CHANGES: gsm-codec-lib-r5
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 27 Mar 2026 00:13:07 +0000
parents b66fb6be73c3
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
642
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
1 Changes from gsm-codec-lib-r4 to gsm-codec-lib-r5:
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
2
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
3 * New library named libgsmhr1 supports GSM-HR (aka HRv1) codec, completing the
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
4 set of GSM speech codecs supported by the full suite.
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
5
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
6 * All gsmhr-* utilities (plus tw5b-dump) are also new, see doc/HR-codec-utils
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
7 article.
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
8
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
9 * New utilities added for TW-TS-005 Annex C (AMR codec) hex format, see
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
10 doc/AMR-hex-utils article.
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
11
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
12 * Fixed bug in TW-TS-005 hex file reader function that failed on comment lines
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
13 of maximum spec-permitted length; this bug affected previously supported
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
14 Annex A format and newly supported Annex B and Annex C formats.
4122baa843c5 CHANGES: gsm-codec-lib-r5
Mychaela Falconia <falcon@freecalypso.org>
parents: 554
diff changeset
15
554
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
16 Changes from gsm-codec-lib-r3 to gsm-codec-lib-r4:
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
17
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
18 * Libgsmfr2 evolved from version 2.0.0 to version 2.1.0: see
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
19 doc/FR1-library-history for the details.
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
20
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
21 * Libgsmefr evolved from version 1.1.0 to version 1.2.0: see
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
22 doc/EFR-library-history for the details.
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
23
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
24 * Command line utilities support the new hexadecimal file format of TW-TS-005
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
25 Annex A for FR and EFR codecs (see doc/TW-TS-005 article):
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
26
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
27 + tw5a-dump parses TW-TS-005 Annex A files in the same way how gsmrec-dump
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
28 parses gsmx binary files;
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
29
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
30 + gsm[e]fr-decode-tw5[-r] are new speech decoder utilities that read their
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
31 input from TW-TS-005 Annex A files;
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
32
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
33 + gsmx-to-tw5a and tw5a-to-gsmx conversion utilities should be sufficient for
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
34 most other use cases.
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
35
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
36 * New command line utility gsmfr-tfo-xfrm exercises TFO transform addition to
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
37 libgsmfr2.
b66fb6be73c3 CHANGES: list those planned for inclusion in gsm-codec-lib-r4
Mychaela Falconia <falcon@freecalypso.org>
parents: 486
diff changeset
38
452
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
39 Changes from gsm-codec-lib-r2 to gsm-codec-lib-r3:
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
40
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
41 * Libgsmfrp has been replaced with libgsmfr2, a major version change per SemVer.
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
42
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
43 * The former dependency on historical libgsm has been eliminated; the
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
44 functionality of libgsm (GSM 06.10 encoder and decoder implementation) has
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
45 been absorbed into libgsmfr2.
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
46
473
2d46abdfbe91 libgsmefr version 1.1.0 for DHF addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 462
diff changeset
47 * Libgsmefr version 1.1.0 exhibits approximately 2x performance improvement
2d46abdfbe91 libgsmefr version 1.1.0 for DHF addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 462
diff changeset
48 over the original version, and also exhibits a small addition to the public
2d46abdfbe91 libgsmefr version 1.1.0 for DHF addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 462
diff changeset
49 API: the RTP-encoded form of the standard EFR DHF is now provided as a const
2d46abdfbe91 libgsmefr version 1.1.0 for DHF addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 462
diff changeset
50 datum.
452
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
51
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
52 * New library added: libtwamr for 3GPP AMR-NB codec, serving as a replacement
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
53 for libopencore-amrnb in Themyscira GSM codec exploration workflows.
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
54
484
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
55 * New command line utilities:
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
56
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
57 + amrefr-* and twamr-* related to libtwamr: see doc/Codec-utils,
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
58 doc/AMR-EFR-hybrid-emu and doc/AMR-library-tests articles.
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
59
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
60 + amrts-pcm8-compact: see doc/Utils-overview article.
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
61
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
62 + gsmfr-* updates for libgsmfr2: see doc/Codec-utils article.
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
63
20d44cfc219c CHANGES: list all new command line utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 473
diff changeset
64 + gsm[e]fr-dlcap-sync: see doc/Calypso-TCH-downlink article.
452
6e595f7d40e2 CHANGES: document changes for the upcoming release
Mychaela Falconia <falcon@freecalypso.org>
parents: 251
diff changeset
65
462
bada654a859b CHANGES: document rm of gsmfr-hand-test and gsmfr-max-out
Mychaela Falconia <falcon@freecalypso.org>
parents: 455
diff changeset
66 * gsmfr-* utilities set: gsmfr-hand-test and gsmfr-max-out hack programs have
bada654a859b CHANGES: document rm of gsmfr-hand-test and gsmfr-max-out
Mychaela Falconia <falcon@freecalypso.org>
parents: 455
diff changeset
67 been dropped. These hack programs were never properly documented and were
bada654a859b CHANGES: document rm of gsmfr-hand-test and gsmfr-max-out
Mychaela Falconia <falcon@freecalypso.org>
parents: 455
diff changeset
68 written only as part of a debug chase, in pursuit of a bug that ultimately
bada654a859b CHANGES: document rm of gsmfr-hand-test and gsmfr-max-out
Mychaela Falconia <falcon@freecalypso.org>
parents: 455
diff changeset
69 turned out to be in our then-hacky patch to osmo-bts-sysmo.
bada654a859b CHANGES: document rm of gsmfr-hand-test and gsmfr-max-out
Mychaela Falconia <falcon@freecalypso.org>
parents: 455
diff changeset
70
486
f35c8fd9ceba CHANGES: document gsmrec-dump improvements
Mychaela Falconia <falcon@freecalypso.org>
parents: 484
diff changeset
71 * gsmrec-dump now prints the bit-counting SID classification for both FRv1 and
f35c8fd9ceba CHANGES: document gsmrec-dump improvements
Mychaela Falconia <falcon@freecalypso.org>
parents: 484
diff changeset
72 EFR codecs, and also identifies bit patterns that match the official DHF
f35c8fd9ceba CHANGES: document gsmrec-dump improvements
Mychaela Falconia <falcon@freecalypso.org>
parents: 484
diff changeset
73 (decoder homing frame) for each codec.
f35c8fd9ceba CHANGES: document gsmrec-dump improvements
Mychaela Falconia <falcon@freecalypso.org>
parents: 484
diff changeset
74
455
287063b9cf43 CHANGES: document the build process change
Mychaela Falconia <falcon@freecalypso.org>
parents: 452
diff changeset
75 * The configuration and build process has been revamped: the full suite of
287063b9cf43 CHANGES: document the build process change
Mychaela Falconia <falcon@freecalypso.org>
parents: 452
diff changeset
76 libraries and utilities can now be installed in any desired file system
287063b9cf43 CHANGES: document the build process change
Mychaela Falconia <falcon@freecalypso.org>
parents: 452
diff changeset
77 location without contortions.
287063b9cf43 CHANGES: document the build process change
Mychaela Falconia <falcon@freecalypso.org>
parents: 452
diff changeset
78
251
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
79 Changes from gsm-codec-lib-r1 to gsm-codec-lib-r2:
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
81 * Libgsmfrp evolved from version 1.0.0 to version 1.0.2; please see
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
82 doc/FR1-Rx-DTX for a detailing listing of libgsmfrp changes.
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
83
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
84 * Some new utilities have been developed for studying AMR: see
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
85 doc/AMR-study-utils for more information.
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
86
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
87 * The subject of conversions between 16-bit 2's complement linear PCM and 8-bit
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
88 A-law and mu-law PCM formats (G.711) has been thoroughly studied, the findings
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
89 have been documented in doc/PCM8-conversions, and some new command line
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
90 utilities have been added, described in the same article.
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
91
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
92 * Many new table generators have been added to the dev subdirectory; some of
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
93 them may be useful to other software developers.
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
94
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
95 * pcap utilities have been split off to a separate rtp-debug-utils repository;
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
96 this split was made so that those utilities can be developed freely while the
946849291027 CHANGES: document changes since gsm-codec-lib-r1
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
97 gsm-codec-lib repository remains under strict release process control.