FreeCalypso > hg > freecalypso-tools
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 |
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. |