video: add header file for Mobile High-Definition Link (MHL) interface
authorAndrzej Hajda <a.hajda@samsung.com>
Fri, 7 Oct 2016 07:02:40 +0000 (09:02 +0200)
committerArchit Taneja <architt@codeaurora.org>
Wed, 26 Oct 2016 04:59:58 +0000 (10:29 +0530)
This header adds definitions specific to MHL protocol.

Signed-off-by: Andrzej Hajda <a.hajda@samsung.com>
Signed-off-by: Archit Taneja <architt@codeaurora.org>
Link: http://patchwork.freedesktop.org/patch/msgid/1475823762-16237-2-git-send-email-a.hajda@samsung.com
include/drm/bridge/mhl.h [new file with mode: 0644]

diff --git a/include/drm/bridge/mhl.h b/include/drm/bridge/mhl.h
new file mode 100644 (file)
index 0000000..3629b27
--- /dev/null
@@ -0,0 +1,291 @@
+/*
+ * Defines for Mobile High-Definition Link (MHL) interface
+ *
+ * Copyright (C) 2015, Samsung Electronics, Co., Ltd.
+ * Andrzej Hajda <a.hajda@samsung.com>
+ *
+ * Based on MHL driver for Android devices.
+ * Copyright (C) 2013-2014 Silicon Image, Inc.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2 as
+ * published by the Free Software Foundation.
+ */
+
+#ifndef __MHL_H__
+#define __MHL_H__
+
+/* Device Capabilities Registers */
+enum {
+       MHL_DCAP_DEV_STATE,
+       MHL_DCAP_MHL_VERSION,
+       MHL_DCAP_CAT,
+       MHL_DCAP_ADOPTER_ID_H,
+       MHL_DCAP_ADOPTER_ID_L,
+       MHL_DCAP_VID_LINK_MODE,
+       MHL_DCAP_AUD_LINK_MODE,
+       MHL_DCAP_VIDEO_TYPE,
+       MHL_DCAP_LOG_DEV_MAP,
+       MHL_DCAP_BANDWIDTH,
+       MHL_DCAP_FEATURE_FLAG,
+       MHL_DCAP_DEVICE_ID_H,
+       MHL_DCAP_DEVICE_ID_L,
+       MHL_DCAP_SCRATCHPAD_SIZE,
+       MHL_DCAP_INT_STAT_SIZE,
+       MHL_DCAP_RESERVED,
+       MHL_DCAP_SIZE
+};
+
+#define MHL_DCAP_CAT_SINK                      0x01
+#define MHL_DCAP_CAT_SOURCE                    0x02
+#define MHL_DCAP_CAT_POWER                     0x10
+#define MHL_DCAP_CAT_PLIM(x)                   ((x) << 5)
+
+#define MHL_DCAP_VID_LINK_RGB444               0x01
+#define MHL_DCAP_VID_LINK_YCBCR444             0x02
+#define MHL_DCAP_VID_LINK_YCBCR422             0x04
+#define MHL_DCAP_VID_LINK_PPIXEL               0x08
+#define MHL_DCAP_VID_LINK_ISLANDS              0x10
+#define MHL_DCAP_VID_LINK_VGA                  0x20
+#define MHL_DCAP_VID_LINK_16BPP                        0x40
+
+#define MHL_DCAP_AUD_LINK_2CH                  0x01
+#define MHL_DCAP_AUD_LINK_8CH                  0x02
+
+#define MHL_DCAP_VT_GRAPHICS                   0x00
+#define MHL_DCAP_VT_PHOTO                      0x02
+#define MHL_DCAP_VT_CINEMA                     0x04
+#define MHL_DCAP_VT_GAMES                      0x08
+#define MHL_DCAP_SUPP_VT                       0x80
+
+#define MHL_DCAP_LD_DISPLAY                    0x01
+#define MHL_DCAP_LD_VIDEO                      0x02
+#define MHL_DCAP_LD_AUDIO                      0x04
+#define MHL_DCAP_LD_MEDIA                      0x08
+#define MHL_DCAP_LD_TUNER                      0x10
+#define MHL_DCAP_LD_RECORD                     0x20
+#define MHL_DCAP_LD_SPEAKER                    0x40
+#define MHL_DCAP_LD_GUI                                0x80
+#define MHL_DCAP_LD_ALL                                0xFF
+
+#define MHL_DCAP_FEATURE_RCP_SUPPORT           0x01
+#define MHL_DCAP_FEATURE_RAP_SUPPORT           0x02
+#define MHL_DCAP_FEATURE_SP_SUPPORT            0x04
+#define MHL_DCAP_FEATURE_UCP_SEND_SUPPOR       0x08
+#define MHL_DCAP_FEATURE_UCP_RECV_SUPPORT      0x10
+#define MHL_DCAP_FEATURE_RBP_SUPPORT           0x40
+
+/* Extended Device Capabilities Registers */
+enum {
+       MHL_XDC_ECBUS_SPEEDS,
+       MHL_XDC_TMDS_SPEEDS,
+       MHL_XDC_ECBUS_ROLES,
+       MHL_XDC_LOG_DEV_MAPX,
+       MHL_XDC_SIZE
+};
+
+#define MHL_XDC_ECBUS_S_075                    0x01
+#define MHL_XDC_ECBUS_S_8BIT                   0x02
+#define MHL_XDC_ECBUS_S_12BIT                  0x04
+#define MHL_XDC_ECBUS_D_150                    0x10
+#define MHL_XDC_ECBUS_D_8BIT                   0x20
+
+#define MHL_XDC_TMDS_000                       0x00
+#define MHL_XDC_TMDS_150                       0x01
+#define MHL_XDC_TMDS_300                       0x02
+#define MHL_XDC_TMDS_600                       0x04
+
+/* MHL_XDC_ECBUS_ROLES flags */
+#define MHL_XDC_DEV_HOST                       0x01
+#define MHL_XDC_DEV_DEVICE                     0x02
+#define MHL_XDC_DEV_CHARGER                    0x04
+#define MHL_XDC_HID_HOST                       0x08
+#define MHL_XDC_HID_DEVICE                     0x10
+
+/* MHL_XDC_LOG_DEV_MAPX flags */
+#define MHL_XDC_LD_PHONE                       0x01
+
+/* Device Status Registers */
+enum {
+       MHL_DST_CONNECTED_RDY,
+       MHL_DST_LINK_MODE,
+       MHL_DST_VERSION,
+       MHL_DST_SIZE
+};
+
+/* Offset of DEVSTAT registers */
+#define MHL_DST_OFFSET                         0x30
+#define MHL_DST_REG(name) (MHL_DST_OFFSET + MHL_DST_##name)
+
+#define MHL_DST_CONN_DCAP_RDY                  0x01
+#define MHL_DST_CONN_XDEVCAPP_SUPP             0x02
+#define MHL_DST_CONN_POW_STAT                  0x04
+#define MHL_DST_CONN_PLIM_STAT_MASK            0x38
+
+#define MHL_DST_LM_CLK_MODE_MASK               0x07
+#define MHL_DST_LM_CLK_MODE_PACKED_PIXEL       0x02
+#define MHL_DST_LM_CLK_MODE_NORMAL             0x03
+#define MHL_DST_LM_PATH_EN_MASK                        0x08
+#define MHL_DST_LM_PATH_ENABLED                        0x08
+#define MHL_DST_LM_PATH_DISABLED               0x00
+#define MHL_DST_LM_MUTED_MASK                  0x10
+
+/* Extended Device Status Registers */
+enum {
+       MHL_XDS_CURR_ECBUS_MODE,
+       MHL_XDS_AVLINK_MODE_STATUS,
+       MHL_XDS_AVLINK_MODE_CONTROL,
+       MHL_XDS_MULTI_SINK_STATUS,
+       MHL_XDS_SIZE
+};
+
+/* Offset of XDEVSTAT registers */
+#define MHL_XDS_OFFSET                         0x90
+#define MHL_XDS_REG(name) (MHL_XDS_OFFSET + MHL_XDS_##name)
+
+/* MHL_XDS_REG_CURR_ECBUS_MODE flags */
+#define MHL_XDS_SLOT_MODE_8BIT                 0x00
+#define MHL_XDS_SLOT_MODE_6BIT                 0x01
+#define MHL_XDS_ECBUS_S                                0x04
+#define MHL_XDS_ECBUS_D                                0x08
+
+#define MHL_XDS_LINK_CLOCK_75MHZ               0x00
+#define MHL_XDS_LINK_CLOCK_150MHZ              0x10
+#define MHL_XDS_LINK_CLOCK_300MHZ              0x20
+#define MHL_XDS_LINK_CLOCK_600MHZ              0x30
+
+#define MHL_XDS_LINK_STATUS_NO_SIGNAL          0x00
+#define MHL_XDS_LINK_STATUS_CRU_LOCKED         0x01
+#define MHL_XDS_LINK_STATUS_TMDS_NORMAL                0x02
+#define MHL_XDS_LINK_STATUS_TMDS_RESERVED      0x03
+
+#define MHL_XDS_LINK_RATE_1_5_GBPS             0x00
+#define MHL_XDS_LINK_RATE_3_0_GBPS             0x01
+#define MHL_XDS_LINK_RATE_6_0_GBPS             0x02
+#define MHL_XDS_ATT_CAPABLE                    0x08
+
+#define MHL_XDS_SINK_STATUS_1_HPD_LOW          0x00
+#define MHL_XDS_SINK_STATUS_1_HPD_HIGH         0x01
+#define MHL_XDS_SINK_STATUS_2_HPD_LOW          0x00
+#define MHL_XDS_SINK_STATUS_2_HPD_HIGH         0x04
+#define MHL_XDS_SINK_STATUS_3_HPD_LOW          0x00
+#define MHL_XDS_SINK_STATUS_3_HPD_HIGH         0x10
+#define MHL_XDS_SINK_STATUS_4_HPD_LOW          0x00
+#define MHL_XDS_SINK_STATUS_4_HPD_HIGH         0x40
+
+/* Interrupt Registers */
+enum {
+       MHL_INT_RCHANGE,
+       MHL_INT_DCHANGE,
+       MHL_INT_SIZE
+};
+
+/* Offset of DEVSTAT registers */
+#define MHL_INT_OFFSET                         0x20
+#define MHL_INT_REG(name) (MHL_INT_OFFSET + MHL_INT_##name)
+
+#define        MHL_INT_RC_DCAP_CHG                     0x01
+#define MHL_INT_RC_DSCR_CHG                    0x02
+#define MHL_INT_RC_REQ_WRT                     0x04
+#define MHL_INT_RC_GRT_WRT                     0x08
+#define MHL_INT_RC_3D_REQ                      0x10
+#define MHL_INT_RC_FEAT_REQ                    0x20
+#define MHL_INT_RC_FEAT_COMPLETE               0x40
+
+#define MHL_INT_DC_EDID_CHG                    0x02
+
+enum {
+       MHL_ACK = 0x33, /* Command or Data byte acknowledge */
+       MHL_NACK = 0x34, /* Command or Data byte not acknowledge */
+       MHL_ABORT = 0x35, /* Transaction abort */
+       MHL_WRITE_STAT = 0xe0, /* Write one status register */
+       MHL_SET_INT = 0x60, /* Write one interrupt register */
+       MHL_READ_DEVCAP_REG = 0x61, /* Read one register */
+       MHL_GET_STATE = 0x62, /* Read CBUS revision level from follower */
+       MHL_GET_VENDOR_ID = 0x63, /* Read vendor ID value from follower */
+       MHL_SET_HPD = 0x64, /* Set Hot Plug Detect in follower */
+       MHL_CLR_HPD = 0x65, /* Clear Hot Plug Detect in follower */
+       MHL_SET_CAP_ID = 0x66, /* Set Capture ID for downstream device */
+       MHL_GET_CAP_ID = 0x67, /* Get Capture ID from downstream device */
+       MHL_MSC_MSG = 0x68, /* VS command to send RCP sub-commands */
+       MHL_GET_SC1_ERRORCODE = 0x69, /* Get Vendor-Specific error code */
+       MHL_GET_DDC_ERRORCODE = 0x6A, /* Get DDC channel command error code */
+       MHL_GET_MSC_ERRORCODE = 0x6B, /* Get MSC command error code */
+       MHL_WRITE_BURST = 0x6C, /* Write 1-16 bytes to responder's scratchpad */
+       MHL_GET_SC3_ERRORCODE = 0x6D, /* Get channel 3 command error code */
+       MHL_WRITE_XSTAT = 0x70, /* Write one extended status register */
+       MHL_READ_XDEVCAP_REG = 0x71, /* Read one extended devcap register */
+       /* let the rest of these float, they are software specific */
+       MHL_READ_EDID_BLOCK,
+       MHL_SEND_3D_REQ_OR_FEAT_REQ,
+       MHL_READ_DEVCAP,
+       MHL_READ_XDEVCAP
+};
+
+/* MSC message types */
+enum {
+       MHL_MSC_MSG_RCP = 0x10, /* RCP sub-command */
+       MHL_MSC_MSG_RCPK = 0x11, /* RCP Acknowledge sub-command */
+       MHL_MSC_MSG_RCPE = 0x12, /* RCP Error sub-command */
+       MHL_MSC_MSG_RAP = 0x20, /* Mode Change Warning sub-command */
+       MHL_MSC_MSG_RAPK = 0x21, /* MCW Acknowledge sub-command */
+       MHL_MSC_MSG_RBP = 0x22, /* Remote Button Protocol sub-command */
+       MHL_MSC_MSG_RBPK = 0x23, /* RBP Acknowledge sub-command */
+       MHL_MSC_MSG_RBPE = 0x24, /* RBP Error sub-command */
+       MHL_MSC_MSG_UCP = 0x30, /* UCP sub-command */
+       MHL_MSC_MSG_UCPK = 0x31, /* UCP Acknowledge sub-command */
+       MHL_MSC_MSG_UCPE = 0x32, /* UCP Error sub-command */
+       MHL_MSC_MSG_RUSB = 0x40, /* Request USB host role */
+       MHL_MSC_MSG_RUSBK = 0x41, /* Acknowledge request for USB host role */
+       MHL_MSC_MSG_RHID = 0x42, /* Request HID host role */
+       MHL_MSC_MSG_RHIDK = 0x43, /* Acknowledge request for HID host role */
+       MHL_MSC_MSG_ATT = 0x50, /* Request attention sub-command */
+       MHL_MSC_MSG_ATTK = 0x51, /* ATT Acknowledge sub-command */
+       MHL_MSC_MSG_BIST_TRIGGER = 0x60,
+       MHL_MSC_MSG_BIST_REQUEST_STAT = 0x61,
+       MHL_MSC_MSG_BIST_READY = 0x62,
+       MHL_MSC_MSG_BIST_STOP = 0x63,
+};
+
+/* RAP action codes */
+#define MHL_RAP_POLL           0x00    /* Just do an ack */
+#define MHL_RAP_CONTENT_ON     0x10    /* Turn content stream ON */
+#define MHL_RAP_CONTENT_OFF    0x11    /* Turn content stream OFF */
+#define MHL_RAP_CBUS_MODE_DOWN 0x20
+#define MHL_RAP_CBUS_MODE_UP   0x21
+
+/* RAPK status codes */
+#define MHL_RAPK_NO_ERR                0x00    /* RAP action recognized & supported */
+#define MHL_RAPK_UNRECOGNIZED  0x01    /* Unknown RAP action code received */
+#define MHL_RAPK_UNSUPPORTED   0x02    /* Rcvd RAP action code not supported */
+#define MHL_RAPK_BUSY          0x03    /* Responder too busy to respond */
+
+/*
+ * Error status codes for RCPE messages
+ */
+/* No error. (Not allowed in RCPE messages) */
+#define MHL_RCPE_STATUS_NO_ERROR               0x00
+/* Unsupported/unrecognized key code */
+#define MHL_RCPE_STATUS_INEFFECTIVE_KEY_CODE   0x01
+/* Responder busy. Initiator may retry message */
+#define MHL_RCPE_STATUS_BUSY                   0x02
+
+/*
+ * Error status codes for RBPE messages
+ */
+/* No error. (Not allowed in RBPE messages) */
+#define MHL_RBPE_STATUS_NO_ERROR               0x00
+/* Unsupported/unrecognized button code */
+#define MHL_RBPE_STATUS_INEFFECTIVE_BUTTON_CODE        0x01
+/* Responder busy. Initiator may retry message */
+#define MHL_RBPE_STATUS_BUSY                   0x02
+
+/*
+ * Error status codes for UCPE messages
+ */
+/* No error. (Not allowed in UCPE messages) */
+#define MHL_UCPE_STATUS_NO_ERROR               0x00
+/* Unsupported/unrecognized key code */
+#define MHL_UCPE_STATUS_INEFFECTIVE_KEY_CODE   0x01
+
+#endif /* __MHL_H__ */