sde_crtc.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809
  1. /*
  2. * Copyright (c) 2015-2020 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_CRTC_H_
  19. #define _SDE_CRTC_H_
  20. #include <linux/kthread.h>
  21. #include <linux/of_fdt.h>
  22. #include <drm/drm_crtc.h>
  23. #include "msm_prop.h"
  24. #include "sde_fence.h"
  25. #include "sde_kms.h"
  26. #include "sde_core_perf.h"
  27. #include "sde_hw_ds.h"
  28. #define SDE_CRTC_NAME_SIZE 12
  29. /* define the maximum number of in-flight frame events */
  30. /* Expand it to 2x for handling atleast 2 connectors safely */
  31. #define SDE_CRTC_FRAME_EVENT_SIZE (4 * 2)
  32. /**
  33. * enum sde_crtc_client_type: crtc client type
  34. * @RT_CLIENT: RealTime client like video/cmd mode display
  35. * voting through apps rsc
  36. * @NRT_CLIENT: Non-RealTime client like WB display
  37. * voting through apps rsc
  38. * @RT_RSC_CLIENT: Realtime display RSC voting client
  39. */
  40. enum sde_crtc_client_type {
  41. RT_CLIENT,
  42. NRT_CLIENT,
  43. RT_RSC_CLIENT,
  44. };
  45. /**
  46. * enum sde_crtc_output_capture_point
  47. * @MIXER_OUT : capture mixer output
  48. * @DSPP_OUT : capture output of dspp
  49. */
  50. enum sde_crtc_output_capture_point {
  51. CAPTURE_MIXER_OUT,
  52. CAPTURE_DSPP_OUT
  53. };
  54. /**
  55. * enum sde_crtc_idle_pc_state: states of idle power collapse
  56. * @IDLE_PC_NONE: no-op
  57. * @IDLE_PC_ENABLE: enable idle power-collapse
  58. * @IDLE_PC_DISABLE: disable idle power-collapse
  59. */
  60. enum sde_crtc_idle_pc_state {
  61. IDLE_PC_NONE,
  62. IDLE_PC_ENABLE,
  63. IDLE_PC_DISABLE,
  64. };
  65. /**
  66. * @connectors : Currently associated drm connectors for retire event
  67. * @num_connectors: Number of associated drm connectors for retire event
  68. * @list: event list
  69. */
  70. struct sde_crtc_retire_event {
  71. struct drm_connector *connectors[MAX_CONNECTORS];
  72. int num_connectors;
  73. struct list_head list;
  74. };
  75. /**
  76. * struct sde_crtc_mixer: stores the map for each virtual pipeline in the CRTC
  77. * @hw_lm: LM HW Driver context
  78. * @hw_ctl: CTL Path HW driver context
  79. * @hw_dspp: DSPP HW driver context
  80. * @hw_ds: DS HW driver context
  81. * @encoder: Encoder attached to this lm & ctl
  82. * @mixer_op_mode: mixer blending operation mode
  83. */
  84. struct sde_crtc_mixer {
  85. struct sde_hw_mixer *hw_lm;
  86. struct sde_hw_ctl *hw_ctl;
  87. struct sde_hw_dspp *hw_dspp;
  88. struct sde_hw_ds *hw_ds;
  89. struct drm_encoder *encoder;
  90. u32 mixer_op_mode;
  91. };
  92. /**
  93. * struct sde_crtc_frame_event: stores crtc frame event for crtc processing
  94. * @work: base work structure
  95. * @crtc: Pointer to crtc handling this event
  96. * @connector: pointer to drm connector which is source of frame event
  97. * @list: event list
  98. * @ts: timestamp at queue entry
  99. * @event: event identifier
  100. */
  101. struct sde_crtc_frame_event {
  102. struct kthread_work work;
  103. struct drm_crtc *crtc;
  104. struct drm_connector *connector;
  105. struct list_head list;
  106. ktime_t ts;
  107. u32 event;
  108. };
  109. /**
  110. * struct sde_crtc_event - event callback tracking structure
  111. * @list: Linked list tracking node
  112. * @kt_work: Kthread worker structure
  113. * @sde_crtc: Pointer to associated sde_crtc structure
  114. * @cb_func: Pointer to callback function
  115. * @usr: Pointer to user data to be provided to the callback
  116. */
  117. struct sde_crtc_event {
  118. struct list_head list;
  119. struct kthread_work kt_work;
  120. void *sde_crtc;
  121. void (*cb_func)(struct drm_crtc *crtc, void *usr);
  122. void *usr;
  123. };
  124. /**
  125. * struct sde_crtc_fps_info - structure for measuring fps periodicity
  126. * @frame_count : Total frames during configured periodic duration
  127. * @last_sampled_time_us: Stores the last ktime in microsecs when fps
  128. * was calculated
  129. * @measured_fps : Last measured fps value
  130. * @fps_periodic_duration : Duration in milliseconds to measure the fps.
  131. * Default value is 1 second.
  132. * @time_buf : Buffer for storing ktime of the commits
  133. * @next_time_index : index into time_buf for storing ktime for next commit
  134. */
  135. struct sde_crtc_fps_info {
  136. u32 frame_count;
  137. ktime_t last_sampled_time_us;
  138. u32 measured_fps;
  139. u32 fps_periodic_duration;
  140. ktime_t *time_buf;
  141. u32 next_time_index;
  142. };
  143. /**
  144. * struct sde_ltm_buffer - defines LTM buffer structure.
  145. * @fb: frm framebuffer for the buffer
  146. * @gem: drm gem handle for the buffer
  147. * @asapce : pointer to address space
  148. * @drm_fb_id: framebuffer id associated with this buffer
  149. * @offset: offset for alignment
  150. * @iova: device address
  151. * @kva: kernel virtual address
  152. * @node: list node for LTM buffer list;
  153. */
  154. struct sde_ltm_buffer {
  155. struct drm_framebuffer *fb;
  156. struct drm_gem_object *gem;
  157. struct msm_gem_address_space *aspace;
  158. u32 drm_fb_id;
  159. u32 offset;
  160. u64 iova;
  161. void *kva;
  162. struct list_head node;
  163. };
  164. /**
  165. * struct sde_crtc_misr_info - structure for misr information
  166. * @misr_enable : enable/disable flag
  167. * @misr_frame_count : Number of frames for misr calculation.
  168. */
  169. struct sde_crtc_misr_info {
  170. bool misr_enable;
  171. u32 misr_frame_count;
  172. };
  173. /*
  174. * Maximum number of free event structures to cache
  175. */
  176. #define SDE_CRTC_MAX_EVENT_COUNT 16
  177. /**
  178. * struct sde_crtc - virtualized CRTC data structure
  179. * @base : Base drm crtc structure
  180. * @name : ASCII description of this crtc
  181. * @num_ctls : Number of ctl paths in use
  182. * @num_mixers : Number of mixers in use
  183. * @mixers_swapped: Whether the mixers have been swapped for left/right update
  184. * especially in the case of DSC Merge.
  185. * @mixers : List of active mixers
  186. * @event : Pointer to last received drm vblank event. If there is a
  187. * pending vblank event, this will be non-null.
  188. * @vsync_count : Running count of received vsync events
  189. * @drm_requested_vblank : Whether vblanks have been enabled in the encoder
  190. * @property_info : Opaque structure for generic property support
  191. * @property_defaults : Array of default values for generic property support
  192. * @output_fence : output release fence context
  193. * @stage_cfg : H/w mixer stage configuration
  194. * @debugfs_root : Parent of debugfs node
  195. * @priv_handle : Pointer to external private handle, if present
  196. * @vblank_cb_count : count of vblank callback since last reset
  197. * @play_count : frame count between crtc enable and disable
  198. * @vblank_cb_time : ktime at vblank count reset
  199. * @vblank_last_cb_time : ktime at last vblank notification
  200. * @sysfs_dev : sysfs device node for crtc
  201. * @vsync_event_sf : vsync event notifier sysfs device
  202. * @enabled : whether the SDE CRTC is currently enabled. updated in the
  203. * commit-thread, not state-swap time which is earlier, so
  204. * safe to make decisions on during VBLANK on/off work
  205. * @ds_reconfig : force reconfiguration of the destination scaler block
  206. * @feature_list : list of color processing features supported on a crtc
  207. * @active_list : list of color processing features are active
  208. * @dirty_list : list of color processing features are dirty
  209. * @ad_dirty : list containing ad properties that are dirty
  210. * @ad_active : list containing ad properties that are active
  211. * @crtc_lock : crtc lock around create, destroy and access.
  212. * @frame_pending : Whether or not an update is pending
  213. * @frame_events : static allocation of in-flight frame events
  214. * @frame_event_list : available frame event list
  215. * @spin_lock : spin lock for frame event, transaction status, etc...
  216. * @event_thread : Pointer to event handler thread
  217. * @event_worker : Event worker queue
  218. * @event_cache : Local cache of event worker structures
  219. * @event_free_list : List of available event structures
  220. * @event_lock : Spinlock around event handling code
  221. * @misr_enable_sui : boolean entry indicates misr enable/disable status
  222. * for secure cases.
  223. * @misr_enable_debugfs : boolean entry indicates misr enable/disable status
  224. * from debugfs.
  225. * @misr_frame_count : misr frame count provided by client
  226. * @misr_data : store misr data before turning off the clocks.
  227. * @idle_notify_work: delayed worker to notify idle timeout to user space
  228. * @power_event : registered power event handle
  229. * @cur_perf : current performance committed to clock/bandwidth driver
  230. * @plane_mask_old: keeps track of the planes used in the previous commit
  231. * @frame_trigger_mode: frame trigger mode
  232. * @ltm_buffer_cnt : number of ltm buffers
  233. * @ltm_buffers : struct stores ltm buffer related data
  234. * @ltm_buf_free : list of LTM buffers that are available
  235. * @ltm_buf_busy : list of LTM buffers that are been used by HW
  236. * @ltm_hist_en : flag to indicate whether LTM hist is enabled or not
  237. * @ltm_buffer_lock : muttx to protect ltm_buffers allcation and free
  238. * @ltm_lock : Spinlock to protect ltm buffer_cnt, hist_en and ltm lists
  239. */
  240. struct sde_crtc {
  241. struct drm_crtc base;
  242. char name[SDE_CRTC_NAME_SIZE];
  243. /* HW Resources reserved for the crtc */
  244. u32 num_ctls;
  245. u32 num_mixers;
  246. bool mixers_swapped;
  247. struct sde_crtc_mixer mixers[CRTC_DUAL_MIXERS];
  248. struct drm_pending_vblank_event *event;
  249. u32 vsync_count;
  250. struct msm_property_info property_info;
  251. struct msm_property_data property_data[CRTC_PROP_COUNT];
  252. struct drm_property_blob *blob_info;
  253. /* output fence support */
  254. struct sde_fence_context *output_fence;
  255. struct sde_hw_stage_cfg stage_cfg;
  256. struct dentry *debugfs_root;
  257. void *priv_handle;
  258. u32 vblank_cb_count;
  259. u64 play_count;
  260. ktime_t vblank_cb_time;
  261. ktime_t vblank_last_cb_time;
  262. struct sde_crtc_fps_info fps_info;
  263. struct device *sysfs_dev;
  264. struct kernfs_node *vsync_event_sf;
  265. bool enabled;
  266. bool ds_reconfig;
  267. struct list_head feature_list;
  268. struct list_head active_list;
  269. struct list_head dirty_list;
  270. struct list_head ad_dirty;
  271. struct list_head ad_active;
  272. struct list_head user_event_list;
  273. struct mutex crtc_lock;
  274. struct mutex crtc_cp_lock;
  275. atomic_t frame_pending;
  276. struct sde_crtc_frame_event frame_events[SDE_CRTC_FRAME_EVENT_SIZE];
  277. struct list_head frame_event_list;
  278. spinlock_t spin_lock;
  279. /* for handling internal event thread */
  280. struct sde_crtc_event event_cache[SDE_CRTC_MAX_EVENT_COUNT];
  281. struct list_head event_free_list;
  282. spinlock_t event_lock;
  283. bool misr_enable_sui;
  284. bool misr_enable_debugfs;
  285. u32 misr_frame_count;
  286. struct kthread_delayed_work idle_notify_work;
  287. struct sde_power_event *power_event;
  288. struct sde_core_perf_params cur_perf;
  289. struct sde_core_perf_params new_perf;
  290. u32 plane_mask_old;
  291. /* blob for histogram data */
  292. struct drm_property_blob *hist_blob;
  293. enum frame_trigger_mode_type frame_trigger_mode;
  294. u32 ltm_buffer_cnt;
  295. struct sde_ltm_buffer *ltm_buffers[LTM_BUFFER_SIZE];
  296. struct list_head ltm_buf_free;
  297. struct list_head ltm_buf_busy;
  298. bool ltm_hist_en;
  299. struct drm_msm_ltm_cfg_param ltm_cfg;
  300. struct mutex ltm_buffer_lock;
  301. spinlock_t ltm_lock;
  302. };
  303. #define to_sde_crtc(x) container_of(x, struct sde_crtc, base)
  304. /**
  305. * struct sde_crtc_state - sde container for atomic crtc state
  306. * @base: Base drm crtc state structure
  307. * @connectors : Currently associated drm connectors
  308. * @num_connectors: Number of associated drm connectors
  309. * @rsc_client : sde rsc client when mode is valid
  310. * @is_ppsplit : Whether current topology requires PPSplit special handling
  311. * @bw_control : true if bw/clk controlled by core bw/clk properties
  312. * @bw_split_vote : true if bw controlled by llcc/dram bw properties
  313. * @crtc_roi : Current CRTC ROI. Possibly sub-rectangle of mode.
  314. * Origin top left of CRTC.
  315. * @lm_bounds : LM boundaries based on current mode full resolution, no ROI.
  316. * Origin top left of CRTC.
  317. * @lm_roi : Current LM ROI, possibly sub-rectangle of mode.
  318. * Origin top left of CRTC.
  319. * @user_roi_list : List of user's requested ROIs as from set property
  320. * @property_state: Local storage for msm_prop properties
  321. * @property_values: Current crtc property values
  322. * @input_fence_timeout_ns : Cached input fence timeout, in ns
  323. * @num_dim_layers: Number of dim layers
  324. * @dim_layer: Dim layer configs
  325. * @num_ds: Number of destination scalers to be configured
  326. * @num_ds_enabled: Number of destination scalers enabled
  327. * @ds_dirty: Boolean to indicate if dirty or not
  328. * @ds_cfg: Destination scaler config
  329. * @scl3_lut_cfg: QSEED3 lut config
  330. * @new_perf: new performance state being requested
  331. */
  332. struct sde_crtc_state {
  333. struct drm_crtc_state base;
  334. struct drm_connector *connectors[MAX_CONNECTORS];
  335. int num_connectors;
  336. struct sde_rsc_client *rsc_client;
  337. bool rsc_update;
  338. bool bw_control;
  339. bool bw_split_vote;
  340. bool is_ppsplit;
  341. struct sde_rect crtc_roi;
  342. struct sde_rect lm_bounds[CRTC_DUAL_MIXERS];
  343. struct sde_rect lm_roi[CRTC_DUAL_MIXERS];
  344. struct msm_roi_list user_roi_list;
  345. struct msm_property_state property_state;
  346. struct msm_property_value property_values[CRTC_PROP_COUNT];
  347. uint64_t input_fence_timeout_ns;
  348. uint32_t num_dim_layers;
  349. struct sde_hw_dim_layer dim_layer[SDE_MAX_DIM_LAYERS];
  350. uint32_t num_ds;
  351. uint32_t num_ds_enabled;
  352. bool ds_dirty;
  353. struct sde_hw_ds_cfg ds_cfg[SDE_MAX_DS_COUNT];
  354. struct sde_hw_scaler3_lut_cfg scl3_lut_cfg;
  355. struct sde_core_perf_params new_perf;
  356. };
  357. enum sde_crtc_irq_state {
  358. IRQ_NOINIT,
  359. IRQ_ENABLED,
  360. IRQ_DISABLING,
  361. IRQ_DISABLED,
  362. };
  363. /**
  364. * sde_crtc_irq_info - crtc interrupt info
  365. * @irq: interrupt callback
  366. * @event: event type of the interrupt
  367. * @func: function pointer to enable/disable the interrupt
  368. * @list: list of user customized event in crtc
  369. * @state: state of the interrupt
  370. * @state_lock: spin lock for interrupt state
  371. */
  372. struct sde_crtc_irq_info {
  373. struct sde_irq_callback irq;
  374. u32 event;
  375. int (*func)(struct drm_crtc *crtc, bool en,
  376. struct sde_irq_callback *irq);
  377. struct list_head list;
  378. enum sde_crtc_irq_state state;
  379. spinlock_t state_lock;
  380. };
  381. #define to_sde_crtc_state(x) \
  382. container_of(x, struct sde_crtc_state, base)
  383. /**
  384. * sde_crtc_get_property - query integer value of crtc property
  385. * @S: Pointer to crtc state
  386. * @X: Property index, from enum msm_mdp_crtc_property
  387. * Returns: Integer value of requested property
  388. */
  389. #define sde_crtc_get_property(S, X) \
  390. ((S) && ((X) < CRTC_PROP_COUNT) ? ((S)->property_values[(X)].value) : 0)
  391. /**
  392. * sde_crtc_get_mixer_width - get the mixer width
  393. * Mixer width will be same as panel width(/2 for split)
  394. * unless destination scaler feature is enabled
  395. */
  396. static inline int sde_crtc_get_mixer_width(struct sde_crtc *sde_crtc,
  397. struct sde_crtc_state *cstate, struct drm_display_mode *mode)
  398. {
  399. u32 mixer_width;
  400. if (!sde_crtc || !cstate || !mode)
  401. return 0;
  402. if (cstate->num_ds_enabled)
  403. mixer_width = cstate->ds_cfg[0].lm_width;
  404. else
  405. mixer_width = (sde_crtc->num_mixers == CRTC_DUAL_MIXERS ?
  406. mode->hdisplay / CRTC_DUAL_MIXERS : mode->hdisplay);
  407. return mixer_width;
  408. }
  409. /**
  410. * sde_crtc_get_mixer_height - get the mixer height
  411. * Mixer height will be same as panel height unless
  412. * destination scaler feature is enabled
  413. */
  414. static inline int sde_crtc_get_mixer_height(struct sde_crtc *sde_crtc,
  415. struct sde_crtc_state *cstate, struct drm_display_mode *mode)
  416. {
  417. if (!sde_crtc || !cstate || !mode)
  418. return 0;
  419. return (cstate->num_ds_enabled ?
  420. cstate->ds_cfg[0].lm_height : mode->vdisplay);
  421. }
  422. /**
  423. * sde_crtc_get_num_datapath - get the number of datapath active
  424. * @crtc: Pointer to drm crtc object
  425. */
  426. static inline int sde_crtc_get_num_datapath(struct drm_crtc *crtc)
  427. {
  428. struct sde_crtc *sde_crtc = to_sde_crtc(crtc);
  429. return sde_crtc ? sde_crtc->num_mixers : 0;
  430. }
  431. /**
  432. * sde_crtc_frame_pending - retun the number of pending frames
  433. * @crtc: Pointer to drm crtc object
  434. */
  435. static inline int sde_crtc_frame_pending(struct drm_crtc *crtc)
  436. {
  437. struct sde_crtc *sde_crtc;
  438. if (!crtc)
  439. return -EINVAL;
  440. sde_crtc = to_sde_crtc(crtc);
  441. return atomic_read(&sde_crtc->frame_pending);
  442. }
  443. /**
  444. * sde_crtc_reset_hw - attempt hardware reset on errors
  445. * @crtc: Pointer to DRM crtc instance
  446. * @old_state: Pointer to crtc state for previous commit
  447. * @recovery_events: Whether or not recovery events are enabled
  448. * Returns: Zero if current commit should still be attempted
  449. */
  450. int sde_crtc_reset_hw(struct drm_crtc *crtc, struct drm_crtc_state *old_state,
  451. bool recovery_events);
  452. /**
  453. * sde_crtc_request_frame_reset - requests for next frame reset
  454. * @crtc: Pointer to drm crtc object
  455. */
  456. static inline int sde_crtc_request_frame_reset(struct drm_crtc *crtc)
  457. {
  458. struct sde_crtc *sde_crtc = to_sde_crtc(crtc);
  459. if (sde_crtc->frame_trigger_mode == FRAME_DONE_WAIT_POSTED_START)
  460. sde_crtc_reset_hw(crtc, crtc->state, false);
  461. return 0;
  462. }
  463. /**
  464. * sde_crtc_vblank - enable or disable vblanks for this crtc
  465. * @crtc: Pointer to drm crtc object
  466. * @en: true to enable vblanks, false to disable
  467. */
  468. int sde_crtc_vblank(struct drm_crtc *crtc, bool en);
  469. /**
  470. * sde_crtc_commit_kickoff - trigger kickoff of the commit for this crtc
  471. * @crtc: Pointer to drm crtc object
  472. * @old_state: Pointer to drm crtc old state object
  473. */
  474. void sde_crtc_commit_kickoff(struct drm_crtc *crtc,
  475. struct drm_crtc_state *old_state);
  476. /**
  477. * sde_crtc_prepare_commit - callback to prepare for output fences
  478. * @crtc: Pointer to drm crtc object
  479. * @old_state: Pointer to drm crtc old state object
  480. */
  481. void sde_crtc_prepare_commit(struct drm_crtc *crtc,
  482. struct drm_crtc_state *old_state);
  483. /**
  484. * sde_crtc_complete_commit - callback signalling completion of current commit
  485. * @crtc: Pointer to drm crtc object
  486. * @old_state: Pointer to drm crtc old state object
  487. */
  488. void sde_crtc_complete_commit(struct drm_crtc *crtc,
  489. struct drm_crtc_state *old_state);
  490. /**
  491. * sde_crtc_init - create a new crtc object
  492. * @dev: sde device
  493. * @plane: base plane
  494. * @Return: new crtc object or error
  495. */
  496. struct drm_crtc *sde_crtc_init(struct drm_device *dev, struct drm_plane *plane);
  497. /**
  498. * sde_crtc_post_init - update crtc object with post initialization. It
  499. * can update the debugfs, sysfs, entires.
  500. * @dev: sde device
  501. * @crtc: Pointer to drm crtc structure
  502. */
  503. int sde_crtc_post_init(struct drm_device *dev, struct drm_crtc *crtc);
  504. /**
  505. * sde_crtc_complete_flip - complete flip for clients
  506. * @crtc: Pointer to drm crtc object
  507. * @file: client to cancel's file handle
  508. */
  509. void sde_crtc_complete_flip(struct drm_crtc *crtc, struct drm_file *file);
  510. /**
  511. * sde_crtc_register_custom_event - api for enabling/disabling crtc event
  512. * @kms: Pointer to sde_kms
  513. * @crtc_drm: Pointer to crtc object
  514. * @event: Event that client is interested
  515. * @en: Flag to enable/disable the event
  516. */
  517. int sde_crtc_register_custom_event(struct sde_kms *kms,
  518. struct drm_crtc *crtc_drm, u32 event, bool en);
  519. /**
  520. * sde_crtc_get_intf_mode - get interface mode of the given crtc
  521. * @crtc: Pointert to DRM crtc
  522. * @crtc: Pointert to DRM crtc_state
  523. */
  524. enum sde_intf_mode sde_crtc_get_intf_mode(struct drm_crtc *crtc,
  525. struct drm_crtc_state *cstate);
  526. /**
  527. * sde_crtc_get_fps_mode - get frame rate of the given crtc
  528. * @crtc: Pointert to crtc
  529. */
  530. u32 sde_crtc_get_fps_mode(struct drm_crtc *crtc);
  531. /**
  532. * sde_crtc_get_client_type - check the crtc type- rt, rsc_rt, etc.
  533. * @crtc: Pointer to crtc
  534. */
  535. static inline enum sde_crtc_client_type sde_crtc_get_client_type(
  536. struct drm_crtc *crtc)
  537. {
  538. struct sde_crtc_state *cstate =
  539. crtc ? to_sde_crtc_state(crtc->state) : NULL;
  540. if (!cstate)
  541. return RT_CLIENT;
  542. return cstate->rsc_client ? RT_RSC_CLIENT : RT_CLIENT;
  543. }
  544. /**
  545. * sde_crtc_is_rt_client - check if real-time client or not
  546. * @crtc: Pointer to DRM crtc
  547. * @crtc_state: Pointer to DRM crtc_state
  548. */
  549. static inline bool sde_crtc_is_rt_client(struct drm_crtc *crtc,
  550. struct drm_crtc_state *cstate)
  551. {
  552. if (!crtc || !cstate)
  553. return true;
  554. return (sde_crtc_get_intf_mode(crtc, cstate) != INTF_MODE_WB_LINE);
  555. }
  556. /**
  557. * sde_crtc_is_enabled - check if sde crtc is enabled or not
  558. * @crtc: Pointer to crtc
  559. */
  560. static inline bool sde_crtc_is_enabled(struct drm_crtc *crtc)
  561. {
  562. return crtc ? crtc->enabled : false;
  563. }
  564. /**
  565. * sde_crtc_is_reset_required - validate the reset request based on the
  566. * pm_suspend and crtc's active status. crtc's are left active
  567. * on pm_suspend during LP1/LP2 states, as the display is still
  568. * left ON. Avoid reset for the subsequent pm_resume in such cases.
  569. * @crtc: Pointer to crtc
  570. * return: false if in suspend state and crtc active, true otherwise
  571. */
  572. static inline bool sde_crtc_is_reset_required(struct drm_crtc *crtc)
  573. {
  574. /*
  575. * reset is required even when there is no crtc_state as it is required
  576. * to create the initial state object
  577. */
  578. if (!crtc || !crtc->state)
  579. return true;
  580. /* reset not required if crtc is active during suspend state */
  581. if (sde_kms_is_suspend_state(crtc->dev) && crtc->state->active)
  582. return false;
  583. return true;
  584. }
  585. /**
  586. * sde_crtc_event_queue - request event callback
  587. * @crtc: Pointer to drm crtc structure
  588. * @func: Pointer to callback function
  589. * @usr: Pointer to user data to be passed to callback
  590. * @color_processing_event: True if color processing event
  591. * Returns: Zero on success
  592. */
  593. int sde_crtc_event_queue(struct drm_crtc *crtc,
  594. void (*func)(struct drm_crtc *crtc, void *usr),
  595. void *usr, bool color_processing_event);
  596. /**
  597. * sde_crtc_get_crtc_roi - retrieve the crtc_roi from the given state object
  598. * used to allow the planes to adjust their final lm out_xy value in the
  599. * case of partial update
  600. * @crtc_state: Pointer to crtc state
  601. * @crtc_roi: Output pointer to crtc roi in the given state
  602. */
  603. void sde_crtc_get_crtc_roi(struct drm_crtc_state *state,
  604. const struct sde_rect **crtc_roi);
  605. /**
  606. * sde_crtc_is_crtc_roi_dirty - retrieve whether crtc_roi was updated this frame
  607. * Note: Only use during atomic_check since dirty properties may be popped
  608. * @crtc_state: Pointer to crtc state
  609. * Return: true if roi is dirty, false otherwise
  610. */
  611. bool sde_crtc_is_crtc_roi_dirty(struct drm_crtc_state *state);
  612. /** sde_crt_get_secure_level - retrieve the secure level from the give state
  613. * object, this is used to determine the secure state of the crtc
  614. * @crtc : Pointer to drm crtc structure
  615. * @usr: Pointer to drm crtc state
  616. * return: secure_level
  617. */
  618. static inline int sde_crtc_get_secure_level(struct drm_crtc *crtc,
  619. struct drm_crtc_state *state)
  620. {
  621. if (!crtc || !state)
  622. return -EINVAL;
  623. return sde_crtc_get_property(to_sde_crtc_state(state),
  624. CRTC_PROP_SECURITY_LEVEL);
  625. }
  626. /** sde_crtc_atomic_check_has_modeset - checks if the new_crtc_state in the
  627. * drm_atomic_state has a modeset
  628. * @state : pointer to drm_atomic_state
  629. * @crtc : Pointer to drm crtc structure
  630. * Returns true if crtc has modeset
  631. */
  632. static inline bool sde_crtc_atomic_check_has_modeset(
  633. struct drm_atomic_state *state, struct drm_crtc *crtc)
  634. {
  635. struct drm_crtc_state *crtc_state;
  636. if (!state || !crtc)
  637. return false;
  638. crtc_state = drm_atomic_get_new_crtc_state(state,
  639. crtc);
  640. return (crtc_state && drm_atomic_crtc_needs_modeset(crtc_state));
  641. }
  642. /**
  643. * sde_crtc_get_secure_transition - determines the operations to be
  644. * performed before transitioning to secure state
  645. * This function should be called after swapping the new state
  646. * @crtc: Pointer to drm crtc structure
  647. * @old_crtc_state: Poniter to previous CRTC state
  648. * Returns the bitmask of operations need to be performed, -Error in
  649. * case of error cases
  650. */
  651. int sde_crtc_get_secure_transition_ops(struct drm_crtc *crtc,
  652. struct drm_crtc_state *old_crtc_state,
  653. bool old_valid_fb);
  654. /**
  655. * sde_crtc_find_plane_fb_modes - finds the modes of all planes attached
  656. * to crtc
  657. * @crtc: Pointer to DRM crtc object
  658. * @fb_ns: number of non secure planes
  659. * @fb_sec: number of secure-playback planes
  660. * @fb_sec_dir: number of secure-ui/secure-camera planes
  661. */
  662. int sde_crtc_find_plane_fb_modes(struct drm_crtc *crtc,
  663. uint32_t *fb_ns, uint32_t *fb_sec, uint32_t *fb_sec_dir);
  664. /**
  665. * sde_crtc_state_find_plane_fb_modes - finds the modes of all planes attached
  666. * to the crtc state
  667. * @crtc_state: Pointer to DRM crtc state object
  668. * @fb_ns: number of non secure planes
  669. * @fb_sec: number of secure-playback planes
  670. * @fb_sec_dir: number of secure-ui/secure-camera planes
  671. */
  672. int sde_crtc_state_find_plane_fb_modes(struct drm_crtc_state *state,
  673. uint32_t *fb_ns, uint32_t *fb_sec, uint32_t *fb_sec_dir);
  674. /**
  675. * sde_crtc_secure_ctrl - Initiates the transition between secure and
  676. * non-secure world
  677. * @crtc: Pointer to crtc
  678. * @post_commit: if this operation is triggered after commit
  679. */
  680. int sde_crtc_secure_ctrl(struct drm_crtc *crtc, bool post_commit);
  681. /**
  682. * sde_crtc_helper_reset_properties - reset properties to default values in the
  683. * given DRM CRTC state object
  684. * @crtc: Pointer to DRM crtc object
  685. * @crtc_state: Pointer to DRM crtc state object
  686. * Returns: 0 on success, negative errno on failure
  687. */
  688. int sde_crtc_helper_reset_custom_properties(struct drm_crtc *crtc,
  689. struct drm_crtc_state *crtc_state);
  690. /**
  691. * sde_crtc_timeline_status - current buffer timeline status
  692. * @crtc: Pointer to crtc
  693. */
  694. void sde_crtc_timeline_status(struct drm_crtc *crtc);
  695. /**
  696. * sde_crtc_update_cont_splash_settings - update mixer settings
  697. * during device bootup for cont_splash use case
  698. * @crtc: Pointer to drm crtc structure
  699. */
  700. void sde_crtc_update_cont_splash_settings(
  701. struct drm_crtc *crtc);
  702. /**
  703. * sde_crtc_misr_setup - to configure and enable/disable MISR
  704. * @crtc: Pointer to drm crtc structure
  705. * @enable: boolean to indicate enable/disable misr
  706. * @frame_count: frame_count to be configured
  707. */
  708. void sde_crtc_misr_setup(struct drm_crtc *crtc, bool enable, u32 frame_count);
  709. /**
  710. * sde_crtc_get_misr_info - to configure and enable/disable MISR
  711. * @crtc: Pointer to drm crtc structure
  712. * @crtc_misr_info: Pointer to crtc misr info structure
  713. */
  714. void sde_crtc_get_misr_info(struct drm_crtc *crtc,
  715. struct sde_crtc_misr_info *crtc_misr_info);
  716. #endif /* _SDE_CRTC_H_ */