sde_kms.h 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755
  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_KMS_H__
  19. #define __SDE_KMS_H__
  20. #include <linux/msm_ion.h>
  21. #include <linux/pm_domain.h>
  22. #include <linux/pm_qos.h>
  23. #include "msm_drv.h"
  24. #include "msm_kms.h"
  25. #include "msm_mmu.h"
  26. #include "msm_gem.h"
  27. #include "sde_dbg.h"
  28. #include "sde_hw_catalog.h"
  29. #include "sde_hw_ctl.h"
  30. #include "sde_hw_lm.h"
  31. #include "sde_hw_pingpong.h"
  32. #include "sde_hw_interrupts.h"
  33. #include "sde_hw_wb.h"
  34. #include "sde_hw_top.h"
  35. #include "sde_hw_uidle.h"
  36. #include "sde_rm.h"
  37. #include "sde_power_handle.h"
  38. #include "sde_irq.h"
  39. #include "sde_core_perf.h"
  40. #define DRMID(x) ((x) ? (x)->base.id : -1)
  41. /**
  42. * SDE_DEBUG - macro for kms/plane/crtc/encoder/connector logs
  43. * @fmt: Pointer to format string
  44. */
  45. #define SDE_DEBUG(fmt, ...) \
  46. do { \
  47. if (unlikely(drm_debug & DRM_UT_KMS)) \
  48. DRM_DEBUG(fmt, ##__VA_ARGS__); \
  49. else \
  50. pr_debug(fmt, ##__VA_ARGS__); \
  51. } while (0)
  52. /**
  53. * SDE_INFO - macro for kms/plane/crtc/encoder/connector logs
  54. * @fmt: Pointer to format string
  55. */
  56. #define SDE_INFO(fmt, ...) \
  57. do { \
  58. if (unlikely(drm_debug & DRM_UT_KMS)) \
  59. DRM_INFO(fmt, ##__VA_ARGS__); \
  60. else \
  61. pr_info(fmt, ##__VA_ARGS__); \
  62. } while (0)
  63. /**
  64. * SDE_DEBUG_DRIVER - macro for hardware driver logging
  65. * @fmt: Pointer to format string
  66. */
  67. #define SDE_DEBUG_DRIVER(fmt, ...) \
  68. do { \
  69. if (unlikely(drm_debug & DRM_UT_DRIVER)) \
  70. DRM_ERROR(fmt, ##__VA_ARGS__); \
  71. else \
  72. pr_debug(fmt, ##__VA_ARGS__); \
  73. } while (0)
  74. #define SDE_ERROR(fmt, ...) pr_err("[sde error]" fmt, ##__VA_ARGS__)
  75. #define POPULATE_RECT(rect, a, b, c, d, Q16_flag) \
  76. do { \
  77. (rect)->x = (Q16_flag) ? (a) >> 16 : (a); \
  78. (rect)->y = (Q16_flag) ? (b) >> 16 : (b); \
  79. (rect)->w = (Q16_flag) ? (c) >> 16 : (c); \
  80. (rect)->h = (Q16_flag) ? (d) >> 16 : (d); \
  81. } while (0)
  82. #define CHECK_LAYER_BOUNDS(offset, size, max_size) \
  83. (((size) > (max_size)) || ((offset) > ((max_size) - (size))))
  84. /**
  85. * ktime_compare_safe - compare two ktime structures
  86. * This macro is similar to the standard ktime_compare() function, but
  87. * attempts to also handle ktime overflows.
  88. * @A: First ktime value
  89. * @B: Second ktime value
  90. * Returns: -1 if A < B, 0 if A == B, 1 if A > B
  91. */
  92. #define ktime_compare_safe(A, B) \
  93. ktime_compare(ktime_sub((A), (B)), ktime_set(0, 0))
  94. #define SDE_NAME_SIZE 12
  95. #define DEFAULT_FPS 60
  96. /* timeout in frames waiting for frame done */
  97. #define SDE_FRAME_DONE_TIMEOUT 60
  98. /* max active secure client counts allowed */
  99. #define MAX_ALLOWED_SECURE_CLIENT_CNT 1
  100. /* max active crtc when secure client is active */
  101. #define MAX_ALLOWED_CRTC_CNT_DURING_SECURE 1
  102. /* max virtual encoders per secure crtc */
  103. #define MAX_ALLOWED_ENCODER_CNT_PER_SECURE_CRTC 1
  104. /* defines the operations required for secure state transition */
  105. #define SDE_KMS_OPS_SECURE_STATE_CHANGE BIT(0)
  106. #define SDE_KMS_OPS_WAIT_FOR_TX_DONE BIT(1)
  107. #define SDE_KMS_OPS_CLEANUP_PLANE_FB BIT(2)
  108. #define SDE_KMS_OPS_PREPARE_PLANE_FB BIT(3)
  109. /* ESD status check interval in miliseconds */
  110. #define STATUS_CHECK_INTERVAL_MS 5000
  111. /**
  112. * enum sde_kms_smmu_state: smmu state
  113. * @ATTACHED: all the context banks are attached.
  114. * @DETACHED: all the context banks are detached.
  115. * @DETACHED_SEC: secure context bank is detached.
  116. * @ATTACH_ALL_REQ: transient state of attaching context banks.
  117. * @DETACH_ALL_REQ: transient state of detaching context banks.
  118. * @DETACH_SEC_REQ: tranisent state of secure context bank is detached
  119. * @ATTACH_SEC_REQ: transient state of attaching secure context bank.
  120. */
  121. enum sde_kms_smmu_state {
  122. ATTACHED = 0,
  123. DETACHED,
  124. DETACHED_SEC,
  125. ATTACH_ALL_REQ,
  126. DETACH_ALL_REQ,
  127. DETACH_SEC_REQ,
  128. ATTACH_SEC_REQ,
  129. };
  130. /**
  131. * enum sde_kms_smmu_state_transition_type: state transition type
  132. * @NONE: no pending state transitions
  133. * @PRE_COMMIT: state transitions should be done before processing the commit
  134. * @POST_COMMIT: state transitions to be done after processing the commit.
  135. */
  136. enum sde_kms_smmu_state_transition_type {
  137. NONE,
  138. PRE_COMMIT,
  139. POST_COMMIT
  140. };
  141. /**
  142. * enum sde_kms_sui_misr_state: state request for enabling/disabling MISR
  143. * @NONE: no request
  144. * @ENABLE_SUI_MISR_REQ: request to enable sui MISR
  145. * @DISABLE_SUI_MISR_REQ: request to disable sui MISR
  146. */
  147. enum sde_kms_sui_misr_state {
  148. SUI_MISR_NONE,
  149. SUI_MISR_ENABLE_REQ,
  150. SUI_MISR_DISABLE_REQ
  151. };
  152. /*
  153. * @FRAME_DONE_WAIT_DEFAULT: waits for frame N pp_done interrupt before
  154. * triggering frame N+1.
  155. * @FRAME_DONE_WAIT_SERIALIZE: serialize pp_done and ctl_start irq for frame
  156. * N without next frame trigger wait.
  157. * @FRAME_DONE_WAIT_POSTED_START: Do not wait for pp_done interrupt for any
  158. * frame. Wait will trigger only for error case.
  159. */
  160. enum frame_trigger_mode_type {
  161. FRAME_DONE_WAIT_DEFAULT,
  162. FRAME_DONE_WAIT_SERIALIZE,
  163. FRAME_DONE_WAIT_POSTED_START,
  164. };
  165. /**
  166. * struct sde_kms_smmu_state_data: stores the smmu state and transition type
  167. * @state: current state of smmu context banks
  168. * @prev_state: previous state of smmu context banks
  169. * @secure_level: secure level cached from crtc
  170. * @prev_secure_level: previous secure level
  171. * @transition_type: transition request type
  172. * @transition_error: whether there is error while transitioning the state
  173. */
  174. struct sde_kms_smmu_state_data {
  175. uint32_t state;
  176. uint32_t prev_state;
  177. uint32_t secure_level;
  178. uint32_t prev_secure_level;
  179. uint32_t transition_type;
  180. uint32_t transition_error;
  181. uint32_t sui_misr_state;
  182. };
  183. /*
  184. * struct sde_irq_callback - IRQ callback handlers
  185. * @list: list to callback
  186. * @func: intr handler
  187. * @arg: argument for the handler
  188. */
  189. struct sde_irq_callback {
  190. struct list_head list;
  191. void (*func)(void *arg, int irq_idx);
  192. void *arg;
  193. };
  194. /**
  195. * struct sde_irq: IRQ structure contains callback registration info
  196. * @total_irq: total number of irq_idx obtained from HW interrupts mapping
  197. * @irq_cb_tbl: array of IRQ callbacks setting
  198. * @enable_counts array of IRQ enable counts
  199. * @cb_lock: callback lock
  200. * @debugfs_file: debugfs file for irq statistics
  201. */
  202. struct sde_irq {
  203. u32 total_irqs;
  204. struct list_head *irq_cb_tbl;
  205. atomic_t *enable_counts;
  206. atomic_t *irq_counts;
  207. spinlock_t cb_lock;
  208. struct dentry *debugfs_file;
  209. };
  210. /**
  211. * struct sde_kms_frame_event_cb_data : info of drm objects of a frame event
  212. * @crtc: pointer to drm crtc object registered for frame event
  213. * @connector: pointer to drm connector which is source of frame event
  214. */
  215. struct sde_kms_frame_event_cb_data {
  216. struct drm_crtc *crtc;
  217. struct drm_connector *connector;
  218. };
  219. struct sde_kms {
  220. struct msm_kms base;
  221. struct drm_device *dev;
  222. uint32_t core_rev;
  223. struct sde_mdss_cfg *catalog;
  224. struct generic_pm_domain genpd;
  225. bool genpd_init;
  226. struct msm_gem_address_space *aspace[MSM_SMMU_DOMAIN_MAX];
  227. struct sde_power_event *power_event;
  228. /* directory entry for debugfs */
  229. struct dentry *debugfs_vbif;
  230. /* io/register spaces: */
  231. void __iomem *mmio, *vbif[VBIF_MAX], *reg_dma, *sid;
  232. unsigned long mmio_len, vbif_len[VBIF_MAX], reg_dma_len, sid_len;
  233. struct regulator *vdd;
  234. struct regulator *mmagic;
  235. struct regulator *venus;
  236. struct sde_irq_controller irq_controller;
  237. struct sde_hw_intr *hw_intr;
  238. struct sde_irq irq_obj;
  239. int irq_num; /* mdss irq number */
  240. bool irq_enabled;
  241. struct sde_core_perf perf;
  242. /* saved atomic state during system suspend */
  243. struct drm_atomic_state *suspend_state;
  244. bool suspend_block;
  245. struct sde_rm rm;
  246. bool rm_init;
  247. struct sde_splash_data splash_data;
  248. struct sde_hw_vbif *hw_vbif[VBIF_MAX];
  249. struct sde_hw_mdp *hw_mdp;
  250. struct sde_hw_uidle *hw_uidle;
  251. struct sde_hw_sid *hw_sid;
  252. int dsi_display_count;
  253. void **dsi_displays;
  254. int wb_display_count;
  255. void **wb_displays;
  256. int dp_display_count;
  257. void **dp_displays;
  258. int dp_stream_count;
  259. bool has_danger_ctrl;
  260. struct sde_kms_smmu_state_data smmu_state;
  261. atomic_t detach_sec_cb;
  262. atomic_t detach_all_cb;
  263. struct mutex secure_transition_lock;
  264. bool first_kickoff;
  265. bool qdss_enabled;
  266. bool pm_suspend_clk_dump;
  267. cpumask_t irq_cpu_mask;
  268. atomic_t irq_vote_count;
  269. struct dev_pm_qos_request pm_qos_irq_req[NR_CPUS];
  270. struct irq_affinity_notify affinity_notify;
  271. struct sde_vm *vm;
  272. };
  273. struct vsync_info {
  274. u32 frame_count;
  275. u32 line_count;
  276. };
  277. #define to_sde_kms(x) container_of(x, struct sde_kms, base)
  278. /**
  279. * sde_is_custom_client - whether or not to enable non-standard customizations
  280. *
  281. * Return: Whether or not the 'sdeclient' module parameter was set on boot up
  282. */
  283. bool sde_is_custom_client(void);
  284. /**
  285. * sde_kms_get_hw_version - get the hw revision - client is expected to
  286. * enable the power resources before making this call
  287. * @dev: Pointer to drm device
  288. */
  289. static inline u32 sde_kms_get_hw_version(struct drm_device *dev)
  290. {
  291. struct sde_kms *sde_kms;
  292. if (!ddev_to_msm_kms(dev))
  293. return 0;
  294. sde_kms = to_sde_kms(ddev_to_msm_kms(dev));
  295. return readl_relaxed(sde_kms->mmio + 0x0);
  296. }
  297. /**
  298. * sde_kms_power_resource_is_enabled - whether or not power resource is enabled
  299. * @dev: Pointer to drm device
  300. * Return: true if power resource is enabled; false otherwise
  301. */
  302. static inline bool sde_kms_power_resource_is_enabled(struct drm_device *dev)
  303. {
  304. if (!dev)
  305. return false;
  306. return pm_runtime_enabled(dev->dev);
  307. }
  308. /**
  309. * sde_kms_is_suspend_state - whether or not the system is pm suspended
  310. * @dev: Pointer to drm device
  311. * Return: Suspend status
  312. */
  313. static inline bool sde_kms_is_suspend_state(struct drm_device *dev)
  314. {
  315. if (!ddev_to_msm_kms(dev))
  316. return false;
  317. return to_sde_kms(ddev_to_msm_kms(dev))->suspend_state != NULL;
  318. }
  319. /**
  320. * sde_kms_is_suspend_blocked - whether or not commits are blocked due to pm
  321. * suspend status
  322. * @dev: Pointer to drm device
  323. * Return: True if commits should be rejected due to pm suspend
  324. */
  325. static inline bool sde_kms_is_suspend_blocked(struct drm_device *dev)
  326. {
  327. if (!sde_kms_is_suspend_state(dev))
  328. return false;
  329. return to_sde_kms(ddev_to_msm_kms(dev))->suspend_block;
  330. }
  331. /**
  332. * sde_kms_is_secure_session_inprogress - to indicate if secure-session is in
  333. * currently in-progress based on the current smmu_state
  334. *
  335. * @sde_kms: Pointer to sde_kms
  336. *
  337. * return: true if secure-session is in progress; false otherwise
  338. */
  339. static inline bool sde_kms_is_secure_session_inprogress(struct sde_kms *sde_kms)
  340. {
  341. bool ret = false;
  342. if (!sde_kms)
  343. return false;
  344. mutex_lock(&sde_kms->secure_transition_lock);
  345. if (((sde_kms->catalog->sui_ns_allowed) &&
  346. (sde_kms->smmu_state.secure_level == SDE_DRM_SEC_ONLY) &&
  347. ((sde_kms->smmu_state.state == DETACHED_SEC) ||
  348. (sde_kms->smmu_state.state == DETACH_SEC_REQ) ||
  349. (sde_kms->smmu_state.state == ATTACH_SEC_REQ)))
  350. || (((sde_kms->smmu_state.state == DETACHED) ||
  351. (sde_kms->smmu_state.state == DETACH_ALL_REQ) ||
  352. (sde_kms->smmu_state.state == ATTACH_ALL_REQ))))
  353. ret = true;
  354. mutex_unlock(&sde_kms->secure_transition_lock);
  355. return ret;
  356. }
  357. /**
  358. * sde_kms_is_vbif_operation_allowed - resticts the VBIF programming
  359. * during secure-ui, if the sec_ui_misr feature is enabled
  360. *
  361. * @sde_kms: Pointer to sde_kms
  362. *
  363. * return: false if secure-session is in progress; true otherwise
  364. */
  365. static inline bool sde_kms_is_vbif_operation_allowed(struct sde_kms *sde_kms)
  366. {
  367. if (!sde_kms)
  368. return false;
  369. if (!sde_kms->catalog->sui_misr_supported)
  370. return true;
  371. return !sde_kms_is_secure_session_inprogress(sde_kms);
  372. }
  373. /**
  374. * sde_kms_is_cp_operation_allowed - resticts the CP programming
  375. * during secure-ui, if the non-secure context banks are detached
  376. *
  377. * @sde_kms: Pointer to sde_kms
  378. */
  379. static inline bool sde_kms_is_cp_operation_allowed(struct sde_kms *sde_kms)
  380. {
  381. if (!sde_kms || !sde_kms->catalog)
  382. return false;
  383. if (sde_kms->catalog->sui_ns_allowed)
  384. return true;
  385. return !sde_kms_is_secure_session_inprogress(sde_kms);
  386. }
  387. /**
  388. * Debugfs functions - extra helper functions for debugfs support
  389. *
  390. * Main debugfs documentation is located at,
  391. *
  392. * Documentation/filesystems/debugfs.txt
  393. *
  394. * @sde_debugfs_get_root: Get root dentry for SDE_KMS's debugfs node
  395. */
  396. /**
  397. * sde_debugfs_get_root - Return root directory entry for KMS's debugfs
  398. *
  399. * The return value should be passed as the 'parent' argument to subsequent
  400. * debugfs create calls.
  401. *
  402. * @sde_kms: Pointer to SDE's KMS structure
  403. *
  404. * Return: dentry pointer for SDE's debugfs location
  405. */
  406. void *sde_debugfs_get_root(struct sde_kms *sde_kms);
  407. /**
  408. * SDE info management functions
  409. * These functions/definitions allow for building up a 'sde_info' structure
  410. * containing one or more "key=value\n" entries.
  411. */
  412. #define SDE_KMS_INFO_MAX_SIZE 4096
  413. /**
  414. * struct sde_kms_info - connector information structure container
  415. * @data: Array of information character data
  416. * @len: Current length of information data
  417. * @staged_len: Temporary data buffer length, commit to
  418. * len using sde_kms_info_stop
  419. * @start: Whether or not a partial data entry was just started
  420. */
  421. struct sde_kms_info {
  422. char data[SDE_KMS_INFO_MAX_SIZE];
  423. uint32_t len;
  424. uint32_t staged_len;
  425. bool start;
  426. };
  427. /**
  428. * SDE_KMS_INFO_DATA - Macro for accessing sde_kms_info data bytes
  429. * @S: Pointer to sde_kms_info structure
  430. * Returns: Pointer to byte data
  431. */
  432. #define SDE_KMS_INFO_DATA(S) ((S) ? ((struct sde_kms_info *)(S))->data \
  433. : NULL)
  434. /**
  435. * SDE_KMS_INFO_DATALEN - Macro for accessing sde_kms_info data length
  436. * it adds an extra character length to count null.
  437. * @S: Pointer to sde_kms_info structure
  438. * Returns: Size of available byte data
  439. */
  440. #define SDE_KMS_INFO_DATALEN(S) ((S) ? ((struct sde_kms_info *)(S))->len + 1 \
  441. : 0)
  442. /**
  443. * sde_kms_info_reset - reset sde_kms_info structure
  444. * @info: Pointer to sde_kms_info structure
  445. */
  446. void sde_kms_info_reset(struct sde_kms_info *info);
  447. /**
  448. * sde_kms_info_add_keyint - add integer value to 'sde_kms_info'
  449. * @info: Pointer to sde_kms_info structure
  450. * @key: Pointer to key string
  451. * @value: Signed 64-bit integer value
  452. */
  453. void sde_kms_info_add_keyint(struct sde_kms_info *info,
  454. const char *key,
  455. int64_t value);
  456. /**
  457. * sde_kms_info_add_keystr - add string value to 'sde_kms_info'
  458. * @info: Pointer to sde_kms_info structure
  459. * @key: Pointer to key string
  460. * @value: Pointer to string value
  461. */
  462. void sde_kms_info_add_keystr(struct sde_kms_info *info,
  463. const char *key,
  464. const char *value);
  465. /**
  466. * sde_kms_info_start - begin adding key to 'sde_kms_info'
  467. * Usage:
  468. * sde_kms_info_start(key)
  469. * sde_kms_info_append(val_1)
  470. * ...
  471. * sde_kms_info_append(val_n)
  472. * sde_kms_info_stop
  473. * @info: Pointer to sde_kms_info structure
  474. * @key: Pointer to key string
  475. */
  476. void sde_kms_info_start(struct sde_kms_info *info,
  477. const char *key);
  478. /**
  479. * sde_kms_info_append - append value string to 'sde_kms_info'
  480. * Usage:
  481. * sde_kms_info_start(key)
  482. * sde_kms_info_append(val_1)
  483. * ...
  484. * sde_kms_info_append(val_n)
  485. * sde_kms_info_stop
  486. * @info: Pointer to sde_kms_info structure
  487. * @str: Pointer to partial value string
  488. */
  489. void sde_kms_info_append(struct sde_kms_info *info,
  490. const char *str);
  491. /**
  492. * sde_kms_info_append_format - append format code string to 'sde_kms_info'
  493. * Usage:
  494. * sde_kms_info_start(key)
  495. * sde_kms_info_append_format(fourcc, modifier)
  496. * ...
  497. * sde_kms_info_stop
  498. * @info: Pointer to sde_kms_info structure
  499. * @pixel_format: FOURCC format code
  500. * @modifier: 64-bit drm format modifier
  501. */
  502. void sde_kms_info_append_format(struct sde_kms_info *info,
  503. uint32_t pixel_format,
  504. uint64_t modifier);
  505. /**
  506. * sde_kms_info_stop - finish adding key to 'sde_kms_info'
  507. * Usage:
  508. * sde_kms_info_start(key)
  509. * sde_kms_info_append(val_1)
  510. * ...
  511. * sde_kms_info_append(val_n)
  512. * sde_kms_info_stop
  513. * @info: Pointer to sde_kms_info structure
  514. */
  515. void sde_kms_info_stop(struct sde_kms_info *info);
  516. /**
  517. * sde_kms_rect_intersect - intersect two rectangles
  518. * @r1: first rectangle
  519. * @r2: scissor rectangle
  520. * @result: result rectangle, all 0's on no intersection found
  521. */
  522. void sde_kms_rect_intersect(const struct sde_rect *r1,
  523. const struct sde_rect *r2,
  524. struct sde_rect *result);
  525. /**
  526. * sde_kms_rect_merge_rectangles - merge a rectangle list into one rect
  527. * @rois: pointer to the list of rois
  528. * @result: output rectangle, all 0 on error
  529. */
  530. void sde_kms_rect_merge_rectangles(const struct msm_roi_list *rois,
  531. struct sde_rect *result);
  532. /**
  533. * sde_kms_rect_is_equal - compares two rects
  534. * @r1: rect value to compare
  535. * @r2: rect value to compare
  536. *
  537. * Returns 1 if the rects are same, 0 otherwise.
  538. */
  539. static inline bool sde_kms_rect_is_equal(struct sde_rect *r1,
  540. struct sde_rect *r2)
  541. {
  542. if ((!r1 && r2) || (r1 && !r2))
  543. return false;
  544. if (!r1 && !r2)
  545. return true;
  546. return r1->x == r2->x && r1->y == r2->y && r1->w == r2->w &&
  547. r1->h == r2->h;
  548. }
  549. /**
  550. * sde_kms_rect_is_null - returns true if the width or height of a rect is 0
  551. * @rect: rectangle to check for zero size
  552. * @Return: True if width or height of rectangle is 0
  553. */
  554. static inline bool sde_kms_rect_is_null(const struct sde_rect *r)
  555. {
  556. if (!r)
  557. return true;
  558. return (!r->w || !r->h);
  559. }
  560. /*
  561. * sde_in_trusted_vm - checks the executing VM
  562. * return: true, if the device driver is executing in the trusted VM
  563. * false, if the device driver is executing in the primary VM
  564. */
  565. static inline bool sde_in_trusted_vm(const struct sde_kms *sde_kms)
  566. {
  567. if (sde_kms && sde_kms->catalog)
  568. return sde_kms->catalog->trusted_vm_env;
  569. return false;
  570. }
  571. /**
  572. * Vblank enable/disable functions
  573. */
  574. int sde_enable_vblank(struct msm_kms *kms, struct drm_crtc *crtc);
  575. void sde_disable_vblank(struct msm_kms *kms, struct drm_crtc *crtc);
  576. /**
  577. * smmu attach/detach functions
  578. * @sde_kms: poiner to sde_kms structure
  579. * @secure_only: if true only secure contexts are attached/detached, else
  580. * all contexts are attached/detached/
  581. */
  582. int sde_kms_mmu_attach(struct sde_kms *sde_kms, bool secure_only);
  583. int sde_kms_mmu_detach(struct sde_kms *sde_kms, bool secure_only);
  584. /**
  585. * sde_kms_timeline_status - provides current timeline status
  586. * @dev: Pointer to drm device
  587. */
  588. void sde_kms_timeline_status(struct drm_device *dev);
  589. /**
  590. * sde_kms_handle_recovery - handler function for FIFO overflow issue
  591. * @encoder: pointer to drm encoder structure
  592. * return: 0 on success; error code otherwise
  593. */
  594. int sde_kms_handle_recovery(struct drm_encoder *encoder);
  595. /**
  596. * sde_kms_cpu_vote_for_irq() - API to keep pm_qos latency vote on cpu
  597. * where mdss_irq is scheduled
  598. * @sde_kms: pointer to sde_kms structure
  599. * @enable: true if enable request, false otherwise.
  600. */
  601. void sde_kms_cpu_vote_for_irq(struct sde_kms *sde_kms, bool enable);
  602. /**
  603. * sde_kms_get_io_resources() - reads associated register range
  604. * @kms: pointer to sde_kms structure
  605. * @io_res: pointer to msm_io_res struct to populate the ranges
  606. * Return: error code.
  607. */
  608. int sde_kms_get_io_resources(struct sde_kms *kms, struct msm_io_res *io_res);
  609. /**
  610. * sde_kms_vm_trusted_resource_init - reserve/initialize the HW/SW resources
  611. * @sde_kms: poiner to sde_kms structure
  612. * return: 0 on success; error code otherwise
  613. */
  614. int sde_kms_vm_trusted_resource_init(struct sde_kms *sde_kms);
  615. /**
  616. * sde_kms_vm_trusted_resource_deinit - release the HW/SW resources
  617. * @sde_kms: poiner to sde_kms structure
  618. */
  619. void sde_kms_vm_trusted_resource_deinit(struct sde_kms *sde_kms);
  620. /**
  621. * sde_kms_vm_trusted_post_commit - function to prepare the VM after the
  622. * last commit before releasing the HW
  623. * resources from trusted VM
  624. * @sde_kms: pointer to sde_kms
  625. * @state: current frames atomic commit state
  626. */
  627. int sde_kms_vm_trusted_post_commit(struct sde_kms *sde_kms,
  628. struct drm_atomic_state *state);
  629. /**
  630. * sde_kms_vm_primary_post_commit - function to prepare the VM after the
  631. * last commit before assign the HW
  632. * resources from primary VM
  633. * @sde_kms: pointer to sde_kms
  634. * @state: current frames atomic commit state
  635. */
  636. int sde_kms_vm_primary_post_commit(struct sde_kms *sde_kms,
  637. struct drm_atomic_state *state);
  638. /**
  639. * sde_kms_vm_trusted_prepare_commit - function to prepare the VM before the
  640. * the first commit after the accepting
  641. * the HW resources in trusted VM.
  642. * @sde_kms: pointer to sde_kms
  643. * @state: current frame's atomic commit state
  644. */
  645. int sde_kms_vm_trusted_prepare_commit(struct sde_kms *sde_kms,
  646. struct drm_atomic_state *state);
  647. /**
  648. * sde_kms_vm_primary_prepare_commit - function to prepare the VM before the
  649. * the first commit after the reclaming
  650. * the HW resources in trusted VM.
  651. * @sde_kms: pointer to sde_kms
  652. * @state: current frame's atomic commit state
  653. */
  654. int sde_kms_vm_primary_prepare_commit(struct sde_kms *sde_kms,
  655. struct drm_atomic_state *state);
  656. #endif /* __sde_kms_H__ */