]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - include/drm/bridge/dw_hdmi.h
drm: bridge: dw-hdmi: Add Documentation on supported input formats
[mirror_ubuntu-artful-kernel.git] / include / drm / bridge / dw_hdmi.h
CommitLineData
b21f4b65
AY
1/*
2 * Copyright (C) 2011 Freescale Semiconductor, Inc.
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
8 */
9
10#ifndef __DW_HDMI__
11#define __DW_HDMI__
12
13#include <drm/drmP.h>
14
b5814fff
RK
15struct dw_hdmi;
16
def23aa7
NA
17/**
18 * DOC: Supported input formats and encodings
19 *
20 * Depending on the Hardware configuration of the Controller IP, it supports
21 * a subset of the following input formats and encodings on its internal
22 * 48bit bus.
23 *
24 * +----------------------+----------------------------------+------------------------------+
25 * + Format Name + Format Code + Encodings +
26 * +----------------------+----------------------------------+------------------------------+
27 * + RGB 4:4:4 8bit + ``MEDIA_BUS_FMT_RGB888_1X24`` + ``V4L2_YCBCR_ENC_DEFAULT`` +
28 * +----------------------+----------------------------------+------------------------------+
29 * + RGB 4:4:4 10bits + ``MEDIA_BUS_FMT_RGB101010_1X30`` + ``V4L2_YCBCR_ENC_DEFAULT`` +
30 * +----------------------+----------------------------------+------------------------------+
31 * + RGB 4:4:4 12bits + ``MEDIA_BUS_FMT_RGB121212_1X36`` + ``V4L2_YCBCR_ENC_DEFAULT`` +
32 * +----------------------+----------------------------------+------------------------------+
33 * + RGB 4:4:4 16bits + ``MEDIA_BUS_FMT_RGB161616_1X48`` + ``V4L2_YCBCR_ENC_DEFAULT`` +
34 * +----------------------+----------------------------------+------------------------------+
35 * + YCbCr 4:4:4 8bit + ``MEDIA_BUS_FMT_YUV8_1X24`` + ``V4L2_YCBCR_ENC_601`` +
36 * + + + or ``V4L2_YCBCR_ENC_709`` +
37 * + + + or ``V4L2_YCBCR_ENC_XV601`` +
38 * + + + or ``V4L2_YCBCR_ENC_XV709`` +
39 * +----------------------+----------------------------------+------------------------------+
40 * + YCbCr 4:4:4 10bits + ``MEDIA_BUS_FMT_YUV10_1X30`` + ``V4L2_YCBCR_ENC_601`` +
41 * + + + or ``V4L2_YCBCR_ENC_709`` +
42 * + + + or ``V4L2_YCBCR_ENC_XV601`` +
43 * + + + or ``V4L2_YCBCR_ENC_XV709`` +
44 * +----------------------+----------------------------------+------------------------------+
45 * + YCbCr 4:4:4 12bits + ``MEDIA_BUS_FMT_YUV12_1X36`` + ``V4L2_YCBCR_ENC_601`` +
46 * + + + or ``V4L2_YCBCR_ENC_709`` +
47 * + + + or ``V4L2_YCBCR_ENC_XV601`` +
48 * + + + or ``V4L2_YCBCR_ENC_XV709`` +
49 * +----------------------+----------------------------------+------------------------------+
50 * + YCbCr 4:4:4 16bits + ``MEDIA_BUS_FMT_YUV16_1X48`` + ``V4L2_YCBCR_ENC_601`` +
51 * + + + or ``V4L2_YCBCR_ENC_709`` +
52 * + + + or ``V4L2_YCBCR_ENC_XV601`` +
53 * + + + or ``V4L2_YCBCR_ENC_XV709`` +
54 * +----------------------+----------------------------------+------------------------------+
55 * + YCbCr 4:2:2 8bit + ``MEDIA_BUS_FMT_UYVY8_1X16`` + ``V4L2_YCBCR_ENC_601`` +
56 * + + + or ``V4L2_YCBCR_ENC_709`` +
57 * +----------------------+----------------------------------+------------------------------+
58 * + YCbCr 4:2:2 10bits + ``MEDIA_BUS_FMT_UYVY10_1X20`` + ``V4L2_YCBCR_ENC_601`` +
59 * + + + or ``V4L2_YCBCR_ENC_709`` +
60 * +----------------------+----------------------------------+------------------------------+
61 * + YCbCr 4:2:2 12bits + ``MEDIA_BUS_FMT_UYVY12_1X24`` + ``V4L2_YCBCR_ENC_601`` +
62 * + + + or ``V4L2_YCBCR_ENC_709`` +
63 * +----------------------+----------------------------------+------------------------------+
64 * + YCbCr 4:2:0 8bit + ``MEDIA_BUS_FMT_UYYVYY8_0_5X24`` + ``V4L2_YCBCR_ENC_601`` +
65 * + + + or ``V4L2_YCBCR_ENC_709`` +
66 * +----------------------+----------------------------------+------------------------------+
67 * + YCbCr 4:2:0 10bits + ``MEDIA_BUS_FMT_UYYVYY10_0_5X30``+ ``V4L2_YCBCR_ENC_601`` +
68 * + + + or ``V4L2_YCBCR_ENC_709`` +
69 * +----------------------+----------------------------------+------------------------------+
70 * + YCbCr 4:2:0 12bits + ``MEDIA_BUS_FMT_UYYVYY12_0_5X36``+ ``V4L2_YCBCR_ENC_601`` +
71 * + + + or ``V4L2_YCBCR_ENC_709`` +
72 * +----------------------+----------------------------------+------------------------------+
73 * + YCbCr 4:2:0 16bits + ``MEDIA_BUS_FMT_UYYVYY16_0_5X48``+ ``V4L2_YCBCR_ENC_601`` +
74 * + + + or ``V4L2_YCBCR_ENC_709`` +
75 * +----------------------+----------------------------------+------------------------------+
76 */
77
b21f4b65
AY
78enum {
79 DW_HDMI_RES_8,
80 DW_HDMI_RES_10,
81 DW_HDMI_RES_12,
82 DW_HDMI_RES_MAX,
83};
84
faba6c3c
LP
85enum dw_hdmi_phy_type {
86 DW_HDMI_PHY_DWC_HDMI_TX_PHY = 0x00,
87 DW_HDMI_PHY_DWC_MHL_PHY_HEAC = 0xb2,
88 DW_HDMI_PHY_DWC_MHL_PHY = 0xc2,
89 DW_HDMI_PHY_DWC_HDMI_3D_TX_PHY_HEAC = 0xe2,
90 DW_HDMI_PHY_DWC_HDMI_3D_TX_PHY = 0xf2,
91 DW_HDMI_PHY_DWC_HDMI20_TX_PHY = 0xf3,
92 DW_HDMI_PHY_VENDOR_PHY = 0xfe,
93};
94
b21f4b65
AY
95struct dw_hdmi_mpll_config {
96 unsigned long mpixelclock;
97 struct {
98 u16 cpce;
99 u16 gmp;
100 } res[DW_HDMI_RES_MAX];
101};
102
103struct dw_hdmi_curr_ctrl {
104 unsigned long mpixelclock;
105 u16 curr[DW_HDMI_RES_MAX];
106};
107
034705a4 108struct dw_hdmi_phy_config {
b21f4b65
AY
109 unsigned long mpixelclock;
110 u16 sym_ctr; /*clock symbol and transmitter control*/
111 u16 term; /*transmission termination value*/
034705a4 112 u16 vlev_ctr; /* voltage level control */
b21f4b65
AY
113};
114
f1585f6e
LP
115struct dw_hdmi_phy_ops {
116 int (*init)(struct dw_hdmi *hdmi, void *data,
117 struct drm_display_mode *mode);
118 void (*disable)(struct dw_hdmi *hdmi, void *data);
119 enum drm_connector_status (*read_hpd)(struct dw_hdmi *hdmi, void *data);
120};
121
b21f4b65 122struct dw_hdmi_plat_data {
80e2f979 123 struct regmap *regm;
f1585f6e
LP
124 enum drm_mode_status (*mode_valid)(struct drm_connector *connector,
125 struct drm_display_mode *mode);
def23aa7
NA
126 unsigned long input_bus_format;
127 unsigned long input_bus_encoding;
f1585f6e
LP
128
129 /* Vendor PHY support */
130 const struct dw_hdmi_phy_ops *phy_ops;
131 const char *phy_name;
132 void *phy_data;
133
134 /* Synopsys PHY support */
b21f4b65
AY
135 const struct dw_hdmi_mpll_config *mpll_cfg;
136 const struct dw_hdmi_curr_ctrl *cur_ctr;
034705a4 137 const struct dw_hdmi_phy_config *phy_config;
2ef9dfed
KB
138 int (*configure_phy)(struct dw_hdmi *hdmi,
139 const struct dw_hdmi_plat_data *pdata,
140 unsigned long mpixelclock);
b21f4b65
AY
141};
142
69497eb9
LP
143int dw_hdmi_probe(struct platform_device *pdev,
144 const struct dw_hdmi_plat_data *plat_data);
145void dw_hdmi_remove(struct platform_device *pdev);
ecaa98f1 146void dw_hdmi_unbind(struct device *dev);
c608119d 147int dw_hdmi_bind(struct platform_device *pdev, struct drm_encoder *encoder,
b21f4b65 148 const struct dw_hdmi_plat_data *plat_data);
b5814fff
RK
149
150void dw_hdmi_set_sample_rate(struct dw_hdmi *hdmi, unsigned int rate);
b90120a9
RK
151void dw_hdmi_audio_enable(struct dw_hdmi *hdmi);
152void dw_hdmi_audio_disable(struct dw_hdmi *hdmi);
b5814fff 153
2ef9dfed
KB
154/* PHY configuration */
155void dw_hdmi_phy_i2c_write(struct dw_hdmi *hdmi, unsigned short data,
156 unsigned char addr);
157
b21f4b65 158#endif /* __IMX_HDMI_H__ */