Linux Audio

Check our new training course

Loading...
v6.2
   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3 * Driver for keys on GPIO lines capable of generating interrupts.
   4 *
   5 * Copyright 2005 Phil Blundell
   6 * Copyright 2010, 2011 David Jander <david@protonic.nl>
 
 
 
 
   7 */
   8
   9#include <linux/module.h>
  10
  11#include <linux/hrtimer.h>
  12#include <linux/init.h>
  13#include <linux/fs.h>
  14#include <linux/interrupt.h>
  15#include <linux/irq.h>
  16#include <linux/sched.h>
  17#include <linux/pm.h>
  18#include <linux/slab.h>
  19#include <linux/sysctl.h>
  20#include <linux/proc_fs.h>
  21#include <linux/delay.h>
  22#include <linux/platform_device.h>
  23#include <linux/input.h>
  24#include <linux/gpio_keys.h>
  25#include <linux/workqueue.h>
  26#include <linux/gpio.h>
  27#include <linux/gpio/consumer.h>
  28#include <linux/of.h>
  29#include <linux/of_irq.h>
  30#include <linux/spinlock.h>
  31#include <dt-bindings/input/gpio-keys.h>
  32
  33struct gpio_button_data {
  34	const struct gpio_keys_button *button;
  35	struct input_dev *input;
  36	struct gpio_desc *gpiod;
  37
  38	unsigned short *code;
  39
  40	struct hrtimer release_timer;
  41	unsigned int release_delay;	/* in msecs, for IRQ-only buttons */
  42
  43	struct delayed_work work;
  44	struct hrtimer debounce_timer;
  45	unsigned int software_debounce;	/* in msecs, for GPIO-driven buttons */
  46
  47	unsigned int irq;
  48	unsigned int wakeup_trigger_type;
  49	spinlock_t lock;
  50	bool disabled;
  51	bool key_pressed;
  52	bool suspended;
  53	bool debounce_use_hrtimer;
  54};
  55
  56struct gpio_keys_drvdata {
  57	const struct gpio_keys_platform_data *pdata;
  58	struct input_dev *input;
  59	struct mutex disable_lock;
  60	unsigned short *keymap;
  61	struct gpio_button_data data[];
 
 
  62};
  63
  64/*
  65 * SYSFS interface for enabling/disabling keys and switches:
  66 *
  67 * There are 4 attributes under /sys/devices/platform/gpio-keys/
  68 *	keys [ro]              - bitmap of keys (EV_KEY) which can be
  69 *	                         disabled
  70 *	switches [ro]          - bitmap of switches (EV_SW) which can be
  71 *	                         disabled
  72 *	disabled_keys [rw]     - bitmap of keys currently disabled
  73 *	disabled_switches [rw] - bitmap of switches currently disabled
  74 *
  75 * Userland can change these values and hence disable event generation
  76 * for each key (or switch). Disabling a key means its interrupt line
  77 * is disabled.
  78 *
  79 * For example, if we have following switches set up as gpio-keys:
  80 *	SW_DOCK = 5
  81 *	SW_CAMERA_LENS_COVER = 9
  82 *	SW_KEYPAD_SLIDE = 10
  83 *	SW_FRONT_PROXIMITY = 11
  84 * This is read from switches:
  85 *	11-9,5
  86 * Next we want to disable proximity (11) and dock (5), we write:
  87 *	11,5
  88 * to file disabled_switches. Now proximity and dock IRQs are disabled.
  89 * This can be verified by reading the file disabled_switches:
  90 *	11,5
  91 * If we now want to enable proximity (11) switch we write:
  92 *	5
  93 * to disabled_switches.
  94 *
  95 * We can disable only those keys which don't allow sharing the irq.
  96 */
  97
  98/**
  99 * get_n_events_by_type() - returns maximum number of events per @type
 100 * @type: type of button (%EV_KEY, %EV_SW)
 101 *
 102 * Return value of this function can be used to allocate bitmap
 103 * large enough to hold all bits for given type.
 104 */
 105static int get_n_events_by_type(int type)
 106{
 107	BUG_ON(type != EV_SW && type != EV_KEY);
 108
 109	return (type == EV_KEY) ? KEY_CNT : SW_CNT;
 110}
 111
 112/**
 113 * get_bm_events_by_type() - returns bitmap of supported events per @type
 114 * @dev: input device from which bitmap is retrieved
 115 * @type: type of button (%EV_KEY, %EV_SW)
 116 *
 117 * Return value of this function can be used to allocate bitmap
 118 * large enough to hold all bits for given type.
 119 */
 120static const unsigned long *get_bm_events_by_type(struct input_dev *dev,
 121						  int type)
 122{
 123	BUG_ON(type != EV_SW && type != EV_KEY);
 124
 125	return (type == EV_KEY) ? dev->keybit : dev->swbit;
 126}
 127
 128static void gpio_keys_quiesce_key(void *data)
 129{
 130	struct gpio_button_data *bdata = data;
 131
 132	if (!bdata->gpiod)
 133		hrtimer_cancel(&bdata->release_timer);
 134	else if (bdata->debounce_use_hrtimer)
 135		hrtimer_cancel(&bdata->debounce_timer);
 136	else
 137		cancel_delayed_work_sync(&bdata->work);
 138}
 139
 140/**
 141 * gpio_keys_disable_button() - disables given GPIO button
 142 * @bdata: button data for button to be disabled
 143 *
 144 * Disables button pointed by @bdata. This is done by masking
 145 * IRQ line. After this function is called, button won't generate
 146 * input events anymore. Note that one can only disable buttons
 147 * that don't share IRQs.
 148 *
 149 * Make sure that @bdata->disable_lock is locked when entering
 150 * this function to avoid races when concurrent threads are
 151 * disabling buttons at the same time.
 152 */
 153static void gpio_keys_disable_button(struct gpio_button_data *bdata)
 154{
 155	if (!bdata->disabled) {
 156		/*
 157		 * Disable IRQ and associated timer/work structure.
 158		 */
 159		disable_irq(bdata->irq);
 160		gpio_keys_quiesce_key(bdata);
 
 
 161		bdata->disabled = true;
 162	}
 163}
 164
 165/**
 166 * gpio_keys_enable_button() - enables given GPIO button
 167 * @bdata: button data for button to be disabled
 168 *
 169 * Enables given button pointed by @bdata.
 170 *
 171 * Make sure that @bdata->disable_lock is locked when entering
 172 * this function to avoid races with concurrent threads trying
 173 * to enable the same button at the same time.
 174 */
 175static void gpio_keys_enable_button(struct gpio_button_data *bdata)
 176{
 177	if (bdata->disabled) {
 178		enable_irq(bdata->irq);
 179		bdata->disabled = false;
 180	}
 181}
 182
 183/**
 184 * gpio_keys_attr_show_helper() - fill in stringified bitmap of buttons
 185 * @ddata: pointer to drvdata
 186 * @buf: buffer where stringified bitmap is written
 187 * @type: button type (%EV_KEY, %EV_SW)
 188 * @only_disabled: does caller want only those buttons that are
 189 *                 currently disabled or all buttons that can be
 190 *                 disabled
 191 *
 192 * This function writes buttons that can be disabled to @buf. If
 193 * @only_disabled is true, then @buf contains only those buttons
 194 * that are currently disabled. Returns 0 on success or negative
 195 * errno on failure.
 196 */
 197static ssize_t gpio_keys_attr_show_helper(struct gpio_keys_drvdata *ddata,
 198					  char *buf, unsigned int type,
 199					  bool only_disabled)
 200{
 201	int n_events = get_n_events_by_type(type);
 202	unsigned long *bits;
 203	ssize_t ret;
 204	int i;
 205
 206	bits = bitmap_zalloc(n_events, GFP_KERNEL);
 207	if (!bits)
 208		return -ENOMEM;
 209
 210	for (i = 0; i < ddata->pdata->nbuttons; i++) {
 211		struct gpio_button_data *bdata = &ddata->data[i];
 212
 213		if (bdata->button->type != type)
 214			continue;
 215
 216		if (only_disabled && !bdata->disabled)
 217			continue;
 218
 219		__set_bit(*bdata->code, bits);
 220	}
 221
 222	ret = scnprintf(buf, PAGE_SIZE - 1, "%*pbl", n_events, bits);
 223	buf[ret++] = '\n';
 224	buf[ret] = '\0';
 225
 226	bitmap_free(bits);
 227
 228	return ret;
 229}
 230
 231/**
 232 * gpio_keys_attr_store_helper() - enable/disable buttons based on given bitmap
 233 * @ddata: pointer to drvdata
 234 * @buf: buffer from userspace that contains stringified bitmap
 235 * @type: button type (%EV_KEY, %EV_SW)
 236 *
 237 * This function parses stringified bitmap from @buf and disables/enables
 238 * GPIO buttons accordingly. Returns 0 on success and negative error
 239 * on failure.
 240 */
 241static ssize_t gpio_keys_attr_store_helper(struct gpio_keys_drvdata *ddata,
 242					   const char *buf, unsigned int type)
 243{
 244	int n_events = get_n_events_by_type(type);
 245	const unsigned long *bitmap = get_bm_events_by_type(ddata->input, type);
 246	unsigned long *bits;
 247	ssize_t error;
 248	int i;
 249
 250	bits = bitmap_alloc(n_events, GFP_KERNEL);
 251	if (!bits)
 252		return -ENOMEM;
 253
 254	error = bitmap_parselist(buf, bits, n_events);
 255	if (error)
 256		goto out;
 257
 258	/* First validate */
 259	if (!bitmap_subset(bits, bitmap, n_events)) {
 260		error = -EINVAL;
 261		goto out;
 262	}
 263
 264	for (i = 0; i < ddata->pdata->nbuttons; i++) {
 265		struct gpio_button_data *bdata = &ddata->data[i];
 266
 267		if (bdata->button->type != type)
 268			continue;
 269
 270		if (test_bit(*bdata->code, bits) &&
 271		    !bdata->button->can_disable) {
 272			error = -EINVAL;
 273			goto out;
 274		}
 275	}
 276
 277	mutex_lock(&ddata->disable_lock);
 278
 279	for (i = 0; i < ddata->pdata->nbuttons; i++) {
 280		struct gpio_button_data *bdata = &ddata->data[i];
 281
 282		if (bdata->button->type != type)
 283			continue;
 284
 285		if (test_bit(*bdata->code, bits))
 286			gpio_keys_disable_button(bdata);
 287		else
 288			gpio_keys_enable_button(bdata);
 289	}
 290
 291	mutex_unlock(&ddata->disable_lock);
 292
 293out:
 294	bitmap_free(bits);
 295	return error;
 296}
 297
 298#define ATTR_SHOW_FN(name, type, only_disabled)				\
 299static ssize_t gpio_keys_show_##name(struct device *dev,		\
 300				     struct device_attribute *attr,	\
 301				     char *buf)				\
 302{									\
 303	struct platform_device *pdev = to_platform_device(dev);		\
 304	struct gpio_keys_drvdata *ddata = platform_get_drvdata(pdev);	\
 305									\
 306	return gpio_keys_attr_show_helper(ddata, buf,			\
 307					  type, only_disabled);		\
 308}
 309
 310ATTR_SHOW_FN(keys, EV_KEY, false);
 311ATTR_SHOW_FN(switches, EV_SW, false);
 312ATTR_SHOW_FN(disabled_keys, EV_KEY, true);
 313ATTR_SHOW_FN(disabled_switches, EV_SW, true);
 314
 315/*
 316 * ATTRIBUTES:
 317 *
 318 * /sys/devices/platform/gpio-keys/keys [ro]
 319 * /sys/devices/platform/gpio-keys/switches [ro]
 320 */
 321static DEVICE_ATTR(keys, S_IRUGO, gpio_keys_show_keys, NULL);
 322static DEVICE_ATTR(switches, S_IRUGO, gpio_keys_show_switches, NULL);
 323
 324#define ATTR_STORE_FN(name, type)					\
 325static ssize_t gpio_keys_store_##name(struct device *dev,		\
 326				      struct device_attribute *attr,	\
 327				      const char *buf,			\
 328				      size_t count)			\
 329{									\
 330	struct platform_device *pdev = to_platform_device(dev);		\
 331	struct gpio_keys_drvdata *ddata = platform_get_drvdata(pdev);	\
 332	ssize_t error;							\
 333									\
 334	error = gpio_keys_attr_store_helper(ddata, buf, type);		\
 335	if (error)							\
 336		return error;						\
 337									\
 338	return count;							\
 339}
 340
 341ATTR_STORE_FN(disabled_keys, EV_KEY);
 342ATTR_STORE_FN(disabled_switches, EV_SW);
 343
 344/*
 345 * ATTRIBUTES:
 346 *
 347 * /sys/devices/platform/gpio-keys/disabled_keys [rw]
 348 * /sys/devices/platform/gpio-keys/disables_switches [rw]
 349 */
 350static DEVICE_ATTR(disabled_keys, S_IWUSR | S_IRUGO,
 351		   gpio_keys_show_disabled_keys,
 352		   gpio_keys_store_disabled_keys);
 353static DEVICE_ATTR(disabled_switches, S_IWUSR | S_IRUGO,
 354		   gpio_keys_show_disabled_switches,
 355		   gpio_keys_store_disabled_switches);
 356
 357static struct attribute *gpio_keys_attrs[] = {
 358	&dev_attr_keys.attr,
 359	&dev_attr_switches.attr,
 360	&dev_attr_disabled_keys.attr,
 361	&dev_attr_disabled_switches.attr,
 362	NULL,
 363};
 364ATTRIBUTE_GROUPS(gpio_keys);
 365
 366static void gpio_keys_gpio_report_event(struct gpio_button_data *bdata)
 
 
 
 
 367{
 368	const struct gpio_keys_button *button = bdata->button;
 369	struct input_dev *input = bdata->input;
 370	unsigned int type = button->type ?: EV_KEY;
 371	int state;
 372
 373	state = bdata->debounce_use_hrtimer ?
 374			gpiod_get_value(bdata->gpiod) :
 375			gpiod_get_value_cansleep(bdata->gpiod);
 376	if (state < 0) {
 377		dev_err(input->dev.parent,
 378			"failed to get gpio state: %d\n", state);
 379		return;
 380	}
 381
 382	if (type == EV_ABS) {
 383		if (state)
 384			input_event(input, type, button->code, button->value);
 385	} else {
 386		input_event(input, type, *bdata->code, state);
 387	}
 
 388}
 389
 390static void gpio_keys_debounce_event(struct gpio_button_data *bdata)
 391{
 392	gpio_keys_gpio_report_event(bdata);
 393	input_sync(bdata->input);
 394
 395	if (bdata->button->wakeup)
 396		pm_relax(bdata->input->dev.parent);
 397}
 398
 399static void gpio_keys_gpio_work_func(struct work_struct *work)
 400{
 401	struct gpio_button_data *bdata =
 402		container_of(work, struct gpio_button_data, work.work);
 403
 404	gpio_keys_debounce_event(bdata);
 405}
 406
 407static enum hrtimer_restart gpio_keys_debounce_timer(struct hrtimer *t)
 408{
 409	struct gpio_button_data *bdata =
 410		container_of(t, struct gpio_button_data, debounce_timer);
 411
 412	gpio_keys_debounce_event(bdata);
 413
 414	return HRTIMER_NORESTART;
 415}
 416
 417static irqreturn_t gpio_keys_gpio_isr(int irq, void *dev_id)
 418{
 419	struct gpio_button_data *bdata = dev_id;
 420
 421	BUG_ON(irq != bdata->irq);
 422
 423	if (bdata->button->wakeup) {
 424		const struct gpio_keys_button *button = bdata->button;
 425
 426		pm_stay_awake(bdata->input->dev.parent);
 427		if (bdata->suspended  &&
 428		    (button->type == 0 || button->type == EV_KEY)) {
 429			/*
 430			 * Simulate wakeup key press in case the key has
 431			 * already released by the time we got interrupt
 432			 * handler to run.
 433			 */
 434			input_report_key(bdata->input, button->code, 1);
 435		}
 436	}
 437
 438	if (bdata->debounce_use_hrtimer) {
 439		hrtimer_start(&bdata->debounce_timer,
 440			      ms_to_ktime(bdata->software_debounce),
 441			      HRTIMER_MODE_REL);
 442	} else {
 443		mod_delayed_work(system_wq,
 444				 &bdata->work,
 445				 msecs_to_jiffies(bdata->software_debounce));
 446	}
 447
 448	return IRQ_HANDLED;
 449}
 450
 451static enum hrtimer_restart gpio_keys_irq_timer(struct hrtimer *t)
 452{
 453	struct gpio_button_data *bdata = container_of(t,
 454						      struct gpio_button_data,
 455						      release_timer);
 456	struct input_dev *input = bdata->input;
 457
 458	if (bdata->key_pressed) {
 459		input_event(input, EV_KEY, *bdata->code, 0);
 460		input_sync(input);
 461		bdata->key_pressed = false;
 462	}
 463
 464	return HRTIMER_NORESTART;
 465}
 466
 467static irqreturn_t gpio_keys_irq_isr(int irq, void *dev_id)
 468{
 469	struct gpio_button_data *bdata = dev_id;
 470	struct input_dev *input = bdata->input;
 471	unsigned long flags;
 472
 473	BUG_ON(irq != bdata->irq);
 474
 475	spin_lock_irqsave(&bdata->lock, flags);
 476
 477	if (!bdata->key_pressed) {
 478		if (bdata->button->wakeup)
 479			pm_wakeup_event(bdata->input->dev.parent, 0);
 480
 481		input_event(input, EV_KEY, *bdata->code, 1);
 482		input_sync(input);
 483
 484		if (!bdata->release_delay) {
 485			input_event(input, EV_KEY, *bdata->code, 0);
 486			input_sync(input);
 487			goto out;
 488		}
 489
 490		bdata->key_pressed = true;
 491	}
 492
 493	if (bdata->release_delay)
 494		hrtimer_start(&bdata->release_timer,
 495			      ms_to_ktime(bdata->release_delay),
 496			      HRTIMER_MODE_REL_HARD);
 497out:
 498	spin_unlock_irqrestore(&bdata->lock, flags);
 499	return IRQ_HANDLED;
 500}
 501
 502static int gpio_keys_setup_key(struct platform_device *pdev,
 503				struct input_dev *input,
 504				struct gpio_keys_drvdata *ddata,
 505				const struct gpio_keys_button *button,
 506				int idx,
 507				struct fwnode_handle *child)
 508{
 509	const char *desc = button->desc ? button->desc : "gpio_keys";
 510	struct device *dev = &pdev->dev;
 511	struct gpio_button_data *bdata = &ddata->data[idx];
 512	irq_handler_t isr;
 513	unsigned long irqflags;
 514	int irq;
 515	int error;
 516
 517	bdata->input = input;
 518	bdata->button = button;
 519	spin_lock_init(&bdata->lock);
 520
 521	if (child) {
 522		bdata->gpiod = devm_fwnode_gpiod_get(dev, child,
 523						     NULL, GPIOD_IN, desc);
 524		if (IS_ERR(bdata->gpiod)) {
 525			error = PTR_ERR(bdata->gpiod);
 526			if (error == -ENOENT) {
 527				/*
 528				 * GPIO is optional, we may be dealing with
 529				 * purely interrupt-driven setup.
 530				 */
 531				bdata->gpiod = NULL;
 532			} else {
 533				if (error != -EPROBE_DEFER)
 534					dev_err(dev, "failed to get gpio: %d\n",
 535						error);
 536				return error;
 537			}
 538		}
 539	} else if (gpio_is_valid(button->gpio)) {
 540		/*
 541		 * Legacy GPIO number, so request the GPIO here and
 542		 * convert it to descriptor.
 543		 */
 544		unsigned flags = GPIOF_IN;
 545
 546		if (button->active_low)
 547			flags |= GPIOF_ACTIVE_LOW;
 548
 549		error = devm_gpio_request_one(dev, button->gpio, flags, desc);
 550		if (error < 0) {
 551			dev_err(dev, "Failed to request GPIO %d, error %d\n",
 552				button->gpio, error);
 553			return error;
 554		}
 555
 556		bdata->gpiod = gpio_to_desc(button->gpio);
 557		if (!bdata->gpiod)
 558			return -EINVAL;
 559	}
 560
 561	if (bdata->gpiod) {
 562		bool active_low = gpiod_is_active_low(bdata->gpiod);
 563
 564		if (button->debounce_interval) {
 565			error = gpiod_set_debounce(bdata->gpiod,
 566					button->debounce_interval * 1000);
 567			/* use timer if gpiolib doesn't provide debounce */
 568			if (error < 0)
 569				bdata->software_debounce =
 570						button->debounce_interval;
 571
 572			/*
 573			 * If reading the GPIO won't sleep, we can use a
 574			 * hrtimer instead of a standard timer for the software
 575			 * debounce, to reduce the latency as much as possible.
 576			 */
 577			bdata->debounce_use_hrtimer =
 578					!gpiod_cansleep(bdata->gpiod);
 579		}
 580
 581		if (button->irq) {
 582			bdata->irq = button->irq;
 583		} else {
 584			irq = gpiod_to_irq(bdata->gpiod);
 585			if (irq < 0) {
 586				error = irq;
 587				dev_err(dev,
 588					"Unable to get irq number for GPIO %d, error %d\n",
 589					button->gpio, error);
 590				return error;
 591			}
 592			bdata->irq = irq;
 593		}
 594
 595		INIT_DELAYED_WORK(&bdata->work, gpio_keys_gpio_work_func);
 596
 597		hrtimer_init(&bdata->debounce_timer,
 598			     CLOCK_REALTIME, HRTIMER_MODE_REL);
 599		bdata->debounce_timer.function = gpio_keys_debounce_timer;
 600
 601		isr = gpio_keys_gpio_isr;
 602		irqflags = IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING;
 603
 604		switch (button->wakeup_event_action) {
 605		case EV_ACT_ASSERTED:
 606			bdata->wakeup_trigger_type = active_low ?
 607				IRQ_TYPE_EDGE_FALLING : IRQ_TYPE_EDGE_RISING;
 608			break;
 609		case EV_ACT_DEASSERTED:
 610			bdata->wakeup_trigger_type = active_low ?
 611				IRQ_TYPE_EDGE_RISING : IRQ_TYPE_EDGE_FALLING;
 612			break;
 613		case EV_ACT_ANY:
 614		default:
 615			/*
 616			 * For other cases, we are OK letting suspend/resume
 617			 * not reconfigure the trigger type.
 618			 */
 619			break;
 620		}
 621	} else {
 622		if (!button->irq) {
 623			dev_err(dev, "Found button without gpio or irq\n");
 624			return -EINVAL;
 625		}
 626
 627		bdata->irq = button->irq;
 628
 629		if (button->type && button->type != EV_KEY) {
 630			dev_err(dev, "Only EV_KEY allowed for IRQ buttons.\n");
 631			return -EINVAL;
 632		}
 633
 634		bdata->release_delay = button->debounce_interval;
 635		hrtimer_init(&bdata->release_timer,
 636			     CLOCK_REALTIME, HRTIMER_MODE_REL_HARD);
 637		bdata->release_timer.function = gpio_keys_irq_timer;
 638
 639		isr = gpio_keys_irq_isr;
 640		irqflags = 0;
 641
 642		/*
 643		 * For IRQ buttons, there is no interrupt for release.
 644		 * So we don't need to reconfigure the trigger type for wakeup.
 645		 */
 
 
 646	}
 647
 648	bdata->code = &ddata->keymap[idx];
 649	*bdata->code = button->code;
 650	input_set_capability(input, button->type ?: EV_KEY, *bdata->code);
 
 
 
 
 651
 652	/*
 653	 * Install custom action to cancel release timer and
 654	 * workqueue item.
 655	 */
 656	error = devm_add_action(dev, gpio_keys_quiesce_key, bdata);
 657	if (error) {
 658		dev_err(dev, "failed to register quiesce action, error: %d\n",
 659			error);
 660		return error;
 661	}
 662
 
 663	/*
 664	 * If platform has specified that the button can be disabled,
 665	 * we don't want it to share the interrupt line.
 666	 */
 667	if (!button->can_disable)
 668		irqflags |= IRQF_SHARED;
 669
 670	error = devm_request_any_context_irq(dev, bdata->irq, isr, irqflags,
 671					     desc, bdata);
 672	if (error < 0) {
 673		dev_err(dev, "Unable to claim irq %d; error %d\n",
 674			bdata->irq, error);
 675		return error;
 676	}
 677
 678	return 0;
 679}
 680
 681static void gpio_keys_report_state(struct gpio_keys_drvdata *ddata)
 682{
 683	struct input_dev *input = ddata->input;
 684	int i;
 685
 686	for (i = 0; i < ddata->pdata->nbuttons; i++) {
 687		struct gpio_button_data *bdata = &ddata->data[i];
 688		if (bdata->gpiod)
 689			gpio_keys_gpio_report_event(bdata);
 690	}
 691	input_sync(input);
 692}
 693
 694static int gpio_keys_open(struct input_dev *input)
 695{
 696	struct gpio_keys_drvdata *ddata = input_get_drvdata(input);
 697	const struct gpio_keys_platform_data *pdata = ddata->pdata;
 698	int error;
 699
 700	if (pdata->enable) {
 701		error = pdata->enable(input->dev.parent);
 702		if (error)
 703			return error;
 704	}
 705
 706	/* Report current state of buttons that are connected to GPIOs */
 707	gpio_keys_report_state(ddata);
 708
 709	return 0;
 710}
 711
 712static void gpio_keys_close(struct input_dev *input)
 713{
 714	struct gpio_keys_drvdata *ddata = input_get_drvdata(input);
 715	const struct gpio_keys_platform_data *pdata = ddata->pdata;
 716
 717	if (pdata->disable)
 718		pdata->disable(input->dev.parent);
 719}
 720
 721/*
 722 * Handlers for alternative sources of platform_data
 723 */
 724
 725/*
 726 * Translate properties into platform_data
 727 */
 728static struct gpio_keys_platform_data *
 729gpio_keys_get_devtree_pdata(struct device *dev)
 730{
 731	struct gpio_keys_platform_data *pdata;
 732	struct gpio_keys_button *button;
 733	struct fwnode_handle *child;
 734	int nbuttons;
 
 735
 736	nbuttons = device_get_child_node_count(dev);
 737	if (nbuttons == 0)
 738		return ERR_PTR(-ENODEV);
 739
 740	pdata = devm_kzalloc(dev,
 741			     sizeof(*pdata) + nbuttons * sizeof(*button),
 742			     GFP_KERNEL);
 743	if (!pdata)
 744		return ERR_PTR(-ENOMEM);
 745
 746	button = (struct gpio_keys_button *)(pdata + 1);
 747
 748	pdata->buttons = button;
 749	pdata->nbuttons = nbuttons;
 750
 751	pdata->rep = device_property_read_bool(dev, "autorepeat");
 752
 753	device_property_read_string(dev, "label", &pdata->name);
 754
 755	device_for_each_child_node(dev, child) {
 756		if (is_of_node(child))
 757			button->irq =
 758				irq_of_parse_and_map(to_of_node(child), 0);
 759
 760		if (fwnode_property_read_u32(child, "linux,code",
 761					     &button->code)) {
 762			dev_err(dev, "Button without keycode\n");
 763			fwnode_handle_put(child);
 764			return ERR_PTR(-EINVAL);
 765		}
 766
 767		fwnode_property_read_string(child, "label", &button->desc);
 768
 769		if (fwnode_property_read_u32(child, "linux,input-type",
 770					     &button->type))
 771			button->type = EV_KEY;
 772
 773		button->wakeup =
 774			fwnode_property_read_bool(child, "wakeup-source") ||
 775			/* legacy name */
 776			fwnode_property_read_bool(child, "gpio-key,wakeup");
 
 777
 778		fwnode_property_read_u32(child, "wakeup-event-action",
 779					 &button->wakeup_event_action);
 780
 781		button->can_disable =
 782			fwnode_property_read_bool(child, "linux,can-disable");
 
 783
 784		if (fwnode_property_read_u32(child, "debounce-interval",
 785					 &button->debounce_interval))
 786			button->debounce_interval = 5;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 787
 788		button++;
 
 
 
 789	}
 790
 791	return pdata;
 
 
 
 
 
 
 792}
 793
 794static const struct of_device_id gpio_keys_of_match[] = {
 795	{ .compatible = "gpio-keys", },
 796	{ },
 797};
 798MODULE_DEVICE_TABLE(of, gpio_keys_of_match);
 799
 800static int gpio_keys_probe(struct platform_device *pdev)
 
 
 
 801{
 802	struct device *dev = &pdev->dev;
 803	const struct gpio_keys_platform_data *pdata = dev_get_platdata(dev);
 804	struct fwnode_handle *child = NULL;
 
 
 
 
 
 
 
 805	struct gpio_keys_drvdata *ddata;
 
 
 806	struct input_dev *input;
 807	int i, error;
 808	int wakeup = 0;
 809
 810	if (!pdata) {
 811		pdata = gpio_keys_get_devtree_pdata(dev);
 812		if (IS_ERR(pdata))
 813			return PTR_ERR(pdata);
 
 814	}
 815
 816	ddata = devm_kzalloc(dev, struct_size(ddata, data, pdata->nbuttons),
 817			     GFP_KERNEL);
 818	if (!ddata) {
 
 
 819		dev_err(dev, "failed to allocate state\n");
 820		return -ENOMEM;
 821	}
 822
 823	ddata->keymap = devm_kcalloc(dev,
 824				     pdata->nbuttons, sizeof(ddata->keymap[0]),
 825				     GFP_KERNEL);
 826	if (!ddata->keymap)
 827		return -ENOMEM;
 828
 829	input = devm_input_allocate_device(dev);
 830	if (!input) {
 831		dev_err(dev, "failed to allocate input device\n");
 832		return -ENOMEM;
 833	}
 834
 835	ddata->pdata = pdata;
 836	ddata->input = input;
 
 
 
 837	mutex_init(&ddata->disable_lock);
 838
 839	platform_set_drvdata(pdev, ddata);
 840	input_set_drvdata(input, ddata);
 841
 842	input->name = pdata->name ? : pdev->name;
 843	input->phys = "gpio-keys/input0";
 844	input->dev.parent = dev;
 845	input->open = gpio_keys_open;
 846	input->close = gpio_keys_close;
 847
 848	input->id.bustype = BUS_HOST;
 849	input->id.vendor = 0x0001;
 850	input->id.product = 0x0001;
 851	input->id.version = 0x0100;
 852
 853	input->keycode = ddata->keymap;
 854	input->keycodesize = sizeof(ddata->keymap[0]);
 855	input->keycodemax = pdata->nbuttons;
 856
 857	/* Enable auto repeat feature of Linux input subsystem */
 858	if (pdata->rep)
 859		__set_bit(EV_REP, input->evbit);
 860
 861	for (i = 0; i < pdata->nbuttons; i++) {
 862		const struct gpio_keys_button *button = &pdata->buttons[i];
 
 
 863
 864		if (!dev_get_platdata(dev)) {
 865			child = device_get_next_child_node(dev, child);
 866			if (!child) {
 867				dev_err(dev,
 868					"missing child device node for entry %d\n",
 869					i);
 870				return -EINVAL;
 871			}
 872		}
 873
 874		error = gpio_keys_setup_key(pdev, input, ddata,
 875					    button, i, child);
 876		if (error) {
 877			fwnode_handle_put(child);
 878			return error;
 879		}
 880
 881		if (button->wakeup)
 882			wakeup = 1;
 
 
 883	}
 884
 885	fwnode_handle_put(child);
 
 
 
 
 
 886
 887	error = input_register_device(input);
 888	if (error) {
 889		dev_err(dev, "Unable to register input device, error: %d\n",
 890			error);
 891		return error;
 892	}
 893
 894	device_init_wakeup(dev, wakeup);
 895
 896	return 0;
 897}
 898
 899static int __maybe_unused
 900gpio_keys_button_enable_wakeup(struct gpio_button_data *bdata)
 901{
 902	int error;
 903
 904	error = enable_irq_wake(bdata->irq);
 905	if (error) {
 906		dev_err(bdata->input->dev.parent,
 907			"failed to configure IRQ %d as wakeup source: %d\n",
 908			bdata->irq, error);
 909		return error;
 910	}
 911
 912	if (bdata->wakeup_trigger_type) {
 913		error = irq_set_irq_type(bdata->irq,
 914					 bdata->wakeup_trigger_type);
 915		if (error) {
 916			dev_err(bdata->input->dev.parent,
 917				"failed to set wakeup trigger %08x for IRQ %d: %d\n",
 918				bdata->wakeup_trigger_type, bdata->irq, error);
 919			disable_irq_wake(bdata->irq);
 920			return error;
 921		}
 922	}
 923
 924	return 0;
 925}
 926
 927static void __maybe_unused
 928gpio_keys_button_disable_wakeup(struct gpio_button_data *bdata)
 929{
 930	int error;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 931
 932	/*
 933	 * The trigger type is always both edges for gpio-based keys and we do
 934	 * not support changing wakeup trigger for interrupt-based keys.
 935	 */
 936	if (bdata->wakeup_trigger_type) {
 937		error = irq_set_irq_type(bdata->irq, IRQ_TYPE_EDGE_BOTH);
 938		if (error)
 939			dev_warn(bdata->input->dev.parent,
 940				 "failed to restore interrupt trigger for IRQ %d: %d\n",
 941				 bdata->irq, error);
 942	}
 943
 944	error = disable_irq_wake(bdata->irq);
 945	if (error)
 946		dev_warn(bdata->input->dev.parent,
 947			 "failed to disable IRQ %d as wake source: %d\n",
 948			 bdata->irq, error);
 949}
 950
 951static int __maybe_unused
 952gpio_keys_enable_wakeup(struct gpio_keys_drvdata *ddata)
 953{
 954	struct gpio_button_data *bdata;
 955	int error;
 956	int i;
 957
 958	for (i = 0; i < ddata->pdata->nbuttons; i++) {
 959		bdata = &ddata->data[i];
 960		if (bdata->button->wakeup) {
 961			error = gpio_keys_button_enable_wakeup(bdata);
 962			if (error)
 963				goto err_out;
 964		}
 965		bdata->suspended = true;
 966	}
 967
 968	return 0;
 969
 970err_out:
 971	while (i--) {
 972		bdata = &ddata->data[i];
 973		if (bdata->button->wakeup)
 974			gpio_keys_button_disable_wakeup(bdata);
 975		bdata->suspended = false;
 
 976	}
 977
 978	return error;
 979}
 980
 981static void __maybe_unused
 982gpio_keys_disable_wakeup(struct gpio_keys_drvdata *ddata)
 983{
 984	struct gpio_button_data *bdata;
 985	int i;
 
 
 986
 987	for (i = 0; i < ddata->pdata->nbuttons; i++) {
 988		bdata = &ddata->data[i];
 989		bdata->suspended = false;
 990		if (irqd_is_wakeup_set(irq_get_irq_data(bdata->irq)))
 991			gpio_keys_button_disable_wakeup(bdata);
 992	}
 993}
 994
 
 995static int gpio_keys_suspend(struct device *dev)
 996{
 997	struct gpio_keys_drvdata *ddata = dev_get_drvdata(dev);
 998	struct input_dev *input = ddata->input;
 999	int error;
1000
1001	if (device_may_wakeup(dev)) {
1002		error = gpio_keys_enable_wakeup(ddata);
1003		if (error)
1004			return error;
1005	} else {
1006		mutex_lock(&input->mutex);
1007		if (input_device_enabled(input))
1008			gpio_keys_close(input);
1009		mutex_unlock(&input->mutex);
1010	}
1011
1012	return 0;
1013}
1014
1015static int gpio_keys_resume(struct device *dev)
1016{
1017	struct gpio_keys_drvdata *ddata = dev_get_drvdata(dev);
1018	struct input_dev *input = ddata->input;
1019	int error = 0;
1020
1021	if (device_may_wakeup(dev)) {
1022		gpio_keys_disable_wakeup(ddata);
1023	} else {
1024		mutex_lock(&input->mutex);
1025		if (input_device_enabled(input))
1026			error = gpio_keys_open(input);
1027		mutex_unlock(&input->mutex);
1028	}
1029
1030	if (error)
1031		return error;
 
 
 
 
 
 
 
1032
1033	gpio_keys_report_state(ddata);
1034	return 0;
1035}
 
