Linux 4.16.11
[linux/fpc-iii.git] / drivers / media / rc / img-ir / img-ir-hw.c
blobec4ded84cd170b93d231eeff298c6a9d0a5b56c9
1 /*
2 * ImgTec IR Hardware Decoder found in PowerDown Controller.
4 * Copyright 2010-2014 Imagination Technologies Ltd.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by the
8 * Free Software Foundation; either version 2 of the License, or (at your
9 * option) any later version.
11 * This ties into the input subsystem using the RC-core. Protocol support is
12 * provided in separate modules which provide the parameters and scancode
13 * translation functions to set up the hardware decoder and interpret the
14 * resulting input.
17 #include <linux/bitops.h>
18 #include <linux/clk.h>
19 #include <linux/interrupt.h>
20 #include <linux/spinlock.h>
21 #include <linux/timer.h>
22 #include <media/rc-core.h>
23 #include "img-ir.h"
25 /* Decoders lock (only modified to preprocess them) */
26 static DEFINE_SPINLOCK(img_ir_decoders_lock);
28 static bool img_ir_decoders_preprocessed;
29 static struct img_ir_decoder *img_ir_decoders[] = {
30 #ifdef CONFIG_IR_IMG_NEC
31 &img_ir_nec,
32 #endif
33 #ifdef CONFIG_IR_IMG_JVC
34 &img_ir_jvc,
35 #endif
36 #ifdef CONFIG_IR_IMG_SONY
37 &img_ir_sony,
38 #endif
39 #ifdef CONFIG_IR_IMG_SHARP
40 &img_ir_sharp,
41 #endif
42 #ifdef CONFIG_IR_IMG_SANYO
43 &img_ir_sanyo,
44 #endif
45 #ifdef CONFIG_IR_IMG_RC5
46 &img_ir_rc5,
47 #endif
48 #ifdef CONFIG_IR_IMG_RC6
49 &img_ir_rc6,
50 #endif
51 NULL
54 #define IMG_IR_F_FILTER BIT(RC_FILTER_NORMAL) /* enable filtering */
55 #define IMG_IR_F_WAKE BIT(RC_FILTER_WAKEUP) /* enable waking */
57 /* code type quirks */
59 #define IMG_IR_QUIRK_CODE_BROKEN 0x1 /* Decode is broken */
60 #define IMG_IR_QUIRK_CODE_LEN_INCR 0x2 /* Bit length needs increment */
62 * The decoder generates rapid interrupts without actually having
63 * received any new data after an incomplete IR code is decoded.
65 #define IMG_IR_QUIRK_CODE_IRQ 0x4
67 /* functions for preprocessing timings, ensuring max is set */
69 static void img_ir_timing_preprocess(struct img_ir_timing_range *range,
70 unsigned int unit)
72 if (range->max < range->min)
73 range->max = range->min;
74 if (unit) {
75 /* multiply by unit and convert to microseconds */
76 range->min = (range->min*unit)/1000;
77 range->max = (range->max*unit + 999)/1000; /* round up */
81 static void img_ir_symbol_timing_preprocess(struct img_ir_symbol_timing *timing,
82 unsigned int unit)
84 img_ir_timing_preprocess(&timing->pulse, unit);
85 img_ir_timing_preprocess(&timing->space, unit);
88 static void img_ir_timings_preprocess(struct img_ir_timings *timings,
89 unsigned int unit)
91 img_ir_symbol_timing_preprocess(&timings->ldr, unit);
92 img_ir_symbol_timing_preprocess(&timings->s00, unit);
93 img_ir_symbol_timing_preprocess(&timings->s01, unit);
94 img_ir_symbol_timing_preprocess(&timings->s10, unit);
95 img_ir_symbol_timing_preprocess(&timings->s11, unit);
96 /* default s10 and s11 to s00 and s01 if no leader */
97 if (unit)
98 /* multiply by unit and convert to microseconds (round up) */
99 timings->ft.ft_min = (timings->ft.ft_min*unit + 999)/1000;
102 /* functions for filling empty fields with defaults */
104 static void img_ir_timing_defaults(struct img_ir_timing_range *range,
105 struct img_ir_timing_range *defaults)
107 if (!range->min)
108 range->min = defaults->min;
109 if (!range->max)
110 range->max = defaults->max;
113 static void img_ir_symbol_timing_defaults(struct img_ir_symbol_timing *timing,
114 struct img_ir_symbol_timing *defaults)
116 img_ir_timing_defaults(&timing->pulse, &defaults->pulse);
117 img_ir_timing_defaults(&timing->space, &defaults->space);
120 static void img_ir_timings_defaults(struct img_ir_timings *timings,
121 struct img_ir_timings *defaults)
123 img_ir_symbol_timing_defaults(&timings->ldr, &defaults->ldr);
124 img_ir_symbol_timing_defaults(&timings->s00, &defaults->s00);
125 img_ir_symbol_timing_defaults(&timings->s01, &defaults->s01);
126 img_ir_symbol_timing_defaults(&timings->s10, &defaults->s10);
127 img_ir_symbol_timing_defaults(&timings->s11, &defaults->s11);
128 if (!timings->ft.ft_min)
129 timings->ft.ft_min = defaults->ft.ft_min;
132 /* functions for converting timings to register values */
135 * img_ir_control() - Convert control struct to control register value.
136 * @control: Control data
138 * Returns: The control register value equivalent of @control.
140 static u32 img_ir_control(const struct img_ir_control *control)
142 u32 ctrl = control->code_type << IMG_IR_CODETYPE_SHIFT;
143 if (control->decoden)
144 ctrl |= IMG_IR_DECODEN;
145 if (control->hdrtog)
146 ctrl |= IMG_IR_HDRTOG;
147 if (control->ldrdec)
148 ctrl |= IMG_IR_LDRDEC;
149 if (control->decodinpol)
150 ctrl |= IMG_IR_DECODINPOL;
151 if (control->bitorien)
152 ctrl |= IMG_IR_BITORIEN;
153 if (control->d1validsel)
154 ctrl |= IMG_IR_D1VALIDSEL;
155 if (control->bitinv)
156 ctrl |= IMG_IR_BITINV;
157 if (control->decodend2)
158 ctrl |= IMG_IR_DECODEND2;
159 if (control->bitoriend2)
160 ctrl |= IMG_IR_BITORIEND2;
161 if (control->bitinvd2)
162 ctrl |= IMG_IR_BITINVD2;
163 return ctrl;
167 * img_ir_timing_range_convert() - Convert microsecond range.
168 * @out: Output timing range in clock cycles with a shift.
169 * @in: Input timing range in microseconds.
170 * @tolerance: Tolerance as a fraction of 128 (roughly percent).
171 * @clock_hz: IR clock rate in Hz.
172 * @shift: Shift of output units.
174 * Converts min and max from microseconds to IR clock cycles, applies a
175 * tolerance, and shifts for the register, rounding in the right direction.
176 * Note that in and out can safely be the same object.
178 static void img_ir_timing_range_convert(struct img_ir_timing_range *out,
179 const struct img_ir_timing_range *in,
180 unsigned int tolerance,
181 unsigned long clock_hz,
182 unsigned int shift)
184 unsigned int min = in->min;
185 unsigned int max = in->max;
186 /* add a tolerance */
187 min = min - (min*tolerance >> 7);
188 max = max + (max*tolerance >> 7);
189 /* convert from microseconds into clock cycles */
190 min = min*clock_hz / 1000000;
191 max = (max*clock_hz + 999999) / 1000000; /* round up */
192 /* apply shift and copy to output */
193 out->min = min >> shift;
194 out->max = (max + ((1 << shift) - 1)) >> shift; /* round up */
198 * img_ir_symbol_timing() - Convert symbol timing struct to register value.
199 * @timing: Symbol timing data
200 * @tolerance: Timing tolerance where 0-128 represents 0-100%
201 * @clock_hz: Frequency of source clock in Hz
202 * @pd_shift: Shift to apply to symbol period
203 * @w_shift: Shift to apply to symbol width
205 * Returns: Symbol timing register value based on arguments.
207 static u32 img_ir_symbol_timing(const struct img_ir_symbol_timing *timing,
208 unsigned int tolerance,
209 unsigned long clock_hz,
210 unsigned int pd_shift,
211 unsigned int w_shift)
213 struct img_ir_timing_range hw_pulse, hw_period;
214 /* we calculate period in hw_period, then convert in place */
215 hw_period.min = timing->pulse.min + timing->space.min;
216 hw_period.max = timing->pulse.max + timing->space.max;
217 img_ir_timing_range_convert(&hw_period, &hw_period,
218 tolerance, clock_hz, pd_shift);
219 img_ir_timing_range_convert(&hw_pulse, &timing->pulse,
220 tolerance, clock_hz, w_shift);
221 /* construct register value */
222 return (hw_period.max << IMG_IR_PD_MAX_SHIFT) |
223 (hw_period.min << IMG_IR_PD_MIN_SHIFT) |
224 (hw_pulse.max << IMG_IR_W_MAX_SHIFT) |
225 (hw_pulse.min << IMG_IR_W_MIN_SHIFT);
229 * img_ir_free_timing() - Convert free time timing struct to register value.
230 * @timing: Free symbol timing data
231 * @clock_hz: Source clock frequency in Hz
233 * Returns: Free symbol timing register value.
235 static u32 img_ir_free_timing(const struct img_ir_free_timing *timing,
236 unsigned long clock_hz)
238 unsigned int minlen, maxlen, ft_min;
239 /* minlen is only 5 bits, and round minlen to multiple of 2 */
240 if (timing->minlen < 30)
241 minlen = timing->minlen & -2;
242 else
243 minlen = 30;
244 /* maxlen has maximum value of 48, and round maxlen to multiple of 2 */
245 if (timing->maxlen < 48)
246 maxlen = (timing->maxlen + 1) & -2;
247 else
248 maxlen = 48;
249 /* convert and shift ft_min, rounding upwards */
250 ft_min = (timing->ft_min*clock_hz + 999999) / 1000000;
251 ft_min = (ft_min + 7) >> 3;
252 /* construct register value */
253 return (maxlen << IMG_IR_MAXLEN_SHIFT) |
254 (minlen << IMG_IR_MINLEN_SHIFT) |
255 (ft_min << IMG_IR_FT_MIN_SHIFT);
259 * img_ir_free_timing_dynamic() - Update free time register value.
260 * @st_ft: Static free time register value from img_ir_free_timing.
261 * @filter: Current filter which may additionally restrict min/max len.
263 * Returns: Updated free time register value based on the current filter.
265 static u32 img_ir_free_timing_dynamic(u32 st_ft, struct img_ir_filter *filter)
267 unsigned int minlen, maxlen, newminlen, newmaxlen;
269 /* round minlen, maxlen to multiple of 2 */
270 newminlen = filter->minlen & -2;
271 newmaxlen = (filter->maxlen + 1) & -2;
272 /* extract min/max len from register */
273 minlen = (st_ft & IMG_IR_MINLEN) >> IMG_IR_MINLEN_SHIFT;
274 maxlen = (st_ft & IMG_IR_MAXLEN) >> IMG_IR_MAXLEN_SHIFT;
275 /* if the new values are more restrictive, update the register value */
276 if (newminlen > minlen) {
277 st_ft &= ~IMG_IR_MINLEN;
278 st_ft |= newminlen << IMG_IR_MINLEN_SHIFT;
280 if (newmaxlen < maxlen) {
281 st_ft &= ~IMG_IR_MAXLEN;
282 st_ft |= newmaxlen << IMG_IR_MAXLEN_SHIFT;
284 return st_ft;
288 * img_ir_timings_convert() - Convert timings to register values
289 * @regs: Output timing register values
290 * @timings: Input timing data
291 * @tolerance: Timing tolerance where 0-128 represents 0-100%
292 * @clock_hz: Source clock frequency in Hz
294 static void img_ir_timings_convert(struct img_ir_timing_regvals *regs,
295 const struct img_ir_timings *timings,
296 unsigned int tolerance,
297 unsigned int clock_hz)
299 /* leader symbol timings are divided by 16 */
300 regs->ldr = img_ir_symbol_timing(&timings->ldr, tolerance, clock_hz,
301 4, 4);
302 /* other symbol timings, pd fields only are divided by 2 */
303 regs->s00 = img_ir_symbol_timing(&timings->s00, tolerance, clock_hz,
304 1, 0);
305 regs->s01 = img_ir_symbol_timing(&timings->s01, tolerance, clock_hz,
306 1, 0);
307 regs->s10 = img_ir_symbol_timing(&timings->s10, tolerance, clock_hz,
308 1, 0);
309 regs->s11 = img_ir_symbol_timing(&timings->s11, tolerance, clock_hz,
310 1, 0);
311 regs->ft = img_ir_free_timing(&timings->ft, clock_hz);
315 * img_ir_decoder_preprocess() - Preprocess timings in decoder.
316 * @decoder: Decoder to be preprocessed.
318 * Ensures that the symbol timing ranges are valid with respect to ordering, and
319 * does some fixed conversion on them.
321 static void img_ir_decoder_preprocess(struct img_ir_decoder *decoder)
323 /* default tolerance */
324 if (!decoder->tolerance)
325 decoder->tolerance = 10; /* percent */
326 /* and convert tolerance to fraction out of 128 */
327 decoder->tolerance = decoder->tolerance * 128 / 100;
329 /* fill in implicit fields */
330 img_ir_timings_preprocess(&decoder->timings, decoder->unit);
332 /* do the same for repeat timings if applicable */
333 if (decoder->repeat) {
334 img_ir_timings_preprocess(&decoder->rtimings, decoder->unit);
335 img_ir_timings_defaults(&decoder->rtimings, &decoder->timings);
340 * img_ir_decoder_convert() - Generate internal timings in decoder.
341 * @decoder: Decoder to be converted to internal timings.
342 * @reg_timings: Timing register values.
343 * @clock_hz: IR clock rate in Hz.
345 * Fills out the repeat timings and timing register values for a specific clock
346 * rate.
348 static void img_ir_decoder_convert(const struct img_ir_decoder *decoder,
349 struct img_ir_reg_timings *reg_timings,
350 unsigned int clock_hz)
352 /* calculate control value */
353 reg_timings->ctrl = img_ir_control(&decoder->control);
355 /* fill in implicit fields and calculate register values */
356 img_ir_timings_convert(&reg_timings->timings, &decoder->timings,
357 decoder->tolerance, clock_hz);
359 /* do the same for repeat timings if applicable */
360 if (decoder->repeat)
361 img_ir_timings_convert(&reg_timings->rtimings,
362 &decoder->rtimings, decoder->tolerance,
363 clock_hz);
367 * img_ir_write_timings() - Write timings to the hardware now
368 * @priv: IR private data
369 * @regs: Timing register values to write
370 * @type: RC filter type (RC_FILTER_*)
372 * Write timing register values @regs to the hardware, taking into account the
373 * current filter which may impose restrictions on the length of the expected
374 * data.
376 static void img_ir_write_timings(struct img_ir_priv *priv,
377 struct img_ir_timing_regvals *regs,
378 enum rc_filter_type type)
380 struct img_ir_priv_hw *hw = &priv->hw;
382 /* filter may be more restrictive to minlen, maxlen */
383 u32 ft = regs->ft;
384 if (hw->flags & BIT(type))
385 ft = img_ir_free_timing_dynamic(regs->ft, &hw->filters[type]);
386 /* write to registers */
387 img_ir_write(priv, IMG_IR_LEAD_SYMB_TIMING, regs->ldr);
388 img_ir_write(priv, IMG_IR_S00_SYMB_TIMING, regs->s00);
389 img_ir_write(priv, IMG_IR_S01_SYMB_TIMING, regs->s01);
390 img_ir_write(priv, IMG_IR_S10_SYMB_TIMING, regs->s10);
391 img_ir_write(priv, IMG_IR_S11_SYMB_TIMING, regs->s11);
392 img_ir_write(priv, IMG_IR_FREE_SYMB_TIMING, ft);
393 dev_dbg(priv->dev, "timings: ldr=%#x, s=[%#x, %#x, %#x, %#x], ft=%#x\n",
394 regs->ldr, regs->s00, regs->s01, regs->s10, regs->s11, ft);
397 static void img_ir_write_filter(struct img_ir_priv *priv,
398 struct img_ir_filter *filter)
400 if (filter) {
401 dev_dbg(priv->dev, "IR filter=%016llx & %016llx\n",
402 (unsigned long long)filter->data,
403 (unsigned long long)filter->mask);
404 img_ir_write(priv, IMG_IR_IRQ_MSG_DATA_LW, (u32)filter->data);
405 img_ir_write(priv, IMG_IR_IRQ_MSG_DATA_UP, (u32)(filter->data
406 >> 32));
407 img_ir_write(priv, IMG_IR_IRQ_MSG_MASK_LW, (u32)filter->mask);
408 img_ir_write(priv, IMG_IR_IRQ_MSG_MASK_UP, (u32)(filter->mask
409 >> 32));
410 } else {
411 dev_dbg(priv->dev, "IR clearing filter\n");
412 img_ir_write(priv, IMG_IR_IRQ_MSG_MASK_LW, 0);
413 img_ir_write(priv, IMG_IR_IRQ_MSG_MASK_UP, 0);
417 /* caller must have lock */
418 static void _img_ir_set_filter(struct img_ir_priv *priv,
419 struct img_ir_filter *filter)
421 struct img_ir_priv_hw *hw = &priv->hw;
422 u32 irq_en, irq_on;
424 irq_en = img_ir_read(priv, IMG_IR_IRQ_ENABLE);
425 if (filter) {
426 /* Only use the match interrupt */
427 hw->filters[RC_FILTER_NORMAL] = *filter;
428 hw->flags |= IMG_IR_F_FILTER;
429 irq_on = IMG_IR_IRQ_DATA_MATCH;
430 irq_en &= ~(IMG_IR_IRQ_DATA_VALID | IMG_IR_IRQ_DATA2_VALID);
431 } else {
432 /* Only use the valid interrupt */
433 hw->flags &= ~IMG_IR_F_FILTER;
434 irq_en &= ~IMG_IR_IRQ_DATA_MATCH;
435 irq_on = IMG_IR_IRQ_DATA_VALID | IMG_IR_IRQ_DATA2_VALID;
437 irq_en |= irq_on;
439 img_ir_write_filter(priv, filter);
440 /* clear any interrupts we're enabling so we don't handle old ones */
441 img_ir_write(priv, IMG_IR_IRQ_CLEAR, irq_on);
442 img_ir_write(priv, IMG_IR_IRQ_ENABLE, irq_en);
445 /* caller must have lock */
446 static void _img_ir_set_wake_filter(struct img_ir_priv *priv,
447 struct img_ir_filter *filter)
449 struct img_ir_priv_hw *hw = &priv->hw;
450 if (filter) {
451 /* Enable wake, and copy filter for later */
452 hw->filters[RC_FILTER_WAKEUP] = *filter;
453 hw->flags |= IMG_IR_F_WAKE;
454 } else {
455 /* Disable wake */
456 hw->flags &= ~IMG_IR_F_WAKE;
460 /* Callback for setting scancode filter */
461 static int img_ir_set_filter(struct rc_dev *dev, enum rc_filter_type type,
462 struct rc_scancode_filter *sc_filter)
464 struct img_ir_priv *priv = dev->priv;
465 struct img_ir_priv_hw *hw = &priv->hw;
466 struct img_ir_filter filter, *filter_ptr = &filter;
467 int ret = 0;
469 dev_dbg(priv->dev, "IR scancode %sfilter=%08x & %08x\n",
470 type == RC_FILTER_WAKEUP ? "wake " : "",
471 sc_filter->data,
472 sc_filter->mask);
474 spin_lock_irq(&priv->lock);
476 /* filtering can always be disabled */
477 if (!sc_filter->mask) {
478 filter_ptr = NULL;
479 goto set_unlock;
482 /* current decoder must support scancode filtering */
483 if (!hw->decoder || !hw->decoder->filter) {
484 ret = -EINVAL;
485 goto unlock;
488 /* convert scancode filter to raw filter */
489 filter.minlen = 0;
490 filter.maxlen = ~0;
491 if (type == RC_FILTER_NORMAL) {
492 /* guess scancode from protocol */
493 ret = hw->decoder->filter(sc_filter, &filter,
494 dev->enabled_protocols);
495 } else {
496 /* for wakeup user provided exact protocol variant */
497 ret = hw->decoder->filter(sc_filter, &filter,
498 1ULL << dev->wakeup_protocol);
500 if (ret)
501 goto unlock;
502 dev_dbg(priv->dev, "IR raw %sfilter=%016llx & %016llx\n",
503 type == RC_FILTER_WAKEUP ? "wake " : "",
504 (unsigned long long)filter.data,
505 (unsigned long long)filter.mask);
507 set_unlock:
508 /* apply raw filters */
509 switch (type) {
510 case RC_FILTER_NORMAL:
511 _img_ir_set_filter(priv, filter_ptr);
512 break;
513 case RC_FILTER_WAKEUP:
514 _img_ir_set_wake_filter(priv, filter_ptr);
515 break;
516 default:
517 ret = -EINVAL;
520 unlock:
521 spin_unlock_irq(&priv->lock);
522 return ret;
525 static int img_ir_set_normal_filter(struct rc_dev *dev,
526 struct rc_scancode_filter *sc_filter)
528 return img_ir_set_filter(dev, RC_FILTER_NORMAL, sc_filter);
531 static int img_ir_set_wakeup_filter(struct rc_dev *dev,
532 struct rc_scancode_filter *sc_filter)
534 return img_ir_set_filter(dev, RC_FILTER_WAKEUP, sc_filter);
538 * img_ir_set_decoder() - Set the current decoder.
539 * @priv: IR private data.
540 * @decoder: Decoder to use with immediate effect.
541 * @proto: Protocol bitmap (or 0 to use decoder->type).
543 static void img_ir_set_decoder(struct img_ir_priv *priv,
544 const struct img_ir_decoder *decoder,
545 u64 proto)
547 struct img_ir_priv_hw *hw = &priv->hw;
548 struct rc_dev *rdev = hw->rdev;
549 u32 ir_status, irq_en;
550 spin_lock_irq(&priv->lock);
553 * First record that the protocol is being stopped so that the end timer
554 * isn't restarted while we're trying to stop it.
556 hw->stopping = true;
559 * Release the lock to stop the end timer, since the end timer handler
560 * acquires the lock and we don't want to deadlock waiting for it.
562 spin_unlock_irq(&priv->lock);
563 del_timer_sync(&hw->end_timer);
564 del_timer_sync(&hw->suspend_timer);
565 spin_lock_irq(&priv->lock);
567 hw->stopping = false;
569 /* switch off and disable interrupts */
570 img_ir_write(priv, IMG_IR_CONTROL, 0);
571 irq_en = img_ir_read(priv, IMG_IR_IRQ_ENABLE);
572 img_ir_write(priv, IMG_IR_IRQ_ENABLE, irq_en & IMG_IR_IRQ_EDGE);
573 img_ir_write(priv, IMG_IR_IRQ_CLEAR, IMG_IR_IRQ_ALL & ~IMG_IR_IRQ_EDGE);
575 /* ack any data already detected */
576 ir_status = img_ir_read(priv, IMG_IR_STATUS);
577 if (ir_status & (IMG_IR_RXDVAL | IMG_IR_RXDVALD2)) {
578 ir_status &= ~(IMG_IR_RXDVAL | IMG_IR_RXDVALD2);
579 img_ir_write(priv, IMG_IR_STATUS, ir_status);
582 /* always read data to clear buffer if IR wakes the device */
583 img_ir_read(priv, IMG_IR_DATA_LW);
584 img_ir_read(priv, IMG_IR_DATA_UP);
586 /* switch back to normal mode */
587 hw->mode = IMG_IR_M_NORMAL;
589 /* clear the wakeup scancode filter */
590 rdev->scancode_wakeup_filter.data = 0;
591 rdev->scancode_wakeup_filter.mask = 0;
592 rdev->wakeup_protocol = RC_PROTO_UNKNOWN;
594 /* clear raw filters */
595 _img_ir_set_filter(priv, NULL);
596 _img_ir_set_wake_filter(priv, NULL);
598 /* clear the enabled protocols */
599 hw->enabled_protocols = 0;
601 /* switch decoder */
602 hw->decoder = decoder;
603 if (!decoder)
604 goto unlock;
606 /* set the enabled protocols */
607 if (!proto)
608 proto = decoder->type;
609 hw->enabled_protocols = proto;
611 /* write the new timings */
612 img_ir_decoder_convert(decoder, &hw->reg_timings, hw->clk_hz);
613 img_ir_write_timings(priv, &hw->reg_timings.timings, RC_FILTER_NORMAL);
615 /* set up and enable */
616 img_ir_write(priv, IMG_IR_CONTROL, hw->reg_timings.ctrl);
619 unlock:
620 spin_unlock_irq(&priv->lock);
624 * img_ir_decoder_compatable() - Find whether a decoder will work with a device.
625 * @priv: IR private data.
626 * @dec: Decoder to check.
628 * Returns: true if @dec is compatible with the device @priv refers to.
630 static bool img_ir_decoder_compatible(struct img_ir_priv *priv,
631 const struct img_ir_decoder *dec)
633 unsigned int ct;
635 /* don't accept decoders using code types which aren't supported */
636 ct = dec->control.code_type;
637 if (priv->hw.ct_quirks[ct] & IMG_IR_QUIRK_CODE_BROKEN)
638 return false;
640 return true;
644 * img_ir_allowed_protos() - Get allowed protocols from global decoder list.
645 * @priv: IR private data.
647 * Returns: Mask of protocols supported by the device @priv refers to.
649 static u64 img_ir_allowed_protos(struct img_ir_priv *priv)
651 u64 protos = 0;
652 struct img_ir_decoder **decp;
654 for (decp = img_ir_decoders; *decp; ++decp) {
655 const struct img_ir_decoder *dec = *decp;
656 if (img_ir_decoder_compatible(priv, dec))
657 protos |= dec->type;
659 return protos;
662 /* Callback for changing protocol using sysfs */
663 static int img_ir_change_protocol(struct rc_dev *dev, u64 *ir_type)
665 struct img_ir_priv *priv = dev->priv;
666 struct img_ir_priv_hw *hw = &priv->hw;
667 struct rc_dev *rdev = hw->rdev;
668 struct img_ir_decoder **decp;
669 u64 wakeup_protocols;
671 if (!*ir_type) {
672 /* disable all protocols */
673 img_ir_set_decoder(priv, NULL, 0);
674 goto success;
676 for (decp = img_ir_decoders; *decp; ++decp) {
677 const struct img_ir_decoder *dec = *decp;
678 if (!img_ir_decoder_compatible(priv, dec))
679 continue;
680 if (*ir_type & dec->type) {
681 *ir_type &= dec->type;
682 img_ir_set_decoder(priv, dec, *ir_type);
683 goto success;
686 return -EINVAL;
688 success:
690 * Only allow matching wakeup protocols for now, and only if filtering
691 * is supported.
693 wakeup_protocols = *ir_type;
694 if (!hw->decoder || !hw->decoder->filter)
695 wakeup_protocols = 0;
696 rdev->allowed_wakeup_protocols = wakeup_protocols;
697 return 0;
700 /* Changes ir-core protocol device attribute */
701 static void img_ir_set_protocol(struct img_ir_priv *priv, u64 proto)
703 struct rc_dev *rdev = priv->hw.rdev;
705 mutex_lock(&rdev->lock);
706 rdev->enabled_protocols = proto;
707 rdev->allowed_wakeup_protocols = proto;
708 mutex_unlock(&rdev->lock);
711 /* Set up IR decoders */
712 static void img_ir_init_decoders(void)
714 struct img_ir_decoder **decp;
716 spin_lock(&img_ir_decoders_lock);
717 if (!img_ir_decoders_preprocessed) {
718 for (decp = img_ir_decoders; *decp; ++decp)
719 img_ir_decoder_preprocess(*decp);
720 img_ir_decoders_preprocessed = true;
722 spin_unlock(&img_ir_decoders_lock);
725 #ifdef CONFIG_PM_SLEEP
727 * img_ir_enable_wake() - Switch to wake mode.
728 * @priv: IR private data.
730 * Returns: non-zero if the IR can wake the system.
732 static int img_ir_enable_wake(struct img_ir_priv *priv)
734 struct img_ir_priv_hw *hw = &priv->hw;
735 int ret = 0;
737 spin_lock_irq(&priv->lock);
738 if (hw->flags & IMG_IR_F_WAKE) {
739 /* interrupt only on a match */
740 hw->suspend_irqen = img_ir_read(priv, IMG_IR_IRQ_ENABLE);
741 img_ir_write(priv, IMG_IR_IRQ_ENABLE, IMG_IR_IRQ_DATA_MATCH);
742 img_ir_write_filter(priv, &hw->filters[RC_FILTER_WAKEUP]);
743 img_ir_write_timings(priv, &hw->reg_timings.timings,
744 RC_FILTER_WAKEUP);
745 hw->mode = IMG_IR_M_WAKE;
746 ret = 1;
748 spin_unlock_irq(&priv->lock);
749 return ret;
753 * img_ir_disable_wake() - Switch out of wake mode.
754 * @priv: IR private data
756 * Returns: 1 if the hardware should be allowed to wake from a sleep state.
757 * 0 otherwise.
759 static int img_ir_disable_wake(struct img_ir_priv *priv)
761 struct img_ir_priv_hw *hw = &priv->hw;
762 int ret = 0;
764 spin_lock_irq(&priv->lock);
765 if (hw->flags & IMG_IR_F_WAKE) {
766 /* restore normal filtering */
767 if (hw->flags & IMG_IR_F_FILTER) {
768 img_ir_write(priv, IMG_IR_IRQ_ENABLE,
769 (hw->suspend_irqen & IMG_IR_IRQ_EDGE) |
770 IMG_IR_IRQ_DATA_MATCH);
771 img_ir_write_filter(priv,
772 &hw->filters[RC_FILTER_NORMAL]);
773 } else {
774 img_ir_write(priv, IMG_IR_IRQ_ENABLE,
775 (hw->suspend_irqen & IMG_IR_IRQ_EDGE) |
776 IMG_IR_IRQ_DATA_VALID |
777 IMG_IR_IRQ_DATA2_VALID);
778 img_ir_write_filter(priv, NULL);
780 img_ir_write_timings(priv, &hw->reg_timings.timings,
781 RC_FILTER_NORMAL);
782 hw->mode = IMG_IR_M_NORMAL;
783 ret = 1;
785 spin_unlock_irq(&priv->lock);
786 return ret;
788 #endif /* CONFIG_PM_SLEEP */
790 /* lock must be held */
791 static void img_ir_begin_repeat(struct img_ir_priv *priv)
793 struct img_ir_priv_hw *hw = &priv->hw;
794 if (hw->mode == IMG_IR_M_NORMAL) {
795 /* switch to repeat timings */
796 img_ir_write(priv, IMG_IR_CONTROL, 0);
797 hw->mode = IMG_IR_M_REPEATING;
798 img_ir_write_timings(priv, &hw->reg_timings.rtimings,
799 RC_FILTER_NORMAL);
800 img_ir_write(priv, IMG_IR_CONTROL, hw->reg_timings.ctrl);
804 /* lock must be held */
805 static void img_ir_end_repeat(struct img_ir_priv *priv)
807 struct img_ir_priv_hw *hw = &priv->hw;
808 if (hw->mode == IMG_IR_M_REPEATING) {
809 /* switch to normal timings */
810 img_ir_write(priv, IMG_IR_CONTROL, 0);
811 hw->mode = IMG_IR_M_NORMAL;
812 img_ir_write_timings(priv, &hw->reg_timings.timings,
813 RC_FILTER_NORMAL);
814 img_ir_write(priv, IMG_IR_CONTROL, hw->reg_timings.ctrl);
818 /* lock must be held */
819 static void img_ir_handle_data(struct img_ir_priv *priv, u32 len, u64 raw)
821 struct img_ir_priv_hw *hw = &priv->hw;
822 const struct img_ir_decoder *dec = hw->decoder;
823 int ret = IMG_IR_SCANCODE;
824 struct img_ir_scancode_req request;
826 request.protocol = RC_PROTO_UNKNOWN;
827 request.toggle = 0;
829 if (dec->scancode)
830 ret = dec->scancode(len, raw, hw->enabled_protocols, &request);
831 else if (len >= 32)
832 request.scancode = (u32)raw;
833 else if (len < 32)
834 request.scancode = (u32)raw & ((1 << len)-1);
835 dev_dbg(priv->dev, "data (%u bits) = %#llx\n",
836 len, (unsigned long long)raw);
837 if (ret == IMG_IR_SCANCODE) {
838 dev_dbg(priv->dev, "decoded scan code %#x, toggle %u\n",
839 request.scancode, request.toggle);
840 rc_keydown(hw->rdev, request.protocol, request.scancode,
841 request.toggle);
842 img_ir_end_repeat(priv);
843 } else if (ret == IMG_IR_REPEATCODE) {
844 if (hw->mode == IMG_IR_M_REPEATING) {
845 dev_dbg(priv->dev, "decoded repeat code\n");
846 rc_repeat(hw->rdev);
847 } else {
848 dev_dbg(priv->dev, "decoded unexpected repeat code, ignoring\n");
850 } else {
851 dev_dbg(priv->dev, "decode failed (%d)\n", ret);
852 return;
856 /* we mustn't update the end timer while trying to stop it */
857 if (dec->repeat && !hw->stopping) {
858 unsigned long interval;
860 img_ir_begin_repeat(priv);
862 /* update timer, but allowing for 1/8th tolerance */
863 interval = dec->repeat + (dec->repeat >> 3);
864 mod_timer(&hw->end_timer,
865 jiffies + msecs_to_jiffies(interval));
869 /* timer function to end waiting for repeat. */
870 static void img_ir_end_timer(struct timer_list *t)
872 struct img_ir_priv *priv = from_timer(priv, t, hw.end_timer);
874 spin_lock_irq(&priv->lock);
875 img_ir_end_repeat(priv);
876 spin_unlock_irq(&priv->lock);
880 * Timer function to re-enable the current protocol after it had been
881 * cleared when invalid interrupts were generated due to a quirk in the
882 * img-ir decoder.
884 static void img_ir_suspend_timer(struct timer_list *t)
886 struct img_ir_priv *priv = from_timer(priv, t, hw.suspend_timer);
888 spin_lock_irq(&priv->lock);
890 * Don't overwrite enabled valid/match IRQs if they have already been
891 * changed by e.g. a filter change.
893 if ((priv->hw.quirk_suspend_irq & IMG_IR_IRQ_EDGE) ==
894 img_ir_read(priv, IMG_IR_IRQ_ENABLE))
895 img_ir_write(priv, IMG_IR_IRQ_ENABLE,
896 priv->hw.quirk_suspend_irq);
897 /* enable */
898 img_ir_write(priv, IMG_IR_CONTROL, priv->hw.reg_timings.ctrl);
899 spin_unlock_irq(&priv->lock);
902 #ifdef CONFIG_COMMON_CLK
903 static void img_ir_change_frequency(struct img_ir_priv *priv,
904 struct clk_notifier_data *change)
906 struct img_ir_priv_hw *hw = &priv->hw;
908 dev_dbg(priv->dev, "clk changed %lu HZ -> %lu HZ\n",
909 change->old_rate, change->new_rate);
911 spin_lock_irq(&priv->lock);
912 if (hw->clk_hz == change->new_rate)
913 goto unlock;
914 hw->clk_hz = change->new_rate;
915 /* refresh current timings */
916 if (hw->decoder) {
917 img_ir_decoder_convert(hw->decoder, &hw->reg_timings,
918 hw->clk_hz);
919 switch (hw->mode) {
920 case IMG_IR_M_NORMAL:
921 img_ir_write_timings(priv, &hw->reg_timings.timings,
922 RC_FILTER_NORMAL);
923 break;
924 case IMG_IR_M_REPEATING:
925 img_ir_write_timings(priv, &hw->reg_timings.rtimings,
926 RC_FILTER_NORMAL);
927 break;
928 #ifdef CONFIG_PM_SLEEP
929 case IMG_IR_M_WAKE:
930 img_ir_write_timings(priv, &hw->reg_timings.timings,
931 RC_FILTER_WAKEUP);
932 break;
933 #endif
936 unlock:
937 spin_unlock_irq(&priv->lock);
940 static int img_ir_clk_notify(struct notifier_block *self, unsigned long action,
941 void *data)
943 struct img_ir_priv *priv = container_of(self, struct img_ir_priv,
944 hw.clk_nb);
945 switch (action) {
946 case POST_RATE_CHANGE:
947 img_ir_change_frequency(priv, data);
948 break;
949 default:
950 break;
952 return NOTIFY_OK;
954 #endif /* CONFIG_COMMON_CLK */
956 /* called with priv->lock held */
957 void img_ir_isr_hw(struct img_ir_priv *priv, u32 irq_status)
959 struct img_ir_priv_hw *hw = &priv->hw;
960 u32 ir_status, len, lw, up;
961 unsigned int ct;
963 /* use the current decoder */
964 if (!hw->decoder)
965 return;
967 ct = hw->decoder->control.code_type;
969 ir_status = img_ir_read(priv, IMG_IR_STATUS);
970 if (!(ir_status & (IMG_IR_RXDVAL | IMG_IR_RXDVALD2))) {
971 if (!(priv->hw.ct_quirks[ct] & IMG_IR_QUIRK_CODE_IRQ) ||
972 hw->stopping)
973 return;
975 * The below functionality is added as a work around to stop
976 * multiple Interrupts generated when an incomplete IR code is
977 * received by the decoder.
978 * The decoder generates rapid interrupts without actually
979 * having received any new data. After a single interrupt it's
980 * expected to clear up, but instead multiple interrupts are
981 * rapidly generated. only way to get out of this loop is to
982 * reset the control register after a short delay.
984 img_ir_write(priv, IMG_IR_CONTROL, 0);
985 hw->quirk_suspend_irq = img_ir_read(priv, IMG_IR_IRQ_ENABLE);
986 img_ir_write(priv, IMG_IR_IRQ_ENABLE,
987 hw->quirk_suspend_irq & IMG_IR_IRQ_EDGE);
989 /* Timer activated to re-enable the protocol. */
990 mod_timer(&hw->suspend_timer,
991 jiffies + msecs_to_jiffies(5));
992 return;
994 ir_status &= ~(IMG_IR_RXDVAL | IMG_IR_RXDVALD2);
995 img_ir_write(priv, IMG_IR_STATUS, ir_status);
997 len = (ir_status & IMG_IR_RXDLEN) >> IMG_IR_RXDLEN_SHIFT;
998 /* some versions report wrong length for certain code types */
999 if (hw->ct_quirks[ct] & IMG_IR_QUIRK_CODE_LEN_INCR)
1000 ++len;
1002 lw = img_ir_read(priv, IMG_IR_DATA_LW);
1003 up = img_ir_read(priv, IMG_IR_DATA_UP);
1004 img_ir_handle_data(priv, len, (u64)up << 32 | lw);
1007 void img_ir_setup_hw(struct img_ir_priv *priv)
1009 struct img_ir_decoder **decp;
1011 if (!priv->hw.rdev)
1012 return;
1014 /* Use the first available decoder (or disable stuff if NULL) */
1015 for (decp = img_ir_decoders; *decp; ++decp) {
1016 const struct img_ir_decoder *dec = *decp;
1017 if (img_ir_decoder_compatible(priv, dec)) {
1018 img_ir_set_protocol(priv, dec->type);
1019 img_ir_set_decoder(priv, dec, 0);
1020 return;
1023 img_ir_set_decoder(priv, NULL, 0);
1027 * img_ir_probe_hw_caps() - Probe capabilities of the hardware.
1028 * @priv: IR private data.
1030 static void img_ir_probe_hw_caps(struct img_ir_priv *priv)
1032 struct img_ir_priv_hw *hw = &priv->hw;
1034 * When a version of the block becomes available without these quirks,
1035 * they'll have to depend on the core revision.
1037 hw->ct_quirks[IMG_IR_CODETYPE_PULSELEN]
1038 |= IMG_IR_QUIRK_CODE_LEN_INCR;
1039 hw->ct_quirks[IMG_IR_CODETYPE_BIPHASE]
1040 |= IMG_IR_QUIRK_CODE_IRQ;
1041 hw->ct_quirks[IMG_IR_CODETYPE_2BITPULSEPOS]
1042 |= IMG_IR_QUIRK_CODE_BROKEN;
1045 int img_ir_probe_hw(struct img_ir_priv *priv)
1047 struct img_ir_priv_hw *hw = &priv->hw;
1048 struct rc_dev *rdev;
1049 int error;
1051 /* Ensure hardware decoders have been preprocessed */
1052 img_ir_init_decoders();
1054 /* Probe hardware capabilities */
1055 img_ir_probe_hw_caps(priv);
1057 /* Set up the end timer */
1058 timer_setup(&hw->end_timer, img_ir_end_timer, 0);
1059 timer_setup(&hw->suspend_timer, img_ir_suspend_timer, 0);
1061 /* Register a clock notifier */
1062 if (!IS_ERR(priv->clk)) {
1063 hw->clk_hz = clk_get_rate(priv->clk);
1064 #ifdef CONFIG_COMMON_CLK
1065 hw->clk_nb.notifier_call = img_ir_clk_notify;
1066 error = clk_notifier_register(priv->clk, &hw->clk_nb);
1067 if (error)
1068 dev_warn(priv->dev,
1069 "failed to register clock notifier\n");
1070 #endif
1071 } else {
1072 hw->clk_hz = 32768;
1075 /* Allocate hardware decoder */
1076 hw->rdev = rdev = rc_allocate_device(RC_DRIVER_SCANCODE);
1077 if (!rdev) {
1078 dev_err(priv->dev, "cannot allocate input device\n");
1079 error = -ENOMEM;
1080 goto err_alloc_rc;
1082 rdev->priv = priv;
1083 rdev->map_name = RC_MAP_EMPTY;
1084 rdev->allowed_protocols = img_ir_allowed_protos(priv);
1085 rdev->device_name = "IMG Infrared Decoder";
1086 rdev->s_filter = img_ir_set_normal_filter;
1087 rdev->s_wakeup_filter = img_ir_set_wakeup_filter;
1089 /* Register hardware decoder */
1090 error = rc_register_device(rdev);
1091 if (error) {
1092 dev_err(priv->dev, "failed to register IR input device\n");
1093 goto err_register_rc;
1097 * Set this after rc_register_device as no protocols have been
1098 * registered yet.
1100 rdev->change_protocol = img_ir_change_protocol;
1102 device_init_wakeup(priv->dev, 1);
1104 return 0;
1106 err_register_rc:
1107 img_ir_set_decoder(priv, NULL, 0);
1108 hw->rdev = NULL;
1109 rc_free_device(rdev);
1110 err_alloc_rc:
1111 #ifdef CONFIG_COMMON_CLK
1112 if (!IS_ERR(priv->clk))
1113 clk_notifier_unregister(priv->clk, &hw->clk_nb);
1114 #endif
1115 return error;
1118 void img_ir_remove_hw(struct img_ir_priv *priv)
1120 struct img_ir_priv_hw *hw = &priv->hw;
1121 struct rc_dev *rdev = hw->rdev;
1122 if (!rdev)
1123 return;
1124 img_ir_set_decoder(priv, NULL, 0);
1125 hw->rdev = NULL;
1126 rc_unregister_device(rdev);
1127 #ifdef CONFIG_COMMON_CLK
1128 if (!IS_ERR(priv->clk))
1129 clk_notifier_unregister(priv->clk, &hw->clk_nb);
1130 #endif
1133 #ifdef CONFIG_PM_SLEEP
1134 int img_ir_suspend(struct device *dev)
1136 struct img_ir_priv *priv = dev_get_drvdata(dev);
1138 if (device_may_wakeup(dev) && img_ir_enable_wake(priv))
1139 enable_irq_wake(priv->irq);
1140 return 0;
1143 int img_ir_resume(struct device *dev)
1145 struct img_ir_priv *priv = dev_get_drvdata(dev);
1147 if (device_may_wakeup(dev) && img_ir_disable_wake(priv))
1148 disable_irq_wake(priv->irq);
1149 return 0;
1151 #endif /* CONFIG_PM_SLEEP */