[GitHub/mt8127/android_kernel_alcatel_ttab.git] / drivers / input / misc / dm355evm_keys.c

/*
 * dm355evm_keys.c - support buttons and IR remote on DM355 EVM board
 *
 * Copyright (c) 2008 by David Brownell
 *
 * 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; either version
 * 2 of the License, or (at your option) any later version.
 */
#include <linux/kernel.h>
#include <linux/init.h>
#include <linux/slab.h>
#include <linux/input.h>
#include <linux/input/sparse-keymap.h>
#include <linux/platform_device.h>
#include <linux/interrupt.h>

#include <linux/i2c/dm355evm_msp.h>
#include <linux/module.h>


/*
 * The MSP430 firmware on the DM355 EVM monitors on-board pushbuttons
 * and an IR receptor used for the remote control.  When any key is
 * pressed, or its autorepeat kicks in, an event is sent.  This driver
 * read those events from the small (32 event) queue and reports them.
 *
 * Note that physically there can only be one of these devices.
 *
 * This driver was tested with firmware revision A4.
 */
struct dm355evm_keys {
	struct input_dev	*input;
	struct device		*dev;
	int			irq;
};

/* These initial keycodes can be remapped */
static const struct key_entry dm355evm_keys[] = {
	/*
	 * Pushbuttons on the EVM board ... note that the labels for these
	 * are SW10/SW11/etc on the PC board.  The left/right orientation
	 * comes only from the firmware's documentation, and presumes the
	 * power connector is immediately in front of you and the IR sensor
	 * is to the right.  (That is, rotate the board counter-clockwise
	 * by 90 degrees from the SW10/etc and "DM355 EVM" labels.)
	 */
	{ KE_KEY, 0x00d8, { KEY_OK } },		/* SW12 */
	{ KE_KEY, 0x00b8, { KEY_UP } },		/* SW13 */
	{ KE_KEY, 0x00e8, { KEY_DOWN } },	/* SW11 */
	{ KE_KEY, 0x0078, { KEY_LEFT } },	/* SW14 */
	{ KE_KEY, 0x00f0, { KEY_RIGHT } },	/* SW10 */

	/*
	 * IR buttons ... codes assigned to match the universal remote
	 * provided with the EVM (Philips PM4S) using DVD code 0020.
	 *
	 * These event codes match firmware documentation, but other
	 * remote controls could easily send more RC5-encoded events.
	 * The PM4S manual was used in several cases to help select
	 * a keycode reflecting the intended usage.
	 *
	 * RC5 codes are 14 bits, with two start bits (0x3 prefix)
	 * and a toggle bit (masked out below).
	 */
	{ KE_KEY, 0x300c, { KEY_POWER } },	/* NOTE: docs omit this */
	{ KE_KEY, 0x3000, { KEY_NUMERIC_0 } },
	{ KE_KEY, 0x3001, { KEY_NUMERIC_1 } },
	{ KE_KEY, 0x3002, { KEY_NUMERIC_2 } },
	{ KE_KEY, 0x3003, { KEY_NUMERIC_3 } },
	{ KE_KEY, 0x3004, { KEY_NUMERIC_4 } },
	{ KE_KEY, 0x3005, { KEY_NUMERIC_5 } },
	{ KE_KEY, 0x3006, { KEY_NUMERIC_6 } },
	{ KE_KEY, 0x3007, { KEY_NUMERIC_7 } },
	{ KE_KEY, 0x3008, { KEY_NUMERIC_8 } },
	{ KE_KEY, 0x3009, { KEY_NUMERIC_9 } },
	{ KE_KEY, 0x3022, { KEY_ENTER } },
	{ KE_KEY, 0x30ec, { KEY_MODE } },	/* "tv/vcr/..." */
	{ KE_KEY, 0x300f, { KEY_SELECT } },	/* "info" */
	{ KE_KEY, 0x3020, { KEY_CHANNELUP } },	/* "up" */
	{ KE_KEY, 0x302e, { KEY_MENU } },	/* "in/out" */
	{ KE_KEY, 0x3011, { KEY_VOLUMEDOWN } },	/* "left" */
	{ KE_KEY, 0x300d, { KEY_MUTE } },	/* "ok" */
	{ KE_KEY, 0x3010, { KEY_VOLUMEUP } },	/* "right" */
	{ KE_KEY, 0x301e, { KEY_SUBTITLE } },	/* "cc" */
	{ KE_KEY, 0x3021, { KEY_CHANNELDOWN } },/* "down" */
	{ KE_KEY, 0x3022, { KEY_PREVIOUS } },
	{ KE_KEY, 0x3026, { KEY_SLEEP } },
	{ KE_KEY, 0x3172, { KEY_REWIND } },	/* NOTE: docs wrongly say 0x30ca */
	{ KE_KEY, 0x3175, { KEY_PLAY } },
	{ KE_KEY, 0x3174, { KEY_FASTFORWARD } },
	{ KE_KEY, 0x3177, { KEY_RECORD } },
	{ KE_KEY, 0x3176, { KEY_STOP } },
	{ KE_KEY, 0x3169, { KEY_PAUSE } },
};

