Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Remove factual errors from the radio man pages. 

Also rearrange some information.
This commit is contained in:
augustss 2002-01-02 02:08:02 +00:00
parent e9a82c88ce
commit 1ec3f0c9cc
6 changed files with 57 additions and 40 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
share/man/man4/az.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: az.4,v 1.3 2002/01/01 22:50:29 wiz Exp $
.\" $NetBSD: az.4,v 1.4 2002/01/02 02:08:02 augustss Exp $
.\" $RuOBSD: az.4,v 1.3 2001/10/26 05:38:43 form Exp $
.\" $OpenBSD: az.4,v 1.1 2001/12/05 10:58:54 mickey Exp $
.\"
@ -32,8 +32,8 @@
.Nm az
.Nd Aztech/PackardBell radio card device driver
.Sh SYNOPSIS
.Cd "az0 at isa? port 0x358"
.Cd "az0 at isa? port 0x350"
.Cd "az1 at isa? port 0x358"
.Cd "radio* at az?"
.Sh DESCRIPTION
The

21
share/man/man4/radio.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: radio.4,v 1.4 2002/01/01 22:54:11 wiz Exp $
.\" $NetBSD: radio.4,v 1.5 2002/01/02 02:08:02 augustss Exp $
.\" $RuOBSD: radio.4,v 1.4 2001/10/26 05:38:43 form Exp $
.\" $OpenBSD: radio.4,v 1.3 2001/12/05 10:58:54 mickey Exp $
.\"
@ -32,8 +32,6 @@
.Nm radio
.Nd device-independent radio driver layer
.Sh SYNOPSIS
.Cd option RADIO_TEA5759
.Pp
.Cd "radio* at az?"
.Cd "radio* at mr?"
.Cd "radio* at rt?"
@ -50,17 +48,6 @@ driver provides support for various FM radio cards.
It provides an uniform programming interface layer above different underlying
radio hardware drivers.
.Pp
Philips Semiconductors released two almost identical chips TEA5757 and
TEA5759.
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 (e.g. Japanese standards).
The option
.Va RADIO_TEA5759
changes the algotithm of frequency calculation for the tea5757 based cards
to conform with the Japanese standards.
.Pp
For radio tuner controlling there is a single device file available:
.Pa /dev/radio .
.Pp
@ -186,9 +173,3 @@ The
.Nm
driver was written by Vladimir Popov and Maxim Tsyplakov.
The man page was written by Vladimir Popov.
.Sh BUGS
You can have only one card of the same type.
For example, if you have two aztech FM tuners, the first card with jumper
set to port 0x358 and the second one - to 0x350, you can use only one
aztech card (in the kernel, that is) either with port 0x350 or 0x358.
Don't even try to compile support for the second card into the kernel.

10
share/man/man4/rt.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: rt.4,v 1.3 2002/01/01 22:54:12 wiz Exp $
.\" $NetBSD: rt.4,v 1.4 2002/01/02 02:08:02 augustss Exp $
.\" $OpenBSD: rt.4,v 1.2 2001/12/05 11:27:44 mickey Exp $
.\" $RuOBSD: rt.4,v 1.3 2001/10/26 05:38:43 form Exp $
.\"
@ -32,10 +32,10 @@
.Nm rt
.Nd AIMS Lab Radiotrack FM radio device driver
.Sh SYNOPSIS
.Cd "rt* at isa? port 0x20c"
.Cd "rt* at isa? port 0x30c"
.Cd "rt* at isa? port 0x284"
.Cd "rt* at isa? port 0x384"
.Cd "rt0 at isa? port 0x20c"
.Cd "rt1 at isa? port 0x30c"
.Cd "rt2 at isa? port 0x284"
.Cd "rt3 at isa? port 0x384"
.Cd "radio* at rt?"
.Sh DESCRIPTION
The

