--------------------------------------------------------------------------------
- Readme for DTAPI Service/Daemon
--------------------------------------------------------------------------------

--------------------------------------------------------------------------------
- Table of Contents
--------------------------------------------------------------------------------

 1. Version History
 2. Introduction
 3. Installation Instructions
 4. Contact Information

--------------------------------------------------------------------------------
- 1. Version History
--------------------------------------------------------------------------------

Refer to "SDK - Revision History.pdf" for details


--------------------------------------------------------------------------------
- 2. Introduction
--------------------------------------------------------------------------------

The DTAPI service is a Linux daemon (service) that manages DekTec's range of 
demodulator boards. The following demodulators are supported:
- DTU-234	(VSB/QAM-B receiver for USB)
- DTU-235	(DVB-T measurement receiver for USB)
- DTU-236	(QAM measurement receiver + ASI input for USB)
- DTA-2127  (Quad DVB-S2X Receiver with 3G-SDI/ASI Output for PCIe)
- DTA-2128  (Octal DVB-S2X Receiver for PCIe)
- DTA-2131	(Multi-Standard Cable/Terrestrial Receiver for PCIe)
- DTA-2131B	(Multi-Standard Cable/Terrestrial Receiver for PCIe)
- DTA-2132  (High-End Satellite Receiver for PCIe)
- DTA-2135	(Dual DVB-T receiver for PCIe)
- DTA-2136	(Dual QAM-A/B/C receiver for PCIe)
- DTA-2137	(Dual DVB-S/DVB-S2 receiver for PCIe)
- DTA-2138	(DVB C2/T2 receiver for PCIe)
- DTA-2138B	(Single-Channel Cable/Terrestrial Receiver for PCIe)
- DTA-2139	(Twelve-Channel Cable Receiver for PCIe)
- DTA-2139B	(Twelve-Channel Cable/Terrestrial Receiver for PCIe)
- DTA-2139C	(Twelve-Channel Cable/Terrestrial Receiver for PCIe)
 
NOTE: this service must be running to be able to use the above boards.
 
--------------------------------------------------------------------------------
- 3. Installation Instructions
--------------------------------------------------------------------------------

The DtapiService dynamically links to a set of shared libraries. Make sure you
have installed the following shared library versions.
 - libstdc++.so.6
 - libgcc_s.so.1
 - libpthread.so.0
 - libm.so.6
 - libc.so.6
 - libdl.so.2

To install the DtapiService, execute the self-extracting installer 
"DtapiService.bin". Superuser privileges are required because the installer
installs system files and registers the service with the system’s init system.
For example:
 - "sudo ./DtapiService.bin"
During installation, temporary files are created in 
"/tmp/DtapiServiceInstaller". This directory is removed automatically when the
installation completes.

After installation, the DtapiService is enabled to start automatically at
system boot.

Service management (systemd)
On systems using systemd (most modern Linux distributions), the DtapiService
is installed as a systemd service.
You can manually start and stop the service using systemctl:
 - "sudo systemctl start DtapiServiced"
 - "sudo systemctl stop DtapiServiced"
 
Legacy init systems
On systems without systemd, the DtapiService runs as a traditional daemon.
In this case, the installer installs a legacy init script "DtapiServiceInit",
located in the system’s init directory.
In that case you can manually start and stop the daemon as follows:
 - "DtapiServiceInit start"
 - "DtapiServiceInit stop"

IMPORTANT: 
* For the DtapiService to function correctly, the DtPcie/Dta driver must be 
  installed and running. Please refer to the DtPcie/Dta readme file for 
  instructions on how to compile and install the driver. 
* The DtapiService also needs write-access to the /tmp directory and the 
  /dev/shm directory.
* On systemd-based systems, DtapiServices uses the runtime directory  
  /run/DtapiServiced (automatically created and cleaned up by systemd).

--------------------------------------------------------------------------------
- 4. Contact Information
--------------------------------------------------------------------------------

Please find our contact information below:

DekTec Digital Video B.V.
Godelindeweg 4
1217 HR Hilversum
The Netherlands

Tel:     +31 (0)35 2030 100
Email:   support@dektec.com / info@dektec.com
Website: www.dektec.com
