update w/ chipset descriptions and config flags vs option; from Vladimir Popov <jumbo@narod.ru>

7 files changed, 87 insertions, 31 deletions

diff --git a/share/man/man4/az.4 b/share/man/man4/az.4
index 441ab56c8a9..5e410d0b596 100644
--- a/share/man/man4/az.4
+++ b/share/man/man4/az.4
@@ -1,5 +1,5 @@
 .\"	$RuOBSD: az.4,v 1.3 2001/10/26 05:38:43 form Exp $
-.\"	$OpenBSD: az.4,v 1.2 2002/01/04 17:14:51 mickey Exp $
+.\"	$OpenBSD: az.4,v 1.3 2002/01/07 18:37:45 mickey Exp $
 .\"
 .\" Copyright (c) 2001 Vladimir Popov
 .\" All rights reserved.
@@ -44,6 +44,10 @@ in the 87.5-108.0 MHz range.
 It is capable to report signal status (tuned/not tuned, stereo/mono signal)
 and force audio output to mono.
 .Pp
+The card is based on the LM7001 chip, see
+.Xr radio 4
+for details.
+.Pp
 The Aztech cards use only one I/O port.
 The I/O port is set by the driver to the value specified in the configuration
 file.
@@ -65,7 +69,7 @@ driver was written by
 and
 .An Maxim Tsyplakov Aq tm@oganer.net .
 The man page was written by
-.An Maxim Tsyplakov Aq tm@oganer.net .
+.An Vladimir Popov Aq jumbo@narod.ru .
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/mr.4 b/share/man/man4/mr.4
index 02e5c500f73..56a9ffa612d 100644
--- a/share/man/man4/mr.4
+++ b/share/man/man4/mr.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mr.4,v 1.3 2002/01/04 17:14:51 mickey Exp $
+.\"	$OpenBSD: mr.4,v 1.4 2002/01/07 18:37:45 mickey Exp $
 .\"	$RuOBSD: mr.4,v 1.3 2001/10/26 05:38:43 form Exp $
 .\"
 .\" Copyright (c) 2001 Vladimir Popov <jumbo@narod.ru>
@@ -31,7 +31,7 @@
 .Nm mr
 .Nd Guillemot Maxi Radio FM 2000 FM radio device driver
 .Sh SYNOPSIS
-.Cd "mr*   at pci?"
+.Cd "mr*   at pci? flags 0x00"
 .Cd "radio* at mr?"
 .Sh DESCRIPTION
 The
@@ -42,6 +42,13 @@ The Maxi Radio cards are stereo FM tuners that allow to tune in the range
 87.5 - 108.0 MHz, report signal status on the current frequency, force
 audio output to mono, perform hardware signal search, and have an internal
 AFC.
+.Pp
+The card is based on the TEA5757 chip, see
+.Xr radio 4
+for details.
+.Pp
+The flags control the driver behavior. For example, with flags 0x01 the driver
+will assume that there is a TEA5759 chip is used.
 .Sh SEE ALSO
 .Xr pci 4 ,
 .Xr radio 4 ,
@@ -54,7 +61,7 @@ driver was written by
 and
 .An Maxim Tsyplakov Aq tm@oganer.net .
 The man page was written by
-.An Maxim Tsyplakov Aq tm@oganer.net .
+.An Vladimir Popov Aq jumbo@narod.ru .
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/radio.4 b/share/man/man4/radio.4
index e4d739300e1..ca0affdd819 100644
--- a/share/man/man4/radio.4
+++ b/share/man/man4/radio.4
@@ -1,5 +1,5 @@
 .\"	$RuOBSD: radio.4,v 1.4 2001/10/26 05:38:43 form Exp $
-.\"	$OpenBSD: radio.4,v 1.4 2002/01/04 17:14:51 mickey Exp $
+.\"	$OpenBSD: radio.4,v 1.5 2002/01/07 18:37:45 mickey Exp $
 .\"
 .\" Copyright (c) 2001 Vladimir Popov
 .\" All rights reserved.
@@ -31,7 +31,6 @@
 .Nm radio
 .Nd device-independent radio driver layer
 .Sh SYNOPSIS