/*
 * Because we communicate with the MSP430 using I2C, and all I2C calls
 * in Linux sleep, we use a threaded IRQ handler.  The IRQ itself is
 * active low, but we go through the GPIO controller so we can trigger
 * on falling edges and not worry about enabling/disabling the IRQ in
 * the keypress handling path.
 */
static irqreturn_t dm355evm_keys_irq(int irq, void *_keys)
{
	static u16 last_event;
	struct dm355evm_keys *keys = _keys;
	const struct key_entry *ke;
	unsigned int keycode;
	int status;
	u16 event;

	/* For simplicity we ignore INPUT_COUNT and just read
	 * events until we get the "queue empty" indicator.
	 * Reading INPUT_LOW decrements the count.
	 */
	for (;;) {
		status = dm355evm_msp_read(DM355EVM_MSP_INPUT_HIGH);
		if (status < 0) {
			dev_dbg(keys->dev, "input high err %d\n",
					status);
			break;
		}
		event = status << 8;

		status = dm355evm_msp_read(DM355EVM_MSP_INPUT_LOW);
		if (status < 0) {
			dev_dbg(keys->dev, "input low err %d\n",
					status);
			break;
		}
		event |= status;
		if (event == 0xdead)
			break;

		/* Press and release a button:  two events, same code.
		 * Press and hold (autorepeat), then release: N events
		 * (N > 2), same code.  For RC5 buttons the toggle bits
		 * distinguish (for example) "1-autorepeat" from "1 1";
		 * but PCB buttons don't support that bit.
		 *
		 * So we must synthesize release events.  We do that by
		 * mapping events to a press/release event pair; then
		 * to avoid adding extra events, skip the second event
		 * of each pair.
		 */
		if (event == last_event) {
			last_event = 0;
			continue;
		}
		last_event = event;

		/* ignore the RC5 toggle bit */
		event &= ~0x0800;

		/* find the key, or report it as unknown */
		ke = sparse_keymap_entry_from_scancode(keys->input, event);
		keycode = ke ? ke->keycode : KEY_UNKNOWN;
		dev_dbg(keys->dev,
			"input event 0x%04x--> keycode %d\n",
			event, keycode);

		/* report press + release */
		input_report_key(keys->input, keycode, 1);
		input_sync(keys->input);
		input_report_key(keys->input, keycode, 0);
		input_sync(keys->input);
	}

	return IRQ_HANDLED;
}

/*----------------------------------------------------------------------*/

