[mirror_ubuntu-jammy-kernel.git] / include / linux / libps2.h

#ifndef _LIBPS2_H
#define _LIBPS2_H

/*
 * Copyright (C) 1999-2002 Vojtech Pavlik
 * Copyright (C) 2004 Dmitry Torokhov
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 as published by
 * the Free Software Foundation.
 */

#include <linux/bitops.h>
#include <linux/mutex.h>
#include <linux/types.h>
#include <linux/wait.h>

#define PS2_CMD_SETSCALE11	0x00e6
#define PS2_CMD_SETRES		0x10e8
#define PS2_CMD_GETID		0x02f2
#define PS2_CMD_RESET_BAT	0x02ff

#define PS2_RET_BAT		0xaa
#define PS2_RET_ID		0x00
#define PS2_RET_ACK		0xfa
#define PS2_RET_NAK		0xfe
#define PS2_RET_ERR		0xfc

#define PS2_FLAG_ACK		BIT(0)	/* Waiting for ACK/NAK */
#define PS2_FLAG_CMD		BIT(1)	/* Waiting for a command to finish */
#define PS2_FLAG_CMD1		BIT(2)	/* Waiting for the first byte of command response */
#define PS2_FLAG_WAITID		BIT(3)	/* Command executing is GET ID */
#define PS2_FLAG_NAK		BIT(4)	/* Last transmission was NAKed */
#define PS2_FLAG_ACK_CMD	BIT(5)	/* Waiting to ACK the command (first) byte */

struct ps2dev {
	struct serio *serio;

	/* Ensures that only one command is executing at a time */
	struct mutex cmd_mutex;

	/* Used to signal completion from interrupt handler */
	wait_queue_head_t wait;

	unsigned long flags;
	u8 cmdbuf[8];
	u8 cmdcnt;
	u8 nak;
};

void ps2_init(struct ps2dev *ps2dev, struct serio *serio);
int ps2_sendbyte(struct ps2dev *ps2dev, u8 byte, unsigned int timeout);
void ps2_drain(struct ps2dev *ps2dev, size_t maxbytes, unsigned int timeout);
void ps2_begin_command(struct ps2dev *ps2dev);
void ps2_end_command(struct ps2dev *ps2dev);
int __ps2_command(struct ps2dev *ps2dev, u8 *param, unsigned int command);
int ps2_command(struct ps2dev *ps2dev, u8 *param, unsigned int command);
int ps2_sliced_command(struct ps2dev *ps2dev, u8 command);
bool ps2_handle_ack(struct ps2dev *ps2dev, u8 data);
bool ps2_handle_response(struct ps2dev *ps2dev, u8 data);
void ps2_cmd_aborted(struct ps2dev *ps2dev);
bool ps2_is_keyboard_id(u8 id);

#endif /* _LIBPS2_H */
Commit	Line	Data
1da177e4 LT	1	#ifndef _LIBPS2_H
	2	#define _LIBPS2_H
	3
	4	/*
	5	* Copyright (C) 1999-2002 Vojtech Pavlik
	6	* Copyright (C) 2004 Dmitry Torokhov
	7	*
	8	* This program is free software; you can redistribute it and/or modify it
	9	* under the terms of the GNU General Public License version 2 as published by
	10	* the Free Software Foundation.
	11	*/
	12
3a92dd33	13	#include <linux/bitops.h>
b28bad65 DT	14	#include <linux/mutex.h>
	15	#include <linux/types.h>
	16	#include <linux/wait.h>
1da177e4	17
08be954b DT	18	#define PS2_CMD_SETSCALE11 0x00e6
08be954b DT	19	#define PS2_CMD_SETRES 0x10e8
1da177e4 LT	20	#define PS2_CMD_GETID 0x02f2
	21	#define PS2_CMD_RESET_BAT 0x02ff
	22
	23	#define PS2_RET_BAT 0xaa
	24	#define PS2_RET_ID 0x00
	25	#define PS2_RET_ACK 0xfa
	26	#define PS2_RET_NAK 0xfe
a2d781fc	27	#define PS2_RET_ERR 0xfc
1da177e4	28
3a92dd33 DT	29	#define PS2_FLAG_ACK BIT(0) /* Waiting for ACK/NAK */
	30	#define PS2_FLAG_CMD BIT(1) /* Waiting for a command to finish */
	31	#define PS2_FLAG_CMD1 BIT(2) /* Waiting for the first byte of command response */
	32	#define PS2_FLAG_WAITID BIT(3) /* Command executing is GET ID */
	33	#define PS2_FLAG_NAK BIT(4) /* Last transmission was NAKed */
29acc42e	34	#define PS2_FLAG_ACK_CMD BIT(5) /* Waiting to ACK the command (first) byte */
1da177e4 LT	35
	36	struct ps2dev {
	37	struct serio *serio;
	38
	39	/* Ensures that only one command is executing at a time */
c4e32e9f	40	struct mutex cmd_mutex;
1da177e4 LT	41
	42	/* Used to signal completion from interrupt handler */
	43	wait_queue_head_t wait;
	44
	45	unsigned long flags;
b28bad65 DT	46	u8 cmdbuf[8];
	47	u8 cmdcnt;
	48	u8 nak;
1da177e4 LT	49	};
	50
	51	void ps2_init(struct ps2dev ps2dev, struct serio serio);
b28bad65 DT	52	int ps2_sendbyte(struct ps2dev *ps2dev, u8 byte, unsigned int timeout);
b28bad65 DT	53	void ps2_drain(struct ps2dev *ps2dev, size_t maxbytes, unsigned int timeout);
181d683d DT	54	void ps2_begin_command(struct ps2dev *ps2dev);
181d683d DT	55	void ps2_end_command(struct ps2dev *ps2dev);
b28bad65 DT	56	int __ps2_command(struct ps2dev ps2dev, u8 param, unsigned int command);
b28bad65 DT	57	int ps2_command(struct ps2dev ps2dev, u8 param, unsigned int command);
08be954b	58	int ps2_sliced_command(struct ps2dev *ps2dev, u8 command);
b28bad65 DT	59	bool ps2_handle_ack(struct ps2dev *ps2dev, u8 data);
b28bad65 DT	60	bool ps2_handle_response(struct ps2dev *ps2dev, u8 data);
1da177e4	61	void ps2_cmd_aborted(struct ps2dev *ps2dev);
b28bad65	62	bool ps2_is_keyboard_id(u8 id);
1da177e4 LT	63
1da177e4 LT	64	#endif /* _LIBPS2_H */