radio-isa.c 9.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341
  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. #include <linux/module.h>
  23. #include <linux/init.h>
  24. #include <linux/ioport.h>
  25. #include <linux/delay.h>
  26. #include <linux/videodev2.h>
  27. #include <linux/io.h>
  28. #include <linux/slab.h>
  29. #include <media/v4l2-device.h>
  30. #include <media/v4l2-ioctl.h>
  31. #include <media/v4l2-fh.h>
  32. #include <media/v4l2-ctrls.h>
  33. #include <media/v4l2-event.h>
  34. #include "radio-isa.h"
  35. MODULE_AUTHOR("Hans Verkuil");
  36. MODULE_DESCRIPTION("A framework for ISA radio drivers.");
  37. MODULE_LICENSE("GPL");
  38. #define FREQ_LOW (87U * 16000U)
  39. #define FREQ_HIGH (108U * 16000U)
  40. static int radio_isa_querycap(struct file *file, void *priv,
  41. struct v4l2_capability *v)
  42. {
  43. struct radio_isa_card *isa = video_drvdata(file);
  44. strlcpy(v->driver, isa->drv->driver.driver.name, sizeof(v->driver));
  45. strlcpy(v->card, isa->drv->card, sizeof(v->card));
  46. snprintf(v->bus_info, sizeof(v->bus_info), "ISA:%s", isa->v4l2_dev.name);
  47. v->capabilities = V4L2_CAP_TUNER | V4L2_CAP_RADIO;
  48. v->device_caps = v->capabilities | V4L2_CAP_DEVICE_CAPS;
  49. return 0;
  50. }
  51. static int radio_isa_g_tuner(struct file *file, void *priv,
  52. struct v4l2_tuner *v)
  53. {
  54. struct radio_isa_card *isa = video_drvdata(file);
  55. const struct radio_isa_ops *ops = isa->drv->ops;
  56. if (v->index > 0)
  57. return -EINVAL;
  58. strlcpy(v->name, "FM", sizeof(v->name));
  59. v->type = V4L2_TUNER_RADIO;
  60. v->rangelow = FREQ_LOW;
  61. v->rangehigh = FREQ_HIGH;
  62. v->capability = V4L2_TUNER_CAP_LOW;
  63. if (isa->drv->has_stereo)
  64. v->capability |= V4L2_TUNER_CAP_STEREO;
  65. if (ops->g_rxsubchans)
  66. v->rxsubchans = ops->g_rxsubchans(isa);
  67. else
  68. v->rxsubchans = V4L2_TUNER_SUB_MONO | V4L2_TUNER_SUB_STEREO;
  69. v->audmode = isa->stereo ? V4L2_TUNER_MODE_STEREO : V4L2_TUNER_MODE_MONO;
  70. if (ops->g_signal)
  71. v->signal = ops->g_signal(isa);
  72. else
  73. v->signal = (v->rxsubchans & V4L2_TUNER_SUB_STEREO) ?
  74. 0xffff : 0;
  75. return 0;
  76. }
  77. static int radio_isa_s_tuner(struct file *file, void *priv,
  78. struct v4l2_tuner *v)
  79. {
  80. struct radio_isa_card *isa = video_drvdata(file);
  81. const struct radio_isa_ops *ops = isa->drv->ops;
  82. if (v->index)
  83. return -EINVAL;
  84. if (ops->s_stereo) {
  85. isa->stereo = (v->audmode == V4L2_TUNER_MODE_STEREO);
  86. return ops->s_stereo(isa, isa->stereo);
  87. }
  88. return 0;
  89. }
  90. static int radio_isa_s_frequency(struct file *file, void *priv,
  91. struct v4l2_frequency *f)
  92. {
  93. struct radio_isa_card *isa = video_drvdata(file);
  94. int res;
  95. if (f->tuner != 0 || f->type != V4L2_TUNER_RADIO)
  96. return -EINVAL;
  97. f->frequency = clamp(f->frequency, FREQ_LOW, FREQ_HIGH);
  98. res = isa->drv->ops->s_frequency(isa, f->frequency);
  99. if (res == 0)
  100. isa->freq = f->frequency;
  101. return res;
  102. }
  103. static int radio_isa_g_frequency(struct file *file, void *priv,
  104. struct v4l2_frequency *f)
  105. {
  106. struct radio_isa_card *isa = video_drvdata(file);
  107. if (f->tuner != 0)
  108. return -EINVAL;
  109. f->type = V4L2_TUNER_RADIO;
  110. f->frequency = isa->freq;
  111. return 0;
  112. }
  113. static int radio_isa_s_ctrl(struct v4l2_ctrl *ctrl)
  114. {
  115. struct radio_isa_card *isa =
  116. container_of(ctrl->handler, struct radio_isa_card, hdl);
  117. switch (ctrl->id) {
  118. case V4L2_CID_AUDIO_MUTE:
  119. return isa->drv->ops->s_mute_volume(isa, ctrl->val,
  120. isa->volume ? isa->volume->val : 0);
  121. }
  122. return -EINVAL;
  123. }
  124. static int radio_isa_log_status(struct file *file, void *priv)
  125. {
  126. struct radio_isa_card *isa = video_drvdata(file);
  127. v4l2_info(&isa->v4l2_dev, "I/O Port = 0x%03x\n", isa->io);
  128. v4l2_ctrl_handler_log_status(&isa->hdl, isa->v4l2_dev.name);
  129. return 0;
  130. }
  131. static int radio_isa_subscribe_event(struct v4l2_fh *fh,
  132. struct v4l2_event_subscription *sub)
  133. {
  134. if (sub->type == V4L2_EVENT_CTRL)
  135. return v4l2_event_subscribe(fh, sub, 0);
  136. return -EINVAL;
  137. }
  138. static const struct v4l2_ctrl_ops radio_isa_ctrl_ops = {
  139. .s_ctrl = radio_isa_s_ctrl,
  140. };
  141. static const struct v4l2_file_operations radio_isa_fops = {
  142. .owner = THIS_MODULE,
  143. .open = v4l2_fh_open,
  144. .release = v4l2_fh_release,
  145. .poll = v4l2_ctrl_poll,
  146. .unlocked_ioctl = video_ioctl2,
  147. };
  148. static const struct v4l2_ioctl_ops radio_isa_ioctl_ops = {
  149. .vidioc_querycap = radio_isa_querycap,
  150. .vidioc_g_tuner = radio_isa_g_tuner,
  151. .vidioc_s_tuner = radio_isa_s_tuner,
  152. .vidioc_g_frequency = radio_isa_g_frequency,
  153. .vidioc_s_frequency = radio_isa_s_frequency,
  154. .vidioc_log_status = radio_isa_log_status,
  155. .vidioc_subscribe_event = radio_isa_subscribe_event,
  156. .vidioc_unsubscribe_event = v4l2_event_unsubscribe,
  157. };
  158. int radio_isa_match(struct device *pdev, unsigned int dev)
  159. {
  160. struct radio_isa_driver *drv = pdev->platform_data;
  161. return drv->probe || drv->io_params[dev] >= 0;
  162. }
  163. EXPORT_SYMBOL_GPL(radio_isa_match);
  164. static bool radio_isa_valid_io(const struct radio_isa_driver *drv, int io)
  165. {
  166. int i;
  167. for (i = 0; i < drv->num_of_io_ports; i++)
  168. if (drv->io_ports[i] == io)
  169. return true;
  170. return false;
  171. }
  172. int radio_isa_probe(struct device *pdev, unsigned int dev)
  173. {
  174. struct radio_isa_driver *drv = pdev->platform_data;
  175. const struct radio_isa_ops *ops = drv->ops;
  176. struct v4l2_device *v4l2_dev;
  177. struct radio_isa_card *isa;
  178. int res;
  179. isa = drv->ops->alloc();
  180. if (isa == NULL)
  181. return -ENOMEM;
  182. dev_set_drvdata(pdev, isa);
  183. isa->drv = drv;
  184. isa->io = drv->io_params[dev];
  185. v4l2_dev = &isa->v4l2_dev;
  186. strlcpy(v4l2_dev->name, dev_name(pdev), sizeof(v4l2_dev->name));
  187. if (drv->probe && ops->probe) {
  188. int i;
  189. for (i = 0; i < drv->num_of_io_ports; ++i) {
  190. int io = drv->io_ports[i];
  191. if (request_region(io, drv->region_size, v4l2_dev->name)) {
  192. bool found = ops->probe(isa, io);
  193. release_region(io, drv->region_size);
  194. if (found) {
  195. isa->io = io;
  196. break;
  197. }
  198. }
  199. }
  200. }
  201. if (!radio_isa_valid_io(drv, isa->io)) {
  202. int i;
  203. if (isa->io < 0)
  204. return -ENODEV;
  205. v4l2_err(v4l2_dev, "you must set an I/O address with io=0x%03x",
  206. drv->io_ports[0]);
  207. for (i = 1; i < drv->num_of_io_ports; i++)
  208. printk(KERN_CONT "/0x%03x", drv->io_ports[i]);
  209. printk(KERN_CONT ".\n");
  210. kfree(isa);
  211. return -EINVAL;
  212. }
  213. if (!request_region(isa->io, drv->region_size, v4l2_dev->name)) {
  214. v4l2_err(v4l2_dev, "port 0x%x already in use\n", isa->io);
  215. kfree(isa);
  216. return -EBUSY;
  217. }
  218. res = v4l2_device_register(pdev, v4l2_dev);
  219. if (res < 0) {
  220. v4l2_err(v4l2_dev, "Could not register v4l2_device\n");
  221. goto err_dev_reg;
  222. }
  223. v4l2_ctrl_handler_init(&isa->hdl, 1);
  224. isa->mute = v4l2_ctrl_new_std(&isa->hdl, &radio_isa_ctrl_ops,
  225. V4L2_CID_AUDIO_MUTE, 0, 1, 1, 1);
  226. if (drv->max_volume)
  227. isa->volume = v4l2_ctrl_new_std(&isa->hdl, &radio_isa_ctrl_ops,
  228. V4L2_CID_AUDIO_VOLUME, 0, drv->max_volume, 1,
  229. drv->max_volume);
  230. v4l2_dev->ctrl_handler = &isa->hdl;
  231. if (isa->hdl.error) {
  232. res = isa->hdl.error;
  233. v4l2_err(v4l2_dev, "Could not register controls\n");
  234. goto err_hdl;
  235. }
  236. if (drv->max_volume)
  237. v4l2_ctrl_cluster(2, &isa->mute);
  238. v4l2_dev->ctrl_handler = &isa->hdl;
  239. mutex_init(&isa->lock);
  240. isa->vdev.lock = &isa->lock;
  241. strlcpy(isa->vdev.name, v4l2_dev->name, sizeof(isa->vdev.name));
  242. isa->vdev.v4l2_dev = v4l2_dev;
  243. isa->vdev.fops = &radio_isa_fops;
  244. isa->vdev.ioctl_ops = &radio_isa_ioctl_ops;
  245. isa->vdev.release = video_device_release_empty;
  246. set_bit(V4L2_FL_USE_FH_PRIO, &isa->vdev.flags);
  247. video_set_drvdata(&isa->vdev, isa);
  248. isa->freq = FREQ_LOW;
  249. isa->stereo = drv->has_stereo;
  250. if (ops->init)
  251. res = ops->init(isa);
  252. if (!res)
  253. res = v4l2_ctrl_handler_setup(&isa->hdl);
  254. if (!res)
  255. res = ops->s_frequency(isa, isa->freq);
  256. if (!res && ops->s_stereo)
  257. res = ops->s_stereo(isa, isa->stereo);
  258. if (res < 0) {
  259. v4l2_err(v4l2_dev, "Could not setup card\n");
  260. goto err_node_reg;
  261. }
  262. res = video_register_device(&isa->vdev, VFL_TYPE_RADIO,
  263. drv->radio_nr_params[dev]);
  264. if (res < 0) {
  265. v4l2_err(v4l2_dev, "Could not register device node\n");
  266. goto err_node_reg;
  267. }
  268. v4l2_info(v4l2_dev, "Initialized radio card %s on port 0x%03x\n",
  269. drv->card, isa->io);
  270. return 0;
  271. err_node_reg:
  272. v4l2_ctrl_handler_free(&isa->hdl);
  273. err_hdl:
  274. v4l2_device_unregister(&isa->v4l2_dev);
  275. err_dev_reg:
  276. release_region(isa->io, drv->region_size);
  277. kfree(isa);
  278. return res;
  279. }
  280. EXPORT_SYMBOL_GPL(radio_isa_probe);
  281. int radio_isa_remove(struct device *pdev, unsigned int dev)
  282. {
  283. struct radio_isa_card *isa = dev_get_drvdata(pdev);
  284. const struct radio_isa_ops *ops = isa->drv->ops;
  285. ops->s_mute_volume(isa, true, isa->volume ? isa->volume->cur.val : 0);
  286. video_unregister_device(&isa->vdev);
  287. v4l2_ctrl_handler_free(&isa->hdl);
  288. v4l2_device_unregister(&isa->v4l2_dev);
  289. release_region(isa->io, isa->drv->region_size);
  290. v4l2_info(&isa->v4l2_dev, "Removed radio card %s\n", isa->drv->card);
  291. kfree(isa);
  292. return 0;
  293. }
  294. EXPORT_SYMBOL_GPL(radio_isa_remove);