radio-aztech.c

  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * radio-aztech.c - Aztech radio card driver
  4 *
  5 * Converted to the radio-isa framework by Hans Verkuil <hverkuil@kernel.org>
  6 * Converted to V4L2 API by Mauro Carvalho Chehab <mchehab@kernel.org>
  7 * Adapted to support the Video for Linux API by
  8 * Russell Kroll <rkroll@exploits.org>.  Based on original tuner code by:
  9 *
 10 * Quay Ly
 11 * Donald Song
 12 * Jason Lewis      (jlewis@twilight.vtc.vsc.edu)
 13 * Scott McGrath    (smcgrath@twilight.vtc.vsc.edu)
 14 * William McGrath  (wmcgrath@twilight.vtc.vsc.edu)
 15 *
 16 * Fully tested with the Keene USB FM Transmitter and the v4l2-compliance tool.
 17*/
 18
 19#include <linux/module.h>	/* Modules			*/
 20#include <linux/init.h>		/* Initdata			*/
 21#include <linux/ioport.h>	/* request_region		*/
 22#include <linux/delay.h>	/* udelay			*/
 23#include <linux/videodev2.h>	/* kernel radio structs		*/
 24#include <linux/io.h>		/* outb, outb_p			*/
 25#include <linux/slab.h>
 26#include <media/v4l2-device.h>
 27#include <media/v4l2-ioctl.h>
 28#include <media/v4l2-ctrls.h>
 29#include "radio-isa.h"
 30#include "lm7000.h"
 31
 32MODULE_AUTHOR("Russell Kroll, Quay Lu, Donald Song, Jason Lewis, Scott McGrath, William McGrath");
 33MODULE_DESCRIPTION("A driver for the Aztech radio card.");
 34MODULE_LICENSE("GPL");
 35MODULE_VERSION("1.0.0");
 36
 37/* acceptable ports: 0x350 (JP3 shorted), 0x358 (JP3 open) */
 38#ifndef CONFIG_RADIO_AZTECH_PORT
 39#define CONFIG_RADIO_AZTECH_PORT -1
 40#endif
 41
 42#define AZTECH_MAX 2
 43
 44static int io[AZTECH_MAX] = { [0] = CONFIG_RADIO_AZTECH_PORT,
 45			      [1 ... (AZTECH_MAX - 1)] = -1 };
 46static int radio_nr[AZTECH_MAX]	= { [0 ... (AZTECH_MAX - 1)] = -1 };
 47
 48module_param_array(io, int, NULL, 0444);
 49MODULE_PARM_DESC(io, "I/O addresses of the Aztech card (0x350 or 0x358)");
 50module_param_array(radio_nr, int, NULL, 0444);
 51MODULE_PARM_DESC(radio_nr, "Radio device numbers");
 52
 53struct aztech {
 54	struct radio_isa_card isa;
 55	int curvol;
 56};
 57
 58/* bit definitions for register read */
 59#define AZTECH_BIT_NOT_TUNED	(1 << 0)
 60#define AZTECH_BIT_MONO		(1 << 1)
 61/* bit definitions for register write */
 62#define AZTECH_BIT_TUN_CE	(1 << 1)
 63#define AZTECH_BIT_TUN_CLK	(1 << 6)
 64#define AZTECH_BIT_TUN_DATA	(1 << 7)
 65/* bits 0 and 2 are volume control, bits 3..5 are not connected */
 66
 67static void aztech_set_pins(void *handle, u8 pins)
 68{
 69	struct radio_isa_card *isa = handle;
 70	struct aztech *az = container_of(isa, struct aztech, isa);
 71	u8 bits = az->curvol;
 72
 73	if (pins & LM7000_DATA)
 74		bits |= AZTECH_BIT_TUN_DATA;
 75	if (pins & LM7000_CLK)
 76		bits |= AZTECH_BIT_TUN_CLK;
 77	if (pins & LM7000_CE)
 78		bits |= AZTECH_BIT_TUN_CE;
 79
 80	outb_p(bits, az->isa.io);
 81}
 82
 83static struct radio_isa_card *aztech_alloc(void)
 84{
 85	struct aztech *az = kzalloc(sizeof(*az), GFP_KERNEL);
 86
 87	return az ? &az->isa : NULL;
 88}
 89
 90static int aztech_s_frequency(struct radio_isa_card *isa, u32 freq)
 91{
 92	lm7000_set_freq(freq, isa, aztech_set_pins);
 93
 94	return 0;
 95}
 96
 97static u32 aztech_g_rxsubchans(struct radio_isa_card *isa)
 98{
 99	if (inb(isa->io) & AZTECH_BIT_MONO)
100		return V4L2_TUNER_SUB_MONO;
101	return V4L2_TUNER_SUB_STEREO;
102}
103
104static u32 aztech_g_signal(struct radio_isa_card *isa)
105{
106	return (inb(isa->io) & AZTECH_BIT_NOT_TUNED) ? 0 : 0xffff;
107}
108
109static int aztech_s_mute_volume(struct radio_isa_card *isa, bool mute, int vol)
110{
111	struct aztech *az = container_of(isa, struct aztech, isa);
112
113	if (mute)
114		vol = 0;
115	az->curvol = (vol & 1) + ((vol & 2) << 1);
116	outb(az->curvol, isa->io);
117	return 0;
118}
119
120static const struct radio_isa_ops aztech_ops = {
121	.alloc = aztech_alloc,
122	.s_mute_volume = aztech_s_mute_volume,
123	.s_frequency = aztech_s_frequency,
124	.g_rxsubchans = aztech_g_rxsubchans,
125	.g_signal = aztech_g_signal,
126};
127
128static const int aztech_ioports[] = { 0x350, 0x358 };
129
130static struct radio_isa_driver aztech_driver = {
131	.driver = {
132		.match		= radio_isa_match,
133		.probe		= radio_isa_probe,
134		.remove		= radio_isa_remove,
135		.driver		= {
136			.name	= "radio-aztech",
137		},
138	},
139	.io_params = io,
140	.radio_nr_params = radio_nr,
141	.io_ports = aztech_ioports,
142	.num_of_io_ports = ARRAY_SIZE(aztech_ioports),
143	.region_size = 8,
144	.card = "Aztech Radio",
145	.ops = &aztech_ops,
146	.has_stereo = true,
147	.max_volume = 3,
148};
149
150static int __init aztech_init(void)
151{
152	return isa_register_driver(&aztech_driver.driver, AZTECH_MAX);
153}
154
155static void __exit aztech_exit(void)
156{
157	isa_unregister_driver(&aztech_driver.driver);
158}
159
160module_init(aztech_init);
161module_exit(aztech_exit);