sde_crtc.h 29 KB

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