raydium_driver.h 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483
  1. /* raydium_driver.h
  2. *
  3. * Raydium TouchScreen driver.
  4. *
  5. * Copyright (c) 2021 Raydium tech Ltd.
  6. *
  7. * This program is free software; you can redistribute it and/or modify
  8. * it under the terms of the GNU General Public License as published by
  9. * the Free Software Foundation; either version 2 of the License, or
  10. * (at your option) any later version.
  11. *
  12. * This program is distributed in the hope that it will be useful,
  13. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15. * GNU General Public License for more details.
  16. *
  17. */
  18. #ifndef __LINUX_RAYDIUM_H
  19. #define __LINUX_RAYDIUM_H
  20. #define RAYDIUM_NAME "raydium_ts"
  21. #define COORDS_ARR_SIZE 4
  22. #define I2C_VTG_MIN_UV 1800000
  23. #define I2C_VTG_MAX_UV 1800000
  24. #ifdef VDD_ANALOG_ENABLE
  25. #define VTG_MIN_UV 2800000
  26. #define VTG_MAX_UV 2800000
  27. #endif
  28. #define RAD_MAIN_VERSION 0x01
  29. #define RAD_MINOR_VERSION 0x01
  30. #define RAD_CUSTOMER_VERSION 0x0100
  31. #if defined(CONFIG_TOUCHSCREEN_RM_TS)
  32. /* IC timing control arguments */
  33. #define RAYDIUM_POWERON_DELAY_USEC 500
  34. #define RAYDIUM_RESET_INTERVAL_MSEC 5
  35. #define RAYDIUM_RESET_RESTORE_USEC 200
  36. #define RAYDIUM_RESET_DELAY_MSEC 100
  37. #define RAYDIUM_RESET_INTERVAL_10MSEC 10
  38. /* I2C bus slave address(ID) */
  39. #define RAYDIUM_I2C_EID (0x5A)
  40. #define RAYDIUM_I2C_NID (0x39)
  41. #define RAYDIUM_I2C_PDA_CMD 0x66
  42. /* I2C R/W configuration literal */
  43. #define RAYDIUM_I2C_WRITE I2C_SMBUS_WRITE
  44. #define RAYDIUM_I2C_READ I2C_SMBUS_READ
  45. #define SYN_I2C_RETRY_TIMES 1
  46. #define MAX_WRITE_PACKET_SIZE 128
  47. #define MAX_READ_PACKET_SIZE 128
  48. /* PDA address and bit definition*/
  49. #define RAD_READ_FT_DATA_CMD 0x2000019C
  50. /* 1byte, disable:0x00 ; enable:0x20*/
  51. #define RAD_GESTURE_STATE_CMD 0x200005F4
  52. #define RAD_GESTURE_DISABLE 0x00
  53. #define RAD_GESTURE_ENABLE 0x20
  54. /* 4bytes, [0]:ready ; [1]:type ; [2]:direction*/
  55. #define RAD_GESTURE_RESULT_CMD 0x200005F0
  56. #define RAD_ENABLE_PDA2 0x04
  57. #define RAD_ENABLE_SI2 0x02
  58. /* PDA literal */
  59. #define MASK_8BIT 0xFF
  60. #define RAD_I2C_PDA_ADDRESS_LENGTH 4
  61. #define PDA_MODE 0x01
  62. #define PDA2_MODE 0x02
  63. #define RAD_I2C_PDA_MODE_DISABLE 0x00
  64. #define RAD_I2C_PDA_MODE_ENABLE 0x80
  65. /* Using byte mode due to data might be not word-aligment */
  66. #define RAD_I2C_PDA_MODE_WORD_MODE 0x40
  67. #define RAD_I2C_PDA_2_MODE_DISABLE 0x20
  68. #define I2C_PDA2_BYTE_MODE 0x03
  69. #define I2C_PDA2_WORD_MODE 0x43
  70. #define RAD_PALM_DISABLE 0x00
  71. #define RAD_PALM_ENABLE 0x01
  72. #define RAD_WAKE_UP 0x02
  73. #define RAYDIUM_TEST_FW 0x80
  74. #define RAYDIUM_TEST_PARA 0x40
  75. #define RAYDIUM_BOOTLOADER 0x20
  76. #define RAYDIUM_FIRMWARE 0x10
  77. #define RAYDIUM_PARA 0x08
  78. #define RAYDIUM_COMP 0x04
  79. #define RAYDIUM_BASELINE 0x02
  80. #define RAYDIUM_INIT 0x01
  81. #define FAIL 0
  82. #define ERROR -1
  83. #define SUCCESS 1
  84. #define DISABLE 0
  85. #define ENABLE 1
  86. /* PDA2 setting */
  87. /* Page 0 ~ Page A */
  88. #define MAX_PAGE_AMOUNT 11
  89. /* PDA2 address and setting definition*/
  90. #define RAYDIUM_PDA2_TCH_RPT_STATUS_ADDR 0x00 /* only in Page 0 */
  91. #define RAYDIUM_PDA2_TCH_RPT_ADDR 0x01 /* only in Page 0 */
  92. #define RAYDIUM_PDA2_HOST_CMD_ADDR 0x02 /* only in Page 0 */
  93. #define RAYDIUM_PDA2_PALM_AREA_ADDR 0x03 /* only in Page 0 */
  94. #define RAYDIUM_PDA2_GESTURE_RPT_ADDR 0x04 /* only in Page 0 */
  95. #define RAYDIUM_PDA2_PALM_STATUS_ADDR 0x05 /* only in Page 0 */
  96. #define RAYDIUM_PDA2_FW_VERSION_ADDR 0x06 /* only in Page 0 */
  97. #define RAYDIUM_PDA2_PANEL_VERSION_ADDR 0x07 /* only in Page 0 */
  98. #define RAYDIUM_PDA2_DISPLAY_INFO_ADDR 0x08 /* only in Page 0 */
  99. #define RAYDIUM_PDA2_PDA_CFG_ADDR 0x09 /* only in Page 0 */
  100. #define RAYDIUM_PDA2_RAWDATA_ADDR 0x0B /* only in Page 0 */
  101. /* Page 0 ~ Page 9 will be directed to Page 0 */
  102. #define RAYDIUM_PDA2_PAGE_ADDR 0x0A
  103. #define RAYDIUM_PDA2_PAGE_0 0x00
  104. /* temporary switch to PDA once */
  105. #define RAYDIUM_PDA2_ENABLE_PDA 0x0A
  106. /* permanently switch to PDA mode */
  107. #define RAYDIUM_PDA2_2_PDA (MAX_PAGE_AMOUNT + 2)
  108. /* Raydium host cmd */
  109. #define RAYDIUM_HOST_CMD_NO_OP 0x00
  110. #define RAYDIUM_HOST_CMD_PWR_SLEEP 0x30
  111. #define RAYDIUM_HOST_CMD_DISPLAY_MODE 0x33
  112. #define RAYDIUM_HOST_CMD_CALIBRATION 0x5C
  113. #define RAYDIUM_HOST_CMD_TP_MODE 0x60
  114. #define RAYDIUM_HOST_CMD_FT_MODE 0x61
  115. /* Raydium Register define */
  116. #define RAYDIUM_PDA_BOOTVERSION 0x00000080
  117. #define RAYDIUM_PDA_FIRMWAREADDR 0x00000800
  118. #define RAYDIUM_PDA_PARAADDR 0x00007B00
  119. #define RAYDIUM_PDA_FIRMWARELENGTH 0x00007300
  120. #define RAYDIUM_PDA_PARALENGTH 0x00000178
  121. #define RAYDIUM_PDA_CRCLENGTH 0x00007474
  122. #define RAYDIUM_PDA_SYNCDATA 0x20000200
  123. #define RAYDIUM_PDA_BOOTENG1 0x20000204
  124. #define RAYDIUM_PDA_BOOTENG2 0x20000208
  125. #define RAYDIUM_PDA_BOOTENG3 0x2000020C
  126. #define RAYDIUM_PDA_BOOTENG4 0x20000210
  127. #define RAYDIUM_PDA_BOOTSTATE 0x20000214
  128. #define RAYDIUM_PDA_BOOTMODE 0x20000218
  129. #define RAYDIUM_PDA_BLKEN 0x40000000
  130. #define RAYDIUM_PDA_BLKRST 0x40000004
  131. #define RAYDIUM_PDA_MISCIER 0x40000014
  132. #define RAYDIUM_PDA_I2CENG 0x50000610
  133. #define RAYDIUM_PDA_FLASHPRO 0x50000624
  134. #define RAYDIUM_PDA_I2CREG 0x50000628
  135. #define RAYDIUM_PDA_PRAMLOCK 0x50000900
  136. #define RAYDIUM_PDA_PRAMTYPE 0x50000904
  137. #define RAYDIUM_PDA_PRAMADDR 0x50000908
  138. #define RAYDIUM_PDA_PRAMLENGTH 0x5000090C
  139. #define RAYDIUM_PDA_FLHADDR 0x50000910
  140. #define RAYDIUM_PDA_FLHCTL 0x50000914
  141. #define RAYDIUM_PDA_BOOTREG 0x50000918
  142. #define RAYDIUM_PDA_FLKEY1 0x50000934
  143. #define RAYDIUM_PDA_FLKEY2 0x50000938
  144. #define RAYDIUM_PDA_FLDATA 0x5000093C
  145. #define RAYDIUM_PDA_PRGCHKSUMENG 0x5000094C
  146. #define RAYDIUM_PDA_PRGCHKSUMADDR 0x50000974
  147. #define RAYDIUM_PDA_PRGCHKSUMRESULT 0x50000978
  148. #define RAYDIUM_CHK_I2C_CMD 0x500009BC
  149. #define RAYDIUM_REG_GPIO_DEGLITCH 0x50000E1C
  150. #define I2CTB_LOCK (0x00000001<<6)
  151. #define BOTLR_LOCK (0x00000001<<5)
  152. #define USEFW_LOCK (0x00000001<<4)
  153. #define CONFIG_LOCK (0x00000001<<3)
  154. #define COMP_LOCK (0x00000001<<2)
  155. #define BASEL_LOCK (0x00000001<<1)
  156. #define INICO_LOCK (0x00000001<<0)
  157. /* ['h5000_0904], [32'h0000_0000], Program RAM store type, PRAM_STORE_TYPE */
  158. #define BOTLR_AREA (0x00000001<<5)
  159. #define USEFW_AREA (0x00000001<<4)
  160. #define CONFIG_AREA (0x00000001<<3)
  161. #define COMP_AREA (0x00000001<<2)
  162. #define BASEL_AREA (0x00000001<<1)
  163. #define INICO_AREA (0x00000001<<0)
  164. /* PDA2 literal */
  165. /* entry byte + target page byte */
  166. #define RAYDIUM_I2C_PDA2_PAGE_LENGTH 2
  167. /* Touch report */
  168. #define MAX_TOUCH_NUM 2
  169. #define MAX_REPORT_PACKET_SIZE 35
  170. #define MAX_TCH_STATUS_PACKET_SIZE 4
  171. #define PRESS_MAX 0xFFFF
  172. #define WIDTH_MAX 0xFFFF
  173. #define BYTE_SHIFT 8
  174. #define TOUCH_PRESS 0
  175. #define TOUCH_RELEASE 1
  176. #define TOUCH_MOVE 2
  177. #define TOUCH_COVER 3
  178. #define TOUCH_SHORTCLICK 4
  179. /* FW update literal */
  180. #define RAYDIUM_FW_BIN_PATH_LENGTH 256
  181. #define RAD_BOOT_3X_SIZE 0x800
  182. #define RAD_INIT_3X_SIZE 0x80
  183. #define RAD_FW_3X_SIZE 0x7300
  184. #define RAD_PARA_3X_SIZE 0x174
  185. #define RAD_TESTFW_3X_SIZE (RAD_FW_3X_SIZE + RAD_PARA_3X_SIZE + 4)
  186. #define RAD_ALLFW_3X_SIZE 0xF170
  187. #define RAD_CMD_UPDATE_BIN 0x80
  188. #define RAD_CMD_UPDATE_END 0x81
  189. #define RAD_CMD_BURN_FINISH 0x82
  190. /* FT APK literal */
  191. #define RAD_HOST_CMD_POS 0x00
  192. #define RAD_FT_CMD_POS 0x01
  193. #define RAD_FT_CMD_LENGTH 0x02
  194. /* FT APK data type */
  195. #define RAYDIUM_FT_UPDATE 0x00
  196. /*Raydium system flag*/
  197. #define INT_FLAG 0x01
  198. #define ENG_MODE 0x02
  199. #define NORMAL_MODE 0x00
  200. /* define display mode */
  201. #define ACTIVE_MODE 0x00
  202. #define AMBIENT_MODE 0x01
  203. #define SLEEP_MODE 0x02
  204. /* Enable sysfs */
  205. #define CONFIG_RM_SYSFS_DEBUG
  206. /* Gesture switch */
  207. #define GESTURE_EN
  208. /* Enable FW update */
  209. #define FW_UPDATE_EN
  210. /* #define FW_MAPPING_EN */
  211. #define MSM_NEW_VER
  212. /* enable ESD */
  213. /* #define ESD_SOLUTION_EN */
  214. #define RAD_SELFTEST
  215. #define PARA_FW_VERSION_OFFSET 4
  216. #define ENABLE_FW_LOADER 1
  217. #define FW_NAME "RM6D030_v0.1.bin"
  218. #define PINCTRL_STATE_ACTIVE "pmx_ts_active"
  219. #define PINCTRL_STATE_SUSPEND "pmx_ts_suspend"
  220. #define PINCTRL_STATE_RELEASE "pmx_ts_release"
  221. /* Power Management Macros Enablement */
  222. #ifndef CONFIG_PM
  223. #define CONFIG_PM
  224. #endif
  225. #ifndef CONFIG_DRM
  226. #define CONFIG_DRM
  227. #endif
  228. #if IS_ENABLED(CONFIG_QCOM_PANEL_EVENT_NOTIFIER)
  229. #define CONFIG_PANEL_NOTIFIER
  230. #endif
  231. #include <linux/device.h>
  232. #include <linux/fb.h>
  233. #include <linux/notifier.h>
  234. #ifdef CONFIG_HAS_EARLYSUSPEND
  235. #include <linux/earlysuspend.h>
  236. #elif defined(CONFIG_DRM) || defined(CONFIG_PANEL_NOTIFIER)
  237. #include <drm/drm_panel.h>
  238. #endif
  239. extern uint32_t slate_ack_resp;
  240. enum raydium_fb_state {
  241. FB_ON,
  242. FB_OFF,
  243. };
  244. struct raydium_ts_data {
  245. unsigned int irq;
  246. unsigned int irq_gpio;
  247. unsigned int rst_gpio;
  248. unsigned int x_max;
  249. unsigned int y_max;
  250. unsigned int x_pos[2];
  251. unsigned int y_pos[2];
  252. unsigned int pressure;
  253. unsigned int is_suspend;
  254. unsigned int is_sleep;
  255. #ifdef GESTURE_EN
  256. unsigned int is_palm;
  257. #endif
  258. unsigned char u8_max_touchs;
  259. struct i2c_client *client;
  260. struct input_dev *input_dev;
  261. struct mutex lock;
  262. struct work_struct work;
  263. struct workqueue_struct *workqueue;
  264. struct irq_desc *irq_desc;
  265. bool irq_enabled;
  266. bool irq_wake;
  267. #if defined(CONFIG_PANEL_NOTIFIER)
  268. struct panel_event_notifier_entry *entry;
  269. int blank;
  270. enum raydium_fb_state fb_state;
  271. #elif defined(CONFIG_FB) || defined(CONFIG_DRM) || defined(CONFIG_PANEL_NOTIFIER)
  272. struct notifier_block fb_notif;
  273. int blank;
  274. enum raydium_fb_state fb_state;
  275. #elif defined(CONFIG_HAS_EARLYSUSPEND)
  276. struct early_suspend early_suspend;
  277. #endif /*end of CONFIG_FB*/
  278. /*struct regulator *vdd;*/
  279. #ifdef VDD_ANALOG_ENABLE
  280. struct regulator *vdd;
  281. #endif
  282. struct regulator *vcc_i2c;
  283. unsigned int fw_version;
  284. unsigned short id;
  285. char *vcc_name;
  286. #ifdef MSM_NEW_VER
  287. struct pinctrl *ts_pinctrl;
  288. struct pinctrl_state *pinctrl_state_active;
  289. struct pinctrl_state *pinctrl_state_suspend;
  290. struct pinctrl_state *pinctrl_state_release;
  291. #endif /*end of MSM_NEW_VER*/
  292. bool touch_offload;
  293. };
  294. struct raydium_platform_data {
  295. char *vdd_name;
  296. int irq_gpio_number;
  297. int reset_gpio_number;
  298. int x_max;
  299. int y_max;
  300. };
  301. struct raydium_ts_platform_data {
  302. char *name;
  303. u32 irqflags;
  304. u32 irq_gpio;
  305. u32 irq_gpio_flags;
  306. u32 reset_gpio;
  307. u32 reset_gpio_flags;
  308. u32 x_max;
  309. u32 y_max;
  310. u32 x_min;
  311. u32 y_min;
  312. u32 hard_rst_dly;
  313. u32 soft_rst_dly;
  314. u32 num_max_touches;
  315. u32 fw_id;
  316. struct drm_panel *active_panel;
  317. };
  318. /* TODO: Using struct+memcpy instead of array+offset*/
  319. enum raydium_pt_report_status {
  320. POS_SEQ = 0,/*1:touch, 0:no touch*/
  321. POS_PT_AMOUNT,
  322. POS_GES_STATUS,
  323. POS_FW_STATE,
  324. };
  325. enum raydium_pt_report_idx {
  326. POS_PT_ID = 0,
  327. POS_X_L,
  328. POS_X_H,
  329. POS_Y_L,
  330. POS_Y_H,
  331. POS_PRESSURE_L,
  332. POS_PRESSURE_H,
  333. POS_WX_L,
  334. POS_WX_H,
  335. POS_WY_L,
  336. POS_WY_H,
  337. LEN_PT = 11
  338. };
  339. enum raydium_log_level {
  340. LOG_NONE = 0,
  341. LOG_ALERT,
  342. LOG_ERR,
  343. LOG_WARNING,
  344. LOG_INFO,
  345. LOG_DEBUG = 5
  346. };
  347. extern int raydium_read_touchdata(unsigned char *tp_status, unsigned char *buf);
  348. extern int raydium_mem_table_setting(void);
  349. extern int wait_fw_state(struct i2c_client *client, unsigned int u32_addr,
  350. unsigned int u32_state, unsigned long u32_delay_us,
  351. unsigned short u16_retry);
  352. extern int wait_irq_state(struct i2c_client *client,
  353. unsigned int u32_retry_time,
  354. unsigned int u32_delay_us);
  355. extern void raydium_irq_control(bool enable);
  356. extern int raydium_i2c_mode_control(struct i2c_client *client,
  357. unsigned char u8_mode);
  358. extern int raydium_i2c_pda_read(struct i2c_client *client,
  359. unsigned int u32_addr, unsigned char *u8_r_data,
  360. unsigned short u16_length);
  361. extern int raydium_i2c_pda_write(struct i2c_client *client,
  362. unsigned int u32_addr, unsigned char *u8_w_data,
  363. unsigned short u16_length);
  364. extern int handle_i2c_pda_write(struct i2c_client *client,
  365. unsigned int u32_addr, unsigned char *u8_w_data,
  366. unsigned short u16_length);
  367. extern int handle_i2c_pda_read(struct i2c_client *client,
  368. unsigned int u32_addr, unsigned char *u8_r_data,
  369. unsigned short u16_length);
  370. extern int raydium_i2c_pda2_read(struct i2c_client *client,
  371. unsigned char u8_addr,
  372. unsigned char *u8_r_data,
  373. unsigned short u16_length);
  374. extern int raydium_i2c_pda2_write(struct i2c_client *client,
  375. unsigned char u8_addr,
  376. unsigned char *u8_w_data,
  377. unsigned short u16_length);
  378. extern int raydium_i2c_pda2_set_page(struct i2c_client *client,
  379. unsigned int is_suspend,
  380. unsigned char u8_page);
  381. extern int raydium_i2c_write_pda_via_pda2(struct i2c_client *client,
  382. unsigned int u32_addr, unsigned char *u8_w_data,
  383. unsigned short u16_length);
  384. extern int raydium_i2c_read_pda_via_pda2(struct i2c_client *client,
  385. unsigned int u32_addr, unsigned char *u8_r_data,
  386. unsigned short u16_length);
  387. extern unsigned char raydium_disable_i2c_deglitch(void);
  388. extern unsigned char raydium_selftest_stop_mcu(struct i2c_client *client);
  389. extern int raydium_burn_comp(struct i2c_client *client);
  390. extern int raydium_burn_fw(struct i2c_client *client);
  391. extern int raydium_load_test_fw(struct i2c_client *client);
  392. extern int raydium_fw_update_init(unsigned short u16_i2c_data);
  393. extern int raydium_fw_update_check(unsigned int u32_check_version);
  394. extern int raydium_i2c_pda_set_address(unsigned int u32_address,
  395. unsigned char u8_mode);
  396. extern void raydium_mem_table_init(unsigned short u16_id);
  397. extern int raydium_id_init(unsigned char u8_type);
  398. #ifdef RAD_SELFTEST
  399. extern int raydium_do_selftest(struct raydium_ts_data *ts);
  400. #endif
  401. int raydium_esd_check(void);
  402. extern struct attribute *raydium_attributes[];
  403. extern const struct attribute_group raydium_attr_group;
  404. extern unsigned char g_u8_raydium_flag;
  405. extern unsigned char g_u8_addr;
  406. extern unsigned char g_u8_i2c_mode;
  407. extern unsigned char g_u8_upgrade_type;
  408. extern unsigned char g_u8_raw_data_type;
  409. extern unsigned int g_u32_raw_data_len; /* 128 bytes*/
  410. extern unsigned int g_u32_length;
  411. extern unsigned long g_u32_addr;
  412. extern unsigned char *g_rad_fw_image, *g_rad_init_image;
  413. extern unsigned char *g_rad_boot_image, *g_rad_para_image;
  414. extern unsigned char *g_rad_testfw_image, *g_rad_testpara_image;
  415. extern unsigned char g_u8_table_setting, g_u8_table_init;
  416. extern unsigned int g_u32_driver_version;
  417. extern unsigned char g_u8_resetflag;
  418. extern struct raydium_ts_data *g_raydium_ts;
  419. extern unsigned char g_u8_log_level;
  420. #define LOGD(a, fmt, ...) {\
  421. if (a <= g_u8_log_level) {\
  422. pr_info(pr_fmt(fmt), ##__VA_ARGS__);\
  423. } \
  424. }
  425. #endif
  426. #endif /*__LINUX_RAYDIUM_H*/