1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 * Cadence MHDP8546 DP bridge driver.
4 *
5 * Copyright (C) 2020 Cadence Design Systems, Inc.
6 *
7 * Author: Quentin Schulz <quentin.schulz@free-electrons.com>
8 * Swapnil Jakhade <sjakhade@cadence.com>
9 */
10
11#ifndef CDNS_MHDP8546_CORE_H
12#define CDNS_MHDP8546_CORE_H
13
14#include <linux/bits.h>
15#include <linux/mutex.h>
16#include <linux/spinlock.h>
17
18#include <drm/display/drm_dp_helper.h>
19#include <drm/drm_bridge.h>
20#include <drm/drm_connector.h>
21
22struct clk;
23struct device;
24struct phy;
25
26/* Register offsets */
27#define CDNS_APB_CTRL 0x00000
28#define CDNS_CPU_STALL BIT(3)
29
30#define CDNS_MAILBOX_FULL 0x00008
31#define CDNS_MAILBOX_EMPTY 0x0000c
32#define CDNS_MAILBOX_TX_DATA 0x00010
33#define CDNS_MAILBOX_RX_DATA 0x00014
34#define CDNS_KEEP_ALIVE 0x00018
35#define CDNS_KEEP_ALIVE_MASK GENMASK(7, 0)
36
37#define CDNS_VER_L 0x0001C
38#define CDNS_VER_H 0x00020
39#define CDNS_LIB_L_ADDR 0x00024
40#define CDNS_LIB_H_ADDR 0x00028
41
42#define CDNS_MB_INT_MASK 0x00034
43#define CDNS_MB_INT_STATUS 0x00038
44
45#define CDNS_SW_CLK_L 0x0003c
46#define CDNS_SW_CLK_H 0x00040
47
48#define CDNS_SW_EVENT0 0x00044
49#define CDNS_DPTX_HPD BIT(0)
50#define CDNS_HDCP_TX_STATUS BIT(4)
51#define CDNS_HDCP2_TX_IS_KM_STORED BIT(5)
52#define CDNS_HDCP2_TX_STORE_KM BIT(6)
53#define CDNS_HDCP_TX_IS_RCVR_ID_VALID BIT(7)
54
55#define CDNS_SW_EVENT1 0x00048
56#define CDNS_SW_EVENT2 0x0004c
57#define CDNS_SW_EVENT3 0x00050
58
59#define CDNS_APB_INT_MASK 0x0006C
60#define CDNS_APB_INT_MASK_MAILBOX_INT BIT(0)
61#define CDNS_APB_INT_MASK_SW_EVENT_INT BIT(1)
62
63#define CDNS_APB_INT_STATUS 0x00070
64
65#define CDNS_DPTX_CAR 0x00904
66#define CDNS_VIF_CLK_EN BIT(0)
67#define CDNS_VIF_CLK_RSTN BIT(1)
68
69#define CDNS_SOURCE_VIDEO_IF(s) (0x00b00 + ((s) * 0x20))
70#define CDNS_BND_HSYNC2VSYNC(s) (CDNS_SOURCE_VIDEO_IF(s) + \
71 0x00)
72#define CDNS_IP_DTCT_WIN GENMASK(11, 0)
73#define CDNS_IP_DET_INTERLACE_FORMAT BIT(12)
74#define CDNS_IP_BYPASS_V_INTERFACE BIT(13)
75
76#define CDNS_HSYNC2VSYNC_POL_CTRL(s) (CDNS_SOURCE_VIDEO_IF(s) + \
77 0x10)
78#define CDNS_H2V_HSYNC_POL_ACTIVE_LOW BIT(1)
79#define CDNS_H2V_VSYNC_POL_ACTIVE_LOW BIT(2)
80
81#define CDNS_DPTX_PHY_CONFIG 0x02000
82#define CDNS_PHY_TRAINING_EN BIT(0)
83#define CDNS_PHY_TRAINING_TYPE(x) (((x) & GENMASK(3, 0)) << 1)
84#define CDNS_PHY_SCRAMBLER_BYPASS BIT(5)
85#define CDNS_PHY_ENCODER_BYPASS BIT(6)
86#define CDNS_PHY_SKEW_BYPASS BIT(7)
87#define CDNS_PHY_TRAINING_AUTO BIT(8)
88#define CDNS_PHY_LANE0_SKEW(x) (((x) & GENMASK(2, 0)) << 9)
89#define CDNS_PHY_LANE1_SKEW(x) (((x) & GENMASK(2, 0)) << 12)
90#define CDNS_PHY_LANE2_SKEW(x) (((x) & GENMASK(2, 0)) << 15)
91#define CDNS_PHY_LANE3_SKEW(x) (((x) & GENMASK(2, 0)) << 18)
92#define CDNS_PHY_COMMON_CONFIG (CDNS_PHY_LANE1_SKEW(1) | \
93 CDNS_PHY_LANE2_SKEW(2) | \
94 CDNS_PHY_LANE3_SKEW(3))
95#define CDNS_PHY_10BIT_EN BIT(21)
96
97#define CDNS_DP_FRAMER_GLOBAL_CONFIG 0x02200
98#define CDNS_DP_NUM_LANES(x) ((x) - 1)
99#define CDNS_DP_MST_EN BIT(2)
100#define CDNS_DP_FRAMER_EN BIT(3)
101#define CDNS_DP_RATE_GOVERNOR_EN BIT(4)
102#define CDNS_DP_NO_VIDEO_MODE BIT(5)
103#define CDNS_DP_DISABLE_PHY_RST BIT(6)
104#define CDNS_DP_WR_FAILING_EDGE_VSYNC BIT(7)
105
106#define CDNS_DP_FRAMER_TU 0x02208
107#define CDNS_DP_FRAMER_TU_SIZE(x) (((x) & GENMASK(6, 0)) << 8)
108#define CDNS_DP_FRAMER_TU_VS(x) ((x) & GENMASK(5, 0))
109#define CDNS_DP_FRAMER_TU_CNT_RST_EN BIT(15)
110
111#define CDNS_DP_MTPH_CONTROL 0x02264
112#define CDNS_DP_MTPH_ECF_EN BIT(0)
113#define CDNS_DP_MTPH_ACT_EN BIT(1)
114#define CDNS_DP_MTPH_LVP_EN BIT(2)
115
116#define CDNS_DP_MTPH_STATUS 0x0226C
117#define CDNS_DP_MTPH_ACT_STATUS BIT(0)
118
119#define CDNS_DP_LANE_EN 0x02300
120#define CDNS_DP_LANE_EN_LANES(x) GENMASK((x) - 1, 0)
121
122#define CDNS_DP_ENHNCD 0x02304
123
124#define CDNS_DPTX_STREAM(s) (0x03000 + (s) * 0x80)
125#define CDNS_DP_MSA_HORIZONTAL_0(s) (CDNS_DPTX_STREAM(s) + 0x00)
126#define CDNS_DP_MSAH0_H_TOTAL(x) (x)
127#define CDNS_DP_MSAH0_HSYNC_START(x) ((x) << 16)
128
129#define CDNS_DP_MSA_HORIZONTAL_1(s) (CDNS_DPTX_STREAM(s) + 0x04)
130#define CDNS_DP_MSAH1_HSYNC_WIDTH(x) (x)
131#define CDNS_DP_MSAH1_HSYNC_POL_LOW BIT(15)
132#define CDNS_DP_MSAH1_HDISP_WIDTH(x) ((x) << 16)
133
134#define CDNS_DP_MSA_VERTICAL_0(s) (CDNS_DPTX_STREAM(s) + 0x08)
135#define CDNS_DP_MSAV0_V_TOTAL(x) (x)
136#define CDNS_DP_MSAV0_VSYNC_START(x) ((x) << 16)
137
138#define CDNS_DP_MSA_VERTICAL_1(s) (CDNS_DPTX_STREAM(s) + 0x0c)
139#define CDNS_DP_MSAV1_VSYNC_WIDTH(x) (x)
140#define CDNS_DP_MSAV1_VSYNC_POL_LOW BIT(15)
141#define CDNS_DP_MSAV1_VDISP_WIDTH(x) ((x) << 16)
142
143#define CDNS_DP_MSA_MISC(s) (CDNS_DPTX_STREAM(s) + 0x10)
144#define CDNS_DP_STREAM_CONFIG(s) (CDNS_DPTX_STREAM(s) + 0x14)
145#define CDNS_DP_STREAM_CONFIG_2(s) (CDNS_DPTX_STREAM(s) + 0x2c)
146#define CDNS_DP_SC2_TU_VS_DIFF(x) ((x) << 8)
147
148#define CDNS_DP_HORIZONTAL(s) (CDNS_DPTX_STREAM(s) + 0x30)
149#define CDNS_DP_H_HSYNC_WIDTH(x) (x)
150#define CDNS_DP_H_H_TOTAL(x) ((x) << 16)
151
152#define CDNS_DP_VERTICAL_0(s) (CDNS_DPTX_STREAM(s) + 0x34)
153#define CDNS_DP_V0_VHEIGHT(x) (x)
154#define CDNS_DP_V0_VSTART(x) ((x) << 16)
155
156#define CDNS_DP_VERTICAL_1(s) (CDNS_DPTX_STREAM(s) + 0x38)
157#define CDNS_DP_V1_VTOTAL(x) (x)
158#define CDNS_DP_V1_VTOTAL_EVEN BIT(16)
159
160#define CDNS_DP_MST_SLOT_ALLOCATE(s) (CDNS_DPTX_STREAM(s) + 0x44)
161#define CDNS_DP_S_ALLOC_START_SLOT(x) (x)
162#define CDNS_DP_S_ALLOC_END_SLOT(x) ((x) << 8)
163
164#define CDNS_DP_RATE_GOVERNING(s) (CDNS_DPTX_STREAM(s) + 0x48)
165#define CDNS_DP_RG_TARG_AV_SLOTS_Y(x) (x)
166#define CDNS_DP_RG_TARG_AV_SLOTS_X(x) ((x) << 4)
167#define CDNS_DP_RG_ENABLE BIT(10)
168
169#define CDNS_DP_FRAMER_PXL_REPR(s) (CDNS_DPTX_STREAM(s) + 0x4c)
170#define CDNS_DP_FRAMER_6_BPC BIT(0)
171#define CDNS_DP_FRAMER_8_BPC BIT(1)
172#define CDNS_DP_FRAMER_10_BPC BIT(2)
173#define CDNS_DP_FRAMER_12_BPC BIT(3)
174#define CDNS_DP_FRAMER_16_BPC BIT(4)
175#define CDNS_DP_FRAMER_PXL_FORMAT 0x8
176#define CDNS_DP_FRAMER_RGB BIT(0)
177#define CDNS_DP_FRAMER_YCBCR444 BIT(1)
178#define CDNS_DP_FRAMER_YCBCR422 BIT(2)
179#define CDNS_DP_FRAMER_YCBCR420 BIT(3)
180#define CDNS_DP_FRAMER_Y_ONLY BIT(4)
181
182#define CDNS_DP_FRAMER_SP(s) (CDNS_DPTX_STREAM(s) + 0x50)
183#define CDNS_DP_FRAMER_VSYNC_POL_LOW BIT(0)
184#define CDNS_DP_FRAMER_HSYNC_POL_LOW BIT(1)
185#define CDNS_DP_FRAMER_INTERLACE BIT(2)
186
187#define CDNS_DP_LINE_THRESH(s) (CDNS_DPTX_STREAM(s) + 0x64)
188#define CDNS_DP_ACTIVE_LINE_THRESH(x) (x)
189
190#define CDNS_DP_VB_ID(s) (CDNS_DPTX_STREAM(s) + 0x68)
191#define CDNS_DP_VB_ID_INTERLACED BIT(2)
192#define CDNS_DP_VB_ID_COMPRESSED BIT(6)
193
194#define CDNS_DP_FRONT_BACK_PORCH(s) (CDNS_DPTX_STREAM(s) + 0x78)
195#define CDNS_DP_BACK_PORCH(x) (x)
196#define CDNS_DP_FRONT_PORCH(x) ((x) << 16)
197
198#define CDNS_DP_BYTE_COUNT(s) (CDNS_DPTX_STREAM(s) + 0x7c)
199#define CDNS_DP_BYTE_COUNT_BYTES_IN_CHUNK_SHIFT 16
200
201/* mailbox */
202#define MAILBOX_RETRY_US 1000
203#define MAILBOX_TIMEOUT_US 2000000
204
205#define MB_OPCODE_ID 0
206#define MB_MODULE_ID 1
207#define MB_SIZE_MSB_ID 2
208#define MB_SIZE_LSB_ID 3
209#define MB_DATA_ID 4
210
211#define MB_MODULE_ID_DP_TX 0x01
212#define MB_MODULE_ID_HDCP_TX 0x07
213#define MB_MODULE_ID_HDCP_RX 0x08
214#define MB_MODULE_ID_HDCP_GENERAL 0x09
215#define MB_MODULE_ID_GENERAL 0x0a
216
217/* firmware and opcodes */
218#define FW_NAME "cadence/mhdp8546.bin"
219#define CDNS_MHDP_IMEM 0x10000
220
221#define GENERAL_MAIN_CONTROL 0x01
222#define GENERAL_TEST_ECHO 0x02
223#define GENERAL_BUS_SETTINGS 0x03
224#define GENERAL_TEST_ACCESS 0x04
225#define GENERAL_REGISTER_READ 0x07
226
227#define DPTX_SET_POWER_MNG 0x00
228#define DPTX_GET_EDID 0x02
229#define DPTX_READ_DPCD 0x03
230#define DPTX_WRITE_DPCD 0x04
231#define DPTX_ENABLE_EVENT 0x05
232#define DPTX_WRITE_REGISTER 0x06
233#define DPTX_READ_REGISTER 0x07
234#define DPTX_WRITE_FIELD 0x08
235#define DPTX_READ_EVENT 0x0a
236#define DPTX_GET_LAST_AUX_STAUS 0x0e
237#define DPTX_HPD_STATE 0x11
238#define DPTX_ADJUST_LT 0x12
239
240#define FW_STANDBY 0
241#define FW_ACTIVE 1
242
243/* HPD */
244#define DPTX_READ_EVENT_HPD_TO_HIGH BIT(0)
245#define DPTX_READ_EVENT_HPD_TO_LOW BIT(1)
246#define DPTX_READ_EVENT_HPD_PULSE BIT(2)
247#define DPTX_READ_EVENT_HPD_STATE BIT(3)
248
249/* general */
250#define CDNS_DP_TRAINING_PATTERN_4 0x7
251
252#define CDNS_KEEP_ALIVE_TIMEOUT 2000
253
254#define CDNS_VOLT_SWING(x) ((x) & GENMASK(1, 0))
255#define CDNS_FORCE_VOLT_SWING BIT(2)
256
257#define CDNS_PRE_EMPHASIS(x) ((x) & GENMASK(1, 0))
258#define CDNS_FORCE_PRE_EMPHASIS BIT(2)
259
260#define CDNS_SUPPORT_TPS(x) BIT((x) - 1)
261
262#define CDNS_FAST_LINK_TRAINING BIT(0)
263
264#define CDNS_LANE_MAPPING_TYPE_C_LANE_0(x) ((x) & GENMASK(1, 0))
265#define CDNS_LANE_MAPPING_TYPE_C_LANE_1(x) ((x) & GENMASK(3, 2))
266#define CDNS_LANE_MAPPING_TYPE_C_LANE_2(x) ((x) & GENMASK(5, 4))
267#define CDNS_LANE_MAPPING_TYPE_C_LANE_3(x) ((x) & GENMASK(7, 6))
268#define CDNS_LANE_MAPPING_NORMAL 0xe4
269#define CDNS_LANE_MAPPING_FLIPPED 0x1b
270
271#define CDNS_DP_MAX_NUM_LANES 4
272#define CDNS_DP_TEST_VSC_SDP BIT(6) /* 1.3+ */
273#define CDNS_DP_TEST_COLOR_FORMAT_RAW_Y_ONLY BIT(7)
274
275#define CDNS_MHDP_MAX_STREAMS 4
276
277#define DP_LINK_CAP_ENHANCED_FRAMING BIT(0)
278
279struct cdns_mhdp_link {
280 unsigned char revision;
281 unsigned int rate;
282 unsigned int num_lanes;
283 unsigned long capabilities;
284};
285
286struct cdns_mhdp_host {
287 unsigned int link_rate;
288 u8 lanes_cnt;
289 u8 volt_swing;
290 u8 pre_emphasis;
291 u8 pattern_supp;
292 u8 lane_mapping;
293 bool fast_link;
294 bool enhanced;
295 bool scrambler;
296 bool ssc;
297};
298
299struct cdns_mhdp_sink {
300 unsigned int link_rate;
301 u8 lanes_cnt;
302 u8 pattern_supp;
303 bool fast_link;
304 bool enhanced;
305 bool ssc;
306};
307
308struct cdns_mhdp_display_fmt {
309 u32 color_format;
310 u32 bpc;
311 bool y_only;
312};
313
314/*
315 * These enums present MHDP hw initialization state
316 * Legal state transitions are:
317 * MHDP_HW_READY <-> MHDP_HW_STOPPED
318 */
319enum mhdp_hw_state {
320 MHDP_HW_READY = 1, /* HW ready, FW active */
321 MHDP_HW_STOPPED /* Driver removal FW to be stopped */
322};
323
324struct cdns_mhdp_device;
325
326struct mhdp_platform_ops {
327 int (*init)(struct cdns_mhdp_device *mhdp);
328 void (*exit)(struct cdns_mhdp_device *mhdp);
329 void (*enable)(struct cdns_mhdp_device *mhdp);
330 void (*disable)(struct cdns_mhdp_device *mhdp);
331};
332
333struct cdns_mhdp_bridge_state {
334 struct drm_bridge_state base;
335 struct drm_display_mode *current_mode;
336};
337
338struct cdns_mhdp_platform_info {
339 const u32 *input_bus_flags;
340 const struct mhdp_platform_ops *ops;
341};
342
343#define to_cdns_mhdp_bridge_state(s) \
344 container_of(s, struct cdns_mhdp_bridge_state, base)
345
346struct cdns_mhdp_hdcp {
347 struct delayed_work check_work;
348 struct work_struct prop_work;
349 struct mutex mutex; /* mutex to protect hdcp.value */
350 u32 value;
351 u8 hdcp_content_type;
352};
353
354struct cdns_mhdp_device {
355 void __iomem *regs;
356 void __iomem *sapb_regs;
357 void __iomem *j721e_regs;
358
359 struct device *dev;
360 struct clk *clk;
361 struct phy *phy;
362
363 const struct cdns_mhdp_platform_info *info;
364
365 /* This is to protect mailbox communications with the firmware */
366 struct mutex mbox_mutex;
367
368 /*
369 * "link_mutex" protects the access to all the link parameters
370 * including the link training process. Link training will be
371 * invoked both from threaded interrupt handler and from atomic
372 * callbacks when link_up is not set. So this mutex protects
373 * flags such as link_up, bridge_enabled, link.num_lanes,
374 * link.rate etc.
375 */
376 struct mutex link_mutex;
377
378 struct drm_connector connector;
379 struct drm_bridge bridge;
380
381 struct cdns_mhdp_link link;
382 struct drm_dp_aux aux;
383
384 struct cdns_mhdp_host host;
385 struct cdns_mhdp_sink sink;
386 struct cdns_mhdp_display_fmt display_fmt;
387 u8 stream_id;
388
389 bool link_up;
390 bool plugged;
391
392 /*
393 * "start_lock" protects the access to bridge_attached and
394 * hw_state data members that control the delayed firmware
395 * loading and attaching the bridge. They are accessed from
396 * both the DRM core and cdns_mhdp_fw_cb(). In most cases just
397 * protecting the data members is enough, but the irq mask
398 * setting needs to be protected when enabling the FW.
399 */
400 spinlock_t start_lock;
401 bool bridge_attached;
402 bool bridge_enabled;
403 enum mhdp_hw_state hw_state;
404 wait_queue_head_t fw_load_wq;
405
406 /* Work struct to schedule a uevent on link train failure */
407 struct work_struct modeset_retry_work;
408 struct work_struct hpd_work;
409
410 wait_queue_head_t sw_events_wq;
411 u32 sw_events;
412
413 struct cdns_mhdp_hdcp hdcp;
414 bool hdcp_supported;
415};
416
417#define connector_to_mhdp(x) container_of(x, struct cdns_mhdp_device, connector)
418#define bridge_to_mhdp(x) container_of(x, struct cdns_mhdp_device, bridge)
419
420u32 cdns_mhdp_wait_for_sw_event(struct cdns_mhdp_device *mhdp, uint32_t event);
421
422#endif
423

source code of linux/drivers/gpu/drm/bridge/cadence/cdns-mhdp8546-core.h