1036
1037static DEFINE_SIMPLE_DEV_PM_OPS(gpio_keys_pm_ops, gpio_keys_suspend, gpio_keys_resume);
1038
1039static void gpio_keys_shutdown(struct platform_device *pdev)
1040{
1041	int ret;
1042
1043	ret = gpio_keys_suspend(&pdev->dev);
1044	if (ret)
1045		dev_err(&pdev->dev, "failed to shutdown\n");
1046}
1047
1048static struct platform_driver gpio_keys_device_driver = {
1049	.probe		= gpio_keys_probe,
1050	.shutdown	= gpio_keys_shutdown,
1051	.driver		= {
1052		.name	= "gpio-keys",
1053		.pm	= pm_sleep_ptr(&gpio_keys_pm_ops),
 
1054		.of_match_table = gpio_keys_of_match,
1055		.dev_groups	= gpio_keys_groups,
1056	}
1057};
1058
1059static int __init gpio_keys_init(void)
1060{
1061	return platform_driver_register(&gpio_keys_device_driver);
1062}
1063
1064static void __exit gpio_keys_exit(void)
1065{
1066	platform_driver_unregister(&gpio_keys_device_driver);
1067}
1068
1069late_initcall(gpio_keys_init);
1070module_exit(gpio_keys_exit);
1071
1072MODULE_LICENSE("GPL");
1073MODULE_AUTHOR("Phil Blundell <pb@handhelds.org>");
1074MODULE_DESCRIPTION("Keyboard driver for GPIOs");
1075MODULE_ALIAS("platform:gpio-keys");
v3.1
 
  1/*
  2 * Driver for keys on GPIO lines capable of generating interrupts.
  3 *
  4 * Copyright 2005 Phil Blundell
  5 * Copyright 2010, 2011 David Jander <david@protonic.nl>
  6 *
  7 * This program is free software; you can redistribute it and/or modify
  8 * it under the terms of the GNU General Public License version 2 as
  9 * published by the Free Software Foundation.
 10 */
 11
 12#include <linux/module.h>
 13
 
 14#include <linux/init.h>
 15#include <linux/fs.h>
 16#include <linux/interrupt.h>
 17#include <linux/irq.h>
 18#include <linux/sched.h>
 19#include <linux/pm.h>
 20#include <linux/slab.h>
 21#include <linux/sysctl.h>
 22#include <linux/proc_fs.h>
 23#include <linux/delay.h>
 24#include <linux/platform_device.h>
 25#include <linux/input.h>
 26#include <linux/gpio_keys.h>
 27#include <linux/workqueue.h>
 28#include <linux/gpio.h>
 29#include <linux/of_platform.h>
 30#include <linux/of_gpio.h>
 
 
 
 31
 32struct gpio_button_data {
 33	struct gpio_keys_button *button;
 34	struct input_dev *input;
 35	struct timer_list timer;
 36	struct work_struct work;
 37	int timer_debounce;	/* in msecs */
 
 
 
 
 
 
 
 
 
 
 
 38	bool disabled;
 
 
 
 39};
 40
 41struct gpio_keys_drvdata {
 
 42	struct input_dev *input;
 43	struct mutex disable_lock;
 44	unsigned int n_buttons;
 45	int (*enable)(struct device *dev);
 46	void (*disable)(struct device *dev);
 47	struct gpio_button_data data[0];
 48};
 49
 50/*
 51 * SYSFS interface for enabling/disabling keys and switches:
 52 *
 53 * There are 4 attributes under /sys/devices/platform/gpio-keys/
 54 *	keys [ro]              - bitmap of keys (EV_KEY) which can be
 55 *	                         disabled
 56 *	switches [ro]          - bitmap of switches (EV_SW) which can be
 57 *	                         disabled
 58 *	disabled_keys [rw]     - bitmap of keys currently disabled
 59 *	disabled_switches [rw] - bitmap of switches currently disabled
 60 *
 61 * Userland can change these values and hence disable event generation
 62 * for each key (or switch). Disabling a key means its interrupt line
 63 * is disabled.
 64 *
 65 * For example, if we have following switches set up as gpio-keys:
 66 *	SW_DOCK = 5
 67 *	SW_CAMERA_LENS_COVER = 9
 68 *	SW_KEYPAD_SLIDE = 10
 69 *	SW_FRONT_PROXIMITY = 11
 70 * This is read from switches:
 71 *	11-9,5
 72 * Next we want to disable proximity (11) and dock (5), we write:
 73 *	11,5
 74 * to file disabled_switches. Now proximity and dock IRQs are disabled.
 75 * This can be verified by reading the file disabled_switches:
 76 *	11,5
 77 * If we now want to enable proximity (11) switch we write:
 78 *	5
 79 * to disabled_switches.
 80 *
 81 * We can disable only those keys which don't allow sharing the irq.
 82 */
 83
 84/**
 85 * get_n_events_by_type() - returns maximum number of events per @type
 86 * @type: type of button (%EV_KEY, %EV_SW)
 87 *
 88 * Return value of this function can be used to allocate bitmap
 89 * large enough to hold all bits for given type.
 90 */
 91static inline int get_n_events_by_type(int type)
 92{
 93	BUG_ON(type != EV_SW && type != EV_KEY);
 94
 95	return (type == EV_KEY) ? KEY_CNT : SW_CNT;
 96}
 97
 98/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 99 * gpio_keys_disable_button() - disables given GPIO button
