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.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25 * Or, point your browser to http://www.gnu.org/copyleft/gpl.html
28 #include <linux/string.h>
29 #include <linux/kernel.h>
30 #include <linux/sched.h>
31 #include <linux/wait.h>
32 #include <linux/slab.h>
33 #include <linux/poll.h>
34 #include <linux/module.h>
35 #include <linux/list.h>
36 #include <linux/freezer.h>
37 #include <linux/jiffies.h>
38 #include <linux/kthread.h>
39 #include <asm/processor.h>
41 #include "dvb_frontend.h"
44 static int dvb_frontend_debug;
45 static int dvb_shutdown_timeout;
46 static int dvb_force_auto_inversion;
47 static int dvb_override_tune_delay;
48 static int dvb_powerdown_on_sleep = 1;
50 module_param_named(frontend_debug, dvb_frontend_debug, int, 0644);
51 MODULE_PARM_DESC(frontend_debug, "Turn on/off frontend core debugging (default:off).");
52 module_param(dvb_shutdown_timeout, int, 0644);
53 MODULE_PARM_DESC(dvb_shutdown_timeout, "wait <shutdown_timeout> seconds after close() before suspending hardware");
54 module_param(dvb_force_auto_inversion, int, 0644);
55 MODULE_PARM_DESC(dvb_force_auto_inversion, "0: normal (default), 1: INVERSION_AUTO forced always");
56 module_param(dvb_override_tune_delay, int, 0644);
57 MODULE_PARM_DESC(dvb_override_tune_delay, "0: normal (default), >0 => delay in milliseconds to wait for lock after a tune attempt");
58 module_param(dvb_powerdown_on_sleep, int, 0644);
59 MODULE_PARM_DESC(dvb_powerdown_on_sleep, "0: do not power down, 1: turn LNB voltage off on sleep (default)");
61 #define dprintk if (dvb_frontend_debug) printk
63 #define FESTATE_IDLE 1
64 #define FESTATE_RETUNE 2
65 #define FESTATE_TUNING_FAST 4
66 #define FESTATE_TUNING_SLOW 8
67 #define FESTATE_TUNED 16
68 #define FESTATE_ZIGZAG_FAST 32
69 #define FESTATE_ZIGZAG_SLOW 64
70 #define FESTATE_DISEQC 128
71 #define FESTATE_WAITFORLOCK (FESTATE_TUNING_FAST | FESTATE_TUNING_SLOW | FESTATE_ZIGZAG_FAST | FESTATE_ZIGZAG_SLOW | FESTATE_DISEQC)
72 #define FESTATE_SEARCHING_FAST (FESTATE_TUNING_FAST | FESTATE_ZIGZAG_FAST)
73 #define FESTATE_SEARCHING_SLOW (FESTATE_TUNING_SLOW | FESTATE_ZIGZAG_SLOW)
74 #define FESTATE_LOSTLOCK (FESTATE_ZIGZAG_FAST | FESTATE_ZIGZAG_SLOW)
78 * FESTATE_IDLE. No tuning parameters have been supplied and the loop is idling.
79 * FESTATE_RETUNE. Parameters have been supplied, but we have not yet performed the first tune.
80 * FESTATE_TUNING_FAST. Tuning parameters have been supplied and fast zigzag scan is in progress.
81 * FESTATE_TUNING_SLOW. Tuning parameters have been supplied. Fast zigzag failed, so we're trying again, but slower.
82 * FESTATE_TUNED. The frontend has successfully locked on.
83 * FESTATE_ZIGZAG_FAST. The lock has been lost, and a fast zigzag has been initiated to try and regain it.
84 * FESTATE_ZIGZAG_SLOW. The lock has been lost. Fast zigzag has been failed, so we're trying again, but slower.
85 * FESTATE_DISEQC. A DISEQC command has just been issued.
86 * FESTATE_WAITFORLOCK. When we're waiting for a lock.
87 * FESTATE_SEARCHING_FAST. When we're searching for a signal using a fast zigzag scan.
88 * FESTATE_SEARCHING_SLOW. When we're searching for a signal using a slow zigzag scan.
89 * FESTATE_LOSTLOCK. When the lock has been lost, and we're searching it again.
92 static DEFINE_MUTEX(frontend_mutex);
94 struct dvb_frontend_private {
96 /* thread/frontend values */
97 struct dvb_device *dvbdev;
98 struct dvb_frontend_parameters parameters;
99 struct dvb_fe_events events;
100 struct semaphore sem;
101 struct list_head list_head;
102 wait_queue_head_t wait_queue;
103 struct task_struct *thread;
104 unsigned long release_jiffies;
108 unsigned long tune_mode_flags;
110 unsigned int reinitialise;
114 /* swzigzag values */
116 unsigned int bending;
118 unsigned int inversion;
119 unsigned int auto_step;
120 unsigned int auto_sub_step;
121 unsigned int started_auto_step;
122 unsigned int min_delay;
123 unsigned int max_drift;
124 unsigned int step_size;
126 unsigned int check_wrapped;
129 static void dvb_frontend_wakeup(struct dvb_frontend *fe);
131 static void dvb_frontend_add_event(struct dvb_frontend *fe, fe_status_t status)
133 struct dvb_frontend_private *fepriv = fe->frontend_priv;
134 struct dvb_fe_events *events = &fepriv->events;
135 struct dvb_frontend_event *e;
138 dprintk ("%s\n", __FUNCTION__);
140 if (mutex_lock_interruptible (&events->mtx))
143 wp = (events->eventw + 1) % MAX_EVENT;
145 if (wp == events->eventr) {
146 events->overflow = 1;
147 events->eventr = (events->eventr + 1) % MAX_EVENT;
150 e = &events->events[events->eventw];
152 memcpy (&e->parameters, &fepriv->parameters,
153 sizeof (struct dvb_frontend_parameters));
155 if (status & FE_HAS_LOCK)
156 if (fe->ops.get_frontend)
157 fe->ops.get_frontend(fe, &e->parameters);
161 mutex_unlock(&events->mtx);
165 wake_up_interruptible (&events->wait_queue);
168 static int dvb_frontend_get_event(struct dvb_frontend *fe,
169 struct dvb_frontend_event *event, int flags)
171 struct dvb_frontend_private *fepriv = fe->frontend_priv;
172 struct dvb_fe_events *events = &fepriv->events;
174 dprintk ("%s\n", __FUNCTION__);
176 if (events->overflow) {
177 events->overflow = 0;
181 if (events->eventw == events->eventr) {
184 if (flags & O_NONBLOCK)
189 ret = wait_event_interruptible (events->wait_queue,
190 events->eventw != events->eventr);
192 if (down_interruptible (&fepriv->sem))
199 if (mutex_lock_interruptible (&events->mtx))
202 memcpy (event, &events->events[events->eventr],
203 sizeof(struct dvb_frontend_event));
205 events->eventr = (events->eventr + 1) % MAX_EVENT;
207 mutex_unlock(&events->mtx);
212 static void dvb_frontend_init(struct dvb_frontend *fe)
214 dprintk ("DVB: initialising frontend %i (%s)...\n",
220 if (fe->ops.tuner_ops.init) {
221 fe->ops.tuner_ops.init(fe);
222 if (fe->ops.i2c_gate_ctrl)
223 fe->ops.i2c_gate_ctrl(fe, 0);
227 void dvb_frontend_reinitialise(struct dvb_frontend *fe)
229 struct dvb_frontend_private *fepriv = fe->frontend_priv;
231 fepriv->reinitialise = 1;
232 dvb_frontend_wakeup(fe);
234 EXPORT_SYMBOL(dvb_frontend_reinitialise);
236 static void dvb_frontend_swzigzag_update_delay(struct dvb_frontend_private *fepriv, int locked)
240 dprintk ("%s\n", __FUNCTION__);
243 (fepriv->quality) = (fepriv->quality * 220 + 36*256) / 256;
245 (fepriv->quality) = (fepriv->quality * 220 + 0) / 256;
247 q2 = fepriv->quality - 128;
250 fepriv->delay = fepriv->min_delay + q2 * HZ / (128*128);
254 * Performs automatic twiddling of frontend parameters.
256 * @param fe The frontend concerned.
257 * @param check_wrapped Checks if an iteration has completed. DO NOT SET ON THE FIRST ATTEMPT
258 * @returns Number of complete iterations that have been performed.
260 static int dvb_frontend_swzigzag_autotune(struct dvb_frontend *fe, int check_wrapped)
264 struct dvb_frontend_private *fepriv = fe->frontend_priv;
265 int original_inversion = fepriv->parameters.inversion;
266 u32 original_frequency = fepriv->parameters.frequency;
268 /* are we using autoinversion? */
269 autoinversion = ((!(fe->ops.info.caps & FE_CAN_INVERSION_AUTO)) &&
270 (fepriv->parameters.inversion == INVERSION_AUTO));
272 /* setup parameters correctly */
274 /* calculate the lnb_drift */
275 fepriv->lnb_drift = fepriv->auto_step * fepriv->step_size;
277 /* wrap the auto_step if we've exceeded the maximum drift */
278 if (fepriv->lnb_drift > fepriv->max_drift) {
279 fepriv->auto_step = 0;
280 fepriv->auto_sub_step = 0;
281 fepriv->lnb_drift = 0;
284 /* perform inversion and +/- zigzag */
285 switch(fepriv->auto_sub_step) {
287 /* try with the current inversion and current drift setting */
292 if (!autoinversion) break;
294 fepriv->inversion = (fepriv->inversion == INVERSION_OFF) ? INVERSION_ON : INVERSION_OFF;
299 if (fepriv->lnb_drift == 0) break;
301 fepriv->lnb_drift = -fepriv->lnb_drift;
306 if (fepriv->lnb_drift == 0) break;
307 if (!autoinversion) break;
309 fepriv->inversion = (fepriv->inversion == INVERSION_OFF) ? INVERSION_ON : INVERSION_OFF;
310 fepriv->lnb_drift = -fepriv->lnb_drift;
316 fepriv->auto_sub_step = -1; /* it'll be incremented to 0 in a moment */
320 if (!ready) fepriv->auto_sub_step++;
323 /* if this attempt would hit where we started, indicate a complete
324 * iteration has occurred */
325 if ((fepriv->auto_step == fepriv->started_auto_step) &&
326 (fepriv->auto_sub_step == 0) && check_wrapped) {
330 dprintk("%s: drift:%i inversion:%i auto_step:%i "
331 "auto_sub_step:%i started_auto_step:%i\n",
332 __FUNCTION__, fepriv->lnb_drift, fepriv->inversion,
333 fepriv->auto_step, fepriv->auto_sub_step, fepriv->started_auto_step);
335 /* set the frontend itself */
336 fepriv->parameters.frequency += fepriv->lnb_drift;
338 fepriv->parameters.inversion = fepriv->inversion;
339 if (fe->ops.set_frontend)
340 fe->ops.set_frontend(fe, &fepriv->parameters);
342 fepriv->parameters.frequency = original_frequency;
343 fepriv->parameters.inversion = original_inversion;
345 fepriv->auto_sub_step++;
349 static void dvb_frontend_swzigzag(struct dvb_frontend *fe)
352 struct dvb_frontend_private *fepriv = fe->frontend_priv;
354 /* if we've got no parameters, just keep idling */
355 if (fepriv->state & FESTATE_IDLE) {
356 fepriv->delay = 3*HZ;
361 /* in SCAN mode, we just set the frontend when asked and leave it alone */
362 if (fepriv->tune_mode_flags & FE_TUNE_MODE_ONESHOT) {
363 if (fepriv->state & FESTATE_RETUNE) {
364 if (fe->ops.set_frontend)
365 fe->ops.set_frontend(fe, &fepriv->parameters);
366 fepriv->state = FESTATE_TUNED;
368 fepriv->delay = 3*HZ;
373 /* get the frontend status */
374 if (fepriv->state & FESTATE_RETUNE) {
377 if (fe->ops.read_status)
378 fe->ops.read_status(fe, &s);
379 if (s != fepriv->status) {
380 dvb_frontend_add_event(fe, s);
385 /* if we're not tuned, and we have a lock, move to the TUNED state */
386 if ((fepriv->state & FESTATE_WAITFORLOCK) && (s & FE_HAS_LOCK)) {
387 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
388 fepriv->state = FESTATE_TUNED;
390 /* if we're tuned, then we have determined the correct inversion */
391 if ((!(fe->ops.info.caps & FE_CAN_INVERSION_AUTO)) &&
392 (fepriv->parameters.inversion == INVERSION_AUTO)) {
393 fepriv->parameters.inversion = fepriv->inversion;
398 /* if we are tuned already, check we're still locked */
399 if (fepriv->state & FESTATE_TUNED) {
400 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
402 /* we're tuned, and the lock is still good... */
403 if (s & FE_HAS_LOCK) {
405 } else { /* if we _WERE_ tuned, but now don't have a lock */
406 fepriv->state = FESTATE_ZIGZAG_FAST;
407 fepriv->started_auto_step = fepriv->auto_step;
408 fepriv->check_wrapped = 0;
412 /* don't actually do anything if we're in the LOSTLOCK state,
413 * the frontend is set to FE_CAN_RECOVER, and the max_drift is 0 */
414 if ((fepriv->state & FESTATE_LOSTLOCK) &&
415 (fe->ops.info.caps & FE_CAN_RECOVER) && (fepriv->max_drift == 0)) {
416 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
420 /* don't do anything if we're in the DISEQC state, since this
421 * might be someone with a motorized dish controlled by DISEQC.
422 * If its actually a re-tune, there will be a SET_FRONTEND soon enough. */
423 if (fepriv->state & FESTATE_DISEQC) {
424 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
428 /* if we're in the RETUNE state, set everything up for a brand
429 * new scan, keeping the current inversion setting, as the next
430 * tune is _very_ likely to require the same */
431 if (fepriv->state & FESTATE_RETUNE) {
432 fepriv->lnb_drift = 0;
433 fepriv->auto_step = 0;
434 fepriv->auto_sub_step = 0;
435 fepriv->started_auto_step = 0;
436 fepriv->check_wrapped = 0;
440 if ((fepriv->state & FESTATE_SEARCHING_FAST) || (fepriv->state & FESTATE_RETUNE)) {
441 fepriv->delay = fepriv->min_delay;
444 if (dvb_frontend_swzigzag_autotune(fe, fepriv->check_wrapped)) {
445 /* OK, if we've run out of trials at the fast speed.
446 * Drop back to slow for the _next_ attempt */
447 fepriv->state = FESTATE_SEARCHING_SLOW;
448 fepriv->started_auto_step = fepriv->auto_step;
451 fepriv->check_wrapped = 1;
453 /* if we've just retuned, enter the ZIGZAG_FAST state.
454 * This ensures we cannot return from an
455 * FE_SET_FRONTEND ioctl before the first frontend tune
457 if (fepriv->state & FESTATE_RETUNE) {
458 fepriv->state = FESTATE_TUNING_FAST;
463 if (fepriv->state & FESTATE_SEARCHING_SLOW) {
464 dvb_frontend_swzigzag_update_delay(fepriv, s & FE_HAS_LOCK);
466 /* Note: don't bother checking for wrapping; we stay in this
467 * state until we get a lock */
468 dvb_frontend_swzigzag_autotune(fe, 0);
472 static int dvb_frontend_is_exiting(struct dvb_frontend *fe)
474 struct dvb_frontend_private *fepriv = fe->frontend_priv;
479 if (fepriv->dvbdev->writers == 1)
480 if (time_after(jiffies, fepriv->release_jiffies +
481 dvb_shutdown_timeout * HZ))
487 static int dvb_frontend_should_wakeup(struct dvb_frontend *fe)
489 struct dvb_frontend_private *fepriv = fe->frontend_priv;
491 if (fepriv->wakeup) {
495 return dvb_frontend_is_exiting(fe);
498 static void dvb_frontend_wakeup(struct dvb_frontend *fe)
500 struct dvb_frontend_private *fepriv = fe->frontend_priv;
503 wake_up_interruptible(&fepriv->wait_queue);
506 static int dvb_frontend_thread(void *data)
508 struct dvb_frontend *fe = data;
509 struct dvb_frontend_private *fepriv = fe->frontend_priv;
510 unsigned long timeout;
512 struct dvb_frontend_parameters *params;
514 dprintk("%s\n", __FUNCTION__);
516 fepriv->check_wrapped = 0;
518 fepriv->delay = 3*HZ;
521 fepriv->reinitialise = 0;
523 dvb_frontend_init(fe);
527 up(&fepriv->sem); /* is locked when we enter the thread... */
529 timeout = wait_event_interruptible_timeout(fepriv->wait_queue,
530 dvb_frontend_should_wakeup(fe) || kthread_should_stop()
531 || freezing(current),
534 if (kthread_should_stop() || dvb_frontend_is_exiting(fe)) {
535 /* got signal or quitting */
542 if (down_interruptible(&fepriv->sem))
545 if (fepriv->reinitialise) {
546 dvb_frontend_init(fe);
547 if (fepriv->tone != -1) {
548 fe->ops.set_tone(fe, fepriv->tone);
550 if (fepriv->voltage != -1) {
551 fe->ops.set_voltage(fe, fepriv->voltage);
553 fepriv->reinitialise = 0;
556 /* do an iteration of the tuning loop */
557 if (fe->ops.get_frontend_algo) {
558 if (fe->ops.get_frontend_algo(fe) == FE_ALGO_HW) {
559 /* have we been asked to retune? */
561 if (fepriv->state & FESTATE_RETUNE) {
562 params = &fepriv->parameters;
563 fepriv->state = FESTATE_TUNED;
566 fe->ops.tune(fe, params, fepriv->tune_mode_flags, &fepriv->delay, &s);
567 if (s != fepriv->status) {
568 dvb_frontend_add_event(fe, s);
572 dvb_frontend_swzigzag(fe);
574 dvb_frontend_swzigzag(fe);
577 if (dvb_powerdown_on_sleep) {
578 if (fe->ops.set_voltage)
579 fe->ops.set_voltage(fe, SEC_VOLTAGE_OFF);
580 if (fe->ops.tuner_ops.sleep) {
581 fe->ops.tuner_ops.sleep(fe);
582 if (fe->ops.i2c_gate_ctrl)
583 fe->ops.i2c_gate_ctrl(fe, 0);
589 fepriv->thread = NULL;
592 dvb_frontend_wakeup(fe);
596 static void dvb_frontend_stop(struct dvb_frontend *fe)
598 struct dvb_frontend_private *fepriv = fe->frontend_priv;
600 dprintk ("%s\n", __FUNCTION__);
608 kthread_stop(fepriv->thread);
610 init_MUTEX (&fepriv->sem);
611 fepriv->state = FESTATE_IDLE;
613 /* paranoia check in case a signal arrived */
615 printk("dvb_frontend_stop: warning: thread %p won't exit\n",
619 s32 timeval_usec_diff(struct timeval lasttime, struct timeval curtime)
621 return ((curtime.tv_usec < lasttime.tv_usec) ?
622 1000000 - lasttime.tv_usec + curtime.tv_usec :
623 curtime.tv_usec - lasttime.tv_usec);
625 EXPORT_SYMBOL(timeval_usec_diff);
627 static inline void timeval_usec_add(struct timeval *curtime, u32 add_usec)
629 curtime->tv_usec += add_usec;
630 if (curtime->tv_usec >= 1000000) {
631 curtime->tv_usec -= 1000000;
637 * Sleep until gettimeofday() > waketime + add_usec
638 * This needs to be as precise as possible, but as the delay is
639 * usually between 2ms and 32ms, it is done using a scheduled msleep
640 * followed by usleep (normally a busy-wait loop) for the remainder
642 void dvb_frontend_sleep_until(struct timeval *waketime, u32 add_usec)
644 struct timeval lasttime;
647 timeval_usec_add(waketime, add_usec);
649 do_gettimeofday(&lasttime);
650 delta = timeval_usec_diff(lasttime, *waketime);
652 msleep((delta - 1500) / 1000);
653 do_gettimeofday(&lasttime);
654 newdelta = timeval_usec_diff(lasttime, *waketime);
655 delta = (newdelta > delta) ? 0 : newdelta;
660 EXPORT_SYMBOL(dvb_frontend_sleep_until);
662 static int dvb_frontend_start(struct dvb_frontend *fe)
665 struct dvb_frontend_private *fepriv = fe->frontend_priv;
666 struct task_struct *fe_thread;
668 dprintk ("%s\n", __FUNCTION__);
670 if (fepriv->thread) {
674 dvb_frontend_stop (fe);
677 if (signal_pending(current))
679 if (down_interruptible (&fepriv->sem))
682 fepriv->state = FESTATE_IDLE;
684 fepriv->thread = NULL;
687 fe_thread = kthread_run(dvb_frontend_thread, fe,
688 "kdvb-fe-%i", fe->dvb->num);
689 if (IS_ERR(fe_thread)) {
690 ret = PTR_ERR(fe_thread);
691 printk("dvb_frontend_start: failed to start kthread (%d)\n", ret);
695 fepriv->thread = fe_thread;
699 static void dvb_frontend_get_frequeny_limits(struct dvb_frontend *fe,
700 u32 *freq_min, u32 *freq_max)
702 *freq_min = max(fe->ops.info.frequency_min, fe->ops.tuner_ops.info.frequency_min);
704 if (fe->ops.info.frequency_max == 0)
705 *freq_max = fe->ops.tuner_ops.info.frequency_max;
706 else if (fe->ops.tuner_ops.info.frequency_max == 0)
707 *freq_max = fe->ops.info.frequency_max;
709 *freq_max = min(fe->ops.info.frequency_max, fe->ops.tuner_ops.info.frequency_max);
711 if (*freq_min == 0 || *freq_max == 0)
712 printk(KERN_WARNING "DVB: frontend %u frequency limits undefined - fix the driver\n",
716 static int dvb_frontend_check_parameters(struct dvb_frontend *fe,
717 struct dvb_frontend_parameters *parms)
722 /* range check: frequency */
723 dvb_frontend_get_frequeny_limits(fe, &freq_min, &freq_max);
724 if ((freq_min && parms->frequency < freq_min) ||
725 (freq_max && parms->frequency > freq_max)) {
726 printk(KERN_WARNING "DVB: frontend %u frequency %u out of range (%u..%u)\n",
727 fe->dvb->num, parms->frequency, freq_min, freq_max);
731 /* range check: symbol rate */
732 if (fe->ops.info.type == FE_QPSK) {
733 if ((fe->ops.info.symbol_rate_min &&
734 parms->u.qpsk.symbol_rate < fe->ops.info.symbol_rate_min) ||
735 (fe->ops.info.symbol_rate_max &&
736 parms->u.qpsk.symbol_rate > fe->ops.info.symbol_rate_max)) {
737 printk(KERN_WARNING "DVB: frontend %u symbol rate %u out of range (%u..%u)\n",
738 fe->dvb->num, parms->u.qpsk.symbol_rate,
739 fe->ops.info.symbol_rate_min, fe->ops.info.symbol_rate_max);
743 } else if (fe->ops.info.type == FE_QAM) {
744 if ((fe->ops.info.symbol_rate_min &&
745 parms->u.qam.symbol_rate < fe->ops.info.symbol_rate_min) ||
746 (fe->ops.info.symbol_rate_max &&
747 parms->u.qam.symbol_rate > fe->ops.info.symbol_rate_max)) {
748 printk(KERN_WARNING "DVB: frontend %u symbol rate %u out of range (%u..%u)\n",
749 fe->dvb->num, parms->u.qam.symbol_rate,
750 fe->ops.info.symbol_rate_min, fe->ops.info.symbol_rate_max);
758 static int dvb_frontend_ioctl(struct inode *inode, struct file *file,
759 unsigned int cmd, void *parg)
761 struct dvb_device *dvbdev = file->private_data;
762 struct dvb_frontend *fe = dvbdev->priv;
763 struct dvb_frontend_private *fepriv = fe->frontend_priv;
764 int err = -EOPNOTSUPP;
766 dprintk ("%s\n", __FUNCTION__);
771 if ((file->f_flags & O_ACCMODE) == O_RDONLY &&
772 (_IOC_DIR(cmd) != _IOC_READ || cmd == FE_GET_EVENT ||
773 cmd == FE_DISEQC_RECV_SLAVE_REPLY))
776 if (down_interruptible (&fepriv->sem))
781 struct dvb_frontend_info* info = parg;
782 memcpy(info, &fe->ops.info, sizeof(struct dvb_frontend_info));
783 dvb_frontend_get_frequeny_limits(fe, &info->frequency_min, &info->frequency_max);
785 /* Force the CAN_INVERSION_AUTO bit on. If the frontend doesn't
786 * do it, it is done for it. */
787 info->caps |= FE_CAN_INVERSION_AUTO;
792 case FE_READ_STATUS: {
793 fe_status_t* status = parg;
795 /* if retune was requested but hasn't occured yet, prevent
796 * that user get signal state from previous tuning */
797 if(fepriv->state == FESTATE_RETUNE) {
803 if (fe->ops.read_status)
804 err = fe->ops.read_status(fe, status);
808 if (fe->ops.read_ber)
809 err = fe->ops.read_ber(fe, (__u32*) parg);
812 case FE_READ_SIGNAL_STRENGTH:
813 if (fe->ops.read_signal_strength)
814 err = fe->ops.read_signal_strength(fe, (__u16*) parg);
818 if (fe->ops.read_snr)
819 err = fe->ops.read_snr(fe, (__u16*) parg);
822 case FE_READ_UNCORRECTED_BLOCKS:
823 if (fe->ops.read_ucblocks)
824 err = fe->ops.read_ucblocks(fe, (__u32*) parg);
828 case FE_DISEQC_RESET_OVERLOAD:
829 if (fe->ops.diseqc_reset_overload) {
830 err = fe->ops.diseqc_reset_overload(fe);
831 fepriv->state = FESTATE_DISEQC;
836 case FE_DISEQC_SEND_MASTER_CMD:
837 if (fe->ops.diseqc_send_master_cmd) {
838 err = fe->ops.diseqc_send_master_cmd(fe, (struct dvb_diseqc_master_cmd*) parg);
839 fepriv->state = FESTATE_DISEQC;
844 case FE_DISEQC_SEND_BURST:
845 if (fe->ops.diseqc_send_burst) {
846 err = fe->ops.diseqc_send_burst(fe, (fe_sec_mini_cmd_t) parg);
847 fepriv->state = FESTATE_DISEQC;
853 if (fe->ops.set_tone) {
854 err = fe->ops.set_tone(fe, (fe_sec_tone_mode_t) parg);
855 fepriv->tone = (fe_sec_tone_mode_t) parg;
856 fepriv->state = FESTATE_DISEQC;
862 if (fe->ops.set_voltage) {
863 err = fe->ops.set_voltage(fe, (fe_sec_voltage_t) parg);
864 fepriv->voltage = (fe_sec_voltage_t) parg;
865 fepriv->state = FESTATE_DISEQC;
870 case FE_DISHNETWORK_SEND_LEGACY_CMD:
871 if (fe->ops.dishnetwork_send_legacy_command) {
872 err = fe->ops.dishnetwork_send_legacy_command(fe, (unsigned long) parg);
873 fepriv->state = FESTATE_DISEQC;
875 } else if (fe->ops.set_voltage) {
877 * NOTE: This is a fallback condition. Some frontends
878 * (stv0299 for instance) take longer than 8msec to
879 * respond to a set_voltage command. Those switches
880 * need custom routines to switch properly. For all
881 * other frontends, the following shoule work ok.
882 * Dish network legacy switches (as used by Dish500)
883 * are controlled by sending 9-bit command words
884 * spaced 8msec apart.
885 * the actual command word is switch/port dependant
886 * so it is up to the userspace application to send
888 * The command must always start with a '0' after
889 * initialization, so parg is 8 bits and does not
890 * include the initialization or start bit
892 unsigned long cmd = ((unsigned long) parg) << 1;
893 struct timeval nexttime;
894 struct timeval tv[10];
897 if (dvb_frontend_debug)
898 printk("%s switch command: 0x%04lx\n", __FUNCTION__, cmd);
899 do_gettimeofday(&nexttime);
900 if (dvb_frontend_debug)
901 memcpy(&tv[0], &nexttime, sizeof(struct timeval));
902 /* before sending a command, initialize by sending
903 * a 32ms 18V to the switch
905 fe->ops.set_voltage(fe, SEC_VOLTAGE_18);
906 dvb_frontend_sleep_until(&nexttime, 32000);
908 for (i = 0; i < 9; i++) {
909 if (dvb_frontend_debug)
910 do_gettimeofday(&tv[i + 1]);
911 if ((cmd & 0x01) != last) {
912 /* set voltage to (last ? 13V : 18V) */
913 fe->ops.set_voltage(fe, (last) ? SEC_VOLTAGE_13 : SEC_VOLTAGE_18);
914 last = (last) ? 0 : 1;
918 dvb_frontend_sleep_until(&nexttime, 8000);
920 if (dvb_frontend_debug) {
921 printk("%s(%d): switch delay (should be 32k followed by all 8k\n",
922 __FUNCTION__, fe->dvb->num);
923 for (i = 1; i < 10; i++)
924 printk("%d: %d\n", i, timeval_usec_diff(tv[i-1] , tv[i]));
927 fepriv->state = FESTATE_DISEQC;
932 case FE_DISEQC_RECV_SLAVE_REPLY:
933 if (fe->ops.diseqc_recv_slave_reply)
934 err = fe->ops.diseqc_recv_slave_reply(fe, (struct dvb_diseqc_slave_reply*) parg);
937 case FE_ENABLE_HIGH_LNB_VOLTAGE:
938 if (fe->ops.enable_high_lnb_voltage)
939 err = fe->ops.enable_high_lnb_voltage(fe, (long) parg);
942 case FE_SET_FRONTEND: {
943 struct dvb_frontend_tune_settings fetunesettings;
945 if (dvb_frontend_check_parameters(fe, parg) < 0) {
950 memcpy (&fepriv->parameters, parg,
951 sizeof (struct dvb_frontend_parameters));
953 memset(&fetunesettings, 0, sizeof(struct dvb_frontend_tune_settings));
954 memcpy(&fetunesettings.parameters, parg,
955 sizeof (struct dvb_frontend_parameters));
957 /* force auto frequency inversion if requested */
958 if (dvb_force_auto_inversion) {
959 fepriv->parameters.inversion = INVERSION_AUTO;
960 fetunesettings.parameters.inversion = INVERSION_AUTO;
962 if (fe->ops.info.type == FE_OFDM) {
963 /* without hierarchical coding code_rate_LP is irrelevant,
964 * so we tolerate the otherwise invalid FEC_NONE setting */
965 if (fepriv->parameters.u.ofdm.hierarchy_information == HIERARCHY_NONE &&
966 fepriv->parameters.u.ofdm.code_rate_LP == FEC_NONE)
967 fepriv->parameters.u.ofdm.code_rate_LP = FEC_AUTO;
970 /* get frontend-specific tuning settings */
971 if (fe->ops.get_tune_settings && (fe->ops.get_tune_settings(fe, &fetunesettings) == 0)) {
972 fepriv->min_delay = (fetunesettings.min_delay_ms * HZ) / 1000;
973 fepriv->max_drift = fetunesettings.max_drift;
974 fepriv->step_size = fetunesettings.step_size;
977 switch(fe->ops.info.type) {
979 fepriv->min_delay = HZ/20;
980 fepriv->step_size = fepriv->parameters.u.qpsk.symbol_rate / 16000;
981 fepriv->max_drift = fepriv->parameters.u.qpsk.symbol_rate / 2000;
985 fepriv->min_delay = HZ/20;
986 fepriv->step_size = 0; /* no zigzag */
987 fepriv->max_drift = 0;
991 fepriv->min_delay = HZ/20;
992 fepriv->step_size = fe->ops.info.frequency_stepsize * 2;
993 fepriv->max_drift = (fe->ops.info.frequency_stepsize * 2) + 1;
996 fepriv->min_delay = HZ/20;
997 fepriv->step_size = 0;
998 fepriv->max_drift = 0;
1002 if (dvb_override_tune_delay > 0)
1003 fepriv->min_delay = (dvb_override_tune_delay * HZ) / 1000;
1005 fepriv->state = FESTATE_RETUNE;
1006 dvb_frontend_wakeup(fe);
1007 dvb_frontend_add_event(fe, 0);
1014 err = dvb_frontend_get_event (fe, parg, file->f_flags);
1017 case FE_GET_FRONTEND:
1018 if (fe->ops.get_frontend) {
1019 memcpy (parg, &fepriv->parameters, sizeof (struct dvb_frontend_parameters));
1020 err = fe->ops.get_frontend(fe, (struct dvb_frontend_parameters*) parg);
1024 case FE_SET_FRONTEND_TUNE_MODE:
1025 fepriv->tune_mode_flags = (unsigned long) parg;
1034 static unsigned int dvb_frontend_poll(struct file *file, struct poll_table_struct *wait)
1036 struct dvb_device *dvbdev = file->private_data;
1037 struct dvb_frontend *fe = dvbdev->priv;
1038 struct dvb_frontend_private *fepriv = fe->frontend_priv;
1040 dprintk ("%s\n", __FUNCTION__);
1042 poll_wait (file, &fepriv->events.wait_queue, wait);
1044 if (fepriv->events.eventw != fepriv->events.eventr)
1045 return (POLLIN | POLLRDNORM | POLLPRI);
1050 static int dvb_frontend_open(struct inode *inode, struct file *file)
1052 struct dvb_device *dvbdev = file->private_data;
1053 struct dvb_frontend *fe = dvbdev->priv;
1054 struct dvb_frontend_private *fepriv = fe->frontend_priv;
1057 dprintk ("%s\n", __FUNCTION__);
1059 if (dvbdev->users == -1 && fe->ops.ts_bus_ctrl) {
1060 if ((ret = fe->ops.ts_bus_ctrl(fe, 1)) < 0)
1064 if ((ret = dvb_generic_open (inode, file)) < 0)
1067 if ((file->f_flags & O_ACCMODE) != O_RDONLY) {
1068 /* normal tune mode when opened R/W */
1069 fepriv->tune_mode_flags &= ~FE_TUNE_MODE_ONESHOT;
1071 fepriv->voltage = -1;
1073 ret = dvb_frontend_start (fe);
1077 /* empty event queue */
1078 fepriv->events.eventr = fepriv->events.eventw = 0;
1084 dvb_generic_release(inode, file);
1086 if (dvbdev->users == -1 && fe->ops.ts_bus_ctrl)
1087 fe->ops.ts_bus_ctrl(fe, 0);
1091 static int dvb_frontend_release(struct inode *inode, struct file *file)
1093 struct dvb_device *dvbdev = file->private_data;
1094 struct dvb_frontend *fe = dvbdev->priv;
1095 struct dvb_frontend_private *fepriv = fe->frontend_priv;
1098 dprintk ("%s\n", __FUNCTION__);
1100 if ((file->f_flags & O_ACCMODE) != O_RDONLY)
1101 fepriv->release_jiffies = jiffies;
1103 ret = dvb_generic_release (inode, file);
1105 if (dvbdev->users == -1) {
1106 if (fepriv->exit == 1) {
1107 fops_put(file->f_op);
1109 wake_up(&dvbdev->wait_queue);
1111 if (fe->ops.ts_bus_ctrl)
1112 fe->ops.ts_bus_ctrl(fe, 0);
1118 static struct file_operations dvb_frontend_fops = {
1119 .owner = THIS_MODULE,
1120 .ioctl = dvb_generic_ioctl,
1121 .poll = dvb_frontend_poll,
1122 .open = dvb_frontend_open,
1123 .release = dvb_frontend_release
1126 int dvb_register_frontend(struct dvb_adapter* dvb,
1127 struct dvb_frontend* fe)
1129 struct dvb_frontend_private *fepriv;
1130 static const struct dvb_device dvbdev_template = {
1134 .fops = &dvb_frontend_fops,
1135 .kernel_ioctl = dvb_frontend_ioctl
1138 dprintk ("%s\n", __FUNCTION__);
1140 if (mutex_lock_interruptible(&frontend_mutex))
1141 return -ERESTARTSYS;
1143 fe->frontend_priv = kzalloc(sizeof(struct dvb_frontend_private), GFP_KERNEL);
1144 if (fe->frontend_priv == NULL) {
1145 mutex_unlock(&frontend_mutex);
1148 fepriv = fe->frontend_priv;
1150 init_MUTEX (&fepriv->sem);
1151 init_waitqueue_head (&fepriv->wait_queue);
1152 init_waitqueue_head (&fepriv->events.wait_queue);
1153 mutex_init(&fepriv->events.mtx);
1155 fepriv->inversion = INVERSION_OFF;
1157 printk ("DVB: registering frontend %i (%s)...\n",
1161 dvb_register_device (fe->dvb, &fepriv->dvbdev, &dvbdev_template,
1162 fe, DVB_DEVICE_FRONTEND);
1164 mutex_unlock(&frontend_mutex);
1167 EXPORT_SYMBOL(dvb_register_frontend);
1169 int dvb_unregister_frontend(struct dvb_frontend* fe)
1171 struct dvb_frontend_private *fepriv = fe->frontend_priv;
1172 dprintk ("%s\n", __FUNCTION__);
1174 mutex_lock(&frontend_mutex);
1175 dvb_frontend_stop (fe);
1176 mutex_unlock(&frontend_mutex);
1178 if (fepriv->dvbdev->users < -1)
1179 wait_event(fepriv->dvbdev->wait_queue,
1180 fepriv->dvbdev->users==-1);
1182 mutex_lock(&frontend_mutex);
1183 dvb_unregister_device (fepriv->dvbdev);
1185 /* fe is invalid now */
1187 mutex_unlock(&frontend_mutex);
1190 EXPORT_SYMBOL(dvb_unregister_frontend);
1192 #ifdef CONFIG_DVB_CORE_ATTACH
1193 void dvb_frontend_detach(struct dvb_frontend* fe)
1197 if (fe->ops.release_sec) {
1198 fe->ops.release_sec(fe);
1199 symbol_put_addr(fe->ops.release_sec);
1201 if (fe->ops.tuner_ops.release) {
1202 fe->ops.tuner_ops.release(fe);
1203 symbol_put_addr(fe->ops.tuner_ops.release);
1205 ptr = (void*)fe->ops.release;
1207 fe->ops.release(fe);
1208 symbol_put_addr(ptr);
1212 void dvb_frontend_detach(struct dvb_frontend* fe)
1214 if (fe->ops.release_sec)
1215 fe->ops.release_sec(fe);
1216 if (fe->ops.tuner_ops.release)
1217 fe->ops.tuner_ops.release(fe);
1218 if (fe->ops.release)
1219 fe->ops.release(fe);
1222 EXPORT_SYMBOL(dvb_frontend_detach);