annotate doc/FR-EFR-formats @ 4:5216e7fb1c9e

doc: update for new FR/EFR RTP payload formats
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 16 Apr 2023 07:55:21 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 The two RTP analysis utilities rtp-gsmfr-dump and rtp-gsmfr-extr support the
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 following RTP payload formats for FR/EFR codec frames and BFI markers:
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 * Standard RFC 3551 (same as TS 101 318) format for good frames
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 * TRAUlike RTP payload format defined here:
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 https://www.freecalypso.org/hg/themwi-system-sw/file/tip/doc/RTP-TRAUlike-format
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 * Old BFI marker format defined here:
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 https://www.freecalypso.org/hg/themwi-system-sw/file/tip/doc/RTP-BFI-extension
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 * Zero-length RTP payload serving as a BFI marker
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 All of these formats are distinguished by rtp-gsmfr-dump in its human-oriented
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 dump output, but not all of them can be represented losslessly in the gsmx
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 binary file format defined in our Themyscira Wireless GSM codec libraries and
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 utilities package. The latter on-disk file format requires plain RFC 3551
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 format for good frames and the old Themyscira 2-byte BFI marker format for bad
5216e7fb1c9e doc: update for new FR/EFR RTP payload formats
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 frames; rtp-gsmfr-extr converts everything into this fixed format.