Update README.md

add more description of this software

README.md

@@ -1,21 +1,21 @@
 eti-tools
 =========
 
-ETI conversion software
+This is ETI conversion software. The main purpose of this apps - is to convert/manupulate ETI-NA/ETI-NI streams UNIX-way (by using pipelines). With this software you can create your own IceCast2 internet-radio server, which will use your local DAB/DAB+ transmitter as source of the stations streams. You also can re-multiplex some (needed) stations from one ETI-stream to another by using ZeroMQ feature of the ni2http application and ODR-DabMUX. This software also able to receive and convert specially formatted satellite DAB streams to regular DAB-NI, which can be used to feed modulator software/hardware or to create internet-station from that source.
 
 Additional libraries are needed:
-* [libfec](http://mmbtools.crc.ca/content/view/39/65/) - for Reed-Solomon FEC, may be enabled/disabled.
-* [libshout](http://www.icecast.org/download.php) - for NI-to-HTTP converter (used modified one that supports aac and raw streaming).
+* [libfec](https://github.com/Opendigitalradio/ka9q-fec) - for Reed-Solomon FEC, may be enabled/disabled.
+* [libshout](http://www.icecast.org/download.php) - for NI-to-HTTP converter (included in this package library is modified to support aac and raw streaming).
 * [libzmq](http://zeromq.org) - optional: for ZeroMQ output of NI-to-HTTP converter (possible re-mux of ETI-streams containing DAB/DAB+ streams). Uncomment it in Makefile if this option is needed.
 
 
 ts2na
 ===============
-ts2na - is MPEG-TS to ETI-NA converter. To use this tool, you have to provide pid to use, and optional offset size.
+ts2na - is MPEG-TS to ETI-NA converter. To use this tool, you have to provide pid to use, and optional offset size. ts2na_dreambox.c - is special version for Dreambox DM-500S which can be used to tune frontend to specific frequency. On regular PC use [dvbstream](https://www.linuxtv.org/wiki/index.php/Dvbstream) application to dump or send in pipeline needed PID for this application.
 
     usage: ./ts2na [-p pid] [-s offset] [-i <inputfile>] [-o <outputfile>]
 
-The output stream will be raw pid content. If negative offset is setted, then "pid" field will be used as part of the ETI stream.
+The output stream will be raw pid content. If negative offset is setted, then "pid" field will be used as part of the ETI stream. The parameter [-s offset] must be seen in MPEG-TS dump, in most cases that is unused 0xFF at the beginning of the each TS-packet's payload.
 
 ETI na2ni
 ===============
@@ -27,14 +27,14 @@ The output stream will be 6144-bytes aligned raw ETI-NI stream.
 
 ETI ni2http
 ===============
-ni2http - is ETI-NI to http converter. This tool converts eti-stream to mp2 and relay it to icecast2 server.
+ni2http - is ETI-NI to HTTP or ZeroMQ converter. This tool converts eti-stream to mp2/aac and relay it to icecast2 or ODR-DabMUX server.
 
     usage: ./ni2http [--list] [--delay] [-i <inputfile>] [-c <config_file>]
 
 Use "--list" option to find SID's and station names of the streams inside ETI.
 The "--delay" option have to be used when you are doing offline-relaying (from the file, not from the stream). So in that case application will wait 24ms after each eti frame, to make pseudo-realtime streaming.
 
-The application also parses FIC for auto-detecting of station name and X-PAD of DAB and DAB+ for setting current song titles.
+The application also able to parse FIC for auto-detecting of station name and X-PAD of DAB and DAB+ for setting current DLS (song titles).
 
 Config sample:
 
@@ -78,4 +78,8 @@ Config sample:
     zmq:       tcp://127.0.0.1:9001
 
 In [server] section the parameters of Icecast2 server must be setted.
-In [channel] sections at least service-id of the channel must be presented. If u wish to write stream to file, then use "file" to specify it's location. If stream to Icecast2 server is needed, then specify mount-point on the icecast server. If you wish to re-stream to ODR-DabMUX then set destination of the ZeroMQ URI to muxing server. To get list of service-id's, use "ni2http --list -i <inputfile>"
+In [channel] sections at least service-id of the channel must be presented.
+
+If you wish to write stream to file, then use "file" to specify it's location. If stream to Icecast2 server is needed, then specify mount-point on the icecast server.
+
+If you wish to re-stream to ODR-DabMUX then set destination of the ZeroMQ URI to muxing server. To get list of service-id's, use "ni2http --list -i <inputfile>"