include/linux/i2c/adp5588.h

   1 /*
   2  * Analog Devices ADP5588 I/O Expander and QWERTY Keypad Controller
   3  *
   4  * Copyright 2009 Analog Devices Inc.
   5  *
   6  * Licensed under the GPL-2 or later.
   7  */
   8
   9 #ifndef _ADP5588_H
  10 #define _ADP5588_H
  11
  12 #define DEV_ID 0x00             /* Device ID */
  13 #define CFG 0x01                /* Configuration Register1 */
  14 #define INT_STAT 0x02           /* Interrupt Status Register */
  15 #define KEY_LCK_EC_STAT 0x03    /* Key Lock and Event Counter Register */
  16 #define Key_EVENTA 0x04         /* Key Event Register A */
  17 #define Key_EVENTB 0x05         /* Key Event Register B */
  18 #define Key_EVENTC 0x06         /* Key Event Register C */
  19 #define Key_EVENTD 0x07         /* Key Event Register D */
  20 #define Key_EVENTE 0x08         /* Key Event Register E */
  21 #define Key_EVENTF 0x09         /* Key Event Register F */
  22 #define Key_EVENTG 0x0A         /* Key Event Register G */
  23 #define Key_EVENTH 0x0B         /* Key Event Register H */
  24 #define Key_EVENTI 0x0C         /* Key Event Register I */
  25 #define Key_EVENTJ 0x0D         /* Key Event Register J */
  26 #define KP_LCK_TMR 0x0E         /* Keypad Lock1 to Lock2 Timer */
  27 #define UNLOCK1 0x0F            /* Unlock Key1 */
  28 #define UNLOCK2 0x10            /* Unlock Key2 */
  29 #define GPIO_INT_STAT1 0x11     /* GPIO Interrupt Status */
  30 #define GPIO_INT_STAT2 0x12     /* GPIO Interrupt Status */
  31 #define GPIO_INT_STAT3 0x13     /* GPIO Interrupt Status */
  32 #define GPIO_DAT_STAT1 0x14     /* GPIO Data Status, Read twice to clear */
  33 #define GPIO_DAT_STAT2 0x15     /* GPIO Data Status, Read twice to clear */
  34 #define GPIO_DAT_STAT3 0x16     /* GPIO Data Status, Read twice to clear */
  35 #define GPIO_DAT_OUT1 0x17      /* GPIO DATA OUT */
  36 #define GPIO_DAT_OUT2 0x18      /* GPIO DATA OUT */
  37 #define GPIO_DAT_OUT3 0x19      /* GPIO DATA OUT */
  38 #define GPIO_INT_EN1 0x1A       /* GPIO Interrupt Enable */
  39 #define GPIO_INT_EN2 0x1B       /* GPIO Interrupt Enable */
  40 #define GPIO_INT_EN3 0x1C       /* GPIO Interrupt Enable */
  41 #define KP_GPIO1 0x1D           /* Keypad or GPIO Selection */
  42 #define KP_GPIO2 0x1E           /* Keypad or GPIO Selection */
  43 #define KP_GPIO3 0x1F           /* Keypad or GPIO Selection */
  44 #define GPI_EM1 0x20            /* GPI Event Mode 1 */
  45 #define GPI_EM2 0x21            /* GPI Event Mode 2 */
  46 #define GPI_EM3 0x22            /* GPI Event Mode 3 */
  47 #define GPIO_DIR1 0x23          /* GPIO Data Direction */
  48 #define GPIO_DIR2 0x24          /* GPIO Data Direction */
  49 #define GPIO_DIR3 0x25          /* GPIO Data Direction */
  50 #define GPIO_INT_LVL1 0x26      /* GPIO Edge/Level Detect */
  51 #define GPIO_INT_LVL2 0x27      /* GPIO Edge/Level Detect */
  52 #define GPIO_INT_LVL3 0x28      /* GPIO Edge/Level Detect */
  53 #define Debounce_DIS1 0x29      /* Debounce Disable */
  54 #define Debounce_DIS2 0x2A      /* Debounce Disable */
  55 #define Debounce_DIS3 0x2B      /* Debounce Disable */
  56 #define GPIO_PULL1 0x2C         /* GPIO Pull Disable */
  57 #define GPIO_PULL2 0x2D         /* GPIO Pull Disable */
  58 #define GPIO_PULL3 0x2E         /* GPIO Pull Disable */
  59 #define CMP_CFG_STAT 0x30       /* Comparator Configuration and Status Register */
  60 #define CMP_CONFG_SENS1 0x31    /* Sensor1 Comparator Configuration Register */
  61 #define CMP_CONFG_SENS2 0x32    /* L2 Light Sensor Reference Level, Output Falling for Sensor 1 */
  62 #define CMP1_LVL2_TRIP 0x33     /* L2 Light Sensor Hysteresis (Active when Output Rising) for Sensor 1 */
  63 #define CMP1_LVL2_HYS 0x34      /* L3 Light Sensor Reference Level, Output Falling For Sensor 1 */
  64 #define CMP1_LVL3_TRIP 0x35     /* L3 Light Sensor Hysteresis (Active when Output Rising) For Sensor 1 */
  65 #define CMP1_LVL3_HYS 0x36      /* Sensor 2 Comparator Configuration Register */
  66 #define CMP2_LVL2_TRIP 0x37     /* L2 Light Sensor Reference Level, Output Falling for Sensor 2 */
  67 #define CMP2_LVL2_HYS 0x38      /* L2 Light Sensor Hysteresis (Active when Output Rising) for Sensor 2 */
  68 #define CMP2_LVL3_TRIP 0x39     /* L3 Light Sensor Reference Level, Output Falling For Sensor 2 */
  69 #define CMP2_LVL3_HYS 0x3A      /* L3 Light Sensor Hysteresis (Active when Output Rising) For Sensor 2 */
  70 #define CMP1_ADC_DAT_R1 0x3B    /* Comparator 1 ADC data Register1 */
  71 #define CMP1_ADC_DAT_R2 0x3C    /* Comparator 1 ADC data Register2 */
  72 #define CMP2_ADC_DAT_R1 0x3D    /* Comparator 2 ADC data Register1 */
  73 #define CMP2_ADC_DAT_R2 0x3E    /* Comparator 2 ADC data Register2 */
  74
  75 #define ADP5588_DEVICE_ID_MASK  0xF
  76
  77  /* Configuration Register1 */
  78 #define ADP5588_AUTO_INC        (1 << 7)
  79 #define ADP5588_GPIEM_CFG       (1 << 6)
  80 #define ADP5588_INT_CFG         (1 << 4)
  81 #define ADP5588_GPI_IEN         (1 << 1)
  82
  83 /* Interrupt Status Register */
  84 #define ADP5588_GPI_INT         (1 << 1)
  85 #define ADP5588_KE_INT          (1 << 0)
  86
  87 #define ADP5588_MAXGPIO         18
  88 #define ADP5588_BANK(offs)      ((offs) >> 3)
  89 #define ADP5588_BIT(offs)       (1u << ((offs) & 0x7))
  90
  91 /* Put one of these structures in i2c_board_info platform_data */
  92
  93 #define ADP5588_KEYMAPSIZE      80
  94
  95 #define GPI_PIN_ROW0 97
  96 #define GPI_PIN_ROW1 98
  97 #define GPI_PIN_ROW2 99
  98 #define GPI_PIN_ROW3 100
  99 #define GPI_PIN_ROW4 101
 100 #define GPI_PIN_ROW5 102
 101 #define GPI_PIN_ROW6 103
 102 #define GPI_PIN_ROW7 104
 103 #define GPI_PIN_COL0 105
 104 #define GPI_PIN_COL1 106
 105 #define GPI_PIN_COL2 107
 106 #define GPI_PIN_COL3 108
 107 #define GPI_PIN_COL4 109
 108 #define GPI_PIN_COL5 110
 109 #define GPI_PIN_COL6 111
 110 #define GPI_PIN_COL7 112
 111 #define GPI_PIN_COL8 113
 112 #define GPI_PIN_COL9 114
 113
 114 #define GPI_PIN_ROW_BASE GPI_PIN_ROW0
 115 #define GPI_PIN_ROW_END GPI_PIN_ROW7
 116 #define GPI_PIN_COL_BASE GPI_PIN_COL0
 117 #define GPI_PIN_COL_END GPI_PIN_COL9
 118
 119 #define GPI_PIN_BASE GPI_PIN_ROW_BASE
 120 #define GPI_PIN_END GPI_PIN_COL_END
 121
 122 #define ADP5588_GPIMAPSIZE_MAX (GPI_PIN_END - GPI_PIN_BASE + 1)
 123
 124 struct adp5588_gpi_map {
 125         unsigned short pin;
 126         unsigned short sw_evt;
 127 };
 128
 129 struct adp5588_kpad_platform_data {
 130         int rows;                       /* Number of rows */
 131         int cols;                       /* Number of columns */
 132         const unsigned short *keymap;   /* Pointer to keymap */
 133         unsigned short keymapsize;      /* Keymap size */
 134         unsigned repeat:1;              /* Enable key repeat */
 135         unsigned en_keylock:1;          /* Enable Key Lock feature */
 136         unsigned short unlock_key1;     /* Unlock Key 1 */
 137         unsigned short unlock_key2;     /* Unlock Key 2 */
 138         const struct adp5588_gpi_map *gpimap;
 139         unsigned short gpimapsize;
 140         const struct adp5588_gpio_platform_data *gpio_data;
 141 };
 142
 143 struct i2c_client; /* forward declaration */
 144
 145 struct adp5588_gpio_platform_data {
 146         int gpio_start;         /* GPIO Chip base # */
 147         unsigned irq_base;      /* interrupt base # */
 148         unsigned pullup_dis_mask; /* Pull-Up Disable Mask */
 149         int     (*setup)(struct i2c_client *client,
 150                                 int gpio, unsigned ngpio,
 151                                 void *context);
 152         int     (*teardown)(struct i2c_client *client,
 153                                 int gpio, unsigned ngpio,
 154                                 void *context);
 155         void    *context;
 156 };
 157
 158 #endif