sde_crtc.h 32 KB

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