dsi_panel.h 7.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright (c) 2016-2020, The Linux Foundation. All rights reserved.
  4. */
  5. #ifndef _DSI_PANEL_H_
  6. #define _DSI_PANEL_H_
  7. #include <linux/of_device.h>
  8. #include <linux/types.h>
  9. #include <linux/bitops.h>
  10. #include <linux/errno.h>
  11. #include <linux/backlight.h>
  12. #include <drm/drm_panel.h>
  13. #include <drm/msm_drm.h>
  14. #include "dsi_defs.h"
  15. #include "dsi_ctrl_hw.h"
  16. #include "dsi_clk.h"
  17. #include "dsi_pwr.h"
  18. #include "dsi_parser.h"
  19. #include "msm_drv.h"
  20. #define MAX_BL_LEVEL 4096
  21. #define MAX_BL_SCALE_LEVEL 1024
  22. #define MAX_SV_BL_SCALE_LEVEL 65535
  23. #define DSI_CMD_PPS_SIZE 135
  24. #define DSI_CMD_PPS_HDR_SIZE 7
  25. #define DSI_MODE_MAX 32
  26. enum dsi_panel_rotation {
  27. DSI_PANEL_ROTATE_NONE = 0,
  28. DSI_PANEL_ROTATE_HV_FLIP,
  29. DSI_PANEL_ROTATE_H_FLIP,
  30. DSI_PANEL_ROTATE_V_FLIP
  31. };
  32. enum dsi_backlight_type {
  33. DSI_BACKLIGHT_PWM = 0,
  34. DSI_BACKLIGHT_WLED,
  35. DSI_BACKLIGHT_DCS,
  36. DSI_BACKLIGHT_EXTERNAL,
  37. DSI_BACKLIGHT_UNKNOWN,
  38. DSI_BACKLIGHT_MAX,
  39. };
  40. enum bl_update_flag {
  41. BL_UPDATE_DELAY_UNTIL_FIRST_FRAME,
  42. BL_UPDATE_NONE,
  43. };
  44. enum {
  45. MODE_GPIO_NOT_VALID = 0,
  46. MODE_SEL_DUAL_PORT,
  47. MODE_SEL_SINGLE_PORT,
  48. MODE_GPIO_HIGH,
  49. MODE_GPIO_LOW,
  50. };
  51. enum dsi_dms_mode {
  52. DSI_DMS_MODE_DISABLED = 0,
  53. DSI_DMS_MODE_RES_SWITCH_IMMEDIATE,
  54. };
  55. enum dsi_panel_physical_type {
  56. DSI_DISPLAY_PANEL_TYPE_LCD = 0,
  57. DSI_DISPLAY_PANEL_TYPE_OLED,
  58. DSI_DISPLAY_PANEL_TYPE_MAX,
  59. };
  60. struct dsi_dfps_capabilities {
  61. enum dsi_dfps_type type;
  62. u32 min_refresh_rate;
  63. u32 max_refresh_rate;
  64. u32 *dfps_list;
  65. u32 dfps_list_len;
  66. bool dfps_support;
  67. };
  68. struct dsi_dyn_clk_caps {
  69. bool dyn_clk_support;
  70. u32 *bit_clk_list;
  71. u32 bit_clk_list_len;
  72. };
  73. struct dsi_pinctrl_info {
  74. struct pinctrl *pinctrl;
  75. struct pinctrl_state *active;
  76. struct pinctrl_state *suspend;
  77. };
  78. struct dsi_panel_phy_props {
  79. u32 panel_width_mm;
  80. u32 panel_height_mm;
  81. enum dsi_panel_rotation rotation;
  82. };
  83. struct dsi_backlight_config {
  84. enum dsi_backlight_type type;
  85. enum bl_update_flag bl_update;
  86. u32 bl_min_level;
  87. u32 bl_max_level;
  88. u32 brightness_max_level;
  89. u32 bl_level;
  90. u32 bl_scale;
  91. u32 bl_scale_sv;
  92. int en_gpio;
  93. /* PWM params */
  94. struct pwm_device *pwm_bl;
  95. bool pwm_enabled;
  96. u32 pwm_period_usecs;
  97. /* WLED params */
  98. struct led_trigger *wled;
  99. struct backlight_device *raw_bd;
  100. };
  101. struct dsi_reset_seq {
  102. u32 level;
  103. u32 sleep_ms;
  104. };
  105. struct dsi_panel_reset_config {
  106. struct dsi_reset_seq *sequence;
  107. u32 count;
  108. int reset_gpio;
  109. int disp_en_gpio;
  110. int lcd_mode_sel_gpio;
  111. u32 mode_sel_state;
  112. };
  113. enum esd_check_status_mode {
  114. ESD_MODE_REG_READ,
  115. ESD_MODE_SW_BTA,
  116. ESD_MODE_PANEL_TE,
  117. ESD_MODE_SW_SIM_SUCCESS,
  118. ESD_MODE_SW_SIM_FAILURE,
  119. ESD_MODE_MAX
  120. };
  121. struct drm_panel_esd_config {
  122. bool esd_enabled;
  123. enum esd_check_status_mode status_mode;
  124. struct dsi_panel_cmd_set status_cmd;
  125. u32 *status_cmds_rlen;
  126. u32 *status_valid_params;
  127. u32 *status_value;
  128. u8 *return_buf;
  129. u8 *status_buf;
  130. u32 groups;
  131. };
  132. struct dsi_panel {
  133. const char *name;
  134. const char *type;
  135. struct device_node *panel_of_node;
  136. struct mipi_dsi_device mipi_device;
  137. struct mutex panel_lock;
  138. struct drm_panel drm_panel;
  139. struct mipi_dsi_host *host;
  140. struct device *parent;
  141. struct dsi_host_common_cfg host_config;
  142. struct dsi_video_engine_cfg video_config;
  143. struct dsi_cmd_engine_cfg cmd_config;
  144. enum dsi_op_mode panel_mode;
  145. bool panel_mode_switch_enabled;
  146. struct dsi_dfps_capabilities dfps_caps;
  147. struct dsi_dyn_clk_caps dyn_clk_caps;
  148. struct dsi_panel_phy_props phy_props;
  149. struct dsi_display_mode *cur_mode;
  150. u32 num_timing_nodes;
  151. u32 num_display_modes;
  152. struct dsi_regulator_info power_info;
  153. struct dsi_backlight_config bl_config;
  154. struct dsi_panel_reset_config reset_config;
  155. struct dsi_pinctrl_info pinctrl;
  156. struct drm_panel_hdr_properties hdr_props;
  157. struct drm_panel_esd_config esd_config;
  158. struct dsi_parser_utils utils;
  159. bool lp11_init;
  160. bool ulps_feature_enabled;
  161. bool ulps_suspend_enabled;
  162. bool allow_phy_power_off;
  163. atomic_t esd_recovery_pending;
  164. bool panel_initialized;
  165. bool te_using_watchdog_timer;
  166. u32 qsync_min_fps;
  167. char dce_pps_cmd[DSI_CMD_PPS_SIZE];
  168. enum dsi_dms_mode dms_mode;
  169. bool sync_broadcast_en;
  170. int panel_test_gpio;
  171. int power_mode;
  172. enum dsi_panel_physical_type panel_type;
  173. };
  174. static inline bool dsi_panel_ulps_feature_enabled(struct dsi_panel *panel)
  175. {
  176. return panel->ulps_feature_enabled;
  177. }
  178. static inline bool dsi_panel_initialized(struct dsi_panel *panel)
  179. {
  180. return panel->panel_initialized;
  181. }
  182. static inline void dsi_panel_acquire_panel_lock(struct dsi_panel *panel)
  183. {
  184. mutex_lock(&panel->panel_lock);
  185. }
  186. static inline void dsi_panel_release_panel_lock(struct dsi_panel *panel)
  187. {
  188. mutex_unlock(&panel->panel_lock);
  189. }
  190. static inline bool dsi_panel_is_type_oled(struct dsi_panel *panel)
  191. {
  192. return (panel->panel_type == DSI_DISPLAY_PANEL_TYPE_OLED);
  193. }
  194. struct dsi_panel *dsi_panel_get(struct device *parent,
  195. struct device_node *of_node,
  196. struct device_node *parser_node,
  197. const char *type,
  198. int topology_override);
  199. int dsi_panel_trigger_esd_attack(struct dsi_panel *panel);
  200. void dsi_panel_put(struct dsi_panel *panel);
  201. int dsi_panel_drv_init(struct dsi_panel *panel, struct mipi_dsi_host *host);
  202. int dsi_panel_drv_deinit(struct dsi_panel *panel);
  203. int dsi_panel_get_mode_count(struct dsi_panel *panel);
  204. void dsi_panel_put_mode(struct dsi_display_mode *mode);
  205. int dsi_panel_get_mode(struct dsi_panel *panel,
  206. u32 index,
  207. struct dsi_display_mode *mode,
  208. int topology_override);
  209. int dsi_panel_validate_mode(struct dsi_panel *panel,
  210. struct dsi_display_mode *mode);
  211. int dsi_panel_get_host_cfg_for_mode(struct dsi_panel *panel,
  212. struct dsi_display_mode *mode,
  213. struct dsi_host_config *config);
  214. int dsi_panel_get_phy_props(struct dsi_panel *panel,
  215. struct dsi_panel_phy_props *phy_props);
  216. int dsi_panel_get_dfps_caps(struct dsi_panel *panel,
  217. struct dsi_dfps_capabilities *dfps_caps);
  218. int dsi_panel_pre_prepare(struct dsi_panel *panel);
  219. int dsi_panel_set_lp1(struct dsi_panel *panel);
  220. int dsi_panel_set_lp2(struct dsi_panel *panel);
  221. int dsi_panel_set_nolp(struct dsi_panel *panel);
  222. int dsi_panel_prepare(struct dsi_panel *panel);
  223. int dsi_panel_enable(struct dsi_panel *panel);
  224. int dsi_panel_post_enable(struct dsi_panel *panel);
  225. int dsi_panel_pre_disable(struct dsi_panel *panel);
  226. int dsi_panel_disable(struct dsi_panel *panel);
  227. int dsi_panel_unprepare(struct dsi_panel *panel);
  228. int dsi_panel_post_unprepare(struct dsi_panel *panel);
  229. int dsi_panel_set_backlight(struct dsi_panel *panel, u32 bl_lvl);
  230. int dsi_panel_update_pps(struct dsi_panel *panel);
  231. int dsi_panel_send_qsync_on_dcs(struct dsi_panel *panel,
  232. int ctrl_idx);
  233. int dsi_panel_send_qsync_off_dcs(struct dsi_panel *panel,
  234. int ctrl_idx);
  235. int dsi_panel_send_roi_dcs(struct dsi_panel *panel, int ctrl_idx,
  236. struct dsi_rect *roi);
  237. int dsi_panel_pre_mode_switch_to_video(struct dsi_panel *panel);
  238. int dsi_panel_pre_mode_switch_to_cmd(struct dsi_panel *panel);
  239. int dsi_panel_mode_switch_to_cmd(struct dsi_panel *panel);
  240. int dsi_panel_mode_switch_to_vid(struct dsi_panel *panel);
  241. int dsi_panel_switch(struct dsi_panel *panel);
  242. int dsi_panel_post_switch(struct dsi_panel *panel);
  243. void dsi_dsc_pclk_param_calc(struct msm_display_dsc_info *dsc, int intf_width);
  244. void dsi_panel_bl_handoff(struct dsi_panel *panel);
  245. struct dsi_panel *dsi_panel_ext_bridge_get(struct device *parent,
  246. struct device_node *of_node,
  247. int topology_override);
  248. int dsi_panel_parse_esd_reg_read_configs(struct dsi_panel *panel);
  249. void dsi_panel_ext_bridge_put(struct dsi_panel *panel);
  250. void dsi_panel_calc_dsi_transfer_time(struct dsi_host_common_cfg *config,
  251. struct dsi_display_mode *mode, u32 frame_threshold_us);
  252. #endif /* _DSI_PANEL_H_ */