diff mbox

[1/1] input,serio: support for GRLIB APBPS2 PS/2 Keyboard/Mouse

Message ID 1361371293-14059-1-git-send-email-daniel@gaisler.com (mailing list archive)
State New, archived
Headers show

Commit Message

Daniel Hellstrom Feb. 20, 2013, 2:41 p.m. UTC
APBPS2 is a PS/2 core part of GRLIB found in SPARC32/LEON
products.

Signed-off-by: Daniel Hellstrom <daniel@gaisler.com>
---
 .../bindings/input/ps2keyb-mouse-apbps2.txt        |   20 ++
 drivers/input/serio/Kconfig                        |   10 +
 drivers/input/serio/Makefile                       |    1 +
 drivers/input/serio/apbps2.c                       |  266 ++++++++++++++++++++
 4 files changed, 297 insertions(+), 0 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt
 create mode 100644 drivers/input/serio/apbps2.c

Comments

Dmitry Torokhov Feb. 20, 2013, 6:43 p.m. UTC | #1
Hi Daniel,

On Wed, Feb 20, 2013 at 03:41:33PM +0100, Daniel Hellstrom wrote:
> APBPS2 is a PS/2 core part of GRLIB found in SPARC32/LEON
> products.
> 
> Signed-off-by: Daniel Hellstrom <daniel@gaisler.com>
> ---
>  .../bindings/input/ps2keyb-mouse-apbps2.txt        |   20 ++
>  drivers/input/serio/Kconfig                        |   10 +
>  drivers/input/serio/Makefile                       |    1 +
>  drivers/input/serio/apbps2.c                       |  266 ++++++++++++++++++++
>  4 files changed, 297 insertions(+), 0 deletions(-)
>  create mode 100644 Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt
>  create mode 100644 drivers/input/serio/apbps2.c
> 
> diff --git a/Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt b/Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt
> new file mode 100644
> index 0000000..1553d28
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt
> @@ -0,0 +1,20 @@
> +Aeroflex Gaisler APBPS2 PS/2 Core, supporting Keyboard or Mouse.
> +
> +The APBPS2 PS/2 core is available in the GRLIB VHDL IP core library.
> +
> +Note: In the ordinary environment for the APBPS2 core, a LEON SPARC system,
> +these properties are built from information in the AMBA plug&play and from
> +bootloader settings.
> +
> +Required properties:
> +
> +- name : Should be "GAISLER_APBPS2" or "01_060"
> +- reg : Address and length of the register set for the device
> +- interrupts : Interrupt numbers for this device
> +
> +Optional properties:
> +- keyboard : if present it indicates that a keyboard is connected, if not
> +             present the driver will assume that a mouse is connected instead
> +
> +For further information look in the documentation for the GLIB IP core library:
> +http://www.gaisler.com/products/grlib/grip.pdf
> diff --git a/drivers/input/serio/Kconfig b/drivers/input/serio/Kconfig
> index 4a4e182..d0304c3 100644
> --- a/drivers/input/serio/Kconfig
> +++ b/drivers/input/serio/Kconfig
> @@ -236,6 +236,7 @@ config SERIO_PS2MULT
>  
>  config SERIO_ARC_PS2
>  	tristate "ARC PS/2 support"
> +	depends on OF

This looks like an unrelated change.

>  	help
>  	  Say Y here if you have an ARC FPGA platform with a PS/2
>  	  controller in it.
> @@ -243,4 +244,13 @@ config SERIO_ARC_PS2
>  	  To compile this driver as a module, choose M here; the module
>  	  will be called arc_ps2.
>  
> +config SERIO_APBPS2
> +        tristate "GRLIB APBPS2 PS/2 keyboard/mouse controller"
> +        help
> +          Say Y here if you want support for GRLIB APBPS2 peripherals used
> +          to connect to PS/2 keyboard and/or mouse.
> +
> +          To compile this driver as a module, choose M here: the module will
> +          be called apbps2.
> +
>  endif
> diff --git a/drivers/input/serio/Makefile b/drivers/input/serio/Makefile
> index 4b0c8f8..8edb36c 100644
> --- a/drivers/input/serio/Makefile
> +++ b/drivers/input/serio/Makefile
> @@ -26,3 +26,4 @@ obj-$(CONFIG_SERIO_AMS_DELTA)	+= ams_delta_serio.o
>  obj-$(CONFIG_SERIO_XILINX_XPS_PS2)	+= xilinx_ps2.o
>  obj-$(CONFIG_SERIO_ALTERA_PS2)	+= altera_ps2.o
>  obj-$(CONFIG_SERIO_ARC_PS2)	+= arc_ps2.o
> +obj-$(CONFIG_SERIO_APBPS2)	+= apbps2.o
> diff --git a/drivers/input/serio/apbps2.c b/drivers/input/serio/apbps2.c
> new file mode 100644
> index 0000000..78b28e1
> --- /dev/null
> +++ b/drivers/input/serio/apbps2.c
> @@ -0,0 +1,266 @@
> +/*
> + *  linux/drivers/input/serio/apbps2.c
> + *
> + *  Copyright (C) 2013 Aeroflex Gaisler
> + *
> + * This driver supports the APBPS2 PS/2 core available in the GRLIB
> + * VHDL IP core library.
> + *
> + * Full documentation of the APBPS2 core can be found here:
> + * http://www.gaisler.com/products/grlib/grip.pdf
> + *
> + * See "Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt" for
> + * information on open firmware properties.
> + *
> + * 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.
> + *
> + * Contributors: Daniel Hellstrom <daniel@gaisler.com>
> + */
> +#include <linux/platform_device.h>
> +#include <linux/of_device.h>
> +#include <linux/module.h>
> +#include <linux/init.h>
> +#include <linux/serio.h>
> +#include <linux/errno.h>
> +#include <linux/interrupt.h>
> +#include <linux/device.h>
> +#include <linux/delay.h>
> +#include <linux/slab.h>
> +#include <linux/err.h>
> +#include <linux/string.h>
> +#include <linux/kernel.h>
> +#include <linux/io.h>
> +
> +struct apbps2_regs {
> +	u32 data;	/* 0x00 */
> +	u32 status;	/* 0x04 */
> +	u32 ctrl;	/* 0x08 */
> +	u32 reload;	/* 0x0c */
> +};
> +
> +#define APBPS2_STATUS_DR	(1<<0)
> +#define APBPS2_STATUS_PE	(1<<1)
> +#define APBPS2_STATUS_FE	(1<<2)
> +#define APBPS2_STATUS_KI	(1<<3)
> +#define APBPS2_STATUS_RF	(1<<4)
> +#define APBPS2_STATUS_TF	(1<<5)
> +#define APBPS2_STATUS_TCNT	(0x1f<<22)
> +#define APBPS2_STATUS_RCNT	(0x1f<<27)
> +
> +#define APBPS2_CTRL_RE		(1<<0)
> +#define APBPS2_CTRL_TE		(1<<1)
> +#define APBPS2_CTRL_RI		(1<<2)
> +#define APBPS2_CTRL_TI		(1<<3)
> +
> +/* Register read/write functions */
> +#define APBPS2_READ(reg) apbps2_read_reg(reg)
> +#define APBPS2_WRITE(reg, data) apbps2_write_reg(reg, data)

