1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Copyright (C) ST-Ericsson SA 2010
4 *
5 * Author: Rabin Vincent <rabin.vincent@stericsson.com> for ST-Ericsson
6 */
7
8#ifndef __STMPE_H
9#define __STMPE_H
10
11#include <linux/device.h>
12#include <linux/mfd/core.h>
13#include <linux/mfd/stmpe.h>
14#include <linux/printk.h>
15#include <linux/types.h>
16
17extern const struct dev_pm_ops stmpe_dev_pm_ops;
18
19#ifdef STMPE_DUMP_BYTES
20static inline void stmpe_dump_bytes(const char *str, const void *buf,
21 size_t len)
22{
23 print_hex_dump_bytes(str, DUMP_PREFIX_OFFSET, buf, len);
24}
25#else
26static inline void stmpe_dump_bytes(const char *str, const void *buf,
27 size_t len)
28{
29}
30#endif
31
32/**
33 * struct stmpe_variant_block - information about block
34 * @cell: base mfd cell
35 * @irq: interrupt number to be added to each IORESOURCE_IRQ
36 * in the cell
37 * @block: block id; used for identification with platform data and for
38 * enable and altfunc callbacks
39 */
40struct stmpe_variant_block {
41 const struct mfd_cell *cell;
42 int irq;
43 enum stmpe_block block;
44};
45
46/**
47 * struct stmpe_variant_info - variant-specific information
48 * @name: part name
49 * @id_val: content of CHIPID register
50 * @id_mask: bits valid in CHIPID register for comparison with id_val
51 * @num_gpios: number of GPIOS
52 * @af_bits: number of bits used to specify the alternate function
53 * @regs: variant specific registers.
54 * @blocks: list of blocks present on this device
55 * @num_blocks: number of blocks present on this device
56 * @num_irqs: number of internal IRQs available on this device
57 * @enable: callback to enable the specified blocks.
58 * Called with the I/O lock held.
59 * @get_altfunc: callback to get the alternate function number for the
60 * specific block
61 * @enable_autosleep: callback to configure autosleep with specified timeout
62 */
63struct stmpe_variant_info {
64 const char *name;
65 u16 id_val;
66 u16 id_mask;
67 int num_gpios;
68 int af_bits;
69 const u8 *regs;
70 struct stmpe_variant_block *blocks;
71 int num_blocks;
72 int num_irqs;
73 int (*enable)(struct stmpe *stmpe, unsigned int blocks, bool enable);
74 int (*get_altfunc)(struct stmpe *stmpe, enum stmpe_block block);
75 int (*enable_autosleep)(struct stmpe *stmpe, int autosleep_timeout);
76};
77
78/**
79 * struct stmpe_client_info - i2c or spi specific routines/info
80 * @data: client specific data
81 * @read_byte: read single byte
82 * @write_byte: write single byte
83 * @read_block: read block or multiple bytes
84 * @write_block: write block or multiple bytes
85 * @init: client init routine, called during probe
86 */
87struct stmpe_client_info {
88 void *data;
89 int irq;
90 void *client;
91 struct device *dev;
92 int (*read_byte)(struct stmpe *stmpe, u8 reg);
93 int (*write_byte)(struct stmpe *stmpe, u8 reg, u8 val);
94 int (*read_block)(struct stmpe *stmpe, u8 reg, u8 len, u8 *values);
95 int (*write_block)(struct stmpe *stmpe, u8 reg, u8 len,
96 const u8 *values);
97 void (*init)(struct stmpe *stmpe);
98};
99
100int stmpe_probe(struct stmpe_client_info *ci, enum stmpe_partnum partnum);
101void stmpe_remove(struct stmpe *stmpe);
102
103#define STMPE_ICR_LSB_HIGH (1 << 2)
104#define STMPE_ICR_LSB_EDGE (1 << 1)
105#define STMPE_ICR_LSB_GIM (1 << 0)
106
107#define STMPE_SYS_CTRL_RESET (1 << 7)
108#define STMPE_SYS_CTRL_INT_EN (1 << 2)
109#define STMPE_SYS_CTRL_INT_HI (1 << 0)
110
111/*
112 * STMPE801
113 */
114#define STMPE801_ID 0x0108
115#define STMPE801_NR_INTERNAL_IRQS 1
116
117#define STMPE801_REG_CHIP_ID 0x00
118#define STMPE801_REG_VERSION_ID 0x02
119#define STMPE801_REG_SYS_CTRL 0x04
120#define STMPE801_REG_GPIO_INT_EN 0x08
121#define STMPE801_REG_GPIO_INT_STA 0x09
122#define STMPE801_REG_GPIO_MP_STA 0x10
123#define STMPE801_REG_GPIO_SET_PIN 0x11
124#define STMPE801_REG_GPIO_DIR 0x12
125
126/*
127 * STMPE811
128 */
129#define STMPE811_ID 0x0811
130
131#define STMPE811_IRQ_TOUCH_DET 0
132#define STMPE811_IRQ_FIFO_TH 1
133#define STMPE811_IRQ_FIFO_OFLOW 2
134#define STMPE811_IRQ_FIFO_FULL 3
135#define STMPE811_IRQ_FIFO_EMPTY 4
136#define STMPE811_IRQ_TEMP_SENS 5
137#define STMPE811_IRQ_ADC 6
138#define STMPE811_IRQ_GPIOC 7
139#define STMPE811_NR_INTERNAL_IRQS 8
140
141#define STMPE811_REG_CHIP_ID 0x00
142#define STMPE811_REG_SYS_CTRL 0x03
143#define STMPE811_REG_SYS_CTRL2 0x04
144#define STMPE811_REG_SPI_CFG 0x08
145#define STMPE811_REG_INT_CTRL 0x09
146#define STMPE811_REG_INT_EN 0x0A
147#define STMPE811_REG_INT_STA 0x0B
148#define STMPE811_REG_GPIO_INT_EN 0x0C
149#define STMPE811_REG_GPIO_INT_STA 0x0D
150#define STMPE811_REG_GPIO_SET_PIN 0x10
151#define STMPE811_REG_GPIO_CLR_PIN 0x11
152#define STMPE811_REG_GPIO_MP_STA 0x12
153#define STMPE811_REG_GPIO_DIR 0x13
154#define STMPE811_REG_GPIO_ED 0x14
155#define STMPE811_REG_GPIO_RE 0x15
156#define STMPE811_REG_GPIO_FE 0x16
157#define STMPE811_REG_GPIO_AF 0x17
158
159#define STMPE811_SYS_CTRL_RESET (1 << 1)
160
161#define STMPE811_SYS_CTRL2_ADC_OFF (1 << 0)
162#define STMPE811_SYS_CTRL2_TSC_OFF (1 << 1)
163#define STMPE811_SYS_CTRL2_GPIO_OFF (1 << 2)
164#define STMPE811_SYS_CTRL2_TS_OFF (1 << 3)
165
166/*
167 * STMPE1600
168 */
169#define STMPE1600_ID 0x0016
170#define STMPE1600_NR_INTERNAL_IRQS 16
171
172#define STMPE1600_REG_CHIP_ID 0x00
173#define STMPE1600_REG_SYS_CTRL 0x03
174#define STMPE1600_REG_IEGPIOR_LSB 0x08
175#define STMPE1600_REG_IEGPIOR_MSB 0x09
176#define STMPE1600_REG_ISGPIOR_LSB 0x0A
177#define STMPE1600_REG_ISGPIOR_MSB 0x0B
178#define STMPE1600_REG_GPMR_LSB 0x10
179#define STMPE1600_REG_GPMR_MSB 0x11
180#define STMPE1600_REG_GPSR_LSB 0x12
181#define STMPE1600_REG_GPSR_MSB 0x13
182#define STMPE1600_REG_GPDR_LSB 0x14
183#define STMPE1600_REG_GPDR_MSB 0x15
184#define STMPE1600_REG_GPPIR_LSB 0x16
185#define STMPE1600_REG_GPPIR_MSB 0x17
186
187/*
188 * STMPE1601
189 */
190
191#define STMPE1601_IRQ_GPIOC 8
192#define STMPE1601_IRQ_PWM3 7
193#define STMPE1601_IRQ_PWM2 6
194#define STMPE1601_IRQ_PWM1 5
195#define STMPE1601_IRQ_PWM0 4
196#define STMPE1601_IRQ_KEYPAD_OVER 2
197#define STMPE1601_IRQ_KEYPAD 1
198#define STMPE1601_IRQ_WAKEUP 0
199#define STMPE1601_NR_INTERNAL_IRQS 9
200
201#define STMPE1601_REG_SYS_CTRL 0x02
202#define STMPE1601_REG_SYS_CTRL2 0x03
203#define STMPE1601_REG_ICR_MSB 0x10
204#define STMPE1601_REG_ICR_LSB 0x11
205#define STMPE1601_REG_IER_MSB 0x12
206#define STMPE1601_REG_IER_LSB 0x13
207#define STMPE1601_REG_ISR_MSB 0x14
208#define STMPE1601_REG_ISR_LSB 0x15
209#define STMPE1601_REG_INT_EN_GPIO_MASK_MSB 0x16
210#define STMPE1601_REG_INT_EN_GPIO_MASK_LSB 0x17
211#define STMPE1601_REG_INT_STA_GPIO_MSB 0x18
212#define STMPE1601_REG_INT_STA_GPIO_LSB 0x19
213#define STMPE1601_REG_CHIP_ID 0x80
214#define STMPE1601_REG_GPIO_SET_MSB 0x82
215#define STMPE1601_REG_GPIO_SET_LSB 0x83
216#define STMPE1601_REG_GPIO_CLR_MSB 0x84
217#define STMPE1601_REG_GPIO_CLR_LSB 0x85
218#define STMPE1601_REG_GPIO_MP_MSB 0x86
219#define STMPE1601_REG_GPIO_MP_LSB 0x87
220#define STMPE1601_REG_GPIO_SET_DIR_MSB 0x88
221#define STMPE1601_REG_GPIO_SET_DIR_LSB 0x89
222#define STMPE1601_REG_GPIO_ED_MSB 0x8A
223#define STMPE1601_REG_GPIO_ED_LSB 0x8B
224#define STMPE1601_REG_GPIO_RE_MSB 0x8C
225#define STMPE1601_REG_GPIO_RE_LSB 0x8D
226#define STMPE1601_REG_GPIO_FE_MSB 0x8E
227#define STMPE1601_REG_GPIO_FE_LSB 0x8F
228#define STMPE1601_REG_GPIO_PU_MSB 0x90
229#define STMPE1601_REG_GPIO_PU_LSB 0x91
230#define STMPE1601_REG_GPIO_AF_U_MSB 0x92
231
232#define STMPE1601_SYS_CTRL_ENABLE_GPIO (1 << 3)
233#define STMPE1601_SYS_CTRL_ENABLE_KPC (1 << 1)
234#define STMPE1601_SYS_CTRL_ENABLE_SPWM (1 << 0)
235
236/* The 1601/2403 share the same masks */
237#define STMPE1601_AUTOSLEEP_TIMEOUT_MASK (0x7)
238#define STPME1601_AUTOSLEEP_ENABLE (1 << 3)
239
240/*
241 * STMPE1801
242 */
243#define STMPE1801_ID 0xc110
244#define STMPE1801_NR_INTERNAL_IRQS 5
245#define STMPE1801_IRQ_KEYPAD_COMBI 4
246#define STMPE1801_IRQ_GPIOC 3
247#define STMPE1801_IRQ_KEYPAD_OVER 2
248#define STMPE1801_IRQ_KEYPAD 1
249#define STMPE1801_IRQ_WAKEUP 0
250
251#define STMPE1801_REG_CHIP_ID 0x00
252#define STMPE1801_REG_SYS_CTRL 0x02
253#define STMPE1801_REG_INT_CTRL_LOW 0x04
254#define STMPE1801_REG_INT_EN_MASK_LOW 0x06
255#define STMPE1801_REG_INT_STA_LOW 0x08
256#define STMPE1801_REG_INT_EN_GPIO_MASK_LOW 0x0A
257#define STMPE1801_REG_INT_EN_GPIO_MASK_MID 0x0B
258#define STMPE1801_REG_INT_EN_GPIO_MASK_HIGH 0x0C
259#define STMPE1801_REG_INT_STA_GPIO_LOW 0x0D
260#define STMPE1801_REG_INT_STA_GPIO_MID 0x0E
261#define STMPE1801_REG_INT_STA_GPIO_HIGH 0x0F
262#define STMPE1801_REG_GPIO_SET_LOW 0x10
263#define STMPE1801_REG_GPIO_SET_MID 0x11
264#define STMPE1801_REG_GPIO_SET_HIGH 0x12
265#define STMPE1801_REG_GPIO_CLR_LOW 0x13
266#define STMPE1801_REG_GPIO_CLR_MID 0x14
267#define STMPE1801_REG_GPIO_CLR_HIGH 0x15
268#define STMPE1801_REG_GPIO_MP_LOW 0x16
269#define STMPE1801_REG_GPIO_MP_MID 0x17
270#define STMPE1801_REG_GPIO_MP_HIGH 0x18
271#define STMPE1801_REG_GPIO_SET_DIR_LOW 0x19
272#define STMPE1801_REG_GPIO_SET_DIR_MID 0x1A
273#define STMPE1801_REG_GPIO_SET_DIR_HIGH 0x1B
274#define STMPE1801_REG_GPIO_RE_LOW 0x1C
275#define STMPE1801_REG_GPIO_RE_MID 0x1D
276#define STMPE1801_REG_GPIO_RE_HIGH 0x1E
277#define STMPE1801_REG_GPIO_FE_LOW 0x1F
278#define STMPE1801_REG_GPIO_FE_MID 0x20
279#define STMPE1801_REG_GPIO_FE_HIGH 0x21
280#define STMPE1801_REG_GPIO_PULL_UP_LOW 0x22
281#define STMPE1801_REG_GPIO_PULL_UP_MID 0x23
282#define STMPE1801_REG_GPIO_PULL_UP_HIGH 0x24
283
284#define STMPE1801_MSK_INT_EN_KPC (1 << 1)
285#define STMPE1801_MSK_INT_EN_GPIO (1 << 3)
286
287/*
288 * STMPE24xx
289 */
290
291#define STMPE24XX_IRQ_GPIOC 8
292#define STMPE24XX_IRQ_PWM2 7
293#define STMPE24XX_IRQ_PWM1 6
294#define STMPE24XX_IRQ_PWM0 5
295#define STMPE24XX_IRQ_ROT_OVER 4
296#define STMPE24XX_IRQ_ROT 3
297#define STMPE24XX_IRQ_KEYPAD_OVER 2
298#define STMPE24XX_IRQ_KEYPAD 1
299#define STMPE24XX_IRQ_WAKEUP 0
300#define STMPE24XX_NR_INTERNAL_IRQS 9
301
302#define STMPE24XX_REG_SYS_CTRL 0x02
303#define STMPE24XX_REG_SYS_CTRL2 0x03
304#define STMPE24XX_REG_ICR_MSB 0x10
305#define STMPE24XX_REG_ICR_LSB 0x11
306#define STMPE24XX_REG_IER_MSB 0x12
307#define STMPE24XX_REG_IER_LSB 0x13
308#define STMPE24XX_REG_ISR_MSB 0x14
309#define STMPE24XX_REG_ISR_LSB 0x15
310#define STMPE24XX_REG_IEGPIOR_MSB 0x16
311#define STMPE24XX_REG_IEGPIOR_CSB 0x17
312#define STMPE24XX_REG_IEGPIOR_LSB 0x18
313#define STMPE24XX_REG_ISGPIOR_MSB 0x19
314#define STMPE24XX_REG_ISGPIOR_CSB 0x1A
315#define STMPE24XX_REG_ISGPIOR_LSB 0x1B
316#define STMPE24XX_REG_CHIP_ID 0x80
317#define STMPE24XX_REG_GPSR_MSB 0x83
318#define STMPE24XX_REG_GPSR_CSB 0x84
319#define STMPE24XX_REG_GPSR_LSB 0x85
320#define STMPE24XX_REG_GPCR_MSB 0x86
321#define STMPE24XX_REG_GPCR_CSB 0x87
322#define STMPE24XX_REG_GPCR_LSB 0x88
323#define STMPE24XX_REG_GPDR_MSB 0x89
324#define STMPE24XX_REG_GPDR_CSB 0x8A
325#define STMPE24XX_REG_GPDR_LSB 0x8B
326#define STMPE24XX_REG_GPEDR_MSB 0x8C
327#define STMPE24XX_REG_GPEDR_CSB 0x8D
328#define STMPE24XX_REG_GPEDR_LSB 0x8E
329#define STMPE24XX_REG_GPRER_MSB 0x8F
330#define STMPE24XX_REG_GPRER_CSB 0x90
331#define STMPE24XX_REG_GPRER_LSB 0x91
332#define STMPE24XX_REG_GPFER_MSB 0x92
333#define STMPE24XX_REG_GPFER_CSB 0x93
334#define STMPE24XX_REG_GPFER_LSB 0x94
335#define STMPE24XX_REG_GPPUR_MSB 0x95
336#define STMPE24XX_REG_GPPUR_CSB 0x96
337#define STMPE24XX_REG_GPPUR_LSB 0x97
338#define STMPE24XX_REG_GPPDR_MSB 0x98
339#define STMPE24XX_REG_GPPDR_CSB 0x99
340#define STMPE24XX_REG_GPPDR_LSB 0x9A
341#define STMPE24XX_REG_GPAFR_U_MSB 0x9B
342#define STMPE24XX_REG_GPMR_MSB 0xA2
343#define STMPE24XX_REG_GPMR_CSB 0xA3
344#define STMPE24XX_REG_GPMR_LSB 0xA4
345#define STMPE24XX_SYS_CTRL_ENABLE_GPIO (1 << 3)
346#define STMPE24XX_SYSCON_ENABLE_PWM (1 << 2)
347#define STMPE24XX_SYS_CTRL_ENABLE_KPC (1 << 1)
348#define STMPE24XX_SYSCON_ENABLE_ROT (1 << 0)
349
350#endif
351

source code of linux/drivers/mfd/stmpe.h