fmscan.1

   1 .TH FM 1 "fmscan 1.0.2"
   2 .SH NAME
   3 fmscan \- scan FM band for radio stations
   4 .SH SYNOPSIS
   5 .PP
   6 .B fm
   7 [
   8 .B \-h
   9 ] [
  10 .B \-d
  11 .I device
  12 ] [
  13 .B \-t
  14 .I tuner
  15 ] [
  16 .B \-s
  17 .I freq
  18 ] [
  19 .B \-e
  20 .I freq
  21 ] [
  22 .I \-i
  23 .I freq
  24 ] [
  25 .I \-q
  26 ]
  27 .SH DESCRIPTION
  28 .B fmscan
  29 is a program to scan a frequency band for radio stations, using the
  30 video4linux interface introduced in 2.1.x series Linux kernels.  It
  31 shows which ones have a accumulated signal strength of 50% or higher.
  32 .SS OPTIONS
  33 .PP
  34 .TP
  35 .B \-h
  36 Print a usage message to standard output, and exit.
  37 .TP
  38 \fB\-d \fIdevice
  39 Sets \fIdevice\fR as the device to tune.  The default is
  40 \fB/dev/radio0\fR.
  41 .TP
  42 \fB\-t \fItuner
  43 Sets \fItuner\fR as the tuner on the selected device to adjust.  The
  44 default is tuner 0.  Most radio devices have only a single tuner.
  45 .TP
  46 \fB\-s \fIfreq
  47 Starting frequency for scan, in MHz.  Default: 87.9.
  48 .TP
  49 \fB\-e \fIfreq
  50 Ending frequency for scan, in MHz.  Default: 107.9.
  51 .TP
  52 \fB\-i \fIfreq
  53 Increment between scanned channels, in MHz.  Default: 0.2.
  54 .TP
  55 \fB\-t \fIpercent
  56 Signal strength threshold to consider a channel.  Default: 50%.
  57 .TP
  58 \fB\-q\fR
  59 Quiet mode.  Suppresses progress output.
  60 .SH BUGS
  61 This process can take a while, and results vary greatly depending on the
  62 radio card in use.  If your card's hardware cannot report signal
  63 strength, it will not produce useful results.
  64 .PP
  65 This program may not do much if your radio card's driver doesn't support
  66 fine tuning in 1/16000 MHz offsets.  By default, V4L2 assumes 1/16 MHz
  67 tuning units, which introduces evil rounding errors on many frequencies.
  68 .PP
  69 Supports only tuner 0 on any given device.
  70 .SH SEE ALSO
  71 .TP
  72 Additional documentation:
  73 .B /usr/doc/fmtools/README
  74 .TP
  75 The fmtools homepage:
  76 .B http://benpfaff.org/fmtools
  77 .SH AUTHORS
  78 Russell Kroll <rkroll@exploits.org>, now maintained by Ben Pfaff
  79 <blp@cs.stanford.edu.>. This manpage written by Ben Pfaff.