100 * @bdata: button data for button to be disabled
101 *
102 * Disables button pointed by @bdata. This is done by masking
103 * IRQ line. After this function is called, button won't generate
104 * input events anymore. Note that one can only disable buttons
105 * that don't share IRQs.
106 *
107 * Make sure that @bdata->disable_lock is locked when entering
108 * this function to avoid races when concurrent threads are
109 * disabling buttons at the same time.
110 */
111static void gpio_keys_disable_button(struct gpio_button_data *bdata)
112{
113	if (!bdata->disabled) {
114		/*
115		 * Disable IRQ and possible debouncing timer.
116		 */
117		disable_irq(gpio_to_irq(bdata->button->gpio));
118		if (bdata->timer_debounce)
119			del_timer_sync(&bdata->timer);
120
121		bdata->disabled = true;
122	}
123}
124
125/**
126 * gpio_keys_enable_button() - enables given GPIO button
127 * @bdata: button data for button to be disabled
128 *
129 * Enables given button pointed by @bdata.
130 *
131 * Make sure that @bdata->disable_lock is locked when entering
132 * this function to avoid races with concurrent threads trying
133 * to enable the same button at the same time.
134 */
135static void gpio_keys_enable_button(struct gpio_button_data *bdata)
136{
137	if (bdata->disabled) {
138		enable_irq(gpio_to_irq(bdata->button->gpio));
139		bdata->disabled = false;
140	}
141}
142
143/**
144 * gpio_keys_attr_show_helper() - fill in stringified bitmap of buttons
145 * @ddata: pointer to drvdata
146 * @buf: buffer where stringified bitmap is written
147 * @type: button type (%EV_KEY, %EV_SW)
148 * @only_disabled: does caller want only those buttons that are
149 *                 currently disabled or all buttons that can be
150 *                 disabled
151 *
152 * This function writes buttons that can be disabled to @buf. If
153 * @only_disabled is true, then @buf contains only those buttons
154 * that are currently disabled. Returns 0 on success or negative
155 * errno on failure.
156 */
157static ssize_t gpio_keys_attr_show_helper(struct gpio_keys_drvdata *ddata,
158					  char *buf, unsigned int type,
159					  bool only_disabled)
160{
161	int n_events = get_n_events_by_type(type);
162	unsigned long *bits;
163	ssize_t ret;
164	int i;
165
166	bits = kcalloc(BITS_TO_LONGS(n_events), sizeof(*bits), GFP_KERNEL);
167	if (!bits)
168		return -ENOMEM;
169
170	for (i = 0; i < ddata->n_buttons; i++) {
171		struct gpio_button_data *bdata = &ddata->data[i];
172
173		if (bdata->button->type != type)
174			continue;
175
176		if (only_disabled && !bdata->disabled)
177			continue;
178
179		__set_bit(bdata->button->code, bits);
180	}
181
182	ret = bitmap_scnlistprintf(buf, PAGE_SIZE - 2, bits, n_events);
183	buf[ret++] = '\n';
184	buf[ret] = '\0';
185
186	kfree(bits);
187
188	return ret;
189}
190
191/**
192 * gpio_keys_attr_store_helper() - enable/disable buttons based on given bitmap
193 * @ddata: pointer to drvdata
194 * @buf: buffer from userspace that contains stringified bitmap
195 * @type: button type (%EV_KEY, %EV_SW)
196 *
197 * This function parses stringified bitmap from @buf and disables/enables
198 * GPIO buttons accordinly. Returns 0 on success and negative error
199 * on failure.
200 */
201static ssize_t gpio_keys_attr_store_helper(struct gpio_keys_drvdata *ddata,
202					   const char *buf, unsigned int type)
203{
204	int n_events = get_n_events_by_type(type);
 
205	unsigned long *bits;
206	ssize_t error;
207	int i;
208
209	bits = kcalloc(BITS_TO_LONGS(n_events), sizeof(*bits), GFP_KERNEL);
210	if (!bits)
211		return -ENOMEM;
212
213	error = bitmap_parselist(buf, bits, n_events);
214	if (error)
215		goto out;
216
217	/* First validate */
218	for (i = 0; i < ddata->n_buttons; i++) {
 
 
 
 
 
219		struct gpio_button_data *bdata = &ddata->data[i];
220
221		if (bdata->button->type != type)
222			continue;
223
224		if (test_bit(bdata->button->code, bits) &&
225		    !bdata->button->can_disable) {
226			error = -EINVAL;
227			goto out;
228		}
229	}
230
231	mutex_lock(&ddata->disable_lock);
232
233	for (i = 0; i < ddata->n_buttons; i++) {
234		struct gpio_button_data *bdata = &ddata->data[i];
235
236		if (bdata->button->type != type)
237			continue;
238
239		if (test_bit(bdata->button->code, bits))
240			gpio_keys_disable_button(bdata);
241		else
242			gpio_keys_enable_button(bdata);
243	}
244
245	mutex_unlock(&ddata->disable_lock);
246
247out:
248	kfree(bits);
249	return error;
250}
251
252#define ATTR_SHOW_FN(name, type, only_disabled)				\
253static ssize_t gpio_keys_show_##name(struct device *dev,		\
254				     struct device_attribute *attr,	\
255				     char *buf)				\
256{									\
257	struct platform_device *pdev = to_platform_device(dev);		\
258	struct gpio_keys_drvdata *ddata = platform_get_drvdata(pdev);	\
259									\
260	return gpio_keys_attr_show_helper(ddata, buf,			\
261					  type, only_disabled);		\
262}
263
264ATTR_SHOW_FN(keys, EV_KEY, false);
265ATTR_SHOW_FN(switches, EV_SW, false);
266ATTR_SHOW_FN(disabled_keys, EV_KEY, true);
267ATTR_SHOW_FN(disabled_switches, EV_SW, true);
268
269/*
270 * ATTRIBUTES:
271 *
272 * /sys/devices/platform/gpio-keys/keys [ro]
273 * /sys/devices/platform/gpio-keys/switches [ro]
274 */
275static DEVICE_ATTR(keys, S_IRUGO, gpio_keys_show_keys, NULL);
276static DEVICE_ATTR(switches, S_IRUGO, gpio_keys_show_switches, NULL);
277
278#define ATTR_STORE_FN(name, type)					\
279static ssize_t gpio_keys_store_##name(struct device *dev,		\
280				      struct device_attribute *attr,	\
281				      const char *buf,			\
282				      size_t count)			\
283{									\
284	struct platform_device *pdev = to_platform_device(dev);		\
285	struct gpio_keys_drvdata *ddata = platform_get_drvdata(pdev);	\
286	ssize_t error;							\
287									\
288	error = gpio_keys_attr_store_helper(ddata, buf, type);		\
289	if (error)							\
290		return error;						\
291									\
292	return count;							\
293}
294
295ATTR_STORE_FN(disabled_keys, EV_KEY);
296ATTR_STORE_FN(disabled_switches, EV_SW);
297
298/*
299 * ATTRIBUTES:
300 *
301 * /sys/devices/platform/gpio-keys/disabled_keys [rw]
302 * /sys/devices/platform/gpio-keys/disables_switches [rw]
303 */
304static DEVICE_ATTR(disabled_keys, S_IWUSR | S_IRUGO,
305		   gpio_keys_show_disabled_keys,
306		   gpio_keys_store_disabled_keys);
307static DEVICE_ATTR(disabled_switches, S_IWUSR | S_IRUGO,
308		   gpio_keys_show_disabled_switches,
309		   gpio_keys_store_disabled_switches);
310
311static struct attribute *gpio_keys_attrs[] = {
312	&dev_attr_keys.attr,
313	&dev_attr_switches.attr,
314	&dev_attr_disabled_keys.attr,
315	&dev_attr_disabled_switches.attr,
316	NULL,
317};
 
