drivers/input/mouse/psmouse.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef _PSMOUSE_H
   3 #define _PSMOUSE_H
   4
   5 #define PSMOUSE_OOB_NONE        0x00
   6 #define PSMOUSE_OOB_EXTRA_BTNS  0x01
   7
   8 #define PSMOUSE_CMD_SETSCALE11  0x00e6
   9 #define PSMOUSE_CMD_SETSCALE21  0x00e7
  10 #define PSMOUSE_CMD_SETRES      0x10e8
  11 #define PSMOUSE_CMD_GETINFO     0x03e9
  12 #define PSMOUSE_CMD_SETSTREAM   0x00ea
  13 #define PSMOUSE_CMD_SETPOLL     0x00f0
  14 #define PSMOUSE_CMD_POLL        0x00eb  /* caller sets number of bytes to receive */
  15 #define PSMOUSE_CMD_RESET_WRAP  0x00ec
  16 #define PSMOUSE_CMD_GETID       0x02f2
  17 #define PSMOUSE_CMD_SETRATE     0x10f3
  18 #define PSMOUSE_CMD_ENABLE      0x00f4
  19 #define PSMOUSE_CMD_DISABLE     0x00f5
  20 #define PSMOUSE_CMD_RESET_DIS   0x00f6
  21 #define PSMOUSE_CMD_RESET_BAT   0x02ff
  22
  23 #define PSMOUSE_RET_BAT         0xaa
  24 #define PSMOUSE_RET_ID          0x00
  25 #define PSMOUSE_RET_ACK         0xfa
  26 #define PSMOUSE_RET_NAK         0xfe
  27
  28 enum psmouse_state {
  29         PSMOUSE_IGNORE,
  30         PSMOUSE_INITIALIZING,
  31         PSMOUSE_RESYNCING,
  32         PSMOUSE_CMD_MODE,
  33         PSMOUSE_ACTIVATED,
  34 };
  35
  36 /* psmouse protocol handler return codes */
  37 typedef enum {
  38         PSMOUSE_BAD_DATA,
  39         PSMOUSE_GOOD_DATA,
  40         PSMOUSE_FULL_PACKET
  41 } psmouse_ret_t;
  42
  43 enum psmouse_scale {
  44         PSMOUSE_SCALE11,
  45         PSMOUSE_SCALE21
  46 };
  47
  48 enum psmouse_type {
  49         PSMOUSE_NONE,
  50         PSMOUSE_PS2,
  51         PSMOUSE_PS2PP,
  52         PSMOUSE_THINKPS,
  53         PSMOUSE_GENPS,
  54         PSMOUSE_IMPS,
  55         PSMOUSE_IMEX,
  56         PSMOUSE_SYNAPTICS,
  57         PSMOUSE_ALPS,
  58         PSMOUSE_LIFEBOOK,
  59         PSMOUSE_TRACKPOINT,
  60         PSMOUSE_TOUCHKIT_PS2,
  61         PSMOUSE_CORTRON,
  62         PSMOUSE_HGPK,
  63         PSMOUSE_ELANTECH,
  64         PSMOUSE_FSP,
  65         PSMOUSE_SYNAPTICS_RELATIVE,
  66         PSMOUSE_CYPRESS,
  67         PSMOUSE_FOCALTECH,
  68         PSMOUSE_VMMOUSE,
  69         PSMOUSE_BYD,
  70         PSMOUSE_SYNAPTICS_SMBUS,
  71         PSMOUSE_AUTO            /* This one should always be last */
  72 };
  73
  74 struct psmouse;
  75
  76 struct psmouse_protocol {
  77         enum psmouse_type type;
  78         bool maxproto;
  79         bool ignore_parity; /* Protocol should ignore parity errors from KBC */
  80         bool try_passthru; /* Try protocol also on passthrough ports */
  81         bool smbus_companion; /* "Protocol" is a stub, device is on SMBus */
  82         const char *name;
  83         const char *alias;
  84         int (*detect)(struct psmouse *, bool);
  85         int (*init)(struct psmouse *);
  86 };
  87
  88 struct psmouse {
  89         void *private;
  90         struct input_dev *dev;
  91         struct ps2dev ps2dev;
  92         struct delayed_work resync_work;
  93         const char *vendor;
  94         const char *name;
  95         const struct psmouse_protocol *protocol;
  96         unsigned char packet[8];
  97         unsigned char badbyte;
  98         unsigned char pktcnt;
  99         unsigned char pktsize;
 100         unsigned char oob_data_type;
 101         unsigned char extra_buttons;
 102         bool acks_disable_command;
 103         unsigned int model;
 104         unsigned long last;
 105         unsigned long out_of_sync_cnt;
 106         unsigned long num_resyncs;
 107         enum psmouse_state state;
 108         char devname[64];
 109         char phys[32];
 110
 111         unsigned int rate;
 112         unsigned int resolution;
 113         unsigned int resetafter;
 114         unsigned int resync_time;
 115         bool smartscroll;       /* Logitech only */
 116
 117         psmouse_ret_t (*protocol_handler)(struct psmouse *psmouse);
 118         void (*set_rate)(struct psmouse *psmouse, unsigned int rate);
 119         void (*set_resolution)(struct psmouse *psmouse, unsigned int resolution);
 120         void (*set_scale)(struct psmouse *psmouse, enum psmouse_scale scale);
 121
 122         int (*reconnect)(struct psmouse *psmouse);
 123         int (*fast_reconnect)(struct psmouse *psmouse);
 124         void (*disconnect)(struct psmouse *psmouse);
 125         void (*cleanup)(struct psmouse *psmouse);
 126         int (*poll)(struct psmouse *psmouse);
 127
 128         void (*pt_activate)(struct psmouse *psmouse);
 129         void (*pt_deactivate)(struct psmouse *psmouse);
 130 };
 131
 132 void psmouse_queue_work(struct psmouse *psmouse, struct delayed_work *work,
 133                 unsigned long delay);
 134 int psmouse_reset(struct psmouse *psmouse);
 135 void psmouse_set_state(struct psmouse *psmouse, enum psmouse_state new_state);
 136 void psmouse_set_resolution(struct psmouse *psmouse, unsigned int resolution);
 137 psmouse_ret_t psmouse_process_byte(struct psmouse *psmouse);
 138 int psmouse_activate(struct psmouse *psmouse);
 139 int psmouse_deactivate(struct psmouse *psmouse);
 140 bool psmouse_matches_pnp_id(struct psmouse *psmouse, const char * const ids[]);
 141
 142 void psmouse_report_standard_buttons(struct input_dev *, u8 buttons);
 143 void psmouse_report_standard_motion(struct input_dev *, u8 *packet);
 144 void psmouse_report_standard_packet(struct input_dev *, u8 *packet);
 145
 146 struct psmouse_attribute {
 147         struct device_attribute dattr;
 148         void *data;
 149         ssize_t (*show)(struct psmouse *psmouse, void *data, char *buf);
 150         ssize_t (*set)(struct psmouse *psmouse, void *data,
 151                         const char *buf, size_t count);
 152         bool protect;
 153 };
 154 #define to_psmouse_attr(a)      container_of((a), struct psmouse_attribute, dattr)
 155
 156 ssize_t psmouse_attr_show_helper(struct device *dev, struct device_attribute *attr,
 157                                  char *buf);
 158 ssize_t psmouse_attr_set_helper(struct device *dev, struct device_attribute *attr,
 159                                 const char *buf, size_t count);
 160
 161 #define __PSMOUSE_DEFINE_ATTR_VAR(_name, _mode, _data, _show, _set, _protect)   \
 162 static struct psmouse_attribute psmouse_attr_##_name = {                        \
 163         .dattr  = {                                                             \
 164                 .attr   = {                                                     \
 165                         .name   = __stringify(_name),                           \
 166                         .mode   = _mode,                                        \
 167                 },                                                              \
 168                 .show   = psmouse_attr_show_helper,                             \
 169                 .store  = psmouse_attr_set_helper,                              \
 170         },                                                                      \
 171         .data   = _data,                                                        \
 172         .show   = _show,                                                        \
 173         .set    = _set,                                                         \
 174         .protect = _protect,                                                    \
 175 }
 176
 177 #define __PSMOUSE_DEFINE_ATTR(_name, _mode, _data, _show, _set, _protect)       \
 178         static ssize_t _show(struct psmouse *, void *, char *);                 \
 179         static ssize_t _set(struct psmouse *, void *, const char *, size_t);    \
 180         __PSMOUSE_DEFINE_ATTR_VAR(_name, _mode, _data, _show, _set, _protect)
 181
 182 #define PSMOUSE_DEFINE_ATTR(_name, _mode, _data, _show, _set)                   \
 183         __PSMOUSE_DEFINE_ATTR(_name, _mode, _data, _show, _set, true)
 184
 185 #define PSMOUSE_DEFINE_RO_ATTR(_name, _mode, _data, _show)                      \
 186         static ssize_t _show(struct psmouse *, void *, char *);                 \
 187         __PSMOUSE_DEFINE_ATTR_VAR(_name, _mode, _data, _show, NULL, true)
 188
 189 #define PSMOUSE_DEFINE_WO_ATTR(_name, _mode, _data, _set)                       \
 190         static ssize_t _set(struct psmouse *, void *, const char *, size_t);    \
 191         __PSMOUSE_DEFINE_ATTR_VAR(_name, _mode, _data, NULL, _set, true)
 192
 193 #ifndef psmouse_fmt
 194 #define psmouse_fmt(fmt)        KBUILD_BASENAME ": " fmt
 195 #endif
 196
 197 #define psmouse_dbg(psmouse, format, ...)               \
 198         dev_dbg(&(psmouse)->ps2dev.serio->dev,          \
 199                 psmouse_fmt(format), ##__VA_ARGS__)
 200 #define psmouse_info(psmouse, format, ...)              \
 201         dev_info(&(psmouse)->ps2dev.serio->dev,         \
 202                  psmouse_fmt(format), ##__VA_ARGS__)
 203 #define psmouse_warn(psmouse, format, ...)              \
 204         dev_warn(&(psmouse)->ps2dev.serio->dev,         \
 205                  psmouse_fmt(format), ##__VA_ARGS__)
 206 #define psmouse_err(psmouse, format, ...)               \
 207         dev_err(&(psmouse)->ps2dev.serio->dev,          \
 208                 psmouse_fmt(format), ##__VA_ARGS__)
 209 #define psmouse_notice(psmouse, format, ...)            \
 210         dev_notice(&(psmouse)->ps2dev.serio->dev,       \
 211                    psmouse_fmt(format), ##__VA_ARGS__)
 212 #define psmouse_printk(level, psmouse, format, ...)     \
 213         dev_printk(level,                               \
 214                    &(psmouse)->ps2dev.serio->dev,       \
 215                    psmouse_fmt(format), ##__VA_ARGS__)
 216
 217 #ifdef CONFIG_MOUSE_PS2_SMBUS
 218
 219 int psmouse_smbus_module_init(void);
 220 void psmouse_smbus_module_exit(void);
 221
 222 struct i2c_board_info;
 223
 224 int psmouse_smbus_init(struct psmouse *psmouse,
 225                        const struct i2c_board_info *board,
 226                        const void *pdata, size_t pdata_size,
 227                        bool leave_breadcrumbs);
 228 void psmouse_smbus_cleanup(struct psmouse *psmouse);
 229
 230 #else /* !CONFIG_MOUSE_PS2_SMBUS */
 231
 232 static inline int psmouse_smbus_module_init(void)
 233 {
 234         return 0;
 235 }
 236
 237 static inline void psmouse_smbus_module_exit(void)
 238 {
 239 }
 240
 241 static inline void psmouse_smbus_cleanup(struct psmouse *psmouse)
 242 {
 243 }
 244
 245 #endif /* CONFIG_MOUSE_PS2_SMBUS */
 246
 247 #endif /* _PSMOUSE_H */