sde_connector.h 39 KB

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