ti_am335x_tscadc.h 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * TI Touch Screen / ADC MFD driver
  4. *
  5. * Copyright (C) 2012 Texas Instruments Incorporated - https://www.ti.com/
  6. */
  7. #ifndef __LINUX_TI_AM335X_TSCADC_MFD_H
  8. #define __LINUX_TI_AM335X_TSCADC_MFD_H
  9. #include <linux/bitfield.h>
  10. #include <linux/mfd/core.h>
  11. #include <linux/units.h>
  12. #define REG_RAWIRQSTATUS 0x024
  13. #define REG_IRQSTATUS 0x028
  14. #define REG_IRQENABLE 0x02C
  15. #define REG_IRQCLR 0x030
  16. #define REG_IRQWAKEUP 0x034
  17. #define REG_DMAENABLE_SET 0x038
  18. #define REG_DMAENABLE_CLEAR 0x03c
  19. #define REG_CTRL 0x040
  20. #define REG_ADCFSM 0x044
  21. #define REG_CLKDIV 0x04C
  22. #define REG_SE 0x054
  23. #define REG_IDLECONFIG 0x058
  24. #define REG_CHARGECONFIG 0x05C
  25. #define REG_CHARGEDELAY 0x060
  26. #define REG_STEPCONFIG(n) (0x64 + ((n) * 8))
  27. #define REG_STEPDELAY(n) (0x68 + ((n) * 8))
  28. #define REG_FIFO0CNT 0xE4
  29. #define REG_FIFO0THR 0xE8
  30. #define REG_FIFO1CNT 0xF0
  31. #define REG_FIFO1THR 0xF4
  32. #define REG_DMA1REQ 0xF8
  33. #define REG_FIFO0 0x100
  34. #define REG_FIFO1 0x200
  35. /* Register Bitfields */
  36. /* IRQ wakeup enable */
  37. #define IRQWKUP_ENB BIT(0)
  38. /* IRQ enable */
  39. #define IRQENB_HW_PEN BIT(0)
  40. #define IRQENB_EOS BIT(1)
  41. #define IRQENB_FIFO0THRES BIT(2)
  42. #define IRQENB_FIFO0OVRRUN BIT(3)
  43. #define IRQENB_FIFO0UNDRFLW BIT(4)
  44. #define IRQENB_FIFO1THRES BIT(5)
  45. #define IRQENB_FIFO1OVRRUN BIT(6)
  46. #define IRQENB_FIFO1UNDRFLW BIT(7)
  47. #define IRQENB_PENUP BIT(9)
  48. /* Step Configuration */
  49. #define STEPCONFIG_MODE(val) FIELD_PREP(GENMASK(1, 0), (val))
  50. #define STEPCONFIG_MODE_SWCNT STEPCONFIG_MODE(1)
  51. #define STEPCONFIG_MODE_HWSYNC STEPCONFIG_MODE(2)
  52. #define STEPCONFIG_AVG(val) FIELD_PREP(GENMASK(4, 2), (val))
  53. #define STEPCONFIG_AVG_16 STEPCONFIG_AVG(4)
  54. #define STEPCONFIG_XPP BIT(5)
  55. #define STEPCONFIG_XNN BIT(6)
  56. #define STEPCONFIG_YPP BIT(7)
  57. #define STEPCONFIG_YNN BIT(8)
  58. #define STEPCONFIG_XNP BIT(9)
  59. #define STEPCONFIG_YPN BIT(10)
  60. #define STEPCONFIG_RFP(val) FIELD_PREP(GENMASK(13, 12), (val))
  61. #define STEPCONFIG_RFP_VREFP STEPCONFIG_RFP(3)
  62. #define STEPCONFIG_INM(val) FIELD_PREP(GENMASK(18, 15), (val))
  63. #define STEPCONFIG_INM_ADCREFM STEPCONFIG_INM(8)
  64. #define STEPCONFIG_INP(val) FIELD_PREP(GENMASK(22, 19), (val))
  65. #define STEPCONFIG_INP_AN4 STEPCONFIG_INP(4)
  66. #define STEPCONFIG_INP_ADCREFM STEPCONFIG_INP(8)
  67. #define STEPCONFIG_FIFO1 BIT(26)
  68. #define STEPCONFIG_RFM(val) FIELD_PREP(GENMASK(24, 23), (val))
  69. #define STEPCONFIG_RFM_VREFN STEPCONFIG_RFM(3)
  70. /* Delay register */
  71. #define STEPDELAY_OPEN(val) FIELD_PREP(GENMASK(17, 0), (val))
  72. #define STEPCONFIG_OPENDLY STEPDELAY_OPEN(0x098)
  73. #define STEPCONFIG_MAX_OPENDLY GENMASK(17, 0)
  74. #define STEPDELAY_SAMPLE(val) FIELD_PREP(GENMASK(31, 24), (val))
  75. #define STEPCONFIG_SAMPLEDLY STEPDELAY_SAMPLE(0)
  76. #define STEPCONFIG_MAX_SAMPLE GENMASK(7, 0)
  77. /* Charge Config */
  78. #define STEPCHARGE_RFP(val) FIELD_PREP(GENMASK(14, 12), (val))
  79. #define STEPCHARGE_RFP_XPUL STEPCHARGE_RFP(1)
  80. #define STEPCHARGE_INM(val) FIELD_PREP(GENMASK(18, 15), (val))
  81. #define STEPCHARGE_INM_AN1 STEPCHARGE_INM(1)
  82. #define STEPCHARGE_INP(val) FIELD_PREP(GENMASK(22, 19), (val))
  83. #define STEPCHARGE_RFM(val) FIELD_PREP(GENMASK(24, 23), (val))
  84. #define STEPCHARGE_RFM_XNUR STEPCHARGE_RFM(1)
  85. /* Charge delay */
  86. #define CHARGEDLY_OPEN(val) FIELD_PREP(GENMASK(17, 0), (val))
  87. #define CHARGEDLY_OPENDLY CHARGEDLY_OPEN(0x400)
  88. /* Control register */
  89. #define CNTRLREG_SSENB BIT(0)
  90. #define CNTRLREG_STEPID BIT(1)
  91. #define CNTRLREG_TSC_STEPCONFIGWRT BIT(2)
  92. #define CNTRLREG_POWERDOWN BIT(4)
  93. #define CNTRLREG_TSC_AFE_CTRL(val) FIELD_PREP(GENMASK(6, 5), (val))
  94. #define CNTRLREG_TSC_4WIRE CNTRLREG_TSC_AFE_CTRL(1)
  95. #define CNTRLREG_TSC_5WIRE CNTRLREG_TSC_AFE_CTRL(2)
  96. #define CNTRLREG_TSC_ENB BIT(7)
  97. /*Control registers bitfields for MAGADC IP */
  98. #define CNTRLREG_MAGADCENB BIT(0)
  99. #define CNTRLREG_MAG_PREAMP_PWRDOWN BIT(5)
  100. #define CNTRLREG_MAG_PREAMP_BYPASS BIT(6)
  101. /* FIFO READ Register */
  102. #define FIFOREAD_DATA_MASK GENMASK(11, 0)
  103. #define FIFOREAD_CHNLID_MASK GENMASK(19, 16)
  104. /* DMA ENABLE/CLEAR Register */
  105. #define DMA_FIFO0 BIT(0)
  106. #define DMA_FIFO1 BIT(1)
  107. /* Sequencer Status */
  108. #define SEQ_STATUS BIT(5)
  109. #define CHARGE_STEP 0x11
  110. #define TSC_ADC_CLK (3 * HZ_PER_MHZ)
  111. #define MAG_ADC_CLK (13 * HZ_PER_MHZ)
  112. #define TOTAL_STEPS 16
  113. #define TOTAL_CHANNELS 8
  114. #define FIFO1_THRESHOLD 19
  115. /*
  116. * time in us for processing a single channel, calculated as follows:
  117. *
  118. * max num cycles = open delay + (sample delay + conv time) * averaging
  119. *
  120. * max num cycles: 262143 + (255 + 13) * 16 = 266431
  121. *
  122. * clock frequency: 26MHz / 8 = 3.25MHz
  123. * clock period: 1 / 3.25MHz = 308ns
  124. *
  125. * max processing time: 266431 * 308ns = 83ms(approx)
  126. */
  127. #define IDLE_TIMEOUT_MS 83 /* milliseconds */
  128. #define TSCADC_CELLS 2
  129. struct ti_tscadc_data {
  130. char *adc_feature_name;
  131. char *adc_feature_compatible;
  132. char *secondary_feature_name;
  133. char *secondary_feature_compatible;
  134. unsigned int target_clk_rate;
  135. };
  136. struct ti_tscadc_dev {
  137. struct device *dev;
  138. struct regmap *regmap;
  139. void __iomem *tscadc_base;
  140. phys_addr_t tscadc_phys_base;
  141. const struct ti_tscadc_data *data;
  142. int irq;
  143. struct mfd_cell cells[TSCADC_CELLS];
  144. u32 ctrl;
  145. u32 reg_se_cache;
  146. bool adc_waiting;
  147. bool adc_in_use;
  148. wait_queue_head_t reg_se_wait;
  149. spinlock_t reg_lock;
  150. unsigned int clk_div;
  151. /* tsc device */
  152. struct titsc *tsc;
  153. /* adc device */
  154. struct adc_device *adc;
  155. };
  156. static inline struct ti_tscadc_dev *ti_tscadc_dev_get(struct platform_device *p)
  157. {
  158. struct ti_tscadc_dev **tscadc_dev = p->dev.platform_data;
  159. return *tscadc_dev;
  160. }
  161. static inline bool ti_adc_with_touchscreen(struct ti_tscadc_dev *tscadc)
  162. {
  163. return of_device_is_compatible(tscadc->dev->of_node,
  164. "ti,am3359-tscadc");
  165. }
  166. void am335x_tsc_se_set_cache(struct ti_tscadc_dev *tsadc, u32 val);
  167. void am335x_tsc_se_set_once(struct ti_tscadc_dev *tsadc, u32 val);
  168. void am335x_tsc_se_clr(struct ti_tscadc_dev *tsadc, u32 val);
  169. void am335x_tsc_se_adc_done(struct ti_tscadc_dev *tsadc);
  170. #endif