[media] radio-keene: support suspend/resume
[deliverable/linux.git] / drivers / media / radio / radio-isa.c
CommitLineData
137c579c
HV
1/*
2 * Framework for ISA radio drivers.
3 * This takes care of all the V4L2 scaffolding, allowing the ISA drivers
4 * to concentrate on the actual hardware operation.
5 *
6 * Copyright (C) 2012 Hans Verkuil <hans.verkuil@cisco.com>
7 *
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * version 2 as published by the Free Software Foundation.
11 *
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20 * 02110-1301 USA
21 */
22
23#include <linux/module.h>
24#include <linux/init.h>
25#include <linux/ioport.h>
26#include <linux/delay.h>
27#include <linux/videodev2.h>
28#include <linux/io.h>
9f1dfccf 29#include <linux/slab.h>
137c579c
HV
30#include <media/v4l2-device.h>
31#include <media/v4l2-ioctl.h>
32#include <media/v4l2-fh.h>
33#include <media/v4l2-ctrls.h>
34#include <media/v4l2-event.h>
35
36#include "radio-isa.h"
37
38MODULE_AUTHOR("Hans Verkuil");
39MODULE_DESCRIPTION("A framework for ISA radio drivers.");
40MODULE_LICENSE("GPL");
41
42#define FREQ_LOW (87U * 16000U)
43#define FREQ_HIGH (108U * 16000U)
44
45static int radio_isa_querycap(struct file *file, void *priv,
46 struct v4l2_capability *v)
47{
48 struct radio_isa_card *isa = video_drvdata(file);
49
50 strlcpy(v->driver, isa->drv->driver.driver.name, sizeof(v->driver));
51 strlcpy(v->card, isa->drv->card, sizeof(v->card));
52 snprintf(v->bus_info, sizeof(v->bus_info), "ISA:%s", isa->v4l2_dev.name);
53
54 v->capabilities = V4L2_CAP_TUNER | V4L2_CAP_RADIO;
55 v->device_caps = v->capabilities | V4L2_CAP_DEVICE_CAPS;
56 return 0;
57}
58
59static int radio_isa_g_tuner(struct file *file, void *priv,
60 struct v4l2_tuner *v)
61{
62 struct radio_isa_card *isa = video_drvdata(file);
63 const struct radio_isa_ops *ops = isa->drv->ops;
64
65 if (v->index > 0)
66 return -EINVAL;
67
68 strlcpy(v->name, "FM", sizeof(v->name));
69 v->type = V4L2_TUNER_RADIO;
70 v->rangelow = FREQ_LOW;
71 v->rangehigh = FREQ_HIGH;
72 v->capability = V4L2_TUNER_CAP_LOW;
73 if (isa->drv->has_stereo)
74 v->capability |= V4L2_TUNER_CAP_STEREO;
75
76 if (ops->g_rxsubchans)
77 v->rxsubchans = ops->g_rxsubchans(isa);
78 else
79 v->rxsubchans = V4L2_TUNER_SUB_MONO | V4L2_TUNER_SUB_STEREO;
80 v->audmode = isa->stereo ? V4L2_TUNER_MODE_STEREO : V4L2_TUNER_MODE_MONO;
81 if (ops->g_signal)
82 v->signal = ops->g_signal(isa);
83 else
84 v->signal = (v->rxsubchans & V4L2_TUNER_SUB_STEREO) ?
85 0xffff : 0;
86 return 0;
87}
88
89static int radio_isa_s_tuner(struct file *file, void *priv,
90 struct v4l2_tuner *v)
91{
92 struct radio_isa_card *isa = video_drvdata(file);
93 const struct radio_isa_ops *ops = isa->drv->ops;
94
95 if (v->index)
96 return -EINVAL;
97 if (ops->s_stereo) {
98 isa->stereo = (v->audmode == V4L2_TUNER_MODE_STEREO);
99 return ops->s_stereo(isa, isa->stereo);
100 }
101 return 0;
102}
103
104static int radio_isa_s_frequency(struct file *file, void *priv,
105 struct v4l2_frequency *f)
106{
107 struct radio_isa_card *isa = video_drvdata(file);
108 int res;
109
110 if (f->tuner != 0 || f->type != V4L2_TUNER_RADIO)
111 return -EINVAL;
112 f->frequency = clamp(f->frequency, FREQ_LOW, FREQ_HIGH);
113 res = isa->drv->ops->s_frequency(isa, f->frequency);
114 if (res == 0)
115 isa->freq = f->frequency;
116 return res;
117}
118
119static int radio_isa_g_frequency(struct file *file, void *priv,
120 struct v4l2_frequency *f)
121{
122 struct radio_isa_card *isa = video_drvdata(file);
123
124 if (f->tuner != 0)
125 return -EINVAL;
126 f->type = V4L2_TUNER_RADIO;
127 f->frequency = isa->freq;
128 return 0;
129}
130
131static int radio_isa_s_ctrl(struct v4l2_ctrl *ctrl)
132{
133 struct radio_isa_card *isa =
134 container_of(ctrl->handler, struct radio_isa_card, hdl);
135
136 switch (ctrl->id) {
137 case V4L2_CID_AUDIO_MUTE:
138 return isa->drv->ops->s_mute_volume(isa, ctrl->val,
139 isa->volume ? isa->volume->val : 0);
140 }
141 return -EINVAL;
142}
143
144static int radio_isa_log_status(struct file *file, void *priv)
145{
146 struct radio_isa_card *isa = video_drvdata(file);
147
148 v4l2_info(&isa->v4l2_dev, "I/O Port = 0x%03x\n", isa->io);
149 v4l2_ctrl_handler_log_status(&isa->hdl, isa->v4l2_dev.name);
150 return 0;
151}
152
153static int radio_isa_subscribe_event(struct v4l2_fh *fh,
154 struct v4l2_event_subscription *sub)
155{
156 if (sub->type == V4L2_EVENT_CTRL)
157 return v4l2_event_subscribe(fh, sub, 0);
158 return -EINVAL;
159}
160
161static const struct v4l2_ctrl_ops radio_isa_ctrl_ops = {
162 .s_ctrl = radio_isa_s_ctrl,
163};
164
165static const struct v4l2_file_operations radio_isa_fops = {
166 .owner = THIS_MODULE,
167 .open = v4l2_fh_open,
168 .release = v4l2_fh_release,
169 .poll = v4l2_ctrl_poll,
170 .unlocked_ioctl = video_ioctl2,
171};
172
173static const struct v4l2_ioctl_ops radio_isa_ioctl_ops = {
174 .vidioc_querycap = radio_isa_querycap,
175 .vidioc_g_tuner = radio_isa_g_tuner,
176 .vidioc_s_tuner = radio_isa_s_tuner,
177 .vidioc_g_frequency = radio_isa_g_frequency,
178 .vidioc_s_frequency = radio_isa_s_frequency,
179 .vidioc_log_status = radio_isa_log_status,
180 .vidioc_subscribe_event = radio_isa_subscribe_event,
181 .vidioc_unsubscribe_event = v4l2_event_unsubscribe,
182};
183
184int radio_isa_match(struct device *pdev, unsigned int dev)
185{
186 struct radio_isa_driver *drv = pdev->platform_data;
187
188 return drv->probe || drv->io_params[dev] >= 0;
189}
190EXPORT_SYMBOL_GPL(radio_isa_match);
191
192static bool radio_isa_valid_io(const struct radio_isa_driver *drv, int io)
193{
194 int i;
195
196 for (i = 0; i < drv->num_of_io_ports; i++)
197 if (drv->io_ports[i] == io)
198 return true;
199 return false;
200}
201
865d7ec9
OZ
202struct radio_isa_card *radio_isa_alloc(struct radio_isa_driver *drv,
203 struct device *pdev)
137c579c 204{
137c579c 205 struct v4l2_device *v4l2_dev;
865d7ec9
OZ
206 struct radio_isa_card *isa = drv->ops->alloc();
207 if (!isa)
208 return NULL;
137c579c 209
137c579c
HV
210 dev_set_drvdata(pdev, isa);
211 isa->drv = drv;
137c579c
HV
212 v4l2_dev = &isa->v4l2_dev;
213 strlcpy(v4l2_dev->name, dev_name(pdev), sizeof(v4l2_dev->name));
214
865d7ec9
OZ
215 return isa;
216}
137c579c 217
865d7ec9
OZ
218int radio_isa_common_probe(struct radio_isa_card *isa, struct device *pdev,
219 int radio_nr, unsigned region_size)
220{
221 const struct radio_isa_driver *drv = isa->drv;
222 const struct radio_isa_ops *ops = drv->ops;
223 struct v4l2_device *v4l2_dev = &isa->v4l2_dev;
224 int res;
137c579c 225
865d7ec9 226 if (!request_region(isa->io, region_size, v4l2_dev->name)) {
137c579c
HV
227 v4l2_err(v4l2_dev, "port 0x%x already in use\n", isa->io);
228 kfree(isa);
229 return -EBUSY;
230 }
231
232 res = v4l2_device_register(pdev, v4l2_dev);
233 if (res < 0) {
234 v4l2_err(v4l2_dev, "Could not register v4l2_device\n");
235 goto err_dev_reg;
236 }
237
238 v4l2_ctrl_handler_init(&isa->hdl, 1);
239 isa->mute = v4l2_ctrl_new_std(&isa->hdl, &radio_isa_ctrl_ops,
240 V4L2_CID_AUDIO_MUTE, 0, 1, 1, 1);
241 if (drv->max_volume)
242 isa->volume = v4l2_ctrl_new_std(&isa->hdl, &radio_isa_ctrl_ops,
243 V4L2_CID_AUDIO_VOLUME, 0, drv->max_volume, 1,
244 drv->max_volume);
245 v4l2_dev->ctrl_handler = &isa->hdl;
246 if (isa->hdl.error) {
247 res = isa->hdl.error;
248 v4l2_err(v4l2_dev, "Could not register controls\n");
249 goto err_hdl;
250 }
251 if (drv->max_volume)
252 v4l2_ctrl_cluster(2, &isa->mute);
253 v4l2_dev->ctrl_handler = &isa->hdl;
254
255 mutex_init(&isa->lock);
256 isa->vdev.lock = &isa->lock;
257 strlcpy(isa->vdev.name, v4l2_dev->name, sizeof(isa->vdev.name));
258 isa->vdev.v4l2_dev = v4l2_dev;
259 isa->vdev.fops = &radio_isa_fops;
260 isa->vdev.ioctl_ops = &radio_isa_ioctl_ops;
261 isa->vdev.release = video_device_release_empty;
262 set_bit(V4L2_FL_USE_FH_PRIO, &isa->vdev.flags);
263 video_set_drvdata(&isa->vdev, isa);
264 isa->freq = FREQ_LOW;
265 isa->stereo = drv->has_stereo;
266
267 if (ops->init)
268 res = ops->init(isa);
269 if (!res)
270 res = v4l2_ctrl_handler_setup(&isa->hdl);
271 if (!res)
272 res = ops->s_frequency(isa, isa->freq);
273 if (!res && ops->s_stereo)
274 res = ops->s_stereo(isa, isa->stereo);
275 if (res < 0) {
276 v4l2_err(v4l2_dev, "Could not setup card\n");
277 goto err_node_reg;
278 }
865d7ec9
OZ
279 res = video_register_device(&isa->vdev, VFL_TYPE_RADIO, radio_nr);
280
137c579c
HV
281 if (res < 0) {
282 v4l2_err(v4l2_dev, "Could not register device node\n");
283 goto err_node_reg;
284 }
285
286 v4l2_info(v4l2_dev, "Initialized radio card %s on port 0x%03x\n",
287 drv->card, isa->io);
288 return 0;
289
290err_node_reg:
291 v4l2_ctrl_handler_free(&isa->hdl);
292err_hdl:
293 v4l2_device_unregister(&isa->v4l2_dev);
294err_dev_reg:
865d7ec9 295 release_region(isa->io, region_size);
137c579c
HV
296 kfree(isa);
297 return res;
298}
137c579c 299
865d7ec9 300int radio_isa_common_remove(struct radio_isa_card *isa, unsigned region_size)
137c579c 301{
137c579c
HV
302 const struct radio_isa_ops *ops = isa->drv->ops;
303
304 ops->s_mute_volume(isa, true, isa->volume ? isa->volume->cur.val : 0);
305 video_unregister_device(&isa->vdev);
306 v4l2_ctrl_handler_free(&isa->hdl);
307 v4l2_device_unregister(&isa->v4l2_dev);
865d7ec9 308 release_region(isa->io, region_size);
137c579c
HV
309 v4l2_info(&isa->v4l2_dev, "Removed radio card %s\n", isa->drv->card);
310 kfree(isa);
311 return 0;
312}
865d7ec9
OZ
313
314int radio_isa_probe(struct device *pdev, unsigned int dev)
315{
316 struct radio_isa_driver *drv = pdev->platform_data;
317 const struct radio_isa_ops *ops = drv->ops;
318 struct v4l2_device *v4l2_dev;
319 struct radio_isa_card *isa;
320
321 isa = radio_isa_alloc(drv, pdev);
322 if (!isa)
323 return -ENOMEM;
324 isa->io = drv->io_params[dev];
325 v4l2_dev = &isa->v4l2_dev;
326
327 if (drv->probe && ops->probe) {
328 int i;
329
330 for (i = 0; i < drv->num_of_io_ports; ++i) {
331 int io = drv->io_ports[i];
332
333 if (request_region(io, drv->region_size, v4l2_dev->name)) {
334 bool found = ops->probe(isa, io);
335
336 release_region(io, drv->region_size);
337 if (found) {
338 isa->io = io;
339 break;
340 }
341 }
342 }
343 }
344
345 if (!radio_isa_valid_io(drv, isa->io)) {
346 int i;
347
348 if (isa->io < 0)
349 return -ENODEV;
350 v4l2_err(v4l2_dev, "you must set an I/O address with io=0x%03x",
351 drv->io_ports[0]);
352 for (i = 1; i < drv->num_of_io_ports; i++)
353 printk(KERN_CONT "/0x%03x", drv->io_ports[i]);
354 printk(KERN_CONT ".\n");
355 kfree(isa);
356 return -EINVAL;
357 }
358
359 return radio_isa_common_probe(isa, pdev, drv->radio_nr_params[dev],
360 drv->region_size);
361}
362EXPORT_SYMBOL_GPL(radio_isa_probe);
363
364int radio_isa_remove(struct device *pdev, unsigned int dev)
365{
366 struct radio_isa_card *isa = dev_get_drvdata(pdev);
367
368 return radio_isa_common_remove(isa, isa->drv->region_size);
369}
137c579c 370EXPORT_SYMBOL_GPL(radio_isa_remove);
865d7ec9
OZ
371
372#ifdef CONFIG_PNP
373int radio_isa_pnp_probe(struct pnp_dev *dev, const struct pnp_device_id *dev_id)
374{
375 struct pnp_driver *pnp_drv = to_pnp_driver(dev->dev.driver);
376 struct radio_isa_driver *drv = container_of(pnp_drv,
377 struct radio_isa_driver, pnp_driver);
378 struct radio_isa_card *isa;
379
380 if (!pnp_port_valid(dev, 0))
381 return -ENODEV;
382
383 isa = radio_isa_alloc(drv, &dev->dev);
384 if (!isa)
385 return -ENOMEM;
386
387 isa->io = pnp_port_start(dev, 0);
388
389 return radio_isa_common_probe(isa, &dev->dev, drv->radio_nr_params[0],
390 pnp_port_len(dev, 0));
391}
392EXPORT_SYMBOL_GPL(radio_isa_pnp_probe);
393
394void radio_isa_pnp_remove(struct pnp_dev *dev)
395{
396 struct radio_isa_card *isa = dev_get_drvdata(&dev->dev);
397
398 radio_isa_common_remove(isa, pnp_port_len(dev, 0));
399}
400EXPORT_SYMBOL_GPL(radio_isa_pnp_remove);
401#endif
This page took 0.065414 seconds and 5 git commands to generate.