diff options
| -rw-r--r-- | INSTALL.md (renamed from INSTALL) | 35 | ||||
| -rw-r--r-- | Makefile.am | 5 | ||||
| -rw-r--r-- | README | 44 | ||||
| -rw-r--r-- | README.md | 52 | 
4 files changed, 78 insertions, 58 deletions
| @@ -1,15 +1,19 @@  Required dependencies:  ====================== -    * libfec from Phil Karn, with compatibility patch: -        https://github.com/Opendigitalradio/ka9q-fec -    * Boost 1.48 or later -    * Optional ZeroMQ 4 from http://www.zeromq.org -        Use --disable-output-zeromq if you don't have it +* libfec from Phil Karn, with compatibility patch: +[ka9q-fec](https://github.com/Opendigitalradio/ka9q-fec) +* Boost 1.48 or later +* Optional ZeroMQ 4 from [http://www.zeromq.org](http://www.zeromq.org) + +Use the --disable-output-zeromq ./configure option if you don't have ZeroMQ.  Simple install procedure using tarball release:  =============================================== +Install libfec +-------------- +      % git clone https://github.com/Opendigitalradio/ka9q-fec.git      % cd ka9q-fec      % ./configure                           # Run the configure script @@ -17,7 +21,9 @@ Simple install procedure using tarball release:      [as root]      % make install                          # Install the library -        # install zeromq 4.0.3 +Install zeromq 4.0.3 +-------------------- +      % wget http://download.zeromq.org/zeromq-4.0.3.tar.gz      % tar -f zeromq-4.0.3.tar.gz -x      % cd zeromq-4.0.3 @@ -26,6 +32,9 @@ Simple install procedure using tarball release:      [as root]      % make install +Install odr-dabmux +------------------ +      % tar xjf odr-dabmux-x.y.z.tar.bz2      # Unpack the source      % cd odr-dabmux-x.y.z                   # Change to the source directory      % ./configure --enable-input-zeromq --enable-output-zeromq @@ -41,11 +50,10 @@ The code in the repository is more recent than the latest  release and could be less stable, but already have new  features. -    * Download and install fec as above -    * Clone the git repository -    * Bootstrap autotools: -    % ./bootstrap.sh -    * Then use ./configure as above +* Download and install fec as above +* Clone the git repository +* Bootstrap autotools: <pre>% ./bootstrap.sh</pre> +* Then use ./configure as above  Advanced install procedure: @@ -53,13 +61,14 @@ Advanced install procedure:  The configure script can be launch with a variety of options, launch the  following command for a complete list: +      % ./configure --help  Notes about libfec  ==================  The original libfec version from -    http://www.ka9q.net/code/fec/fec-3.0.1.tar.bz2 -does not compile on x86_64 nor on ARM. That is the reason why the patched +[ka9q.net](http://www.ka9q.net/code/fec/fec-3.0.1.tar.bz2) +does not compile on x86\_64 nor on ARM. That is the reason why the patched  version is suggested.  On x86 systems, the original version can also be used. diff --git a/Makefile.am b/Makefile.am index 6e9e392..b1578f9 100644 --- a/Makefile.am +++ b/Makefile.am @@ -1,5 +1,8 @@  # Copyright (C) 2008, 2009 Her Majesty the Queen in Right of Canada  # (Communications Research Center Canada) +# +# Copyright (C) 2014 Matthias P. Braendli +# http://opendigitalradio.org  # This file is part of ODR-DabMux.  #  @@ -20,5 +23,5 @@ SUBDIRS	=src lib  ACLOCAL_AMFLAGS = -I m4 -EXTRA_DIST	=COPYING NEWS README AUTHORS ChangeLog TODO doc +EXTRA_DIST	=COPYING NEWS README.md INSTALL.md LICENCE AUTHORS ChangeLog TODO doc @@ -1,44 +0,0 @@ -OVERVIEW -======== -ODR-DabMux is a fork of CRC-DabMux, which was developed by the Communications -Research Center Canada. It has been forked by the Opendigitalradio project. - -ODR-DabMux is a DAB (Digital Audio Broadcasting) multiplexer compliant to -ETSI EN 300 401. - -In addition to the features of CRC-DabMux, this fork contains: -- configuration file support, see doc/example.mux -- timestamping support required for SFN -- a ZeroMQ ETI output that can be used with ODR-DABMOD -- a ZeroMQ dabplus input that can be used with fdk-aac-dabplus-zmq -  and toolame-dab -- supports logging to syslog -- supports ZMQ input monitoring with munin tool -- supports a Telnet Remote Control for setting/getting parameters -  (can change subchannel and component labels, and ZMQ input buffer -   parameters) - -The src/ directory contains the source code of ODR-DabMux. - -The doc/ directory contains the ODR-DabMux documentation, and an example -configuration file. - -The lib/ directory contains source code of libraries needed to build -ODR-DabMux. - -INSTALL -======= -See the INSTALL file for installation instructions. - -LICENCE -======= -See the files LICENCE and COPYING - -CONTACT -======= -Matthias P. Braendli <matthias [at] mpb [dot] li> -Pascal Charest <pascal [dot] charest [at] crc [dot] ca> - -http://opendigitalradio.org/ -http://mmbtools.crc.ca/ -http://mpb.li/ diff --git a/README.md b/README.md new file mode 100644 index 0000000..8a2deef --- /dev/null +++ b/README.md @@ -0,0 +1,52 @@ +Overview +======== + +*ODR-DabMux* is a fork of CRC-DabMux, which was developed by the Communications +Research Center Canada. It has been forked by the +[Opendigitalradio project](http://opendigitalradio.org). + +ODR-DabMux is a *DAB (Digital Audio Broadcasting) multiplexer* compliant to +ETSI EN 300 401. + +In addition to the features of CRC-DabMux, this fork contains: + +- configuration file support, see doc/example.mux +- timestamping support required for SFN +- a ZeroMQ ETI output that can be used with ODR-DabMod +- a ZeroMQ dabplus input that can be used with fdk-aac-dabplus +  and toolame-dab +- supports logging to syslog +- supports ZMQ input monitoring with munin tool +- includes a Telnet Remote Control for setting/getting parameters +  (can change subchannel and component labels, and ZMQ input buffer +   parameters) + +The src/ directory contains the source code of ODR-DabMux. + +The doc/ directory contains the ODR-DabMux documentation, and an example +configuration file. + +The lib/ directory contains source code of libraries needed to build +ODR-DabMux. + +Install +======= + +See the INSTALL.md file for installation instructions. + +Licence +======= + +See the files LICENCE and COPYING + +Contact +======= + +Matthias P. Braendli *matthias [at] mpb [dot] li* + +Pascal Charest *pascal [dot] charest [at] crc [dot] ca* + +- http://opendigitalradio.org/ +- http://mmbtools.crc.ca/ +- http://mpb.li/ + | 
