1*09c434b8SThomas Gleixner // SPDX-License-Identifier: GPL-2.0-only
21da177e4SLinus Torvalds /* Typhoon Radio Card driver for radio support
31da177e4SLinus Torvalds * (c) 1999 Dr. Henrik Seidel <Henrik.Seidel@gmx.de>
41da177e4SLinus Torvalds *
51da177e4SLinus Torvalds * Notes on the hardware
61da177e4SLinus Torvalds *
71da177e4SLinus Torvalds * This card has two output sockets, one for speakers and one for line.
81da177e4SLinus Torvalds * The speaker output has volume control, but only in four discrete
91da177e4SLinus Torvalds * steps. The line output has neither volume control nor mute.
101da177e4SLinus Torvalds *
111da177e4SLinus Torvalds * The card has auto-stereo according to its manual, although it all
121da177e4SLinus Torvalds * sounds mono to me (even with the Win/DOS drivers). Maybe it's my
131da177e4SLinus Torvalds * antenna - I really don't know for sure.
141da177e4SLinus Torvalds *
151da177e4SLinus Torvalds * Frequency control is done digitally.
161da177e4SLinus Torvalds *
171da177e4SLinus Torvalds * Volume control is done digitally, but there are only four different
181da177e4SLinus Torvalds * possible values. So you should better always turn the volume up and
191da177e4SLinus Torvalds * use line control. I got the best results by connecting line output
201da177e4SLinus Torvalds * to the sound card microphone input. For such a configuration the
211da177e4SLinus Torvalds * volume control has no effect, since volume control only influences
221da177e4SLinus Torvalds * the speaker output.
231da177e4SLinus Torvalds *
241da177e4SLinus Torvalds * There is no explicit mute/unmute. So I set the radio frequency to a
251da177e4SLinus Torvalds * value where I do expect just noise and turn the speaker volume down.
261da177e4SLinus Torvalds * The frequency change is necessary since the card never seems to be
271da177e4SLinus Torvalds * completely silent.
2830c48305SMauro Carvalho Chehab *
2932590819SMauro Carvalho Chehab * Converted to V4L2 API by Mauro Carvalho Chehab <mchehab@kernel.org>
301da177e4SLinus Torvalds */
311da177e4SLinus Torvalds
321da177e4SLinus Torvalds #include <linux/module.h> /* Modules */
331da177e4SLinus Torvalds #include <linux/init.h> /* Initdata */
34fb911ee8SPeter Osterlund #include <linux/ioport.h> /* request_region */
3530c48305SMauro Carvalho Chehab #include <linux/videodev2.h> /* kernel radio structs */
36f1bfe89bSHans Verkuil #include <linux/io.h> /* outb, outb_p */
379f1dfccfSHans Verkuil #include <linux/slab.h>
38f1bfe89bSHans Verkuil #include <media/v4l2-device.h>
3935ea11ffSHans Verkuil #include <media/v4l2-ioctl.h>
40da1ff351SHans Verkuil #include "radio-isa.h"
411da177e4SLinus Torvalds
4229834c1aSMauro Carvalho Chehab #define DRIVER_VERSION "0.1.2"
4329834c1aSMauro Carvalho Chehab
44f1bfe89bSHans Verkuil MODULE_AUTHOR("Dr. Henrik Seidel");
45f1bfe89bSHans Verkuil MODULE_DESCRIPTION("A driver for the Typhoon radio card (a.k.a. EcoRadio).");
46f1bfe89bSHans Verkuil MODULE_LICENSE("GPL");
47da1ff351SHans Verkuil MODULE_VERSION("0.1.99");
481da177e4SLinus Torvalds
491da177e4SLinus Torvalds #ifndef CONFIG_RADIO_TYPHOON_PORT
501da177e4SLinus Torvalds #define CONFIG_RADIO_TYPHOON_PORT -1
511da177e4SLinus Torvalds #endif
521da177e4SLinus Torvalds
531da177e4SLinus Torvalds #ifndef CONFIG_RADIO_TYPHOON_MUTEFREQ
54da1ff351SHans Verkuil #define CONFIG_RADIO_TYPHOON_MUTEFREQ 87000
551da177e4SLinus Torvalds #endif
561da177e4SLinus Torvalds
57da1ff351SHans Verkuil #define TYPHOON_MAX 2
581da177e4SLinus Torvalds
59da1ff351SHans Verkuil static int io[TYPHOON_MAX] = { [0] = CONFIG_RADIO_TYPHOON_PORT,
60da1ff351SHans Verkuil [1 ... (TYPHOON_MAX - 1)] = -1 };
61da1ff351SHans Verkuil static int radio_nr[TYPHOON_MAX] = { [0 ... (TYPHOON_MAX - 1)] = -1 };
62f1bfe89bSHans Verkuil static unsigned long mutefreq = CONFIG_RADIO_TYPHOON_MUTEFREQ;
63da1ff351SHans Verkuil
64da1ff351SHans Verkuil module_param_array(io, int, NULL, 0444);
65da1ff351SHans Verkuil MODULE_PARM_DESC(io, "I/O addresses of the Typhoon card (0x316 or 0x336)");
66da1ff351SHans Verkuil module_param_array(radio_nr, int, NULL, 0444);
67da1ff351SHans Verkuil MODULE_PARM_DESC(radio_nr, "Radio device numbers");
68f1bfe89bSHans Verkuil module_param(mutefreq, ulong, 0);
69f1bfe89bSHans Verkuil MODULE_PARM_DESC(mutefreq, "Frequency used when muting the card (in kHz)");
70f1bfe89bSHans Verkuil
71f1bfe89bSHans Verkuil struct typhoon {
72da1ff351SHans Verkuil struct radio_isa_card isa;
731da177e4SLinus Torvalds int muted;
741da177e4SLinus Torvalds };
751da177e4SLinus Torvalds
typhoon_alloc(void)76da1ff351SHans Verkuil static struct radio_isa_card *typhoon_alloc(void)
771da177e4SLinus Torvalds {
78da1ff351SHans Verkuil struct typhoon *ty = kzalloc(sizeof(*ty), GFP_KERNEL);
79da1ff351SHans Verkuil
80da1ff351SHans Verkuil return ty ? &ty->isa : NULL;
811da177e4SLinus Torvalds }
821da177e4SLinus Torvalds
typhoon_s_frequency(struct radio_isa_card * isa,u32 freq)83da1ff351SHans Verkuil static int typhoon_s_frequency(struct radio_isa_card *isa, u32 freq)
841da177e4SLinus Torvalds {
851da177e4SLinus Torvalds unsigned long outval;
861da177e4SLinus Torvalds unsigned long x;
871da177e4SLinus Torvalds
881da177e4SLinus Torvalds /*
891da177e4SLinus Torvalds * The frequency transfer curve is not linear. The best fit I could
901da177e4SLinus Torvalds * get is
911da177e4SLinus Torvalds *
921da177e4SLinus Torvalds * outval = -155 + exp((f + 15.55) * 0.057))
931da177e4SLinus Torvalds *
941da177e4SLinus Torvalds * where frequency f is in MHz. Since we don't have exp in the kernel,
951da177e4SLinus Torvalds * I approximate this function by a third order polynomial.
961da177e4SLinus Torvalds *
971da177e4SLinus Torvalds */
981da177e4SLinus Torvalds
99da1ff351SHans Verkuil x = freq / 160;
1001da177e4SLinus Torvalds outval = (x * x + 2500) / 5000;
1011da177e4SLinus Torvalds outval = (outval * x + 5000) / 10000;
1021da177e4SLinus Torvalds outval -= (10 * x * x + 10433) / 20866;
1031da177e4SLinus Torvalds outval += 4 * x - 11505;
1041da177e4SLinus Torvalds
105da1ff351SHans Verkuil outb_p((outval >> 8) & 0x01, isa->io + 4);
106da1ff351SHans Verkuil outb_p(outval >> 9, isa->io + 6);
107da1ff351SHans Verkuil outb_p(outval & 0xff, isa->io + 8);
1081da177e4SLinus Torvalds return 0;
1091da177e4SLinus Torvalds }
1101da177e4SLinus Torvalds
typhoon_s_mute_volume(struct radio_isa_card * isa,bool mute,int vol)111da1ff351SHans Verkuil static int typhoon_s_mute_volume(struct radio_isa_card *isa, bool mute, int vol)
1121da177e4SLinus Torvalds {
113da1ff351SHans Verkuil struct typhoon *ty = container_of(isa, struct typhoon, isa);
114da1ff351SHans Verkuil
115da1ff351SHans Verkuil if (mute)
116da1ff351SHans Verkuil vol = 0;
117da1ff351SHans Verkuil vol >>= 14; /* Map 16 bit to 2 bit */
118da1ff351SHans Verkuil vol &= 3;
119da1ff351SHans Verkuil outb_p(vol / 2, isa->io); /* Set the volume, high bit. */
120da1ff351SHans Verkuil outb_p(vol % 2, isa->io + 2); /* Set the volume, low bit. */
121da1ff351SHans Verkuil
122da1ff351SHans Verkuil if (vol == 0 && !ty->muted) {
123da1ff351SHans Verkuil ty->muted = true;
124da1ff351SHans Verkuil return typhoon_s_frequency(isa, mutefreq << 4);
125da1ff351SHans Verkuil }
126da1ff351SHans Verkuil if (vol && ty->muted) {
127da1ff351SHans Verkuil ty->muted = false;
128da1ff351SHans Verkuil return typhoon_s_frequency(isa, isa->freq);
129da1ff351SHans Verkuil }
1301da177e4SLinus Torvalds return 0;
1311da177e4SLinus Torvalds }
1321da177e4SLinus Torvalds
133da1ff351SHans Verkuil static const struct radio_isa_ops typhoon_ops = {
134da1ff351SHans Verkuil .alloc = typhoon_alloc,
135da1ff351SHans Verkuil .s_mute_volume = typhoon_s_mute_volume,
136da1ff351SHans Verkuil .s_frequency = typhoon_s_frequency,
1371da177e4SLinus Torvalds };
1381da177e4SLinus Torvalds
139da1ff351SHans Verkuil static const int typhoon_ioports[] = { 0x316, 0x336 };
140da1ff351SHans Verkuil
141da1ff351SHans Verkuil static struct radio_isa_driver typhoon_driver = {
142da1ff351SHans Verkuil .driver = {
143da1ff351SHans Verkuil .match = radio_isa_match,
144da1ff351SHans Verkuil .probe = radio_isa_probe,
145da1ff351SHans Verkuil .remove = radio_isa_remove,
146da1ff351SHans Verkuil .driver = {
147da1ff351SHans Verkuil .name = "radio-typhoon",
148da1ff351SHans Verkuil },
149da1ff351SHans Verkuil },
150da1ff351SHans Verkuil .io_params = io,
151da1ff351SHans Verkuil .radio_nr_params = radio_nr,
152da1ff351SHans Verkuil .io_ports = typhoon_ioports,
153da1ff351SHans Verkuil .num_of_io_ports = ARRAY_SIZE(typhoon_ioports),
154da1ff351SHans Verkuil .region_size = 8,
155da1ff351SHans Verkuil .card = "Typhoon Radio",
156da1ff351SHans Verkuil .ops = &typhoon_ops,
157da1ff351SHans Verkuil .has_stereo = true,
158da1ff351SHans Verkuil .max_volume = 3,
1591da177e4SLinus Torvalds };
1601da177e4SLinus Torvalds
typhoon_init(void)1611da177e4SLinus Torvalds static int __init typhoon_init(void)
1621da177e4SLinus Torvalds {
163da1ff351SHans Verkuil if (mutefreq < 87000 || mutefreq > 108000) {
164da1ff351SHans Verkuil printk(KERN_ERR "%s: You must set a frequency (in kHz) used when muting the card,\n",
165da1ff351SHans Verkuil typhoon_driver.driver.driver.name);
166da1ff351SHans Verkuil printk(KERN_ERR "%s: e.g. with \"mutefreq=87500\" (87000 <= mutefreq <= 108000)\n",
167da1ff351SHans Verkuil typhoon_driver.driver.driver.name);
168da1ff351SHans Verkuil return -ENODEV;
1691da177e4SLinus Torvalds }
170da1ff351SHans Verkuil return isa_register_driver(&typhoon_driver.driver, TYPHOON_MAX);
1711da177e4SLinus Torvalds }
1721da177e4SLinus Torvalds
typhoon_exit(void)173f1bfe89bSHans Verkuil static void __exit typhoon_exit(void)
1741da177e4SLinus Torvalds {
175da1ff351SHans Verkuil isa_unregister_driver(&typhoon_driver.driver);
1761da177e4SLinus Torvalds }
1771da177e4SLinus Torvalds
178da1ff351SHans Verkuil
1791da177e4SLinus Torvalds module_init(typhoon_init);
180f1bfe89bSHans Verkuil module_exit(typhoon_exit);
1811da177e4SLinus Torvalds
182