sde_crtc.h 28 KB

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