static int __devinit dm355evm_keys_probe(struct platform_device *pdev)
{
	struct dm355evm_keys	*keys;
	struct input_dev	*input;
	int			status;

	/* allocate instance struct and input dev */
	keys = kzalloc(sizeof *keys, GFP_KERNEL);
	input = input_allocate_device();
	if (!keys || !input) {
		status = -ENOMEM;
		goto fail1;
	}

	keys->dev = &pdev->dev;
	keys->input = input;

	/* set up "threaded IRQ handler" */
	status = platform_get_irq(pdev, 0);
	if (status < 0)
		goto fail1;
	keys->irq = status;

	input_set_drvdata(input, keys);

	input->name = "DM355 EVM Controls";
	input->phys = "dm355evm/input0";
	input->dev.parent = &pdev->dev;

	input->id.bustype = BUS_I2C;
	input->id.product = 0x0355;
	input->id.version = dm355evm_msp_read(DM355EVM_MSP_FIRMREV);

	status = sparse_keymap_setup(input, dm355evm_keys, NULL);
	if (status)
		goto fail1;

	/* REVISIT:  flush the event queue? */

	status = request_threaded_irq(keys->irq, NULL, dm355evm_keys_irq,
				      IRQF_TRIGGER_FALLING | IRQF_ONESHOT,
				      dev_name(&pdev->dev), keys);
	if (status < 0)
		goto fail2;

	/* register */
	status = input_register_device(input);
	if (status < 0)
		goto fail3;

	platform_set_drvdata(pdev, keys);

	return 0;

fail3:
	free_irq(keys->irq, keys);
fail2:
	sparse_keymap_free(input);
fail1:
	input_free_device(input);
	kfree(keys);
	dev_err(&pdev->dev, "can't register, err %d\n", status);

	return status;
}

static int __devexit dm355evm_keys_remove(struct platform_device *pdev)
{
	struct dm355evm_keys	*keys = platform_get_drvdata(pdev);

	free_irq(keys->irq, keys);
	sparse_keymap_free(keys->input);
	input_unregister_device(keys->input);
	kfree(keys);

	return 0;
}

/* REVISIT:  add suspend/resume when DaVinci supports it.  The IRQ should
 * be able to wake up the system.  When device_may_wakeup(&pdev->dev), call
 * enable_irq_wake() on suspend, and disable_irq_wake() on resume.
 */

/*
 * I2C is used to talk to the MSP430, but this platform device is
 * exposed by an MFD driver that manages I2C communications.
 */
static struct platform_driver dm355evm_keys_driver = {
	.probe		= dm355evm_keys_probe,
	.remove		= __devexit_p(dm355evm_keys_remove),
	.driver		= {
		.owner	= THIS_MODULE,
		.name	= "dm355evm_keys",
	},
};
module_platform_driver(dm355evm_keys_driver);

MODULE_LICENSE("GPL");
Commit	Line	Data
eb990b55 DB	1	/*
	2	* dm355evm_keys.c - support buttons and IR remote on DM355 EVM board
	3	*
	4	* Copyright (c) 2008 by David Brownell
	5	*
	6	* This program is free software; you can redistribute it and/or
	7	* modify it under the terms of the GNU General Public License
	8	* as published by the Free Software Foundation; either version
	9	* 2 of the License, or (at your option) any later version.
	10	*/
	11	#include <linux/kernel.h>
	12	#include <linux/init.h>
5a0e3ad6	13	#include <linux/slab.h>
eb990b55	14	#include <linux/input.h>
66040727	15	#include <linux/input/sparse-keymap.h>
eb990b55 DB	16	#include <linux/platform_device.h>
	17	#include <linux/interrupt.h>
	18
	19	#include <linux/i2c/dm355evm_msp.h>
