radioctl(1) [netbsd man page]

RADIOCTL(1)						    BSD General Commands Manual 					       RADIOCTL(1)

NAME

     radioctl -- control radio tuners

SYNOPSIS

     radioctl [-f file] [-n] -a
     radioctl [-f file] [-n] name
     radioctl [-f file] [-n] -w name=value

DESCRIPTION

     The radioctl command displays or sets various variables that affect the radio tuner behavior. If a variable is present on the command line,
     radioctl prints the current value of this variable for the specified device.  By default, radioctl operates on the /dev/radio device.

     The options are as follows:

     -a      Print all device variables and their current values.

     -w name=value
	     Attempt to set the specified variable name to value.

     -f file
	     Specify an alternative radio tuner device.

     -n      Suppress printing of the variable name.

     Values may be specified in either absolute or relative forms.  The relative form is indicated by a prefix of '+' or '-' to denote an increase
     or decrease, respectively.

     The exact set of controls that can be manipulated depends on the tuner.  The general format (in both getting and setting a value) is

     name = value

     The name indicates what part of the tuner the control affects.

     Write only controls:

     search  Only for cards that allow hardware search. Can be 'up' or 'down'.

     Read-write controls:

     frequency
	     Float value from 87.5 to 108.0.

     volume  Integer value from 0 to 255.

     mute    Mutes the card (volume is not affected), 'on' or 'off'.

     mono    Forces card output to mono, 'on' or 'off'.  Only for cards that allow forced mono.

     reference
	     Reference frequency. Can be 25 kHz, 50 kHz and 100 kHz. Not all cards allow to change the reference frequency.

     sensitivity
	     Station locking sensitivity. Can be 5 mkV, 10 mkV, 30 mkV and 150 mkV. Not all cards allow to change the station locking sensitivity.

     All the remaining controls (signal, stereo and card capabilities) are read-only and can be viewed using option -a.

ENVIRONMENT

     The following environment variable affects the execution of radioctl:

     RADIODEVICE  The radio tuner device to use.

FILES

     /dev/radio  radio tuner device

EXAMPLES

     The command

	   radioctl -a

     can produce

     volume=255
     frequency=106.30MHz
     mute=off
     reference=50kHz
     signal=on
     stereo=on
     card capabilities:
	     manageable mono/stereo

SEE ALSO

     radio(4)

HISTORY

     radioctl command first appeared in OpenBSD 3.0 and NetBSD 1.6.

BSD
								September 16, 2001							       BSD

radio(1)						      General Commands Manual							  radio(1)

NAME

       radio - console radio application

SYNOPSIS

       radio [ options ]

DESCRIPTION

       radio is a interactive, ncurses-bases console radio application.

OPTIONS

       -h     print a short help text.

       -d     enable debug output.

       -q     quit after processing the cmd line options, don't enter interactive ncurses mode.  Only useful together with other options for obvi-
	      ous reasons ...

       -m     mute radio.

       -f freq
	      tune the specified radio frequency (and unmute the radio).

       -c dev specify radio device (default is /dev/radio).

       -s     Do a scan for radio stations.

       -S     Same as above + write a radio.fmmap with the signal  for	every  frequency.   You  can  get  a  graph  for  it  with  gnuplot  (plot
	      "radio.fmmap" w lin).

       -i     Scan,  write a initial ~/.radio file to stdout and quit.	So you can create a config file where you only have to fill in the correct
	      station names later this way: "radio -i > ~/.radio".  See below for the config file syntax.

CONFIGURATION

       radio picks up station names and present stations from a config file.  It can parse kradio (KDE radio app) config files, therefore it first
       tries the usual KDE config file location: ~/.kde/share/config/kradiorc. Failing that, radio tries ~/.radio (which makes things a bit easier
       for people who don't use kradio).

       The format looks like this:

       # KDE Config File
       [Buttons]
       1=95800000
       2=91400000
       [Stations]
       100600000=Hundert,6
       95800000=Radio eins
       102600000=Fritz
       94300000=r.s.2
       91400000=Berliner Rundfunk

       The [Buttons] section can have up to eight entries.  That are the present stations, they get mapped to F1-F8.  The [Stations] section  maps
       frequencies to station names.  The frequencies in both sections are specified in Hz.

KEYS

       X	 exit
       ESC,Q,E	    mute and exit.
       up/down	    inc/dec frequency
       pgup/pgdown  next/previous station.  This one uses the
		    stations from the config file by default.
		    When started with the -s option these keys
		    will cycle througth the stations found during
		    the scan.
       F1-F8, 1-8   preset buttons.
       Ctrl+L	    redraw screen.

AUTHOR

       Gerd Knorr <kraxel@bytesex.org>

COPYRIGHT

       Copyright (C) 1997-2001 Gerd Knorr

       This  program  is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY	WARRANTY;  without  even  the  implied	warranty  of  MER-
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

       You  should  have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation,
       Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

							     (c) 1998-2001 Gerd Knorr							  radio(1)