FreeCalypso > hg > gsm-codec-lib

annotate doc/PCM-file-formats @ 605:63f774192906

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
gsmhr_decoder_twts002_in(): set BFI=1 SID=1 for invalid SID When a received TW-TS-002 RTP payload indicates invalid SID, which of the 3 possible BFI/SID combinations should we pass to our internal ETSI-based speech decoder or TFO engine? Our original code passed BFI=0 SID=1, but upon further reflection, BFI=1 SID=1 is a better choice. In the corner case where received invalid SID is fed to a full decoder in homed state, setting BFI=1 allows that decoder to emit zeros on PCM and stay homed, instead of launching into full decoding.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 04 Dec 2025 21:01:46 +0000
parents a217a6eacbad
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
143
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 What file format should be used for 16-bit PCM sample recordings? The first
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 (in the order of development) group of utilities in the present package that
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 need to read and write such files are gsm[e]fr-encode and gsm[e]fr-decode,
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 designed to mirror amrnb-enc and amrnb-dec from opencore-amr FOSS package;
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 these utilities read and write WAV files and even use WAV reading and writing
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 functions copied from opencore-amrnb test code.
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 However, as I (Mother Mychaela) keep developing more tools, my use cases become
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 more diverse: in some use cases WAV is most convenient (e.g., when playing or
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 recording with SoX tools), but in other use cases a raw sample file without any
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 header is much more convenient. To address this diversity of use cases, a pair
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 of conversion utilities have been written:
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 pcm16-raw2wav converts from raw format to WAV
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 pcm16-wav2raw converts from WAV to raw format
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 Both utilities take a mandatory command line argument specifying the endian
195911f2211c document PCM format conversion utilities
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 order for the raw format - there is no default.
152
a217a6eacbad doc/PCM-file-formats: establish "robe" format
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
19
a217a6eacbad doc/PCM-file-formats: establish "robe" format
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
20 Going forward, I (Mother Mychaela) prefer big-endian format for raw PCM16 files:
a217a6eacbad doc/PCM-file-formats: establish "robe" format
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
21 aside from it being the network byte order on the Internet, 16-bit and 32-bit
a217a6eacbad doc/PCM-file-formats: establish "robe" format
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
22 numbers appear "naturally" in hex dumps in BE, but not in LE. Therefore, newly
a217a6eacbad doc/PCM-file-formats: establish "robe" format
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
23 developed utilities will read and write PCM16 data in "robe" format - "robe" is
a217a6eacbad doc/PCM-file-formats: establish "robe" format
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
24 English pronunciation play on "raw BE", and it is also the ritual garment worn
a217a6eacbad doc/PCM-file-formats: establish "robe" format
Mychaela Falconia <falcon@freecalypso.org>
parents: 143
diff changeset
25 by Themyscira telecom priestesses. :-)