comparison doc/Codec-utils @ 550:de333989a12b

document gsm[e]fr-decode-tw5[-r] utilities
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 05 Oct 2024 02:16:48 +0000
parents 751f06541fbb
children
comparison
equal deleted inserted replaced
549:d9f6b3125259 550:de333989a12b
64 * There is a new utility named gsmfr-decode-rb, where rb stands for "raw basic". 64 * There is a new utility named gsmfr-decode-rb, where rb stands for "raw basic".
65 This utility emits "robe" output like gsmfr-decode-r, but it performs only 65 This utility emits "robe" output like gsmfr-decode-r, but it performs only
66 "basic" GSM 06.10 decoding, without the Rx DTX preprocessor step. BFI frame 66 "basic" GSM 06.10 decoding, without the Rx DTX preprocessor step. BFI frame
67 gaps in input are not allowed, and there is no SID or DHF detection. 67 gaps in input are not allowed, and there is no SID or DHF detection.
68 68
69 Additions for TW-TS-005
70 =======================
71
72 All of the speech decoder utilities described above read FR or EFR compressed
73 speech in gsmx binary file format. However, we now also have a newer
74 hexadecimal file format defined in Themyscira Wireless Technical Specification
75 TW-TS-005 - see TW-TS-005 article. TW-TS-005 Annex A is the application of
76 this hex format to FR and EFR codecs. Here are our updated speech decoder
77 utilities that read TW-TS-005 Annex A file format:
78
79 Original utility, reads gsmx New utility, reads TW-TS-005 Annex A
80 --------------------------------------------------------------------
81 gsmfr-decode gsmfr-decode-tw5
82 gsmfr-decode-r gsmfr-decode-tw5-r
83 gsmefr-decode gsmefr-decode-tw5
84 gsmefr-decode-r gsmefr-decode-tw5-r
85
86 There are no changes to speech encoder utilities: generating gsmx and then
87 converting it to TW-TS-005 with gsmx-to-tw5a is a perfectly good workflow.
88
69 Standalone command line utilities for AMR codec 89 Standalone command line utilities for AMR codec
70 =============================================== 90 ===============================================
71 91
72 As described above, gsm[e]fr-encode and gsm[e]fr-decode were modeled after 92 As described above, gsm[e]fr-encode and gsm[e]fr-decode were modeled after
73 amrnb-enc and amrnb-dec from opencore-amr, a piece of pre-existing FOSS. 93 amrnb-enc and amrnb-dec from opencore-amr, a piece of pre-existing FOSS.