<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

<!-- Process this file with docbook-to-man to generate an nroff manual
     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
     less'.  A typical entry in a Makefile or Makefile.am is:

manpage.1: manpage.sgml
	docbook-to-man $< > $@

    
	The docbook-to-man binary is found in the docbook-to-man package.
	Please remember that if you create the nroff version in one of the
	debian/rules file targets (such as build), you will need to include
	docbook-to-man in your Build-Depends control field.

  -->

  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
  <!ENTITY dhfirstname "<firstname>Alastair</firstname>">
  <!ENTITY dhsurname   "<surname>McKinstry</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>May  9, 2002</date>">
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
       allowed: see man(7), man(1). -->
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  <!ENTITY dhemail     "<email>mckinstry@computer.org</email>">
  <!ENTITY dhusername  "Alastair McKinstry">
  <!ENTITY dhucpackage "<refentrytitle>DVBTUNE</refentrytitle>">
  <!ENTITY dhpackage   "dvbtune">

  <!ENTITY debian      "<productname>Debian</productname>">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
]>

<refentry>
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
        </author>
    <copyright>
      <year>2002</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </refentryinfo>
  <refmeta>
    &dhucpackage;

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>&dhpackage;</refname>

    <refpurpose>command-line tuning application for DVB cards </refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&dhpackage;
      -f <replaceable>frequency</replaceable>
      -p <replaceable>h|v</replaceable>
      -s <replaceable>symbol_rate</replaceable>
      -v <replaceable>vpid</replaceable>
      -a <replaceable>apid</replaceable>
      -t <replaceable>tpid</replaceable>
      </command>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>


    <para><command>&dhpackage;</command> is a simple tuning application for DVB cards 
    supported by the Linux DVB driver (www.linuxtv.org).
    </para>

    <para>
    This is still very experimental - especially the XML output.
    The latest version can be found at www.linuxstb.org. 
    You can contact the author at <email>dave@dchapman.com</email>.
    </para>

  </refsect1>
  <refsect1>
    <title>OPTIONS</title>

    <para>	
    The following options are understood by <command>dvbtune</command>:
    </para>

    <variablelist>

    <varlistentry>
    <term>-c [0-3]</term>
    <listitem>Use DVB device [0-3]</listitem>
    </varlistentry>

    <varlistentry>
    <term>-f freq</term>
     <listitem>
    Absolute Frequency (DVB-S in Hz or DVB-T in Hz), 
    or L-band Frequency (DVB-S in Hz or DVB-T in Hz).
    </listitem>
    </varlistentry>

    <varlistentry>
    <term>-p [H|V]</term>
    <listitem>Polarity (DVB-S only)</listitem>
    </varlistentry>

    <varlistentry>
    <term>-tone [0|1]</term>
    <listitem>0 = 22 kHz off, 1 = 22 kHz on</listitem>
     </varlistentry>

    <varlistentry>
    <term>-I [0|1|2]</term>
    <listitem>
    0 = Spectrum Inversion off
    1 = Spectrum Inversion on,
    2 = auto (Default)
    </listitem>
    </varlistentry>

     <varlistentry>
    <term>-S N</term>
      <listitem>
    Symbol rate (DVB-S only),e.g. 27500
    </listitem>
    </varlistentry>

     <varlistentry>
    <term>-D [0-4]</term>
    <listitem>
    DiSEqc ("Digital Satellite Equipment Control") command (0=none)
    </listitem>
    </varlistentry>
    
     <varlistentry>
    <term>-V vpid</term>
    <listitem>
    Set video PID (Full cards only) 
    </listitem>
   </varlistentry>
    
     <varlistentry>
    <term>-A apid</term>
    <listitem>
    Set audio PID (full cards only)
    </listitem>
    </varlistentry>

     <varlistentry>
    <term>-T ttpid</term>
    <listitem>
    Set teletext PID (full cards only)
    </listitem>
    </varlistentry>

     <varlistentry>
     <term>-pnr N</term>
     <listitem>
     Tune to Program Number (aka service) N
    </listitem>
     </varlistentry>
     
     <varlistentry>
    <term>-i</term>
    <listitem>
    Dump SI information as XML
    </listitem>
    </varlistentry>

     <varlistentry>
    <term>-x</term>
    <listitem>
    Attempt to auto-find other transponders (experimental)
    </listitem>
    </varlistentry>

    <varlistentry>
    <term>-m</term>
    <listitem>
    Monitor the reception quality
    </listitem>
    </varlistentry>
    
     <varlistentry>
    <term>-n dpid</term>
    <listitem>
    Add network interface and receive MPE on PID dpid
    </listitem>
    </varlistentry>

    <varlistentry>
    <term>--help</term>
    <listitem>
    Print help message
    </listitem>
    </varlistentry>

    <varlistentry>
    <term>--version</term>
    <listitem>
    Print version string
    </listitem>
    </varlistentry>

    
</variablelist>
    
  </refsect1>

  <refsect1>
  <title>EXAMPLES</title>

  <para>  
  For simple tuning, you can just use
  
  dvbtune -f 12188000 -p h -s 27500 -v 163 -a 104 -t 32
  
  to tune to a satellite transponder and set the video, audio and teletext PIDs.

  dvbtune can also support DVB-T reception (currently for the UK only). 
  In this case, you just need to specify the frequency:
  
  dvbtune -f 48183300

  To get the DVB SI information for a multiplex, you can use the <option>-i</option>
  option.  The output of dvbtune needs some addition lines before it is
  a valid XML file.  


To get the DVB SI information for a multiplex, you can use the "-i"
option.  The output of dvbtune needs some addition lines before it is
a valid XML file.  e.g. use a script containing

echo '&lt;?xml version="1.0"?&gt;' &gt; test.xml ;
echo '&lt;satellite&gt;' &gt;&gt; test.xml ;
dvbtune -f freq -s srate -p pol -i  &gt;&gt; test.xml ;
echo '&lt;/satellite&gt;' &gt;&gt; test.xml

to dump the SI for a satellite transponder.

This was done to allow you to write scripts to scan multiple
transponders and write the output to the same XML file.  See the
"scripts" subdirectory for examples.

  </para>
  </refsect1>
 
  <refsect1>
   <title>NOTES</title>
    <para>
    <command>dvbtune</command> depends on the appropriate device nodes in /dev being
    present. These are either provided automatically by devfsd or udev, or must
    be made using <command>/sbin/MAKEDEV dvb</command>. The Debian package automatically
    runs MAKEDEV if necessary on install.
    </para>
    </refsect1>
 
  <refsect1>
    <title>SEE ALSO</title>

    <para>xml2vdr (1), szap (1).</para>

  </refsect1>
  <refsect1>
    <title>AUTHOR</title>

    <para>
    <command>&dhpackage;</command> was written by Dave Chapman
    <email>dave@dchapman.org</email>.    
    </para>

    <para>
    Hilmar Linder added the Switch -n that adds a network interface and switch -m that
    monitors the reception quality. Changed the tuning code. Added command
    line parameters for spectral inversion. Changed code to allow L-Band
    frequencies with -f switch.
    </para>

    <para>
     John Williams Added -D diseqc support, and made the 22kHz tone automatic again.
     </para>

    <para>
    This manual page was written by &dhusername; &dhemail; for
      the &debian; system (but may be used by others).  Permission is
      granted to copy, distribute and/or modify this document under
      the terms of the <acronym>GNU</acronym> Free Documentation
      License, Version 1.1 or any later version published by the Free
      Software Foundation; with no Invariant Sections, no Front-Cover
      Texts and no Back-Cover Texts.</para>

  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->


