2 * dvb_frontend.c: DVB frontend tuning interface/thread
5 * Copyright (C) 1999-2001 Ralph Metzler
8 * for convergence integrated media GmbH
10 * Copyright (C) 2004 Andrew de Quincey (tuning thread cleanup)
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation; either version 2
15 * of the License, or (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
21 * To obtain the license, point your browser to
22 * http://www.gnu.org/copyleft/gpl.html
25 /* Enables DVBv3 compatibility bits at the headers */
28 #define pr_fmt(fmt) "dvb_frontend: " fmt
30 #include <linux/string.h>
31 #include <linux/kernel.h>
32 #include <linux/sched/signal.h>
33 #include <linux/wait.h>
34 #include <linux/slab.h>
35 #include <linux/poll.h>
36 #include <linux/semaphore.h>
37 #include <linux/module.h>
38 #include <linux/list.h>
39 #include <linux/freezer.h>
40 #include <linux/jiffies.h>
41 #include <linux/kthread.h>
42 #include <linux/ktime.h>
43 #include <asm/processor.h>
45 #include "dvb_frontend.h"
47 #include <linux/dvb/version.h>
49 static int dvb_frontend_debug;
50 static int dvb_shutdown_timeout;
51 static int dvb_force_auto_inversion;
52 static int dvb_override_tune_delay;
53 static int dvb_powerdown_on_sleep = 1;
54 static int dvb_mfe_wait_time = 5;
56 module_param_named(frontend_debug, dvb_frontend_debug, int, 0644);
57 MODULE_PARM_DESC(frontend_debug, "Turn on/off frontend core debugging (default:off).");
58 module_param(dvb_shutdown_timeout, int, 0644);
59 MODULE_PARM_DESC(dvb_shutdown_timeout, "wait <shutdown_timeout> seconds after close() before suspending hardware");
60 module_param(dvb_force_auto_inversion, int, 0644);
61 MODULE_PARM_DESC(dvb_force_auto_inversion, "0: normal (default), 1: INVERSION_AUTO forced always");
62 module_param(dvb_override_tune_delay, int, 0644);
63 MODULE_PARM_DESC(dvb_override_tune_delay, "0: normal (default), >0 => delay in milliseconds to wait for lock after a tune attempt");
64 module_param(dvb_powerdown_on_sleep, int, 0644);
65 MODULE_PARM_DESC(dvb_powerdown_on_sleep, "0: do not power down, 1: turn LNB voltage off on sleep (default)");
66 module_param(dvb_mfe_wait_time, int, 0644);
67 MODULE_PARM_DESC(dvb_mfe_wait_time, "Wait up to <mfe_wait_time> seconds on open() for multi-frontend to become available (default:5 seconds)");
69 #define dprintk(fmt, arg...) \
70 printk(KERN_DEBUG pr_fmt("%s: " fmt), __func__, ##arg)
72 #define FESTATE_IDLE 1
73 #define FESTATE_RETUNE 2
74 #define FESTATE_TUNING_FAST 4
75 #define FESTATE_TUNING_SLOW 8
76 #define FESTATE_TUNED 16
77 #define FESTATE_ZIGZAG_FAST 32
78 #define FESTATE_ZIGZAG_SLOW 64
79 #define FESTATE_DISEQC 128
80 #define FESTATE_ERROR 256
81 #define FESTATE_WAITFORLOCK (FESTATE_TUNING_FAST | FESTATE_TUNING_SLOW | FESTATE_ZIGZAG_FAST | FESTATE_ZIGZAG_SLOW | FESTATE_DISEQC)
82 #define FESTATE_SEARCHING_FAST (FESTATE_TUNING_FAST | FESTATE_ZIGZAG_FAST)
83 #define FESTATE_SEARCHING_SLOW (FESTATE_TUNING_SLOW | FESTATE_ZIGZAG_SLOW)
84 #define FESTATE_LOSTLOCK (FESTATE_ZIGZAG_FAST | FESTATE_ZIGZAG_SLOW)
87 * FESTATE_IDLE. No tuning parameters have been supplied and the loop is idling.
88 * FESTATE_RETUNE. Parameters have been supplied, but we have not yet performed the first tune.
89 * FESTATE_TUNING_FAST. Tuning parameters have been supplied and fast zigzag scan is in progress.
90 * FESTATE_TUNING_SLOW. Tuning parameters have been supplied. Fast zigzag failed, so we're trying again, but slower.
91 * FESTATE_TUNED. The frontend has successfully locked on.
92 * FESTATE_ZIGZAG_FAST. The lock has been lost, and a fast zigzag has been initiated to try and regain it.
93 * FESTATE_ZIGZAG_SLOW. The lock has been lost. Fast zigzag has been failed, so we're trying again, but slower.
94 * FESTATE_DISEQC. A DISEQC command has just been issued.
95 * FESTATE_WAITFORLOCK. When we're waiting for a lock.
96 * FESTATE_SEARCHING_FAST. When we're searching for a signal using a fast zigzag scan.
97 * FESTATE_SEARCHING_SLOW. When we're searching for a signal using a slow zigzag scan.
98 * FESTATE_LOSTLOCK. When the lock has been lost, and we're searching it again.
101 static DEFINE_MUTEX(frontend_mutex);
103 struct dvb_frontend_private {
104 /* thread/frontend values */
105 struct dvb_device *dvbdev;
106 struct dvb_frontend_parameters parameters_out;
107 struct dvb_fe_events events;
108 struct semaphore sem;
109 struct list_head list_head;
110 wait_queue_head_t wait_queue;
111 struct task_struct *thread;
112 unsigned long release_jiffies;
114 enum fe_status status;
115 unsigned long tune_mode_flags;
117 unsigned int reinitialise;
121 /* swzigzag values */
123 unsigned int bending;
125 unsigned int inversion;
126 unsigned int auto_step;
127 unsigned int auto_sub_step;
128 unsigned int started_auto_step;
129 unsigned int min_delay;
130 unsigned int max_drift;
131 unsigned int step_size;
133 unsigned int check_wrapped;
134 enum dvbfe_search algo_status;
136 #if defined(CONFIG_MEDIA_CONTROLLER_DVB)
137 struct media_pipeline pipe;
141 static void dvb_frontend_invoke_release(struct dvb_frontend *fe,
142 void (*release)(struct dvb_frontend *fe));
144 static void __dvb_frontend_free(struct dvb_frontend *fe)
146 struct dvb_frontend_private *fepriv = fe->frontend_priv;
149 dvb_free_device(fepriv->dvbdev);
151 dvb_frontend_invoke_release(fe, fe->ops.release);
157 static void dvb_frontend_free(struct kref *ref)
159 struct dvb_frontend *fe =
160 container_of(ref, struct dvb_frontend, refcount);
162 __dvb_frontend_free(fe);
165 static void dvb_frontend_put(struct dvb_frontend *fe)
168 * Check if the frontend was registered, as otherwise
169 * kref was not initialized yet.
171 if (fe->frontend_priv)
172 kref_put(&fe->refcount, dvb_frontend_free);
174 __dvb_frontend_free(fe);
177 static void dvb_frontend_get(struct dvb_frontend *fe)
179 kref_get(&fe->refcount);
182 static void dvb_frontend_wakeup(struct dvb_frontend *fe);
183 static int dtv_get_frontend(struct dvb_frontend *fe,
184 struct dtv_frontend_properties *c,
185 struct dvb_frontend_parameters *p_out);
187 dtv_property_legacy_params_sync(struct dvb_frontend *fe,
188 const struct dtv_frontend_properties *c,
189 struct dvb_frontend_parameters *p);
191 static bool has_get_frontend(struct dvb_frontend *fe)
193 return fe->ops.get_frontend != NULL;
197 * Due to DVBv3 API calls, a delivery system should be mapped into one of
198 * the 4 DVBv3 delivery systems (FE_QPSK, FE_QAM, FE_OFDM or FE_ATSC),
199 * otherwise, a DVBv3 call will fail.
201 enum dvbv3_emulation_type {
209 static enum dvbv3_emulation_type dvbv3_type(u32 delivery_system)
211 switch (delivery_system) {
212 case SYS_DVBC_ANNEX_A:
213 case SYS_DVBC_ANNEX_C:
228 case SYS_DVBC_ANNEX_B:
236 * Doesn't know how to emulate those types and/or
237 * there's no frontend driver from this type yet
238 * with some emulation code, so, we're not sure yet how
239 * to handle them, or they're not compatible with a DVBv3 call.
241 return DVBV3_UNKNOWN;
245 static void dvb_frontend_add_event(struct dvb_frontend *fe,
246 enum fe_status status)
248 struct dvb_frontend_private *fepriv = fe->frontend_priv;
249 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
250 struct dvb_fe_events *events = &fepriv->events;
251 struct dvb_frontend_event *e;
254 dev_dbg(fe->dvb->device, "%s:\n", __func__);
256 if ((status & FE_HAS_LOCK) && has_get_frontend(fe))
257 dtv_get_frontend(fe, c, &fepriv->parameters_out);
259 mutex_lock(&events->mtx);
261 wp = (events->eventw + 1) % MAX_EVENT;
262 if (wp == events->eventr) {
263 events->overflow = 1;
264 events->eventr = (events->eventr + 1) % MAX_EVENT;
267 e = &events->events[events->eventw];
269 e->parameters = fepriv->parameters_out;
273 mutex_unlock(&events->mtx);
275 wake_up_interruptible (&events->wait_queue);
278 static int dvb_frontend_get_event(struct dvb_frontend *fe,
279 struct dvb_frontend_event *event, int flags)
281 struct dvb_frontend_private *fepriv = fe->frontend_priv;
282 struct dvb_fe_events *events = &fepriv->events;
284 dev_dbg(fe->dvb->device, "%s:\n", __func__);
286 if (events->overflow) {
287 events->overflow = 0;
291 if (events->eventw == events->eventr) {
294 if (flags & O_NONBLOCK)
299 ret = wait_event_interruptible (events->wait_queue,
300 events->eventw != events->eventr);
302 if (down_interruptible (&fepriv->sem))
309 mutex_lock(&events->mtx);
310 *event = events->events[events->eventr];
311 events->eventr = (events->eventr + 1) % MAX_EVENT;
312 mutex_unlock(&events->mtx);
317 static void dvb_frontend_clear_events(struct dvb_frontend *fe)
319 struct dvb_frontend_private *fepriv = fe->frontend_priv;
320 struct dvb_fe_events *events = &fepriv->events;
322 mutex_lock(&events->mtx);
323 events->eventr = events->eventw;
324 mutex_unlock(&events->mtx);
327 static void dvb_frontend_init(struct dvb_frontend *fe)
329 dev_dbg(fe->dvb->device,
330 "%s: initialising adapter %i frontend %i (%s)...\n",
331 __func__, fe->dvb->num, fe->id, fe->ops.info.name);
335 if (fe->ops.tuner_ops.init) {
336 if (fe->ops.i2c_gate_ctrl)
337 fe->ops.i2c_gate_ctrl(fe, 1);
338 fe->ops.tuner_ops.init(fe);
339 if (fe->ops.i2c_gate_ctrl)
340 fe->ops.i2c_gate_ctrl(fe, 0);
344 void dvb_frontend_reinitialise(struct dvb_frontend *fe)
346 struct dvb_frontend_private *fepriv = fe->frontend_priv;
348 fepriv->reinitialise = 1;
349 dvb_frontend_wakeup(fe);
351 EXPORT_SYMBOL(dvb_frontend_reinitialise);
353 static void dvb_frontend_swzigzag_update_delay(struct dvb_frontend_private *fepriv, int locked)
356 struct dvb_frontend *fe = fepriv->dvbdev->priv;
358 dev_dbg(fe->dvb->device, "%s:\n", __func__);
361 (fepriv->quality) = (fepriv->quality * 220 + 36*256) / 256;
363 (fepriv->quality) = (fepriv->quality * 220 + 0) / 256;
365 q2 = fepriv->quality - 128;
368 fepriv->delay = fepriv->min_delay + q2 * HZ / (128*128);
372 * dvb_frontend_swzigzag_autotune - Performs automatic twiddling of frontend
375 * @fe: The frontend concerned.
376 * @check_wrapped: Checks if an iteration has completed.
377 * DO NOT SET ON THE FIRST ATTEMPT.
379 * return: Number of complete iterations that have been performed.
381 static int dvb_frontend_swzigzag_autotune(struct dvb_frontend *fe, int check_wrapped)
386 struct dvb_frontend_private *fepriv = fe->frontend_priv;
387 struct dtv_frontend_properties *c = &fe->dtv_property_cache, tmp;
388 int original_inversion = c->inversion;
389 u32 original_frequency = c->frequency;
391 /* are we using autoinversion? */
392 autoinversion = ((!(fe->ops.info.caps & FE_CAN_INVERSION_AUTO)) &&
393 (c->inversion == INVERSION_AUTO));
395 /* setup parameters correctly */
397 /* calculate the lnb_drift */
398 fepriv->lnb_drift = fepriv->auto_step * fepriv->step_size;
400 /* wrap the auto_step if we've exceeded the maximum drift */
401 if (fepriv->lnb_drift > fepriv->max_drift) {
402 fepriv->auto_step = 0;
403 fepriv->auto_sub_step = 0;
404 fepriv->lnb_drift = 0;
407 /* perform inversion and +/- zigzag */
408 switch(fepriv->auto_sub_step) {
410 /* try with the current inversion and current drift setting */
415 if (!autoinversion) break;
417 fepriv->inversion = (fepriv->inversion == INVERSION_OFF) ? INVERSION_ON : INVERSION_OFF;
422 if (fepriv->lnb_drift == 0) break;
424 fepriv->lnb_drift = -fepriv->lnb_drift;
429 if (fepriv->lnb_drift == 0) break;
430 if (!autoinversion) break;
432 fepriv->inversion = (fepriv->inversion == INVERSION_OFF) ? INVERSION_ON : INVERSION_OFF;
433 fepriv->lnb_drift = -fepriv->lnb_drift;
439 fepriv->auto_sub_step = -1; /* it'll be incremented to 0 in a moment */
443 if (!ready) fepriv->auto_sub_step++;
446 /* if this attempt would hit where we started, indicate a complete
447 * iteration has occurred */
448 if ((fepriv->auto_step == fepriv->started_auto_step) &&
449 (fepriv->auto_sub_step == 0) && check_wrapped) {
453 dev_dbg(fe->dvb->device, "%s: drift:%i inversion:%i auto_step:%i " \
454 "auto_sub_step:%i started_auto_step:%i\n",
455 __func__, fepriv->lnb_drift, fepriv->inversion,
456 fepriv->auto_step, fepriv->auto_sub_step,
457 fepriv->started_auto_step);
459 /* set the frontend itself */
460 c->frequency += fepriv->lnb_drift;
462 c->inversion = fepriv->inversion;
464 if (fe->ops.set_frontend)
465 fe_set_err = fe->ops.set_frontend(fe);
467 if (fe_set_err < 0) {
468 fepriv->state = FESTATE_ERROR;
472 c->frequency = original_frequency;
473 c->inversion = original_inversion;
475 fepriv->auto_sub_step++;
479 static void dvb_frontend_swzigzag(struct dvb_frontend *fe)
481 enum fe_status s = FE_NONE;
483 struct dvb_frontend_private *fepriv = fe->frontend_priv;
484 struct dtv_frontend_properties *c = &fe->dtv_property_cache, tmp;
486 /* if we've got no parameters, just keep idling */
487 if (fepriv->state & FESTATE_IDLE) {
488 fepriv->delay = 3*HZ;
493 /* in SCAN mode, we just set the frontend when asked and leave it alone */
494 if (fepriv->tune_mode_flags & FE_TUNE_MODE_ONESHOT) {
495 if (fepriv->state & FESTATE_RETUNE) {
497 if (fe->ops.set_frontend)
498 retval = fe->ops.set_frontend(fe);
501 fepriv->state = FESTATE_ERROR;
503 fepriv->state = FESTATE_TUNED;
505 fepriv->delay = 3*HZ;
510 /* get the frontend status */
511 if (fepriv->state & FESTATE_RETUNE) {
514 if (fe->ops.read_status)
515 fe->ops.read_status(fe, &s);
516 if (s != fepriv->status) {
517 dvb_frontend_add_event(fe, s);
522 /* if we're not tuned, and we have a lock, move to the TUNED state */
523 if ((fepriv->state & FESTATE_WAITFORLOCK) && (s & FE_HAS_LOCK)) {
524 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
525 fepriv->state = FESTATE_TUNED;
527 /* if we're tuned, then we have determined the correct inversion */
528 if ((!(fe->ops.info.caps & FE_CAN_INVERSION_AUTO)) &&
529 (c->inversion == INVERSION_AUTO)) {
530 c->inversion = fepriv->inversion;
535 /* if we are tuned already, check we're still locked */
536 if (fepriv->state & FESTATE_TUNED) {
537 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
539 /* we're tuned, and the lock is still good... */
540 if (s & FE_HAS_LOCK) {
542 } else { /* if we _WERE_ tuned, but now don't have a lock */
543 fepriv->state = FESTATE_ZIGZAG_FAST;
544 fepriv->started_auto_step = fepriv->auto_step;
545 fepriv->check_wrapped = 0;
549 /* don't actually do anything if we're in the LOSTLOCK state,
550 * the frontend is set to FE_CAN_RECOVER, and the max_drift is 0 */
551 if ((fepriv->state & FESTATE_LOSTLOCK) &&
552 (fe->ops.info.caps & FE_CAN_RECOVER) && (fepriv->max_drift == 0)) {
553 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
557 /* don't do anything if we're in the DISEQC state, since this
558 * might be someone with a motorized dish controlled by DISEQC.
559 * If its actually a re-tune, there will be a SET_FRONTEND soon enough. */
560 if (fepriv->state & FESTATE_DISEQC) {
561 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
565 /* if we're in the RETUNE state, set everything up for a brand
566 * new scan, keeping the current inversion setting, as the next
567 * tune is _very_ likely to require the same */
568 if (fepriv->state & FESTATE_RETUNE) {
569 fepriv->lnb_drift = 0;
570 fepriv->auto_step = 0;
571 fepriv->auto_sub_step = 0;
572 fepriv->started_auto_step = 0;
573 fepriv->check_wrapped = 0;
577 if ((fepriv->state & FESTATE_SEARCHING_FAST) || (fepriv->state & FESTATE_RETUNE)) {
578 fepriv->delay = fepriv->min_delay;
581 retval = dvb_frontend_swzigzag_autotune(fe,
582 fepriv->check_wrapped);
586 /* OK, if we've run out of trials at the fast speed.
587 * Drop back to slow for the _next_ attempt */
588 fepriv->state = FESTATE_SEARCHING_SLOW;
589 fepriv->started_auto_step = fepriv->auto_step;
592 fepriv->check_wrapped = 1;
594 /* if we've just retuned, enter the ZIGZAG_FAST state.
595 * This ensures we cannot return from an
596 * FE_SET_FRONTEND ioctl before the first frontend tune
598 if (fepriv->state & FESTATE_RETUNE) {
599 fepriv->state = FESTATE_TUNING_FAST;
604 if (fepriv->state & FESTATE_SEARCHING_SLOW) {
605 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
607 /* Note: don't bother checking for wrapping; we stay in this
608 * state until we get a lock */
609 dvb_frontend_swzigzag_autotune(fe, 0);
613 static int dvb_frontend_is_exiting(struct dvb_frontend *fe)
615 struct dvb_frontend_private *fepriv = fe->frontend_priv;
617 if (fe->exit != DVB_FE_NO_EXIT)
620 if (fepriv->dvbdev->writers == 1)
621 if (time_after_eq(jiffies, fepriv->release_jiffies +
622 dvb_shutdown_timeout * HZ))
628 static int dvb_frontend_should_wakeup(struct dvb_frontend *fe)
630 struct dvb_frontend_private *fepriv = fe->frontend_priv;
632 if (fepriv->wakeup) {
636 return dvb_frontend_is_exiting(fe);
639 static void dvb_frontend_wakeup(struct dvb_frontend *fe)
641 struct dvb_frontend_private *fepriv = fe->frontend_priv;
644 wake_up_interruptible(&fepriv->wait_queue);
647 static int dvb_frontend_thread(void *data)
649 struct dvb_frontend *fe = data;
650 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
651 struct dvb_frontend_private *fepriv = fe->frontend_priv;
652 enum fe_status s = FE_NONE;
653 enum dvbfe_algo algo;
654 bool re_tune = false;
655 bool semheld = false;
657 dev_dbg(fe->dvb->device, "%s:\n", __func__);
659 fepriv->check_wrapped = 0;
661 fepriv->delay = 3*HZ;
664 fepriv->reinitialise = 0;
666 dvb_frontend_init(fe);
670 up(&fepriv->sem); /* is locked when we enter the thread... */
672 wait_event_interruptible_timeout(fepriv->wait_queue,
673 dvb_frontend_should_wakeup(fe) || kthread_should_stop()
674 || freezing(current),
677 if (kthread_should_stop() || dvb_frontend_is_exiting(fe)) {
678 /* got signal or quitting */
679 if (!down_interruptible(&fepriv->sem))
681 fe->exit = DVB_FE_NORMAL_EXIT;
688 if (down_interruptible(&fepriv->sem))
691 if (fepriv->reinitialise) {
692 dvb_frontend_init(fe);
693 if (fe->ops.set_tone && fepriv->tone != -1)
694 fe->ops.set_tone(fe, fepriv->tone);
695 if (fe->ops.set_voltage && fepriv->voltage != -1)
696 fe->ops.set_voltage(fe, fepriv->voltage);
697 fepriv->reinitialise = 0;
700 /* do an iteration of the tuning loop */
701 if (fe->ops.get_frontend_algo) {
702 algo = fe->ops.get_frontend_algo(fe);
705 dev_dbg(fe->dvb->device, "%s: Frontend ALGO = DVBFE_ALGO_HW\n", __func__);
707 if (fepriv->state & FESTATE_RETUNE) {
708 dev_dbg(fe->dvb->device, "%s: Retune requested, FESTATE_RETUNE\n", __func__);
710 fepriv->state = FESTATE_TUNED;
716 fe->ops.tune(fe, re_tune, fepriv->tune_mode_flags, &fepriv->delay, &s);
718 if (s != fepriv->status && !(fepriv->tune_mode_flags & FE_TUNE_MODE_ONESHOT)) {
719 dev_dbg(fe->dvb->device, "%s: state changed, adding current state\n", __func__);
720 dvb_frontend_add_event(fe, s);
725 dev_dbg(fe->dvb->device, "%s: Frontend ALGO = DVBFE_ALGO_SW\n", __func__);
726 dvb_frontend_swzigzag(fe);
728 case DVBFE_ALGO_CUSTOM:
729 dev_dbg(fe->dvb->device, "%s: Frontend ALGO = DVBFE_ALGO_CUSTOM, state=%d\n", __func__, fepriv->state);
730 if (fepriv->state & FESTATE_RETUNE) {
731 dev_dbg(fe->dvb->device, "%s: Retune requested, FESTAT_RETUNE\n", __func__);
732 fepriv->state = FESTATE_TUNED;
734 /* Case where we are going to search for a carrier
735 * User asked us to retune again for some reason, possibly
736 * requesting a search with a new set of parameters
738 if (fepriv->algo_status & DVBFE_ALGO_SEARCH_AGAIN) {
739 if (fe->ops.search) {
740 fepriv->algo_status = fe->ops.search(fe);
741 /* We did do a search as was requested, the flags are
742 * now unset as well and has the flags wrt to search.
745 fepriv->algo_status &= ~DVBFE_ALGO_SEARCH_AGAIN;
748 /* Track the carrier if the search was successful */
749 if (fepriv->algo_status != DVBFE_ALGO_SEARCH_SUCCESS) {
750 fepriv->algo_status |= DVBFE_ALGO_SEARCH_AGAIN;
751 fepriv->delay = HZ / 2;
753 dtv_property_legacy_params_sync(fe, c, &fepriv->parameters_out);
754 fe->ops.read_status(fe, &s);
755 if (s != fepriv->status) {
756 dvb_frontend_add_event(fe, s); /* update event list */
758 if (!(s & FE_HAS_LOCK)) {
759 fepriv->delay = HZ / 10;
760 fepriv->algo_status |= DVBFE_ALGO_SEARCH_AGAIN;
762 fepriv->delay = 60 * HZ;
767 dev_dbg(fe->dvb->device, "%s: UNDEFINED ALGO !\n", __func__);
771 dvb_frontend_swzigzag(fe);
775 if (dvb_powerdown_on_sleep) {
776 if (fe->ops.set_voltage)
777 fe->ops.set_voltage(fe, SEC_VOLTAGE_OFF);
778 if (fe->ops.tuner_ops.sleep) {
779 if (fe->ops.i2c_gate_ctrl)
780 fe->ops.i2c_gate_ctrl(fe, 1);
781 fe->ops.tuner_ops.sleep(fe);
782 if (fe->ops.i2c_gate_ctrl)
783 fe->ops.i2c_gate_ctrl(fe, 0);
789 fepriv->thread = NULL;
790 if (kthread_should_stop())
791 fe->exit = DVB_FE_DEVICE_REMOVED;
793 fe->exit = DVB_FE_NO_EXIT;
798 dvb_frontend_wakeup(fe);
802 static void dvb_frontend_stop(struct dvb_frontend *fe)
804 struct dvb_frontend_private *fepriv = fe->frontend_priv;
806 dev_dbg(fe->dvb->device, "%s:\n", __func__);
808 if (fe->exit != DVB_FE_DEVICE_REMOVED)
809 fe->exit = DVB_FE_NORMAL_EXIT;
815 kthread_stop(fepriv->thread);
817 sema_init(&fepriv->sem, 1);
818 fepriv->state = FESTATE_IDLE;
820 /* paranoia check in case a signal arrived */
822 dev_warn(fe->dvb->device,
823 "dvb_frontend_stop: warning: thread %p won't exit\n",
828 * Sleep for the amount of time given by add_usec parameter
830 * This needs to be as precise as possible, as it affects the detection of
831 * the dish tone command at the satellite subsystem. The precision is improved
832 * by using a scheduled msleep followed by udelay for the remainder.
834 void dvb_frontend_sleep_until(ktime_t *waketime, u32 add_usec)
838 *waketime = ktime_add_us(*waketime, add_usec);
839 delta = ktime_us_delta(ktime_get_boottime(), *waketime);
841 msleep((delta - 1500) / 1000);
842 delta = ktime_us_delta(ktime_get_boottime(), *waketime);
847 EXPORT_SYMBOL(dvb_frontend_sleep_until);
849 static int dvb_frontend_start(struct dvb_frontend *fe)
852 struct dvb_frontend_private *fepriv = fe->frontend_priv;
853 struct task_struct *fe_thread;
855 dev_dbg(fe->dvb->device, "%s:\n", __func__);
857 if (fepriv->thread) {
858 if (fe->exit == DVB_FE_NO_EXIT)
861 dvb_frontend_stop (fe);
864 if (signal_pending(current))
866 if (down_interruptible (&fepriv->sem))
869 fepriv->state = FESTATE_IDLE;
870 fe->exit = DVB_FE_NO_EXIT;
871 fepriv->thread = NULL;
874 fe_thread = kthread_run(dvb_frontend_thread, fe,
875 "kdvb-ad-%i-fe-%i", fe->dvb->num,fe->id);
876 if (IS_ERR(fe_thread)) {
877 ret = PTR_ERR(fe_thread);
878 dev_warn(fe->dvb->device,
879 "dvb_frontend_start: failed to start kthread (%d)\n",
884 fepriv->thread = fe_thread;
888 static void dvb_frontend_get_frequency_limits(struct dvb_frontend *fe,
889 u32 *freq_min, u32 *freq_max)
891 *freq_min = max(fe->ops.info.frequency_min, fe->ops.tuner_ops.info.frequency_min);
893 if (fe->ops.info.frequency_max == 0)
894 *freq_max = fe->ops.tuner_ops.info.frequency_max;
895 else if (fe->ops.tuner_ops.info.frequency_max == 0)
896 *freq_max = fe->ops.info.frequency_max;
898 *freq_max = min(fe->ops.info.frequency_max, fe->ops.tuner_ops.info.frequency_max);
900 if (*freq_min == 0 || *freq_max == 0)
901 dev_warn(fe->dvb->device, "DVB: adapter %i frontend %u frequency limits undefined - fix the driver\n",
902 fe->dvb->num, fe->id);
905 static int dvb_frontend_check_parameters(struct dvb_frontend *fe)
907 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
911 /* range check: frequency */
912 dvb_frontend_get_frequency_limits(fe, &freq_min, &freq_max);
913 if ((freq_min && c->frequency < freq_min) ||
914 (freq_max && c->frequency > freq_max)) {
915 dev_warn(fe->dvb->device, "DVB: adapter %i frontend %i frequency %u out of range (%u..%u)\n",
916 fe->dvb->num, fe->id, c->frequency,
921 /* range check: symbol rate */
922 switch (c->delivery_system) {
926 case SYS_DVBC_ANNEX_A:
927 case SYS_DVBC_ANNEX_C:
928 if ((fe->ops.info.symbol_rate_min &&
929 c->symbol_rate < fe->ops.info.symbol_rate_min) ||
930 (fe->ops.info.symbol_rate_max &&
931 c->symbol_rate > fe->ops.info.symbol_rate_max)) {
932 dev_warn(fe->dvb->device, "DVB: adapter %i frontend %i symbol rate %u out of range (%u..%u)\n",
933 fe->dvb->num, fe->id, c->symbol_rate,
934 fe->ops.info.symbol_rate_min,
935 fe->ops.info.symbol_rate_max);
945 static int dvb_frontend_clear_cache(struct dvb_frontend *fe)
947 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
951 delsys = c->delivery_system;
952 memset(c, 0, offsetof(struct dtv_frontend_properties, strength));
953 c->delivery_system = delsys;
955 dev_dbg(fe->dvb->device, "%s: Clearing cache for delivery system %d\n",
956 __func__, c->delivery_system);
958 c->transmission_mode = TRANSMISSION_MODE_AUTO;
959 c->bandwidth_hz = 0; /* AUTO */
960 c->guard_interval = GUARD_INTERVAL_AUTO;
961 c->hierarchy = HIERARCHY_AUTO;
963 c->code_rate_HP = FEC_AUTO;
964 c->code_rate_LP = FEC_AUTO;
965 c->fec_inner = FEC_AUTO;
966 c->rolloff = ROLLOFF_AUTO;
967 c->voltage = SEC_VOLTAGE_OFF;
968 c->sectone = SEC_TONE_OFF;
969 c->pilot = PILOT_AUTO;
971 c->isdbt_partial_reception = 0;
972 c->isdbt_sb_mode = 0;
973 c->isdbt_sb_subchannel = 0;
974 c->isdbt_sb_segment_idx = 0;
975 c->isdbt_sb_segment_count = 0;
976 c->isdbt_layer_enabled = 0;
977 for (i = 0; i < 3; i++) {
978 c->layer[i].fec = FEC_AUTO;
979 c->layer[i].modulation = QAM_AUTO;
980 c->layer[i].interleaving = 0;
981 c->layer[i].segment_count = 0;
984 c->stream_id = NO_STREAM_ID_FILTER;
986 switch (c->delivery_system) {
990 c->modulation = QPSK; /* implied for DVB-S in legacy API */
991 c->rolloff = ROLLOFF_35;/* implied for DVB-S */
994 c->modulation = VSB_8;
997 c->symbol_rate = 28860000;
998 c->rolloff = ROLLOFF_35;
999 c->bandwidth_hz = c->symbol_rate / 100 * 135;
1002 c->modulation = QAM_AUTO;
1011 #define _DTV_CMD(n, s, b) \
1020 char *name; /* A display name for debugging purposes */
1022 __u32 cmd; /* A unique ID */
1025 __u32 set:1; /* Either a set or get property */
1026 __u32 buffer:1; /* Does this property use the buffer? */
1027 __u32 reserved:30; /* Align */
1030 static struct dtv_cmds_h dtv_cmds[DTV_MAX_COMMAND + 1] = {
1031 _DTV_CMD(DTV_TUNE, 1, 0),
1032 _DTV_CMD(DTV_CLEAR, 1, 0),
1035 _DTV_CMD(DTV_FREQUENCY, 1, 0),
1036 _DTV_CMD(DTV_BANDWIDTH_HZ, 1, 0),
1037 _DTV_CMD(DTV_MODULATION, 1, 0),
1038 _DTV_CMD(DTV_INVERSION, 1, 0),
1039 _DTV_CMD(DTV_DISEQC_MASTER, 1, 1),
1040 _DTV_CMD(DTV_SYMBOL_RATE, 1, 0),
1041 _DTV_CMD(DTV_INNER_FEC, 1, 0),
1042 _DTV_CMD(DTV_VOLTAGE, 1, 0),
1043 _DTV_CMD(DTV_TONE, 1, 0),
1044 _DTV_CMD(DTV_PILOT, 1, 0),
1045 _DTV_CMD(DTV_ROLLOFF, 1, 0),
1046 _DTV_CMD(DTV_DELIVERY_SYSTEM, 1, 0),
1047 _DTV_CMD(DTV_HIERARCHY, 1, 0),
1048 _DTV_CMD(DTV_CODE_RATE_HP, 1, 0),
1049 _DTV_CMD(DTV_CODE_RATE_LP, 1, 0),
1050 _DTV_CMD(DTV_GUARD_INTERVAL, 1, 0),
1051 _DTV_CMD(DTV_TRANSMISSION_MODE, 1, 0),
1052 _DTV_CMD(DTV_INTERLEAVING, 1, 0),
1054 _DTV_CMD(DTV_ISDBT_PARTIAL_RECEPTION, 1, 0),
1055 _DTV_CMD(DTV_ISDBT_SOUND_BROADCASTING, 1, 0),
1056 _DTV_CMD(DTV_ISDBT_SB_SUBCHANNEL_ID, 1, 0),
1057 _DTV_CMD(DTV_ISDBT_SB_SEGMENT_IDX, 1, 0),
1058 _DTV_CMD(DTV_ISDBT_SB_SEGMENT_COUNT, 1, 0),
1059 _DTV_CMD(DTV_ISDBT_LAYER_ENABLED, 1, 0),
1060 _DTV_CMD(DTV_ISDBT_LAYERA_FEC, 1, 0),
1061 _DTV_CMD(DTV_ISDBT_LAYERA_MODULATION, 1, 0),
1062 _DTV_CMD(DTV_ISDBT_LAYERA_SEGMENT_COUNT, 1, 0),
1063 _DTV_CMD(DTV_ISDBT_LAYERA_TIME_INTERLEAVING, 1, 0),
1064 _DTV_CMD(DTV_ISDBT_LAYERB_FEC, 1, 0),
1065 _DTV_CMD(DTV_ISDBT_LAYERB_MODULATION, 1, 0),
1066 _DTV_CMD(DTV_ISDBT_LAYERB_SEGMENT_COUNT, 1, 0),
1067 _DTV_CMD(DTV_ISDBT_LAYERB_TIME_INTERLEAVING, 1, 0),
1068 _DTV_CMD(DTV_ISDBT_LAYERC_FEC, 1, 0),
1069 _DTV_CMD(DTV_ISDBT_LAYERC_MODULATION, 1, 0),
1070 _DTV_CMD(DTV_ISDBT_LAYERC_SEGMENT_COUNT, 1, 0),
1071 _DTV_CMD(DTV_ISDBT_LAYERC_TIME_INTERLEAVING, 1, 0),
1073 _DTV_CMD(DTV_STREAM_ID, 1, 0),
1074 _DTV_CMD(DTV_DVBT2_PLP_ID_LEGACY, 1, 0),
1075 _DTV_CMD(DTV_LNA, 1, 0),
1078 _DTV_CMD(DTV_DISEQC_SLAVE_REPLY, 0, 1),
1079 _DTV_CMD(DTV_API_VERSION, 0, 0),
1081 _DTV_CMD(DTV_ENUM_DELSYS, 0, 0),
1083 _DTV_CMD(DTV_ATSCMH_PARADE_ID, 1, 0),
1084 _DTV_CMD(DTV_ATSCMH_RS_FRAME_ENSEMBLE, 1, 0),
1086 _DTV_CMD(DTV_ATSCMH_FIC_VER, 0, 0),
1087 _DTV_CMD(DTV_ATSCMH_NOG, 0, 0),
1088 _DTV_CMD(DTV_ATSCMH_TNOG, 0, 0),
1089 _DTV_CMD(DTV_ATSCMH_SGN, 0, 0),
1090 _DTV_CMD(DTV_ATSCMH_PRC, 0, 0),
1091 _DTV_CMD(DTV_ATSCMH_RS_FRAME_MODE, 0, 0),
1092 _DTV_CMD(DTV_ATSCMH_RS_CODE_MODE_PRI, 0, 0),
1093 _DTV_CMD(DTV_ATSCMH_RS_CODE_MODE_SEC, 0, 0),
1094 _DTV_CMD(DTV_ATSCMH_SCCC_BLOCK_MODE, 0, 0),
1095 _DTV_CMD(DTV_ATSCMH_SCCC_CODE_MODE_A, 0, 0),
1096 _DTV_CMD(DTV_ATSCMH_SCCC_CODE_MODE_B, 0, 0),
1097 _DTV_CMD(DTV_ATSCMH_SCCC_CODE_MODE_C, 0, 0),
1098 _DTV_CMD(DTV_ATSCMH_SCCC_CODE_MODE_D, 0, 0),
1100 /* Statistics API */
1101 _DTV_CMD(DTV_STAT_SIGNAL_STRENGTH, 0, 0),
1102 _DTV_CMD(DTV_STAT_CNR, 0, 0),
1103 _DTV_CMD(DTV_STAT_PRE_ERROR_BIT_COUNT, 0, 0),
1104 _DTV_CMD(DTV_STAT_PRE_TOTAL_BIT_COUNT, 0, 0),
1105 _DTV_CMD(DTV_STAT_POST_ERROR_BIT_COUNT, 0, 0),
1106 _DTV_CMD(DTV_STAT_POST_TOTAL_BIT_COUNT, 0, 0),
1107 _DTV_CMD(DTV_STAT_ERROR_BLOCK_COUNT, 0, 0),
1108 _DTV_CMD(DTV_STAT_TOTAL_BLOCK_COUNT, 0, 0),
1111 /* Synchronise the legacy tuning parameters into the cache, so that demodulator
1112 * drivers can use a single set_frontend tuning function, regardless of whether
1113 * it's being used for the legacy or new API, reducing code and complexity.
1115 static int dtv_property_cache_sync(struct dvb_frontend *fe,
1116 struct dtv_frontend_properties *c,
1117 const struct dvb_frontend_parameters *p)
1119 c->frequency = p->frequency;
1120 c->inversion = p->inversion;
1122 switch (dvbv3_type(c->delivery_system)) {
1124 dev_dbg(fe->dvb->device, "%s: Preparing QPSK req\n", __func__);
1125 c->symbol_rate = p->u.qpsk.symbol_rate;
1126 c->fec_inner = p->u.qpsk.fec_inner;
1129 dev_dbg(fe->dvb->device, "%s: Preparing QAM req\n", __func__);
1130 c->symbol_rate = p->u.qam.symbol_rate;
1131 c->fec_inner = p->u.qam.fec_inner;
1132 c->modulation = p->u.qam.modulation;
1135 dev_dbg(fe->dvb->device, "%s: Preparing OFDM req\n", __func__);
1137 switch (p->u.ofdm.bandwidth) {
1138 case BANDWIDTH_10_MHZ:
1139 c->bandwidth_hz = 10000000;
1141 case BANDWIDTH_8_MHZ:
1142 c->bandwidth_hz = 8000000;
1144 case BANDWIDTH_7_MHZ:
1145 c->bandwidth_hz = 7000000;
1147 case BANDWIDTH_6_MHZ:
1148 c->bandwidth_hz = 6000000;
1150 case BANDWIDTH_5_MHZ:
1151 c->bandwidth_hz = 5000000;
1153 case BANDWIDTH_1_712_MHZ:
1154 c->bandwidth_hz = 1712000;
1156 case BANDWIDTH_AUTO:
1157 c->bandwidth_hz = 0;
1160 c->code_rate_HP = p->u.ofdm.code_rate_HP;
1161 c->code_rate_LP = p->u.ofdm.code_rate_LP;
1162 c->modulation = p->u.ofdm.constellation;
1163 c->transmission_mode = p->u.ofdm.transmission_mode;
1164 c->guard_interval = p->u.ofdm.guard_interval;
1165 c->hierarchy = p->u.ofdm.hierarchy_information;
1168 dev_dbg(fe->dvb->device, "%s: Preparing ATSC req\n", __func__);
1169 c->modulation = p->u.vsb.modulation;
1170 if (c->delivery_system == SYS_ATSCMH)
1172 if ((c->modulation == VSB_8) || (c->modulation == VSB_16))
1173 c->delivery_system = SYS_ATSC;
1175 c->delivery_system = SYS_DVBC_ANNEX_B;
1178 dev_err(fe->dvb->device,
1179 "%s: doesn't know how to handle a DVBv3 call to delivery system %i\n",
1180 __func__, c->delivery_system);
1187 /* Ensure the cached values are set correctly in the frontend
1188 * legacy tuning structures, for the advanced tuning API.
1191 dtv_property_legacy_params_sync(struct dvb_frontend *fe,
1192 const struct dtv_frontend_properties *c,
1193 struct dvb_frontend_parameters *p)
1195 p->frequency = c->frequency;
1196 p->inversion = c->inversion;
1198 switch (dvbv3_type(c->delivery_system)) {
1200 dev_err(fe->dvb->device,
1201 "%s: doesn't know how to handle a DVBv3 call to delivery system %i\n",
1202 __func__, c->delivery_system);
1205 dev_dbg(fe->dvb->device, "%s: Preparing QPSK req\n", __func__);
1206 p->u.qpsk.symbol_rate = c->symbol_rate;
1207 p->u.qpsk.fec_inner = c->fec_inner;
1210 dev_dbg(fe->dvb->device, "%s: Preparing QAM req\n", __func__);
1211 p->u.qam.symbol_rate = c->symbol_rate;
1212 p->u.qam.fec_inner = c->fec_inner;
1213 p->u.qam.modulation = c->modulation;
1216 dev_dbg(fe->dvb->device, "%s: Preparing OFDM req\n", __func__);
1217 switch (c->bandwidth_hz) {
1219 p->u.ofdm.bandwidth = BANDWIDTH_10_MHZ;
1222 p->u.ofdm.bandwidth = BANDWIDTH_8_MHZ;
1225 p->u.ofdm.bandwidth = BANDWIDTH_7_MHZ;
1228 p->u.ofdm.bandwidth = BANDWIDTH_6_MHZ;
1231 p->u.ofdm.bandwidth = BANDWIDTH_5_MHZ;
1234 p->u.ofdm.bandwidth = BANDWIDTH_1_712_MHZ;
1238 p->u.ofdm.bandwidth = BANDWIDTH_AUTO;
1240 p->u.ofdm.code_rate_HP = c->code_rate_HP;
1241 p->u.ofdm.code_rate_LP = c->code_rate_LP;
1242 p->u.ofdm.constellation = c->modulation;
1243 p->u.ofdm.transmission_mode = c->transmission_mode;
1244 p->u.ofdm.guard_interval = c->guard_interval;
1245 p->u.ofdm.hierarchy_information = c->hierarchy;
1248 dev_dbg(fe->dvb->device, "%s: Preparing VSB req\n", __func__);
1249 p->u.vsb.modulation = c->modulation;
1256 * dtv_get_frontend - calls a callback for retrieving DTV parameters
1257 * @fe: struct dvb_frontend pointer
1258 * @c: struct dtv_frontend_properties pointer (DVBv5 cache)
1259 * @p_out: struct dvb_frontend_parameters pointer (DVBv3 FE struct)
1261 * This routine calls either the DVBv3 or DVBv5 get_frontend call.
1262 * If c is not null, it will update the DVBv5 cache struct pointed by it.
1263 * If p_out is not null, it will update the DVBv3 params pointed by it.
1265 static int dtv_get_frontend(struct dvb_frontend *fe,
1266 struct dtv_frontend_properties *c,
1267 struct dvb_frontend_parameters *p_out)
1271 if (fe->ops.get_frontend) {
1272 r = fe->ops.get_frontend(fe, c);
1273 if (unlikely(r < 0))
1276 dtv_property_legacy_params_sync(fe, c, p_out);
1280 /* As everything is in cache, get_frontend fops are always supported */
1284 static int dvb_frontend_handle_ioctl(struct file *file,
1285 unsigned int cmd, void *parg);
1287 static int dtv_property_process_get(struct dvb_frontend *fe,
1288 const struct dtv_frontend_properties *c,
1289 struct dtv_property *tvp,
1295 case DTV_ENUM_DELSYS:
1297 while (ncaps < MAX_DELSYS && fe->ops.delsys[ncaps]) {
1298 tvp->u.buffer.data[ncaps] = fe->ops.delsys[ncaps];
1301 tvp->u.buffer.len = ncaps;
1304 tvp->u.data = c->frequency;
1306 case DTV_MODULATION:
1307 tvp->u.data = c->modulation;
1309 case DTV_BANDWIDTH_HZ:
1310 tvp->u.data = c->bandwidth_hz;
1313 tvp->u.data = c->inversion;
1315 case DTV_SYMBOL_RATE:
1316 tvp->u.data = c->symbol_rate;
1319 tvp->u.data = c->fec_inner;
1322 tvp->u.data = c->pilot;
1325 tvp->u.data = c->rolloff;
1327 case DTV_DELIVERY_SYSTEM:
1328 tvp->u.data = c->delivery_system;
1331 tvp->u.data = c->voltage;
1334 tvp->u.data = c->sectone;
1336 case DTV_API_VERSION:
1337 tvp->u.data = (DVB_API_VERSION << 8) | DVB_API_VERSION_MINOR;
1339 case DTV_CODE_RATE_HP:
1340 tvp->u.data = c->code_rate_HP;
1342 case DTV_CODE_RATE_LP:
1343 tvp->u.data = c->code_rate_LP;
1345 case DTV_GUARD_INTERVAL:
1346 tvp->u.data = c->guard_interval;
1348 case DTV_TRANSMISSION_MODE:
1349 tvp->u.data = c->transmission_mode;
1352 tvp->u.data = c->hierarchy;
1354 case DTV_INTERLEAVING:
1355 tvp->u.data = c->interleaving;
1358 /* ISDB-T Support here */
1359 case DTV_ISDBT_PARTIAL_RECEPTION:
1360 tvp->u.data = c->isdbt_partial_reception;
1362 case DTV_ISDBT_SOUND_BROADCASTING:
1363 tvp->u.data = c->isdbt_sb_mode;
1365 case DTV_ISDBT_SB_SUBCHANNEL_ID:
1366 tvp->u.data = c->isdbt_sb_subchannel;
1368 case DTV_ISDBT_SB_SEGMENT_IDX:
1369 tvp->u.data = c->isdbt_sb_segment_idx;
1371 case DTV_ISDBT_SB_SEGMENT_COUNT:
1372 tvp->u.data = c->isdbt_sb_segment_count;
1374 case DTV_ISDBT_LAYER_ENABLED:
1375 tvp->u.data = c->isdbt_layer_enabled;
1377 case DTV_ISDBT_LAYERA_FEC:
1378 tvp->u.data = c->layer[0].fec;
1380 case DTV_ISDBT_LAYERA_MODULATION:
1381 tvp->u.data = c->layer[0].modulation;
1383 case DTV_ISDBT_LAYERA_SEGMENT_COUNT:
1384 tvp->u.data = c->layer[0].segment_count;
1386 case DTV_ISDBT_LAYERA_TIME_INTERLEAVING:
1387 tvp->u.data = c->layer[0].interleaving;
1389 case DTV_ISDBT_LAYERB_FEC:
1390 tvp->u.data = c->layer[1].fec;
1392 case DTV_ISDBT_LAYERB_MODULATION:
1393 tvp->u.data = c->layer[1].modulation;
1395 case DTV_ISDBT_LAYERB_SEGMENT_COUNT:
1396 tvp->u.data = c->layer[1].segment_count;
1398 case DTV_ISDBT_LAYERB_TIME_INTERLEAVING:
1399 tvp->u.data = c->layer[1].interleaving;
1401 case DTV_ISDBT_LAYERC_FEC:
1402 tvp->u.data = c->layer[2].fec;
1404 case DTV_ISDBT_LAYERC_MODULATION:
1405 tvp->u.data = c->layer[2].modulation;
1407 case DTV_ISDBT_LAYERC_SEGMENT_COUNT:
1408 tvp->u.data = c->layer[2].segment_count;
1410 case DTV_ISDBT_LAYERC_TIME_INTERLEAVING:
1411 tvp->u.data = c->layer[2].interleaving;
1414 /* Multistream support */
1416 case DTV_DVBT2_PLP_ID_LEGACY:
1417 tvp->u.data = c->stream_id;
1421 case DTV_ATSCMH_FIC_VER:
1422 tvp->u.data = fe->dtv_property_cache.atscmh_fic_ver;
1424 case DTV_ATSCMH_PARADE_ID:
1425 tvp->u.data = fe->dtv_property_cache.atscmh_parade_id;
1427 case DTV_ATSCMH_NOG:
1428 tvp->u.data = fe->dtv_property_cache.atscmh_nog;
1430 case DTV_ATSCMH_TNOG:
1431 tvp->u.data = fe->dtv_property_cache.atscmh_tnog;
1433 case DTV_ATSCMH_SGN:
1434 tvp->u.data = fe->dtv_property_cache.atscmh_sgn;
1436 case DTV_ATSCMH_PRC:
1437 tvp->u.data = fe->dtv_property_cache.atscmh_prc;
1439 case DTV_ATSCMH_RS_FRAME_MODE:
1440 tvp->u.data = fe->dtv_property_cache.atscmh_rs_frame_mode;
1442 case DTV_ATSCMH_RS_FRAME_ENSEMBLE:
1443 tvp->u.data = fe->dtv_property_cache.atscmh_rs_frame_ensemble;
1445 case DTV_ATSCMH_RS_CODE_MODE_PRI:
1446 tvp->u.data = fe->dtv_property_cache.atscmh_rs_code_mode_pri;
1448 case DTV_ATSCMH_RS_CODE_MODE_SEC:
1449 tvp->u.data = fe->dtv_property_cache.atscmh_rs_code_mode_sec;
1451 case DTV_ATSCMH_SCCC_BLOCK_MODE:
1452 tvp->u.data = fe->dtv_property_cache.atscmh_sccc_block_mode;
1454 case DTV_ATSCMH_SCCC_CODE_MODE_A:
1455 tvp->u.data = fe->dtv_property_cache.atscmh_sccc_code_mode_a;
1457 case DTV_ATSCMH_SCCC_CODE_MODE_B:
1458 tvp->u.data = fe->dtv_property_cache.atscmh_sccc_code_mode_b;
1460 case DTV_ATSCMH_SCCC_CODE_MODE_C:
1461 tvp->u.data = fe->dtv_property_cache.atscmh_sccc_code_mode_c;
1463 case DTV_ATSCMH_SCCC_CODE_MODE_D:
1464 tvp->u.data = fe->dtv_property_cache.atscmh_sccc_code_mode_d;
1468 tvp->u.data = c->lna;
1471 /* Fill quality measures */
1472 case DTV_STAT_SIGNAL_STRENGTH:
1473 tvp->u.st = c->strength;
1478 case DTV_STAT_PRE_ERROR_BIT_COUNT:
1479 tvp->u.st = c->pre_bit_error;
1481 case DTV_STAT_PRE_TOTAL_BIT_COUNT:
1482 tvp->u.st = c->pre_bit_count;
1484 case DTV_STAT_POST_ERROR_BIT_COUNT:
1485 tvp->u.st = c->post_bit_error;
1487 case DTV_STAT_POST_TOTAL_BIT_COUNT:
1488 tvp->u.st = c->post_bit_count;
1490 case DTV_STAT_ERROR_BLOCK_COUNT:
1491 tvp->u.st = c->block_error;
1493 case DTV_STAT_TOTAL_BLOCK_COUNT:
1494 tvp->u.st = c->block_count;
1497 dev_dbg(fe->dvb->device,
1498 "%s: FE property %d doesn't exist\n",
1499 __func__, tvp->cmd);
1503 if (!dtv_cmds[tvp->cmd].buffer)
1504 dev_dbg(fe->dvb->device,
1505 "%s: GET cmd 0x%08x (%s) = 0x%08x\n",
1506 __func__, tvp->cmd, dtv_cmds[tvp->cmd].name,
1509 dev_dbg(fe->dvb->device,
1510 "%s: GET cmd 0x%08x (%s) len %d: %*ph\n",
1512 tvp->cmd, dtv_cmds[tvp->cmd].name,
1514 tvp->u.buffer.len, tvp->u.buffer.data);
1519 static int dtv_set_frontend(struct dvb_frontend *fe);
1521 static bool is_dvbv3_delsys(u32 delsys)
1523 return (delsys == SYS_DVBT) || (delsys == SYS_DVBC_ANNEX_A) ||
1524 (delsys == SYS_DVBS) || (delsys == SYS_ATSC);
1528 * emulate_delivery_system - emulate a DVBv5 delivery system with a DVBv3 type
1529 * @fe: struct frontend;
1530 * @delsys: DVBv5 type that will be used for emulation
1532 * Provides emulation for delivery systems that are compatible with the old
1533 * DVBv3 call. Among its usages, it provices support for ISDB-T, and allows
1534 * using a DVB-S2 only frontend just like it were a DVB-S, if the frontent
1535 * parameters are compatible with DVB-S spec.
1537 static int emulate_delivery_system(struct dvb_frontend *fe, u32 delsys)
1540 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
1542 c->delivery_system = delsys;
1545 * If the call is for ISDB-T, put it into full-seg, auto mode, TV
1547 if (c->delivery_system == SYS_ISDBT) {
1548 dev_dbg(fe->dvb->device,
1549 "%s: Using defaults for SYS_ISDBT\n",
1552 if (!c->bandwidth_hz)
1553 c->bandwidth_hz = 6000000;
1555 c->isdbt_partial_reception = 0;
1556 c->isdbt_sb_mode = 0;
1557 c->isdbt_sb_subchannel = 0;
1558 c->isdbt_sb_segment_idx = 0;
1559 c->isdbt_sb_segment_count = 0;
1560 c->isdbt_layer_enabled = 7;
1561 for (i = 0; i < 3; i++) {
1562 c->layer[i].fec = FEC_AUTO;
1563 c->layer[i].modulation = QAM_AUTO;
1564 c->layer[i].interleaving = 0;
1565 c->layer[i].segment_count = 0;
1568 dev_dbg(fe->dvb->device, "%s: change delivery system on cache to %d\n",
1569 __func__, c->delivery_system);
1575 * dvbv5_set_delivery_system - Sets the delivery system for a DVBv5 API call
1576 * @fe: frontend struct
1577 * @desired_system: delivery system requested by the user
1579 * A DVBv5 call know what's the desired system it wants. So, set it.
1581 * There are, however, a few known issues with early DVBv5 applications that
1582 * are also handled by this logic:
1584 * 1) Some early apps use SYS_UNDEFINED as the desired delivery system.
1585 * This is an API violation, but, as we don't want to break userspace,
1586 * convert it to the first supported delivery system.
1587 * 2) Some apps might be using a DVBv5 call in a wrong way, passing, for
1588 * example, SYS_DVBT instead of SYS_ISDBT. This is because early usage of
1589 * ISDB-T provided backward compat with DVB-T.
1591 static int dvbv5_set_delivery_system(struct dvb_frontend *fe,
1595 u32 delsys = SYS_UNDEFINED;
1596 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
1597 enum dvbv3_emulation_type type;
1600 * It was reported that some old DVBv5 applications were
1601 * filling delivery_system with SYS_UNDEFINED. If this happens,
1602 * assume that the application wants to use the first supported
1605 if (desired_system == SYS_UNDEFINED)
1606 desired_system = fe->ops.delsys[0];
1609 * This is a DVBv5 call. So, it likely knows the supported
1610 * delivery systems. So, check if the desired delivery system is
1614 while (ncaps < MAX_DELSYS && fe->ops.delsys[ncaps]) {
1615 if (fe->ops.delsys[ncaps] == desired_system) {
1616 c->delivery_system = desired_system;
1617 dev_dbg(fe->dvb->device,
1618 "%s: Changing delivery system to %d\n",
1619 __func__, desired_system);
1626 * The requested delivery system isn't supported. Maybe userspace
1627 * is requesting a DVBv3 compatible delivery system.
1629 * The emulation only works if the desired system is one of the
1630 * delivery systems supported by DVBv3 API
1632 if (!is_dvbv3_delsys(desired_system)) {
1633 dev_dbg(fe->dvb->device,
1634 "%s: Delivery system %d not supported.\n",
1635 __func__, desired_system);
1639 type = dvbv3_type(desired_system);
1642 * Get the last non-DVBv3 delivery system that has the same type
1643 * of the desired system
1646 while (ncaps < MAX_DELSYS && fe->ops.delsys[ncaps]) {
1647 if (dvbv3_type(fe->ops.delsys[ncaps]) == type)
1648 delsys = fe->ops.delsys[ncaps];
1652 /* There's nothing compatible with the desired delivery system */
1653 if (delsys == SYS_UNDEFINED) {
1654 dev_dbg(fe->dvb->device,
1655 "%s: Delivery system %d not supported on emulation mode.\n",
1656 __func__, desired_system);
1660 dev_dbg(fe->dvb->device,
1661 "%s: Using delivery system %d emulated as if it were %d\n",
1662 __func__, delsys, desired_system);
1664 return emulate_delivery_system(fe, desired_system);
1668 * dvbv3_set_delivery_system - Sets the delivery system for a DVBv3 API call
1669 * @fe: frontend struct
1671 * A DVBv3 call doesn't know what's the desired system it wants. It also
1672 * doesn't allow to switch between different types. Due to that, userspace
1673 * should use DVBv5 instead.
1674 * However, in order to avoid breaking userspace API, limited backward
1675 * compatibility support is provided.
1677 * There are some delivery systems that are incompatible with DVBv3 calls.
1679 * This routine should work fine for frontends that support just one delivery
1682 * For frontends that support multiple frontends:
1683 * 1) It defaults to use the first supported delivery system. There's an
1684 * userspace application that allows changing it at runtime;
1686 * 2) If the current delivery system is not compatible with DVBv3, it gets
1687 * the first one that it is compatible.
1689 * NOTE: in order for this to work with applications like Kaffeine that
1690 * uses a DVBv5 call for DVB-S2 and a DVBv3 call to go back to
1691 * DVB-S, drivers that support both DVB-S and DVB-S2 should have the
1692 * SYS_DVBS entry before the SYS_DVBS2, otherwise it won't switch back
1695 static int dvbv3_set_delivery_system(struct dvb_frontend *fe)
1698 u32 delsys = SYS_UNDEFINED;
1699 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
1701 /* If not set yet, defaults to the first supported delivery system */
1702 if (c->delivery_system == SYS_UNDEFINED)
1703 c->delivery_system = fe->ops.delsys[0];
1706 * Trivial case: just use the current one, if it already a DVBv3
1709 if (is_dvbv3_delsys(c->delivery_system)) {
1710 dev_dbg(fe->dvb->device,
1711 "%s: Using delivery system to %d\n",
1712 __func__, c->delivery_system);
1717 * Seek for the first delivery system that it is compatible with a
1721 while (ncaps < MAX_DELSYS && fe->ops.delsys[ncaps]) {
1722 if (dvbv3_type(fe->ops.delsys[ncaps]) != DVBV3_UNKNOWN) {
1723 delsys = fe->ops.delsys[ncaps];
1728 if (delsys == SYS_UNDEFINED) {
1729 dev_dbg(fe->dvb->device,
1730 "%s: Couldn't find a delivery system that works with FE_SET_FRONTEND\n",
1734 return emulate_delivery_system(fe, delsys);
1738 * dtv_property_process_set - Sets a single DTV property
1739 * @fe: Pointer to &struct dvb_frontend
1740 * @file: Pointer to &struct file
1741 * @cmd: Digital TV command
1742 * @data: An unsigned 32-bits number
1744 * This routine assigns the property
1745 * value to the corresponding member of
1746 * &struct dtv_frontend_properties
1749 * Zero on success, negative errno on failure.
1751 static int dtv_property_process_set(struct dvb_frontend *fe,
1756 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
1758 /** Dump DTV command name and value*/
1759 if (!cmd || cmd > DTV_MAX_COMMAND)
1760 dev_warn(fe->dvb->device, "%s: SET cmd 0x%08x undefined\n",
1763 dev_dbg(fe->dvb->device,
1764 "%s: SET cmd 0x%08x (%s) to 0x%08x\n",
1765 __func__, cmd, dtv_cmds[cmd].name, data);
1769 * Reset a cache of data specific to the frontend here. This does
1770 * not effect hardware.
1772 dvb_frontend_clear_cache(fe);
1776 * Use the cached Digital TV properties to tune the
1779 dev_dbg(fe->dvb->device,
1780 "%s: Setting the frontend from property cache\n",
1783 r = dtv_set_frontend(fe);
1786 c->frequency = data;
1788 case DTV_MODULATION:
1789 c->modulation = data;
1791 case DTV_BANDWIDTH_HZ:
1792 c->bandwidth_hz = data;
1795 c->inversion = data;
1797 case DTV_SYMBOL_RATE:
1798 c->symbol_rate = data;
1801 c->fec_inner = data;
1809 case DTV_DELIVERY_SYSTEM:
1810 r = dvbv5_set_delivery_system(fe, data);
1814 r = dvb_frontend_handle_ioctl(file, FE_SET_VOLTAGE,
1815 (void *)c->voltage);
1819 r = dvb_frontend_handle_ioctl(file, FE_SET_TONE,
1820 (void *)c->sectone);
1822 case DTV_CODE_RATE_HP:
1823 c->code_rate_HP = data;
1825 case DTV_CODE_RATE_LP:
1826 c->code_rate_LP = data;
1828 case DTV_GUARD_INTERVAL:
1829 c->guard_interval = data;
1831 case DTV_TRANSMISSION_MODE:
1832 c->transmission_mode = data;
1835 c->hierarchy = data;
1837 case DTV_INTERLEAVING:
1838 c->interleaving = data;
1841 /* ISDB-T Support here */
1842 case DTV_ISDBT_PARTIAL_RECEPTION:
1843 c->isdbt_partial_reception = data;
1845 case DTV_ISDBT_SOUND_BROADCASTING:
1846 c->isdbt_sb_mode = data;
1848 case DTV_ISDBT_SB_SUBCHANNEL_ID:
1849 c->isdbt_sb_subchannel = data;
1851 case DTV_ISDBT_SB_SEGMENT_IDX:
1852 c->isdbt_sb_segment_idx = data;
1854 case DTV_ISDBT_SB_SEGMENT_COUNT:
1855 c->isdbt_sb_segment_count = data;
1857 case DTV_ISDBT_LAYER_ENABLED:
1858 c->isdbt_layer_enabled = data;
1860 case DTV_ISDBT_LAYERA_FEC:
1861 c->layer[0].fec = data;
1863 case DTV_ISDBT_LAYERA_MODULATION:
1864 c->layer[0].modulation = data;
1866 case DTV_ISDBT_LAYERA_SEGMENT_COUNT:
1867 c->layer[0].segment_count = data;
1869 case DTV_ISDBT_LAYERA_TIME_INTERLEAVING:
1870 c->layer[0].interleaving = data;
1872 case DTV_ISDBT_LAYERB_FEC:
1873 c->layer[1].fec = data;
1875 case DTV_ISDBT_LAYERB_MODULATION:
1876 c->layer[1].modulation = data;
1878 case DTV_ISDBT_LAYERB_SEGMENT_COUNT:
1879 c->layer[1].segment_count = data;
1881 case DTV_ISDBT_LAYERB_TIME_INTERLEAVING:
1882 c->layer[1].interleaving = data;
1884 case DTV_ISDBT_LAYERC_FEC:
1885 c->layer[2].fec = data;
1887 case DTV_ISDBT_LAYERC_MODULATION:
1888 c->layer[2].modulation = data;
1890 case DTV_ISDBT_LAYERC_SEGMENT_COUNT:
1891 c->layer[2].segment_count = data;
1893 case DTV_ISDBT_LAYERC_TIME_INTERLEAVING:
1894 c->layer[2].interleaving = data;
1897 /* Multistream support */
1899 case DTV_DVBT2_PLP_ID_LEGACY:
1900 c->stream_id = data;
1904 case DTV_ATSCMH_PARADE_ID:
1905 fe->dtv_property_cache.atscmh_parade_id = data;
1907 case DTV_ATSCMH_RS_FRAME_ENSEMBLE:
1908 fe->dtv_property_cache.atscmh_rs_frame_ensemble = data;
1913 if (fe->ops.set_lna)
1914 r = fe->ops.set_lna(fe);
1926 static int dvb_frontend_ioctl(struct file *file, unsigned int cmd, void *parg)
1928 struct dvb_device *dvbdev = file->private_data;
1929 struct dvb_frontend *fe = dvbdev->priv;
1930 struct dvb_frontend_private *fepriv = fe->frontend_priv;
1933 dev_dbg(fe->dvb->device, "%s: (%d)\n", __func__, _IOC_NR(cmd));
1934 if (down_interruptible(&fepriv->sem))
1935 return -ERESTARTSYS;
1937 if (fe->exit != DVB_FE_NO_EXIT) {
1943 * If the frontend is opened in read-only mode, only the ioctls
1944 * that don't interfere with the tune logic should be accepted.
1945 * That allows an external application to monitor the DVB QoS and
1946 * statistics parameters.
1948 * That matches all _IOR() ioctls, except for two special cases:
1949 * - FE_GET_EVENT is part of the tuning logic on a DVB application;
1950 * - FE_DISEQC_RECV_SLAVE_REPLY is part of DiSEqC 2.0
1952 * So, those two ioctls should also return -EPERM, as otherwise
1953 * reading from them would interfere with a DVB tune application
1955 if ((file->f_flags & O_ACCMODE) == O_RDONLY
1956 && (_IOC_DIR(cmd) != _IOC_READ
1957 || cmd == FE_GET_EVENT
1958 || cmd == FE_DISEQC_RECV_SLAVE_REPLY)) {
1963 err = dvb_frontend_handle_ioctl(file, cmd, parg);
1969 static int dtv_set_frontend(struct dvb_frontend *fe)
1971 struct dvb_frontend_private *fepriv = fe->frontend_priv;
1972 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
1973 struct dvb_frontend_tune_settings fetunesettings;
1976 if (dvb_frontend_check_parameters(fe) < 0)
1980 * Initialize output parameters to match the values given by
1981 * the user. FE_SET_FRONTEND triggers an initial frontend event
1982 * with status = 0, which copies output parameters to userspace.
1984 dtv_property_legacy_params_sync(fe, c, &fepriv->parameters_out);
1987 * Be sure that the bandwidth will be filled for all
1988 * non-satellite systems, as tuners need to know what
1989 * low pass/Nyquist half filter should be applied, in
1990 * order to avoid inter-channel noise.
1992 * ISDB-T and DVB-T/T2 already sets bandwidth.
1993 * ATSC and DVB-C don't set, so, the core should fill it.
1995 * On DVB-C Annex A and C, the bandwidth is a function of
1996 * the roll-off and symbol rate. Annex B defines different
1997 * roll-off factors depending on the modulation. Fortunately,
1998 * Annex B is only used with 6MHz, so there's no need to
2001 * While not officially supported, a side effect of handling it at
2002 * the cache level is that a program could retrieve the bandwidth
2003 * via DTV_BANDWIDTH_HZ, which may be useful for test programs.
2005 switch (c->delivery_system) {
2007 case SYS_DVBC_ANNEX_B:
2008 c->bandwidth_hz = 6000000;
2010 case SYS_DVBC_ANNEX_A:
2013 case SYS_DVBC_ANNEX_C:
2022 switch (c->rolloff) {
2038 c->bandwidth_hz = mult_frac(c->symbol_rate, rolloff, 100);
2040 /* force auto frequency inversion if requested */
2041 if (dvb_force_auto_inversion)
2042 c->inversion = INVERSION_AUTO;
2045 * without hierarchical coding code_rate_LP is irrelevant,
2046 * so we tolerate the otherwise invalid FEC_NONE setting
2048 if (c->hierarchy == HIERARCHY_NONE && c->code_rate_LP == FEC_NONE)
2049 c->code_rate_LP = FEC_AUTO;
2051 /* get frontend-specific tuning settings */
2052 memset(&fetunesettings, 0, sizeof(struct dvb_frontend_tune_settings));
2053 if (fe->ops.get_tune_settings && (fe->ops.get_tune_settings(fe, &fetunesettings) == 0)) {
2054 fepriv->min_delay = (fetunesettings.min_delay_ms * HZ) / 1000;
2055 fepriv->max_drift = fetunesettings.max_drift;
2056 fepriv->step_size = fetunesettings.step_size;
2058 /* default values */
2059 switch (c->delivery_system) {
2064 case SYS_DVBC_ANNEX_A:
2065 case SYS_DVBC_ANNEX_C:
2066 fepriv->min_delay = HZ / 20;
2067 fepriv->step_size = c->symbol_rate / 16000;
2068 fepriv->max_drift = c->symbol_rate / 2000;
2074 fepriv->min_delay = HZ / 20;
2075 fepriv->step_size = fe->ops.info.frequency_stepsize * 2;
2076 fepriv->max_drift = (fe->ops.info.frequency_stepsize * 2) + 1;
2080 * FIXME: This sounds wrong! if freqency_stepsize is
2081 * defined by the frontend, why not use it???
2083 fepriv->min_delay = HZ / 20;
2084 fepriv->step_size = 0; /* no zigzag */
2085 fepriv->max_drift = 0;
2089 if (dvb_override_tune_delay > 0)
2090 fepriv->min_delay = (dvb_override_tune_delay * HZ) / 1000;
2092 fepriv->state = FESTATE_RETUNE;
2094 /* Request the search algorithm to search */
2095 fepriv->algo_status |= DVBFE_ALGO_SEARCH_AGAIN;
2097 dvb_frontend_clear_events(fe);
2098 dvb_frontend_add_event(fe, 0);
2099 dvb_frontend_wakeup(fe);
2106 static int dvb_frontend_handle_ioctl(struct file *file,
2107 unsigned int cmd, void *parg)
2109 struct dvb_device *dvbdev = file->private_data;
2110 struct dvb_frontend *fe = dvbdev->priv;
2111 struct dvb_frontend_private *fepriv = fe->frontend_priv;
2112 struct dtv_frontend_properties *c = &fe->dtv_property_cache;
2115 dev_dbg(fe->dvb->device, "%s:\n", __func__);
2118 case FE_SET_PROPERTY: {
2119 struct dtv_properties *tvps = parg;
2120 struct dtv_property *tvp = NULL;
2122 dev_dbg(fe->dvb->device, "%s: properties.num = %d\n",
2123 __func__, tvps->num);
2124 dev_dbg(fe->dvb->device, "%s: properties.props = %p\n",
2125 __func__, tvps->props);
2128 * Put an arbitrary limit on the number of messages that can
2131 if (!tvps->num || (tvps->num > DTV_IOCTL_MAX_MSGS))
2134 tvp = memdup_user(tvps->props, tvps->num * sizeof(*tvp));
2136 return PTR_ERR(tvp);
2138 for (i = 0; i < tvps->num; i++) {
2139 err = dtv_property_process_set(fe, file,
2150 case FE_GET_PROPERTY: {
2151 struct dtv_properties *tvps = parg;
2152 struct dtv_property *tvp = NULL;
2153 struct dtv_frontend_properties getp = fe->dtv_property_cache;
2155 dev_dbg(fe->dvb->device, "%s: properties.num = %d\n",
2156 __func__, tvps->num);
2157 dev_dbg(fe->dvb->device, "%s: properties.props = %p\n",
2158 __func__, tvps->props);
2161 * Put an arbitrary limit on the number of messages that can
2164 if (!tvps->num || (tvps->num > DTV_IOCTL_MAX_MSGS))
2167 tvp = memdup_user(tvps->props, tvps->num * sizeof(*tvp));
2169 return PTR_ERR(tvp);
2172 * Let's use our own copy of property cache, in order to
2173 * avoid mangling with DTV zigzag logic, as drivers might
2174 * return crap, if they don't check if the data is available
2175 * before updating the properties cache.
2177 if (fepriv->state != FESTATE_IDLE) {
2178 err = dtv_get_frontend(fe, &getp, NULL);
2184 for (i = 0; i < tvps->num; i++) {
2185 err = dtv_property_process_get(fe, &getp,
2193 if (copy_to_user((void __user *)tvps->props, tvp,
2194 tvps->num * sizeof(struct dtv_property))) {
2203 struct dvb_frontend_info* info = parg;
2205 memcpy(info, &fe->ops.info, sizeof(struct dvb_frontend_info));
2206 dvb_frontend_get_frequency_limits(fe, &info->frequency_min, &info->frequency_max);
2209 * Associate the 4 delivery systems supported by DVBv3
2210 * API with their DVBv5 counterpart. For the other standards,
2211 * use the closest type, assuming that it would hopefully
2212 * work with a DVBv3 application.
2213 * It should be noticed that, on multi-frontend devices with
2214 * different types (terrestrial and cable, for example),
2215 * a pure DVBv3 application won't be able to use all delivery
2216 * systems. Yet, changing the DVBv5 cache to the other delivery
2217 * system should be enough for making it work.
2219 switch (dvbv3_type(c->delivery_system)) {
2221 info->type = FE_QPSK;
2224 info->type = FE_ATSC;
2227 info->type = FE_QAM;
2230 info->type = FE_OFDM;
2233 dev_err(fe->dvb->device,
2234 "%s: doesn't know how to handle a DVBv3 call to delivery system %i\n",
2235 __func__, c->delivery_system);
2236 fe->ops.info.type = FE_OFDM;
2238 dev_dbg(fe->dvb->device, "%s: current delivery system on cache: %d, V3 type: %d\n",
2239 __func__, c->delivery_system, fe->ops.info.type);
2241 /* Set CAN_INVERSION_AUTO bit on in other than oneshot mode */
2242 if (!(fepriv->tune_mode_flags & FE_TUNE_MODE_ONESHOT))
2243 info->caps |= FE_CAN_INVERSION_AUTO;
2248 case FE_READ_STATUS: {
2249 enum fe_status *status = parg;
2251 /* if retune was requested but hasn't occurred yet, prevent
2252 * that user get signal state from previous tuning */
2253 if (fepriv->state == FESTATE_RETUNE ||
2254 fepriv->state == FESTATE_ERROR) {
2260 if (fe->ops.read_status)
2261 err = fe->ops.read_status(fe, status);
2265 case FE_DISEQC_RESET_OVERLOAD:
2266 if (fe->ops.diseqc_reset_overload) {
2267 err = fe->ops.diseqc_reset_overload(fe);
2268 fepriv->state = FESTATE_DISEQC;
2273 case FE_DISEQC_SEND_MASTER_CMD:
2274 if (fe->ops.diseqc_send_master_cmd) {
2275 struct dvb_diseqc_master_cmd *cmd = parg;
2277 if (cmd->msg_len > sizeof(cmd->msg)) {
2281 err = fe->ops.diseqc_send_master_cmd(fe, cmd);
2282 fepriv->state = FESTATE_DISEQC;
2287 case FE_DISEQC_SEND_BURST:
2288 if (fe->ops.diseqc_send_burst) {
2289 err = fe->ops.diseqc_send_burst(fe,
2290 (enum fe_sec_mini_cmd)parg);
2291 fepriv->state = FESTATE_DISEQC;
2297 if (fe->ops.set_tone) {
2298 err = fe->ops.set_tone(fe,
2299 (enum fe_sec_tone_mode)parg);
2300 fepriv->tone = (enum fe_sec_tone_mode)parg;
2301 fepriv->state = FESTATE_DISEQC;
2306 case FE_SET_VOLTAGE:
2307 if (fe->ops.set_voltage) {
2308 err = fe->ops.set_voltage(fe,
2309 (enum fe_sec_voltage)parg);
2310 fepriv->voltage = (enum fe_sec_voltage)parg;
2311 fepriv->state = FESTATE_DISEQC;
2316 case FE_DISEQC_RECV_SLAVE_REPLY:
2317 if (fe->ops.diseqc_recv_slave_reply)
2318 err = fe->ops.diseqc_recv_slave_reply(fe, parg);
2321 case FE_ENABLE_HIGH_LNB_VOLTAGE:
2322 if (fe->ops.enable_high_lnb_voltage)
2323 err = fe->ops.enable_high_lnb_voltage(fe, (long) parg);
2326 case FE_SET_FRONTEND_TUNE_MODE:
2327 fepriv->tune_mode_flags = (unsigned long) parg;
2331 /* DEPRECATED dish control ioctls */
2333 case FE_DISHNETWORK_SEND_LEGACY_CMD:
2334 if (fe->ops.dishnetwork_send_legacy_command) {
2335 err = fe->ops.dishnetwork_send_legacy_command(fe,
2336 (unsigned long)parg);
2337 fepriv->state = FESTATE_DISEQC;
2339 } else if (fe->ops.set_voltage) {
2341 * NOTE: This is a fallback condition. Some frontends
2342 * (stv0299 for instance) take longer than 8msec to
2343 * respond to a set_voltage command. Those switches
2344 * need custom routines to switch properly. For all
2345 * other frontends, the following should work ok.
2346 * Dish network legacy switches (as used by Dish500)
2347 * are controlled by sending 9-bit command words
2348 * spaced 8msec apart.
2349 * the actual command word is switch/port dependent
2350 * so it is up to the userspace application to send
2351 * the right command.
2352 * The command must always start with a '0' after
2353 * initialization, so parg is 8 bits and does not
2354 * include the initialization or start bit
2356 unsigned long swcmd = ((unsigned long) parg) << 1;
2361 if (dvb_frontend_debug)
2362 dprintk("%s switch command: 0x%04lx\n",
2364 nexttime = ktime_get_boottime();
2365 if (dvb_frontend_debug)
2367 /* before sending a command, initialize by sending
2368 * a 32ms 18V to the switch
2370 fe->ops.set_voltage(fe, SEC_VOLTAGE_18);
2371 dvb_frontend_sleep_until(&nexttime, 32000);
2373 for (i = 0; i < 9; i++) {
2374 if (dvb_frontend_debug)
2375 tv[i+1] = ktime_get_boottime();
2376 if ((swcmd & 0x01) != last) {
2377 /* set voltage to (last ? 13V : 18V) */
2378 fe->ops.set_voltage(fe, (last) ? SEC_VOLTAGE_13 : SEC_VOLTAGE_18);
2379 last = (last) ? 0 : 1;
2383 dvb_frontend_sleep_until(&nexttime, 8000);
2385 if (dvb_frontend_debug) {
2386 dprintk("%s(%d): switch delay (should be 32k followed by all 8k)\n",
2387 __func__, fe->dvb->num);
2388 for (i = 1; i < 10; i++)
2389 pr_info("%d: %d\n", i,
2390 (int) ktime_us_delta(tv[i], tv[i-1]));
2393 fepriv->state = FESTATE_DISEQC;
2398 /* DEPRECATED statistics ioctls */
2401 if (fe->ops.read_ber) {
2403 err = fe->ops.read_ber(fe, parg);
2409 case FE_READ_SIGNAL_STRENGTH:
2410 if (fe->ops.read_signal_strength) {
2412 err = fe->ops.read_signal_strength(fe, parg);
2419 if (fe->ops.read_snr) {
2421 err = fe->ops.read_snr(fe, parg);
2427 case FE_READ_UNCORRECTED_BLOCKS:
2428 if (fe->ops.read_ucblocks) {
2430 err = fe->ops.read_ucblocks(fe, parg);
2436 /* DEPRECATED DVBv3 ioctls */
2438 case FE_SET_FRONTEND:
2439 err = dvbv3_set_delivery_system(fe);
2443 err = dtv_property_cache_sync(fe, c, parg);
2446 err = dtv_set_frontend(fe);
2449 err = dvb_frontend_get_event (fe, parg, file->f_flags);
2452 case FE_GET_FRONTEND: {
2453 struct dtv_frontend_properties getp = fe->dtv_property_cache;
2456 * Let's use our own copy of property cache, in order to
2457 * avoid mangling with DTV zigzag logic, as drivers might
2458 * return crap, if they don't check if the data is available
2459 * before updating the properties cache.
2461 err = dtv_get_frontend(fe, &getp, parg);
2473 static unsigned int dvb_frontend_poll(struct file *file, struct poll_table_struct *wait)
2475 struct dvb_device *dvbdev = file->private_data;
2476 struct dvb_frontend *fe = dvbdev->priv;
2477 struct dvb_frontend_private *fepriv = fe->frontend_priv;
2479 dev_dbg_ratelimited(fe->dvb->device, "%s:\n", __func__);
2481 poll_wait (file, &fepriv->events.wait_queue, wait);
2483 if (fepriv->events.eventw != fepriv->events.eventr)
2484 return (POLLIN | POLLRDNORM | POLLPRI);
2489 static int dvb_frontend_open(struct inode *inode, struct file *file)
2491 struct dvb_device *dvbdev = file->private_data;
2492 struct dvb_frontend *fe = dvbdev->priv;
2493 struct dvb_frontend_private *fepriv = fe->frontend_priv;
2494 struct dvb_adapter *adapter = fe->dvb;
2497 dev_dbg(fe->dvb->device, "%s:\n", __func__);
2498 if (fe->exit == DVB_FE_DEVICE_REMOVED)
2501 if (adapter->mfe_shared) {
2502 mutex_lock (&adapter->mfe_lock);
2504 if (adapter->mfe_dvbdev == NULL)
2505 adapter->mfe_dvbdev = dvbdev;
2507 else if (adapter->mfe_dvbdev != dvbdev) {
2509 *mfedev = adapter->mfe_dvbdev;
2511 *mfe = mfedev->priv;
2512 struct dvb_frontend_private
2513 *mfepriv = mfe->frontend_priv;
2514 int mferetry = (dvb_mfe_wait_time << 1);
2516 mutex_unlock (&adapter->mfe_lock);
2517 while (mferetry-- && (mfedev->users != -1 ||
2518 mfepriv->thread != NULL)) {
2519 if(msleep_interruptible(500)) {
2520 if(signal_pending(current))
2525 mutex_lock (&adapter->mfe_lock);
2526 if(adapter->mfe_dvbdev != dvbdev) {
2527 mfedev = adapter->mfe_dvbdev;
2529 mfepriv = mfe->frontend_priv;
2530 if (mfedev->users != -1 ||
2531 mfepriv->thread != NULL) {
2532 mutex_unlock (&adapter->mfe_lock);
2535 adapter->mfe_dvbdev = dvbdev;
2540 if (dvbdev->users == -1 && fe->ops.ts_bus_ctrl) {
2541 if ((ret = fe->ops.ts_bus_ctrl(fe, 1)) < 0)
2544 /* If we took control of the bus, we need to force
2545 reinitialization. This is because many ts_bus_ctrl()
2546 functions strobe the RESET pin on the demod, and if the
2547 frontend thread already exists then the dvb_init() routine
2548 won't get called (which is what usually does initial
2549 register configuration). */
2550 fepriv->reinitialise = 1;
2553 if ((ret = dvb_generic_open (inode, file)) < 0)
2556 if ((file->f_flags & O_ACCMODE) != O_RDONLY) {
2557 /* normal tune mode when opened R/W */
2558 fepriv->tune_mode_flags &= ~FE_TUNE_MODE_ONESHOT;
2560 fepriv->voltage = -1;
2562 #ifdef CONFIG_MEDIA_CONTROLLER_DVB
2563 if (fe->dvb->mdev) {
2564 mutex_lock(&fe->dvb->mdev->graph_mutex);
2565 if (fe->dvb->mdev->enable_source)
2566 ret = fe->dvb->mdev->enable_source(
2569 mutex_unlock(&fe->dvb->mdev->graph_mutex);
2571 dev_err(fe->dvb->device,
2572 "Tuner is busy. Error %d\n", ret);
2577 ret = dvb_frontend_start (fe);
2581 /* empty event queue */
2582 fepriv->events.eventr = fepriv->events.eventw = 0;
2585 dvb_frontend_get(fe);
2587 if (adapter->mfe_shared)
2588 mutex_unlock (&adapter->mfe_lock);
2592 #ifdef CONFIG_MEDIA_CONTROLLER_DVB
2593 if (fe->dvb->mdev) {
2594 mutex_lock(&fe->dvb->mdev->graph_mutex);
2595 if (fe->dvb->mdev->disable_source)
2596 fe->dvb->mdev->disable_source(dvbdev->entity);
2597 mutex_unlock(&fe->dvb->mdev->graph_mutex);
2601 dvb_generic_release(inode, file);
2603 if (dvbdev->users == -1 && fe->ops.ts_bus_ctrl)
2604 fe->ops.ts_bus_ctrl(fe, 0);
2606 if (adapter->mfe_shared)
2607 mutex_unlock (&adapter->mfe_lock);
2611 static int dvb_frontend_release(struct inode *inode, struct file *file)
2613 struct dvb_device *dvbdev = file->private_data;
2614 struct dvb_frontend *fe = dvbdev->priv;
2615 struct dvb_frontend_private *fepriv = fe->frontend_priv;
2618 dev_dbg(fe->dvb->device, "%s:\n", __func__);
2620 if ((file->f_flags & O_ACCMODE) != O_RDONLY) {
2621 fepriv->release_jiffies = jiffies;
2625 ret = dvb_generic_release (inode, file);
2627 if (dvbdev->users == -1) {
2628 wake_up(&fepriv->wait_queue);
2629 #ifdef CONFIG_MEDIA_CONTROLLER_DVB
2630 if (fe->dvb->mdev) {
2631 mutex_lock(&fe->dvb->mdev->graph_mutex);
2632 if (fe->dvb->mdev->disable_source)
2633 fe->dvb->mdev->disable_source(dvbdev->entity);
2634 mutex_unlock(&fe->dvb->mdev->graph_mutex);
2637 if (fe->exit != DVB_FE_NO_EXIT)
2638 wake_up(&dvbdev->wait_queue);
2639 if (fe->ops.ts_bus_ctrl)
2640 fe->ops.ts_bus_ctrl(fe, 0);
2643 dvb_frontend_put(fe);
2648 static const struct file_operations dvb_frontend_fops = {
2649 .owner = THIS_MODULE,
2650 .unlocked_ioctl = dvb_generic_ioctl,
2651 .poll = dvb_frontend_poll,
2652 .open = dvb_frontend_open,
2653 .release = dvb_frontend_release,
2654 .llseek = noop_llseek,
2657 int dvb_frontend_suspend(struct dvb_frontend *fe)
2661 dev_dbg(fe->dvb->device, "%s: adap=%d fe=%d\n", __func__, fe->dvb->num,
2664 if (fe->ops.tuner_ops.suspend)
2665 ret = fe->ops.tuner_ops.suspend(fe);
2666 else if (fe->ops.tuner_ops.sleep)
2667 ret = fe->ops.tuner_ops.sleep(fe);
2670 ret = fe->ops.sleep(fe);
2674 EXPORT_SYMBOL(dvb_frontend_suspend);
2676 int dvb_frontend_resume(struct dvb_frontend *fe)
2678 struct dvb_frontend_private *fepriv = fe->frontend_priv;
2681 dev_dbg(fe->dvb->device, "%s: adap=%d fe=%d\n", __func__, fe->dvb->num,
2684 fe->exit = DVB_FE_DEVICE_RESUME;
2686 ret = fe->ops.init(fe);
2688 if (fe->ops.tuner_ops.resume)
2689 ret = fe->ops.tuner_ops.resume(fe);
2690 else if (fe->ops.tuner_ops.init)
2691 ret = fe->ops.tuner_ops.init(fe);
2693 if (fe->ops.set_tone && fepriv->tone != -1)
2694 fe->ops.set_tone(fe, fepriv->tone);
2695 if (fe->ops.set_voltage && fepriv->voltage != -1)
2696 fe->ops.set_voltage(fe, fepriv->voltage);
2698 fe->exit = DVB_FE_NO_EXIT;
2699 fepriv->state = FESTATE_RETUNE;
2700 dvb_frontend_wakeup(fe);
2704 EXPORT_SYMBOL(dvb_frontend_resume);
2706 int dvb_register_frontend(struct dvb_adapter* dvb,
2707 struct dvb_frontend* fe)
2709 struct dvb_frontend_private *fepriv;
2710 const struct dvb_device dvbdev_template = {
2714 .fops = &dvb_frontend_fops,
2715 #if defined(CONFIG_MEDIA_CONTROLLER_DVB)
2716 .name = fe->ops.info.name,
2718 .kernel_ioctl = dvb_frontend_ioctl
2721 dev_dbg(dvb->device, "%s:\n", __func__);
2723 if (mutex_lock_interruptible(&frontend_mutex))
2724 return -ERESTARTSYS;
2726 fe->frontend_priv = kzalloc(sizeof(struct dvb_frontend_private), GFP_KERNEL);
2727 if (fe->frontend_priv == NULL) {
2728 mutex_unlock(&frontend_mutex);
2731 fepriv = fe->frontend_priv;
2733 kref_init(&fe->refcount);
2736 * After initialization, there need to be two references: one
2737 * for dvb_unregister_frontend(), and another one for
2738 * dvb_frontend_detach().
2740 dvb_frontend_get(fe);
2742 sema_init(&fepriv->sem, 1);
2743 init_waitqueue_head (&fepriv->wait_queue);
2744 init_waitqueue_head (&fepriv->events.wait_queue);
2745 mutex_init(&fepriv->events.mtx);
2747 fepriv->inversion = INVERSION_OFF;
2749 dev_info(fe->dvb->device,
2750 "DVB: registering adapter %i frontend %i (%s)...\n",
2751 fe->dvb->num, fe->id, fe->ops.info.name);
2753 dvb_register_device (fe->dvb, &fepriv->dvbdev, &dvbdev_template,
2754 fe, DVB_DEVICE_FRONTEND, 0);
2757 * Initialize the cache to the proper values according with the
2758 * first supported delivery system (ops->delsys[0])
2761 fe->dtv_property_cache.delivery_system = fe->ops.delsys[0];
2762 dvb_frontend_clear_cache(fe);
2764 mutex_unlock(&frontend_mutex);
2767 EXPORT_SYMBOL(dvb_register_frontend);
2769 int dvb_unregister_frontend(struct dvb_frontend* fe)
2771 struct dvb_frontend_private *fepriv = fe->frontend_priv;
2772 dev_dbg(fe->dvb->device, "%s:\n", __func__);
2774 mutex_lock(&frontend_mutex);
2775 dvb_frontend_stop(fe);
2776 dvb_remove_device(fepriv->dvbdev);
2778 /* fe is invalid now */
2779 mutex_unlock(&frontend_mutex);
2780 dvb_frontend_put(fe);
2783 EXPORT_SYMBOL(dvb_unregister_frontend);
2785 static void dvb_frontend_invoke_release(struct dvb_frontend *fe,
2786 void (*release)(struct dvb_frontend *fe))
2790 #ifdef CONFIG_MEDIA_ATTACH
2791 dvb_detach(release);
2796 void dvb_frontend_detach(struct dvb_frontend* fe)
2798 dvb_frontend_invoke_release(fe, fe->ops.release_sec);
2799 dvb_frontend_invoke_release(fe, fe->ops.tuner_ops.release);
2800 dvb_frontend_invoke_release(fe, fe->ops.analog_ops.release);
2801 dvb_frontend_invoke_release(fe, fe->ops.detach);
2802 dvb_frontend_put(fe);
2804 EXPORT_SYMBOL(dvb_frontend_detach);