Release 4.11 drivers/media/rc/rc-ir-raw.c

/* rc-ir-raw.c - handle IR pulse/space events
 *
 * Copyright (C) 2010 by Mauro Carvalho Chehab
 *
 * This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation version 2 of the License.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 */

#include <linux/export.h>
#include <linux/kthread.h>
#include <linux/mutex.h>
#include <linux/kmod.h>
#include <linux/sched.h>
#include "rc-core-priv.h"

/* Used to keep track of IR raw clients, protected by ir_raw_handler_lock */
static LIST_HEAD(ir_raw_client_list);

/* Used to handle IR raw handler extensions */
static DEFINE_MUTEX(ir_raw_handler_lock);
static LIST_HEAD(ir_raw_handler_list);

static atomic64_t available_protocols = ATOMIC64_INIT(0);



static int ir_raw_event_thread(void *data)
{
	struct ir_raw_event ev;
	struct ir_raw_handler *handler;
	struct ir_raw_event_ctrl *raw = (struct ir_raw_event_ctrl *)data;

	while (1) {
		mutex_lock(&ir_raw_handler_lock);
		while (kfifo_out(&raw->kfifo, &ev, 1)) {
			list_for_each_entry(handler, &ir_raw_handler_list, list)
				if (raw->dev->enabled_protocols &
				    handler->protocols || !handler->protocols)
					handler->decode(raw->dev, ev);
			raw->prev_ev = ev;
		}
		mutex_unlock(&ir_raw_handler_lock);

		set_current_state(TASK_INTERRUPTIBLE);

		if (kthread_should_stop()) {
			__set_current_state(TASK_RUNNING);
			break;
		} else if (!kfifo_is_empty(&raw->kfifo))
			set_current_state(TASK_RUNNING);

		schedule();
	}

	return 0;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Heiner Kallweit
64
42.95%
3
27.27%
David Härdeman
51
34.23%
4
36.36%
Maxim Levitsky
28
18.79%
3
27.27%
Srinivas Kandagatla
6
4.03%
1
9.09%
Total
149
100.00%
11
100.00%

/**
 * ir_raw_event_store() - pass a pulse/space duration to the raw ir decoders
 * @dev:        the struct rc_dev device descriptor
 * @ev:         the struct ir_raw_event descriptor of the pulse/space
 *
 * This routine (which may be called from an interrupt context) stores a
 * pulse/space duration for the raw ir decoding state machines. Pulses are
 * signalled as positive values and spaces as negative values. A zero value
 * will reset the decoding state machines.
 */


int ir_raw_event_store(struct rc_dev *dev, struct ir_raw_event *ev)
{
	if (!dev->raw)
		return -EINVAL;

	IR_dprintk(2, "sample: (%05dus %s)\n",
		   TO_US(ev->duration), TO_STR(ev->pulse));

	if (!kfifo_put(&dev->raw->kfifo, *ev)) {
		dev_err(&dev->dev, "IR event FIFO is full!\n");
		return -ENOSPC;
	}

	return 0;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Mauro Carvalho Chehab
33
40.24%
2
28.57%
Maxim Levitsky
20
24.39%
1
14.29%
David Härdeman
15
18.29%
3
42.86%
Heiner Kallweit
14
17.07%
1
14.29%
Total
82
100.00%
7
100.00%


EXPORT_SYMBOL_GPL(ir_raw_event_store);

/**
 * ir_raw_event_store_edge() - notify raw ir decoders of the start of a pulse/space
 * @dev:        the struct rc_dev device descriptor
 * @type:       the type of the event that has occurred
 *
 * This routine (which may be called from an interrupt context) is used to
 * store the beginning of an ir pulse or space (or the start/end of ir
 * reception) for the raw ir decoding state machines. This is used by
 * hardware which does not provide durations directly but only interrupts
 * (or similar events) on state change.
 */


int ir_raw_event_store_edge(struct rc_dev *dev, enum raw_event_type type)
{
	ktime_t			now;
	s64			delta; /* ns */
	DEFINE_IR_RAW_EVENT(ev);
	int			rc = 0;
	int			delay;

	if (!dev->raw)
		return -EINVAL;

	now = ktime_get();
	delta = ktime_to_ns(ktime_sub(now, dev->raw->last_event));
	delay = MS_TO_NS(dev->input_dev->rep[REP_DELAY]);

	/* Check for a long duration since last event or if we're
         * being called for the first time, note that delta can't
         * possibly be negative.
         */
	if (delta > delay || !dev->raw->last_type)
		type |= IR_START_EVENT;
	else
		ev.duration = delta;

	if (type & IR_START_EVENT)
		ir_raw_event_reset(dev);
	else if (dev->raw->last_type & IR_SPACE) {
		ev.pulse = false;
		rc = ir_raw_event_store(dev, &ev);
	} else if (dev->raw->last_type & IR_PULSE) {
		ev.pulse = true;
		rc = ir_raw_event_store(dev, &ev);
	} else
		return 0;

	dev->raw->last_event = now;
	dev->raw->last_type = type;
	return rc;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
David Härdeman
134
68.02%
3
50.00%
Mauro Carvalho Chehab
45
22.84%
2
33.33%
Jarod Wilson
18
9.14%
1
16.67%
Total
197
100.00%
6
100.00%


EXPORT_SYMBOL_GPL(ir_raw_event_store_edge);

/**
 * ir_raw_event_store_with_filter() - pass next pulse/space to decoders with some processing
 * @dev:        the struct rc_dev device descriptor
 * @type:       the type of the event that has occurred
 *
 * This routine (which may be called from an interrupt context) works
 * in similar manner to ir_raw_event_store_edge.
 * This routine is intended for devices with limited internal buffer
 * It automerges samples of same type, and handles timeouts. Returns non-zero
 * if the event was added, and zero if the event was ignored due to idle
 * processing.
 */


int ir_raw_event_store_with_filter(struct rc_dev *dev, struct ir_raw_event *ev)
{
	if (!dev->raw)
		return -EINVAL;

	/* Ignore spaces in idle mode */
	if (dev->idle && !ev->pulse)
		return 0;
	else if (dev->idle)
		ir_raw_event_set_idle(dev, false);

	if (!dev->raw->this_ev.duration)
		dev->raw->this_ev = *ev;
	else if (ev->pulse == dev->raw->this_ev.pulse)
		dev->raw->this_ev.duration += ev->duration;
	else {
		ir_raw_event_store(dev, &dev->raw->this_ev);
		dev->raw->this_ev = *ev;
	}

	/* Enter idle mode if nessesary */
	if (!ev->pulse && dev->timeout &&
	    dev->raw->this_ev.duration >= dev->timeout)
		ir_raw_event_set_idle(dev, true);

	return 1;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Maxim Levitsky
134
83.75%
2
50.00%
David Härdeman
25
15.62%
1
25.00%
Sean Young
1
0.62%
1
25.00%
Total
160
100.00%
4
100.00%


EXPORT_SYMBOL_GPL(ir_raw_event_store_with_filter);

/**
 * ir_raw_event_set_idle() - provide hint to rc-core when the device is idle or not
 * @dev:        the struct rc_dev device descriptor
 * @idle:       whether the device is idle or not
 */


void ir_raw_event_set_idle(struct rc_dev *dev, bool idle)
{
	if (!dev->raw)
		return;

	IR_dprintk(2, "%s idle mode\n", idle ? "enter" : "leave");

	if (idle) {
		dev->raw->this_ev.timeout = true;
		ir_raw_event_store(dev, &dev->raw->this_ev);
		init_ir_raw_event(&dev->raw->this_ev);
	}

	if (dev->s_idle)
		dev->s_idle(dev, idle);

	dev->idle = idle;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Maxim Levitsky
79
84.95%
2
66.67%
David Härdeman
14
15.05%
1
33.33%
Total
93
100.00%
3
100.00%


EXPORT_SYMBOL_GPL(ir_raw_event_set_idle);

/**
 * ir_raw_event_handle() - schedules the decoding of stored ir data
 * @dev:        the struct rc_dev device descriptor
 *
 * This routine will tell rc-core to start decoding stored ir data.
 */


void ir_raw_event_handle(struct rc_dev *dev)
{
	if (!dev->raw)
		return;

	wake_up_process(dev->raw->thread);
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
David Härdeman
22
81.48%
2
40.00%
Mauro Carvalho Chehab
3
11.11%
2
40.00%
Maxim Levitsky
2
7.41%
1
20.00%
Total
27
100.00%
5
100.00%


EXPORT_SYMBOL_GPL(ir_raw_event_handle);

/* used internally by the sysfs interface */

u64

ir_raw_get_allowed_protocols(void)
{
	return atomic64_read(&available_protocols);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
David Härdeman
9
64.29%
1
33.33%
Randy Dunlap
3
21.43%
1
33.33%
Heiner Kallweit
2
14.29%
1
33.33%
Total
14
100.00%
3
100.00%



static int change_protocol(struct rc_dev *dev, u64 *rc_type)
{
	/* the caller will update dev->enabled_protocols */
	return 0;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
David Härdeman
19
100.00%
1
100.00%
Total
19
100.00%
1
100.00%



static void ir_raw_disable_protocols(struct rc_dev *dev, u64 protocols)
{
	mutex_lock(&dev->lock);
	dev->enabled_protocols &= ~protocols;
	mutex_unlock(&dev->lock);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Heiner Kallweit
37
100.00%
1
100.00%
Total
37
100.00%
1
100.00%

/**
 * ir_raw_gen_manchester() - Encode data with Manchester (bi-phase) modulation.
 * @ev:         Pointer to pointer to next free event. *@ev is incremented for
 *              each raw event filled.
 * @max:        Maximum number of raw events to fill.
 * @timings:    Manchester modulation timings.
 * @n:          Number of bits of data.
 * @data:       Data bits to encode.
 *
 * Encodes the @n least significant bits of @data using Manchester (bi-phase)
 * modulation with the timing characteristics described by @timings, writing up
 * to @max raw IR events using the *@ev pointer.
 *
 * Returns:     0 on success.
 *              -ENOBUFS if there isn't enough space in the array to fit the
 *              full encoded data. In this case all @max events will have been
 *              written.
 */


int ir_raw_gen_manchester(struct ir_raw_event **ev, unsigned int max,
			  const struct ir_raw_timings_manchester *timings,
			  unsigned int n, unsigned int data)
{
	bool need_pulse;
	unsigned int i;
	int ret = -ENOBUFS;

	i = 1 << (n - 1);

	if (timings->leader) {
		if (!max--)
			return ret;
		if (timings->pulse_space_start) {
			init_ir_raw_event_duration((*ev)++, 1, timings->leader);

			if (!max--)
				return ret;
			init_ir_raw_event_duration((*ev), 0, timings->leader);
		} else {
			init_ir_raw_event_duration((*ev), 1, timings->leader);
		}
		i >>= 1;
	} else {
		/* continue existing signal */
		--(*ev);
	}
	/* from here on *ev will point to the last event rather than the next */

	while (n && i > 0) {
		need_pulse = !(data & i);
		if (timings->invert)
			need_pulse = !need_pulse;
		if (need_pulse == !!(*ev)->pulse) {
			(*ev)->duration += timings->clock;
		} else {
			if (!max--)
				goto nobufs;
			init_ir_raw_event_duration(++(*ev), need_pulse,
						   timings->clock);
		}

		if (!max--)
			goto nobufs;
		init_ir_raw_event_duration(++(*ev), !need_pulse,
					   timings->clock);
		i >>= 1;
	}

	if (timings->trailer_space) {
		if (!(*ev)->pulse)
			(*ev)->duration += timings->trailer_space;
		else if (!max--)
			goto nobufs;
		else
			init_ir_raw_event_duration(++(*ev), 0,
						   timings->trailer_space);
	}

	ret = 0;
nobufs:
	/* point to the next event rather than last event before returning */
	++(*ev);
	return ret;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Antti Seppälä
330
100.00%
1
100.00%
Total
330
100.00%
1
100.00%


EXPORT_SYMBOL(ir_raw_gen_manchester);

/**
 * ir_raw_gen_pd() - Encode data to raw events with pulse-distance modulation.
 * @ev:         Pointer to pointer to next free event. *@ev is incremented for
 *              each raw event filled.
 * @max:        Maximum number of raw events to fill.
 * @timings:    Pulse distance modulation timings.
 * @n:          Number of bits of data.
 * @data:       Data bits to encode.
 *
 * Encodes the @n least significant bits of @data using pulse-distance
 * modulation with the timing characteristics described by @timings, writing up
 * to @max raw IR events using the *@ev pointer.
 *
 * Returns:     0 on success.
 *              -ENOBUFS if there isn't enough space in the array to fit the
 *              full encoded data. In this case all @max events will have been
 *              written.
 */


int ir_raw_gen_pd(struct ir_raw_event **ev, unsigned int max,
		  const struct ir_raw_timings_pd *timings,
		  unsigned int n, u64 data)
{
	int i;
	int ret;
	unsigned int space;

	if (timings->header_pulse) {
		ret = ir_raw_gen_pulse_space(ev, &max, timings->header_pulse,
					     timings->header_space);
		if (ret)
			return ret;
	}

	if (timings->msb_first) {
		for (i = n - 1; i >= 0; --i) {
			space = timings->bit_space[(data >> i) & 1];
			ret = ir_raw_gen_pulse_space(ev, &max,
						     timings->bit_pulse,
						     space);
			if (ret)
				return ret;
		}
	} else {
		for (i = 0; i < n; ++i, data >>= 1) {
			space = timings->bit_space[data & 1];
			ret = ir_raw_gen_pulse_space(ev, &max,
						     timings->bit_pulse,
						     space);
			if (ret)
				return ret;
		}
	}

	ret = ir_raw_gen_pulse_space(ev, &max, timings->trailer_pulse,
				     timings->trailer_space);
	return ret;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
James Hogan
211
100.00%
1
100.00%
Total
211
100.00%
1
100.00%


EXPORT_SYMBOL(ir_raw_gen_pd);

/**
 * ir_raw_gen_pl() - Encode data to raw events with pulse-length modulation.
 * @ev:         Pointer to pointer to next free event. *@ev is incremented for
 *              each raw event filled.
 * @max:        Maximum number of raw events to fill.
 * @timings:    Pulse distance modulation timings.
 * @n:          Number of bits of data.
 * @data:       Data bits to encode.
 *
 * Encodes the @n least significant bits of @data using space-distance
 * modulation with the timing characteristics described by @timings, writing up
 * to @max raw IR events using the *@ev pointer.
 *
 * Returns:     0 on success.
 *              -ENOBUFS if there isn't enough space in the array to fit the
 *              full encoded data. In this case all @max events will have been
 *              written.
 */


int ir_raw_gen_pl(struct ir_raw_event **ev, unsigned int max,
		  const struct ir_raw_timings_pl *timings,
		  unsigned int n, u64 data)
{
	int i;
	int ret = -ENOBUFS;
	unsigned int pulse;

	if (!max--)
		return ret;

	init_ir_raw_event_duration((*ev)++, 1, timings->header_pulse);

	if (timings->msb_first) {
		for (i = n - 1; i >= 0; --i) {
			if (!max--)
				return ret;
			init_ir_raw_event_duration((*ev)++, 0,
						   timings->bit_space);
			if (!max--)
				return ret;
			pulse = timings->bit_pulse[(data >> i) & 1];
			init_ir_raw_event_duration((*ev)++, 1, pulse);
		}
	} else {
		for (i = 0; i < n; ++i, data >>= 1) {
			if (!max--)
				return ret;
			init_ir_raw_event_duration((*ev)++, 0,
						   timings->bit_space);
			if (!max--)
				return ret;
			pulse = timings->bit_pulse[data & 1];
			init_ir_raw_event_duration((*ev)++, 1, pulse);
		}
	}

	if (!max--)
		return ret;

	init_ir_raw_event_duration((*ev)++, 0, timings->trailer_space);

	return 0;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Sean Young
257
100.00%
1
100.00%
Total
257
100.00%
1
100.00%


EXPORT_SYMBOL(ir_raw_gen_pl);

/**
 * ir_raw_encode_scancode() - Encode a scancode as raw events
 *
 * @protocol:           protocol
 * @scancode:           scancode filter describing a single scancode
 * @events:             array of raw events to write into
 * @max:                max number of raw events
 *
 * Attempts to encode the scancode as raw events.
 *
 * Returns:     The number of events written.
 *              -ENOBUFS if there isn't enough space in the array to fit the
 *              encoding. In this case all @max events will have been written.
 *              -EINVAL if the scancode is ambiguous or invalid, or if no
 *              compatible encoder was found.
 */


int ir_raw_encode_scancode(enum rc_type protocol, u32 scancode,
			   struct ir_raw_event *events, unsigned int max)
{
	struct ir_raw_handler *handler;
	int ret = -EINVAL;
	u64 mask = 1ULL << protocol;

	mutex_lock(&ir_raw_handler_lock);
	list_for_each_entry(handler, &ir_raw_handler_list, list) {
		if (handler->protocols & mask && handler->encode) {
			ret = handler->encode(protocol, scancode, events, max);
			if (ret >= 0 || ret == -ENOBUFS)
				break;
		}
	}
	mutex_unlock(&ir_raw_handler_lock);

	return ret;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
James Hogan
105
100.00%
1
100.00%
Total
105
100.00%
1
100.00%


EXPORT_SYMBOL(ir_raw_encode_scancode);

/*
 * Used to (un)register raw event clients
 */


int ir_raw_event_register(struct rc_dev *dev)
{
	int rc;
	struct ir_raw_handler *handler;

	if (!dev)
		return -EINVAL;

	dev->raw = kzalloc(sizeof(*dev->raw), GFP_KERNEL);
	if (!dev->raw)
		return -ENOMEM;

	dev->raw->dev = dev;
	dev->change_protocol = change_protocol;
	INIT_KFIFO(dev->raw->kfifo);

	/*
         * raw transmitters do not need any event registration
         * because the event is coming from userspace
         */
	if (dev->driver_type != RC_DRIVER_IR_RAW_TX) {
		dev->raw->thread = kthread_run(ir_raw_event_thread, dev->raw,
					       "rc%u", dev->minor);

		if (IS_ERR(dev->raw->thread)) {
			rc = PTR_ERR(dev->raw->thread);
			goto out;
		}
	}

	mutex_lock(&ir_raw_handler_lock);
	list_add_tail(&dev->raw->list, &ir_raw_client_list);
	list_for_each_entry(handler, &ir_raw_handler_list, list)
		if (handler->raw_register)
			handler->raw_register(dev);
	mutex_unlock(&ir_raw_handler_lock);

	return 0;

out:
	kfree(dev->raw);
	dev->raw = NULL;
	return rc;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
David Härdeman
154
75.49%
6
54.55%
Maxim Levitsky
31
15.20%
2
18.18%
Andi Shyti
11
5.39%
1
9.09%
Dan Carpenter
7
3.43%
1
9.09%
Heiner Kallweit
1
0.49%
1
9.09%
Total
204
100.00%
11
100.00%



void ir_raw_event_unregister(struct rc_dev *dev)
{
	struct ir_raw_handler *handler;

	if (!dev || !dev->raw)
		return;

	kthread_stop(dev->raw->thread);

	mutex_lock(&ir_raw_handler_lock);
	list_del(&dev->raw->list);
	list_for_each_entry(handler, &ir_raw_handler_list, list)
		if (handler->raw_unregister)
			handler->raw_unregister(dev);
	mutex_unlock(&ir_raw_handler_lock);

	kfree(dev->raw);
	dev->raw = NULL;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
David Härdeman
87
95.60%
3
60.00%
Maxim Levitsky
4
4.40%
2
40.00%
Total
91
100.00%
5
100.00%

/*
 * Extension interface - used to register the IR decoders
 */



int ir_raw_handler_register(struct ir_raw_handler *ir_raw_handler)
{
	struct ir_raw_event_ctrl *raw;

	mutex_lock(&ir_raw_handler_lock);
	list_add_tail(&ir_raw_handler->list, &ir_raw_handler_list);
	if (ir_raw_handler->raw_register)
		list_for_each_entry(raw, &ir_raw_client_list, list)
			ir_raw_handler->raw_register(raw->dev);
	atomic64_or(ir_raw_handler->protocols, &available_protocols);
	mutex_unlock(&ir_raw_handler_lock);

	return 0;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
David Härdeman
37
50.00%
3
42.86%
Mauro Carvalho Chehab
27
36.49%
1
14.29%
Heiner Kallweit
9
12.16%
2
28.57%
Maxim Levitsky
1
1.35%
1
14.29%
Total
74
100.00%
7
100.00%


EXPORT_SYMBOL(ir_raw_handler_register);



void ir_raw_handler_unregister(struct ir_raw_handler *ir_raw_handler)
{
	struct ir_raw_event_ctrl *raw;
	u64 protocols = ir_raw_handler->protocols;

	mutex_lock(&ir_raw_handler_lock);
	list_del(&ir_raw_handler->list);
	list_for_each_entry(raw, &ir_raw_client_list, list) {
		ir_raw_disable_protocols(raw->dev, protocols);
		if (ir_raw_handler->raw_unregister)
			ir_raw_handler->raw_unregister(raw->dev);
	}
	atomic64_andnot(protocols, &available_protocols);
	mutex_unlock(&ir_raw_handler_lock);
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Heiner Kallweit
33
39.29%
3
37.50%
Mauro Carvalho Chehab
27
32.14%
1
12.50%
David Härdeman
23
27.38%
3
37.50%
Maxim Levitsky
1
1.19%
1
12.50%
Total
84
100.00%
8
100.00%


EXPORT_SYMBOL(ir_raw_handler_unregister);
Overall Contributors
Person
Tokens
Prop
Commits
CommitProp
David Härdeman
615
27.35%
9
21.43%
Antti Seppälä
336
14.94%
1
2.38%
James Hogan
328
14.58%
2
4.76%
Maxim Levitsky
313
13.92%
6
14.29%
Sean Young
265
11.78%
2
4.76%
Mauro Carvalho Chehab
175
7.78%
9
21.43%
Heiner Kallweit
166
7.38%
6
14.29%
Jarod Wilson
18
0.80%
1
2.38%
Andi Shyti
11
0.49%
1
2.38%
Dan Carpenter
7
0.31%
1
2.38%
Srinivas Kandagatla
6
0.27%
1
2.38%
Randy Dunlap
3
0.13%
1
2.38%
Stephen Rothwell
3
0.13%
1
2.38%
Paul Gortmaker
3
0.13%
1
2.38%
Total
2249
100.00%
42
100.00%
Directory: drivers/media/rc

Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.