1 /* 2 * FM Driver for Connectivity chip of Texas Instruments. 3 * This file provides interfaces to V4L2 subsystem. 4 * 5 * This module registers with V4L2 subsystem as Radio 6 * data system interface (/dev/radio). During the registration, 7 * it will expose two set of function pointers. 8 * 9 * 1) File operation related API (open, close, read, write, poll...etc). 10 * 2) Set of V4L2 IOCTL complaint API. 11 * 12 * Copyright (C) 2011 Texas Instruments 13 * Author: Raja Mani <raja_mani@ti.com> 14 * Author: Manjunatha Halli <manjunatha_halli@ti.com> 15 * 16 * This program is free software; you can redistribute it and/or modify 17 * it under the terms of the GNU General Public License version 2 as 18 * published by the Free Software Foundation. 19 * 20 * This program is distributed in the hope that it will be useful, 21 * but WITHOUT ANY WARRANTY; without even the implied warranty of 22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 23 * GNU General Public License for more details. 24 * 25 * You should have received a copy of the GNU General Public License 26 * along with this program; if not, write to the Free Software 27 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 28 * 29 */ 30 31 #include <linux/export.h> 32 33 #include "fmdrv.h" 34 #include "fmdrv_v4l2.h" 35 #include "fmdrv_common.h" 36 #include "fmdrv_rx.h" 37 #include "fmdrv_tx.h" 38 39 static struct video_device *gradio_dev; 40 static u8 radio_disconnected; 41 42 /* -- V4L2 RADIO (/dev/radioX) device file operation interfaces --- */ 43 44 /* Read RX RDS data */ 45 static ssize_t fm_v4l2_fops_read(struct file *file, char __user * buf, 46 size_t count, loff_t *ppos) 47 { 48 u8 rds_mode; 49 int ret; 50 struct fmdev *fmdev; 51 52 fmdev = video_drvdata(file); 53 54 if (!radio_disconnected) { 55 fmerr("FM device is already disconnected\n"); 56 return -EIO; 57 } 58 59 /* Turn on RDS mode , if it is disabled */ 60 ret = fm_rx_get_rds_mode(fmdev, &rds_mode); 61 if (ret < 0) { 62 fmerr("Unable to read current rds mode\n"); 63 return ret; 64 } 65 66 if (rds_mode == FM_RDS_DISABLE) { 67 ret = fmc_set_rds_mode(fmdev, FM_RDS_ENABLE); 68 if (ret < 0) { 69 fmerr("Failed to enable rds mode\n"); 70 return ret; 71 } 72 } 73 74 /* Copy RDS data from internal buffer to user buffer */ 75 return fmc_transfer_rds_from_internal_buff(fmdev, file, buf, count); 76 } 77 78 /* Write TX RDS data */ 79 static ssize_t fm_v4l2_fops_write(struct file *file, const char __user * buf, 80 size_t count, loff_t *ppos) 81 { 82 struct tx_rds rds; 83 int ret; 84 struct fmdev *fmdev; 85 86 ret = copy_from_user(&rds, buf, sizeof(rds)); 87 rds.text[sizeof(rds.text) - 1] = '\0'; 88 fmdbg("(%d)type: %d, text %s, af %d\n", 89 ret, rds.text_type, rds.text, rds.af_freq); 90 if (ret) 91 return -EFAULT; 92 93 fmdev = video_drvdata(file); 94 fm_tx_set_radio_text(fmdev, rds.text, rds.text_type); 95 fm_tx_set_af(fmdev, rds.af_freq); 96 97 return sizeof(rds); 98 } 99 100 static u32 fm_v4l2_fops_poll(struct file *file, struct poll_table_struct *pts) 101 { 102 int ret; 103 struct fmdev *fmdev; 104 105 fmdev = video_drvdata(file); 106 ret = fmc_is_rds_data_available(fmdev, file, pts); 107 if (ret < 0) 108 return POLLIN | POLLRDNORM; 109 110 return 0; 111 } 112 113 /* 114 * Handle open request for "/dev/radioX" device. 115 * Start with FM RX mode as default. 116 */ 117 static int fm_v4l2_fops_open(struct file *file) 118 { 119 int ret; 120 struct fmdev *fmdev = NULL; 121 122 /* Don't allow multiple open */ 123 if (radio_disconnected) { 124 fmerr("FM device is already opened\n"); 125 return -EBUSY; 126 } 127 128 fmdev = video_drvdata(file); 129 130 ret = fmc_prepare(fmdev); 131 if (ret < 0) { 132 fmerr("Unable to prepare FM CORE\n"); 133 return ret; 134 } 135 136 fmdbg("Load FM RX firmware..\n"); 137 138 ret = fmc_set_mode(fmdev, FM_MODE_RX); 139 if (ret < 0) { 140 fmerr("Unable to load FM RX firmware\n"); 141 return ret; 142 } 143 radio_disconnected = 1; 144 145 return ret; 146 } 147 148 static int fm_v4l2_fops_release(struct file *file) 149 { 150 int ret; 151 struct fmdev *fmdev; 152 153 fmdev = video_drvdata(file); 154 if (!radio_disconnected) { 155 fmdbg("FM device is already closed\n"); 156 return 0; 157 } 158 159 ret = fmc_set_mode(fmdev, FM_MODE_OFF); 160 if (ret < 0) { 161 fmerr("Unable to turn off the chip\n"); 162 return ret; 163 } 164 165 ret = fmc_release(fmdev); 166 if (ret < 0) { 167 fmerr("FM CORE release failed\n"); 168 return ret; 169 } 170 radio_disconnected = 0; 171 172 return ret; 173 } 174 175 /* V4L2 RADIO (/dev/radioX) device IOCTL interfaces */ 176 static int fm_v4l2_vidioc_querycap(struct file *file, void *priv, 177 struct v4l2_capability *capability) 178 { 179 strlcpy(capability->driver, FM_DRV_NAME, sizeof(capability->driver)); 180 strlcpy(capability->card, FM_DRV_CARD_SHORT_NAME, 181 sizeof(capability->card)); 182 sprintf(capability->bus_info, "UART"); 183 capability->capabilities = V4L2_CAP_HW_FREQ_SEEK | V4L2_CAP_TUNER | 184 V4L2_CAP_RADIO | V4L2_CAP_MODULATOR | 185 V4L2_CAP_AUDIO | V4L2_CAP_READWRITE | 186 V4L2_CAP_RDS_CAPTURE; 187 188 return 0; 189 } 190 191 static int fm_g_volatile_ctrl(struct v4l2_ctrl *ctrl) 192 { 193 struct fmdev *fmdev = container_of(ctrl->handler, 194 struct fmdev, ctrl_handler); 195 196 switch (ctrl->id) { 197 case V4L2_CID_TUNE_ANTENNA_CAPACITOR: 198 ctrl->val = fm_tx_get_tune_cap_val(fmdev); 199 break; 200 default: 201 fmwarn("%s: Unknown IOCTL: %d\n", __func__, ctrl->id); 202 break; 203 } 204 205 return 0; 206 } 207 208 static int fm_v4l2_s_ctrl(struct v4l2_ctrl *ctrl) 209 { 210 struct fmdev *fmdev = container_of(ctrl->handler, 211 struct fmdev, ctrl_handler); 212 213 switch (ctrl->id) { 214 case V4L2_CID_AUDIO_VOLUME: /* set volume */ 215 return fm_rx_set_volume(fmdev, (u16)ctrl->val); 216 217 case V4L2_CID_AUDIO_MUTE: /* set mute */ 218 return fmc_set_mute_mode(fmdev, (u8)ctrl->val); 219 220 case V4L2_CID_TUNE_POWER_LEVEL: 221 /* set TX power level - ext control */ 222 return fm_tx_set_pwr_lvl(fmdev, (u8)ctrl->val); 223 224 case V4L2_CID_TUNE_PREEMPHASIS: 225 return fm_tx_set_preemph_filter(fmdev, (u8) ctrl->val); 226 227 default: 228 return -EINVAL; 229 } 230 } 231 232 static int fm_v4l2_vidioc_g_audio(struct file *file, void *priv, 233 struct v4l2_audio *audio) 234 { 235 memset(audio, 0, sizeof(*audio)); 236 strcpy(audio->name, "Radio"); 237 audio->capability = V4L2_AUDCAP_STEREO; 238 239 return 0; 240 } 241 242 static int fm_v4l2_vidioc_s_audio(struct file *file, void *priv, 243 struct v4l2_audio *audio) 244 { 245 if (audio->index != 0) 246 return -EINVAL; 247 248 return 0; 249 } 250 251 /* Get tuner attributes. If current mode is NOT RX, return error */ 252 static int fm_v4l2_vidioc_g_tuner(struct file *file, void *priv, 253 struct v4l2_tuner *tuner) 254 { 255 struct fmdev *fmdev = video_drvdata(file); 256 u32 bottom_freq; 257 u32 top_freq; 258 u16 stereo_mono_mode; 259 u16 rssilvl; 260 int ret; 261 262 if (tuner->index != 0) 263 return -EINVAL; 264 265 if (fmdev->curr_fmmode != FM_MODE_RX) 266 return -EPERM; 267 268 ret = fm_rx_get_band_freq_range(fmdev, &bottom_freq, &top_freq); 269 if (ret != 0) 270 return ret; 271 272 ret = fm_rx_get_stereo_mono(fmdev, &stereo_mono_mode); 273 if (ret != 0) 274 return ret; 275 276 ret = fm_rx_get_rssi_level(fmdev, &rssilvl); 277 if (ret != 0) 278 return ret; 279 280 strcpy(tuner->name, "FM"); 281 tuner->type = V4L2_TUNER_RADIO; 282 /* Store rangelow and rangehigh freq in unit of 62.5 Hz */ 283 tuner->rangelow = bottom_freq * 16; 284 tuner->rangehigh = top_freq * 16; 285 tuner->rxsubchans = V4L2_TUNER_SUB_MONO | V4L2_TUNER_SUB_STEREO | 286 ((fmdev->rx.rds.flag == FM_RDS_ENABLE) ? V4L2_TUNER_SUB_RDS : 0); 287 tuner->capability = V4L2_TUNER_CAP_STEREO | V4L2_TUNER_CAP_RDS | 288 V4L2_TUNER_CAP_LOW; 289 tuner->audmode = (stereo_mono_mode ? 290 V4L2_TUNER_MODE_MONO : V4L2_TUNER_MODE_STEREO); 291 292 /* 293 * Actual rssi value lies in between -128 to +127. 294 * Convert this range from 0 to 255 by adding +128 295 */ 296 rssilvl += 128; 297 298 /* 299 * Return signal strength value should be within 0 to 65535. 300 * Find out correct signal radio by multiplying (65535/255) = 257 301 */ 302 tuner->signal = rssilvl * 257; 303 tuner->afc = 0; 304 305 return ret; 306 } 307 308 /* 309 * Set tuner attributes. If current mode is NOT RX, set to RX. 310 * Currently, we set only audio mode (mono/stereo) and RDS state (on/off). 311 * Should we set other tuner attributes, too? 312 */ 313 static int fm_v4l2_vidioc_s_tuner(struct file *file, void *priv, 314 struct v4l2_tuner *tuner) 315 { 316 struct fmdev *fmdev = video_drvdata(file); 317 u16 aud_mode; 318 u8 rds_mode; 319 int ret; 320 321 if (tuner->index != 0) 322 return -EINVAL; 323 324 aud_mode = (tuner->audmode == V4L2_TUNER_MODE_STEREO) ? 325 FM_STEREO_MODE : FM_MONO_MODE; 326 rds_mode = (tuner->rxsubchans & V4L2_TUNER_SUB_RDS) ? 327 FM_RDS_ENABLE : FM_RDS_DISABLE; 328 329 if (fmdev->curr_fmmode != FM_MODE_RX) { 330 ret = fmc_set_mode(fmdev, FM_MODE_RX); 331 if (ret < 0) { 332 fmerr("Failed to set RX mode\n"); 333 return ret; 334 } 335 } 336 337 ret = fmc_set_stereo_mono(fmdev, aud_mode); 338 if (ret < 0) { 339 fmerr("Failed to set RX stereo/mono mode\n"); 340 return ret; 341 } 342 343 ret = fmc_set_rds_mode(fmdev, rds_mode); 344 if (ret < 0) 345 fmerr("Failed to set RX RDS mode\n"); 346 347 return ret; 348 } 349 350 /* Get tuner or modulator radio frequency */ 351 static int fm_v4l2_vidioc_g_freq(struct file *file, void *priv, 352 struct v4l2_frequency *freq) 353 { 354 struct fmdev *fmdev = video_drvdata(file); 355 int ret; 356 357 ret = fmc_get_freq(fmdev, &freq->frequency); 358 if (ret < 0) { 359 fmerr("Failed to get frequency\n"); 360 return ret; 361 } 362 363 /* Frequency unit of 62.5 Hz*/ 364 freq->frequency = (u32) freq->frequency * 16; 365 366 return 0; 367 } 368 369 /* Set tuner or modulator radio frequency */ 370 static int fm_v4l2_vidioc_s_freq(struct file *file, void *priv, 371 struct v4l2_frequency *freq) 372 { 373 struct fmdev *fmdev = video_drvdata(file); 374 375 /* 376 * As V4L2_TUNER_CAP_LOW is set 1 user sends the frequency 377 * in units of 62.5 Hz. 378 */ 379 freq->frequency = (u32)(freq->frequency / 16); 380 381 return fmc_set_freq(fmdev, freq->frequency); 382 } 383 384 /* Set hardware frequency seek. If current mode is NOT RX, set it RX. */ 385 static int fm_v4l2_vidioc_s_hw_freq_seek(struct file *file, void *priv, 386 struct v4l2_hw_freq_seek *seek) 387 { 388 struct fmdev *fmdev = video_drvdata(file); 389 int ret; 390 391 if (fmdev->curr_fmmode != FM_MODE_RX) { 392 ret = fmc_set_mode(fmdev, FM_MODE_RX); 393 if (ret != 0) { 394 fmerr("Failed to set RX mode\n"); 395 return ret; 396 } 397 } 398 399 ret = fm_rx_seek(fmdev, seek->seek_upward, seek->wrap_around, 400 seek->spacing); 401 if (ret < 0) 402 fmerr("RX seek failed - %d\n", ret); 403 404 return ret; 405 } 406 /* Get modulator attributes. If mode is not TX, return no attributes. */ 407 static int fm_v4l2_vidioc_g_modulator(struct file *file, void *priv, 408 struct v4l2_modulator *mod) 409 { 410 struct fmdev *fmdev = video_drvdata(file); 411 412 if (mod->index != 0) 413 return -EINVAL; 414 415 if (fmdev->curr_fmmode != FM_MODE_TX) 416 return -EPERM; 417 418 mod->txsubchans = ((fmdev->tx_data.aud_mode == FM_STEREO_MODE) ? 419 V4L2_TUNER_SUB_STEREO : V4L2_TUNER_SUB_MONO) | 420 ((fmdev->tx_data.rds.flag == FM_RDS_ENABLE) ? 421 V4L2_TUNER_SUB_RDS : 0); 422 423 mod->capability = V4L2_TUNER_CAP_STEREO | V4L2_TUNER_CAP_RDS | 424 V4L2_TUNER_CAP_LOW; 425 426 return 0; 427 } 428 429 /* Set modulator attributes. If mode is not TX, set to TX. */ 430 static int fm_v4l2_vidioc_s_modulator(struct file *file, void *priv, 431 struct v4l2_modulator *mod) 432 { 433 struct fmdev *fmdev = video_drvdata(file); 434 u8 rds_mode; 435 u16 aud_mode; 436 int ret; 437 438 if (mod->index != 0) 439 return -EINVAL; 440 441 if (fmdev->curr_fmmode != FM_MODE_TX) { 442 ret = fmc_set_mode(fmdev, FM_MODE_TX); 443 if (ret != 0) { 444 fmerr("Failed to set TX mode\n"); 445 return ret; 446 } 447 } 448 449 aud_mode = (mod->txsubchans & V4L2_TUNER_SUB_STEREO) ? 450 FM_STEREO_MODE : FM_MONO_MODE; 451 rds_mode = (mod->txsubchans & V4L2_TUNER_SUB_RDS) ? 452 FM_RDS_ENABLE : FM_RDS_DISABLE; 453 ret = fm_tx_set_stereo_mono(fmdev, aud_mode); 454 if (ret < 0) { 455 fmerr("Failed to set mono/stereo mode for TX\n"); 456 return ret; 457 } 458 ret = fm_tx_set_rds_mode(fmdev, rds_mode); 459 if (ret < 0) 460 fmerr("Failed to set rds mode for TX\n"); 461 462 return ret; 463 } 464 465 static const struct v4l2_file_operations fm_drv_fops = { 466 .owner = THIS_MODULE, 467 .read = fm_v4l2_fops_read, 468 .write = fm_v4l2_fops_write, 469 .poll = fm_v4l2_fops_poll, 470 .unlocked_ioctl = video_ioctl2, 471 .open = fm_v4l2_fops_open, 472 .release = fm_v4l2_fops_release, 473 }; 474 475 static const struct v4l2_ctrl_ops fm_ctrl_ops = { 476 .s_ctrl = fm_v4l2_s_ctrl, 477 .g_volatile_ctrl = fm_g_volatile_ctrl, 478 }; 479 static const struct v4l2_ioctl_ops fm_drv_ioctl_ops = { 480 .vidioc_querycap = fm_v4l2_vidioc_querycap, 481 .vidioc_g_audio = fm_v4l2_vidioc_g_audio, 482 .vidioc_s_audio = fm_v4l2_vidioc_s_audio, 483 .vidioc_g_tuner = fm_v4l2_vidioc_g_tuner, 484 .vidioc_s_tuner = fm_v4l2_vidioc_s_tuner, 485 .vidioc_g_frequency = fm_v4l2_vidioc_g_freq, 486 .vidioc_s_frequency = fm_v4l2_vidioc_s_freq, 487 .vidioc_s_hw_freq_seek = fm_v4l2_vidioc_s_hw_freq_seek, 488 .vidioc_g_modulator = fm_v4l2_vidioc_g_modulator, 489 .vidioc_s_modulator = fm_v4l2_vidioc_s_modulator 490 }; 491 492 /* V4L2 RADIO device parent structure */ 493 static struct video_device fm_viddev_template = { 494 .fops = &fm_drv_fops, 495 .ioctl_ops = &fm_drv_ioctl_ops, 496 .name = FM_DRV_NAME, 497 .release = video_device_release, 498 }; 499 500 int fm_v4l2_init_video_device(struct fmdev *fmdev, int radio_nr) 501 { 502 struct v4l2_ctrl *ctrl; 503 int ret; 504 505 /* Init mutex for core locking */ 506 mutex_init(&fmdev->mutex); 507 508 /* Allocate new video device */ 509 gradio_dev = video_device_alloc(); 510 if (NULL == gradio_dev) { 511 fmerr("Can't allocate video device\n"); 512 return -ENOMEM; 513 } 514 515 /* Setup FM driver's V4L2 properties */ 516 memcpy(gradio_dev, &fm_viddev_template, sizeof(fm_viddev_template)); 517 518 video_set_drvdata(gradio_dev, fmdev); 519 520 gradio_dev->lock = &fmdev->mutex; 521 522 /* Register with V4L2 subsystem as RADIO device */ 523 if (video_register_device(gradio_dev, VFL_TYPE_RADIO, radio_nr)) { 524 video_device_release(gradio_dev); 525 fmerr("Could not register video device\n"); 526 return -ENOMEM; 527 } 528 529 fmdev->radio_dev = gradio_dev; 530 531 /* Register to v4l2 ctrl handler framework */ 532 fmdev->radio_dev->ctrl_handler = &fmdev->ctrl_handler; 533 534 ret = v4l2_ctrl_handler_init(&fmdev->ctrl_handler, 5); 535 if (ret < 0) { 536 fmerr("(fmdev): Can't init ctrl handler\n"); 537 v4l2_ctrl_handler_free(&fmdev->ctrl_handler); 538 return -EBUSY; 539 } 540 541 /* 542 * Following controls are handled by V4L2 control framework. 543 * Added in ascending ID order. 544 */ 545 v4l2_ctrl_new_std(&fmdev->ctrl_handler, &fm_ctrl_ops, 546 V4L2_CID_AUDIO_VOLUME, FM_RX_VOLUME_MIN, 547 FM_RX_VOLUME_MAX, 1, FM_RX_VOLUME_MAX); 548 549 v4l2_ctrl_new_std(&fmdev->ctrl_handler, &fm_ctrl_ops, 550 V4L2_CID_AUDIO_MUTE, 0, 1, 1, 1); 551 552 v4l2_ctrl_new_std_menu(&fmdev->ctrl_handler, &fm_ctrl_ops, 553 V4L2_CID_TUNE_PREEMPHASIS, V4L2_PREEMPHASIS_75_uS, 554 0, V4L2_PREEMPHASIS_75_uS); 555 556 v4l2_ctrl_new_std(&fmdev->ctrl_handler, &fm_ctrl_ops, 557 V4L2_CID_TUNE_POWER_LEVEL, FM_PWR_LVL_LOW, 558 FM_PWR_LVL_HIGH, 1, FM_PWR_LVL_HIGH); 559 560 ctrl = v4l2_ctrl_new_std(&fmdev->ctrl_handler, &fm_ctrl_ops, 561 V4L2_CID_TUNE_ANTENNA_CAPACITOR, 0, 562 255, 1, 255); 563 564 if (ctrl) 565 ctrl->flags |= V4L2_CTRL_FLAG_VOLATILE; 566 567 return 0; 568 } 569 570 void *fm_v4l2_deinit_video_device(void) 571 { 572 struct fmdev *fmdev; 573 574 575 fmdev = video_get_drvdata(gradio_dev); 576 577 /* Unregister to v4l2 ctrl handler framework*/ 578 v4l2_ctrl_handler_free(&fmdev->ctrl_handler); 579 580 /* Unregister RADIO device from V4L2 subsystem */ 581 video_unregister_device(gradio_dev); 582 583 return fmdev; 584 } 585