Why?

> +
> +struct apbps2_priv {
> +	struct serio		io;
> +	struct apbps2_regs	*regs;
> +	int			irq;
> +};
> +
> +static inline unsigned long apbps2_read_reg(void __iomem *reg)
> +{
> +	return ioread32be(reg);
> +}
> +
> +static inline void apbps2_write_reg(void __iomem *reg, unsigned long data)
> +{
> +	iowrite32be(data, reg);

Do we really need these wrappers?

> +}
> +
> +static irqreturn_t apbps2_isr(int irq, void *dev_id)
> +{
> +	struct apbps2_priv *priv = dev_id;
> +	unsigned long status, data, rxflags;
> +	irqreturn_t ret = IRQ_NONE;
> +
> +	while ((status = APBPS2_READ(&priv->regs->status)) & APBPS2_STATUS_DR) {
> +		data = APBPS2_READ(&priv->regs->data);
> +		rxflags = (status & APBPS2_STATUS_PE) ? SERIO_PARITY : 0;
> +		rxflags |= (status & APBPS2_STATUS_PE) ? SERIO_FRAME : 0;
> +
> +		/* clear error bits? */
> +		if (rxflags)
> +			APBPS2_WRITE(&priv->regs->status, status);
> +
> +		serio_interrupt(&priv->io, data, rxflags);
> +
> +		ret = IRQ_HANDLED;
> +	}
> +
> +	return ret;
> +}
> +
> +static int apbps2_write(struct serio *io, unsigned char val)
> +{
> +	struct apbps2_priv *priv = io->port_data;
> +	unsigned int tleft = 10000; /* timeout in 100ms */
> +
> +	/* delay until PS/2 controller has room for more chars */
> +	while ((APBPS2_READ(&priv->regs->status) & APBPS2_STATUS_TF) && tleft--)
> +		udelay(10);
> +
> +	if ((APBPS2_READ(&priv->regs->status) & APBPS2_STATUS_TF) == 0) {
> +		APBPS2_WRITE(&priv->regs->data, val);
> +
> +		APBPS2_WRITE(&priv->regs->ctrl, APBPS2_CTRL_RE |
> +						APBPS2_CTRL_RI |
> +						APBPS2_CTRL_TE);
> +		return 0;
> +	}
> +
> +	return SERIO_TIMEOUT;

No, it should return negative error code. -EIO for example.

> +}
> +
> +static int apbps2_open(struct serio *io)
> +{
> +	struct apbps2_priv *priv = io->port_data;
> +	int err, limit;
> +	unsigned long tmp;
> +
> +	err = devm_request_irq(&io->dev, priv->irq, apbps2_isr, IRQF_SHARED,
> +								"apbps2", priv);
> +	if (err) {
> +		dev_err(&io->dev, "request IRQ%d failed\n", priv->irq);
> +		return err;
> +	}
> +
> +	/* clear error flags */
> +	APBPS2_WRITE(&priv->regs->status, 0);
> +
> +	/* Clear old data if available (unlikely) */
> +	limit = 1024;
> +	while ((APBPS2_READ(&priv->regs->status) & APBPS2_STATUS_DR) && --limit)
> +		tmp = APBPS2_READ(&priv->regs->data);
> +
> +	/* Enable reciever and it's interrupt */
> +	APBPS2_WRITE(&priv->regs->ctrl, APBPS2_CTRL_RE | APBPS2_CTRL_RI);
> +
> +	return 0;
> +}
> +
> +static void apbps2_close(struct serio *io)
> +{
> +	struct apbps2_priv *priv = io->port_data;
> +
> +	/* stop interrupts at PS/2 HW level */
> +	APBPS2_WRITE(&priv->regs->ctrl, 0);
> +
> +	/* unregister PS/2 interrupt handler */
> +	devm_free_irq(&io->dev, priv->irq, priv);

What is the benefit (except for wasting memory) of using
devm_request_irq()/devm_free_irq() in this fashion?

By the way, I would prefer if request IRQ was done in probe and freeing
in remove. I know that many existing serio drivers do it in open/close,
but this is not correct. We shoudl make sure all resources are available
beforehand.

> +}
> +
> +/* Initialize one APBPS2 PS/2 core */
> +static int apbps2_of_probe(struct platform_device *ofdev)
> +{
> +	struct apbps2_priv *priv;
> +	int len;
> +	u32 *addr, *freq_hz;
> +	char *typestr;
> +	struct resource *res;
> +
> +	priv = devm_kzalloc(&ofdev->dev, sizeof(*priv), GFP_KERNEL);
> +	if (!priv) {
> +		dev_err(&ofdev->dev, "memory allocation failed\n");
> +		return -ENOMEM;
> +	}
> +	platform_set_drvdata(ofdev, priv);
> +
> +	/* Find Device Address */
> +	res = platform_get_resource(ofdev, IORESOURCE_MEM, 0);
> +	priv->regs = devm_request_and_ioremap(&ofdev->dev, res);
> +	if (!priv->regs) {
> +		dev_err(&ofdev->dev, "io-regs mapping failed\n");
> +		return -EADDRNOTAVAIL;
> +	}
> +
> +	/* IRQ */
> +	priv->irq = ofdev->archdata.irqs[0];
> +
> +	/* Get core frequency */
> +	freq_hz = (u32 *)of_get_property(ofdev->dev.of_node, "freq", &len);

There is of_property_read_u32 for this.

> +	if (!freq_hz) {
> +		dev_err(&ofdev->dev, "unable to get core frequency\n");
> +		return -EINVAL;
> +	}
> +
> +	priv->io.open	= apbps2_open;
> +	priv->io.close	= apbps2_close;
> +	priv->io.port_data = priv;
> +
> +	/* Get keyboard property. If no such property we know it is a mouse */
> +	addr = (u32 *)of_get_property(ofdev->dev.of_node, "keyboard", &len);

And for this.

> +	if (!addr) {
> +		priv->io.id.type = SERIO_PS_PSTHRU;

This is really for pass-through PS/2 ports. Why are even doing this?
Can't you switch the devices over? atkbd and psmouse drivers will query
the attached devices and figure out to which they should bind. Both
ports should declare themselves as SERIO_8042.

> +		priv->io.write = apbps2_write;
> +		strlcpy(priv->io.name, "APBPS2 PS/2 Mouse",
> +						sizeof(priv->io.name));
> +		strlcpy(priv->io.phys, "APBPS2 PS/2 Mouse",
> +						sizeof(priv->io.phys));
> +		typestr = "Mouse";
> +	} else {
> +		priv->io.id.type = SERIO_8042;
> +		priv->io.write = apbps2_write;
> +		strlcpy(priv->io.name, "APBPS2 PS/2 Keyboard",
> +						sizeof(priv->io.name));
> +		strlcpy(priv->io.phys, "APBPS2 PS/2 Keyboard",
> +						sizeof(priv->io.phys));
> +		typestr = "Keyboard";
> +	}
> +
> +	dev_info(&ofdev->dev, "%s, irq = %d, base = 0x%p\n",
> +			typestr, priv->irq, priv->regs);

dev_dbg() if you need this.

> +
> +	/* Set reload register to system freq in kHz/10 */
> +	APBPS2_WRITE(&priv->regs->reload, *freq_hz / 10000);
> +
> +	serio_register_port(&priv->io);
> +
> +	return 0;
> +}
> +
> +static int apbps2_of_remove(struct platform_device *of_dev)
> +{
> +	struct apbps2_priv *priv = platform_get_drvdata(of_dev);
> +
> +	of_iounmap(&of_dev->resource[0], priv->regs,
> +					resource_size(&of_dev->resource[0]));

I am pretty sure it messes up allocation with
devm_request_and_ioremap().

> +	kfree(priv);

And this certainly messes up devm_kzalloc(). And where do you unregister
the ports you created in probe? I am willing to bet module unload was
never tested.

> +
> +	return 0;
> +}
> +
> +static struct of_device_id apbps2_of_match[] = {
> +	{
> +	 .name = "GAISLER_APBPS2",
> +	 },

This is weird formatting. Also matching is uually done on compatible
strings.

> +	{
> +	 .name = "01_060",
> +	 },
> +	{},
> +};
> +
> +MODULE_DEVICE_TABLE(of, apbps2_of_match);
> +
> +static struct platform_driver apbps2_of_driver = {
> +	.driver = {
> +		.name = "grlib-apbps2",
> +		.owner = THIS_MODULE,
> +		.of_match_table = apbps2_of_match,
> +	},
> +	.probe = apbps2_of_probe,
> +	.remove = apbps2_of_remove,
> +};
> +
> +module_platform_driver(apbps2_of_driver);
> +
> +MODULE_AUTHOR("Aeroflex Gaisler AB.");
> +MODULE_DESCRIPTION("GRLIB APBPS2 PS/2 serial I/O");
> +MODULE_LICENSE("GPL");