318
319static struct attribute_group gpio_keys_attr_group = {
320	.attrs = gpio_keys_attrs,
321};
322
323static void gpio_keys_report_event(struct gpio_button_data *bdata)
324{
325	struct gpio_keys_button *button = bdata->button;
326	struct input_dev *input = bdata->input;
327	unsigned int type = button->type ?: EV_KEY;
328	int state = (gpio_get_value_cansleep(button->gpio) ? 1 : 0) ^ button->active_low;
 
 
 
 
 
 
 
 
 
329
330	if (type == EV_ABS) {
331		if (state)
332			input_event(input, type, button->code, button->value);
333	} else {
334		input_event(input, type, button->code, !!state);
335	}
336	input_sync(input);
337}
338
339static void gpio_keys_work_func(struct work_struct *work)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
340{
341	struct gpio_button_data *bdata =
342		container_of(work, struct gpio_button_data, work);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
343
344	gpio_keys_report_event(bdata);
345}
346
347static void gpio_keys_timer(unsigned long _data)
348{
349	struct gpio_button_data *data = (struct gpio_button_data *)_data;
 
 
 
350
351	schedule_work(&data->work);
 
 
 
 
 
 
352}
353
354static irqreturn_t gpio_keys_isr(int irq, void *dev_id)
355{
356	struct gpio_button_data *bdata = dev_id;
357	struct gpio_keys_button *button = bdata->button;
 
 
 
358
359	BUG_ON(irq != gpio_to_irq(button->gpio));
360
361	if (bdata->timer_debounce)
362		mod_timer(&bdata->timer,
363			jiffies + msecs_to_jiffies(bdata->timer_debounce));
364	else
365		schedule_work(&bdata->work);
 
 
 
 
 
 
 
 
 
 
366
 
 
 
 
 
 
367	return IRQ_HANDLED;
368}
369
370static int __devinit gpio_keys_setup_key(struct platform_device *pdev,
371					 struct gpio_button_data *bdata,
372					 struct gpio_keys_button *button)
 
 
 