-.Cd option RADIO_TEA5759
 .Pp
 .Cd "radio* at az0"
 .Cd "radio* at mr0"
@@ -50,17 +49,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
@@ -162,6 +150,38 @@ Informs whether the device receives a valid signal or noise.
 Informs whether the device receives a stereo or mono signal.
 .El
 .El
+.Sh CHIPSETS
+.Pp
+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
+.Xr az 4
+and
+.Xr rt 4
+cards.
+.Pp
+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 (e.g. Japanese standards).
+To conform with the Japanese standards it is needed to set the flags least
+significant bit to 1.
+The TEA5757; TEA5759 has a 25-bit read-write shift register.
+The TEA5757 chips are used in
+.Xr mr 4 ,
+.Xr rtii 4 ,
+.Xr sf2r 4
+and
+.Xr sf4r 4
+cards.
 .Sh FILES
 .Bl -tag -width /dev/radio -compact
 .It Pa /dev/radio
@@ -189,7 +209,7 @@ driver was written by
 and
 .An Maxim Tsyplakov Aq tm@oganer.net .
 The man page was written by
-.An Maxim Tsyplakov Aq tm@oganer.net .
+.An Vladimir Popov Aq jumbo@narod.ru .
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/rt.4 b/share/man/man4/rt.4
index c827ddf1da2..a364cb1607d 100644
--- a/share/man/man4/rt.4
+++ b/share/man/man4/rt.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: rt.4,v 1.3 2002/01/04 17:14:51 mickey Exp $
+.\"	$OpenBSD: rt.4,v 1.4 2002/01/07 18:37:45 mickey Exp $
 .\"	$RuOBSD: rt.4,v 1.3 2001/10/26 05:38:43 form Exp $
 .\"
 .\" Copyright (c) 2001 Vladimir Popov <jumbo@narod.ru>
@@ -46,6 +46,10 @@ The Radiotrack is a stereo FM tuner that allows to tune in the range
 87.5 - 108.0 MHz, report signal status on the current frequency, and
 force audio output to mono.
 .Pp
+The card is based on the LM7000 chip, see
+.Xr radio 4
+for details.
+.Pp
 The Radiotrack 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.
@@ -64,7 +68,7 @@ driver was written by
 and
 .An Maxim Tsyplakov Aq tm@oganer.net .
 The man page was written by
-.An Maxim Tsyplakov Aq tm@oganer.net .
+.An Vladimir Popov Aq jumbo@narod.ru .
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/rtii.4 b/share/man/man4/rtii.4
index 20a046defbc..c51eb2783d5 100644
--- a/share/man/man4/rtii.4
+++ b/share/man/man4/rtii.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: rtii.4,v 1.3 2002/01/04 17:14:51 mickey Exp $
+.\"	$OpenBSD: rtii.4,v 1.4 2002/01/07 18:37:45 mickey Exp $
 .\"	$RuOBSD: rtii.4,v 1.3 2001/10/26 05:38:44 form Exp $
 .\"
 .\" Copyright (c) 2001 Vladimir Popov <jumbo@narod.ru>
@@ -31,8 +31,8 @@
 .Nm rtii
 .Nd AIMS Lab Radiotrack II FM radio device driver
 .Sh SYNOPSIS
-.Cd "rtii0   at isa? port 0x20c"
-.Cd "rtii0   at isa? port 0x30c"
+.Cd "rtii0   at isa? port 0x20c flags 0x00"
+.Cd "rtii0   at isa? port 0x30c flags 0x00"
 .Cd "radio* at rtii0"
 .Sh DESCRIPTION
 The
@@ -44,9 +44,16 @@ The Radiotrack II is a stereo FM tuner that allows to tune in the range
 audio output to mono, perform hardware signal search, and has an internal
 AFC.
 .Pp
+The card is based on the TEA5757 chip, see
+.Xr radio 4
+for details.
+.Pp
 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
+The flags control the driver behavior. For example, with flags 0x01 the driver
+will assume that there is a TEA5759 chip is used.
 .Sh SEE ALSO
 .Xr isa 4 ,
 .Xr radio 4 ,
@@ -59,7 +66,7 @@ driver was written by
 and
 .An Maxim Tsyplakov Aq tm@oganer.net .
 The man page was written by
