rmi_driver.h 4.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright (c) 2011-2016 Synaptics Incorporated
  4. * Copyright (c) 2011 Unixphere
  5. */
  6. #ifndef _RMI_DRIVER_H
  7. #define _RMI_DRIVER_H
  8. #include <linux/ctype.h>
  9. #include <linux/hrtimer.h>
  10. #include <linux/ktime.h>
  11. #include <linux/input.h>
  12. #include "rmi_bus.h"
  13. #define SYNAPTICS_INPUT_DEVICE_NAME "Synaptics RMI4 Touch Sensor"
  14. #define SYNAPTICS_VENDOR_ID 0x06cb
  15. #define GROUP(_attrs) { \
  16. .attrs = _attrs, \
  17. }
  18. #define PDT_PROPERTIES_LOCATION 0x00EF
  19. #define BSR_LOCATION 0x00FE
  20. #define RMI_PDT_PROPS_HAS_BSR 0x02
  21. #define NAME_BUFFER_SIZE 256
  22. #define RMI_PDT_ENTRY_SIZE 6
  23. #define RMI_PDT_FUNCTION_VERSION_MASK 0x60
  24. #define RMI_PDT_INT_SOURCE_COUNT_MASK 0x07
  25. #define PDT_START_SCAN_LOCATION 0x00e9
  26. #define PDT_END_SCAN_LOCATION 0x0005
  27. #define RMI4_END_OF_PDT(id) ((id) == 0x00 || (id) == 0xff)
  28. struct pdt_entry {
  29. u16 page_start;
  30. u8 query_base_addr;
  31. u8 command_base_addr;
  32. u8 control_base_addr;
  33. u8 data_base_addr;
  34. u8 interrupt_source_count;
  35. u8 function_version;
  36. u8 function_number;
  37. };
  38. #define RMI_REG_DESC_PRESENSE_BITS (32 * BITS_PER_BYTE)
  39. #define RMI_REG_DESC_SUBPACKET_BITS (37 * BITS_PER_BYTE)
  40. /* describes a single packet register */
  41. struct rmi_register_desc_item {
  42. u16 reg;
  43. unsigned long reg_size;
  44. u8 num_subpackets;
  45. unsigned long subpacket_map[BITS_TO_LONGS(
  46. RMI_REG_DESC_SUBPACKET_BITS)];
  47. };
  48. /*
  49. * describes the packet registers for a particular type
  50. * (ie query, control, data)
  51. */
  52. struct rmi_register_descriptor {
  53. unsigned long struct_size;
  54. unsigned long presense_map[BITS_TO_LONGS(RMI_REG_DESC_PRESENSE_BITS)];
  55. u8 num_registers;
  56. struct rmi_register_desc_item *registers;
  57. };
  58. int rmi_read_register_desc(struct rmi_device *d, u16 addr,
  59. struct rmi_register_descriptor *rdesc);
  60. const struct rmi_register_desc_item *rmi_get_register_desc_item(
  61. struct rmi_register_descriptor *rdesc, u16 reg);
  62. /*
  63. * Calculate the total size of all of the registers described in the
  64. * descriptor.
  65. */
  66. size_t rmi_register_desc_calc_size(struct rmi_register_descriptor *rdesc);
  67. int rmi_register_desc_calc_reg_offset(
  68. struct rmi_register_descriptor *rdesc, u16 reg);
  69. bool rmi_register_desc_has_subpacket(const struct rmi_register_desc_item *item,
  70. u8 subpacket);
  71. bool rmi_is_physical_driver(struct device_driver *);
  72. int rmi_register_physical_driver(void);
  73. void rmi_unregister_physical_driver(void);
  74. void rmi_free_function_list(struct rmi_device *rmi_dev);
  75. struct rmi_function *rmi_find_function(struct rmi_device *rmi_dev, u8 number);
  76. int rmi_enable_sensor(struct rmi_device *rmi_dev);
  77. int rmi_scan_pdt(struct rmi_device *rmi_dev, void *ctx,
  78. int (*callback)(struct rmi_device *rmi_dev, void *ctx,
  79. const struct pdt_entry *entry));
  80. int rmi_probe_interrupts(struct rmi_driver_data *data);
  81. void rmi_enable_irq(struct rmi_device *rmi_dev, bool clear_wake);
  82. void rmi_disable_irq(struct rmi_device *rmi_dev, bool enable_wake);
  83. int rmi_init_functions(struct rmi_driver_data *data);
  84. int rmi_initial_reset(struct rmi_device *rmi_dev, void *ctx,
  85. const struct pdt_entry *pdt);
  86. const char *rmi_f01_get_product_ID(struct rmi_function *fn);
  87. #ifdef CONFIG_RMI4_F03
  88. int rmi_f03_overwrite_button(struct rmi_function *fn, unsigned int button,
  89. int value);
  90. void rmi_f03_commit_buttons(struct rmi_function *fn);
  91. #else
  92. static inline int rmi_f03_overwrite_button(struct rmi_function *fn,
  93. unsigned int button, int value)
  94. {
  95. return 0;
  96. }
  97. static inline void rmi_f03_commit_buttons(struct rmi_function *fn) {}
  98. #endif
  99. #ifdef CONFIG_RMI4_F34
  100. int rmi_f34_create_sysfs(struct rmi_device *rmi_dev);
  101. void rmi_f34_remove_sysfs(struct rmi_device *rmi_dev);
  102. #else
  103. static inline int rmi_f34_create_sysfs(struct rmi_device *rmi_dev)
  104. {
  105. return 0;
  106. }
  107. static inline void rmi_f34_remove_sysfs(struct rmi_device *rmi_dev)
  108. {
  109. }
  110. #endif /* CONFIG_RMI_F34 */
  111. extern struct rmi_function_handler rmi_f01_handler;
  112. extern struct rmi_function_handler rmi_f03_handler;
  113. extern struct rmi_function_handler rmi_f11_handler;
  114. extern struct rmi_function_handler rmi_f12_handler;
  115. extern struct rmi_function_handler rmi_f30_handler;
  116. extern struct rmi_function_handler rmi_f34_handler;
  117. extern struct rmi_function_handler rmi_f3a_handler;
  118. extern struct rmi_function_handler rmi_f54_handler;
  119. extern struct rmi_function_handler rmi_f55_handler;
  120. #endif