373{
374	const char *desc = button->desc ? button->desc : "gpio_keys";
375	struct device *dev = &pdev->dev;
 
 
376	unsigned long irqflags;
377	int irq, error;
 
378
379	setup_timer(&bdata->timer, gpio_keys_timer, (unsigned long)bdata);
380	INIT_WORK(&bdata->work, gpio_keys_work_func);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
381
382	error = gpio_request(button->gpio, desc);
383	if (error < 0) {
384		dev_err(dev, "failed to request GPIO %d, error %d\n",
385			button->gpio, error);
386		goto fail2;
387	}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
388
389	error = gpio_direction_input(button->gpio);
390	if (error < 0) {
391		dev_err(dev, "failed to configure"
392			" direction for GPIO %d, error %d\n",
393			button->gpio, error);
394		goto fail3;
395	}
396
397	if (button->debounce_interval) {
398		error = gpio_set_debounce(button->gpio,
399					  button->debounce_interval * 1000);
400		/* use timer if gpiolib doesn't provide debounce */
401		if (error < 0)
402			bdata->timer_debounce = button->debounce_interval;
403	}
404
405	irq = gpio_to_irq(button->gpio);
406	if (irq < 0) {
407		error = irq;
408		dev_err(dev, "Unable to get irq number for GPIO %d, error %d\n",
409			button->gpio, error);
410		goto fail3;
 
 
 
411	}
412
413	irqflags = IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING;
414	/*
415	 * If platform has specified that the button can be disabled,
416	 * we don't want it to share the interrupt line.
417	 */
418	if (!button->can_disable)
419		irqflags |= IRQF_SHARED;
420
421	error = request_threaded_irq(irq, NULL, gpio_keys_isr, irqflags, desc, bdata);
 
422	if (error < 0) {
423		dev_err(dev, "Unable to claim irq %d; error %d\n",
424			irq, error);
425		goto fail3;
426	}
427
428	return 0;
 
 
 
 
 
 
429
430fail3:
431	gpio_free(button->gpio);
432fail2:
433	return error;
 
 
434}
435
436static int gpio_keys_open(struct input_dev *input)
437{
438	struct gpio_keys_drvdata *ddata = input_get_drvdata(input);
 
 
 
 
 
 
 
 
439
440	return ddata->enable ? ddata->enable(input->dev.parent) : 0;
 
 
 
441}
442
443static void gpio_keys_close(struct input_dev *input)
444{
445	struct gpio_keys_drvdata *ddata = input_get_drvdata(input);
 
446
447	if (ddata->disable)
448		ddata->disable(input->dev.parent);
449}
450
451/*
452 * Handlers for alternative sources of platform_data
453 */
454#ifdef CONFIG_OF
455/*
456 * Translate OpenFirmware node properties into platform_data
457 */
458static int gpio_keys_get_devtree_pdata(struct device *dev,
459			    struct gpio_keys_platform_data *pdata)
460{
461	struct device_node *node, *pp;
462	int i;
463	struct gpio_keys_button *buttons;
464	const u32 *reg;
465	int len;
466
467	node = dev->of_node;
468	if (node == NULL)
469		return -ENODEV;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
470
471	memset(pdata, 0, sizeof *pdata);
472
473	pdata->rep = !!of_get_property(node, "autorepeat", &len);
 
 
474
475	/* First count the subnodes */
476	pdata->nbuttons = 0;
477	pp = NULL;
478	while ((pp = of_get_next_child(node, pp)))
479		pdata->nbuttons++;
480
481	if (pdata->nbuttons == 0)
482		return -ENODEV;
483
484	buttons = kzalloc(pdata->nbuttons * (sizeof *buttons), GFP_KERNEL);
485	if (!buttons)
486		return -ENOMEM;
487
488	pp = NULL;
489	i = 0;
490	while ((pp = of_get_next_child(node, pp))) {
491		enum of_gpio_flags flags;
492
493		if (!of_find_property(pp, "gpios", NULL)) {
494			pdata->nbuttons--;
495			dev_warn(dev, "Found button without gpios\n");
496			continue;
497		}
498		buttons[i].gpio = of_get_gpio_flags(pp, 0, &flags);
499		buttons[i].active_low = flags & OF_GPIO_ACTIVE_LOW;
500
501		reg = of_get_property(pp, "linux,code", &len);
502		if (!reg) {
503			dev_err(dev, "Button without keycode: 0x%x\n", buttons[i].gpio);
504			goto out_fail;
505		}
506		buttons[i].code = be32_to_cpup(reg);
507
508		buttons[i].desc = of_get_property(pp, "label", &len);
509
510		reg = of_get_property(pp, "linux,input-type", &len);
511		buttons[i].type = reg ? be32_to_cpup(reg) : EV_KEY;
512
513		buttons[i].wakeup = !!of_get_property(pp, "gpio-key,wakeup", NULL);
514
515		reg = of_get_property(pp, "debounce-interval", &len);
516		buttons[i].debounce_interval = reg ? be32_to_cpup(reg) : 5;
517
518		i++;
519	}
520
521	pdata->buttons = buttons;
522
523	return 0;
524
525out_fail:
526	kfree(buttons);
527	return -ENODEV;
528}
529
530static struct of_device_id gpio_keys_of_match[] = {
531	{ .compatible = "gpio-keys", },
532	{ },
533};
534MODULE_DEVICE_TABLE(of, gpio_keys_of_match);
535
536#else
537
538static int gpio_keys_get_devtree_pdata(struct device *dev,
539			    struct gpio_keys_platform_data *altp)
540{
541	return -ENODEV;
542}
543
544#define gpio_keys_of_match NULL
545
546#endif
547
548static int __devinit gpio_keys_probe(struct platform_device *pdev)
549{
550	struct gpio_keys_platform_data *pdata = pdev->dev.platform_data;
551	struct gpio_keys_drvdata *ddata;
552	struct device *dev = &pdev->dev;
553	struct gpio_keys_platform_data alt_pdata;
554	struct input_dev *input;
555	int i, error;
556	int wakeup = 0;
557
558	if (!pdata) {
559		error = gpio_keys_get_devtree_pdata(dev, &alt_pdata);
560		if (error)
561			return error;
562		pdata = &alt_pdata;
563	}
564
565	ddata = kzalloc(sizeof(struct gpio_keys_drvdata) +
566			pdata->nbuttons * sizeof(struct gpio_button_data),
567			GFP_KERNEL);
568	input = input_allocate_device();
569	if (!ddata || !input) {
570		dev_err(dev, "failed to allocate state\n");
571		error = -ENOMEM;
572		goto fail1;
 
 
 
 
 
 
 
 
 
 
 
573	}
574
 
575	ddata->input = input;
576	ddata->n_buttons = pdata->nbuttons;
577	ddata->enable = pdata->enable;
578	ddata->disable = pdata->disable;
579	mutex_init(&ddata->disable_lock);
580
581	platform_set_drvdata(pdev, ddata);
582	input_set_drvdata(input, ddata);
583
584	input->name = pdata->name ? : pdev->name;
585	input->phys = "gpio-keys/input0";
586	input->dev.parent = &pdev->dev;
587	input->open = gpio_keys_open;
588	input->close = gpio_keys_close;
589
590	input->id.bustype = BUS_HOST;
591	input->id.vendor = 0x0001;
592	input->id.product = 0x0001;
593	input->id.version = 0x0100;
594
 
 
 
 
595	/* Enable auto repeat feature of Linux input subsystem */
596	if (pdata->rep)
597		__set_bit(EV_REP, input->evbit);
598
599	for (i = 0; i < pdata->nbuttons; i++) {
600		struct gpio_keys_button *button = &pdata->buttons[i];
601		struct gpio_button_data *bdata = &ddata->data[i];
602		unsigned int type = button->type ?: EV_KEY;
603
604		bdata->input = input;
605		bdata->button = button;
 
 
 
 
 
 
 
606
607		error = gpio_keys_setup_key(pdev, bdata, button);
608		if (error)
609			goto fail2;
 
 
 
610
611		if (button->wakeup)
612			wakeup = 1;
613
614		input_set_capability(input, type, button->code);
615	}
616
617	error = sysfs_create_group(&pdev->dev.kobj, &gpio_keys_attr_group);
618	if (error) {
619		dev_err(dev, "Unable to export keys/switches, error: %d\n",
620			error);
621		goto fail2;
622	}
623
624	error = input_register_device(input);
625	if (error) {
626		dev_err(dev, "Unable to register input device, error: %d\n",
627			error);
628		goto fail3;
629	}
630
631	/* get current state of buttons */
632	for (i = 0; i < pdata->nbuttons; i++)
633		gpio_keys_report_event(&ddata->data[i]);
634	input_sync(input);
 
 
 
 
 
 
 
 
 
 
 
 
 
635
636	device_init_wakeup(&pdev->dev, wakeup);
 
 
 
 
 
 
 
 
 
 
637
638	return 0;
 
639
640 fail3:
641	sysfs_remove_group(&pdev->dev.kobj, &gpio_keys_attr_group);
642 fail2:
643	while (--i >= 0) {
644		free_irq(gpio_to_irq(pdata->buttons[i].gpio), &ddata->data[i]);
645		if (ddata->data[i].timer_debounce)
646			del_timer_sync(&ddata->data[i].timer);
647		cancel_work_sync(&ddata->data[i].work);
648		gpio_free(pdata->buttons[i].gpio);
649	}
650
651	platform_set_drvdata(pdev, NULL);
652 fail1:
653	input_free_device(input);
654	kfree(ddata);
655	/* If we have no platform_data, we allocated buttons dynamically. */
656	if (!pdev->dev.platform_data)
657		kfree(pdata->buttons);
658
659	return error;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
660}
661
662static int __devexit gpio_keys_remove(struct platform_device *pdev)
 