-.An Maxim Tsyplakov Aq tm@oganer.net .
+.An Vladimir Popov Aq jumbo@narod.ru .
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/sf2r.4 b/share/man/man4/sf2r.4
index 5bc8e101df1..1a92ec420d7 100644
--- a/share/man/man4/sf2r.4
+++ b/share/man/man4/sf2r.4
@@ -1,5 +1,5 @@
 .\"	$RuOBSD: sf2r.4,v 1.3 2001/10/26 05:38:44 form Exp $
-.\"	$OpenBSD: sf2r.4,v 1.3 2002/01/04 17:14:51 mickey Exp $
+.\"	$OpenBSD: sf2r.4,v 1.4 2002/01/07 18:37:45 mickey Exp $
 .\"
 .\" Copyright (c) 2001 Vladimir Popov
 .\" All rights reserved.
@@ -31,7 +31,7 @@
 .Nm sf2r
 .Nd SoundForte RadioLink SF16-FMR2 FM radio device driver
 .Sh SYNOPSIS
-.Cd "sf2r0   at isa? port 0x384"
+.Cd "sf2r0   at isa? port 0x384 flags 0x00"
 .Cd "radio* at sf2r0"
 .Sh DESCRIPTION
 The
@@ -43,9 +43,16 @@ The SF16-FMR2 is a stereo FM tuner that allows to tune in the range
 audio output to mono, perform hardware signal search, and has an internal
 AFC.
 .Pp
+The card is based on the TEA5757 chip, see
+.Xr radio 4
+for details.
+.Pp
 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
+The flags control the driver behavior. For example, with flags 0x01 the driver
+will assume that there is a TEA5759 chip is used.
 .Sh BUGS
 MediaForte made two variants of the SF16-FMR2 cards, the first one has
 an internal amplifier of the output sound, the second one does not have
@@ -63,7 +70,7 @@ driver was written by
 and
 .An Maxim Tsyplakov Aq tm@oganer.net .
 The man page was written by
-.An Maxim Tsyplakov Aq tm@oganer.net .
+.An Vladimir Popov Aq jumbo@narod.ru .
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man4/sf4r.4 b/share/man/man4/sf4r.4
index 4ece21528ef..07d3a8ce7d0 100644
--- a/share/man/man4/sf4r.4
+++ b/share/man/man4/sf4r.4
@@ -1,5 +1,5 @@
 .\"	$RuOBSD: sf4r.4,v 1.3 2001/10/26 05:38:44 form Exp $
-.\"	$OpenBSD: sf4r.4,v 1.2 2002/01/04 17:14:51 mickey Exp $
+.\"	$OpenBSD: sf4r.4,v 1.3 2002/01/07 18:37:45 mickey Exp $
 .\"
 .\" Copyright (c) 2001 Vladimir Popov
 .\" All rights reserved.
@@ -31,7 +31,7 @@
 .Nm sf4r
 .Nd SoundForte RadioLink SF64-PCR FM radio device driver
 .Sh SYNOPSIS
-.Cd "sf4r0   at pci?"
+.Cd "sf4r0   at pci? flags 0x00"
 .Cd "radio* at sf4r0"
 .Sh DESCRIPTION
 The
@@ -42,6 +42,13 @@ The SF64-PCR cards are stereo FM tuners that allow to tune in the range
 87.5 - 108.0 MHz, report signal status on the current frequency, force
 audio output to mono, perform hardware signal search, and have an internal
 AFC.
+.Pp
+The card is based on the TEA5757 chip, see
+.Xr radio 4
+for details.
+.Pp
+The flags control the driver behavior. For example, with flags 0x01 the driver
+will assume that there is a TEA5759 chip is used.
 .Sh BUGS
 Because MediaForte put FM801 on the board, the current driver cannot
 distinguish sound cards based on FM801 and SF64-PCR.
@@ -57,7 +64,7 @@ driver was written by
 and
 .An Maxim Tsyplakov Aq tm@oganer.net .
 The man page was written by
-.An Maxim Tsyplakov Aq tm@oganer.net .
+.An Vladimir Popov Aq jumbo@narod.ru .
 .Sh HISTORY
 The
 .Nm