dsi_display.h 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771
  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. * @esd_fail_count Count of continuous ESD check failures
  175. * @te_source vsync source pin information
  176. * @clk_gating_config Clocks for which clock gating needs to be enabled
  177. * @queue_cmd_waits Indicates if wait for dma commands done has to be queued.
  178. * @dma_cmd_workq: Pointer to the workqueue of DMA command transfer done
  179. * wait sequence.
  180. * @is_active: status of the display
  181. * @trusted_vm_env: Set to true, it the executing VM is Trusted VM.
  182. * Set to false, otherwise.
  183. */
  184. struct dsi_display {
  185. struct platform_device *pdev;
  186. struct drm_device *drm_dev;
  187. struct drm_connector *drm_conn;
  188. struct drm_connector *ext_conn;
  189. const char *name;
  190. const char *display_type;
  191. struct list_head list;
  192. bool is_cont_splash_enabled;
  193. bool sw_te_using_wd;
  194. struct mutex display_lock;
  195. int disp_te_gpio;
  196. bool is_te_irq_enabled;
  197. struct completion esd_te_gate;
  198. u32 ctrl_count;
  199. struct dsi_display_ctrl ctrl[MAX_DSI_CTRLS_PER_DISPLAY];
  200. /* panel info */
  201. struct dsi_panel *panel;
  202. struct device_node *panel_node;
  203. struct device_node *parser_node;
  204. /* external bridge */
  205. struct dsi_display_ext_bridge ext_bridge[MAX_DSI_CTRLS_PER_DISPLAY];
  206. u32 ext_bridge_cnt;
  207. struct dsi_display_mode *modes;
  208. enum dsi_display_type type;
  209. u32 clk_master_idx;
  210. u32 cmd_master_idx;
  211. u32 video_master_idx;
  212. /* dynamic DSI clock info*/
  213. u32 cached_clk_rate;
  214. atomic_t clkrate_change_pending;
  215. struct dsi_display_clk_info clock_info;
  216. struct dsi_host_config config;
  217. struct dsi_lane_map lane_map;
  218. int cmdline_topology;
  219. int cmdline_timing;
  220. bool is_tpg_enabled;
  221. bool poms_pending;
  222. bool ulps_enabled;
  223. bool clamp_enabled;
  224. bool phy_idle_power_off;
  225. struct drm_gem_object *tx_cmd_buf;
  226. u32 cmd_buffer_size;
  227. u64 cmd_buffer_iova;
  228. void *vaddr;
  229. struct msm_gem_address_space *aspace;
  230. struct mipi_dsi_host host;
  231. struct dsi_bridge *bridge;
  232. u32 cmd_engine_refcount;
  233. void *clk_mngr;
  234. void *dsi_clk_handle;
  235. void *mdp_clk_handle;
  236. /* DEBUG FS */
  237. struct dentry *root;
  238. bool misr_enable;
  239. u32 misr_frame_count;
  240. u32 esd_trigger;
  241. /* multiple dsi error handlers */
  242. struct workqueue_struct *err_workq;
  243. struct work_struct fifo_underflow_work;
  244. struct work_struct fifo_overflow_work;
  245. struct work_struct lp_rx_timeout_work;
  246. /* panel te delayed work */
  247. struct delayed_work poms_te_work;
  248. /* firmware panel data */
  249. const struct firmware *fw;
  250. void *parser;
  251. struct dsi_display_boot_param *boot_disp;
  252. u32 esd_fail_count;
  253. u32 te_source;
  254. u32 clk_gating_config;
  255. bool queue_cmd_waits;
  256. struct workqueue_struct *dma_cmd_workq;
  257. /* panel id of the display */
  258. u64 panel_id;
  259. bool is_active;
  260. bool trusted_vm_env;
  261. };
  262. int dsi_display_dev_probe(struct platform_device *pdev);
  263. int dsi_display_dev_remove(struct platform_device *pdev);
  264. /**
  265. * dsi_display_get_num_of_displays() - returns number of display devices
  266. * supported.
  267. *
  268. * Return: number of displays.
  269. */
  270. int dsi_display_get_num_of_displays(void);
  271. /**
  272. * dsi_display_get_active_displays - returns pointers for active display devices
  273. * @display_array: Pointer to display array to be filled
  274. * @max_display_count: Size of display_array
  275. * @Returns: Number of display entries filled
  276. */
  277. int dsi_display_get_active_displays(void **display_array,
  278. u32 max_display_count);
  279. /**
  280. * dsi_display_get_display_by_name()- finds display by name
  281. * @name: name of the display.
  282. *
  283. * Return: handle to the display or error code.
  284. */
  285. struct dsi_display *dsi_display_get_display_by_name(const char *name);
  286. /**
  287. * dsi_display_set_active_state() - sets the state of the display
  288. * @display: Handle to display.
  289. * @is_active: state
  290. */
  291. void dsi_display_set_active_state(struct dsi_display *display, bool is_active);
  292. /**
  293. * dsi_display_drm_bridge_init() - initializes DRM bridge object for DSI
  294. * @display: Handle to the display.
  295. * @encoder: Pointer to the encoder object which is connected to the
  296. * display.
  297. *
  298. * Return: error code.
  299. */
  300. int dsi_display_drm_bridge_init(struct dsi_display *display,
  301. struct drm_encoder *enc);
  302. /**
  303. * dsi_display_drm_bridge_deinit() - destroys DRM bridge for the display
  304. * @display: Handle to the display.
  305. *
  306. * Return: error code.
  307. */
  308. int dsi_display_drm_bridge_deinit(struct dsi_display *display);
  309. /**
  310. * dsi_display_drm_ext_bridge_init() - initializes DRM bridge for ext bridge
  311. * @display: Handle to the display.
  312. * @enc: Pointer to the encoder object which is connected to the
  313. * display.
  314. * @connector: Pointer to the connector object which is connected to
  315. * the display.
  316. *
  317. * Return: error code.
  318. */
  319. int dsi_display_drm_ext_bridge_init(struct dsi_display *display,
  320. struct drm_encoder *enc, struct drm_connector *connector);
  321. /**
  322. * dsi_display_get_info() - returns the display properties
  323. * @connector: Pointer to drm connector structure
  324. * @info: Pointer to the structure where info is stored.
  325. * @disp: Handle to the display.
  326. *
  327. * Return: error code.
  328. */
  329. int dsi_display_get_info(struct drm_connector *connector,
  330. struct msm_display_info *info, void *disp);
  331. /**
  332. * dsi_display_get_mode_count() - get number of modes supported by the display
  333. * @display: Handle to display.
  334. * @count: Number of modes supported
  335. *
  336. * Return: error code.
  337. */
  338. int dsi_display_get_mode_count(struct dsi_display *display, u32 *count);
  339. /**
  340. * dsi_display_get_modes() - get modes supported by display
  341. * @display: Handle to display.
  342. * @modes; Output param, list of DSI modes. Number of modes matches
  343. * count got from display->panel->num_display_modes;
  344. *
  345. * Return: error code.
  346. */
  347. int dsi_display_get_modes(struct dsi_display *display,
  348. struct dsi_display_mode **modes);
  349. /**
  350. * dsi_display_put_mode() - free up mode created for the display
  351. * @display: Handle to display.
  352. * @mode: Display mode to be freed up
  353. *
  354. * Return: error code.
  355. */
  356. void dsi_display_put_mode(struct dsi_display *display,
  357. struct dsi_display_mode *mode);
  358. /**
  359. * dsi_display_get_default_lms() - retrieve max number of lms used
  360. * for dsi display by traversing through all topologies
  361. * @display: Handle to display.
  362. * @num_lm: Number of LMs used
  363. *
  364. * Return: error code.
  365. */
  366. int dsi_display_get_default_lms(void *dsi_display, u32 *num_lm);
  367. /**
  368. * dsi_display_find_mode() - retrieve cached DSI mode given relevant params
  369. * @display: Handle to display.
  370. * @cmp: Mode to use as comparison to find original
  371. * @out_mode: Output parameter, pointer to retrieved mode
  372. *
  373. * Return: error code.
  374. */
  375. int dsi_display_find_mode(struct dsi_display *display,
  376. const struct dsi_display_mode *cmp,
  377. struct dsi_display_mode **out_mode);
  378. /**
  379. * dsi_display_validate_mode() - validates if mode is supported by display
  380. * @display: Handle to display.
  381. * @mode: Mode to be validated.
  382. * @flags: Modifier flags.
  383. *
  384. * Return: 0 if supported or error code.
  385. */
  386. int dsi_display_validate_mode(struct dsi_display *display,
  387. struct dsi_display_mode *mode,
  388. u32 flags);
  389. /**
  390. * dsi_display_validate_mode_change() - validates mode if variable refresh case
  391. * or dynamic clk change case
  392. * @display: Handle to display.
  393. * @mode: Mode to be validated..
  394. *
  395. * Return: 0 if error code.
  396. */
  397. int dsi_display_validate_mode_change(struct dsi_display *display,
  398. struct dsi_display_mode *cur_dsi_mode,
  399. struct dsi_display_mode *mode);
  400. /**
  401. * dsi_display_set_mode() - Set mode on the display.
  402. * @display: Handle to display.
  403. * @mode: mode to be set.
  404. * @flags: Modifier flags.
  405. *
  406. * Return: error code.
  407. */
  408. int dsi_display_set_mode(struct dsi_display *display,
  409. struct dsi_display_mode *mode,
  410. u32 flags);
  411. /**
  412. * dsi_display_prepare() - prepare display
  413. * @display: Handle to display.
  414. *
  415. * Prepare will perform power up sequences for the host and panel hardware.
  416. * Power and clock resources might be turned on (depending on the panel mode).
  417. * The video engine is not enabled.
  418. *
  419. * Return: error code.
  420. */
  421. int dsi_display_prepare(struct dsi_display *display);
  422. /**
  423. * dsi_display_splash_res_cleanup() - cleanup for continuous splash
  424. * @display: Pointer to dsi display
  425. * Returns: Zero on success
  426. */
  427. int dsi_display_splash_res_cleanup(struct dsi_display *display);
  428. /**
  429. * dsi_display_config_ctrl_for_cont_splash()- Enable engine modes for DSI
  430. * controller during continuous splash
  431. * @display: Handle to DSI display
  432. *
  433. * Return: returns error code
  434. */
  435. int dsi_display_config_ctrl_for_cont_splash(struct dsi_display *display);
  436. /**
  437. * dsi_display_enable() - enable display
  438. * @display: Handle to display.
  439. *
  440. * Enable will turn on the host engine and the panel. At the end of the enable
  441. * function, Host and panel hardware are ready to accept pixel data from
  442. * upstream.
  443. *
  444. * Return: error code.
  445. */
  446. int dsi_display_enable(struct dsi_display *display);
  447. /**
  448. * dsi_display_post_enable() - perform post enable operations.
  449. * @display: Handle to display.
  450. *
  451. * Some panels might require some commands to be sent after pixel data
  452. * transmission has started. Such commands are sent as part of the post_enable
  453. * function.
  454. *
  455. * Return: error code.
  456. */
  457. int dsi_display_post_enable(struct dsi_display *display);
  458. /**
  459. * dsi_display_pre_disable() - perform pre disable operations.
  460. * @display: Handle to display.
  461. *
  462. * If a panel requires commands to be sent before pixel data transmission is
  463. * stopped, those can be sent as part of pre_disable.
  464. *
  465. * Return: error code.
  466. */
  467. int dsi_display_pre_disable(struct dsi_display *display);
  468. /**
  469. * dsi_display_disable() - disable panel and host hardware.
  470. * @display: Handle to display.
  471. *
  472. * Disable host and panel hardware and pixel data transmission can not continue.
  473. *
  474. * Return: error code.
  475. */
  476. int dsi_display_disable(struct dsi_display *display);
  477. /**
  478. * dsi_pre_clkoff_cb() - Callback before clock is turned off
  479. * @priv: private data pointer.
  480. * @clk_type: clock which is being turned on.
  481. * @l_type: specifies if the clock is HS or LP type. Valid only for link clocks.
  482. * @new_state: next state for the clock.
  483. *
  484. * @return: error code.
  485. */
  486. int dsi_pre_clkoff_cb(void *priv, enum dsi_clk_type clk_type,
  487. enum dsi_lclk_type l_type,
  488. enum dsi_clk_state new_state);
  489. /**
  490. * dsi_display_update_pps() - update PPS buffer.
  491. * @pps_cmd: PPS buffer.
  492. * @display: Handle to display.
  493. *
  494. * Copies new PPS buffer into display structure.
  495. *
  496. * Return: error code.
  497. */
  498. int dsi_display_update_pps(char *pps_cmd, void *display);
  499. /**
  500. * dsi_post_clkoff_cb() - Callback after clock is turned off
  501. * @priv: private data pointer.
  502. * @clk_type: clock which is being turned on.
  503. * @l_type: specifies if the clock is HS or LP type. Valid only for link clocks.
  504. * @curr_state: current state for the clock.
  505. *
  506. * @return: error code.
  507. */
  508. int dsi_post_clkoff_cb(void *priv, enum dsi_clk_type clk_type,
  509. enum dsi_lclk_type l_type,
  510. enum dsi_clk_state curr_state);
  511. /**
  512. * dsi_post_clkon_cb() - Callback after clock is turned on
  513. * @priv: private data pointer.
  514. * @clk_type: clock which is being turned on.
  515. * @l_type: specifies if the clock is HS or LP type. Valid only for link clocks.
  516. * @curr_state: current state for the clock.
  517. *
  518. * @return: error code.
  519. */
  520. int dsi_post_clkon_cb(void *priv, enum dsi_clk_type clk_type,
  521. enum dsi_lclk_type l_type,
  522. enum dsi_clk_state curr_state);
  523. /**
  524. * dsi_pre_clkon_cb() - Callback before clock is turned on
  525. * @priv: private data pointer.
  526. * @clk_type: clock which is being turned on.
  527. * @l_type: specifies if the clock is HS or LP type. Valid only for link clocks.
  528. * @new_state: next state for the clock.
  529. *
  530. * @return: error code.
  531. */
  532. int dsi_pre_clkon_cb(void *priv, enum dsi_clk_type clk_type,
  533. enum dsi_lclk_type l_type,
  534. enum dsi_clk_state new_state);
  535. /**
  536. * dsi_display_unprepare() - power off display hardware.
  537. * @display: Handle to display.
  538. *
  539. * Host and panel hardware is turned off. Panel will be in reset state at the
  540. * end of the function.
  541. *
  542. * Return: error code.
  543. */
  544. int dsi_display_unprepare(struct dsi_display *display);
  545. int dsi_display_set_tpg_state(struct dsi_display *display, bool enable);
  546. int dsi_display_clock_gate(struct dsi_display *display, bool enable);
  547. int dsi_dispaly_static_frame(struct dsi_display *display, bool enable);
  548. /**
  549. * dsi_display_get_drm_panel() - get drm_panel from display.
  550. * @display: Handle to display.
  551. * Get drm_panel which was inclued in dsi_display's dsi_panel.
  552. *
  553. * Return: drm_panel/NULL.
  554. */
  555. struct drm_panel *dsi_display_get_drm_panel(struct dsi_display *display);
  556. /**
  557. * dsi_display_enable_event() - enable interrupt based connector event
  558. * @connector: Pointer to drm connector structure
  559. * @display: Handle to display.
  560. * @event_idx: Event index.
  561. * @event_info: Event callback definition.
  562. * @enable: Whether to enable/disable the event interrupt.
  563. */
  564. void dsi_display_enable_event(struct drm_connector *connector,
  565. struct dsi_display *display,
  566. uint32_t event_idx, struct dsi_event_cb_info *event_info,
  567. bool enable);
  568. /**
  569. * dsi_display_set_backlight() - set backlight
  570. * @connector: Pointer to drm connector structure
  571. * @display: Handle to display.
  572. * @bl_lvl: Backlight level.
  573. * @event_info: Event callback definition.
  574. * @enable: Whether to enable/disable the event interrupt.
  575. */
  576. int dsi_display_set_backlight(struct drm_connector *connector,
  577. void *display, u32 bl_lvl);
  578. /**
  579. * dsi_display_check_status() - check if panel is dead or alive
  580. * @connector: Pointer to drm connector structure
  581. * @display: Handle to display.
  582. * @te_check_override: Whether check for TE from panel or default check
  583. */
  584. int dsi_display_check_status(struct drm_connector *connector, void *display,
  585. bool te_check_override);
  586. /**
  587. * dsi_display_cmd_transfer() - transfer command to the panel
  588. * @connector: Pointer to drm connector structure
  589. * @display: Handle to display.
  590. * @cmd_buf: Command buffer
  591. * @cmd_buf_len: Command buffer length in bytes
  592. */
  593. int dsi_display_cmd_transfer(struct drm_connector *connector,
  594. void *display, const char *cmd_buffer,
  595. u32 cmd_buf_len);
  596. /**
  597. * dsi_display_cmd_receive() - receive response from the panel
  598. * @display: Handle to display.
  599. * @cmd_buf: Command buffer
  600. * @cmd_buf_len: Command buffer length in bytes
  601. * @recv_buf: Receive buffer
  602. * @recv_buf_len: Receive buffer length in bytes
  603. */
  604. int dsi_display_cmd_receive(void *display, const char *cmd_buf,
  605. u32 cmd_buf_len, u8 *recv_buf, u32 recv_buf_len);
  606. /**
  607. * dsi_display_soft_reset() - perform a soft reset on DSI controller
  608. * @display: Handle to display
  609. *
  610. * The video, command and controller engines will be disabled before the
  611. * reset is triggered. After, the engines will be re-enabled to the same state
  612. * as before the reset.
  613. *
  614. * If the reset is done while MDP timing engine is turned on, the video
  615. * engine should be re-enabled only during the vertical blanking time.
  616. *
  617. * Return: error code
  618. */
  619. int dsi_display_soft_reset(void *display);
  620. /**
  621. * dsi_display_set_power - update power/dpms setting
  622. * @connector: Pointer to drm connector structure
  623. * @power_mode: One of the following,
  624. * SDE_MODE_DPMS_ON
  625. * SDE_MODE_DPMS_LP1
  626. * SDE_MODE_DPMS_LP2
  627. * SDE_MODE_DPMS_STANDBY
  628. * SDE_MODE_DPMS_SUSPEND
  629. * SDE_MODE_DPMS_OFF
  630. * @display: Pointer to private display structure
  631. * Returns: Zero on success
  632. */
  633. int dsi_display_set_power(struct drm_connector *connector,
  634. int power_mode, void *display);
  635. /*
  636. * dsi_display_pre_kickoff - program kickoff-time features
  637. * @connector: Pointer to drm connector structure
  638. * @display: Pointer to private display structure
  639. * @params: Parameters for kickoff-time programming
  640. * Returns: Zero on success
  641. */
  642. int dsi_display_pre_kickoff(struct drm_connector *connector,
  643. struct dsi_display *display,
  644. struct msm_display_kickoff_params *params);
  645. /*
  646. * dsi_display_pre_commit - program pre commit features
  647. * @display: Pointer to private display structure
  648. * @params: Parameters for pre commit time programming
  649. * Returns: Zero on success
  650. */
  651. int dsi_display_pre_commit(void *display,
  652. struct msm_display_conn_params *params);
  653. /**
  654. * dsi_display_get_dst_format() - get dst_format from DSI display
  655. * @connector: Pointer to drm connector structure
  656. * @display: Handle to display
  657. *
  658. * Return: enum dsi_pixel_format type
  659. */
  660. enum dsi_pixel_format dsi_display_get_dst_format(
  661. struct drm_connector *connector,
  662. void *display);
  663. /**
  664. * dsi_display_cont_splash_config() - initialize splash resources
  665. * @display: Handle to display
  666. *
  667. * Return: Zero on Success
  668. */
  669. int dsi_display_cont_splash_config(void *display);
  670. /**
  671. * dsi_display_cont_splash_res_disable() - Disable resource votes added in probe
  672. * @display: Pointer to dsi display
  673. * Returns: Zero on success
  674. */
  675. int dsi_display_cont_splash_res_disable(void *display);
  676. /*
  677. * dsi_display_get_panel_vfp - get panel vsync
  678. * @display: Pointer to private display structure
  679. * @h_active: width
  680. * @v_active: height
  681. * Returns: v_front_porch on success error code on failure
  682. */
  683. int dsi_display_get_panel_vfp(void *display,
  684. int h_active, int v_active);
  685. /**
  686. * dsi_display_dump_clks_state() - dump clocks state to console
  687. * @display: Handle to display
  688. *
  689. * Return: Zero on Success
  690. */
  691. int dsi_display_dump_clks_state(struct dsi_display *display);
  692. #endif /* _DSI_DISPLAY_H_ */