annotate doc/Utils-overview @ 484:20d44cfc219c

CHANGES: list all new command line utils
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 20 May 2024 01:42:38 +0000
parents 4f13db3a7086
children d9f6b3125259
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
483
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
9 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
10 amrefr-encode-r
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
11 amrefr-tseq-dec
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
12 amrefr-tseq-enc
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
13
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
14 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
15 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
16 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
17 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
18 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
19 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
20 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
21 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
22 per sample.
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
23
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 gsm-amr2efr See AMR-EFR-conversion article.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 gsm-efr2amr
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 gsmefr-cod-parse See EFR-testing article.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 gsmefr-dec-parse
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29
240
3aeb33d835ad doc/Utils-overview: document gsmefr-cod2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 238
diff changeset
30 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
31 *.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
32
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 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
34 gsmefr-decode-r
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 gsmefr-encode
157
04936af99fc8 document gsm[e]fr-{en,de}code-r utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
36 gsmefr-encode-r
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37
169
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
38 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
39 gsmefr-dlcap-gsmx
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
40 gsmefr-dlcap-parse
483
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
41 gsmefr-dlcap-sync
169
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
42
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 gsmefr-etsi-dec See EFR-testing article.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 gsmefr-etsi-enc
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 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
47 format and converts it into ETSI decoder input (.dec)
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48 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
49 check, to verify that the format of TCH uplink from
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 sysmoBTS in EFR mode matches our expectations, before
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51 embarking on the labor-intensive project to librify EFR
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52 reference code from ETSI.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53
246
a55fcc8b6daf doc/Utils-overview: add gsmfr-cod2std
Mychaela Falconia <falcon@freecalypso.org>
parents: 240
diff changeset
54 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
55 *.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
56
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
57 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
58 gsmfr-decode-r
306
047c198408c8 doc/Utils-overview: update for libgsmfr2
Mychaela Falconia <falcon@freecalypso.org>
parents: 246
diff changeset
59 gsmfr-decode-rb
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
60 gsmfr-encode
157
04936af99fc8 document gsm[e]fr-{en,de}code-r utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
61 gsmfr-encode-r
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
62
169
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
63 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
64 gsmfr-dlcap-parse
483
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
65 gsmfr-dlcap-sync
169
0c965c3c5e6e doc/Utils-overview: new Calypso TCH DL utils
Mychaela Falconia <falcon@freecalypso.org>
parents: 157
diff changeset
66
306
047c198408c8 doc/Utils-overview: update for libgsmfr2
Mychaela Falconia <falcon@freecalypso.org>
parents: 246
diff changeset
67 gsmfr-preproc See FR1-Rx-DTX article.
136
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
68
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
69 gsmrec-dump See Binary-file-format article.
8eb0e7a39409 doc: document command line utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
70
238
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
71 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
72 (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
73 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
74 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
75 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
76 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
77 - 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
78 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
79
143
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 136
diff changeset
80 pcm16-raw2wav See PCM-file-formats article.
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 136
diff changeset
81 pcm16-wav2raw
238
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
82
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
83 pcm16-to-alaw See PCM8-conversions article.
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
84 pcm16-to-ulaw
de1b52304d26 doc/Utils-overview: add new PCM utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 218
diff changeset
85 pcm8-to-pcm16
483
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
86
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
87 twamr-decode See Codec-utils article.
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
88 twamr-decode-r
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
89 twamr-encode
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
90 twamr-encode-r
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
91
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
92 twamr-tseq-dec See AMR-library-tests article.
4f13db3a7086 doc/Utils-overview: document new utilities
Mychaela Falconia <falcon@freecalypso.org>
parents: 306
diff changeset
93 twamr-tseq-enc