dsi_defs.h 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright (c) 2016-2020, The Linux Foundation. All rights reserved.
  4. */
  5. #ifndef _DSI_DEFS_H_
  6. #define _DSI_DEFS_H_
  7. #include <linux/types.h>
  8. #include <drm/drm_mipi_dsi.h>
  9. #include "msm_drv.h"
  10. #define DSI_H_TOTAL(t) (((t)->h_active) + ((t)->h_back_porch) + \
  11. ((t)->h_sync_width) + ((t)->h_front_porch))
  12. #define DSI_V_TOTAL(t) (((t)->v_active) + ((t)->v_back_porch) + \
  13. ((t)->v_sync_width) + ((t)->v_front_porch))
  14. #define DSI_DEBUG_NAME_LEN 32
  15. #define display_for_each_ctrl(index, display) \
  16. for (index = 0; (index < (display)->ctrl_count) &&\
  17. (index < MAX_DSI_CTRLS_PER_DISPLAY); index++)
  18. #define DSI_WARN(fmt, ...) DRM_WARN("[msm-dsi-warn]: "fmt, ##__VA_ARGS__)
  19. #define DSI_ERR(fmt, ...) DRM_DEV_ERROR(NULL, "[msm-dsi-error]: " fmt, \
  20. ##__VA_ARGS__)
  21. #define DSI_INFO(fmt, ...) DRM_DEV_INFO(NULL, "[msm-dsi-info]: "fmt, \
  22. ##__VA_ARGS__)
  23. #define DSI_DEBUG(fmt, ...) DRM_DEV_DEBUG(NULL, "[msm-dsi-debug]: "fmt, \
  24. ##__VA_ARGS__)
  25. /**
  26. * enum dsi_pixel_format - DSI pixel formats
  27. * @DSI_PIXEL_FORMAT_RGB565:
  28. * @DSI_PIXEL_FORMAT_RGB666:
  29. * @DSI_PIXEL_FORMAT_RGB666_LOOSE:
  30. * @DSI_PIXEL_FORMAT_RGB888:
  31. * @DSI_PIXEL_FORMAT_RGB111:
  32. * @DSI_PIXEL_FORMAT_RGB332:
  33. * @DSI_PIXEL_FORMAT_RGB444:
  34. * @DSI_PIXEL_FORMAT_MAX:
  35. */
  36. enum dsi_pixel_format {
  37. DSI_PIXEL_FORMAT_RGB565 = 0,
  38. DSI_PIXEL_FORMAT_RGB666,
  39. DSI_PIXEL_FORMAT_RGB666_LOOSE,
  40. DSI_PIXEL_FORMAT_RGB888,
  41. DSI_PIXEL_FORMAT_RGB111,
  42. DSI_PIXEL_FORMAT_RGB332,
  43. DSI_PIXEL_FORMAT_RGB444,
  44. DSI_PIXEL_FORMAT_MAX
  45. };
  46. /**
  47. * enum dsi_op_mode - dsi operation mode
  48. * @DSI_OP_VIDEO_MODE: DSI video mode operation
  49. * @DSI_OP_CMD_MODE: DSI Command mode operation
  50. * @DSI_OP_MODE_MAX:
  51. */
  52. enum dsi_op_mode {
  53. DSI_OP_VIDEO_MODE = 0,
  54. DSI_OP_CMD_MODE,
  55. DSI_OP_MODE_MAX
  56. };
  57. /**
  58. * enum dsi_mode_flags - flags to signal other drm components via private flags
  59. * @DSI_MODE_FLAG_SEAMLESS: Seamless transition requested by user
  60. * @DSI_MODE_FLAG_DFPS: Seamless transition is DynamicFPS
  61. * @DSI_MODE_FLAG_VBLANK_PRE_MODESET: Transition needs VBLANK before Modeset
  62. * @DSI_MODE_FLAG_DMS: Seamless transition is dynamic mode switch
  63. * @DSI_MODE_FLAG_VRR: Seamless transition is DynamicFPS.
  64. * New timing values are sent from DAL.
  65. * @DSI_MODE_FLAG_POMS:
  66. * Seamless transition is dynamic panel operating mode switch
  67. * @DSI_MODE_FLAG_DYN_CLK: Seamless transition is dynamic clock change
  68. * @DSI_MODE_FLAG_DMS_FPS: Seamless fps only transition in Dynamic Mode Switch
  69. */
  70. enum dsi_mode_flags {
  71. DSI_MODE_FLAG_SEAMLESS = BIT(0),
  72. DSI_MODE_FLAG_DFPS = BIT(1),
  73. DSI_MODE_FLAG_VBLANK_PRE_MODESET = BIT(2),
  74. DSI_MODE_FLAG_DMS = BIT(3),
  75. DSI_MODE_FLAG_VRR = BIT(4),
  76. DSI_MODE_FLAG_POMS = BIT(5),
  77. DSI_MODE_FLAG_DYN_CLK = BIT(6),
  78. DSI_MODE_FLAG_DMS_FPS = BIT(7),
  79. };
  80. /**
  81. * enum dsi_logical_lane - dsi logical lanes
  82. * @DSI_LOGICAL_LANE_0: Logical lane 0
  83. * @DSI_LOGICAL_LANE_1: Logical lane 1
  84. * @DSI_LOGICAL_LANE_2: Logical lane 2
  85. * @DSI_LOGICAL_LANE_3: Logical lane 3
  86. * @DSI_LOGICAL_CLOCK_LANE: Clock lane
  87. * @DSI_LANE_MAX: Maximum lanes supported
  88. */
  89. enum dsi_logical_lane {
  90. DSI_LOGICAL_LANE_0 = 0,
  91. DSI_LOGICAL_LANE_1,
  92. DSI_LOGICAL_LANE_2,
  93. DSI_LOGICAL_LANE_3,
  94. DSI_LOGICAL_CLOCK_LANE,
  95. DSI_LANE_MAX
  96. };
  97. /**
  98. * enum dsi_data_lanes - BIT map for DSI data lanes
  99. * This is used to identify the active DSI data lanes for
  100. * various operations like DSI data lane enable/ULPS/clamp
  101. * configurations.
  102. * @DSI_DATA_LANE_0: BIT(DSI_LOGICAL_LANE_0)
  103. * @DSI_DATA_LANE_1: BIT(DSI_LOGICAL_LANE_1)
  104. * @DSI_DATA_LANE_2: BIT(DSI_LOGICAL_LANE_2)
  105. * @DSI_DATA_LANE_3: BIT(DSI_LOGICAL_LANE_3)
  106. * @DSI_CLOCK_LANE: BIT(DSI_LOGICAL_CLOCK_LANE)
  107. */
  108. enum dsi_data_lanes {
  109. DSI_DATA_LANE_0 = BIT(DSI_LOGICAL_LANE_0),
  110. DSI_DATA_LANE_1 = BIT(DSI_LOGICAL_LANE_1),
  111. DSI_DATA_LANE_2 = BIT(DSI_LOGICAL_LANE_2),
  112. DSI_DATA_LANE_3 = BIT(DSI_LOGICAL_LANE_3),
  113. DSI_CLOCK_LANE = BIT(DSI_LOGICAL_CLOCK_LANE)
  114. };
  115. /**
  116. * enum dsi_phy_data_lanes - dsi physical lanes
  117. * used for DSI logical to physical lane mapping
  118. * @DSI_PHYSICAL_LANE_INVALID: Physical lane valid/invalid
  119. * @DSI_PHYSICAL_LANE_0: Physical lane 0
  120. * @DSI_PHYSICAL_LANE_1: Physical lane 1
  121. * @DSI_PHYSICAL_LANE_2: Physical lane 2
  122. * @DSI_PHYSICAL_LANE_3: Physical lane 3
  123. */
  124. enum dsi_phy_data_lanes {
  125. DSI_PHYSICAL_LANE_INVALID = 0,
  126. DSI_PHYSICAL_LANE_0 = BIT(0),
  127. DSI_PHYSICAL_LANE_1 = BIT(1),
  128. DSI_PHYSICAL_LANE_2 = BIT(2),
  129. DSI_PHYSICAL_LANE_3 = BIT(3)
  130. };
  131. enum dsi_lane_map_type_v1 {
  132. DSI_LANE_MAP_0123,
  133. DSI_LANE_MAP_3012,
  134. DSI_LANE_MAP_2301,
  135. DSI_LANE_MAP_1230,
  136. DSI_LANE_MAP_0321,
  137. DSI_LANE_MAP_1032,
  138. DSI_LANE_MAP_2103,
  139. DSI_LANE_MAP_3210,
  140. };
  141. /**
  142. * lane_map: DSI logical <-> physical lane mapping
  143. * lane_map_v1: Lane mapping for DSI controllers < v2.0
  144. * lane_map_v2: Lane mapping for DSI controllers >= 2.0
  145. */
  146. struct dsi_lane_map {
  147. enum dsi_lane_map_type_v1 lane_map_v1;
  148. u8 lane_map_v2[DSI_LANE_MAX - 1];
  149. };
  150. /**
  151. * enum dsi_trigger_type - dsi trigger type
  152. * @DSI_TRIGGER_NONE: No trigger.
  153. * @DSI_TRIGGER_TE: TE trigger.
  154. * @DSI_TRIGGER_SEOF: Start or End of frame.
  155. * @DSI_TRIGGER_SW: Software trigger.
  156. * @DSI_TRIGGER_SW_SEOF: Software trigger and start/end of frame.
  157. * @DSI_TRIGGER_SW_TE: Software and TE triggers.
  158. * @DSI_TRIGGER_MAX: Max trigger values.
  159. */
  160. enum dsi_trigger_type {
  161. DSI_TRIGGER_NONE = 0,
  162. DSI_TRIGGER_TE,
  163. DSI_TRIGGER_SEOF,
  164. DSI_TRIGGER_SW,
  165. DSI_TRIGGER_SW_SEOF,
  166. DSI_TRIGGER_SW_TE,
  167. DSI_TRIGGER_MAX
  168. };
  169. /**
  170. * enum dsi_color_swap_mode - color swap mode
  171. * @DSI_COLOR_SWAP_RGB:
  172. * @DSI_COLOR_SWAP_RBG:
  173. * @DSI_COLOR_SWAP_BGR:
  174. * @DSI_COLOR_SWAP_BRG:
  175. * @DSI_COLOR_SWAP_GRB:
  176. * @DSI_COLOR_SWAP_GBR:
  177. */
  178. enum dsi_color_swap_mode {
  179. DSI_COLOR_SWAP_RGB = 0,
  180. DSI_COLOR_SWAP_RBG,
  181. DSI_COLOR_SWAP_BGR,
  182. DSI_COLOR_SWAP_BRG,
  183. DSI_COLOR_SWAP_GRB,
  184. DSI_COLOR_SWAP_GBR
  185. };
  186. /**
  187. * enum dsi_dfps_type - Dynamic FPS support type
  188. * @DSI_DFPS_NONE: Dynamic FPS is not supported.
  189. * @DSI_DFPS_SUSPEND_RESUME:
  190. * @DSI_DFPS_IMMEDIATE_CLK:
  191. * @DSI_DFPS_IMMEDIATE_HFP:
  192. * @DSI_DFPS_IMMEDIATE_VFP:
  193. * @DSI_DPFS_MAX:
  194. */
  195. enum dsi_dfps_type {
  196. DSI_DFPS_NONE = 0,
  197. DSI_DFPS_SUSPEND_RESUME,
  198. DSI_DFPS_IMMEDIATE_CLK,
  199. DSI_DFPS_IMMEDIATE_HFP,
  200. DSI_DFPS_IMMEDIATE_VFP,
  201. DSI_DFPS_MAX
  202. };
  203. /**
  204. * enum dsi_dyn_clk_feature_type - Dynamic clock feature support type
  205. * @DSI_DYN_CLK_TYPE_LEGACY: Constant FPS is not supported
  206. * @DSI_DYN_CLK_TYPE_CONST_FPS_ADJUST_HFP: Constant FPS supported with
  207. * change in hfp
  208. * @DSI_DYN_CLK_TYPE_CONST_FPS_ADJUST_VFP: Constant FPS supported with
  209. * change in vfp
  210. * @DSI_DYN_CLK_TYPE_MAX:
  211. */
  212. enum dsi_dyn_clk_feature_type {
  213. DSI_DYN_CLK_TYPE_LEGACY = 0,
  214. DSI_DYN_CLK_TYPE_CONST_FPS_ADJUST_HFP,
  215. DSI_DYN_CLK_TYPE_CONST_FPS_ADJUST_VFP,
  216. DSI_DYN_CLK_TYPE_MAX
  217. };
  218. /**
  219. * enum dsi_cmd_set_type - DSI command set type
  220. * @DSI_CMD_SET_PRE_ON: Panel pre on
  221. * @DSI_CMD_SET_ON: Panel on
  222. * @DSI_CMD_SET_POST_ON: Panel post on
  223. * @DSI_CMD_SET_PRE_OFF: Panel pre off
  224. * @DSI_CMD_SET_OFF: Panel off
  225. * @DSI_CMD_SET_POST_OFF: Panel post off
  226. * @DSI_CMD_SET_PRE_RES_SWITCH: Pre resolution switch
  227. * @DSI_CMD_SET_RES_SWITCH: Resolution switch
  228. * @DSI_CMD_SET_POST_RES_SWITCH: Post resolution switch
  229. * @DSI_CMD_SET_CMD_TO_VID_SWITCH: Cmd to video mode switch
  230. * @DSI_CMD_SET_POST_CMD_TO_VID_SWITCH: Post cmd to vid switch
  231. * @DSI_CMD_SET_VID_TO_CMD_SWITCH: Video to cmd mode switch
  232. * @DSI_CMD_SET_POST_VID_TO_CMD_SWITCH: Post vid to cmd switch
  233. * @DSI_CMD_SET_PANEL_STATUS: Panel status
  234. * @DSI_CMD_SET_LP1: Low power mode 1
  235. * @DSI_CMD_SET_LP2: Low power mode 2
  236. * @DSI_CMD_SET_NOLP: Low power mode disable
  237. * @DSI_CMD_SET_PPS: DSC PPS command
  238. * @DSI_CMD_SET_ROI: Panel ROI update
  239. * @DSI_CMD_SET_TIMING_SWITCH: Timing switch
  240. * @DSI_CMD_SET_POST_TIMING_SWITCH: Post timing switch
  241. * @DSI_CMD_SET_QSYNC_ON Enable qsync mode
  242. * @DSI_CMD_SET_QSYNC_OFF Disable qsync mode
  243. * @DSI_CMD_SET_MAX
  244. */
  245. enum dsi_cmd_set_type {
  246. DSI_CMD_SET_PRE_ON = 0,
  247. DSI_CMD_SET_ON,
  248. DSI_CMD_SET_POST_ON,
  249. DSI_CMD_SET_PRE_OFF,
  250. DSI_CMD_SET_OFF,
  251. DSI_CMD_SET_POST_OFF,
  252. DSI_CMD_SET_PRE_RES_SWITCH,
  253. DSI_CMD_SET_RES_SWITCH,
  254. DSI_CMD_SET_POST_RES_SWITCH,
  255. DSI_CMD_SET_CMD_TO_VID_SWITCH,
  256. DSI_CMD_SET_POST_CMD_TO_VID_SWITCH,
  257. DSI_CMD_SET_VID_TO_CMD_SWITCH,
  258. DSI_CMD_SET_POST_VID_TO_CMD_SWITCH,
  259. DSI_CMD_SET_PANEL_STATUS,
  260. DSI_CMD_SET_LP1,
  261. DSI_CMD_SET_LP2,
  262. DSI_CMD_SET_NOLP,
  263. DSI_CMD_SET_PPS,
  264. DSI_CMD_SET_ROI,
  265. DSI_CMD_SET_TIMING_SWITCH,
  266. DSI_CMD_SET_POST_TIMING_SWITCH,
  267. DSI_CMD_SET_QSYNC_ON,
  268. DSI_CMD_SET_QSYNC_OFF,
  269. DSI_CMD_SET_MAX
  270. };
  271. /**
  272. * enum dsi_cmd_set_state - command set state
  273. * @DSI_CMD_SET_STATE_LP: dsi low power mode
  274. * @DSI_CMD_SET_STATE_HS: dsi high speed mode
  275. * @DSI_CMD_SET_STATE_MAX
  276. */
  277. enum dsi_cmd_set_state {
  278. DSI_CMD_SET_STATE_LP = 0,
  279. DSI_CMD_SET_STATE_HS,
  280. DSI_CMD_SET_STATE_MAX
  281. };
  282. /**
  283. * enum dsi_clk_gate_type - Type of clock to be gated.
  284. * @PIXEL_CLK: DSI pixel clock.
  285. * @BYTE_CLK: DSI byte clock.
  286. * @DSI_PHY: DSI PHY.
  287. * @DSI_CLK_ALL: All available DSI clocks
  288. * @DSI_CLK_NONE: None of the clocks should be gated
  289. */
  290. enum dsi_clk_gate_type {
  291. PIXEL_CLK = 1,
  292. BYTE_CLK = 2,
  293. DSI_PHY = 4,
  294. DSI_CLK_ALL = (PIXEL_CLK | BYTE_CLK | DSI_PHY),
  295. DSI_CLK_NONE = 8,
  296. };
  297. /**
  298. * enum dsi_phy_type - DSI phy types
  299. * @DSI_PHY_TYPE_DPHY:
  300. * @DSI_PHY_TYPE_CPHY:
  301. */
  302. enum dsi_phy_type {
  303. DSI_PHY_TYPE_DPHY,
  304. DSI_PHY_TYPE_CPHY
  305. };
  306. /**
  307. * enum dsi_te_mode - dsi te source
  308. * @DSI_TE_ON_DATA_LINK: TE read from DSI link
  309. * @DSI_TE_ON_EXT_PIN: TE signal on an external GPIO
  310. */
  311. enum dsi_te_mode {
  312. DSI_TE_ON_DATA_LINK = 0,
  313. DSI_TE_ON_EXT_PIN,
  314. };
  315. /**
  316. * enum dsi_video_traffic_mode - video mode pixel transmission type
  317. * @DSI_VIDEO_TRAFFIC_SYNC_PULSES: Non-burst mode with sync pulses.
  318. * @DSI_VIDEO_TRAFFIC_SYNC_START_EVENTS: Non-burst mode with sync start events.
  319. * @DSI_VIDEO_TRAFFIC_BURST_MODE: Burst mode using sync start events.
  320. */
  321. enum dsi_video_traffic_mode {
  322. DSI_VIDEO_TRAFFIC_SYNC_PULSES = 0,
  323. DSI_VIDEO_TRAFFIC_SYNC_START_EVENTS,
  324. DSI_VIDEO_TRAFFIC_BURST_MODE,
  325. };
  326. /**
  327. * struct dsi_cmd_desc - description of a dsi command
  328. * @msg: dsi mipi msg packet
  329. * @last_command: indicates whether the cmd is the last one to send
  330. * @post_wait_ms: post wait duration
  331. */
  332. struct dsi_cmd_desc {
  333. struct mipi_dsi_msg msg;
  334. bool last_command;
  335. u32 post_wait_ms;
  336. };
  337. /**
  338. * struct dsi_panel_cmd_set - command set of the panel
  339. * @type: type of the command
  340. * @state: state of the command
  341. * @count: number of cmds
  342. * @ctrl_idx: index of the dsi control
  343. * @cmds: arry of cmds
  344. */
  345. struct dsi_panel_cmd_set {
  346. enum dsi_cmd_set_type type;
  347. enum dsi_cmd_set_state state;
  348. u32 count;
  349. u32 ctrl_idx;
  350. struct dsi_cmd_desc *cmds;
  351. };
  352. /**
  353. * struct dsi_mode_info - video mode information dsi frame
  354. * @h_active: Active width of one frame in pixels.
  355. * @h_back_porch: Horizontal back porch in pixels.
  356. * @h_sync_width: HSYNC width in pixels.
  357. * @h_front_porch: Horizontal fron porch in pixels.
  358. * @h_skew:
  359. * @h_sync_polarity: Polarity of HSYNC (false is active low).
  360. * @v_active: Active height of one frame in lines.
  361. * @v_back_porch: Vertical back porch in lines.
  362. * @v_sync_width: VSYNC width in lines.
  363. * @v_front_porch: Vertical front porch in lines.
  364. * @v_sync_polarity: Polarity of VSYNC (false is active low).
  365. * @refresh_rate: Refresh rate in Hz.
  366. * @clk_rate_hz: DSI bit clock rate per lane in Hz.
  367. * @min_dsi_clk_hz: Min DSI bit clock to transfer in vsync time.
  368. * @mdp_transfer_time_us: Specifies the mdp transfer time for command mode
  369. * panels in microseconds.
  370. * @dsi_transfer_time_us: Specifies dsi transfer time for command mode.
  371. * @dsc_enabled: DSC compression enabled.
  372. * @vdc_enabled: VDC compression enabled.
  373. * @dsc: DSC compression configuration.
  374. * @vdc: VDC compression configuration.
  375. * @roi_caps: Panel ROI capabilities.
  376. */
  377. struct dsi_mode_info {
  378. u32 h_active;
  379. u32 h_back_porch;
  380. u32 h_sync_width;
  381. u32 h_front_porch;
  382. u32 h_skew;
  383. bool h_sync_polarity;
  384. u32 v_active;
  385. u32 v_back_porch;
  386. u32 v_sync_width;
  387. u32 v_front_porch;
  388. bool v_sync_polarity;
  389. u32 refresh_rate;
  390. u64 clk_rate_hz;
  391. u64 min_dsi_clk_hz;
  392. u32 mdp_transfer_time_us;
  393. u32 dsi_transfer_time_us;
  394. bool dsc_enabled;
  395. bool vdc_enabled;
  396. struct msm_display_dsc_info *dsc;
  397. struct msm_display_vdc_info *vdc;
  398. struct msm_roi_caps roi_caps;
  399. };
  400. /**
  401. * struct dsi_split_link_config - Split Link Configuration
  402. * @split_link_enabled: Split Link Enabled.
  403. * @num_sublinks: Number of sublinks.
  404. * @lanes_per_sublink: Number of lanes per sublink.
  405. */
  406. struct dsi_split_link_config {
  407. bool split_link_enabled;
  408. u32 num_sublinks;
  409. u32 lanes_per_sublink;
  410. };
  411. /**
  412. * struct dsi_host_common_cfg - Host configuration common to video and cmd mode
  413. * @dst_format: Destination pixel format.
  414. * @data_lanes: Physical data lanes to be enabled.
  415. * @num_data_lanes: Number of physical data lanes.
  416. * @bpp: Number of bits per pixel.
  417. * @en_crc_check: Enable CRC checks.
  418. * @en_ecc_check: Enable ECC checks.
  419. * @te_mode: Source for TE signalling.
  420. * @mdp_cmd_trigger: MDP frame update trigger for command mode.
  421. * @dma_cmd_trigger: Command DMA trigger.
  422. * @cmd_trigger_stream: Command mode stream to trigger.
  423. * @swap_mode: DSI color swap mode.
  424. * @bit_swap_read: Is red color bit swapped.
  425. * @bit_swap_green: Is green color bit swapped.
  426. * @bit_swap_blue: Is blue color bit swapped.
  427. * @t_clk_post: Number of byte clock cycles that the transmitter shall
  428. * continue sending after last data lane has transitioned
  429. * to LP mode.
  430. * @t_clk_pre: Number of byte clock cycles that the high spped clock
  431. * shall be driven prior to data lane transitions from LP
  432. * to HS mode.
  433. * @ignore_rx_eot: Ignore Rx EOT packets if set to true.
  434. * @append_tx_eot: Append EOT packets for forward transmissions if set to
  435. * true.
  436. * @ext_bridge_mode: External bridge is connected.
  437. * @force_hs_clk_lane: Send continuous clock to the panel.
  438. * @dsi_split_link_config: Split Link Configuration.
  439. * @byte_intf_clk_div: Determines the factor for calculating byte intf clock.
  440. */
  441. struct dsi_host_common_cfg {
  442. enum dsi_pixel_format dst_format;
  443. enum dsi_data_lanes data_lanes;
  444. u8 num_data_lanes;
  445. u8 bpp;
  446. bool en_crc_check;
  447. bool en_ecc_check;
  448. enum dsi_te_mode te_mode;
  449. enum dsi_trigger_type mdp_cmd_trigger;
  450. enum dsi_trigger_type dma_cmd_trigger;
  451. u32 cmd_trigger_stream;
  452. enum dsi_color_swap_mode swap_mode;
  453. bool bit_swap_red;
  454. bool bit_swap_green;
  455. bool bit_swap_blue;
  456. u32 t_clk_post;
  457. u32 t_clk_pre;
  458. bool ignore_rx_eot;
  459. bool append_tx_eot;
  460. bool ext_bridge_mode;
  461. bool force_hs_clk_lane;
  462. struct dsi_split_link_config split_link;
  463. u32 byte_intf_clk_div;
  464. };
  465. /**
  466. * struct dsi_video_engine_cfg - DSI video engine configuration
  467. * @last_line_interleave_en: Allow command mode op interleaved on last line of
  468. * video stream.
  469. * @pulse_mode_hsa_he: Send HSA and HE following VS/VE packet if set to
  470. * true.
  471. * @hfp_lp11_en: Enter low power stop mode (LP-11) during HFP.
  472. * @hbp_lp11_en: Enter low power stop mode (LP-11) during HBP.
  473. * @hsa_lp11_en: Enter low power stop mode (LP-11) during HSA.
  474. * @eof_bllp_lp11_en: Enter low power stop mode (LP-11) during BLLP of
  475. * last line of a frame.
  476. * @bllp_lp11_en: Enter low power stop mode (LP-11) during BLLP.
  477. * @traffic_mode: Traffic mode for video stream.
  478. * @vc_id: Virtual channel identifier.
  479. * @dma_sched_line: Line number, after vactive end, at which command dma
  480. * needs to be triggered.
  481. */
  482. struct dsi_video_engine_cfg {
  483. bool last_line_interleave_en;
  484. bool pulse_mode_hsa_he;
  485. bool hfp_lp11_en;
  486. bool hbp_lp11_en;
  487. bool hsa_lp11_en;
  488. bool eof_bllp_lp11_en;
  489. bool bllp_lp11_en;
  490. bool force_clk_lane_hs;
  491. enum dsi_video_traffic_mode traffic_mode;
  492. u32 vc_id;
  493. u32 dma_sched_line;
  494. };
  495. /**
  496. * struct dsi_cmd_engine_cfg - DSI command engine configuration
  497. * @max_cmd_packets_interleave Maximum number of command mode RGB packets to
  498. * send with in one horizontal blanking period
  499. * of the video mode frame.
  500. * @wr_mem_start: DCS command for write_memory_start.
  501. * @wr_mem_continue: DCS command for write_memory_continue.
  502. * @insert_dcs_command: Insert DCS command as first byte of payload
  503. * of the pixel data.
  504. */
  505. struct dsi_cmd_engine_cfg {
  506. u32 max_cmd_packets_interleave;
  507. u32 wr_mem_start;
  508. u32 wr_mem_continue;
  509. bool insert_dcs_command;
  510. };
  511. /**
  512. * struct dsi_host_config - DSI host configuration parameters.
  513. * @panel_mode: Operation mode for panel (video or cmd mode).
  514. * @common_config: Host configuration common to both Video and Cmd mode.
  515. * @video_engine: Video engine configuration if panel is in video mode.
  516. * @cmd_engine: Cmd engine configuration if panel is in cmd mode.
  517. * @esc_clk_rate_khz: Esc clock frequency in Hz.
  518. * @bit_clk_rate_hz: Bit clock frequency in Hz.
  519. * @bit_clk_rate_hz_override: DSI bit clk rate override from dt/sysfs.
  520. * @video_timing: Video timing information of a frame.
  521. * @lane_map: Mapping between logical and physical lanes.
  522. */
  523. struct dsi_host_config {
  524. enum dsi_op_mode panel_mode;
  525. struct dsi_host_common_cfg common_config;
  526. union {
  527. struct dsi_video_engine_cfg video_engine;
  528. struct dsi_cmd_engine_cfg cmd_engine;
  529. } u;
  530. u64 esc_clk_rate_hz;
  531. u64 bit_clk_rate_hz;
  532. u64 bit_clk_rate_hz_override;
  533. struct dsi_mode_info video_timing;
  534. struct dsi_lane_map lane_map;
  535. };
  536. /**
  537. * struct dsi_display_mode_priv_info - private mode info that will be attached
  538. * with each drm mode
  539. * @cmd_sets: Command sets of the mode
  540. * @phy_timing_val: Phy timing values
  541. * @phy_timing_len: Phy timing array length
  542. * @panel_jitter: Panel jitter for RSC backoff
  543. * @panel_prefill_lines: Panel prefill lines for RSC
  544. * @mdp_transfer_time_us: Specifies the mdp transfer time for command mode
  545. * panels in microseconds.
  546. * @dsi_transfer_time_us: Specifies the dsi transfer time for cmd panels.
  547. * @clk_rate_hz: DSI bit clock per lane in hz.
  548. * @min_dsi_clk_hz: Min dsi clk per lane to transfer frame in vsync time.
  549. * @topology: Topology selected for the panel
  550. * @dsc: DSC compression info
  551. * @vdc: VDC compression info
  552. * @dsc_enabled: DSC compression enabled
  553. * @vdc_enabled: VDC compression enabled
  554. * @roi_caps: Panel ROI capabilities
  555. */
  556. struct dsi_display_mode_priv_info {
  557. struct dsi_panel_cmd_set cmd_sets[DSI_CMD_SET_MAX];
  558. u32 *phy_timing_val;
  559. u32 phy_timing_len;
  560. u32 panel_jitter_numer;
  561. u32 panel_jitter_denom;
  562. u32 panel_prefill_lines;
  563. u32 mdp_transfer_time_us;
  564. u32 dsi_transfer_time_us;
  565. u64 clk_rate_hz;
  566. u64 min_dsi_clk_hz;
  567. struct msm_display_topology topology;
  568. struct msm_display_dsc_info dsc;
  569. struct msm_display_vdc_info vdc;
  570. bool dsc_enabled;
  571. bool vdc_enabled;
  572. struct msm_roi_caps roi_caps;
  573. };
  574. /**
  575. * struct dsi_display_mode - specifies mode for dsi display
  576. * @timing: Timing parameters for the panel.
  577. * @pixel_clk_khz: Pixel clock in Khz.
  578. * @dsi_mode_flags: Flags to signal other drm components via private flags
  579. * @panel_mode: Panel mode
  580. * @priv_info: Mode private info
  581. */
  582. struct dsi_display_mode {
  583. struct dsi_mode_info timing;
  584. u32 pixel_clk_khz;
  585. u32 dsi_mode_flags;
  586. enum dsi_op_mode panel_mode;
  587. struct dsi_display_mode_priv_info *priv_info;
  588. };
  589. /**
  590. * struct dsi_rect - dsi rectangle representation
  591. * Note: sde_rect is also using u16, this must be maintained for memcpy
  592. */
  593. struct dsi_rect {
  594. u16 x;
  595. u16 y;
  596. u16 w;
  597. u16 h;
  598. };
  599. /**
  600. * dsi_rect_intersect - intersect two rectangles
  601. * @r1: first rectangle
  602. * @r2: scissor rectangle
  603. * @result: result rectangle, all 0's on no intersection found
  604. */
  605. void dsi_rect_intersect(const struct dsi_rect *r1,
  606. const struct dsi_rect *r2,
  607. struct dsi_rect *result);
  608. /**
  609. * dsi_rect_is_equal - compares two rects
  610. * @r1: rect value to compare
  611. * @r2: rect value to compare
  612. *
  613. * Returns true if the rects are same
  614. */
  615. static inline bool dsi_rect_is_equal(struct dsi_rect *r1,
  616. struct dsi_rect *r2)
  617. {
  618. return r1->x == r2->x && r1->y == r2->y && r1->w == r2->w &&
  619. r1->h == r2->h;
  620. }
  621. struct dsi_event_cb_info {
  622. uint32_t event_idx;
  623. void *event_usr_ptr;
  624. int (*event_cb)(void *event_usr_ptr,
  625. uint32_t event_idx, uint32_t instance_idx,
  626. uint32_t data0, uint32_t data1,
  627. uint32_t data2, uint32_t data3);
  628. };
  629. /**
  630. * enum dsi_error_status - various dsi errors
  631. * @DSI_FIFO_OVERFLOW: DSI FIFO Overflow error
  632. * @DSI_FIFO_UNDERFLOW: DSI FIFO Underflow error
  633. * @DSI_LP_Rx_TIMEOUT: DSI LP/RX Timeout error
  634. * @DSI_PLL_UNLOCK_ERR: DSI PLL unlock error
  635. */
  636. enum dsi_error_status {
  637. DSI_FIFO_OVERFLOW = 1,
  638. DSI_FIFO_UNDERFLOW,
  639. DSI_LP_Rx_TIMEOUT,
  640. DSI_PLL_UNLOCK_ERR,
  641. DSI_ERR_INTR_ALL,
  642. };
  643. /* structure containing the delays required for dynamic clk */
  644. struct dsi_dyn_clk_delay {
  645. u32 pipe_delay;
  646. u32 pipe_delay2;
  647. u32 pll_delay;
  648. };
  649. /* dynamic refresh control bits */
  650. enum dsi_dyn_clk_control_bits {
  651. DYN_REFRESH_INTF_SEL = 1,
  652. DYN_REFRESH_SYNC_MODE,
  653. DYN_REFRESH_SW_TRIGGER,
  654. DYN_REFRESH_SWI_CTRL,
  655. };
  656. /* convert dsi pixel format into bits per pixel */
  657. static inline int dsi_pixel_format_to_bpp(enum dsi_pixel_format fmt)
  658. {
  659. switch (fmt) {
  660. case DSI_PIXEL_FORMAT_RGB888:
  661. case DSI_PIXEL_FORMAT_MAX:
  662. return 24;
  663. case DSI_PIXEL_FORMAT_RGB666:
  664. case DSI_PIXEL_FORMAT_RGB666_LOOSE:
  665. return 18;
  666. case DSI_PIXEL_FORMAT_RGB565:
  667. return 16;
  668. case DSI_PIXEL_FORMAT_RGB111:
  669. return 3;
  670. case DSI_PIXEL_FORMAT_RGB332:
  671. return 8;
  672. case DSI_PIXEL_FORMAT_RGB444:
  673. return 12;
  674. }
  675. return 24;
  676. }
  677. static inline u64 dsi_h_active_dce(struct dsi_mode_info *mode)
  678. {
  679. u64 h_active = 0;
  680. if (mode->dsc_enabled && mode->dsc)
  681. h_active = mode->dsc->pclk_per_line;
  682. else if (mode->vdc_enabled && mode->vdc)
  683. h_active = mode->vdc->pclk_per_line;
  684. else
  685. h_active = mode->h_active;
  686. return h_active;
  687. }
  688. static inline u64 dsi_h_total_dce(struct dsi_mode_info *mode)
  689. {
  690. return dsi_h_active_dce(mode) + mode->h_back_porch +
  691. mode->h_sync_width + mode->h_front_porch;
  692. }
  693. #endif /* _DSI_DEFS_H_ */