d2d8442d	20	#include <linux/module.h>
eb990b55 DB	21
	22
	23	/*
	24	* The MSP430 firmware on the DM355 EVM monitors on-board pushbuttons
	25	* and an IR receptor used for the remote control. When any key is
	26	* pressed, or its autorepeat kicks in, an event is sent. This driver
	27	* read those events from the small (32 event) queue and reports them.
	28	*
eb990b55 DB	29	* Note that physically there can only be one of these devices.
	30	*
	31	* This driver was tested with firmware revision A4.
	32	*/
	33	struct dm355evm_keys {
eb990b55 DB	34	struct input_dev *input;
	35	struct device *dev;
	36	int irq;
	37	};
	38
66040727 DT	39	/* These initial keycodes can be remapped */
66040727 DT	40	static const struct key_entry dm355evm_keys[] = {
eb990b55 DB	41	/*
	42	* Pushbuttons on the EVM board ... note that the labels for these
	43	* are SW10/SW11/etc on the PC board. The left/right orientation
	44	* comes only from the firmware's documentation, and presumes the
	45	* power connector is immediately in front of you and the IR sensor
	46	* is to the right. (That is, rotate the board counter-clockwise
	47	* by 90 degrees from the SW10/etc and "DM355 EVM" labels.)
	48	*/
66040727 DT	49	{ KE_KEY, 0x00d8, { KEY_OK } }, /* SW12 */
	50	{ KE_KEY, 0x00b8, { KEY_UP } }, /* SW13 */
	51	{ KE_KEY, 0x00e8, { KEY_DOWN } }, /* SW11 */
	52	{ KE_KEY, 0x0078, { KEY_LEFT } }, /* SW14 */
	53	{ KE_KEY, 0x00f0, { KEY_RIGHT } }, /* SW10 */
eb990b55 DB	54
	55	/*
	56	* IR buttons ... codes assigned to match the universal remote
	57	* provided with the EVM (Philips PM4S) using DVD code 0020.
	58	*
	59	* These event codes match firmware documentation, but other
	60	* remote controls could easily send more RC5-encoded events.
	61	* The PM4S manual was used in several cases to help select
	62	* a keycode reflecting the intended usage.
	63	*
	64	* RC5 codes are 14 bits, with two start bits (0x3 prefix)
	65	* and a toggle bit (masked out below).
	66	*/
66040727 DT	67	{ KE_KEY, 0x300c, { KEY_POWER } }, /* NOTE: docs omit this */
	68	{ KE_KEY, 0x3000, { KEY_NUMERIC_0 } },
	69	{ KE_KEY, 0x3001, { KEY_NUMERIC_1 } },
	70	{ KE_KEY, 0x3002, { KEY_NUMERIC_2 } },
	71	{ KE_KEY, 0x3003, { KEY_NUMERIC_3 } },
	72	{ KE_KEY, 0x3004, { KEY_NUMERIC_4 } },
	73	{ KE_KEY, 0x3005, { KEY_NUMERIC_5 } },
	74	{ KE_KEY, 0x3006, { KEY_NUMERIC_6 } },
	75	{ KE_KEY, 0x3007, { KEY_NUMERIC_7 } },
	76	{ KE_KEY, 0x3008, { KEY_NUMERIC_8 } },
	77	{ KE_KEY, 0x3009, { KEY_NUMERIC_9 } },
	78	{ KE_KEY, 0x3022, { KEY_ENTER } },
	79	{ KE_KEY, 0x30ec, { KEY_MODE } }, /* "tv/vcr/..." */
	80	{ KE_KEY, 0x300f, { KEY_SELECT } }, /* "info" */
	81	{ KE_KEY, 0x3020, { KEY_CHANNELUP } }, /* "up" */
	82	{ KE_KEY, 0x302e, { KEY_MENU } }, /* "in/out" */
	83	{ KE_KEY, 0x3011, { KEY_VOLUMEDOWN } }, /* "left" */
	84	{ KE_KEY, 0x300d, { KEY_MUTE } }, /* "ok" */
	85	{ KE_KEY, 0x3010, { KEY_VOLUMEUP } }, /* "right" */
	86	{ KE_KEY, 0x301e, { KEY_SUBTITLE } }, /* "cc" */
	87	{ KE_KEY, 0x3021, { KEY_CHANNELDOWN } },/* "down" */
	88	{ KE_KEY, 0x3022, { KEY_PREVIOUS } },
	89	{ KE_KEY, 0x3026, { KEY_SLEEP } },
	90	{ KE_KEY, 0x3172, { KEY_REWIND } }, /* NOTE: docs wrongly say 0x30ca */
	91	{ KE_KEY, 0x3175, { KEY_PLAY } },
	92	{ KE_KEY, 0x3174, { KEY_FASTFORWARD } },
	93	{ KE_KEY, 0x3177, { KEY_RECORD } },
	94	{ KE_KEY, 0x3176, { KEY_STOP } },
	95	{ KE_KEY, 0x3169, { KEY_PAUSE } },
eb990b55 DB	96	};
eb990b55 DB	97
3b0a9ce0 DT	98	/*
	99	* Because we communicate with the MSP430 using I2C, and all I2C calls
	100	* in Linux sleep, we use a threaded IRQ handler. The IRQ itself is
	101	* active low, but we go through the GPIO controller so we can trigger
	102	* on falling edges and not worry about enabling/disabling the IRQ in
	103	* the keypress handling path.
	104	*/
