sde_encoder.h 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653
  1. /*
  2. * Copyright (c) 2015-2021, The Linux Foundation. All rights reserved.
  3. * Copyright (C) 2013 Red Hat
  4. * Author: Rob Clark <[email protected]>
  5. *
  6. * This program is free software; you can redistribute it and/or modify it
  7. * under the terms of the GNU General Public License version 2 as published by
  8. * the Free Software Foundation.
  9. *
  10. * This program is distributed in the hope that it will be useful, but WITHOUT
  11. * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  12. * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  13. * more details.
  14. *
  15. * You should have received a copy of the GNU General Public License along with
  16. * this program. If not, see <http://www.gnu.org/licenses/>.
  17. */
  18. #ifndef __SDE_ENCODER_H__
  19. #define __SDE_ENCODER_H__
  20. #include <drm/drm_crtc.h>
  21. #include <drm/drm_bridge.h>
  22. #include <linux/sde_rsc.h>
  23. #include "msm_prop.h"
  24. #include "sde_hw_mdss.h"
  25. #include "sde_kms.h"
  26. #include "sde_connector.h"
  27. #include "sde_power_handle.h"
  28. /*
  29. * Two to anticipate panels that can do cmd/vid dynamic switching
  30. * plan is to create all possible physical encoder types, and switch between
  31. * them at runtime
  32. */
  33. #define NUM_PHYS_ENCODER_TYPES 2
  34. #define MAX_PHYS_ENCODERS_PER_VIRTUAL \
  35. (MAX_H_TILES_PER_DISPLAY * NUM_PHYS_ENCODER_TYPES)
  36. #define MAX_CHANNELS_PER_ENC 4
  37. #define SDE_ENCODER_FRAME_EVENT_DONE BIT(0)
  38. #define SDE_ENCODER_FRAME_EVENT_ERROR BIT(1)
  39. #define SDE_ENCODER_FRAME_EVENT_PANEL_DEAD BIT(2)
  40. #define SDE_ENCODER_FRAME_EVENT_SIGNAL_RELEASE_FENCE BIT(3)
  41. #define SDE_ENCODER_FRAME_EVENT_SIGNAL_RETIRE_FENCE BIT(4)
  42. #define SDE_ENCODER_FRAME_EVENT_CWB_DONE BIT(5)
  43. #define IDLE_POWERCOLLAPSE_DURATION (66 - 16/2)
  44. #define IDLE_POWERCOLLAPSE_IN_EARLY_WAKEUP (200 - 16/2)
  45. /**
  46. * Encoder functions and data types
  47. * @intfs: Interfaces this encoder is using, INTF_MODE_NONE if unused
  48. * @wbs: Writebacks this encoder is using, INTF_MODE_NONE if unused
  49. * @needs_cdm: Encoder requests a CDM based on pixel format conversion needs
  50. * @display_num_of_h_tiles: Number of horizontal tiles in case of split
  51. * interface
  52. * @display_type: Type of the display
  53. * @topology: Topology of the display
  54. * @comp_info: Compression parameters information
  55. */
  56. struct sde_encoder_hw_resources {
  57. enum sde_intf_mode intfs[INTF_MAX];
  58. enum sde_intf_mode wbs[WB_MAX];
  59. bool needs_cdm;
  60. u32 display_num_of_h_tiles;
  61. enum sde_connector_display display_type;
  62. struct msm_display_topology topology;
  63. struct msm_compression_info *comp_info;
  64. };
  65. /**
  66. * sde_encoder_kickoff_params - info encoder requires at kickoff
  67. * @affected_displays: bitmask, bit set means the ROI of the commit lies within
  68. * the bounds of the physical display at the bit index
  69. * @recovery_events_enabled: indicates status of client for recoovery events
  70. * @frame_trigger_mode: indicates frame trigger mode
  71. */
  72. struct sde_encoder_kickoff_params {
  73. unsigned long affected_displays;
  74. bool recovery_events_enabled;
  75. enum frame_trigger_mode_type frame_trigger_mode;
  76. };
  77. /*
  78. * enum sde_enc_rc_states - states that the resource control maintains
  79. * @SDE_ENC_RC_STATE_OFF: Resource is in OFF state
  80. * @SDE_ENC_RC_STATE_PRE_OFF: Resource is transitioning to OFF state
  81. * @SDE_ENC_RC_STATE_ON: Resource is in ON state
  82. * @SDE_ENC_RC_STATE_MODESET: Resource is in modeset state
  83. * @SDE_ENC_RC_STATE_IDLE: Resource is in IDLE state
  84. */
  85. enum sde_enc_rc_states {
  86. SDE_ENC_RC_STATE_OFF,
  87. SDE_ENC_RC_STATE_PRE_OFF,
  88. SDE_ENC_RC_STATE_ON,
  89. SDE_ENC_RC_STATE_MODESET,
  90. SDE_ENC_RC_STATE_IDLE
  91. };
  92. /**
  93. * struct sde_encoder_ops - callback functions for generic sde encoder
  94. * Individual callbacks documented below.
  95. */
  96. struct sde_encoder_ops {
  97. /**
  98. * phys_init - phys initialization function
  99. * @type: controller type
  100. * @controller_id: controller id
  101. * @phys_init_params: Pointer of structure sde_enc_phys_init_params
  102. * Returns: Pointer of sde_encoder_phys, NULL if failed
  103. */
  104. void *(*phys_init)(enum sde_intf_type type,
  105. u32 controller_id, void *phys_init_params);
  106. };
  107. /**
  108. * struct sde_encoder_virt - virtual encoder. Container of one or more physical
  109. * encoders. Virtual encoder manages one "logical" display. Physical
  110. * encoders manage one intf block, tied to a specific panel/sub-panel.
  111. * Virtual encoder defers as much as possible to the physical encoders.
  112. * Virtual encoder registers itself with the DRM Framework as the encoder.
  113. * @base: drm_encoder base class for registration with DRM
  114. * @enc_spin_lock: Virtual-Encoder-Wide Spin Lock for IRQ purposes
  115. * @bus_scaling_client: Client handle to the bus scaling interface
  116. * @te_source: vsync source pin information
  117. * @ops: Encoder ops from init function
  118. * @num_phys_encs: Actual number of physical encoders contained.
  119. * @phys_encs: Container of physical encoders managed.
  120. * @phys_vid_encs: Video physical encoders for panel mode switch.
  121. * @phys_cmd_encs: Command physical encoders for panel mode switch.
  122. * @cur_master: Pointer to the current master in this mode. Optimization
  123. * Only valid after enable. Cleared as disable.
  124. * @hw_pp Handle to the pingpong blocks used for the display. No.
  125. * pingpong blocks can be different than num_phys_encs.
  126. * @hw_dsc: Array of DSC block handles used for the display.
  127. * @hw_vdc: Array of VDC block handles used for the display.
  128. * @dirty_dsc_ids: Cached dsc indexes for dirty DSC blocks needing flush
  129. * @intfs_swapped Whether or not the phys_enc interfaces have been swapped
  130. * for partial update right-only cases, such as pingpong
  131. * split where virtual pingpong does not generate IRQs
  132. * @qdss_status: indicate if qdss is modified since last update
  133. * @crtc_vblank_cb: Callback into the upper layer / CRTC for
  134. * notification of the VBLANK
  135. * @crtc_vblank_cb_data: Data from upper layer for VBLANK notification
  136. * @crtc_kickoff_cb: Callback into CRTC that will flush & start
  137. * all CTL paths
  138. * @crtc_kickoff_cb_data: Opaque user data given to crtc_kickoff_cb
  139. * @debugfs_root: Debug file system root file node
  140. * @enc_lock: Lock around physical encoder create/destroy and
  141. access.
  142. * @frame_done_cnt: Atomic counter for tracking which phys_enc is
  143. * done with frame processing
  144. * @crtc_frame_event_cb: callback handler for frame event
  145. * @crtc_frame_event_cb_data: callback handler private data
  146. * @rsc_client: rsc client pointer
  147. * @rsc_state_init: boolean to indicate rsc config init
  148. * @disp_info: local copy of msm_display_info struct
  149. * @misr_enable: misr enable/disable status
  150. * @misr_reconfigure: boolean entry indicates misr reconfigure status
  151. * @misr_frame_count: misr frame count before start capturing the data
  152. * @idle_pc_enabled: indicate if idle power collapse is enabled
  153. * currently. This can be controlled by user-mode
  154. * @rc_lock: resource control mutex lock to protect
  155. * virt encoder over various state changes
  156. * @rc_state: resource controller state
  157. * @delayed_off_work: delayed worker to schedule disabling of
  158. * clks and resources after IDLE_TIMEOUT time.
  159. * @early_wakeup_work: worker to handle early wakeup event
  160. * @input_event_work: worker to handle input device touch events
  161. * @esd_trigger_work: worker to handle esd trigger events
  162. * @input_handler: handler for input device events
  163. * @topology: topology of the display
  164. * @vblank_enabled: boolean to track userspace vblank vote
  165. * @idle_pc_restore: flag to indicate idle_pc_restore happened
  166. * @frame_trigger_mode: frame trigger mode indication for command mode
  167. * display
  168. * @dynamic_hdr_updated: flag to indicate if mempool was unchanged
  169. * @rsc_config: rsc configuration for display vtotal, fps, etc.
  170. * @cur_conn_roi: current connector roi
  171. * @prv_conn_roi: previous connector roi to optimize if unchanged
  172. * @crtc pointer to drm_crtc
  173. * @recovery_events_enabled: status of hw recovery feature enable by client
  174. * @elevated_ahb_vote: increase AHB bus speed for the first frame
  175. * after power collapse
  176. * @pm_qos_cpu_req: qos request for all cpu core frequency
  177. * @valid_cpu_mask: actual voted cpu core mask
  178. * @mode_info: stores the current mode and should be used
  179. * only in commit phase
  180. * @delay_kickoff boolean to delay the kickoff, used in case
  181. * of esd attack to ensure esd workqueue detects
  182. * the previous frame transfer completion before
  183. * next update is triggered.
  184. */
  185. struct sde_encoder_virt {
  186. struct drm_encoder base;
  187. spinlock_t enc_spinlock;
  188. struct mutex vblank_ctl_lock;
  189. uint32_t bus_scaling_client;
  190. uint32_t display_num_of_h_tiles;
  191. uint32_t te_source;
  192. struct sde_encoder_ops ops;
  193. unsigned int num_phys_encs;
  194. struct sde_encoder_phys *phys_encs[MAX_PHYS_ENCODERS_PER_VIRTUAL];
  195. struct sde_encoder_phys *phys_vid_encs[MAX_PHYS_ENCODERS_PER_VIRTUAL];
  196. struct sde_encoder_phys *phys_cmd_encs[MAX_PHYS_ENCODERS_PER_VIRTUAL];
  197. struct sde_encoder_phys *cur_master;
  198. struct sde_hw_pingpong *hw_pp[MAX_CHANNELS_PER_ENC];
  199. struct sde_hw_dsc *hw_dsc[MAX_CHANNELS_PER_ENC];
  200. struct sde_hw_vdc *hw_vdc[MAX_CHANNELS_PER_ENC];
  201. struct sde_hw_pingpong *hw_dsc_pp[MAX_CHANNELS_PER_ENC];
  202. enum sde_dsc dirty_dsc_ids[MAX_CHANNELS_PER_ENC];
  203. enum sde_vdc dirty_vdc_ids[MAX_CHANNELS_PER_ENC];
  204. bool intfs_swapped;
  205. bool qdss_status;
  206. void (*crtc_vblank_cb)(void *data, ktime_t ts);
  207. void *crtc_vblank_cb_data;
  208. struct dentry *debugfs_root;
  209. struct mutex enc_lock;
  210. atomic_t frame_done_cnt[MAX_PHYS_ENCODERS_PER_VIRTUAL];
  211. void (*crtc_frame_event_cb)(void *data, u32 event, ktime_t ts);
  212. struct sde_kms_frame_event_cb_data crtc_frame_event_cb_data;
  213. struct sde_rsc_client *rsc_client;
  214. bool rsc_state_init;
  215. struct msm_display_info disp_info;
  216. bool misr_enable;
  217. bool misr_reconfigure;
  218. u32 misr_frame_count;
  219. bool idle_pc_enabled;
  220. bool input_event_enabled;
  221. struct mutex rc_lock;
  222. enum sde_enc_rc_states rc_state;
  223. struct kthread_delayed_work delayed_off_work;
  224. struct kthread_work early_wakeup_work;
  225. struct kthread_work input_event_work;
  226. struct kthread_work esd_trigger_work;
  227. struct input_handler *input_handler;
  228. struct msm_display_topology topology;
  229. bool vblank_enabled;
  230. bool idle_pc_restore;
  231. enum frame_trigger_mode_type frame_trigger_mode;
  232. bool dynamic_hdr_updated;
  233. struct sde_rsc_cmd_config rsc_config;
  234. struct sde_rect cur_conn_roi;
  235. struct sde_rect prv_conn_roi;
  236. struct drm_crtc *crtc;
  237. bool recovery_events_enabled;
  238. bool elevated_ahb_vote;
  239. struct dev_pm_qos_request pm_qos_cpu_req[NR_CPUS];
  240. struct cpumask valid_cpu_mask;
  241. struct msm_mode_info mode_info;
  242. bool delay_kickoff;
  243. };
  244. #define to_sde_encoder_virt(x) container_of(x, struct sde_encoder_virt, base)
  245. /**
  246. * sde_encoder_get_hw_resources - Populate table of required hardware resources
  247. * @encoder: encoder pointer
  248. * @hw_res: resource table to populate with encoder required resources
  249. * @conn_state: report hw reqs based on this proposed connector state
  250. */
  251. void sde_encoder_get_hw_resources(struct drm_encoder *encoder,
  252. struct sde_encoder_hw_resources *hw_res,
  253. struct drm_connector_state *conn_state);
  254. /**
  255. * sde_encoder_early_wakeup - early wake up display
  256. * @encoder: encoder pointer
  257. */
  258. void sde_encoder_early_wakeup(struct drm_encoder *drm_enc);
  259. /**
  260. * sde_encoder_register_vblank_callback - provide callback to encoder that
  261. * will be called on the next vblank.
  262. * @encoder: encoder pointer
  263. * @cb: callback pointer, provide NULL to deregister and disable IRQs
  264. * @data: user data provided to callback
  265. */
  266. void sde_encoder_register_vblank_callback(struct drm_encoder *encoder,
  267. void (*cb)(void *, ktime_t), void *data);
  268. /**
  269. * sde_encoder_register_frame_event_callback - provide callback to encoder that
  270. * will be called after the request is complete, or other events.
  271. * @encoder: encoder pointer
  272. * @cb: callback pointer, provide NULL to deregister
  273. * @crtc: pointer to drm_crtc object interested in frame events
  274. */
  275. void sde_encoder_register_frame_event_callback(struct drm_encoder *encoder,
  276. void (*cb)(void *, u32, ktime_t), struct drm_crtc *crtc);
  277. /**
  278. * sde_encoder_get_rsc_client - gets the rsc client state for primary
  279. * for primary display.
  280. * @encoder: encoder pointer
  281. */
  282. struct sde_rsc_client *sde_encoder_get_rsc_client(struct drm_encoder *encoder);
  283. /**
  284. * sde_encoder_poll_line_counts - poll encoder line counts for start of frame
  285. * @encoder: encoder pointer
  286. * @Returns: zero on success
  287. */
  288. int sde_encoder_poll_line_counts(struct drm_encoder *encoder);
  289. /**
  290. * sde_encoder_prepare_for_kickoff - schedule double buffer flip of the ctl
  291. * path (i.e. ctl flush and start) at next appropriate time.
  292. * Immediately: if no previous commit is outstanding.
  293. * Delayed: Block until next trigger can be issued.
  294. * @encoder: encoder pointer
  295. * @params: kickoff time parameters
  296. * @Returns: Zero on success, last detected error otherwise
  297. */
  298. int sde_encoder_prepare_for_kickoff(struct drm_encoder *encoder,
  299. struct sde_encoder_kickoff_params *params);
  300. /**
  301. * sde_encoder_trigger_kickoff_pending - Clear the flush bits from previous
  302. * kickoff and trigger the ctl prepare progress for command mode display.
  303. * @encoder: encoder pointer
  304. */
  305. void sde_encoder_trigger_kickoff_pending(struct drm_encoder *encoder);
  306. /**
  307. * sde_encoder_kickoff - trigger a double buffer flip of the ctl path
  308. * (i.e. ctl flush and start) immediately.
  309. * @encoder: encoder pointer
  310. * @is_error: whether the current commit needs to be aborted and replaced
  311. * with a 'safe' commit
  312. * @config_changed: if true new configuration is applied on the control path
  313. */
  314. void sde_encoder_kickoff(struct drm_encoder *encoder, bool is_error,
  315. bool config_changed);
  316. /**
  317. * sde_encoder_wait_for_event - Waits for encoder events
  318. * @encoder: encoder pointer
  319. * @event: event to wait for
  320. * MSM_ENC_COMMIT_DONE - Wait for hardware to have flushed the current pending
  321. * frames to hardware at a vblank or wr_ptr_start
  322. * Encoders will map this differently depending on the
  323. * panel type.
  324. * vid mode -> vsync_irq
  325. * cmd mode -> wr_ptr_start_irq
  326. * MSM_ENC_TX_COMPLETE - Wait for the hardware to transfer all the pixels to
  327. * the panel. Encoders will map this differently
  328. * depending on the panel type.
  329. * vid mode -> vsync_irq
  330. * cmd mode -> pp_done
  331. * Returns: 0 on success, -EWOULDBLOCK if already signaled, error otherwise
  332. */
  333. int sde_encoder_wait_for_event(struct drm_encoder *drm_encoder,
  334. enum msm_event_wait event);
  335. /**
  336. * sde_encoder_idle_request - request for idle request to avoid 4 vsync cycle
  337. * to turn off the clocks.
  338. * @encoder: encoder pointer
  339. * Returns: 0 on success, errorcode otherwise
  340. */
  341. int sde_encoder_idle_request(struct drm_encoder *drm_enc);
  342. /*
  343. * sde_encoder_get_fps - get interface frame rate of the given encoder
  344. * @encoder: Pointer to drm encoder object
  345. */
  346. u32 sde_encoder_get_fps(struct drm_encoder *encoder);
  347. /*
  348. * sde_encoder_get_intf_mode - get interface mode of the given encoder
  349. * @encoder: Pointer to drm encoder object
  350. */
  351. enum sde_intf_mode sde_encoder_get_intf_mode(struct drm_encoder *encoder);
  352. /*
  353. * sde_encoder_get_frame_count - get hardware frame count of the given encoder
  354. * @encoder: Pointer to drm encoder object
  355. */
  356. u32 sde_encoder_get_frame_count(struct drm_encoder *encoder);
  357. /*
  358. * sde_encoder_get_vblank_timestamp - get the last vsync timestamp
  359. * @encoder: Pointer to drm encoder object
  360. * @tvblank: vblank timestamp
  361. */
  362. bool sde_encoder_get_vblank_timestamp(struct drm_encoder *encoder,
  363. ktime_t *tvblank);
  364. /**
  365. * sde_encoder_control_te - control enabling/disabling VSYNC_IN_EN
  366. * @encoder: encoder pointer
  367. * @enable: boolean to indicate enable/disable
  368. */
  369. void sde_encoder_control_te(struct drm_encoder *encoder, bool enable);
  370. /**
  371. * sde_encoder_virt_restore - restore the encoder configs
  372. * @encoder: encoder pointer
  373. */
  374. void sde_encoder_virt_restore(struct drm_encoder *encoder);
  375. /**
  376. * sde_encoder_is_dsc_merge - check if encoder is in DSC merge mode
  377. * @drm_enc: Pointer to drm encoder object
  378. * @Return: true if encoder is in DSC merge mode
  379. */
  380. bool sde_encoder_is_dsc_merge(struct drm_encoder *drm_enc);
  381. /**
  382. * sde_encoder_check_curr_mode - check if given mode is supported or not
  383. * @drm_enc: Pointer to drm encoder object
  384. * @mode: Mode to be checked
  385. * @Return: true if it is cmd mode
  386. */
  387. bool sde_encoder_check_curr_mode(struct drm_encoder *drm_enc, u32 mode);
  388. /**
  389. * sde_encoder_init - initialize virtual encoder object
  390. * @dev: Pointer to drm device structure
  391. * @disp_info: Pointer to display information structure
  392. * Returns: Pointer to newly created drm encoder
  393. */
  394. struct drm_encoder *sde_encoder_init(
  395. struct drm_device *dev,
  396. struct msm_display_info *disp_info);
  397. /**
  398. * sde_encoder_init_with_ops - initialize virtual encoder object with init ops
  399. * @dev: Pointer to drm device structure
  400. * @disp_info: Pointer to display information structure
  401. * @ops: Pointer to encoder ops structure
  402. * Returns: Pointer to newly created drm encoder
  403. */
  404. struct drm_encoder *sde_encoder_init_with_ops(
  405. struct drm_device *dev,
  406. struct msm_display_info *disp_info,
  407. const struct sde_encoder_ops *ops);
  408. /**
  409. * sde_encoder_destroy - destroy previously initialized virtual encoder
  410. * @drm_enc: Pointer to previously created drm encoder structure
  411. */
  412. void sde_encoder_destroy(struct drm_encoder *drm_enc);
  413. /**
  414. * sde_encoder_prepare_commit - prepare encoder at the very beginning of an
  415. * atomic commit, before any registers are written
  416. * @drm_enc: Pointer to previously created drm encoder structure
  417. */
  418. int sde_encoder_prepare_commit(struct drm_encoder *drm_enc);
  419. /**
  420. * sde_encoder_update_caps_for_cont_splash - update encoder settings during
  421. * device bootup when cont_splash is enabled
  422. * @drm_enc: Pointer to drm encoder structure
  423. * @splash_display: Pointer to sde_splash_display corresponding to this encoder
  424. * @enable: boolean indicates enable or displae state of splash
  425. * @Return: true if successful in updating the encoder structure
  426. */
  427. int sde_encoder_update_caps_for_cont_splash(struct drm_encoder *encoder,
  428. struct sde_splash_display *splash_display, bool enable);
  429. /**
  430. * sde_encoder_display_failure_notification - update sde encoder state for
  431. * esd timeout or other display failure notification. This event flows from
  432. * dsi, sde_connector to sde_encoder.
  433. *
  434. * This api must not be called from crtc_commit (display) thread because it
  435. * requests the flush work on same thread. It is called from esd check thread
  436. * based on current design.
  437. *
  438. * TODO: manage the event at sde_kms level for forward processing.
  439. * @drm_enc: Pointer to drm encoder structure
  440. * @skip_pre_kickoff: Caller can avoid pre_kickoff if it is triggering this
  441. * event only to switch the panel TE to watchdog mode.
  442. * @Return: true if successful in updating the encoder structure
  443. */
  444. int sde_encoder_display_failure_notification(struct drm_encoder *enc,
  445. bool skip_pre_kickoff);
  446. /**
  447. * sde_encoder_recovery_events_enabled - checks if client has enabled
  448. * sw recovery mechanism for this connector
  449. * @drm_enc: Pointer to drm encoder structure
  450. * @Return: true if enabled
  451. */
  452. bool sde_encoder_recovery_events_enabled(struct drm_encoder *encoder);
  453. /**
  454. * sde_encoder_enable_recovery_event - handler to enable the sw recovery
  455. * for this connector
  456. * @drm_enc: Pointer to drm encoder structure
  457. */
  458. void sde_encoder_enable_recovery_event(struct drm_encoder *encoder);
  459. /**
  460. * sde_encoder_in_clone_mode - checks if underlying phys encoder is in clone
  461. * mode or independent display mode. ref@ WB in Concurrent writeback mode.
  462. * @drm_enc: Pointer to drm encoder structure
  463. * @Return: true if successful in updating the encoder structure
  464. */
  465. bool sde_encoder_in_clone_mode(struct drm_encoder *enc);
  466. /*
  467. * sde_encoder_is_cwb_disabling - check if cwb encoder disable is pending
  468. * @drm_enc: Pointer to drm encoder structure
  469. * @drm_crtc: Pointer to drm crtc structure
  470. * @Return: true if cwb encoder disable is pending
  471. */
  472. bool sde_encoder_is_cwb_disabling(struct drm_encoder *drm_enc,
  473. struct drm_crtc *drm_crtc);
  474. /**
  475. * sde_encoder_is_primary_display - checks if underlying display is primary
  476. * display or not.
  477. * @drm_enc: Pointer to drm encoder structure
  478. * @Return: true if it is primary display. false if secondary display
  479. */
  480. bool sde_encoder_is_primary_display(struct drm_encoder *enc);
  481. /**
  482. * sde_encoder_is_dsi_display - checks if underlying display is DSI
  483. * display or not.
  484. * @drm_enc: Pointer to drm encoder structure
  485. * @Return: true if it is primary display. false if secondary display
  486. */
  487. bool sde_encoder_is_dsi_display(struct drm_encoder *enc);
  488. /**
  489. * sde_encoder_control_idle_pc - control enable/disable of idle power collapse
  490. * @drm_enc: Pointer to drm encoder structure
  491. * @enable: enable/disable flag
  492. */
  493. void sde_encoder_control_idle_pc(struct drm_encoder *enc, bool enable);
  494. /**
  495. * sde_encoder_in_cont_splash - checks if display is in continuous splash
  496. * @drm_enc: Pointer to drm encoder structure
  497. * @Return: true if display in continuous splash
  498. */
  499. int sde_encoder_in_cont_splash(struct drm_encoder *enc);
  500. /**
  501. * sde_encoder_helper_hw_reset - hw reset helper function
  502. * @drm_enc: Pointer to drm encoder structure
  503. */
  504. void sde_encoder_needs_hw_reset(struct drm_encoder *enc);
  505. /**
  506. * sde_encoder_uidle_enable - control enable/disable of uidle
  507. * @drm_enc: Pointer to drm encoder structure
  508. * @enable: enable/disable flag
  509. */
  510. void sde_encoder_uidle_enable(struct drm_encoder *drm_enc, bool enable);
  511. /**
  512. * sde_encoder_irq_control - control enable/disable of IRQ's
  513. * @drm_enc: Pointer to drm encoder structure
  514. * @enable: enable/disable flag
  515. */
  516. void sde_encoder_irq_control(struct drm_encoder *drm_enc, bool enable);
  517. /**sde_encoder_get_connector - get connector corresponding to encoder
  518. * @dev: Pointer to drm device structure
  519. * @drm_enc: Pointer to drm encoder structure
  520. * Returns: drm connector if found, null if not found
  521. */
  522. struct drm_connector *sde_encoder_get_connector(struct drm_device *dev,
  523. struct drm_encoder *drm_enc);
  524. /*
  525. * sde_encoder_get_dfps_maxfps - get dynamic FPS max frame rate of
  526. the given encoder
  527. * @encoder: Pointer to drm encoder object
  528. */
  529. static inline u32 sde_encoder_get_dfps_maxfps(struct drm_encoder *drm_enc)
  530. {
  531. struct sde_encoder_virt *sde_enc;
  532. if (!drm_enc) {
  533. SDE_ERROR("invalid encoder\n");
  534. return 0;
  535. }
  536. sde_enc = to_sde_encoder_virt(drm_enc);
  537. return sde_enc->mode_info.dfps_maxfps;
  538. }
  539. /**
  540. * sde_encoder_virt_reset - delay encoder virt reset
  541. * @drm_enc: Pointer to drm encoder structure
  542. */
  543. void sde_encoder_virt_reset(struct drm_encoder *drm_enc);
  544. /**
  545. * sde_encoder_calc_last_vsync_timestamp - read last HW vsync timestamp counter
  546. * and calculate the corresponding vsync ktime. Return ktime_get
  547. * when HW support is not available
  548. * @drm_enc: Pointer to drm encoder structure
  549. */
  550. ktime_t sde_encoder_calc_last_vsync_timestamp(struct drm_encoder *drm_enc);
  551. /**
  552. * sde_encoder_get_kms - retrieve the kms from encoder
  553. * @drm_enc: Pointer to drm encoder structure
  554. */
  555. static inline struct sde_kms *sde_encoder_get_kms(struct drm_encoder *drm_enc)
  556. {
  557. struct msm_drm_private *priv;
  558. if (!drm_enc || !drm_enc->dev) {
  559. SDE_ERROR("invalid encoder\n");
  560. return NULL;
  561. }
  562. priv = drm_enc->dev->dev_private;
  563. if (!priv || !priv->kms) {
  564. SDE_ERROR("invalid kms\n");
  565. return NULL;
  566. }
  567. return to_sde_kms(priv->kms);
  568. }
  569. /*
  570. * sde_encoder_is_widebus_enabled - check if widebus is enabled for current mode
  571. * @drm_enc: Pointer to drm encoder structure
  572. * @Return: true if widebus is enabled for current mode
  573. */
  574. static inline bool sde_encoder_is_widebus_enabled(struct drm_encoder *drm_enc)
  575. {
  576. struct sde_encoder_virt *sde_enc;
  577. if (!drm_enc)
  578. return false;
  579. sde_enc = to_sde_encoder_virt(drm_enc);
  580. return sde_enc->mode_info.wide_bus_en;
  581. }
  582. #endif /* __SDE_ENCODER_H__ */