1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Defines for Mobile High-Definition Link (MHL) interface
4  *
5  * Copyright (C) 2015, Samsung Electronics, Co., Ltd.
6  * Andrzej Hajda <a.hajda@samsung.com>
7  *
8  * Based on MHL driver for Android devices.
9  * Copyright (C) 2013-2014 Silicon Image, Inc.
10  */
11 
12 #ifndef __MHL_H__
13 #define __MHL_H__
14 
15 #include <linux/types.h>
16 
17 /* Device Capabilities Registers */
18 enum {
19 	MHL_DCAP_DEV_STATE,
20 	MHL_DCAP_MHL_VERSION,
21 	MHL_DCAP_CAT,
22 	MHL_DCAP_ADOPTER_ID_H,
23 	MHL_DCAP_ADOPTER_ID_L,
24 	MHL_DCAP_VID_LINK_MODE,
25 	MHL_DCAP_AUD_LINK_MODE,
26 	MHL_DCAP_VIDEO_TYPE,
27 	MHL_DCAP_LOG_DEV_MAP,
28 	MHL_DCAP_BANDWIDTH,
29 	MHL_DCAP_FEATURE_FLAG,
30 	MHL_DCAP_DEVICE_ID_H,
31 	MHL_DCAP_DEVICE_ID_L,
32 	MHL_DCAP_SCRATCHPAD_SIZE,
33 	MHL_DCAP_INT_STAT_SIZE,
34 	MHL_DCAP_RESERVED,
35 	MHL_DCAP_SIZE
36 };
37 
38 #define MHL_DCAP_CAT_SINK			0x01
39 #define MHL_DCAP_CAT_SOURCE			0x02
40 #define MHL_DCAP_CAT_POWER			0x10
41 #define MHL_DCAP_CAT_PLIM(x)			((x) << 5)
42 
43 #define MHL_DCAP_VID_LINK_RGB444		0x01
44 #define MHL_DCAP_VID_LINK_YCBCR444		0x02
45 #define MHL_DCAP_VID_LINK_YCBCR422		0x04
46 #define MHL_DCAP_VID_LINK_PPIXEL		0x08
47 #define MHL_DCAP_VID_LINK_ISLANDS		0x10
48 #define MHL_DCAP_VID_LINK_VGA			0x20
49 #define MHL_DCAP_VID_LINK_16BPP			0x40
50 
51 #define MHL_DCAP_AUD_LINK_2CH			0x01
52 #define MHL_DCAP_AUD_LINK_8CH			0x02
53 
54 #define MHL_DCAP_VT_GRAPHICS			0x00
55 #define MHL_DCAP_VT_PHOTO			0x02
56 #define MHL_DCAP_VT_CINEMA			0x04
57 #define MHL_DCAP_VT_GAMES			0x08
58 #define MHL_DCAP_SUPP_VT			0x80
59 
60 #define MHL_DCAP_LD_DISPLAY			0x01
61 #define MHL_DCAP_LD_VIDEO			0x02
62 #define MHL_DCAP_LD_AUDIO			0x04
63 #define MHL_DCAP_LD_MEDIA			0x08
64 #define MHL_DCAP_LD_TUNER			0x10
65 #define MHL_DCAP_LD_RECORD			0x20
66 #define MHL_DCAP_LD_SPEAKER			0x40
67 #define MHL_DCAP_LD_GUI				0x80
68 #define MHL_DCAP_LD_ALL				0xFF
69 
70 #define MHL_DCAP_FEATURE_RCP_SUPPORT		0x01
71 #define MHL_DCAP_FEATURE_RAP_SUPPORT		0x02
72 #define MHL_DCAP_FEATURE_SP_SUPPORT		0x04
73 #define MHL_DCAP_FEATURE_UCP_SEND_SUPPOR	0x08
74 #define MHL_DCAP_FEATURE_UCP_RECV_SUPPORT	0x10
75 #define MHL_DCAP_FEATURE_RBP_SUPPORT		0x40
76 
77 /* Extended Device Capabilities Registers */
78 enum {
79 	MHL_XDC_ECBUS_SPEEDS,
80 	MHL_XDC_TMDS_SPEEDS,
81 	MHL_XDC_ECBUS_ROLES,
82 	MHL_XDC_LOG_DEV_MAPX,
83 	MHL_XDC_SIZE
84 };
85 
86 #define MHL_XDC_ECBUS_S_075			0x01
87 #define MHL_XDC_ECBUS_S_8BIT			0x02
88 #define MHL_XDC_ECBUS_S_12BIT			0x04
89 #define MHL_XDC_ECBUS_D_150			0x10
90 #define MHL_XDC_ECBUS_D_8BIT			0x20
91 
92 #define MHL_XDC_TMDS_000			0x00
93 #define MHL_XDC_TMDS_150			0x01
94 #define MHL_XDC_TMDS_300			0x02
95 #define MHL_XDC_TMDS_600			0x04
96 
97 /* MHL_XDC_ECBUS_ROLES flags */
98 #define MHL_XDC_DEV_HOST			0x01
99 #define MHL_XDC_DEV_DEVICE			0x02
100 #define MHL_XDC_DEV_CHARGER			0x04
101 #define MHL_XDC_HID_HOST			0x08
102 #define MHL_XDC_HID_DEVICE			0x10
103 
104 /* MHL_XDC_LOG_DEV_MAPX flags */
105 #define MHL_XDC_LD_PHONE			0x01
106 
107 /* Device Status Registers */
108 enum {
109 	MHL_DST_CONNECTED_RDY,
110 	MHL_DST_LINK_MODE,
111 	MHL_DST_VERSION,
112 	MHL_DST_SIZE
113 };
114 
115 /* Offset of DEVSTAT registers */
116 #define MHL_DST_OFFSET				0x30
117 #define MHL_DST_REG(name) (MHL_DST_OFFSET + MHL_DST_##name)
118 
119 #define MHL_DST_CONN_DCAP_RDY			0x01
120 #define MHL_DST_CONN_XDEVCAPP_SUPP		0x02
121 #define MHL_DST_CONN_POW_STAT			0x04
122 #define MHL_DST_CONN_PLIM_STAT_MASK		0x38
123 
124 #define MHL_DST_LM_CLK_MODE_MASK		0x07
125 #define MHL_DST_LM_CLK_MODE_PACKED_PIXEL	0x02
126 #define MHL_DST_LM_CLK_MODE_NORMAL		0x03
127 #define MHL_DST_LM_PATH_EN_MASK			0x08
128 #define MHL_DST_LM_PATH_ENABLED			0x08
129 #define MHL_DST_LM_PATH_DISABLED		0x00
130 #define MHL_DST_LM_MUTED_MASK			0x10
131 
132 /* Extended Device Status Registers */
133 enum {
134 	MHL_XDS_CURR_ECBUS_MODE,
135 	MHL_XDS_AVLINK_MODE_STATUS,
136 	MHL_XDS_AVLINK_MODE_CONTROL,
137 	MHL_XDS_MULTI_SINK_STATUS,
138 	MHL_XDS_SIZE
139 };
140 
141 /* Offset of XDEVSTAT registers */
142 #define MHL_XDS_OFFSET				0x90
143 #define MHL_XDS_REG(name) (MHL_XDS_OFFSET + MHL_XDS_##name)
144 
145 /* MHL_XDS_REG_CURR_ECBUS_MODE flags */
146 #define MHL_XDS_SLOT_MODE_8BIT			0x00
147 #define MHL_XDS_SLOT_MODE_6BIT			0x01
148 #define MHL_XDS_ECBUS_S				0x04
149 #define MHL_XDS_ECBUS_D				0x08
150 
151 #define MHL_XDS_LINK_CLOCK_75MHZ		0x00
152 #define MHL_XDS_LINK_CLOCK_150MHZ		0x10
153 #define MHL_XDS_LINK_CLOCK_300MHZ		0x20
154 #define MHL_XDS_LINK_CLOCK_600MHZ		0x30
155 
156 #define MHL_XDS_LINK_STATUS_NO_SIGNAL		0x00
157 #define MHL_XDS_LINK_STATUS_CRU_LOCKED		0x01
158 #define MHL_XDS_LINK_STATUS_TMDS_NORMAL		0x02
159 #define MHL_XDS_LINK_STATUS_TMDS_RESERVED	0x03
160 
161 #define MHL_XDS_LINK_RATE_1_5_GBPS		0x00
162 #define MHL_XDS_LINK_RATE_3_0_GBPS		0x01
163 #define MHL_XDS_LINK_RATE_6_0_GBPS		0x02
164 #define MHL_XDS_ATT_CAPABLE			0x08
165 
166 #define MHL_XDS_SINK_STATUS_1_HPD_LOW		0x00
167 #define MHL_XDS_SINK_STATUS_1_HPD_HIGH		0x01
168 #define MHL_XDS_SINK_STATUS_2_HPD_LOW		0x00
169 #define MHL_XDS_SINK_STATUS_2_HPD_HIGH		0x04
170 #define MHL_XDS_SINK_STATUS_3_HPD_LOW		0x00
171 #define MHL_XDS_SINK_STATUS_3_HPD_HIGH		0x10
172 #define MHL_XDS_SINK_STATUS_4_HPD_LOW		0x00
173 #define MHL_XDS_SINK_STATUS_4_HPD_HIGH		0x40
174 
175 /* Interrupt Registers */
176 enum {
177 	MHL_INT_RCHANGE,
178 	MHL_INT_DCHANGE,
179 	MHL_INT_SIZE
180 };
181 
182 /* Offset of DEVSTAT registers */
183 #define MHL_INT_OFFSET				0x20
184 #define MHL_INT_REG(name) (MHL_INT_OFFSET + MHL_INT_##name)
185 
186 #define	MHL_INT_RC_DCAP_CHG			0x01
187 #define MHL_INT_RC_DSCR_CHG			0x02
188 #define MHL_INT_RC_REQ_WRT			0x04
189 #define MHL_INT_RC_GRT_WRT			0x08
190 #define MHL_INT_RC_3D_REQ			0x10
191 #define MHL_INT_RC_FEAT_REQ			0x20
192 #define MHL_INT_RC_FEAT_COMPLETE		0x40
193 
194 #define MHL_INT_DC_EDID_CHG			0x02
195 
196 enum {
197 	MHL_ACK = 0x33, /* Command or Data byte acknowledge */
198 	MHL_NACK = 0x34, /* Command or Data byte not acknowledge */
199 	MHL_ABORT = 0x35, /* Transaction abort */
200 	MHL_WRITE_STAT = 0xe0, /* Write one status register */
201 	MHL_SET_INT = 0x60, /* Write one interrupt register */
202 	MHL_READ_DEVCAP_REG = 0x61, /* Read one register */
203 	MHL_GET_STATE = 0x62, /* Read CBUS revision level from follower */
204 	MHL_GET_VENDOR_ID = 0x63, /* Read vendor ID value from follower */
205 	MHL_SET_HPD = 0x64, /* Set Hot Plug Detect in follower */
206 	MHL_CLR_HPD = 0x65, /* Clear Hot Plug Detect in follower */
207 	MHL_SET_CAP_ID = 0x66, /* Set Capture ID for downstream device */
208 	MHL_GET_CAP_ID = 0x67, /* Get Capture ID from downstream device */
209 	MHL_MSC_MSG = 0x68, /* VS command to send RCP sub-commands */
210 	MHL_GET_SC1_ERRORCODE = 0x69, /* Get Vendor-Specific error code */
211 	MHL_GET_DDC_ERRORCODE = 0x6A, /* Get DDC channel command error code */
212 	MHL_GET_MSC_ERRORCODE = 0x6B, /* Get MSC command error code */
213 	MHL_WRITE_BURST = 0x6C, /* Write 1-16 bytes to responder's scratchpad */
214 	MHL_GET_SC3_ERRORCODE = 0x6D, /* Get channel 3 command error code */
215 	MHL_WRITE_XSTAT = 0x70, /* Write one extended status register */
216 	MHL_READ_XDEVCAP_REG = 0x71, /* Read one extended devcap register */
217 	/* let the rest of these float, they are software specific */
218 	MHL_READ_EDID_BLOCK,
219 	MHL_SEND_3D_REQ_OR_FEAT_REQ,
220 	MHL_READ_DEVCAP,
221 	MHL_READ_XDEVCAP
222 };
223 
224 /* MSC message types */
225 enum {
226 	MHL_MSC_MSG_RCP = 0x10, /* RCP sub-command */
227 	MHL_MSC_MSG_RCPK = 0x11, /* RCP Acknowledge sub-command */
228 	MHL_MSC_MSG_RCPE = 0x12, /* RCP Error sub-command */
229 	MHL_MSC_MSG_RAP = 0x20, /* Mode Change Warning sub-command */
230 	MHL_MSC_MSG_RAPK = 0x21, /* MCW Acknowledge sub-command */
231 	MHL_MSC_MSG_RBP = 0x22, /* Remote Button Protocol sub-command */
232 	MHL_MSC_MSG_RBPK = 0x23, /* RBP Acknowledge sub-command */
233 	MHL_MSC_MSG_RBPE = 0x24, /* RBP Error sub-command */
234 	MHL_MSC_MSG_UCP = 0x30, /* UCP sub-command */
235 	MHL_MSC_MSG_UCPK = 0x31, /* UCP Acknowledge sub-command */
236 	MHL_MSC_MSG_UCPE = 0x32, /* UCP Error sub-command */
237 	MHL_MSC_MSG_RUSB = 0x40, /* Request USB host role */
238 	MHL_MSC_MSG_RUSBK = 0x41, /* Acknowledge request for USB host role */
239 	MHL_MSC_MSG_RHID = 0x42, /* Request HID host role */
240 	MHL_MSC_MSG_RHIDK = 0x43, /* Acknowledge request for HID host role */
241 	MHL_MSC_MSG_ATT = 0x50, /* Request attention sub-command */
242 	MHL_MSC_MSG_ATTK = 0x51, /* ATT Acknowledge sub-command */
243 	MHL_MSC_MSG_BIST_TRIGGER = 0x60,
244 	MHL_MSC_MSG_BIST_REQUEST_STAT = 0x61,
245 	MHL_MSC_MSG_BIST_READY = 0x62,
246 	MHL_MSC_MSG_BIST_STOP = 0x63,
247 };
248 
249 /* RAP action codes */
250 #define MHL_RAP_POLL		0x00	/* Just do an ack */
251 #define MHL_RAP_CONTENT_ON	0x10	/* Turn content stream ON */
252 #define MHL_RAP_CONTENT_OFF	0x11	/* Turn content stream OFF */
253 #define MHL_RAP_CBUS_MODE_DOWN	0x20
254 #define MHL_RAP_CBUS_MODE_UP	0x21
255 
256 /* RAPK status codes */
257 #define MHL_RAPK_NO_ERR		0x00	/* RAP action recognized & supported */
258 #define MHL_RAPK_UNRECOGNIZED	0x01	/* Unknown RAP action code received */
259 #define MHL_RAPK_UNSUPPORTED	0x02	/* Rcvd RAP action code not supported */
260 #define MHL_RAPK_BUSY		0x03	/* Responder too busy to respond */
261 
262 /* Bit masks for RCP messages */
263 #define MHL_RCP_KEY_RELEASED_MASK	0x80
264 #define MHL_RCP_KEY_ID_MASK		0x7F
265 
266 /*
267  * Error status codes for RCPE messages
268  */
269 /* No error. (Not allowed in RCPE messages) */
270 #define MHL_RCPE_STATUS_NO_ERROR		0x00
271 /* Unsupported/unrecognized key code */
272 #define MHL_RCPE_STATUS_INEFFECTIVE_KEY_CODE	0x01
273 /* Responder busy. Initiator may retry message */
274 #define MHL_RCPE_STATUS_BUSY			0x02
275 
276 /*
277  * Error status codes for RBPE messages
278  */
279 /* No error. (Not allowed in RBPE messages) */
280 #define MHL_RBPE_STATUS_NO_ERROR		0x00
281 /* Unsupported/unrecognized button code */
282 #define MHL_RBPE_STATUS_INEFFECTIVE_BUTTON_CODE	0x01
283 /* Responder busy. Initiator may retry message */
284 #define MHL_RBPE_STATUS_BUSY			0x02
285 
286 /*
287  * Error status codes for UCPE messages
288  */
289 /* No error. (Not allowed in UCPE messages) */
290 #define MHL_UCPE_STATUS_NO_ERROR		0x00
291 /* Unsupported/unrecognized key code */
292 #define MHL_UCPE_STATUS_INEFFECTIVE_KEY_CODE	0x01
293 
294 enum mhl_burst_id {
295 	MHL_BURST_ID_3D_VIC = 0x10,
296 	MHL_BURST_ID_3D_DTD = 0x11,
297 	MHL_BURST_ID_HEV_VIC = 0x20,
298 	MHL_BURST_ID_HEV_DTDA = 0x21,
299 	MHL_BURST_ID_HEV_DTDB = 0x22,
300 	MHL_BURST_ID_VC_ASSIGN = 0x38,
301 	MHL_BURST_ID_VC_CONFIRM = 0x39,
302 	MHL_BURST_ID_AUD_DELAY = 0x40,
303 	MHL_BURST_ID_ADT_BURSTID = 0x41,
304 	MHL_BURST_ID_BIST_SETUP = 0x51,
305 	MHL_BURST_ID_BIST_RETURN_STAT = 0x52,
306 	MHL_BURST_ID_EMSC_SUPPORT = 0x61,
307 	MHL_BURST_ID_HID_PAYLOAD = 0x62,
308 	MHL_BURST_ID_BLK_RCV_BUFFER_INFO = 0x63,
309 	MHL_BURST_ID_BITS_PER_PIXEL_FMT = 0x64,
310 };
311 
312 struct mhl_burst_blk_rcv_buffer_info {
313 	__be16 id;
314 	__le16 size;
315 } __packed;
316 
317 struct mhl3_burst_header {
318 	__be16 id;
319 	u8 checksum;
320 	u8 total_entries;
321 	u8 sequence_index;
322 } __packed;
323 
324 struct mhl_burst_bits_per_pixel_fmt {
325 	struct mhl3_burst_header hdr;
326 	u8 num_entries;
327 	struct {
328 		u8 stream_id;
329 		u8 pixel_format;
330 	} __packed desc[];
331 } __packed;
332 
333 struct mhl_burst_emsc_support {
334 	struct mhl3_burst_header hdr;
335 	u8 num_entries;
336 	__be16 burst_id[];
337 } __packed;
338 
339 struct mhl_burst_audio_descr {
340 	struct mhl3_burst_header hdr;
341 	u8 flags;
342 	u8 short_desc[9];
343 } __packed;
344 
345 /*
346  * MHL3 infoframe related definitions
347  */
348 
349 #define MHL3_IEEE_OUI		0x7ca61d
350 #define MHL3_INFOFRAME_SIZE	15
351 
352 enum mhl3_video_format {
353 	MHL3_VIDEO_FORMAT_NONE,
354 	MHL3_VIDEO_FORMAT_3D,
355 	MHL3_VIDEO_FORMAT_MULTI_VIEW,
356 	MHL3_VIDEO_FORMAT_DUAL_3D
357 };
358 
359 enum mhl3_3d_format_type {
360 	MHL3_3D_FORMAT_TYPE_FS, /* frame sequential */
361 	MHL3_3D_FORMAT_TYPE_TB, /* top-bottom */
362 	MHL3_3D_FORMAT_TYPE_LR, /* left-right */
363 	MHL3_3D_FORMAT_TYPE_FS_TB, /* frame sequential, top-bottom */
364 	MHL3_3D_FORMAT_TYPE_FS_LR, /* frame sequential, left-right */
365 	MHL3_3D_FORMAT_TYPE_TB_LR /* top-bottom, left-right */
366 };
367 
368 struct mhl3_infoframe {
369 	unsigned char version;
370 	enum mhl3_video_format video_format;
371 	enum mhl3_3d_format_type format_type;
372 	bool sep_audio;
373 	int hev_format;
374 	int av_delay;
375 };
376 
377 #endif /* __MHL_H__ */
378