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