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", __func__
);
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", __func__
);
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", __func__
);
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 __func__
, 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", __func__
);
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", __func__
);
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", __func__
);
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", __func__
);
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", __func__
, 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 __func__
, 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", __func__
);
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", __func__
);
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", __func__
);
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", __func__
);
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", __func__
);
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_MEDIA_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 if (fe
->ops
.analog_ops
.release
) {
1206 fe
->ops
.analog_ops
.release(fe
);
1207 symbol_put_addr(fe
->ops
.analog_ops
.release
);
1209 ptr
= (void*)fe
->ops
.release
;
1211 fe
->ops
.release(fe
);
1212 symbol_put_addr(ptr
);
1216 void dvb_frontend_detach(struct dvb_frontend
* fe
)
1218 if (fe
->ops
.release_sec
)
1219 fe
->ops
.release_sec(fe
);
1220 if (fe
->ops
.tuner_ops
.release
)
1221 fe
->ops
.tuner_ops
.release(fe
);
1222 if (fe
->ops
.analog_ops
.release
)
1223 fe
->ops
.analog_ops
.release(fe
);
1224 if (fe
->ops
.release
)
1225 fe
->ops
.release(fe
);
1228 EXPORT_SYMBOL(dvb_frontend_detach
);