dsi_display.h 24 KB

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