sde_kms.h 22 KB

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