drivers/input/mouse/elan_i2c.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Elan I2C/SMBus Touchpad driver
   4  *
   5  * Copyright (c) 2013 ELAN Microelectronics Corp.
   6  *
   7  * Author: 林政維 (Duson Lin) <dusonlin@emc.com.tw>
   8  *
   9  * Based on cyapa driver:
  10  * copyright (c) 2011-2012 Cypress Semiconductor, Inc.
  11  * copyright (c) 2011-2012 Google, Inc.
  12  *
  13  * Trademarks are the property of their respective owners.
  14  */
  15
  16 #ifndef _ELAN_I2C_H
  17 #define _ELAN_I2C_H
  18
  19 #include <linux/types.h>
  20
  21 #define ETP_ENABLE_ABS          0x0001
  22 #define ETP_ENABLE_CALIBRATE    0x0002
  23 #define ETP_DISABLE_CALIBRATE   0x0000
  24 #define ETP_DISABLE_POWER       0x0001
  25 #define ETP_PRESSURE_OFFSET     25
  26
  27 #define ETP_CALIBRATE_MAX_LEN   3
  28
  29 #define ETP_FEATURE_REPORT_MK   BIT(0)
  30
  31 #define ETP_REPORT_ID           0x5D
  32 #define ETP_TP_REPORT_ID        0x5E
  33 #define ETP_TP_REPORT_ID2       0x5F
  34 #define ETP_REPORT_ID2          0x60    /* High precision report */
  35
  36 #define ETP_REPORT_ID_OFFSET    2
  37 #define ETP_TOUCH_INFO_OFFSET   3
  38 #define ETP_FINGER_DATA_OFFSET  4
  39 #define ETP_HOVER_INFO_OFFSET   30
  40 #define ETP_MK_DATA_OFFSET      33      /* For high precision reports */
  41
  42 #define ETP_MAX_REPORT_LEN      39
  43
  44 #define ETP_MAX_FINGERS         5
  45 #define ETP_FINGER_DATA_LEN     5
  46
  47 /* IAP Firmware handling */
  48 #define ETP_PRODUCT_ID_FORMAT_STRING    "%d.0"
  49 #define ETP_FW_NAME             "elan_i2c_" ETP_PRODUCT_ID_FORMAT_STRING ".bin"
  50 #define ETP_IAP_START_ADDR      0x0083
  51 #define ETP_FW_IAP_PAGE_ERR     (1 << 5)
  52 #define ETP_FW_IAP_INTF_ERR     (1 << 4)
  53 #define ETP_FW_PAGE_SIZE        64
  54 #define ETP_FW_PAGE_SIZE_128    128
  55 #define ETP_FW_PAGE_SIZE_512    512
  56 #define ETP_FW_SIGNATURE_SIZE   6
  57
  58 #define ETP_PRODUCT_ID_WHITEBOX 0x00B8
  59 #define ETP_PRODUCT_ID_VOXEL    0x00BF
  60 #define ETP_PRODUCT_ID_DELBIN   0x00C2
  61 #define ETP_PRODUCT_ID_MAGPIE   0x0120
  62 #define ETP_PRODUCT_ID_BOBBA    0x0121
  63
  64 struct i2c_client;
  65 struct completion;
  66
  67 enum tp_mode {
  68         IAP_MODE = 1,
  69         MAIN_MODE
  70 };
  71
  72 struct elan_transport_ops {
  73         int (*initialize)(struct i2c_client *client);
  74         int (*sleep_control)(struct i2c_client *, bool sleep);
  75         int (*power_control)(struct i2c_client *, bool enable);
  76         int (*set_mode)(struct i2c_client *client, u8 mode);
  77
  78         int (*calibrate)(struct i2c_client *client);
  79         int (*calibrate_result)(struct i2c_client *client, u8 *val);
  80
  81         int (*get_baseline_data)(struct i2c_client *client,
  82                                  bool max_baseline, u8 *value);
  83
  84         int (*get_version)(struct i2c_client *client, u8 pattern, bool iap,
  85                            u8 *version);
  86         int (*get_sm_version)(struct i2c_client *client, u8 pattern,
  87                               u16 *ic_type, u8 *version, u8 *clickpad);
  88         int (*get_checksum)(struct i2c_client *client, bool iap, u16 *csum);
  89         int (*get_product_id)(struct i2c_client *client, u16 *id);
  90
  91         int (*get_max)(struct i2c_client *client,
  92                        unsigned int *max_x, unsigned int *max_y);
  93         int (*get_resolution)(struct i2c_client *client,
  94                               u8 *hw_res_x, u8 *hw_res_y);
  95         int (*get_num_traces)(struct i2c_client *client,
  96                               unsigned int *x_tracenum,
  97                               unsigned int *y_tracenum);
  98
  99         int (*iap_get_mode)(struct i2c_client *client, enum tp_mode *mode);
 100         int (*iap_reset)(struct i2c_client *client);
 101
 102         int (*prepare_fw_update)(struct i2c_client *client, u16 ic_type,
 103                                  u8 iap_version, u16 fw_page_size);
 104         int (*write_fw_block)(struct i2c_client *client, u16 fw_page_size,
 105                               const u8 *page, u16 checksum, int idx);
 106         int (*finish_fw_update)(struct i2c_client *client,
 107                                 struct completion *reset_done);
 108
 109         int (*get_report_features)(struct i2c_client *client, u8 pattern,
 110                                    unsigned int *features,
 111                                    unsigned int *report_len);
 112         int (*get_report)(struct i2c_client *client, u8 *report,
 113                           unsigned int report_len);
 114         int (*get_pressure_adjustment)(struct i2c_client *client,
 115                                        int *adjustment);
 116         int (*get_pattern)(struct i2c_client *client, u8 *pattern);
 117 };
 118
 119 extern const struct elan_transport_ops elan_smbus_ops, elan_i2c_ops;
 120
 121 #endif /* _ELAN_I2C_H */