include/linux/libps2.h

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