Thanks.
Daniel Hellstrom Feb. 21, 2013, 9:49 a.m. UTC | #2
On 02/20/2013 07:43 PM, Dmitry Torokhov wrote:
> Hi Daniel,
>
> On Wed, Feb 20, 2013 at 03:41:33PM +0100, Daniel Hellstrom wrote:
>> APBPS2 is a PS/2 core part of GRLIB found in SPARC32/LEON
>> products.
>>
>> Signed-off-by: Daniel Hellstrom <daniel@gaisler.com>
>> ---
>>   .../bindings/input/ps2keyb-mouse-apbps2.txt        |   20 ++
>>   drivers/input/serio/Kconfig                        |   10 +
>>   drivers/input/serio/Makefile                       |    1 +
>>   drivers/input/serio/apbps2.c                       |  266 ++++++++++++++++++++
>>   4 files changed, 297 insertions(+), 0 deletions(-)
>>   create mode 100644 Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt
>>   create mode 100644 drivers/input/serio/apbps2.c
>>
>> diff --git a/Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt b/Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt
>> new file mode 100644
>> index 0000000..1553d28
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt
>> @@ -0,0 +1,20 @@
>> +Aeroflex Gaisler APBPS2 PS/2 Core, supporting Keyboard or Mouse.
>> +
>> +The APBPS2 PS/2 core is available in the GRLIB VHDL IP core library.
>> +
>> +Note: In the ordinary environment for the APBPS2 core, a LEON SPARC system,
>> +these properties are built from information in the AMBA plug&play and from
>> +bootloader settings.
>> +
>> +Required properties:
>> +
>> +- name : Should be "GAISLER_APBPS2" or "01_060"
>> +- reg : Address and length of the register set for the device
>> +- interrupts : Interrupt numbers for this device
>> +
>> +Optional properties:
>> +- keyboard : if present it indicates that a keyboard is connected, if not
>> +             present the driver will assume that a mouse is connected instead
>> +
>> +For further information look in the documentation for the GLIB IP core library:
>> +http://www.gaisler.com/products/grlib/grip.pdf
>> diff --git a/drivers/input/serio/Kconfig b/drivers/input/serio/Kconfig
>> index 4a4e182..d0304c3 100644
>> --- a/drivers/input/serio/Kconfig
>> +++ b/drivers/input/serio/Kconfig
>> @@ -236,6 +236,7 @@ config SERIO_PS2MULT
>>   
>>   config SERIO_ARC_PS2
>>   	tristate "ARC PS/2 support"
>> +	depends on OF
> This looks like an unrelated change.
You are correct, it was meant to end up in SERIO_APBPS2 of course, sorry for that.. will fix for next patch
>>   	help
>>   	  Say Y here if you have an ARC FPGA platform with a PS/2
>>   	  controller in it.
>> @@ -243,4 +244,13 @@ config SERIO_ARC_PS2
>>   	  To compile this driver as a module, choose M here; the module
>>   	  will be called arc_ps2.
>>   
>> +config SERIO_APBPS2
>> +        tristate "GRLIB APBPS2 PS/2 keyboard/mouse controller"
>> +        help
>> +          Say Y here if you want support for GRLIB APBPS2 peripherals used
>> +          to connect to PS/2 keyboard and/or mouse.
>> +
>> +          To compile this driver as a module, choose M here: the module will
>> +          be called apbps2.
>> +
>>   endif
>> diff --git a/drivers/input/serio/Makefile b/drivers/input/serio/Makefile
>> index 4b0c8f8..8edb36c 100644
>> --- a/drivers/input/serio/Makefile
>> +++ b/drivers/input/serio/Makefile
>> @@ -26,3 +26,4 @@ obj-$(CONFIG_SERIO_AMS_DELTA)	+= ams_delta_serio.o
>>   obj-$(CONFIG_SERIO_XILINX_XPS_PS2)	+= xilinx_ps2.o
>>   obj-$(CONFIG_SERIO_ALTERA_PS2)	+= altera_ps2.o
>>   obj-$(CONFIG_SERIO_ARC_PS2)	+= arc_ps2.o
>> +obj-$(CONFIG_SERIO_APBPS2)	+= apbps2.o
>> diff --git a/drivers/input/serio/apbps2.c b/drivers/input/serio/apbps2.c
>> new file mode 100644
>> index 0000000..78b28e1
>> --- /dev/null
>> +++ b/drivers/input/serio/apbps2.c
>> @@ -0,0 +1,266 @@
>> +/*
>> + *  linux/drivers/input/serio/apbps2.c
>> + *
>> + *  Copyright (C) 2013 Aeroflex Gaisler
>> + *
>> + * This driver supports the APBPS2 PS/2 core available in the GRLIB
>> + * VHDL IP core library.
>> + *
>> + * Full documentation of the APBPS2 core can be found here:
>> + * http://www.gaisler.com/products/grlib/grip.pdf
>> + *
>> + * See "Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt" for
>> + * information on open firmware properties.
>> + *
>> + * 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.
>> + *
>> + * Contributors: Daniel Hellstrom <daniel@gaisler.com>
>> + */
>> +#include <linux/platform_device.h>
>> +#include <linux/of_device.h>
>> +#include <linux/module.h>
>> +#include <linux/init.h>
>> +#include <linux/serio.h>
>> +#include <linux/errno.h>
>> +#include <linux/interrupt.h>
>> +#include <linux/device.h>
>> +#include <linux/delay.h>
>> +#include <linux/slab.h>
>> +#include <linux/err.h>
>> +#include <linux/string.h>
>> +#include <linux/kernel.h>
>> +#include <linux/io.h>
>> +
>> +struct apbps2_regs {
>> +	u32 data;	/* 0x00 */
>> +	u32 status;	/* 0x04 */
>> +	u32 ctrl;	/* 0x08 */
>> +	u32 reload;	/* 0x0c */
>> +};
>> +
>> +#define APBPS2_STATUS_DR	(1<<0)
>> +#define APBPS2_STATUS_PE	(1<<1)
>> +#define APBPS2_STATUS_FE	(1<<2)
>> +#define APBPS2_STATUS_KI	(1<<3)
>> +#define APBPS2_STATUS_RF	(1<<4)
>> +#define APBPS2_STATUS_TF	(1<<5)
>> +#define APBPS2_STATUS_TCNT	(0x1f<<22)
>> +#define APBPS2_STATUS_RCNT	(0x1f<<27)
>> +
>> +#define APBPS2_CTRL_RE		(1<<0)
>> +#define APBPS2_CTRL_TE		(1<<1)
>> +#define APBPS2_CTRL_RI		(1<<2)
>> +#define APBPS2_CTRL_TI		(1<<3)
>> +
>> +/* Register read/write functions */
>> +#define APBPS2_READ(reg) apbps2_read_reg(reg)
>> +#define APBPS2_WRITE(reg, data) apbps2_write_reg(reg, data)
> Why?
>
>> +
>> +struct apbps2_priv {
>> +	struct serio		io;
>> +	struct apbps2_regs	*regs;
>> +	int			irq;
>> +};
>> +
>> +static inline unsigned long apbps2_read_reg(void __iomem *reg)
>> +{
>> +	return ioread32be(reg);
>> +}
>> +
>> +static inline void apbps2_write_reg(void __iomem *reg, unsigned long data)
>> +{
>> +	iowrite32be(data, reg);
> Do we really need these wrappers?

Ok, I will rewrite using io{read,write}32be() directly without wrappers and macros, I though this was the preferred solution.

>
>> +}
>> +
>> +static irqreturn_t apbps2_isr(int irq, void *dev_id)
>> +{
>> +	struct apbps2_priv *priv = dev_id;
>> +	unsigned long status, data, rxflags;
>> +	irqreturn_t ret = IRQ_NONE;
>> +
>> +	while ((status = APBPS2_READ(&priv->regs->status)) & APBPS2_STATUS_DR) {
>> +		data = APBPS2_READ(&priv->regs->data);
>> +		rxflags = (status & APBPS2_STATUS_PE) ? SERIO_PARITY : 0;
>> +		rxflags |= (status & APBPS2_STATUS_PE) ? SERIO_FRAME : 0;
>> +
>> +		/* clear error bits? */
>> +		if (rxflags)
>> +			APBPS2_WRITE(&priv->regs->status, status);
>> +
>> +		serio_interrupt(&priv->io, data, rxflags);
>> +
>> +		ret = IRQ_HANDLED;
>> +	}
>> +
>> +	return ret;
>> +}
>> +
>> +static int apbps2_write(struct serio *io, unsigned char val)
>> +{
>> +	struct apbps2_priv *priv = io->port_data;
>> +	unsigned int tleft = 10000; /* timeout in 100ms */
>> +
>> +	/* delay until PS/2 controller has room for more chars */
>> +	while ((APBPS2_READ(&priv->regs->status) & APBPS2_STATUS_TF) && tleft--)
>> +		udelay(10);
>> +
>> +	if ((APBPS2_READ(&priv->regs->status) & APBPS2_STATUS_TF) == 0) {
>> +		APBPS2_WRITE(&priv->regs->data, val);
>> +
>> +		APBPS2_WRITE(&priv->regs->ctrl, APBPS2_CTRL_RE |
>> +						APBPS2_CTRL_RI |
>> +						APBPS2_CTRL_TE);
>> +		return 0;
>> +	}
>> +
>> +	return SERIO_TIMEOUT;
> No, it should return negative error code. -EIO for example.
Ok, I will return -ETIMEDOUT instead.
>
>> +}
>> +
>> +static int apbps2_open(struct serio *io)
>> +{
>> +	struct apbps2_priv *priv = io->port_data;
>> +	int err, limit;
>> +	unsigned long tmp;
>> +
>> +	err = devm_request_irq(&io->dev, priv->irq, apbps2_isr, IRQF_SHARED,
>> +								"apbps2", priv);
>> +	if (err) {
>> +		dev_err(&io->dev, "request IRQ%d failed\n", priv->irq);
>> +		return err;
>> +	}
>> +
>> +	/* clear error flags */
>> +	APBPS2_WRITE(&priv->regs->status, 0);
>> +
>> +	/* Clear old data if available (unlikely) */
>> +	limit = 1024;
>> +	while ((APBPS2_READ(&priv->regs->status) & APBPS2_STATUS_DR) && --limit)
>> +		tmp = APBPS2_READ(&priv->regs->data);
>> +
>> +	/* Enable reciever and it's interrupt */
>> +	APBPS2_WRITE(&priv->regs->ctrl, APBPS2_CTRL_RE | APBPS2_CTRL_RI);
>> +
>> +	return 0;
>> +}
>> +
>> +static void apbps2_close(struct serio *io)
>> +{
>> +	struct apbps2_priv *priv = io->port_data;
>> +
>> +	/* stop interrupts at PS/2 HW level */
>> +	APBPS2_WRITE(&priv->regs->ctrl, 0);
>> +
>> +	/* unregister PS/2 interrupt handler */
>> +	devm_free_irq(&io->dev, priv->irq, priv);
> What is the benefit (except for wasting memory) of using
> devm_request_irq()/devm_free_irq() in this fashion?
None.

>
> By the way, I would prefer if request IRQ was done in probe and freeing
> in remove. I know that many existing serio drivers do it in open/close,
> but this is not correct. We shoudl make sure all resources are available
> beforehand.
This has been done to avoid spending time in the APBPS2 ISR when the PS/2 interface is not used, and the interrupt is shared with another hardware.

Ok, I will move it to from open/close to probe/remove, at that point I beleive it actually does makes sens to use devm_request_irq() to help with freeing so I will keep using devm_request_irq() unless 
someone objects.


>
>> +}
>> +
>> +/* Initialize one APBPS2 PS/2 core */
>> +static int apbps2_of_probe(struct platform_device *ofdev)
>> +{
>> +	struct apbps2_priv *priv;
>> +	int len;
>> +	u32 *addr, *freq_hz;
>> +	char *typestr;
>> +	struct resource *res;
>> +
>> +	priv = devm_kzalloc(&ofdev->dev, sizeof(*priv), GFP_KERNEL);
>> +	if (!priv) {
>> +		dev_err(&ofdev->dev, "memory allocation failed\n");
>> +		return -ENOMEM;
>> +	}
>> +	platform_set_drvdata(ofdev, priv);
>> +
>> +	/* Find Device Address */
>> +	res = platform_get_resource(ofdev, IORESOURCE_MEM, 0);
>> +	priv->regs = devm_request_and_ioremap(&ofdev->dev, res);
>> +	if (!priv->regs) {
>> +		dev_err(&ofdev->dev, "io-regs mapping failed\n");
>> +		return -EADDRNOTAVAIL;
>> +	}
>> +
>> +	/* IRQ */
>> +	priv->irq = ofdev->archdata.irqs[0];
>> +
>> +	/* Get core frequency */
>> +	freq_hz = (u32 *)of_get_property(ofdev->dev.of_node, "freq", &len);
> There is of_property_read_u32 for this.
Ok.
>
>> +	if (!freq_hz) {
>> +		dev_err(&ofdev->dev, "unable to get core frequency\n");
>> +		return -EINVAL;
>> +	}
>> +
>> +	priv->io.open	= apbps2_open;
>> +	priv->io.close	= apbps2_close;
>> +	priv->io.port_data = priv;
>> +
>> +	/* Get keyboard property. If no such property we know it is a mouse */
>> +	addr = (u32 *)of_get_property(ofdev->dev.of_node, "keyboard", &len);
> And for this.
Ok.
>
>> +	if (!addr) {
>> +		priv->io.id.type = SERIO_PS_PSTHRU;
> This is really for pass-through PS/2 ports. Why are even doing this?
> Can't you switch the devices over? atkbd and psmouse drivers will query
> the attached devices and figure out to which they should bind. Both
> ports should declare themselves as SERIO_8042.

This is a good question which I will have to investigate, in our old driver from 2.6.21.1 this was probably the case. For newer designs however, I can see no reason why not to use SERIO_8042 here as well.

>> +		priv->io.write = apbps2_write;
>> +		strlcpy(priv->io.name, "APBPS2 PS/2 Mouse",
>> +						sizeof(priv->io.name));
>> +		strlcpy(priv->io.phys, "APBPS2 PS/2 Mouse",
>> +						sizeof(priv->io.phys));
>> +		typestr = "Mouse";
>> +	} else {
>> +		priv->io.id.type = SERIO_8042;
>> +		priv->io.write = apbps2_write;
>> +		strlcpy(priv->io.name, "APBPS2 PS/2 Keyboard",
>> +						sizeof(priv->io.name));
>> +		strlcpy(priv->io.phys, "APBPS2 PS/2 Keyboard",
>> +						sizeof(priv->io.phys));
>> +		typestr = "Keyboard";
>> +	}
>> +
>> +	dev_info(&ofdev->dev, "%s, irq = %d, base = 0x%p\n",
>> +			typestr, priv->irq, priv->regs);
> dev_dbg() if you need this.
I would prefer to use dev_info() so that it is printed on startup on our embedded systems. I see that there are several other serio drivers that uses dev_info() in a similar fashion.

>
>> +
>> +	/* Set reload register to system freq in kHz/10 */
>> +	APBPS2_WRITE(&priv->regs->reload, *freq_hz / 10000);
>> +
>> +	serio_register_port(&priv->io);
>> +
>> +	return 0;
>> +}
>> +
>> +static int apbps2_of_remove(struct platform_device *of_dev)
>> +{
>> +	struct apbps2_priv *priv = platform_get_drvdata(of_dev);
>> +
>> +	of_iounmap(&of_dev->resource[0], priv->regs,
>> +					resource_size(&of_dev->resource[0]));
> I am pretty sure it messes up allocation with
> devm_request_and_ioremap().

You are correct. I missed to remove that during changing to devm_*.
>
>> +	kfree(priv);
> And this certainly messes up devm_kzalloc(). And where do you unregister
> the ports you created in probe? I am willing to bet module unload was
> never tested.

You are correct again. I will fix this and call serio_unregister_port().

I tested before converting to the use of devm_*, must have screwed it up double up.


>> +
>> +	return 0;
>> +}
>> +
>> +static struct of_device_id apbps2_of_match[] = {
>> +	{
>> +	 .name = "GAISLER_APBPS2",
>> +	 },
> This is weird formatting. Also matching is uually done on compatible
> strings.

This is the format of the SPARC32/LEON AMBA Plug&Play bus, there is not much I can do about that. A LEON is unique in that it has Plug&Play on the lowest level I/O registers. Several driver in the 
kernel uses this nomenclature.

>> +	{
>> +	 .name = "01_060",
>> +	 },
>> +	{},
>> +};
>> +
>> +MODULE_DEVICE_TABLE(of, apbps2_of_match);
>> +
>> +static struct platform_driver apbps2_of_driver = {
>> +	.driver = {
>> +		.name = "grlib-apbps2",
>> +		.owner = THIS_MODULE,
>> +		.of_match_table = apbps2_of_match,
>> +	},
>> +	.probe = apbps2_of_probe,
>> +	.remove = apbps2_of_remove,
>> +};
>> +
>> +module_platform_driver(apbps2_of_driver);
>> +
>> +MODULE_AUTHOR("Aeroflex Gaisler AB.");
>> +MODULE_DESCRIPTION("GRLIB APBPS2 PS/2 serial I/O");
>> +MODULE_LICENSE("GPL");
> Thanks.

