README

   1 All tables are now using DVBv5 format. That allows suporting all standards
   2 available on a standard way.
   3
   4 GENERATING FILES TO THE LEGACY DVBV3 FORMAT
   5 ===========================================
   6
   7 A Makefile target is provided to convert to the legacy channel format.
   8 For it to work, you need to have v4l-utils installed (specifically,
   9 the v4l-utils package that contains the dvbv5 utils).
  10
  11 Be sure that you have at least version 1.4.0 installed, or, if you're
  12 compiling v4l-utils from its source. Versions below may work too, but
  13 some DVB files won't be properly parsed with earlier versions.
  14
  15 This is the minimal changeset of v4l-utils required for it to work:
  16         commit 64751eb98a15b9c0077d8c2e4409b9b69ac80448
  17         Date:   Fri Sep 5 15:50:43 2014 -0300
  18         Subject: libdvbv5: make sure that all needed properties are filled
  19
  20 You can download and install v4l-utils from:
  21         http://git.linuxtv.org/cgit.cgi/v4l-utils.git/
  22
  23 Once having it installed, generating all the tables usind DVBv3 channel
  24 format is as easy as running:
  25
  26         $ make clean
  27         $ make dvbv3
  28
  29 The files can also be individually converted from DVBv5 to DVBv3 with:
  30
  31         $ dvb-format-convert -I dvbv5 -O channel dvb-c/ch-Rega-Sense legacy-format-ch-Rega-Sense
  32
  33 And converting back into DVBv5 format with:
  34
  35         $ dvb-format-convert -I channel -O dvbv5 legacy-format-ch-Rega-Sense dvb-c/ch-Rega-Sense
  36
  37 Plese notice that comments are not preserved when doing the conversions.
  38
  39 PS.: If you're willing to submit new entries and/or corrections, please
  40 be sure to send them at the DVBv5 format and sending them via e-mail
  41 to linux-media@vger.kernel.org.
  42
  43 INSTALL
  44 =======
  45
  46 In order to install the files, use:
  47         $ make install
  48
  49 By default, it will install the files at /usr/local/share/dvbv5.
  50
  51 In order to install the legacy v3 formatted files, use:
  52         $ make install_v3
  53
  54 Don't forget to run "make dvbv3" before running the above command,
  55 in order to convert the files to the legacy format.
  56
  57 By default, it will install the files at /usr/local/share/dvbv3.
  58
  59 There are a few extra parameters that could be used to define where
  60 the files will be stored:
  61
  62         PREFIX=<dir>            (default: /usr/local)
  63         DATADIR=<dir>           (default: $(PREFIX/share)
  64         DVBV5DIR=<subdir>       (default: dvbv3)
  65         DVBV3DIR=<subdir>       (default: dvbv5)
  66
  67 So, if it is desired to install both v3 and v5 files at a tmp file,
  68 under the current dir, the install command would be:
  69
  70         $ make install install_v3 PREFIX=`pwd`/tmp
  71         Installing dvbv5-formatted files at /home/myuser/dtv-scan-tables/tmp/share/dvbv5...done.
  72         Installing dvbv3-formatted files at /home/myuser/dtv-scan-tables/tmp/share/dvbv3...done.
  73
  74 Please also note that install takes some time, as there are lots
  75 of files to be copied.