dsi_display.h 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright (c) 2015-2020, The Linux Foundation. All rights reserved.
  4. */
  5. #ifndef _DSI_DISPLAY_H_
  6. #define _DSI_DISPLAY_H_
  7. #include <linux/types.h>
  8. #include <linux/bitops.h>
  9. #include <linux/debugfs.h>
  10. #include <linux/of_device.h>
  11. #include <linux/firmware.h>
  12. #include <drm/drmP.h>
  13. #include <drm/drm_crtc.h>
  14. #include "msm_drv.h"
  15. #include "dsi_defs.h"
  16. #include "dsi_ctrl.h"
  17. #include "dsi_phy.h"
  18. #include "dsi_panel.h"
  19. #define MAX_DSI_CTRLS_PER_DISPLAY 2
  20. #define DSI_CLIENT_NAME_SIZE 20
  21. #define MAX_CMDLINE_PARAM_LEN 512
  22. #define MAX_CMD_PAYLOAD_SIZE 256
  23. /*
  24. * DSI Validate Mode modifiers
  25. * @DSI_VALIDATE_FLAG_ALLOW_ADJUST: Allow mode validation to also do fixup
  26. */
  27. #define DSI_VALIDATE_FLAG_ALLOW_ADJUST 0x1
  28. /**
  29. * enum dsi_display_selection_type - enumerates DSI display selection types
  30. * @DSI_PRIMARY: primary DSI display selected from module parameter
  31. * @DSI_SECONDARY: Secondary DSI display selected from module parameter
  32. * @MAX_DSI_ACTIVE_DISPLAY: Maximum acive displays that can be selected
  33. */
  34. enum dsi_display_selection_type {
  35. DSI_PRIMARY = 0,
  36. DSI_SECONDARY,
  37. MAX_DSI_ACTIVE_DISPLAY,
  38. };
  39. /**
  40. * enum dsi_display_type - enumerates DSI display types
  41. * @DSI_DISPLAY_SINGLE: A panel connected on a single DSI interface.
  42. * @DSI_DISPLAY_EXT_BRIDGE: A bridge is connected between panel and DSI host.
  43. * It utilizes a single DSI interface.
  44. * @DSI_DISPLAY_SPLIT: A panel that utilizes more than one DSI
  45. * interfaces.
  46. * @DSI_DISPLAY_SPLIT_EXT_BRIDGE: A bridge is present between panel and DSI
  47. * host. It utilizes more than one DSI interface.
  48. */
  49. enum dsi_display_type {
  50. DSI_DISPLAY_SINGLE = 0,
  51. DSI_DISPLAY_EXT_BRIDGE,
  52. DSI_DISPLAY_SPLIT,
  53. DSI_DISPLAY_SPLIT_EXT_BRIDGE,
  54. DSI_DISPLAY_MAX,
  55. };
  56. /**
  57. * struct dsi_display_ctrl - dsi ctrl/phy information for the display
  58. * @ctrl: Handle to the DSI controller device.
  59. * @ctrl_of_node: pHandle to the DSI controller device.
  60. * @dsi_ctrl_idx: DSI controller instance id.
  61. * @power_state: Current power state of the DSI controller.
  62. * @phy: Handle to the DSI PHY device.
  63. * @phy_of_node: pHandle to the DSI PHY device.
  64. * @phy_enabled: PHY power status.
  65. */
  66. struct dsi_display_ctrl {
  67. /* controller info */
  68. struct dsi_ctrl *ctrl;
  69. struct device_node *ctrl_of_node;
  70. u32 dsi_ctrl_idx;
  71. enum dsi_power_state power_state;
  72. /* phy info */
  73. struct msm_dsi_phy *phy;
  74. struct device_node *phy_of_node;
  75. bool phy_enabled;
  76. };
  77. /**
  78. * struct dsi_display_boot_param - defines DSI boot display selection
  79. * @name:Name of DSI display selected as a boot param.
  80. * @boot_disp_en:bool to indicate dtsi availability of display node
  81. * @is_primary:bool to indicate whether current display is primary display
  82. * @length:length of DSI display.
  83. * @cmdline_topology: Display topology shared from kernel command line.
  84. */
  85. struct dsi_display_boot_param {
  86. char name[MAX_CMDLINE_PARAM_LEN];
  87. char *boot_param;
  88. bool boot_disp_en;
  89. int length;
  90. struct device_node *node;
  91. int cmdline_topology;
  92. void *disp;
  93. };
  94. /**
  95. * struct dsi_display_clk_info - dsi display clock source information
  96. * @src_clks: Source clocks for DSI display.
  97. * @mux_clks: Mux clocks used for DFPS.
  98. * @shadow_clks: Used for D-phy clock switch.
  99. * @shadow_cphy_clks: Used for C-phy clock switch.
  100. */
  101. struct dsi_display_clk_info {
  102. struct dsi_clk_link_set src_clks;
  103. struct dsi_clk_link_set mux_clks;
  104. struct dsi_clk_link_set cphy_clks;
  105. struct dsi_clk_link_set shadow_clks;
  106. struct dsi_clk_link_set shadow_cphy_clks;
  107. };
  108. /**
  109. * struct dsi_display_ext_bridge - dsi display external bridge information
  110. * @display: Pointer of DSI display.
  111. * @node_of: Bridge node created from bridge driver.
  112. * @bridge: Bridge created from bridge driver
  113. * @orig_funcs: Bridge function from bridge driver (split mode only)
  114. * @bridge_funcs: Overridden function from bridge driver (split mode only)
  115. */
  116. struct dsi_display_ext_bridge {
  117. void *display;
  118. struct device_node *node_of;
  119. struct drm_bridge *bridge;
  120. const struct drm_bridge_funcs *orig_funcs;
  121. struct drm_bridge_funcs bridge_funcs;
  122. };
  123. /**
  124. * struct dsi_display - dsi display information
  125. * @pdev: Pointer to platform device.
  126. * @drm_dev: DRM device associated with the display.
  127. * @drm_conn: Pointer to DRM connector associated with the display
  128. * @ext_conn: Pointer to external connector attached to DSI connector
  129. * @name: Name of the display.
  130. * @display_type: Display type as defined in device tree.
  131. * @list: List pointer.
  132. * @is_active: Is display active.
  133. * @is_cont_splash_enabled: Is continuous splash enabled
  134. * @sw_te_using_wd: Is software te enabled
  135. * @display_lock: Mutex for dsi_display interface.
  136. * @disp_te_gpio: GPIO for panel TE interrupt.
  137. * @is_te_irq_enabled:bool to specify whether TE interrupt is enabled.
  138. * @esd_te_gate: completion gate to signal TE interrupt.
  139. * @ctrl_count: Number of DSI interfaces required by panel.
  140. * @ctrl: Controller information for DSI display.
  141. * @panel: Handle to DSI panel.
  142. * @panel_node: pHandle to DSI panel actually in use.
  143. * @ext_bridge: External bridge information for DSI display.
  144. * @ext_bridge_cnt: Number of external bridges
  145. * @modes: Array of probed DSI modes
  146. * @type: DSI display type.
  147. * @clk_master_idx: The master controller for controlling clocks. This is an
  148. * index into the ctrl[MAX_DSI_CTRLS_PER_DISPLAY] array.
  149. * @cmd_master_idx: The master controller for sending DSI commands to panel.
  150. * @video_master_idx: The master controller for enabling video engine.
  151. * @cached_clk_rate: The cached DSI clock rate set dynamically by sysfs.
  152. * @clkrate_change_pending: Flag indicating the pending DSI clock re-enabling.
  153. * @clock_info: Clock sourcing for DSI display.
  154. * @config: DSI host configuration information.
  155. * @lane_map: Lane mapping between DSI host and Panel.
  156. * @cmdline_topology: Display topology shared from kernel command line.
  157. * @cmdline_timing: Display timing shared from kernel command line.
  158. * @is_tpg_enabled: TPG state.
  159. * @poms_pending; Flag indicating the pending panel operating mode switch.
  160. * @ulps_enabled: ulps state.
  161. * @clamp_enabled: clamp state.
  162. * @phy_idle_power_off: PHY power state.
  163. * @host: DRM MIPI DSI Host.
  164. * @bridge: Pointer to DRM bridge object.
  165. * @cmd_engine_refcount: Reference count enforcing single instance of cmd eng
  166. * @clk_mngr: DSI clock manager.
  167. * @dsi_clk_handle: DSI clock handle.
  168. * @mdp_clk_handle: MDP clock handle.
  169. * @root: Debugfs root directory
  170. * @misr_enable Frame MISR enable/disable
  171. * @misr_frame_count Number of frames to accumulate the MISR value
  172. * @esd_trigger field indicating ESD trigger through debugfs
  173. * @poms_te_work POMS delayed work for disabling panel TE
  174. * @te_source vsync source pin information
  175. * @clk_gating_config Clocks for which clock gating needs to be enabled
  176. * @queue_cmd_waits Indicates if wait for dma commands done has to be queued.
  177. * @dma_cmd_workq: Pointer to the workqueue of DMA command transfer done
  178. * wait sequence.
  179. * @is_active: status of the display
  180. * @trusted_vm_env: Set to true, it the executing VM is Trusted VM.
  181. * Set to false, otherwise.
  182. */
  183. struct dsi_display {
  184. struct platform_device *pdev;
  185. struct drm_device *drm_dev;
  186. struct drm_connector *drm_conn;
  187. struct drm_connector *ext_conn;
  188. const char *name;
  189. const char *display_type;
  190. struct list_head list;
  191. bool is_cont_splash_enabled;
  192. bool sw_te_using_wd;
  193. struct mutex display_lock;
  194. int disp_te_gpio;
  195. bool is_te_irq_enabled;
  196. struct completion esd_te_gate;
  197. u32 ctrl_count;
  198. struct dsi_display_ctrl ctrl[MAX_DSI_CTRLS_PER_DISPLAY];
  199. /* panel info */
  200. struct dsi_panel *panel;
  201. struct device_node *panel_node;
  202. struct device_node *parser_node;
  203. /* external bridge */
  204. struct dsi_display_ext_bridge ext_bridge[MAX_DSI_CTRLS_PER_DISPLAY];
  205. u32 ext_bridge_cnt;
  206. struct dsi_display_mode *modes;
  207. enum dsi_display_type type;
  208. u32 clk_master_idx;
  209. u32 cmd_master_idx;
  210. u32 video_master_idx;
  211. /* dynamic DSI clock info*/
  212. u32 cached_clk_rate;
  213. atomic_t clkrate_change_pending;
  214. struct dsi_display_clk_info clock_info;
  215. struct dsi_host_config config;
  216. struct dsi_lane_map lane_map;
  217. int cmdline_topology;
  218. int cmdline_timing;
  219. bool is_tpg_enabled;
  220. bool poms_pending;
  221. bool ulps_enabled;
  222. bool clamp_enabled;
  223. bool phy_idle_power_off;
  224. struct drm_gem_object *tx_cmd_buf;
  225. u32 cmd_buffer_size;
  226. u64 cmd_buffer_iova;
  227. void *vaddr;
  228. struct msm_gem_address_space *aspace;
  229. struct mipi_dsi_host host;
  230. struct dsi_bridge *bridge;
  231. u32 cmd_engine_refcount;
  232. void *clk_mngr;
  233. void *dsi_clk_handle;
  234. void *mdp_clk_handle;
  235. /* DEBUG FS */
  236. struct dentry *root;
  237. bool misr_enable;
  238. u32 misr_frame_count;
  239. u32 esd_trigger;
  240. /* multiple dsi error handlers */
  241. struct workqueue_struct *err_workq;
  242. struct work_struct fifo_underflow_work;
  243. struct work_struct fifo_overflow_work;
  244. struct work_struct lp_rx_timeout_work;
  245. /* panel te delayed work */
  246. struct delayed_work poms_te_work;
  247. /* firmware panel data */
  248. const struct firmware *fw;
  249. void *parser;
  250. struct dsi_display_boot_param *boot_disp;
  251. u32 te_source;
  252. u32 clk_gating_config;
  253. bool queue_cmd_waits;
  254. struct workqueue_struct *dma_cmd_workq;
  255. /* panel id of the display */
  256. u64 panel_id;
  257. bool is_active;
  258. bool trusted_vm_env;
  259. };
  260. int dsi_display_dev_probe(struct platform_device *pdev);
  261. int dsi_display_dev_remove(struct platform_device *pdev);
  262. /**
  263. * dsi_display_get_num_of_displays() - returns number of display devices
  264. * supported.
  265. *
  266. * Return: number of displays.
  267. */
  268. int dsi_display_get_num_of_displays(void);
  269. /**
  270. * dsi_display_get_active_displays - returns pointers for active display devices
  271. * @display_array: Pointer to display array to be filled
  272. * @max_display_count: Size of display_array
  273. * @Returns: Number of display entries filled
  274. */
  275. int dsi_display_get_active_displays(void **display_array,
  276. u32 max_display_count);
  277. /**
  278. * dsi_display_get_display_by_name()- finds display by name
  279. * @name: name of the display.
  280. *
  281. * Return: handle to the display or error code.
  282. */
  283. struct dsi_display *dsi_display_get_display_by_name(const char *name);
  284. /**
  285. * dsi_display_set_active_state() - sets the state of the display
  286. * @display: Handle to display.
  287. * @is_active: state
  288. */
  289. void dsi_display_set_active_state(struct dsi_display *display, bool is_active);
  290. /**
  291. * dsi_display_drm_bridge_init() - initializes DRM bridge object for DSI
  292. * @display: Handle to the display.
  293. * @encoder: Pointer to the encoder object which is connected to the
  294. * display.
  295. *
  296. * Return: error code.
  297. */
  298. int dsi_display_drm_bridge_init(struct dsi_display *display,
  299. struct drm_encoder *enc);
  300. /**
  301. * dsi_display_drm_bridge_deinit() - destroys DRM bridge for the display
  302. * @display: Handle to the display.
  303. *
  304. * Return: error code.
  305. */
  306. int dsi_display_drm_bridge_deinit(struct dsi_display *display);
  307. /**
  308. * dsi_display_drm_ext_bridge_init() - initializes DRM bridge for ext bridge
  309. * @display: Handle to the display.
  310. * @enc: Pointer to the encoder object which is connected to the
  311. * display.
  312. * @connector: Pointer to the connector object which is connected to
  313. * the display.
  314. *
  315. * Return: error code.
  316. */
  317. int dsi_display_drm_ext_bridge_init(struct dsi_display *display,
  318. struct drm_encoder *enc, struct drm_connector *connector);
  319. /**
  320. * dsi_display_get_info() - returns the display properties
  321. * @connector: Pointer to drm connector structure
  322. * @info: Pointer to the structure where info is stored.
  323. * @disp: Handle to the display.
  324. *
  325. * Return: error code.
  326. */
  327. int dsi_display_get_info(struct drm_connector *connector,
  328. struct msm_display_info *info, void *disp);
  329. /**
  330. * dsi_display_get_mode_count() - get number of modes supported by the display
  331. * @display: Handle to display.
  332. * @count: Number of modes supported
  333. *
  334. * Return: error code.
  335. */
  336. int dsi_display_get_mode_count(struct dsi_display *display, u32 *count);
  337. /**
  338. * dsi_display_get_modes() - get modes supported by display
  339. * @display: Handle to display.
  340. * @modes; Output param, list of DSI modes. Number of modes matches
  341. * count got from display->panel->num_display_modes;
  342. *
  343. * Return: error code.
  344. */
  345. int dsi_display_get_modes(struct dsi_display *display,
  346. struct dsi_display_mode **modes);
  347. /**
  348. * dsi_display_put_mode() - free up mode created for the display
  349. * @display: Handle to display.
  350. * @mode: Display mode to be freed up
  351. *
  352. * Return: error code.
  353. */
  354. void dsi_display_put_mode(struct dsi_display *display,
  355. struct dsi_display_mode *mode);
  356. /**
  357. * dsi_display_get_default_lms() - retrieve max number of lms used
  358. * for dsi display by traversing through all topologies
  359. * @display: Handle to display.
  360. * @num_lm: Number of LMs used
  361. *
  362. * Return: error code.
  363. */
  364. int dsi_display_get_default_lms(void *dsi_display, u32 *num_lm);
  365. /**
  366. * dsi_display_find_mode() - retrieve cached DSI mode given relevant params
  367. * @display: Handle to display.
  368. * @cmp: Mode to use as comparison to find original
  369. * @out_mode: Output parameter, pointer to retrieved mode
  370. *
  371. * Return: error code.
  372. */
  373. int dsi_display_find_mode(struct dsi_display *display,
  374. const struct dsi_display_mode *cmp,
  375. struct dsi_display_mode **out_mode);
  376. /**
  377. * dsi_display_validate_mode() - validates if mode is supported by display
  378. * @display: Handle to display.
  379. * @mode: Mode to be validated.
  380. * @flags: Modifier flags.
  381. *
  382. * Return: 0 if supported or error code.
  383. */
  384. int dsi_display_validate_mode(struct dsi_display *display,
  385. struct dsi_display_mode *mode,
  386. u32 flags);
  387. /**
  388. * dsi_display_validate_mode_change() - validates mode if variable refresh case
  389. * or dynamic clk change case
  390. * @display: Handle to display.
  391. * @mode: Mode to be validated..
  392. *
  393. * Return: 0 if error code.
  394. */
  395. int dsi_display_validate_mode_change(struct dsi_display *display,
  396. struct dsi_display_mode *cur_dsi_mode,
  397. struct dsi_display_mode *mode);
  398. /**
  399. * dsi_display_set_mode() - Set mode on the display.
  400. * @display: Handle to display.
  401. * @mode: mode to be set.
  402. * @flags: Modifier flags.
  403. *
  404. * Return: error code.
  405. */
  406. int dsi_display_set_mode(struct dsi_display *display,
  407. struct dsi_display_mode *mode,
  408. u32 flags);
  409. /**
  410. * dsi_display_prepare() - prepare display
  411. * @display: Handle to display.
  412. *
  413. * Prepare will perform power up sequences for the host and panel hardware.
  414. * Power and clock resources might be turned on (depending on the panel mode).
  415. * The video engine is not enabled.
  416. *
  417. * Return: error code.
  418. */
  419. int dsi_display_prepare(struct dsi_display *display);
  420. /**
  421. * dsi_display_splash_res_cleanup() - cleanup for continuous splash
  422. * @display: Pointer to dsi display
  423. * Returns: Zero on success
  424. */
  425. int dsi_display_splash_res_cleanup(struct dsi_display *display);
  426. /**
  427. * dsi_display_config_ctrl_for_cont_splash()- Enable engine modes for DSI
  428. * controller during continuous splash
  429. * @display: Handle to DSI display
  430. *
  431. * Return: returns error code
  432. */
  433. int dsi_display_config_ctrl_for_cont_splash(struct dsi_display *display);
  434. /**
  435. * dsi_display_enable() - enable display
  436. * @display: Handle to display.
  437. *
  438. * Enable will turn on the host engine and the panel. At the end of the enable
  439. * function, Host and panel hardware are ready to accept pixel data from
  440. * upstream.
  441. *
  442. * Return: error code.
  443. */
  444. int dsi_display_enable(struct dsi_display *display);
  445. /**
  446. * dsi_display_post_enable() - perform post enable operations.
  447. * @display: Handle to display.
  448. *
  449. * Some panels might require some commands to be sent after pixel data
  450. * transmission has started. Such commands are sent as part of the post_enable
  451. * function.
  452. *
  453. * Return: error code.
  454. */
  455. int dsi_display_post_enable(struct dsi_display *display);
  456. /**
  457. * dsi_display_pre_disable() - perform pre disable operations.
  458. * @display: Handle to display.
  459. *
  460. * If a panel requires commands to be sent before pixel data transmission is
  461. * stopped, those can be sent as part of pre_disable.
  462. *
  463. * Return: error code.
  464. */
  465. int dsi_display_pre_disable(struct dsi_display *display);
  466. /**
  467. * dsi_display_disable() - disable panel and host hardware.
  468. * @display: Handle to display.
  469. *
  470. * Disable host and panel hardware and pixel data transmission can not continue.
  471. *
  472. * Return: error code.
  473. */
  474. int dsi_display_disable(struct dsi_display *display);
  475. /**
  476. * dsi_pre_clkoff_cb() - Callback before clock is turned off
  477. * @priv: private data pointer.
  478. * @clk_type: clock which is being turned on.
  479. * @l_type: specifies if the clock is HS or LP type. Valid only for link clocks.
  480. * @new_state: next state for the clock.
  481. *
  482. * @return: error code.
  483. */
  484. int dsi_pre_clkoff_cb(void *priv, enum dsi_clk_type clk_type,
  485. enum dsi_lclk_type l_type,
  486. enum dsi_clk_state new_state);
  487. /**
  488. * dsi_display_update_pps() - update PPS buffer.
  489. * @pps_cmd: PPS buffer.
  490. * @display: Handle to display.
  491. *
  492. * Copies new PPS buffer into display structure.
  493. *
  494. * Return: error code.
  495. */
  496. int dsi_display_update_pps(char *pps_cmd, void *display);
  497. /**
  498. * dsi_post_clkoff_cb() - Callback after clock is turned off
  499. * @priv: private data pointer.
  500. * @clk_type: clock which is being turned on.
  501. * @l_type: specifies if the clock is HS or LP type. Valid only for link clocks.
  502. * @curr_state: current state for the clock.
  503. *
  504. * @return: error code.
  505. */
  506. int dsi_post_clkoff_cb(void *priv, enum dsi_clk_type clk_type,
  507. enum dsi_lclk_type l_type,
  508. enum dsi_clk_state curr_state);
  509. /**
  510. * dsi_post_clkon_cb() - Callback after clock is turned on
  511. * @priv: private data pointer.
  512. * @clk_type: clock which is being turned on.
  513. * @l_type: specifies if the clock is HS or LP type. Valid only for link clocks.
  514. * @curr_state: current state for the clock.
  515. *
  516. * @return: error code.
  517. */
  518. int dsi_post_clkon_cb(void *priv, enum dsi_clk_type clk_type,
  519. enum dsi_lclk_type l_type,
  520. enum dsi_clk_state curr_state);
  521. /**
  522. * dsi_pre_clkon_cb() - Callback before clock is turned on
  523. * @priv: private data pointer.
  524. * @clk_type: clock which is being turned on.
  525. * @l_type: specifies if the clock is HS or LP type. Valid only for link clocks.
  526. * @new_state: next state for the clock.
  527. *
  528. * @return: error code.
  529. */
  530. int dsi_pre_clkon_cb(void *priv, enum dsi_clk_type clk_type,
  531. enum dsi_lclk_type l_type,
  532. enum dsi_clk_state new_state);
  533. /**
  534. * dsi_display_unprepare() - power off display hardware.
  535. * @display: Handle to display.
  536. *
  537. * Host and panel hardware is turned off. Panel will be in reset state at the
  538. * end of the function.
  539. *
  540. * Return: error code.
  541. */
  542. int dsi_display_unprepare(struct dsi_display *display);
  543. int dsi_display_set_tpg_state(struct dsi_display *display, bool enable);
  544. int dsi_display_clock_gate(struct dsi_display *display, bool enable);
  545. int dsi_dispaly_static_frame(struct dsi_display *display, bool enable);
  546. /**
  547. * dsi_display_get_drm_panel() - get drm_panel from display.
  548. * @display: Handle to display.
  549. * Get drm_panel which was inclued in dsi_display's dsi_panel.
  550. *
  551. * Return: drm_panel/NULL.
  552. */
  553. struct drm_panel *dsi_display_get_drm_panel(struct dsi_display *display);
  554. /**
  555. * dsi_display_enable_event() - enable interrupt based connector event
  556. * @connector: Pointer to drm connector structure
  557. * @display: Handle to display.
  558. * @event_idx: Event index.
  559. * @event_info: Event callback definition.
  560. * @enable: Whether to enable/disable the event interrupt.
  561. */
  562. void dsi_display_enable_event(struct drm_connector *connector,
  563. struct dsi_display *display,
  564. uint32_t event_idx, struct dsi_event_cb_info *event_info,
  565. bool enable);
  566. /**
  567. * dsi_display_set_backlight() - set backlight
  568. * @connector: Pointer to drm connector structure
  569. * @display: Handle to display.
  570. * @bl_lvl: Backlight level.
  571. * @event_info: Event callback definition.
  572. * @enable: Whether to enable/disable the event interrupt.
  573. */
  574. int dsi_display_set_backlight(struct drm_connector *connector,
  575. void *display, u32 bl_lvl);
  576. /**
  577. * dsi_display_check_status() - check if panel is dead or alive
  578. * @connector: Pointer to drm connector structure
  579. * @display: Handle to display.
  580. * @te_check_override: Whether check for TE from panel or default check
  581. */
  582. int dsi_display_check_status(struct drm_connector *connector, void *display,
  583. bool te_check_override);
  584. /**
  585. * dsi_display_cmd_transfer() - transfer command to the panel
  586. * @connector: Pointer to drm connector structure
  587. * @display: Handle to display.
  588. * @cmd_buf: Command buffer
  589. * @cmd_buf_len: Command buffer length in bytes
  590. */
  591. int dsi_display_cmd_transfer(struct drm_connector *connector,
  592. void *display, const char *cmd_buffer,
  593. u32 cmd_buf_len);
  594. /**
  595. * dsi_display_cmd_receive() - receive response from the panel
  596. * @display: Handle to display.
  597. * @cmd_buf: Command buffer
  598. * @cmd_buf_len: Command buffer length in bytes
  599. * @recv_buf: Receive buffer
  600. * @recv_buf_len: Receive buffer length in bytes
  601. */
  602. int dsi_display_cmd_receive(void *display, const char *cmd_buf,
  603. u32 cmd_buf_len, u8 *recv_buf, u32 recv_buf_len);
  604. /**
  605. * dsi_display_soft_reset() - perform a soft reset on DSI controller
  606. * @display: Handle to display
  607. *
  608. * The video, command and controller engines will be disabled before the
  609. * reset is triggered. After, the engines will be re-enabled to the same state
  610. * as before the reset.
  611. *
  612. * If the reset is done while MDP timing engine is turned on, the video
  613. * engine should be re-enabled only during the vertical blanking time.
  614. *
  615. * Return: error code
  616. */
  617. int dsi_display_soft_reset(void *display);
  618. /**
  619. * dsi_display_set_power - update power/dpms setting
  620. * @connector: Pointer to drm connector structure
  621. * @power_mode: One of the following,
  622. * SDE_MODE_DPMS_ON
  623. * SDE_MODE_DPMS_LP1
  624. * SDE_MODE_DPMS_LP2
  625. * SDE_MODE_DPMS_STANDBY
  626. * SDE_MODE_DPMS_SUSPEND
  627. * SDE_MODE_DPMS_OFF
  628. * @display: Pointer to private display structure
  629. * Returns: Zero on success
  630. */
  631. int dsi_display_set_power(struct drm_connector *connector,
  632. int power_mode, void *display);
  633. /*
  634. * dsi_display_pre_kickoff - program kickoff-time features
  635. * @connector: Pointer to drm connector structure
  636. * @display: Pointer to private display structure
  637. * @params: Parameters for kickoff-time programming
  638. * Returns: Zero on success
  639. */
  640. int dsi_display_pre_kickoff(struct drm_connector *connector,
  641. struct dsi_display *display,
  642. struct msm_display_kickoff_params *params);
  643. /*
  644. * dsi_display_pre_commit - program pre commit features
  645. * @display: Pointer to private display structure
  646. * @params: Parameters for pre commit time programming
  647. * Returns: Zero on success
  648. */
  649. int dsi_display_pre_commit(void *display,
  650. struct msm_display_conn_params *params);
  651. /**
  652. * dsi_display_get_dst_format() - get dst_format from DSI display
  653. * @connector: Pointer to drm connector structure
  654. * @display: Handle to display
  655. *
  656. * Return: enum dsi_pixel_format type
  657. */
  658. enum dsi_pixel_format dsi_display_get_dst_format(
  659. struct drm_connector *connector,
  660. void *display);
  661. /**
  662. * dsi_display_cont_splash_config() - initialize splash resources
  663. * @display: Handle to display
  664. *
  665. * Return: Zero on Success
  666. */
  667. int dsi_display_cont_splash_config(void *display);
  668. /**
  669. * dsi_display_cont_splash_res_disable() - Disable resource votes added in probe
  670. * @display: Pointer to dsi display
  671. * Returns: Zero on success
  672. */
  673. int dsi_display_cont_splash_res_disable(void *display);
  674. /*
  675. * dsi_display_get_panel_vfp - get panel vsync
  676. * @display: Pointer to private display structure
  677. * @h_active: width
  678. * @v_active: height
  679. * Returns: v_front_porch on success error code on failure
  680. */
  681. int dsi_display_get_panel_vfp(void *display,
  682. int h_active, int v_active);
  683. /**
  684. * dsi_display_dump_clks_state() - dump clocks state to console
  685. * @display: Handle to display
  686. *
  687. * Return: Zero on Success
  688. */
  689. int dsi_display_dump_clks_state(struct dsi_display *display);
  690. #endif /* _DSI_DISPLAY_H_ */