**********************************************************
****** DABC plugin for hadaq 
****** (originally HADES collaboration DAQ and data format)
*        Joern Adamczewski-Musch, j.adamczewski@gsi.de
* Version 0.08 - 08-Jul-2012
   :  Added control of distributed runid from hades epics master
   
* Components:
   * HldFile - (OK) input and output of hld file format
   * HldInput - (OK) read hadtu format from file 
   * HldOutput- (OK) write hadtu format to file 
   * DataSocketAddon - (Exp) receive hadtu packets from trb frontend (single stream)
   * MbsTransmitterModule - (OK) wrap hadtu format into mbs event container
                            output is mbs server or lmd file.
                            this format is used in mbs subevent combiner and go4 monitoring unpacker 
   * CombinerModule - (OK) do eventbuilding of hadtu format from several data streams.
                      output is full event in hadtu format. 
                      Should provide functionality of old daq_evtbuild in the end.
   * Observer  - (OK) Control system interface to hades shared memory. 
                      We use original hadaq code (worker and psxshm) and wrap it into dabc parameter scheme.
                      
* Applications:
   * HldConverter.xml - (OK)
         configuration to read hld file and write the hadtu events wrapped in mbs events to lmd file
   * HldServer.xml -  (OK)
         configuration to read hld file and serve the hadtu events as mbs events at transport server
         dabc will wait 30 seconds before start processing, so go4 may connect to inspect data
   * NetmemServer.xml -(OK)
         configuration to receive hadtu buffers at udp socket and serve them as mbs events at transport/stream server

   * EventBuilder.xml -(OK)
         configuration to receive hadtu data at n udp sockets, and do a full eventbuilding.
         Output events can be served via mbs transmitter at transport/stream server
         In parallel, output events can be written to hld file.
         May enable export of variables via shared mem to hades EPICS-based eventbuilder control system
   
   * EventBuilderDim.xml -(OK)
         as EventBuilder.xml, but shows how to activate additionally DIM control system export.
         
* How to use:
 TODO 
 
* Changes:     
   * Version 0.01 - 06-Jun-2012
      : design of classes and first successful compilation.
   * Version 0.02 - 13-Jun-2012
      : First working with HldConverter and HldServer applications. 
   * Version 0.03 - 15-Jun-2012
      : First version with working UdpTransport. Tested with hadaq trb simulator + Go4 client
   * Version 0.04 - 19-Jun-2012
      : Implemented valid simple eventbuilding in udp transport. 
        Will insert hades eventheader before each subevent of hadtu input stream.
        First version that is _really_ working with hadaq trb simulator + Go4 client
   * Version 0.05 - 22-Jun-2012
      : First full eventbuilding in CombinerModule. 
        Tested with hadaq trb simulator + Go4 client  
   * Version 0.06 - 26-Jun-2012
      :  Implemented hld file output. 
         Improvements in Combiner module
   * Version 0.07 - 05-Jul-2012
      :  Implemented interface to hades shared memory control (hadaq "worker").
         Tested with original hades ebctrl ioc + medm
   * Version 0.08 - 08-Jul-2012
      :  Added control of distributed runid from hades epics master
   * Under construction
   
* DISCLAIMER:
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details (http://www.gnu.org).
---------------------------------------------------------------