*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> radio (4)              



NAME    [Toc]    [Back]

     radio - device-independent radio driver layer

SYNOPSIS    [Toc]    [Back]

     radio* at az?
     radio* at bktr?
     radio* at fms?
     radio* at gtp?
     radio* at rt?
     radio* at rtii?
     radio* at sfr?
     radio* at sf2r?
     radio* at udsbr?

     #include <sys/types.h>
     #include <sys/ioctl.h>
     #include <sys/radioio.h>

DESCRIPTION    [Toc]    [Back]

     The radio driver  provides  support  for  various  FM  radio
cards.  It provides
 an uniform programming interface layer above different
     radio hardware drivers.

     For radio tuner controlling there is a  single  device  file

     The following ioctl(2) commands are supported:

     RIOCSSRCH (int)
             This  command  assumes  that  a signal search is required and gives
             direction of search to the driver - 0 to search down
and any nonzero
 value to search up.
     RIOCGINFO (struct radio_info)
     RIOCSINFO (struct radio_info)
             Get  or  set the current hardware device information
into the
             struct radio_info structure.

             struct radio_info {
                     int     mute;
                     int     volume;
                     int     stereo;
                     int     rfreq;  /* reference frequency */
                     int     lock;   /* locking field strength */
                     u_int32_t       freq;   /* in kHz */
                     u_int32_t       caps;   /* card capabilities
             #define RADIO_CAPS_DETECT_STEREO        (1<<0)
             #define RADIO_CAPS_DETECT_SIGNAL        (1<<1)
             #define RADIO_CAPS_SET_MONO             (1<<2)
             #define RADIO_CAPS_HW_SEARCH            (1<<3)
             #define RADIO_CAPS_HW_AFC               (1<<4)
             #define RADIO_CAPS_REFERENCE_FREQ       (1<<5)
             #define RADIO_CAPS_LOCK_SENSITIVITY     (1<<6)
             #define RADIO_CARD_TYPE                 (0xFF<<16)
                     u_int32_t       info;
             #define RADIO_INFO_STEREO               (1<<0)
             #define RADIO_INFO_SIGNAL               (1<<1)

             The mute field is a boolean.

             The volume field holds the card  volume  information
and can be at
             most 255.

             The stereo field is a boolean.

             The rfreq holds information about the card reference
             (not all cards support this feature).

             The lock field  holds  information  about  the  card
locking field
             strength  during  an automatic search for cards that
support this

             The freq field is the frequency in kHz the  card  is
tuned to.

             The  caps  field is read-only and describes the card
             The capabilities can have the following values:

                     The device can determine if it is tuned to a
stereo signal.

                     The  device  can determine if it is tuned or
                     The device is capable  of  forcibly  setting
its output to
                     The device can do hardware search.
                     The device has an internal hardware automatic frequency
                     The device  allows  changing  the  reference
frequency of a
                     received signal.
                     The  device allows changing the station lock
                     used during search operation.
                     Some cards have several  different  incarnations.  This allows
  the  variant  of the card to be determined.  Currently
                     not used.

             The info field is read-only and describes  the  current state of
             the  card - tuned/not tuned, stereo signal/mono signal.

                     Informs whether the device receives a stereo
or mono signal.

                     Informs  whether the device receives a valid
signal or

CHIPSETS    [Toc]    [Back]

     LM700x is a frequency synthesizer IC.  The  LM700x  is  programmed through a
     24-bit  write-only  shift  register.   The first 14 bits are
frequency data.
     The next 2 bits are LSI test bits, and should always be  zero.  The next 4
     bits  are  band  data  and time base data.  They can be programmed to force a
     given reference frequency, or they can be set  to  zero  and
the next 3 bits
     can  be  used to set the reference frequency.  The final bit
selects the
     divider selection, which is 1 for FM  and  0  for  AM.   The
LM700x chips are
     used in az(4) and rt(4) cards.

     The TEA5757; TEA5759 is a 44-pin integrated AM/FM stereo radio circuit.
     The radio part is based on the TEA5712.  The TEA5757 is used
in FM-standards
  in  which the local oscillator frequency is above the
radio frequency
 (e.g. European and American standards).  The  TEA5759  is
the version in
     which  the oscillator frequency is below the radio frequency
     Japanese standards).  To conform  with  the  Japanese  standards, it is necessary
  to  set  the flags' least significant bit to 1.  The
     TEA5759 has a 25-bit read-write shift register.  The TEA5757
chips are
     used in gtp(4), rtii(4), sf2r(4) and fms(4) cards.

     The TC9216P, TC9217P and TC9217F are high speed PLL-LSI with
built-in 2
     modulus prescaler.  Each function is  controlled  through  3
serial bus
     lines (DATA, CLOCK and PERIOD) by the data setting to a pair
of 24-bit
     registers, total of 48 bits.  Address 8  bits  and  data  24
bits, total of
     32  bits,  are  transferred in serial at the same time.  The
TC921x chips
     are used in sfr(4) cards.

FILES    [Toc]    [Back]


SEE ALSO    [Toc]    [Back]

     radioctl(1), ioctl(2), az(4), bktr(4), fms(4),  gtp(4),  intro(4), rt(4),
     rtii(4), sf2r(4), sfr(4), udsbr(4), radio(9)

HISTORY    [Toc]    [Back]

     The radio device driver appeared in OpenBSD 3.0.

AUTHORS    [Toc]    [Back]

     The  radio  driver was written by Vladimir Popov <jumbo@narod.ru> and
     Maxim Tsyplakov <tm@oganer.net>.  The man page  was  written
     Vladimir Popov <jumbo@narod.ru>.

OpenBSD      3.6                         October     20,     2001
[ Back ]
 Similar pages
Name OS Title
midi OpenBSD device-independent MIDI driver layer
audio OpenBSD device-independent audio driver layer
mixer OpenBSD device-independent audio driver layer
gtp OpenBSD Gemtek PCI FM radio device driver
rtii OpenBSD AIMS Lab Radiotrack II FM radio device driver
rt OpenBSD AIMS Lab Radiotrack FM radio device driver
sfr OpenBSD SoundForte RadioLink SF16-FMR FM radio device driver
az OpenBSD Aztech/PackardBell radio card device driver
sf2r OpenBSD SoundForte RadioLink SF16-FMR2 FM radio device driver
ufm FreeBSD USB driver for Cypress Semiconductor FM Radio
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service