diff options
author | Matthias P. Braendli <matthias.braendli@mpb.li> | 2014-03-30 10:38:02 +0200 |
---|---|---|
committer | Matthias P. Braendli <matthias.braendli@mpb.li> | 2014-03-30 10:38:02 +0200 |
commit | 2e325d2c2a34ecda37636e67969ee1550e78fbba (patch) | |
tree | de273c4184b78f16cc9a2853f6f608293cd5cbd6 | |
parent | 77b7ee920e74d73178254a8f6d0954df6bd57ee9 (diff) | |
download | dabmux-2e325d2c2a34ecda37636e67969ee1550e78fbba.tar.gz dabmux-2e325d2c2a34ecda37636e67969ee1550e78fbba.tar.bz2 dabmux-2e325d2c2a34ecda37636e67969ee1550e78fbba.zip |
Markdownise README and INSTALL
-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/ + |