Thank you very much for your comments, I will repost the patch as soon as I fixed it and retested it.

Thanks,
Daniel
--
To unsubscribe from this list: send the line "unsubscribe linux-input" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Dmitry Torokhov Feb. 21, 2013, 6:03 p.m. UTC | #3
On Thu, Feb 21, 2013 at 10:49:41AM +0100, Daniel Hellstrom wrote:
> On 02/20/2013 07:43 PM, Dmitry Torokhov wrote:
> >Hi Daniel,
> >
> >On Wed, Feb 20, 2013 at 03:41:33PM +0100, Daniel Hellstrom wrote:
> >>+static void apbps2_close(struct serio *io)
> >>+{
> >>+	struct apbps2_priv *priv = io->port_data;
> >>+
> >>+	/* stop interrupts at PS/2 HW level */
> >>+	APBPS2_WRITE(&priv->regs->ctrl, 0);
> >>+
> >>+	/* unregister PS/2 interrupt handler */
> >>+	devm_free_irq(&io->dev, priv->irq, priv);
> >What is the benefit (except for wasting memory) of using
> >devm_request_irq()/devm_free_irq() in this fashion?
> None.
> 
> >
> >By the way, I would prefer if request IRQ was done in probe and freeing
> >in remove. I know that many existing serio drivers do it in open/close,
> >but this is not correct. We shoudl make sure all resources are available
> >beforehand.

> This has been done to avoid spending time in the APBPS2 ISR when the
> PS/2 interface is not used, and the interrupt is shared with another
> hardware.

Thankfully your device seems to be able shut off interrupts at the
controller level, so this should not be an issue.
diff mbox

Patch

diff --git a/Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt b/Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt
new file mode 100644
index 0000000..1553d28
--- /dev/null
+++ b/Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt
@@ -0,0 +1,20 @@ 
+Aeroflex Gaisler APBPS2 PS/2 Core, supporting Keyboard or Mouse.
+
+The APBPS2 PS/2 core is available in the GRLIB VHDL IP core library.
+
+Note: In the ordinary environment for the APBPS2 core, a LEON SPARC system,
+these properties are built from information in the AMBA plug&play and from
+bootloader settings.
+
+Required properties:
+
+- name : Should be "GAISLER_APBPS2" or "01_060"
+- reg : Address and length of the register set for the device
+- interrupts : Interrupt numbers for this device
+
+Optional properties:
+- keyboard : if present it indicates that a keyboard is connected, if not
+             present the driver will assume that a mouse is connected instead
+
+For further information look in the documentation for the GLIB IP core library:
+http://www.gaisler.com/products/grlib/grip.pdf
diff --git a/drivers/input/serio/Kconfig b/drivers/input/serio/Kconfig
index 4a4e182..d0304c3 100644
--- a/drivers/input/serio/Kconfig
+++ b/drivers/input/serio/Kconfig
@@ -236,6 +236,7 @@  config SERIO_PS2MULT
 
 config SERIO_ARC_PS2
 	tristate "ARC PS/2 support"
+	depends on OF
 	help
 	  Say Y here if you have an ARC FPGA platform with a PS/2
 	  controller in it.
@@ -243,4 +244,13 @@  config SERIO_ARC_PS2
 	  To compile this driver as a module, choose M here; the module
 	  will be called arc_ps2.
 
+config SERIO_APBPS2
+        tristate "GRLIB APBPS2 PS/2 keyboard/mouse controller"
+        help
+          Say Y here if you want support for GRLIB APBPS2 peripherals used
+          to connect to PS/2 keyboard and/or mouse.
+
+          To compile this driver as a module, choose M here: the module will
+          be called apbps2.
+
 endif
diff --git a/drivers/input/serio/Makefile b/drivers/input/serio/Makefile
index 4b0c8f8..8edb36c 100644
--- a/drivers/input/serio/Makefile
+++ b/drivers/input/serio/Makefile
@@ -26,3 +26,4 @@  obj-$(CONFIG_SERIO_AMS_DELTA)	+= ams_delta_serio.o
 obj-$(CONFIG_SERIO_XILINX_XPS_PS2)	+= xilinx_ps2.o
 obj-$(CONFIG_SERIO_ALTERA_PS2)	+= altera_ps2.o
 obj-$(CONFIG_SERIO_ARC_PS2)	+= arc_ps2.o
+obj-$(CONFIG_SERIO_APBPS2)	+= apbps2.o
diff --git a/drivers/input/serio/apbps2.c b/drivers/input/serio/apbps2.c
new file mode 100644
index 0000000..78b28e1
--- /dev/null
+++ b/drivers/input/serio/apbps2.c
@@ -0,0 +1,266 @@ 
+/*
+ *  linux/drivers/input/serio/apbps2.c
+ *
+ *  Copyright (C) 2013 Aeroflex Gaisler
+ *
+ * This driver supports the APBPS2 PS/2 core available in the GRLIB
+ * VHDL IP core library.
+ *
+ * Full documentation of the APBPS2 core can be found here:
+ * http://www.gaisler.com/products/grlib/grip.pdf
+ *
+ * See "Documentation/devicetree/bindings/input/ps2keyb-mouse-apbps2.txt" for
+ * information on open firmware properties.
+ *
+ * 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.
+ *
+ * Contributors: Daniel Hellstrom <daniel@gaisler.com>
+ */
+#include <linux/platform_device.h>
+#include <linux/of_device.h>
+#include <linux/module.h>
+#include <linux/init.h>
+#include <linux/serio.h>
+#include <linux/errno.h>
+#include <linux/interrupt.h>
+#include <linux/device.h>
+#include <linux/delay.h>
+#include <linux/slab.h>
+#include <linux/err.h>
+#include <linux/string.h>
+#include <linux/kernel.h>
+#include <linux/io.h>
+
+struct apbps2_regs {
+	u32 data;	/* 0x00 */
+	u32 status;	/* 0x04 */
+	u32 ctrl;	/* 0x08 */
+	u32 reload;	/* 0x0c */
+};
+
+#define APBPS2_STATUS_DR	(1<<0)
+#define APBPS2_STATUS_PE	(1<<1)
+#define APBPS2_STATUS_FE	(1<<2)
+#define APBPS2_STATUS_KI	(1<<3)
+#define APBPS2_STATUS_RF	(1<<4)
+#define APBPS2_STATUS_TF	(1<<5)
+#define APBPS2_STATUS_TCNT	(0x1f<<22)
+#define APBPS2_STATUS_RCNT	(0x1f<<27)
+
+#define APBPS2_CTRL_RE		(1<<0)
+#define APBPS2_CTRL_TE		(1<<1)
+#define APBPS2_CTRL_RI		(1<<2)
+#define APBPS2_CTRL_TI		(1<<3)
+
+/* Register read/write functions */
+#define APBPS2_READ(reg) apbps2_read_reg(reg)
+#define APBPS2_WRITE(reg, data) apbps2_write_reg(reg, data)
+
+struct apbps2_priv {
+	struct serio		io;
+	struct apbps2_regs	*regs;
+	int			irq;
+};
+
+static inline unsigned long apbps2_read_reg(void __iomem *reg)
+{
+	return ioread32be(reg);
+}
+
+static inline void apbps2_write_reg(void __iomem *reg, unsigned long data)
+{
+	iowrite32be(data, reg);
+}
+
+static irqreturn_t apbps2_isr(int irq, void *dev_id)
+{
+	struct apbps2_priv *priv = dev_id;
+	unsigned long status, data, rxflags;
+	irqreturn_t ret = IRQ_NONE;
+
+	while ((status = APBPS2_READ(&priv->regs->status)) & APBPS2_STATUS_DR) {
+		data = APBPS2_READ(&priv->regs->data);
+		rxflags = (status & APBPS2_STATUS_PE) ? SERIO_PARITY : 0;
+		rxflags |= (status & APBPS2_STATUS_PE) ? SERIO_FRAME : 0;
+
+		/* clear error bits? */
+		if (rxflags)
+			APBPS2_WRITE(&priv->regs->status, status);
+
+		serio_interrupt(&priv->io, data, rxflags);
+
+		ret = IRQ_HANDLED;
+	}
+
+	return ret;
+}
+
+static int apbps2_write(struct serio *io, unsigned char val)
+{
+	struct apbps2_priv *priv = io->port_data;
+	unsigned int tleft = 10000; /* timeout in 100ms */
+
+	/* delay until PS/2 controller has room for more chars */
+	while ((APBPS2_READ(&priv->regs->status) & APBPS2_STATUS_TF) && tleft--)
+		udelay(10);
+
+	if ((APBPS2_READ(&priv->regs->status) & APBPS2_STATUS_TF) == 0) {
+		APBPS2_WRITE(&priv->regs->data, val);
+
+		APBPS2_WRITE(&priv->regs->ctrl, APBPS2_CTRL_RE |
+						APBPS2_CTRL_RI |
+						APBPS2_CTRL_TE);
+		return 0;
+	}
+
+	return SERIO_TIMEOUT;
+}
+
+static int apbps2_open(struct serio *io)
+{
+	struct apbps2_priv *priv = io->port_data;
+	int err, limit;
+	unsigned long tmp;
+
+	err = devm_request_irq(&io->dev, priv->irq, apbps2_isr, IRQF_SHARED,
+								"apbps2", priv);
+	if (err) {
+		dev_err(&io->dev, "request IRQ%d failed\n", priv->irq);
+		return err;
+	}
+
+	/* clear error flags */
+	APBPS2_WRITE(&priv->regs->status, 0);
+
+	/* Clear old data if available (unlikely) */
+	limit = 1024;
+	while ((APBPS2_READ(&priv->regs->status) & APBPS2_STATUS_DR) && --limit)
+		tmp = APBPS2_READ(&priv->regs->data);
+
+	/* Enable reciever and it's interrupt */
+	APBPS2_WRITE(&priv->regs->ctrl, APBPS2_CTRL_RE | APBPS2_CTRL_RI);
+
+	return 0;
+}
+
+static void apbps2_close(struct serio *io)
+{
+	struct apbps2_priv *priv = io->port_data;
+
+	/* stop interrupts at PS/2 HW level */
+	APBPS2_WRITE(&priv->regs->ctrl, 0);
+
+	/* unregister PS/2 interrupt handler */
+	devm_free_irq(&io->dev, priv->irq, priv);
+}
+
+/* Initialize one APBPS2 PS/2 core */
+static int apbps2_of_probe(struct platform_device *ofdev)
+{
+	struct apbps2_priv *priv;
+	int len;
+	u32 *addr, *freq_hz;
+	char *typestr;
+	struct resource *res;
+
+	priv = devm_kzalloc(&ofdev->dev, sizeof(*priv), GFP_KERNEL);
+	if (!priv) {
+		dev_err(&ofdev->dev, "memory allocation failed\n");
+		return -ENOMEM;
+	}
+	platform_set_drvdata(ofdev, priv);
+
+	/* Find Device Address */
+	res = platform_get_resource(ofdev, IORESOURCE_MEM, 0);
+	priv->regs = devm_request_and_ioremap(&ofdev->dev, res);
+	if (!priv->regs) {
+		dev_err(&ofdev->dev, "io-regs mapping failed\n");
+		return -EADDRNOTAVAIL;
+	}
+
+	/* IRQ */
+	priv->irq = ofdev->archdata.irqs[0];
+
+	/* Get core frequency */
+	freq_hz = (u32 *)of_get_property(ofdev->dev.of_node, "freq", &len);
+	if (!freq_hz) {
+		dev_err(&ofdev->dev, "unable to get core frequency\n");
+		return -EINVAL;
+	}
+
+	priv->io.open	= apbps2_open;
+	priv->io.close	= apbps2_close;
+	priv->io.port_data = priv;
+
+	/* Get keyboard property. If no such property we know it is a mouse */
+	addr = (u32 *)of_get_property(ofdev->dev.of_node, "keyboard", &len);
+	if (!addr) {
+		priv->io.id.type = SERIO_PS_PSTHRU;
+		priv->io.write = apbps2_write;
+		strlcpy(priv->io.name, "APBPS2 PS/2 Mouse",
+						sizeof(priv->io.name));
+		strlcpy(priv->io.phys, "APBPS2 PS/2 Mouse",
+						sizeof(priv->io.phys));
+		typestr = "Mouse";
+	} else {
+		priv->io.id.type = SERIO_8042;
+		priv->io.write = apbps2_write;
+		strlcpy(priv->io.name, "APBPS2 PS/2 Keyboard",
+						sizeof(priv->io.name));
+		strlcpy(priv->io.phys, "APBPS2 PS/2 Keyboard",
+						sizeof(priv->io.phys));
+		typestr = "Keyboard";
+	}
+
+	dev_info(&ofdev->dev, "%s, irq = %d, base = 0x%p\n",
+			typestr, priv->irq, priv->regs);
+
+	/* Set reload register to system freq in kHz/10 */
+	APBPS2_WRITE(&priv->regs->reload, *freq_hz / 10000);
+
+	serio_register_port(&priv->io);
+
+	return 0;
+}
+
+static int apbps2_of_remove(struct platform_device *of_dev)
+{
+	struct apbps2_priv *priv = platform_get_drvdata(of_dev);
+
+	of_iounmap(&of_dev->resource[0], priv->regs,
+					resource_size(&of_dev->resource[0]));
+	kfree(priv);
+
+	return 0;
+}
+
+static struct of_device_id apbps2_of_match[] = {
+	{
+	 .name = "GAISLER_APBPS2",
+	 },
+	{
+	 .name = "01_060",
+	 },
+	{},
+};
+
+MODULE_DEVICE_TABLE(of, apbps2_of_match);
+
+static struct platform_driver apbps2_of_driver = {
+	.driver = {
+		.name = "grlib-apbps2",
+		.owner = THIS_MODULE,
+		.of_match_table = apbps2_of_match,
+	},
+	.probe = apbps2_of_probe,
+	.remove = apbps2_of_remove,
+};
+
+module_platform_driver(apbps2_of_driver);
+
+MODULE_AUTHOR("Aeroflex Gaisler AB.");
+MODULE_DESCRIPTION("GRLIB APBPS2 PS/2 serial I/O");
+MODULE_LICENSE("GPL");