annotate doc/Voice-memo-utils @ 1014:961efadd530a default tip

fc-shell TCH DL handler: add support for CSD modes TCH DL capture mechanism in FC Tourmaline firmware has been extended to support CSD modes in addition to speech - add the necessary support on the host tools side. It needs to be noted that this mechanism in its present state does NOT provide the debug utility value that was sought: as we learned only after the code was implemented, TI's DSP has a misfeature in that the buffer we are reading (a_dd_0[]) is zeroed out when the IDS block is enabled, i.e., we are reading all zeros and not the real DL bits we were after. But since the code has already been written, we are keeping it - perhaps we can do some tests with IDS disabled.
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 26 Nov 2024 06:27:43 +0000
parents 1e9fe07f8f09
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
909
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 The full Calypso hw+fw solution as delivered by TI (the relevant components here
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 are the DSP, the official L1 code and RiViera Audio Service) implements an
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 interesting feature called voice memos. The voice memo feature itself, plus
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 FreeCalypso-added AT commands that exercise it, are described in the
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 Voice-memo-feature article in our separate freecalypso-docs repository; the
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 present document describes the available FC host tools utilities for working
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 with these voice memo recordings.
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 FreeCalypso tools for decoding voice memo files
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 ===============================================
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 If you have recorded a voice memo with AT@VMR and then read it out with fc-fsio,
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 you can use additional FC tools to analyze it. The following tools are
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 available, split between FC host tools and GSM codec libs & utilities packages:
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 * fc-vm2gsmx (new with fc-host-tools-r18) takes a binary VM recording (as you
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 would read out with fc-fsio) and converts it into extended-libgsm (gsmx)
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 format defined in our GSM codec libraries & utilities package. This gsmx
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 format is an extension of the classic libgsm (GSM 06.10) format, adding the
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 possibility of SID frames and BFI markers (frame gaps) in addition to regular
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 speech frames, thus it can represent the content of a voice memo recording
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 made in DTX mode. These gsmx files can then be decoded into playable WAV
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 with our gsmfr-decode utility.
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 * fc-vm2hex (dates back to fc-host-tools-r5) converts a binary VM recording into
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 ASCII hex format, similar to the old (2016) TCH DL recording format before it
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 was extended in late 2022. Every fully-written frame is emitted in the hex
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 output as 3 space-separated hex status words followed by a block of 66 hex
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 digits giving the FR1 codec frame in the unchanged bit order of TI's DSP, and
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 every skipped frame (one for which only status word 0 was written into the
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 memo file) is emitted in the hex output as just that one word. The hex output
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 from fc-vm2hex can be further fed to gsmfr-dlcap-parse utility (gsm-codec-lib
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 package) for deeper analysis.
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 FreeCalypso tools for external generation of voice memo files
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 =============================================================
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38 Using FreeCalypso tools, you can produce an external speech recording in GSM
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 06.10 FR1 codec format, convert it into TCS211 VM format, upload it into FC
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 device FFS with fc-fsio, and then play these externally-produced voice memos
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 with AT@VMP. The steps are as follows:
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 1) You can use gsmfr-encode to FR1-encode a speech sample from WAV into classic
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 .gsm format, or gsmfr-encode-r if the source is raw BE instead of WAV.
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 Alternatively, you can use any other off-the-shelf software that can encode
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 FR1 and write libgsm format; SoX shipped with Slackware includes the
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
47 necessary support.
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
49 2) fc-gsm2vm (unchanged since fc-host-tools-r5) converts a .gsm recording into
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
50 non-DTX TCS211 VM format.
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
51
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
52 At the present time we don't have any tools for producing external DTX-enabled
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
53 VM recordings: the main limitation is that at least to this Mother's knowledge,
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
54 the published source software community does not currently possess a GSM 06.10
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
55 encoding library that has been extended with VAD and DTX functions. There is
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56 classic libgsm from 1990s, used by everyone in the FOSS community who needs a
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
57 GSM 06.10 encoder or decoder, but it doesn't do DTX; we (FreeCalypso and
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
58 Themyscira Wireless) have produced our own libgsmfrp front-end that implements
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
59 Rx DTX handler functions (that's how we can properly decode FR1 streams that
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
60 contain SIDs and/or missing frames), but it doesn't help with DTX encoding.
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
61 Therefore, our ability to produce TCS211-compatible VM recordings externally is
1e9fe07f8f09 doc/Voice-memo-utils: new article
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
62 currently limited to non-DTX mode.