FreeCalypso > hg > gsm-codec-lib

annotate doc/Utils-overview @ 592:24aba0e7aa35

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
document AMR hex (TW-TS-005 Annex C) utilities addition
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 07 Nov 2025 00:41:56 +0000
parents 8f44d7064c56
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 Here is the complete list of all command line utilities included in the present
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 package:
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
218
f4f68c652e98 doc: document AMR study utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 209
diff changeset
4 amr-cod-parse See AMR-study-utils article.
f4f68c652e98 doc: document AMR study utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 209
diff changeset
5 amr-ietf-parse
f4f68c652e98 doc: document AMR study utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 209
diff changeset
6 amr-cod2ietf
f4f68c652e98 doc: document AMR study utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 209
diff changeset
7 amr-ietf2cod
f4f68c652e98 doc: document AMR study utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 209
diff changeset
8
592
24aba0e7aa35 document AMR hex (TW-TS-005 Annex C) utilities addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
9 amr-hex-bwe2oa See AMR-hex-utils article.
24aba0e7aa35 document AMR hex (TW-TS-005 Annex C) utilities addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
10 amr-hex-oa2bwe
24aba0e7aa35 document AMR hex (TW-TS-005 Annex C) utilities addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
11 amr-hexoa2ietf
24aba0e7aa35 document AMR hex (TW-TS-005 Annex C) utilities addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
12 amr-ietf2hexoa
24aba0e7aa35 document AMR hex (TW-TS-005 Annex C) utilities addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
13
483
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
14 amrefr-decode-r See AMR-EFR-hybrid-emu article.
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
15 amrefr-encode-r
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
16 amrefr-tseq-dec
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
17 amrefr-tseq-enc
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
18
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
19 amrts-pcm8-compact The set of AMR test sequences shipped by 3GPP as
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
20 TS 26.074 includes not only linear PCM and AMR-encoded
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
21 files, but also 8-bit PCM sequences in both A-law and
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
22 mu-law. However, those PCM8 sequences are shipped in a
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
23 stupid and inconvenient format: each 8-bit PCM sample
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
24 is expanded to a 16-bit word, written in LE byte order.
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
25 This utility converts a PCM8 test sequence file from
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
26 this weird format into sane PCM8 format with one byte
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
27 per sample.
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
28
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 gsm-amr2efr See AMR-EFR-conversion article.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 gsm-efr2amr
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 gsmefr-cod-parse See EFR-testing article.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 gsmefr-dec-parse
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34
240
3aeb33d835ad doc/Utils-overview: document gsmefr-cod2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 238
diff changeset
35 gsmefr-cod2gsmx This program reads an EFR codec frame stream in ETSI
3aeb33d835ad doc/Utils-overview: document gsmefr-cod2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 238
diff changeset
36 *.cod format and converts it to Themyscira gsmx format.
3aeb33d835ad doc/Utils-overview: document gsmefr-cod2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 238
diff changeset
37
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 gsmefr-decode See Codec-utils article.
157
04936af99fc8 document gsm[e]fr-{en,de}code-r utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
39 gsmefr-decode-r
550
de333989a12b document gsm[e]fr-decode-tw5[-r] utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 549
diff changeset
40 gsmefr-decode-tw5
de333989a12b document gsm[e]fr-decode-tw5[-r] utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 549
diff changeset
41 gsmefr-decode-tw5-r
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 gsmefr-encode
157
04936af99fc8 document gsm[e]fr-{en,de}code-r utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
43 gsmefr-encode-r
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44
169
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
45 gsmefr-dlcap-dec See Calypso-TCH-downlink article.
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
46 gsmefr-dlcap-gsmx
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
47 gsmefr-dlcap-parse
483
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
48 gsmefr-dlcap-sync
169
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
49
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 gsmefr-etsi-dec See EFR-testing article.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51 gsmefr-etsi-enc
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53 gsmefr-rec2etsi This program reads an EFR session recording in gsmx
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 format and converts it into ETSI decoder input (.dec)
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
55 format. It was written early in the project as a sanity
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56 check, to verify that the format of TCH uplink from
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
57 sysmoBTS in EFR mode matches our expectations, before
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
58 embarking on the labor-intensive project to librify EFR
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
59 reference code from ETSI.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
60
246
a55fcc8b6daf doc/Utils-overview: add gsmfr-cod2std
Mychaela Falconia <falcon@freecalypso.org>
parents: 240
diff changeset
61 gsmfr-cod2std This program reads an FR codec frame stream in ETSI
a55fcc8b6daf doc/Utils-overview: add gsmfr-cod2std
Mychaela Falconia <falcon@freecalypso.org>
parents: 240
diff changeset
62 *.cod format and converts it to "standard" *.gsm format.
a55fcc8b6daf doc/Utils-overview: add gsmfr-cod2std
Mychaela Falconia <falcon@freecalypso.org>
parents: 240
diff changeset
63
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
64 gsmfr-decode See Codec-utils article.
157
04936af99fc8 document gsm[e]fr-{en,de}code-r utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
65 gsmfr-decode-r
306
047c198408c8 doc/Utils-overview: update for libgsmfr2
Mychaela Falconia <falcon@freecalypso.org>
parents: 246
diff changeset
66 gsmfr-decode-rb
550
de333989a12b document gsm[e]fr-decode-tw5[-r] utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 549
diff changeset
67 gsmfr-decode-tw5
de333989a12b document gsm[e]fr-decode-tw5[-r] utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 549
diff changeset
68 gsmfr-decode-tw5-r
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
69 gsmfr-encode
157
04936af99fc8 document gsm[e]fr-{en,de}code-r utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
70 gsmfr-encode-r
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
71
169
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
72 gsmfr-dlcap-gsmx See Calypso-TCH-downlink article.
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
73 gsmfr-dlcap-parse
483
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
74 gsmfr-dlcap-sync
169
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
75
306
047c198408c8 doc/Utils-overview: update for libgsmfr2
Mychaela Falconia <falcon@freecalypso.org>
parents: 246
diff changeset
76 gsmfr-preproc See FR1-Rx-DTX article.
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
77
551
8f44d7064c56 document gsmfr-tfo-xfrm
Mychaela Falconia <falcon@freecalypso.org>
parents: 550
diff changeset
78 gsmfr-tfo-xfrm See TFO-transform article.
8f44d7064c56 document gsmfr-tfo-xfrm
Mychaela Falconia <falcon@freecalypso.org>
parents: 550
diff changeset
79
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
80 gsmrec-dump See Binary-file-format article.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
81
549
d9f6b3125259 document TW-TS-005 utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 483
diff changeset
82 gsmx-to-tw5a See TW-TS-005 article.
d9f6b3125259 document TW-TS-005 utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 483
diff changeset
83
238
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
84 pcm16-check13 This program reads a 16-bit linear PCM recording file
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
85 (raw BE by default, or raw LE with -l option) and checks
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
86 if the 3 least significant bits of every sample are all
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
87 zeros. All linear PCM samples consumed or generated by
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
88 GSM codecs are only 13 bits wide, left-justified in
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
89 16-bit words, and so is output from G.711 A-law decoding
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
90 - thus it is useful to be able to check if a given file
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
91 in 16-bit PCM format is purely 13-bit or not.
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
92
143
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 136
diff changeset
93 pcm16-raw2wav See PCM-file-formats article.
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 136
diff changeset
94 pcm16-wav2raw
238
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
95
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
96 pcm16-to-alaw See PCM8-conversions article.
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
97 pcm16-to-ulaw
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
98 pcm8-to-pcm16
483
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
99
549
d9f6b3125259 document TW-TS-005 utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 483
diff changeset
100 tw5a-dump See TW-TS-005 article.
d9f6b3125259 document TW-TS-005 utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 483
diff changeset
101 tw5a-to-gsmx
d9f6b3125259 document TW-TS-005 utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 483
diff changeset
102
483
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
103 twamr-decode See Codec-utils article.
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
104 twamr-decode-r
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
105 twamr-encode
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
106 twamr-encode-r
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
107
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
108 twamr-tseq-dec See AMR-library-tests article.
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
109 twamr-tseq-enc