666cbe34	105	static irqreturn_t dm355evm_keys_irq(int irq, void *_keys)
eb990b55	106	{
66040727 DT	107	static u16 last_event;
	108	struct dm355evm_keys *keys = _keys;
	109	const struct key_entry *ke;
	110	unsigned int keycode;
	111	int status;
	112	u16 event;
eb990b55	113
eb990b55 DB	114	/* For simplicity we ignore INPUT_COUNT and just read
	115	* events until we get the "queue empty" indicator.
	116	* Reading INPUT_LOW decrements the count.
	117	*/
	118	for (;;) {
eb990b55 DB	119	status = dm355evm_msp_read(DM355EVM_MSP_INPUT_HIGH);
	120	if (status < 0) {
	121	dev_dbg(keys->dev, "input high err %d\n",
	122	status);
	123	break;
	124	}
	125	event = status << 8;
	126
	127	status = dm355evm_msp_read(DM355EVM_MSP_INPUT_LOW);
	128	if (status < 0) {
	129	dev_dbg(keys->dev, "input low err %d\n",
	130	status);
	131	break;
	132	}
	133	event \|= status;
	134	if (event == 0xdead)
	135	break;
	136
	137	/* Press and release a button: two events, same code.
	138	* Press and hold (autorepeat), then release: N events
	139	* (N > 2), same code. For RC5 buttons the toggle bits
	140	* distinguish (for example) "1-autorepeat" from "1 1";
	141	* but PCB buttons don't support that bit.
	142	*
	143	* So we must synthesize release events. We do that by
	144	* mapping events to a press/release event pair; then
	145	* to avoid adding extra events, skip the second event
	146	* of each pair.
	147	*/
	148	if (event == last_event) {
	149	last_event = 0;
	150	continue;
	151	}
	152	last_event = event;
	153
	154	/* ignore the RC5 toggle bit */
	155	event &= ~0x0800;
	156
66040727 DT	157	/* find the key, or report it as unknown */
	158	ke = sparse_keymap_entry_from_scancode(keys->input, event);
	159	keycode = ke ? ke->keycode : KEY_UNKNOWN;
eb990b55 DB	160	dev_dbg(keys->dev,
	161	"input event 0x%04x--> keycode %d\n",
	162	event, keycode);
	163
	164	/* report press + release */
	165	input_report_key(keys->input, keycode, 1);
	166	input_sync(keys->input);
	167	input_report_key(keys->input, keycode, 0);
	168	input_sync(keys->input);
	169	}
666cbe34	170
66040727	171	return IRQ_HANDLED;
eb990b55 DB	172	}
	173
	174	/----------------------------------------------------------------------/
	175
	176	static int __devinit dm355evm_keys_probe(struct platform_device *pdev)
	177	{
	178	struct dm355evm_keys *keys;
	179	struct input_dev *input;
	180	int status;
eb990b55 DB	181
	182	/* allocate instance struct and input dev */
	183	keys = kzalloc(sizeof *keys, GFP_KERNEL);
	184	input = input_allocate_device();
	185	if (!keys \|\| !input) {
	186	status = -ENOMEM;
	187	goto fail1;
	188	}
	189
	190	keys->dev = &pdev->dev;
	191	keys->input = input;
eb990b55 DB	192
	193	/* set up "threaded IRQ handler" */
	194	status = platform_get_irq(pdev, 0);
	195	if (status < 0)
	196	goto fail1;
	197	keys->irq = status;
	198
	199	input_set_drvdata(input, keys);
	200
	201	input->name = "DM355 EVM Controls";
	202	input->phys = "dm355evm/input0";
	203	input->dev.parent = &pdev->dev;
	204
	205	input->id.bustype = BUS_I2C;
	206	input->id.product = 0x0355;
	207	input->id.version = dm355evm_msp_read(DM355EVM_MSP_FIRMREV);
	208
66040727 DT	209	status = sparse_keymap_setup(input, dm355evm_keys, NULL);
	210	if (status)
	211	goto fail1;
eb990b55 DB	212
	213	/* REVISIT: flush the event queue? */
	214
3b0a9ce0	215	status = request_threaded_irq(keys->irq, NULL, dm355evm_keys_irq,
9b7e31bb LPC	216	IRQF_TRIGGER_FALLING \| IRQF_ONESHOT,
9b7e31bb LPC	217	dev_name(&pdev->dev), keys);
eb990b55	218	if (status < 0)
66040727	219	goto fail2;
eb990b55 DB	220
	221	/* register */
	222	status = input_register_device(input);
	223	if (status < 0)
66040727	224	goto fail3;
eb990b55 DB	225
	226	platform_set_drvdata(pdev, keys);
	227
	228	return 0;
	229
66040727	230	fail3:
eb990b55	231	free_irq(keys->irq, keys);
66040727 DT	232	fail2:
66040727 DT	233	sparse_keymap_free(input);
eb990b55 DB	234	fail1:
	235	input_free_device(input);
	236	kfree(keys);
	237	dev_err(&pdev->dev, "can't register, err %d\n", status);
	238
	239	return status;
	240	}
	241
	242	static int __devexit dm355evm_keys_remove(struct platform_device *pdev)
	243	{
	244	struct dm355evm_keys *keys = platform_get_drvdata(pdev);
	245
	246	free_irq(keys->irq, keys);
66040727	247	sparse_keymap_free(keys->input);
eb990b55 DB	248	input_unregister_device(keys->input);
	249	kfree(keys);
	250
	251	return 0;
	252	}
	253
	254	/* REVISIT: add suspend/resume when DaVinci supports it. The IRQ should
	255	* be able to wake up the system. When device_may_wakeup(&pdev->dev), call
	256	* enable_irq_wake() on suspend, and disable_irq_wake() on resume.
	257	*/
	258
	259	/*
	260	* I2C is used to talk to the MSP430, but this platform device is
	261	* exposed by an MFD driver that manages I2C communications.
	262	*/
	263	static struct platform_driver dm355evm_keys_driver = {
	264	.probe = dm355evm_keys_probe,
	265	.remove = __devexit_p(dm355evm_keys_remove),
	266	.driver = {
	267	.owner = THIS_MODULE,
	268	.name = "dm355evm_keys",
	269	},
	270	};
840a746b	271	module_platform_driver(dm355evm_keys_driver);
eb990b55 DB	272
eb990b55 DB	273	MODULE_LICENSE("GPL");