m (typos fixed)
Latest revision as of 10:23, 23 September 2020
The DAB encoder is derived from libtoolame-dab. toolame-02l has been converted to a shared library libtoolame-dab.
The DAB+ encoder is using the fdk-aac library the Fraunhofer FDK AAC code from Android, patched for 960-transform and proper header and firecode.
The main tool is odr-audioenc, which can encode from a file or pipe source, all inputs supported by libVLC or an ALSA soundcard, and encode to a ZeroMQ output compatible with ODR-DabMux, to a file or to standard output. The VLC ALSA input supports experimental sound card clock drift compensation, that can compensate for imprecise sound card clocks.
DAB MOT Slideshow and DLS support is possible thanks to ODR-PadEnc.
ODR-AudioEnc v2 and earlier are compatible with ODR-PadEnc v2. ODR-AudioEnc v3 is compatible with ODR-PadEnc v3.
For detailed usage, see the usage screen of the different tools.
Its development is public : http://github.com/Opendigitalradio/ODR-AudioEnc and releases are available as git tags. The git master branch always points to the latest release, the next branch is where development happens.
The ODR-AudioEnc package depends on libfec, boost-thread, boost-system, alsa and ZeroMQ. For instructions on how to install these, please see ODR-DabMux#Prerequisites
The mot-encoder optionally needs ImageMagick's magick_wand to be able to resize pictures.
Several usage scenarios are shown in https://github.com/Opendigitalradio/ODR-AudioEnc#how-to-use
 Problem solving
In the case you are using ZeroMQ between the encoder and odr-dabmux, and you see errors that the size of the data is wrong, then the configured bitrate in the mux probably doesn't correspond to the bitrate given to the encoder. Make sure they are identical.
If you are using a pipe between the encoder and odr-dabmux, and you see a lot of errors like this:
<2> ERROR: Incomplete DAB+ frame! 136 != 360 <5> reach end of file -> rewinding <2> ERROR: Can't rewind file <6> ETI frame number: 228
Then the stream has to be buffered before giving it to muxer, this additional buffer installed between encoder and fifo. To calculate proper block size for mbuffer ("-s" parameter), the table below may be used:
|DAB+ Stream bitrate, kbps||Block size, bytes|
In example above, for stream with bitrate 24 kbps, mbuffer size set to 360 bytes. This trick helping to solve problem.
 Historical notes
v3.0.0 is a breaking change because the communication with ODR-PadEnc was replaced by a socket.
The encoders were renamed at version 0.2.0. The aac-enc testing program disappeared, but its code is still in src/. The aac-enc-dabplus and aac-enc-dabplus-zmq were renamed to dabplus-enc-file and dabplus-enc-file-zmq. dabplus-enc-alsa-zmq appeared in v0.2.0.
In v0.2.2, dabplus-enc-file-zmq received support for output to file and pipe, making dabplus-enc-file obsolete, which has therefore been removed.
In v0.4.0, lots of code redundancy between different encoder variants has been merged into dabplus-enc. The old tools dabplus-enc-file-zmq, dabplus-enc-alsa-zmq and all this has been replaced by a single encoder.
Some of the encode- scripts available in the mmbtools-aux repository might still make use of the old names.
In September 2016, FDK-AAC-DABplus was split in three: ODR-AudioEnc, fdk-aac and ODR-PadEnc, for ease of maintainability and packaging, to clarify the licence situation a bit, and in the hope that the DAB+ modification to fdk-aac could be given upstream.