sde_connector.h 33 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright (c) 2016-2020, The Linux Foundation. All rights reserved.
  4. */
  5. #ifndef _SDE_CONNECTOR_H_
  6. #define _SDE_CONNECTOR_H_
  7. #include <drm/msm_drm_pp.h>
  8. #include <drm/drmP.h>
  9. #include <drm/drm_atomic.h>
  10. #include <drm/drm_panel.h>
  11. #include "msm_drv.h"
  12. #include "msm_prop.h"
  13. #include "sde_kms.h"
  14. #include "sde_fence.h"
  15. #define SDE_CONNECTOR_NAME_SIZE 16
  16. #define SDE_CONNECTOR_DHDR_MEMPOOL_MAX_SIZE SZ_32
  17. struct sde_connector;
  18. struct sde_connector_state;
  19. /**
  20. * struct sde_connector_ops - callback functions for generic sde connector
  21. * Individual callbacks documented below.
  22. */
  23. struct sde_connector_ops {
  24. /**
  25. * post_init - perform additional initialization steps
  26. * @connector: Pointer to drm connector structure
  27. * @display: Pointer to private display handle
  28. * Returns: Zero on success
  29. */
  30. int (*post_init)(struct drm_connector *connector,
  31. void *display);
  32. /**
  33. * set_info_blob - initialize given info blob
  34. * @connector: Pointer to drm connector structure
  35. * @info: Pointer to sde connector info structure
  36. * @display: Pointer to private display handle
  37. * @mode_info: Pointer to mode info structure
  38. * Returns: Zero on success
  39. */
  40. int (*set_info_blob)(struct drm_connector *connector,
  41. void *info,
  42. void *display,
  43. struct msm_mode_info *mode_info);
  44. /**
  45. * detect - determine if connector is connected
  46. * @connector: Pointer to drm connector structure
  47. * @force: Force detect setting from drm framework
  48. * @display: Pointer to private display handle
  49. * Returns: Connector 'is connected' status
  50. */
  51. enum drm_connector_status (*detect)(struct drm_connector *connector,
  52. bool force,
  53. void *display);
  54. /**
  55. * get_modes - add drm modes via drm_mode_probed_add()
  56. * @connector: Pointer to drm connector structure
  57. * @display: Pointer to private display handle
  58. * @avail_res: Pointer with current available resources
  59. * Returns: Number of modes added
  60. */
  61. int (*get_modes)(struct drm_connector *connector,
  62. void *display,
  63. const struct msm_resource_caps_info *avail_res);
  64. /**
  65. * update_pps - update pps command for the display panel
  66. * @connector: Pointer to drm connector structure
  67. * @pps_cmd: Pointer to pps command
  68. * @display: Pointer to private display handle
  69. * Returns: Zero on success
  70. */
  71. int (*update_pps)(struct drm_connector *connector,
  72. char *pps_cmd, void *display);
  73. /**
  74. * mode_valid - determine if specified mode is valid
  75. * @connector: Pointer to drm connector structure
  76. * @mode: Pointer to drm mode structure
  77. * @display: Pointer to private display handle
  78. * @avail_res: Pointer with curr available resources
  79. * Returns: Validity status for specified mode
  80. */
  81. enum drm_mode_status (*mode_valid)(struct drm_connector *connector,
  82. struct drm_display_mode *mode,
  83. void *display,
  84. const struct msm_resource_caps_info *avail_res);
  85. /**
  86. * set_property - set property value
  87. * @connector: Pointer to drm connector structure
  88. * @state: Pointer to drm connector state structure
  89. * @property_index: DRM property index
  90. * @value: Incoming property value
  91. * @display: Pointer to private display structure
  92. * Returns: Zero on success
  93. */
  94. int (*set_property)(struct drm_connector *connector,
  95. struct drm_connector_state *state,
  96. int property_index,
  97. uint64_t value,
  98. void *display);
  99. /**
  100. * get_property - get property value
  101. * @connector: Pointer to drm connector structure
  102. * @state: Pointer to drm connector state structure
  103. * @property_index: DRM property index
  104. * @value: Pointer to variable for accepting property value
  105. * @display: Pointer to private display structure
  106. * Returns: Zero on success
  107. */
  108. int (*get_property)(struct drm_connector *connector,
  109. struct drm_connector_state *state,
  110. int property_index,
  111. uint64_t *value,
  112. void *display);
  113. /**
  114. * get_info - get display information
  115. * @connector: Pointer to drm connector structure
  116. * @info: Pointer to msm display info structure
  117. * @display: Pointer to private display structure
  118. * Returns: Zero on success
  119. */
  120. int (*get_info)(struct drm_connector *connector,
  121. struct msm_display_info *info, void *display);
  122. /**
  123. * get_mode_info - retrieve mode information
  124. * @connector: Pointer to drm connector structure
  125. * @drm_mode: Display mode set for the display
  126. * @mode_info: Out parameter. information of the display mode
  127. * @display: Pointer to private display structure
  128. * @avail_res: Pointer with curr available resources
  129. * Returns: Zero on success
  130. */
  131. int (*get_mode_info)(struct drm_connector *connector,
  132. const struct drm_display_mode *drm_mode,
  133. struct msm_mode_info *mode_info,
  134. void *display,
  135. const struct msm_resource_caps_info *avail_res);
  136. /**
  137. * enable_event - notify display of event registration/unregistration
  138. * @connector: Pointer to drm connector structure
  139. * @event_idx: SDE connector event index
  140. * @enable: Whether the event is being enabled/disabled
  141. * @display: Pointer to private display structure
  142. */
  143. void (*enable_event)(struct drm_connector *connector,
  144. uint32_t event_idx, bool enable, void *display);
  145. /**
  146. * set_backlight - set backlight level
  147. * @connector: Pointer to drm connector structure
  148. * @display: Pointer to private display structure
  149. * @bl_lvel: Backlight level
  150. */
  151. int (*set_backlight)(struct drm_connector *connector,
  152. void *display, u32 bl_lvl);
  153. /**
  154. * set_colorspace - set colorspace for connector
  155. * @connector: Pointer to drm connector structure
  156. * @display: Pointer to private display structure
  157. */
  158. int (*set_colorspace)(struct drm_connector *connector,
  159. void *display);
  160. /**
  161. * soft_reset - perform a soft reset on the connector
  162. * @display: Pointer to private display structure
  163. * Return: Zero on success, -ERROR otherwise
  164. */
  165. int (*soft_reset)(void *display);
  166. /**
  167. * pre_kickoff - trigger display to program kickoff-time features
  168. * @connector: Pointer to drm connector structure
  169. * @display: Pointer to private display structure
  170. * @params: Parameter bundle of connector-stored information for
  171. * kickoff-time programming into the display
  172. * Returns: Zero on success
  173. */
  174. int (*pre_kickoff)(struct drm_connector *connector,
  175. void *display,
  176. struct msm_display_kickoff_params *params);
  177. /**
  178. * clk_ctrl - perform clk enable/disable on the connector
  179. * @handle: Pointer to clk handle
  180. * @type: Type of clks
  181. * @enable: State of clks
  182. */
  183. int (*clk_ctrl)(void *handle, u32 type, u32 state);
  184. /**
  185. * set_power - update dpms setting
  186. * @connector: Pointer to drm connector structure
  187. * @power_mode: One of the following,
  188. * SDE_MODE_DPMS_ON
  189. * SDE_MODE_DPMS_LP1
  190. * SDE_MODE_DPMS_LP2
  191. * SDE_MODE_DPMS_OFF
  192. * @display: Pointer to private display structure
  193. * Returns: Zero on success
  194. */
  195. int (*set_power)(struct drm_connector *connector,
  196. int power_mode, void *display);
  197. /**
  198. * get_dst_format - get dst_format from display
  199. * @connector: Pointer to drm connector structure
  200. * @display: Pointer to private display handle
  201. * Returns: dst_format of display
  202. */
  203. enum dsi_pixel_format (*get_dst_format)(struct drm_connector *connector,
  204. void *display);
  205. /**
  206. * post_kickoff - display to program post kickoff-time features
  207. * @connector: Pointer to drm connector structure
  208. * @params: Parameter bundle of connector-stored information for
  209. * post kickoff programming into the display
  210. * Returns: Zero on success
  211. */
  212. int (*post_kickoff)(struct drm_connector *connector,
  213. struct msm_display_conn_params *params);
  214. /**
  215. * post_open - calls connector to process post open functionalities
  216. * @display: Pointer to private display structure
  217. */
  218. void (*post_open)(struct drm_connector *connector, void *display);
  219. /**
  220. * check_status - check status of connected display panel
  221. * @connector: Pointer to drm connector structure
  222. * @display: Pointer to private display handle
  223. * @te_check_override: Whether check TE from panel or default check
  224. * Returns: positive value for success, negetive or zero for failure
  225. */
  226. int (*check_status)(struct drm_connector *connector, void *display,
  227. bool te_check_override);
  228. /**
  229. * cmd_transfer - Transfer command to the connected display panel
  230. * @connector: Pointer to drm connector structure
  231. * @display: Pointer to private display handle
  232. * @cmd_buf: Command buffer
  233. * @cmd_buf_len: Command buffer length in bytes
  234. * Returns: Zero for success, negetive for failure
  235. */
  236. int (*cmd_transfer)(struct drm_connector *connector,
  237. void *display, const char *cmd_buf,
  238. u32 cmd_buf_len);
  239. /**
  240. * config_hdr - configure HDR
  241. * @connector: Pointer to drm connector structure
  242. * @display: Pointer to private display handle
  243. * @c_state: Pointer to connector state
  244. * Returns: Zero on success, negative error code for failures
  245. */
  246. int (*config_hdr)(struct drm_connector *connector, void *display,
  247. struct sde_connector_state *c_state);
  248. /**
  249. * atomic_best_encoder - atomic best encoder selection for connector
  250. * @connector: Pointer to drm connector structure
  251. * @display: Pointer to private display handle
  252. * @c_state: Pointer to connector state
  253. * Returns: valid drm_encoder for success
  254. */
  255. struct drm_encoder *(*atomic_best_encoder)(
  256. struct drm_connector *connector,
  257. void *display,
  258. struct drm_connector_state *c_state);
  259. /**
  260. * atomic_check - atomic check handling for connector
  261. * @connector: Pointer to drm connector structure
  262. * @display: Pointer to private display handle
  263. * @c_state: Pointer to connector state
  264. * Returns: valid drm_encoder for success
  265. */
  266. int (*atomic_check)(struct drm_connector *connector,
  267. void *display,
  268. struct drm_atomic_state *state);
  269. /**
  270. * pre_destroy - handle pre destroy operations for the connector
  271. * @connector: Pointer to drm connector structure
  272. * @display: Pointer to private display handle
  273. * Returns: Zero on success, negative error code for failures
  274. */
  275. void (*pre_destroy)(struct drm_connector *connector, void *display);
  276. /**
  277. * cont_splash_config - initialize splash resources
  278. * @display: Pointer to private display handle
  279. * Returns: zero for success, negetive for failure
  280. */
  281. int (*cont_splash_config)(void *display);
  282. /**
  283. * get_panel_vfp - returns original panel vfp
  284. * @display: Pointer to private display handle
  285. * @h_active: width
  286. * @v_active: height
  287. * Returns: v_front_porch on success error-code on failure
  288. */
  289. int (*get_panel_vfp)(void *display, int h_active, int v_active);
  290. /**
  291. * get_default_lm - returns default number of lm
  292. * @display: Pointer to private display handle
  293. * @num_lm: Pointer to number of lms to be populated
  294. * Returns: zero for success, negetive for failure
  295. */
  296. int (*get_default_lms)(void *display, u32 *num_lm);
  297. /**
  298. * prepare_commit - trigger display to program pre-commit time features
  299. * @display: Pointer to private display structure
  300. * @params: Parameter bundle of connector-stored information for
  301. * pre commit time programming into the display
  302. * Returns: Zero on success
  303. */
  304. int (*prepare_commit)(void *display,
  305. struct msm_display_conn_params *params);
  306. };
  307. /**
  308. * enum sde_connector_display_type - list of display types
  309. */
  310. enum sde_connector_display {
  311. SDE_CONNECTOR_UNDEFINED,
  312. SDE_CONNECTOR_PRIMARY,
  313. SDE_CONNECTOR_SECONDARY,
  314. SDE_CONNECTOR_MAX
  315. };
  316. /**
  317. * enum sde_connector_events - list of recognized connector events
  318. */
  319. enum sde_connector_events {
  320. SDE_CONN_EVENT_VID_DONE, /* video mode frame done */
  321. SDE_CONN_EVENT_CMD_DONE, /* command mode frame done */
  322. SDE_CONN_EVENT_VID_FIFO_OVERFLOW, /* dsi fifo overflow error */
  323. SDE_CONN_EVENT_CMD_FIFO_UNDERFLOW, /* dsi fifo underflow error */
  324. SDE_CONN_EVENT_COUNT,
  325. };
  326. /**
  327. * struct sde_connector_evt - local event registration entry structure
  328. * @cb_func: Pointer to desired callback function
  329. * @usr: User pointer to pass to callback on event trigger
  330. * Returns: Zero success, negetive for failure
  331. */
  332. struct sde_connector_evt {
  333. int (*cb_func)(uint32_t event_idx,
  334. uint32_t instance_idx, void *usr,
  335. uint32_t data0, uint32_t data1,
  336. uint32_t data2, uint32_t data3);
  337. void *usr;
  338. };
  339. struct sde_connector_dyn_hdr_metadata {
  340. u8 dynamic_hdr_payload[SDE_CONNECTOR_DHDR_MEMPOOL_MAX_SIZE];
  341. int dynamic_hdr_payload_size;
  342. bool dynamic_hdr_update;
  343. };
  344. /**
  345. * struct sde_connector - local sde connector structure
  346. * @base: Base drm connector structure
  347. * @connector_type: Set to one of DRM_MODE_CONNECTOR_ types
  348. * @encoder: Pointer to preferred drm encoder
  349. * @panel: Pointer to drm panel, if present
  350. * @display: Pointer to private display data structure
  351. * @drv_panel: Pointer to interface driver's panel module, if present
  352. * @mst_port: Pointer to mst port, if present
  353. * @mmu_secure: MMU id for secure buffers
  354. * @mmu_unsecure: MMU id for unsecure buffers
  355. * @name: ASCII name of connector
  356. * @lock: Mutex lock object for this structure
  357. * @retire_fence: Retire fence context reference
  358. * @ops: Local callback function pointer table
  359. * @dpms_mode: DPMS property setting from user space
  360. * @lp_mode: LP property setting from user space
  361. * @last_panel_power_mode: Last consolidated dpms/lp mode setting
  362. * @property_info: Private structure for generic property handling
  363. * @property_data: Array of private data for generic property handling
  364. * @blob_caps: Pointer to blob structure for 'capabilities' property
  365. * @blob_hdr: Pointer to blob structure for 'hdr_properties' property
  366. * @blob_ext_hdr: Pointer to blob structure for 'ext_hdr_properties' property
  367. * @blob_dither: Pointer to blob structure for default dither config
  368. * @blob_mode_info: Pointer to blob structure for mode info
  369. * @fb_kmap: true if kernel mapping of framebuffer is requested
  370. * @event_table: Array of registered events
  371. * @event_lock: Lock object for event_table
  372. * @bl_device: backlight device node
  373. * @status_work: work object to perform status checks
  374. * @esd_status_interval: variable to change ESD check interval in millisec
  375. * @panel_dead: Flag to indicate if panel has gone bad
  376. * @esd_status_check: Flag to indicate if ESD thread is scheduled or not
  377. * @bl_scale_dirty: Flag to indicate PP BL scale value(s) is changed
  378. * @bl_scale: BL scale value for ABA feature
  379. * @bl_scale_sv: BL scale value for sunlight visibility feature
  380. * @unset_bl_level: BL level that needs to be set later
  381. * @hdr_eotf: Electro optical transfer function obtained from HDR block
  382. * @hdr_metadata_type_one: Metadata type one obtained from HDR block
  383. * @hdr_max_luminance: desired max luminance obtained from HDR block
  384. * @hdr_avg_luminance: desired avg luminance obtained from HDR block
  385. * @hdr_min_luminance: desired min luminance obtained from HDR block
  386. * @hdr_supported: does the sink support HDR content
  387. * @color_enc_fmt: Colorimetry encoding formats of sink
  388. * @allow_bl_update: Flag to indicate if BL update is allowed currently or not
  389. * @qsync_mode: Cached Qsync mode, 0=disabled, 1=continuous mode
  390. * @qsync_updated: Qsync settings were updated
  391. * @colorspace_updated: Colorspace property was updated
  392. * last_cmd_tx_sts: status of the last command transfer
  393. * @hdr_capable: external hdr support present
  394. * @core_clk_rate: MDP core clk rate used for dynamic HDR packet calculation
  395. */
  396. struct sde_connector {
  397. struct drm_connector base;
  398. int connector_type;
  399. struct drm_encoder *encoder;
  400. void *display;
  401. void *drv_panel;
  402. void *mst_port;
  403. struct msm_gem_address_space *aspace[SDE_IOMMU_DOMAIN_MAX];
  404. char name[SDE_CONNECTOR_NAME_SIZE];
  405. struct mutex lock;
  406. struct sde_fence_context *retire_fence;
  407. struct sde_connector_ops ops;
  408. int dpms_mode;
  409. int lp_mode;
  410. int last_panel_power_mode;
  411. struct msm_property_info property_info;
  412. struct msm_property_data property_data[CONNECTOR_PROP_COUNT];
  413. struct drm_property_blob *blob_caps;
  414. struct drm_property_blob *blob_hdr;
  415. struct drm_property_blob *blob_ext_hdr;
  416. struct drm_property_blob *blob_dither;
  417. struct drm_property_blob *blob_mode_info;
  418. bool fb_kmap;
  419. struct sde_connector_evt event_table[SDE_CONN_EVENT_COUNT];
  420. spinlock_t event_lock;
  421. struct backlight_device *bl_device;
  422. struct delayed_work status_work;
  423. u32 esd_status_interval;
  424. bool panel_dead;
  425. bool esd_status_check;
  426. bool bl_scale_dirty;
  427. u32 bl_scale;
  428. u32 bl_scale_sv;
  429. u32 unset_bl_level;
  430. bool allow_bl_update;
  431. u32 hdr_eotf;
  432. bool hdr_metadata_type_one;
  433. u32 hdr_max_luminance;
  434. u32 hdr_avg_luminance;
  435. u32 hdr_min_luminance;
  436. bool hdr_supported;
  437. u32 color_enc_fmt;
  438. u8 hdr_plus_app_ver;
  439. u32 qsync_mode;
  440. bool qsync_updated;
  441. bool colorspace_updated;
  442. bool last_cmd_tx_sts;
  443. bool hdr_capable;
  444. };
  445. /**
  446. * to_sde_connector - convert drm_connector pointer to sde connector pointer
  447. * @X: Pointer to drm_connector structure
  448. * Returns: Pointer to sde_connector structure
  449. */
  450. #define to_sde_connector(x) container_of((x), struct sde_connector, base)
  451. /**
  452. * sde_connector_get_display - get sde connector's private display pointer
  453. * @C: Pointer to drm connector structure
  454. * Returns: Pointer to associated private display structure
  455. */
  456. #define sde_connector_get_display(C) \
  457. ((C) ? to_sde_connector((C))->display : NULL)
  458. /**
  459. * sde_connector_get_encoder - get sde connector's private encoder pointer
  460. * @C: Pointer to drm connector structure
  461. * Returns: Pointer to associated private encoder structure
  462. */
  463. #define sde_connector_get_encoder(C) \
  464. ((C) ? to_sde_connector((C))->encoder : NULL)
  465. /**
  466. * sde_connector_qsync_updated - indicates if connector updated qsync
  467. * @C: Pointer to drm connector structure
  468. * Returns: True if qsync is updated; false otherwise
  469. */
  470. #define sde_connector_is_qsync_updated(C) \
  471. ((C) ? to_sde_connector((C))->qsync_updated : 0)
  472. /**
  473. * sde_connector_get_qsync_mode - get sde connector's qsync_mode
  474. * @C: Pointer to drm connector structure
  475. * Returns: Current cached qsync_mode for given connector
  476. */
  477. #define sde_connector_get_qsync_mode(C) \
  478. ((C) ? to_sde_connector((C))->qsync_mode : 0)
  479. /**
  480. * sde_connector_get_propinfo - get sde connector's property info pointer
  481. * @C: Pointer to drm connector structure
  482. * Returns: Pointer to associated private property info structure
  483. */
  484. #define sde_connector_get_propinfo(C) \
  485. ((C) ? &to_sde_connector((C))->property_info : NULL)
  486. /**
  487. * struct sde_connector_state - private connector status structure
  488. * @base: Base drm connector structure
  489. * @out_fb: Pointer to output frame buffer, if applicable
  490. * @property_state: Local storage for msm_prop properties
  491. * @property_values: Local cache of current connector property values
  492. * @rois: Regions of interest structure for mapping CRTC to Connector output
  493. * @property_blobs: blob properties
  494. * @mode_info: local copy of msm_mode_info struct
  495. * @hdr_meta: HDR metadata info passed from userspace
  496. * @dyn_hdr_meta: Dynamic HDR metadata payload and state tracking
  497. * @old_topology_name: topology of previous atomic state. remove this in later
  498. * kernel versions which provide drm_atomic_state old_state pointers
  499. */
  500. struct sde_connector_state {
  501. struct drm_connector_state base;
  502. struct drm_framebuffer *out_fb;
  503. struct msm_property_state property_state;
  504. struct msm_property_value property_values[CONNECTOR_PROP_COUNT];
  505. struct msm_roi_list rois;
  506. struct drm_property_blob *property_blobs[CONNECTOR_PROP_BLOBCOUNT];
  507. struct msm_mode_info mode_info;
  508. struct drm_msm_ext_hdr_metadata hdr_meta;
  509. struct sde_connector_dyn_hdr_metadata dyn_hdr_meta;
  510. enum sde_rm_topology_name old_topology_name;
  511. };
  512. /**
  513. * to_sde_connector_state - convert drm_connector_state pointer to
  514. * sde connector state pointer
  515. * @X: Pointer to drm_connector_state structure
  516. * Returns: Pointer to sde_connector_state structure
  517. */
  518. #define to_sde_connector_state(x) \
  519. container_of((x), struct sde_connector_state, base)
  520. /**
  521. * sde_connector_get_property - query integer value of connector property
  522. * @S: Pointer to drm connector state
  523. * @X: Property index, from enum msm_mdp_connector_property
  524. * Returns: Integer value of requested property
  525. */
  526. #define sde_connector_get_property(S, X) \
  527. ((S) && ((X) < CONNECTOR_PROP_COUNT) ? \
  528. (to_sde_connector_state((S))->property_values[(X)].value) : 0)
  529. /**
  530. * sde_connector_get_property_state - retrieve property state cache
  531. * @S: Pointer to drm connector state
  532. * Returns: Pointer to local property state structure
  533. */
  534. #define sde_connector_get_property_state(S) \
  535. ((S) ? (&to_sde_connector_state((S))->property_state) : NULL)
  536. /**
  537. * sde_connector_get_out_fb - query out_fb value from sde connector state
  538. * @S: Pointer to drm connector state
  539. * Returns: Output fb associated with specified connector state
  540. */
  541. #define sde_connector_get_out_fb(S) \
  542. ((S) ? to_sde_connector_state((S))->out_fb : 0)
  543. /**
  544. * sde_connector_get_topology_name - helper accessor to retrieve topology_name
  545. * @connector: pointer to drm connector
  546. * Returns: value of the CONNECTOR_PROP_TOPOLOGY_NAME property or 0
  547. */
  548. static inline uint64_t sde_connector_get_topology_name(
  549. struct drm_connector *connector)
  550. {
  551. if (!connector || !connector->state)
  552. return 0;
  553. return sde_connector_get_property(connector->state,
  554. CONNECTOR_PROP_TOPOLOGY_NAME);
  555. }
  556. /**
  557. * sde_connector_get_old_topology_name - helper accessor to retrieve
  558. * topology_name for the previous mode
  559. * @connector: pointer to drm connector state
  560. * Returns: cached value of the previous topology, or SDE_RM_TOPOLOGY_NONE
  561. */
  562. static inline enum sde_rm_topology_name sde_connector_get_old_topology_name(
  563. struct drm_connector_state *state)
  564. {
  565. struct sde_connector_state *c_state = to_sde_connector_state(state);
  566. if (!state)
  567. return SDE_RM_TOPOLOGY_NONE;
  568. return c_state->old_topology_name;
  569. }
  570. /**
  571. * sde_connector_set_old_topology_name - helper to cache value of previous
  572. * mode's topology
  573. * @connector: pointer to drm connector state
  574. * Returns: 0 on success, negative errno on failure
  575. */
  576. static inline int sde_connector_set_old_topology_name(
  577. struct drm_connector_state *state,
  578. enum sde_rm_topology_name top)
  579. {
  580. struct sde_connector_state *c_state = to_sde_connector_state(state);
  581. if (!state)
  582. return -EINVAL;
  583. c_state->old_topology_name = top;
  584. return 0;
  585. }
  586. /**
  587. * sde_connector_get_lp - helper accessor to retrieve LP state
  588. * @connector: pointer to drm connector
  589. * Returns: value of the CONNECTOR_PROP_LP property or 0
  590. */
  591. static inline uint64_t sde_connector_get_lp(
  592. struct drm_connector *connector)
  593. {
  594. if (!connector || !connector->state)
  595. return 0;
  596. return sde_connector_get_property(connector->state,
  597. CONNECTOR_PROP_LP);
  598. }
  599. /**
  600. * sde_connector_set_property_for_commit - add property set to atomic state
  601. * Add a connector state property update for the specified property index
  602. * to the atomic state in preparation for a drm_atomic_commit.
  603. * @connector: Pointer to drm connector
  604. * @atomic_state: Pointer to DRM atomic state structure for commit
  605. * @property_idx: Connector property index
  606. * @value: Updated property value
  607. * Returns: Zero on success
  608. */
  609. int sde_connector_set_property_for_commit(struct drm_connector *connector,
  610. struct drm_atomic_state *atomic_state,
  611. uint32_t property_idx, uint64_t value);
  612. /**
  613. * sde_connector_init - create drm connector object for a given display
  614. * @dev: Pointer to drm device struct
  615. * @encoder: Pointer to associated encoder
  616. * @panel: Pointer to associated panel, can be NULL
  617. * @display: Pointer to associated display object
  618. * @ops: Pointer to callback operations function table
  619. * @connector_poll: Set to appropriate DRM_CONNECTOR_POLL_ setting
  620. * @connector_type: Set to appropriate DRM_MODE_CONNECTOR_ type
  621. * Returns: Pointer to newly created drm connector struct
  622. */
  623. struct drm_connector *sde_connector_init(struct drm_device *dev,
  624. struct drm_encoder *encoder,
  625. struct drm_panel *panel,
  626. void *display,
  627. const struct sde_connector_ops *ops,
  628. int connector_poll,
  629. int connector_type);
  630. /**
  631. * sde_connector_prepare_fence - prepare fence support for current commit
  632. * @connector: Pointer to drm connector object
  633. */
  634. void sde_connector_prepare_fence(struct drm_connector *connector);
  635. /**
  636. * sde_connector_complete_commit - signal completion of current commit
  637. * @connector: Pointer to drm connector object
  638. * @ts: timestamp to be updated in the fence signalling
  639. * @fence_event: enum value to indicate nature of fence event
  640. */
  641. void sde_connector_complete_commit(struct drm_connector *connector,
  642. ktime_t ts, enum sde_fence_event fence_event);
  643. /**
  644. * sde_connector_commit_reset - reset the completion signal
  645. * @connector: Pointer to drm connector object
  646. * @ts: timestamp to be updated in the fence signalling
  647. */
  648. void sde_connector_commit_reset(struct drm_connector *connector, ktime_t ts);
  649. /**
  650. * sde_connector_get_info - query display specific information
  651. * @connector: Pointer to drm connector object
  652. * @info: Pointer to msm display information structure
  653. * Returns: Zero on success
  654. */
  655. int sde_connector_get_info(struct drm_connector *connector,
  656. struct msm_display_info *info);
  657. /**
  658. * sde_connector_clk_ctrl - enables/disables the connector clks
  659. * @connector: Pointer to drm connector object
  660. * @enable: true/false to enable/disable
  661. * Returns: Zero on success
  662. */
  663. int sde_connector_clk_ctrl(struct drm_connector *connector, bool enable);
  664. /**
  665. * sde_connector_get_dpms - query dpms setting
  666. * @connector: Pointer to drm connector structure
  667. * Returns: Current DPMS setting for connector
  668. */
  669. int sde_connector_get_dpms(struct drm_connector *connector);
  670. /**
  671. * sde_connector_set_qsync_params - set status of qsync_updated for current
  672. * frame and update the cached qsync_mode
  673. * @connector: pointer to drm connector
  674. *
  675. * This must be called after the connector set_property values are applied,
  676. * and before sde_connector's qsync_updated or qsync_mode fields are accessed.
  677. * It must only be called once per frame update for the given connector.
  678. */
  679. void sde_connector_set_qsync_params(struct drm_connector *connector);
  680. /**
  681. * sde_connector_complete_qsync_commit - callback signalling completion
  682. * of qsync, if modified for the current commit
  683. * @conn - Pointer to drm connector object
  684. * @params - Parameter bundle of connector-stored information for
  685. * post kickoff programming into the display
  686. */
  687. void sde_connector_complete_qsync_commit(struct drm_connector *conn,
  688. struct msm_display_conn_params *params);
  689. /**
  690. * sde_connector_get_dyn_hdr_meta - returns pointer to connector state's dynamic
  691. * HDR metadata info
  692. * @connector: pointer to drm connector
  693. */
  694. struct sde_connector_dyn_hdr_metadata *sde_connector_get_dyn_hdr_meta(
  695. struct drm_connector *connector);
  696. /**
  697. * sde_connector_trigger_event - indicate that an event has occurred
  698. * Any callbacks that have been registered against this event will
  699. * be called from the same thread context.
  700. * @connector: Pointer to drm connector structure
  701. * @event_idx: Index of event to trigger
  702. * @instance_idx: Event-specific "instance index" to pass to callback
  703. * @data0: Event-specific "data" to pass to callback
  704. * @data1: Event-specific "data" to pass to callback
  705. * @data2: Event-specific "data" to pass to callback
  706. * @data3: Event-specific "data" to pass to callback
  707. * Returns: Zero on success
  708. */
  709. int sde_connector_trigger_event(void *drm_connector,
  710. uint32_t event_idx, uint32_t instance_idx,
  711. uint32_t data0, uint32_t data1,
  712. uint32_t data2, uint32_t data3);
  713. /**
  714. * sde_connector_register_event - register a callback function for an event
  715. * @connector: Pointer to drm connector structure
  716. * @event_idx: Index of event to register
  717. * @cb_func: Pointer to desired callback function
  718. * @usr: User pointer to pass to callback on event trigger
  719. * Returns: Zero on success
  720. */
  721. int sde_connector_register_event(struct drm_connector *connector,
  722. uint32_t event_idx,
  723. int (*cb_func)(uint32_t event_idx,
  724. uint32_t instance_idx, void *usr,
  725. uint32_t data0, uint32_t data1,
  726. uint32_t data2, uint32_t data3),
  727. void *usr);
  728. /**
  729. * sde_connector_unregister_event - unregister all callbacks for an event
  730. * @connector: Pointer to drm connector structure
  731. * @event_idx: Index of event to register
  732. */
  733. void sde_connector_unregister_event(struct drm_connector *connector,
  734. uint32_t event_idx);
  735. /**
  736. * sde_connector_register_custom_event - register for async events
  737. * @kms: Pointer to sde_kms
  738. * @conn_drm: Pointer to drm connector object
  739. * @event: Event for which request is being sent
  740. * @en: Flag to enable/disable the event
  741. * Returns: Zero on success
  742. */
  743. int sde_connector_register_custom_event(struct sde_kms *kms,
  744. struct drm_connector *conn_drm, u32 event, bool en);
  745. /**
  746. * sde_connector_pre_kickoff - trigger kickoff time feature programming
  747. * @connector: Pointer to drm connector object
  748. * Returns: Zero on success
  749. */
  750. int sde_connector_pre_kickoff(struct drm_connector *connector);
  751. /**
  752. * sde_connector_prepare_commit - trigger commit time feature programming
  753. * @connector: Pointer to drm connector object
  754. * Returns: Zero on success
  755. */
  756. int sde_connector_prepare_commit(struct drm_connector *connector);
  757. /**
  758. * sde_connector_needs_offset - adjust the output fence offset based on
  759. * display type
  760. * @connector: Pointer to drm connector object
  761. * Returns: true if offset is required, false for all other cases.
  762. */
  763. static inline bool sde_connector_needs_offset(struct drm_connector *connector)
  764. {
  765. struct sde_connector *c_conn;
  766. if (!connector)
  767. return false;
  768. c_conn = to_sde_connector(connector);
  769. return (c_conn->connector_type != DRM_MODE_CONNECTOR_VIRTUAL);
  770. }
  771. /**
  772. * sde_connector_get_dither_cfg - get dither property data
  773. * @conn: Pointer to drm_connector struct
  774. * @state: Pointer to drm_connector_state struct
  775. * @cfg: Pointer to pointer to dither cfg
  776. * @len: length of the dither data
  777. * @idle_pc: flag to indicate idle_pc_restore happened
  778. * Returns: Zero on success
  779. */
  780. int sde_connector_get_dither_cfg(struct drm_connector *conn,
  781. struct drm_connector_state *state, void **cfg,
  782. size_t *len, bool idle_pc);
  783. /**
  784. * sde_connector_set_blob_data - set connector blob property data
  785. * @conn: Pointer to drm_connector struct
  786. * @state: Pointer to the drm_connector_state struct
  787. * @prop_id: property id to be populated
  788. * Returns: Zero on success
  789. */
  790. int sde_connector_set_blob_data(struct drm_connector *conn,
  791. struct drm_connector_state *state,
  792. enum msm_mdp_conn_property prop_id);
  793. /**
  794. * sde_connector_roi_v1_check_roi - validate connector ROI
  795. * @conn_state: Pointer to drm_connector_state struct
  796. * Returns: Zero on success
  797. */
  798. int sde_connector_roi_v1_check_roi(struct drm_connector_state *conn_state);
  799. /**
  800. * sde_connector_schedule_status_work - manage ESD thread
  801. * conn: Pointer to drm_connector struct
  802. * @en: flag to start/stop ESD thread
  803. */
  804. void sde_connector_schedule_status_work(struct drm_connector *conn, bool en);
  805. /**
  806. * sde_connector_helper_reset_properties - reset properties to default values in
  807. * the given DRM connector state object
  808. * @connector: Pointer to DRM connector object
  809. * @connector_state: Pointer to DRM connector state object
  810. * Returns: 0 on success, negative errno on failure
  811. */
  812. int sde_connector_helper_reset_custom_properties(
  813. struct drm_connector *connector,
  814. struct drm_connector_state *connector_state);
  815. /**
  816. * sde_connector_state_get_mode_info - get information of the current mode
  817. * in the given connector state.
  818. * conn_state: Pointer to the DRM connector state object
  819. * mode_info: Pointer to the mode info structure
  820. */
  821. int sde_connector_state_get_mode_info(struct drm_connector_state *conn_state,
  822. struct msm_mode_info *mode_info);
  823. /**
  824. * sde_connector_get_mode_info - retrieve mode info for given mode
  825. * @connector: Pointer to drm connector structure
  826. * @drm_mode: Display mode set for the display
  827. * @mode_info: Out parameter. information of the display mode
  828. * Returns: Zero on success
  829. */
  830. int sde_connector_get_mode_info(struct drm_connector *conn,
  831. const struct drm_display_mode *drm_mode,
  832. struct msm_mode_info *mode_info);
  833. /**
  834. * sde_conn_timeline_status - current buffer timeline status
  835. * conn: Pointer to drm_connector struct
  836. */
  837. void sde_conn_timeline_status(struct drm_connector *conn);
  838. /**
  839. * sde_connector_helper_bridge_disable - helper function for drm bridge disable
  840. * @connector: Pointer to DRM connector object
  841. */
  842. void sde_connector_helper_bridge_disable(struct drm_connector *connector);
  843. /**
  844. * sde_connector_destroy - destroy drm connector object
  845. * @connector: Pointer to DRM connector object
  846. */
  847. void sde_connector_destroy(struct drm_connector *connector);
  848. /**
  849. * sde_connector_event_notify - signal hw recovery event to client
  850. * @connector: pointer to connector
  851. * @type: event type
  852. * @len: length of the value of the event
  853. * @val: value
  854. */
  855. int sde_connector_event_notify(struct drm_connector *connector, uint32_t type,
  856. uint32_t len, uint32_t val);
  857. /**
  858. * sde_connector_helper_bridge_enable - helper function for drm bridge enable
  859. * @connector: Pointer to DRM connector object
  860. */
  861. void sde_connector_helper_bridge_enable(struct drm_connector *connector);
  862. /**
  863. * sde_connector_get_panel_vfp - helper to get panel vfp
  864. * @connector: pointer to drm connector
  865. * @h_active: panel width
  866. * @v_active: panel heigth
  867. * Returns: v_front_porch on success error-code on failure
  868. */
  869. int sde_connector_get_panel_vfp(struct drm_connector *connector,
  870. struct drm_display_mode *mode);
  871. /**
  872. * sde_connector_esd_status - helper function to check te status
  873. * @connector: Pointer to DRM connector object
  874. */
  875. int sde_connector_esd_status(struct drm_connector *connector);
  876. #endif /* _SDE_CONNECTOR_H_ */