README

   1 TELETEXT SERVER - DVB-T2 Version
   2 ================================
   3
   4 Updated to work with DVB-T2 and the Astrometa DVB-T2 USB Stick; many improvements in `html.pl`.
   5
   6 Installation
   7 ------------
   8
   9 1. `./install.sh` as root
  10 2. create channels.conf with `w_scan` or others; I'm using VDR format
  11    `w_scan -a /dev/dvb/adapter0/frontend1 -cAT -vv > channels.conf`
  12 4. use `ttxd.service` or `serv.sh` to start the service.
  13
  14 Usage
  15 -----
  16
  17 1. run `serv.sh` to tune the TV card and start spooling pages
  18 2. generate an HTML file by running `ORFText.cgi`
  19
  20 Notes and Caveats
  21 -----------------
  22
  23  * The Astrometa DVB-T2 is very iffy: make sure firmware (`dvb-demod-mn88473-01.fw`) is in place and monitor dmesg when connecting/tuning (I2C errors, firmware upload).
  24    Only fix seems to be a manual reconnect (TODO: splice relay into 5V wire of USB cable)
  25  * `dvbtext` had the line `if (buf[4+i*46]==2) {` replaced with `if (buf[4+i*46]==3) {` or no vtx files will be generated
  26  * The spool directory and DVB adapter number are hardcoded in `dvbtext`; its source is in `./src/dvbtext-src/dvbtext.c`.
  27  * `serv.sh` does not check if the card has been tuned; it simply waits 5 seconds.
  28  * The spool directory is `/run/ttxd/spool/`, to avoid disk wear.
  29  * The accompaning systemd service is `/etc/systemd/system/ttx.service`, where the names of the processes `dvbtext`, `tzap`, and `thttpd` are hardcoded.
  30  * since `killall thttpd` is used to start and stop the service, rename that executable if you already running an instance of `thttpd` for other web services.
  31  * in VDR format, teletext PIDs are directly visible: `awk -F':' '{if ($8 != 0){print $1, " : ", $8}}' channels.conf|column -t -s':'`
  32
  33 Notes
  34 -----
  35
  36 Currently, the service is using `/dev/dvb/adapter0/{frontend1,demux0}` (USB) for ORF via DVB-T2.
  37
  38 License
  39 -------
  40
  41 (C) 2017 Tobias Girstmair
  42 This software is distributed under the GNU General Public License 3.
  43
  44 Included Software
  45 -----------------
  46
  47 This package contains software of third parties (excluded from license):
  48  * dvbtext - Dave Chapman, GNU GPL v2+ (software sightly adapted)
  49  * vtx2ascii - Gerd, Martin Buck, GNU GPL v2(+?) (software sightly adapted)
  50  * thttpd - Jef Poskanzer, 2 clause BSD (modified)
  51  * tzap-t2 - Igor M. Liplianin, GNU GPL v2+ (used as-is)