663{
664	struct gpio_keys_drvdata *ddata = platform_get_drvdata(pdev);
665	struct input_dev *input = ddata->input;
666	int i;
667
668	sysfs_remove_group(&pdev->dev.kobj, &gpio_keys_attr_group);
 
 
 
 
 
 
 
 
669
670	device_init_wakeup(&pdev->dev, 0);
671
672	for (i = 0; i < ddata->n_buttons; i++) {
673		int irq = gpio_to_irq(ddata->data[i].button->gpio);
674		free_irq(irq, &ddata->data[i]);
675		if (ddata->data[i].timer_debounce)
676			del_timer_sync(&ddata->data[i].timer);
677		cancel_work_sync(&ddata->data[i].work);
678		gpio_free(ddata->data[i].button->gpio);
679	}
680
681	input_unregister_device(input);
 
682
683	/*
684	 * If we had no platform_data, we allocated buttons dynamically, and
685	 * must free them here. ddata->data[0].button is the pointer to the
686	 * beginning of the allocated array.
687	 */
688	if (!pdev->dev.platform_data)
689		kfree(ddata->data[0].button);
690
691	kfree(ddata);
692
693	return 0;
 
 
 
694}
695
696#ifdef CONFIG_PM_SLEEP
697static int gpio_keys_suspend(struct device *dev)
698{
699	struct gpio_keys_drvdata *ddata = dev_get_drvdata(dev);
700	int i;
 
701
702	if (device_may_wakeup(dev)) {
703		for (i = 0; i < ddata->n_buttons; i++) {
704			struct gpio_keys_button *button = ddata->data[i].button;
705			if (button->wakeup) {
706				int irq = gpio_to_irq(button->gpio);
707				enable_irq_wake(irq);
708			}
709		}
 
710	}
711
712	return 0;
713}
714
715static int gpio_keys_resume(struct device *dev)
716{
717	struct gpio_keys_drvdata *ddata = dev_get_drvdata(dev);
718	int i;
 
719
720	for (i = 0; i < ddata->n_buttons; i++) {
 
 
 
 
 
 
 
721
722		struct gpio_keys_button *button = ddata->data[i].button;
723		if (button->wakeup && device_may_wakeup(dev)) {
724			int irq = gpio_to_irq(button->gpio);
725			disable_irq_wake(irq);
726		}
727
728		gpio_keys_report_event(&ddata->data[i]);
729	}
730	input_sync(ddata->input);
731
 
732	return 0;
733}
734#endif
735
736static SIMPLE_DEV_PM_OPS(gpio_keys_pm_ops, gpio_keys_suspend, gpio_keys_resume);
 
 
 
 
 
 
 
 
 
737
738static struct platform_driver gpio_keys_device_driver = {
739	.probe		= gpio_keys_probe,
740	.remove		= __devexit_p(gpio_keys_remove),
741	.driver		= {
742		.name	= "gpio-keys",
743		.owner	= THIS_MODULE,
744		.pm	= &gpio_keys_pm_ops,
745		.of_match_table = gpio_keys_of_match,
 
746	}
747};
748
749static int __init gpio_keys_init(void)
750{
751	return platform_driver_register(&gpio_keys_device_driver);
752}
753
754static void __exit gpio_keys_exit(void)
755{
756	platform_driver_unregister(&gpio_keys_device_driver);
757}
758
759late_initcall(gpio_keys_init);
760module_exit(gpio_keys_exit);
761
762MODULE_LICENSE("GPL");
763MODULE_AUTHOR("Phil Blundell <pb@handhelds.org>");
764MODULE_DESCRIPTION("Keyboard driver for GPIOs");
765MODULE_ALIAS("platform:gpio-keys");