17
share/man/man4/rtii.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: rtii.4,v 1.3 2002/01/01 22:54:12 wiz Exp $
.\" $NetBSD: rtii.4,v 1.4 2002/01/02 02:08:02 augustss Exp $
.\" $OpenBSD: rtii.4,v 1.2 2001/12/05 11:27:44 mickey Exp $
.\" $RuOBSD: rtii.4,v 1.3 2001/10/26 05:38:44 form Exp $
.\"
@ -32,8 +32,10 @@
.Nm rtii
.Nd AIMS Lab Radiotrack II FM radio device driver
.Sh SYNOPSIS
.Cd option RADIO_TEA5759
.Pp
.Cd "rtii0 at isa? port 0x20c"
.Cd "rtii0 at isa? port 0x30c"
.Cd "rtii1 at isa? port 0x30c"
.Cd "radio* at rtii0"
.Sh DESCRIPTION
The
@ -48,6 +50,17 @@ AFC.
The Radiotrack II cards take only one I/O port.
The I/O port is set by the driver to the value specified in the configuration
file and must be either 0x20c or 0x30c.
.Pp
Philips Semiconductors released two almost identical chips TEA5757 and
TEA5759.
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 (e.g. Japanese standards).
The option
.Va RADIO_TEA5759
changes the algotithm of frequency calculation for the tea5757 based cards
to conform with the Japanese standards.
.Sh SEE ALSO
.Xr isa 4 ,
.Xr radio 4

15
share/man/man4/sf2r.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: sf2r.4,v 1.3 2002/01/01 22:54:12 wiz Exp $
.\" $NetBSD: sf2r.4,v 1.4 2002/01/02 02:08:02 augustss Exp $
.\" $RuOBSD: sf2r.4,v 1.3 2001/10/26 05:38:44 form Exp $
.\" $OpenBSD: sf2r.4,v 1.2 2001/12/05 11:27:44 mickey Exp $
.\"
@ -32,6 +32,8 @@
.Nm sf2r
.Nd SoundForte RadioLink SF16-FMR2 FM radio device driver
.Sh SYNOPSIS
.Cd option RADIO_TEA5759
.Pp
.Cd "sf2r0 at isa? port 0x384"
.Cd "radio* at sf2r0"
.Sh DESCRIPTION
@ -47,6 +49,17 @@ AFC.
The SF16-FMR2 cards take only one I/O port.
The I/O port is set by the driver to the value specified in the configuration
file and must be 0x384.
.Pp
Philips Semiconductors released two almost identical chips TEA5757 and
TEA5759.
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 (e.g. Japanese standards).
The option
.Va RADIO_TEA5759
changes the algotithm of frequency calculation for the tea5757 based cards
to conform with the Japanese standards.
.Sh SEE ALSO
.Xr isa 4 ,
.Xr radio 4

30
share/man/man9/radio.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: radio.9,v 1.1 2002/01/01 22:09:42 augustss Exp $
.\" $NetBSD: radio.9,v 1.2 2002/01/02 02:08:03 augustss Exp $
.\" $OpenBSD: radio.9,v 1.2 2001/10/08 08:52:50 mpech Exp $
.\"
.\" Copyright (c) Maxim Tsyplakov <tm@oganer.net>
@ -39,9 +39,11 @@ The interface between these is the
structure.
.Bd -literal
struct radio_hw_if {
int *open(dev_t, int, int, struct proc *);
void *close(dev_t, int, int, struct proc *);
int *ioctl(dev_t, u_long, caddr_t, int, struct proc *);
int (*open)(void *, int, int, struct proc *);
int (*close)(void *, int, int, struct proc *);
int (*get_info)(void *, struct radio_info *);
int (*set_info)(void *, struct radio_info *);
int (*search)(void *, int);
};
.Ed
.Pp
@ -63,8 +65,7 @@ struct is as shown above.
The
.Va hdlp
argument is a handle to some low level data structure.
It is reserved field for future usage, and actually not used in any
low-level driver functions.
It is sent as the first argument to all the functions in
.Va radio_hw_if
when the high level driver calls them.
.Va dev
@ -74,16 +75,25 @@ The fields of
.Va radio_hw_if
are described in some more detail below.
.Bd -literal
int open (dev_t dev, int flags, int fmt, struct proc *p);
int open (void *, int flags, int fmt, struct proc *p);
Optional.
Is called when the radio device is opened.
Returns 0 on success, otherwise an error code.
int close (dev_t dev, int flags, int fmt, struct proc *p);
int close (void *, int flags, int fmt, struct proc *p);
Optional.
Is called when the radio device is closed.
Returns 0 on success, otherwise an error code.
int ioctl (dev_t dev, u_long cmd, caddr_t data, int flags, struct proc *p);
Is ioctl requests handler function.
int get_info (void *, struct radio_info *);
Fill the radio_info struct.
Returns 0 on success, otherwise an error code.
int set_info (void *, struct radio_info *);
Set values from the radio_info struct.
Returns 0 on success, otherwise an error code.
int search (void *, int);
Returns 0 on success, otherwise an error code.
.Ed
.Sh SEE ALSO