aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 21793717640b98fa5ee1331b34da0905631c0bfa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
ETISnoop analyser
=================

The ETISnoop analyser decodes a RAW ETI (see https://wiki.opendigitalradio.org/Ensemble_Transport_Interface ) file and prints out
its contents in YAML for easier analysis.

It can show information about the signalling, details about the FIGs,
and extract a DAB+ subchannel into a file.

Build
-----

etisnoop is using autotools. If you do not have a release containing a ./configure script,
run ./bootstrap.sh

Install prerequisites: A C++ compiler with complete C++11 support and `libfaad-dev`

Then do

    ./configure
    make
    sudo make install
    

Usage
-----

```
etisnoop [options] [(-i|-I) filename]

   -i      the file contains RAW ETI
   -I      the file contains FIC
   -v      increase verbosity (can be given more than once)
   -d N    decode subchannel N into stream-N.dab file
           if DAB+: decode audio to stream-N.wav file and extract PAD to stream-N.dab
           (superframes with RS coding)
   -s <filename.yaml>
           statistics mode: decode all subchannels and measure audio level, write statistics to file
   -n N    stop analysing after N ETI frames
   -f      analyse FIC carousel (no YAML output)
   -r      analyse FIG rates in FIGs per second
   -R      analyse FIG rates in frames per FIG
   -w      decode CRC-DABMUX and ODR-DabMux watermark.
   -e      decode frames with SYNC error and decode FIGs with invalid CRC
   -F <type>/<ext>
           add FIG type/ext to list of FIGs to display.
           if the option is not given, all FIGs are displayed.
```

You can open the stream-N.dab file in https://www.basicmaster.de/xpadxpert/ 
(remark: in case of DAB please rename the .dab to .mp2)

Hint: subchannel N means the (N+1)th subchannel in a mux (including data subchannels!)

About
-----

This is a contribution from CSP.it, now developed by Opendigitalradio,
and is published under the terms of the GNU GPL v3 or later.
See LICENCE for more information.


Faadalyse
=========

faadalyse can extract the audio from .dabp files created with ODR-AudioEnc,
and is designed to do more in-depth analysis of the AAC encoding using a modified
libfaad.

To install:

download and extract faad2-2.7 to a folder of the same name, and configure and compile it.
You can patch that faad library to display additional information you need.
Do not run make install.

Then run

    make -f Makefile.faadalyse
    ./faadalyse