[PATCH v4 3/6] drm/bridge/synopsys: Add MIPI DSI host controller bridge
Archit Taneja
architt at codeaurora.org
Mon Jul 3 06:21:13 UTC 2017
On 06/28/2017 02:35 PM, Andrzej Hajda wrote:
> On 28.06.2017 08:44, Archit Taneja wrote:
>>
>> On 06/19/2017 09:58 PM, Philippe CORNU wrote:
>>> Add a Synopsys Designware MIPI DSI host DRM bridge driver, based on the
>>> Rockchip version from rockchip/dw-mipi-dsi.c with phy & bridge APIs.
>>>
>>> Signed-off-by: Philippe CORNU <philippe.cornu at st.com>
>>> ---
>>> drivers/gpu/drm/bridge/synopsys/Kconfig | 6 +
>>> drivers/gpu/drm/bridge/synopsys/Makefile | 2 +
>>> drivers/gpu/drm/bridge/synopsys/dw-mipi-dsi.c | 976 ++++++++++++++++++++++++++
>>> include/drm/bridge/dw_mipi_dsi.h | 39 +
>>> 4 files changed, 1023 insertions(+)
>>> create mode 100644 drivers/gpu/drm/bridge/synopsys/dw-mipi-dsi.c
>>> create mode 100644 include/drm/bridge/dw_mipi_dsi.h
>>>
>>> diff --git a/drivers/gpu/drm/bridge/synopsys/Kconfig b/drivers/gpu/drm/bridge/synopsys/Kconfig
>>> index 40d2827..f00ee26 100644
>>> --- a/drivers/gpu/drm/bridge/synopsys/Kconfig
>>> +++ b/drivers/gpu/drm/bridge/synopsys/Kconfig
>>> @@ -21,3 +21,9 @@ config DRM_DW_HDMI_I2S_AUDIO
>>> help
>>> Support the I2S Audio interface which is part of the Synopsys
>>> Designware HDMI block.
>>> +
>>> +config DRM_DW_MIPI_DSI
>>> + tristate
>>> + select DRM_KMS_HELPER
>>> + select DRM_MIPI_DSI
>>> + select DRM_PANEL_BRIDGE
>>> diff --git a/drivers/gpu/drm/bridge/synopsys/Makefile b/drivers/gpu/drm/bridge/synopsys/Makefile
>>> index 17aa7a6..5f57d36 100644
>>> --- a/drivers/gpu/drm/bridge/synopsys/Makefile
>>> +++ b/drivers/gpu/drm/bridge/synopsys/Makefile
>>> @@ -3,3 +3,5 @@
>>> obj-$(CONFIG_DRM_DW_HDMI) += dw-hdmi.o
>>> obj-$(CONFIG_DRM_DW_HDMI_AHB_AUDIO) += dw-hdmi-ahb-audio.o
>>> obj-$(CONFIG_DRM_DW_HDMI_I2S_AUDIO) += dw-hdmi-i2s-audio.o
>>> +
>>> +obj-$(CONFIG_DRM_DW_MIPI_DSI) += dw-mipi-dsi.o
>>> diff --git a/drivers/gpu/drm/bridge/synopsys/dw-mipi-dsi.c b/drivers/gpu/drm/bridge/synopsys/dw-mipi-dsi.c
>>> new file mode 100644
>>> index 0000000..416ed7f
>>> --- /dev/null
>>> +++ b/drivers/gpu/drm/bridge/synopsys/dw-mipi-dsi.c
>>> @@ -0,0 +1,976 @@
>>> +/*
>>> + * Copyright (c) 2016, Fuzhou Rockchip Electronics Co., Ltd
>>> + * Copyright (C) STMicroelectronics SA 2017
>>> + *
>>> + * This program is free software; you can redistribute it and/or modify
>>> + * it under the terms of the GNU General Public License as published by
>>> + * the Free Software Foundation; either version 2 of the License, or
>>> + * (at your option) any later version.
>>> + *
>>> + * Modified by Philippe Cornu <philippe.cornu at st.com>
>>> + * This generic Synopsys DesignWare MIPI DSI host driver is based on the
>>> + * Rockchip version from rockchip/dw-mipi-dsi.c with phy & bridge APIs.
>>> + */
>>> +
>>> +#include <linux/clk.h>
>>> +#include <linux/component.h>
>>> +#include <linux/iopoll.h>
>>> +#include <linux/module.h>
>>> +#include <linux/of_device.h>
>>> +#include <linux/pm_runtime.h>
>>> +#include <linux/reset.h>
>>> +#include <drm/drmP.h>
>>> +#include <drm/drm_atomic_helper.h>
>>> +#include <drm/drm_bridge.h>
>>> +#include <drm/drm_crtc.h>
>>> +#include <drm/drm_crtc_helper.h>
>>> +#include <drm/drm_mipi_dsi.h>
>>> +#include <drm/drm_of.h>
>>> +#include <drm/bridge/dw_mipi_dsi.h>
>>> +#include <video/mipi_display.h>
>>> +
>>> +#define DSI_VERSION 0x00
>>> +#define DSI_PWR_UP 0x04
>>> +#define RESET 0
>>> +#define POWERUP BIT(0)
>>> +
>>> +#define DSI_CLKMGR_CFG 0x08
>>> +#define TO_CLK_DIVIDSION(div) (((div) & 0xff) << 8)
>>> +#define TX_ESC_CLK_DIVIDSION(div) (((div) & 0xff) << 0)
>>> +
>>> +#define DSI_DPI_VCID 0x0c
>>> +#define DPI_VID(vid) (((vid) & 0x3) << 0)
>>> +
>>> +#define DSI_DPI_COLOR_CODING 0x10
>>> +#define EN18_LOOSELY BIT(8)
>>> +#define DPI_COLOR_CODING_16BIT_1 0x0
>>> +#define DPI_COLOR_CODING_16BIT_2 0x1
>>> +#define DPI_COLOR_CODING_16BIT_3 0x2
>>> +#define DPI_COLOR_CODING_18BIT_1 0x3
>>> +#define DPI_COLOR_CODING_18BIT_2 0x4
>>> +#define DPI_COLOR_CODING_24BIT 0x5
>>> +
>>> +#define DSI_DPI_CFG_POL 0x14
>>> +#define COLORM_ACTIVE_LOW BIT(4)
>>> +#define SHUTD_ACTIVE_LOW BIT(3)
>>> +#define HSYNC_ACTIVE_LOW BIT(2)
>>> +#define VSYNC_ACTIVE_LOW BIT(1)
>>> +#define DATAEN_ACTIVE_LOW BIT(0)
>>> +
>>> +#define DSI_DPI_LP_CMD_TIM 0x18
>>> +#define OUTVACT_LPCMD_TIME(p) (((p) & 0xff) << 16)
>>> +#define INVACT_LPCMD_TIME(p) ((p) & 0xff)
>>> +
>>> +#define DSI_DBI_CFG 0x20
>>> +#define DSI_DBI_CMDSIZE 0x28
>>> +
>>> +#define DSI_PCKHDL_CFG 0x2c
>>> +#define EN_CRC_RX BIT(4)
>>> +#define EN_ECC_RX BIT(3)
>>> +#define EN_BTA BIT(2)
>>> +#define EN_EOTP_RX BIT(1)
>>> +#define EN_EOTP_TX BIT(0)
>>> +
>>> +#define DSI_MODE_CFG 0x34
>>> +#define ENABLE_VIDEO_MODE 0
>>> +#define ENABLE_CMD_MODE BIT(0)
>>> +
>>> +#define DSI_VID_MODE_CFG 0x38
>>> +#define FRAME_BTA_ACK BIT(14)
>>> +#define ENABLE_LOW_POWER (0x3f << 8)
>>> +#define ENABLE_LOW_POWER_MASK (0x3f << 8)
>>> +#define VID_MODE_TYPE_NON_BURST_SYNC_PULSES 0x0
>>> +#define VID_MODE_TYPE_NON_BURST_SYNC_EVENTS 0x1
>>> +#define VID_MODE_TYPE_BURST 0x2
>>> +#define VID_MODE_TYPE_MASK 0x3
>>> +
>>> +#define DSI_VID_PKT_SIZE 0x3c
>>> +#define VID_PKT_SIZE(p) (((p) & 0x3fff) << 0)
>>> +#define VID_PKT_MAX_SIZE 0x3fff
>>> +
>>> +#define DSI_VID_HSA_TIME 0x48
>>> +#define DSI_VID_HBP_TIME 0x4c
>>> +#define DSI_VID_HLINE_TIME 0x50
>>> +#define DSI_VID_VSA_LINES 0x54
>>> +#define DSI_VID_VBP_LINES 0x58
>>> +#define DSI_VID_VFP_LINES 0x5c
>>> +#define DSI_VID_VACTIVE_LINES 0x60
>>> +#define DSI_CMD_MODE_CFG 0x68
>>> +#define MAX_RD_PKT_SIZE_LP BIT(24)
>>> +#define DCS_LW_TX_LP BIT(19)
>>> +#define DCS_SR_0P_TX_LP BIT(18)
>>> +#define DCS_SW_1P_TX_LP BIT(17)
>>> +#define DCS_SW_0P_TX_LP BIT(16)
>>> +#define GEN_LW_TX_LP BIT(14)
>>> +#define GEN_SR_2P_TX_LP BIT(13)
>>> +#define GEN_SR_1P_TX_LP BIT(12)
>>> +#define GEN_SR_0P_TX_LP BIT(11)
>>> +#define GEN_SW_2P_TX_LP BIT(10)
>>> +#define GEN_SW_1P_TX_LP BIT(9)
>>> +#define GEN_SW_0P_TX_LP BIT(8)
>>> +#define EN_ACK_RQST BIT(1)
>>> +#define EN_TEAR_FX BIT(0)
>>> +
>>> +#define CMD_MODE_ALL_LP (MAX_RD_PKT_SIZE_LP | \
>>> + DCS_LW_TX_LP | \
>>> + DCS_SR_0P_TX_LP | \
>>> + DCS_SW_1P_TX_LP | \
>>> + DCS_SW_0P_TX_LP | \
>>> + GEN_LW_TX_LP | \
>>> + GEN_SR_2P_TX_LP | \
>>> + GEN_SR_1P_TX_LP | \
>>> + GEN_SR_0P_TX_LP | \
>>> + GEN_SW_2P_TX_LP | \
>>> + GEN_SW_1P_TX_LP | \
>>> + GEN_SW_0P_TX_LP)
>>> +
>>> +#define DSI_GEN_HDR 0x6c
>>> +#define GEN_HDATA(data) (((data) & 0xffff) << 8)
>>> +#define GEN_HDATA_MASK (0xffff << 8)
>>> +#define GEN_HTYPE(type) (((type) & 0xff) << 0)
>>> +#define GEN_HTYPE_MASK 0xff
>>> +
>>> +#define DSI_GEN_PLD_DATA 0x70
>>> +
>>> +#define DSI_CMD_PKT_STATUS 0x74
>>> +#define GEN_CMD_EMPTY BIT(0)
>>> +#define GEN_CMD_FULL BIT(1)
>>> +#define GEN_PLD_W_EMPTY BIT(2)
>>> +#define GEN_PLD_W_FULL BIT(3)
>>> +#define GEN_PLD_R_EMPTY BIT(4)
>>> +#define GEN_PLD_R_FULL BIT(5)
>>> +#define GEN_RD_CMD_BUSY BIT(6)
>>> +
>>> +#define DSI_TO_CNT_CFG 0x78
>>> +#define HSTX_TO_CNT(p) (((p) & 0xffff) << 16)
>>> +#define LPRX_TO_CNT(p) ((p) & 0xffff)
>>> +
>>> +#define DSI_BTA_TO_CNT 0x8c
>>> +#define DSI_LPCLK_CTRL 0x94
>>> +#define AUTO_CLKLANE_CTRL BIT(1)
>>> +#define PHY_TXREQUESTCLKHS BIT(0)
>>> +
>>> +#define DSI_PHY_TMR_LPCLK_CFG 0x98
>>> +#define PHY_CLKHS2LP_TIME(lbcc) (((lbcc) & 0x3ff) << 16)
>>> +#define PHY_CLKLP2HS_TIME(lbcc) ((lbcc) & 0x3ff)
>>> +
>>> +#define DSI_PHY_TMR_CFG 0x9c
>>> +#define PHY_HS2LP_TIME(lbcc) (((lbcc) & 0xff) << 24)
>>> +#define PHY_LP2HS_TIME(lbcc) (((lbcc) & 0xff) << 16)
>>> +#define MAX_RD_TIME(lbcc) ((lbcc) & 0x7fff)
>>> +
>>> +#define DSI_PHY_RSTZ 0xa0
>>> +#define PHY_DISFORCEPLL 0
>>> +#define PHY_ENFORCEPLL BIT(3)
>>> +#define PHY_DISABLECLK 0
>>> +#define PHY_ENABLECLK BIT(2)
>>> +#define PHY_RSTZ 0
>>> +#define PHY_UNRSTZ BIT(1)
>>> +#define PHY_SHUTDOWNZ 0
>>> +#define PHY_UNSHUTDOWNZ BIT(0)
>>> +
>>> +#define DSI_PHY_IF_CFG 0xa4
>>> +#define N_LANES(n) ((((n) - 1) & 0x3) << 0)
>>> +#define PHY_STOP_WAIT_TIME(cycle) (((cycle) & 0xff) << 8)
>>> +
>>> +#define DSI_PHY_STATUS 0xb0
>>> +#define LOCK BIT(0)
>>> +#define STOP_STATE_CLK_LANE BIT(2)
>>> +
>>> +#define DSI_PHY_TST_CTRL0 0xb4
>>> +#define PHY_TESTCLK BIT(1)
>>> +#define PHY_UNTESTCLK 0
>>> +#define PHY_TESTCLR BIT(0)
>>> +#define PHY_UNTESTCLR 0
>>> +
>>> +#define DSI_PHY_TST_CTRL1 0xb8
>>> +#define PHY_TESTEN BIT(16)
>>> +#define PHY_UNTESTEN 0
>>> +#define PHY_TESTDOUT(n) (((n) & 0xff) << 8)
>>> +#define PHY_TESTDIN(n) (((n) & 0xff) << 0)
>>> +
>>> +#define DSI_INT_ST0 0xbc
>>> +#define DSI_INT_ST1 0xc0
>>> +#define DSI_INT_MSK0 0xc4
>>> +#define DSI_INT_MSK1 0xc8
>>> +
>>> +#define PHY_STATUS_TIMEOUT_US 10000
>>> +#define CMD_PKT_STATUS_TIMEOUT_US 20000
>>> +
>>> +struct dw_mipi_dsi {
>>> + struct drm_bridge bridge;
>>> + struct mipi_dsi_host dsi_host;
>>> + struct drm_bridge *panel_bridge;
>>> + bool is_panel_bridge;
>>> + struct device *dev;
>>> + void __iomem *base;
>>> +
>>> + struct clk *pclk;
>>> +
>>> + unsigned int lane_mbps; /* per lane */
>>> + u32 channel;
>>> + u32 lanes;
>>> + u32 format;
>>> + unsigned long mode_flags;
>>> +
>>> + const struct dw_mipi_dsi_plat_data *plat_data;
>>> +};
>>> +
>>> +/*
>>> + * The controller should generate 2 frames before
>>> + * preparing the peripheral.
>>> + */
>>> +static void dw_mipi_dsi_wait_for_two_frames(struct drm_display_mode *mode)
>>> +{
>>> + int refresh, two_frames;
>>> +
>>> + refresh = drm_mode_vrefresh(mode);
>>> + two_frames = DIV_ROUND_UP(MSEC_PER_SEC, refresh) * 2;
>>> + msleep(two_frames);
>>> +}
>>> +
>>> +static inline struct dw_mipi_dsi *host_to_dsi(struct mipi_dsi_host *host)
>>> +{
>>> + return container_of(host, struct dw_mipi_dsi, dsi_host);
>>> +}
>>> +
>>> +static inline struct dw_mipi_dsi *bridge_to_dsi(struct drm_bridge *bridge)
>>> +{
>>> + return container_of(bridge, struct dw_mipi_dsi, bridge);
>>> +}
>>> +
>>> +static inline void dsi_write(struct dw_mipi_dsi *dsi, u32 reg, u32 val)
>>> +{
>>> + writel(val, dsi->base + reg);
>>> +}
>>> +
>>> +static inline u32 dsi_read(struct dw_mipi_dsi *dsi, u32 reg)
>>> +{
>>> + return readl(dsi->base + reg);
>>> +}
>>> +
>>> +static int dw_mipi_dsi_host_attach(struct mipi_dsi_host *host,
>>> + struct mipi_dsi_device *device)
>>> +{
>>> + struct dw_mipi_dsi *dsi = host_to_dsi(host);
>>> + struct drm_bridge *bridge;
>>> + struct drm_panel *panel;
>>> + int ret;
>>> +
>>> + if (device->lanes > dsi->plat_data->max_data_lanes) {
>>> + dev_err(dsi->dev, "the number of data lanes(%u) is too many\n",
>>> + device->lanes);
>>> + return -EINVAL;
>>> + }
>>> +
>>> + dsi->lanes = device->lanes;
>>> + dsi->channel = device->channel;
>>> + dsi->format = device->format;
>>> + dsi->mode_flags = device->mode_flags;
>>> +
>>> + ret = drm_of_find_panel_or_bridge(host->dev->of_node, 1, 0,
>>> + &panel, &bridge);
>>> + if (ret)
>>> + return ret;
>>> +
>>> + if (panel) {
>>> + bridge = drm_panel_bridge_add(panel, DRM_MODE_CONNECTOR_DSI);
>>> + if (IS_ERR(bridge))
>>> + return PTR_ERR(bridge);
>>> + dsi->is_panel_bridge = true;
>>> + }
>>> +
>>> + dsi->panel_bridge = bridge;
>>> +
>>> + return drm_bridge_add(&dsi->bridge);
>>> +}
>>> +
>>> +static int dw_mipi_dsi_host_detach(struct mipi_dsi_host *host,
>>> + struct mipi_dsi_device *device)
>>> +{
>>> + struct dw_mipi_dsi *dsi = host_to_dsi(host);
>>> +
>>> + if (dsi->is_panel_bridge)
>>> + drm_panel_bridge_remove(dsi->panel_bridge);
>>> +
>>> + drm_bridge_remove(&dsi->bridge);
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static void dw_mipi_message_config(struct dw_mipi_dsi *dsi,
>>> + const struct mipi_dsi_msg *msg)
>>> +{
>>> + bool lpm = msg->flags & MIPI_DSI_MSG_USE_LPM;
>>> + u32 val = 0;
>>> +
>>> + if (msg->flags & MIPI_DSI_MSG_REQ_ACK)
>>> + val |= EN_ACK_RQST;
>>> + if (lpm)
>>> + val |= CMD_MODE_ALL_LP;
>>> +
>>> + dsi_write(dsi, DSI_LPCLK_CTRL, lpm ? 0 : PHY_TXREQUESTCLKHS);
>>> + dsi_write(dsi, DSI_CMD_MODE_CFG, val);
>>> +}
>>> +
>>> +static int dw_mipi_dsi_gen_pkt_hdr_write(struct dw_mipi_dsi *dsi, u32 hdr_val)
>>> +{
>>> + int ret;
>>> + u32 val, mask;
>>> +
>>> + ret = readl_poll_timeout(dsi->base + DSI_CMD_PKT_STATUS,
>>> + val, !(val & GEN_CMD_FULL), 1000,
>>> + CMD_PKT_STATUS_TIMEOUT_US);
>>> + if (ret < 0) {
>>> + dev_err(dsi->dev, "failed to get available command FIFO\n");
>>> + return ret;
>>> + }
>>> +
>>> + dsi_write(dsi, DSI_GEN_HDR, hdr_val);
>>> +
>>> + mask = GEN_CMD_EMPTY | GEN_PLD_W_EMPTY;
>>> + ret = readl_poll_timeout(dsi->base + DSI_CMD_PKT_STATUS,
>>> + val, (val & mask) == mask,
>>> + 1000, CMD_PKT_STATUS_TIMEOUT_US);
>>> + if (ret < 0) {
>>> + dev_err(dsi->dev, "failed to write command FIFO\n");
>>> + return ret;
>>> + }
>>> +
>>> + return 0;
>>> +}
>>> +
>>> +static int dw_mipi_dsi_dcs_short_write(struct dw_mipi_dsi *dsi,
>>> + const struct mipi_dsi_msg *msg)
>>> +{
>>> + const u8 *tx_buf = msg->tx_buf;
>>> + u16 data = 0;
>>> + u32 val;
>>> +
>>> + if (msg->tx_len > 0)
>>> + data |= tx_buf[0];
>>> + if (msg->tx_len > 1)
>>> + data |= tx_buf[1] << 8;
>>> +
>>> + if (msg->tx_len > 2) {
>>> + dev_err(dsi->dev, "too long tx buf length %zu for short write\n",
>>> + msg->tx_len);
>>> + return -EINVAL;
>>> + }
>>> +
>>> + val = GEN_HDATA(data) | GEN_HTYPE(msg->type);
>>> + return dw_mipi_dsi_gen_pkt_hdr_write(dsi, val);
>>> +}
>>> +
>>> +static int dw_mipi_dsi_dcs_long_write(struct dw_mipi_dsi *dsi,
>>> + const struct mipi_dsi_msg *msg)
>>> +{
>>> + const u8 *tx_buf = msg->tx_buf;
>>> + int len = msg->tx_len, pld_data_bytes = sizeof(u32), ret;
>>> + u32 hdr_val = GEN_HDATA(msg->tx_len) | GEN_HTYPE(msg->type);
>>> + u32 remainder;
>>> + u32 val;
>>> +
>>> + if (msg->tx_len < 3) {
>>> + dev_err(dsi->dev, "wrong tx buf length %zu for long write\n",
>>> + msg->tx_len);
>>> + return -EINVAL;
>>> + }
>>> +
>>> + while (DIV_ROUND_UP(len, pld_data_bytes)) {
>>> + if (len < pld_data_bytes) {
>>> + remainder = 0;
>>> + memcpy(&remainder, tx_buf, len);
>>> + dsi_write(dsi, DSI_GEN_PLD_DATA, remainder);
>>> + len = 0;
>>> + } else {
>>> + memcpy(&remainder, tx_buf, pld_data_bytes);
>>> + dsi_write(dsi, DSI_GEN_PLD_DATA, remainder);
>>> + tx_buf += pld_data_bytes;
>>> + len -= pld_data_bytes;
>>> + }
>>> +
>>> + ret = readl_poll_timeout(dsi->base + DSI_CMD_PKT_STATUS,
>>> + val, !(val & GEN_PLD_W_FULL), 1000,
>>> + CMD_PKT_STATUS_TIMEOUT_US);
>>> + if (ret < 0) {
>>> + dev_err(dsi->dev,
>>> + "failed to get available write payload FIFO\n");
>>> + return ret;
>>> + }
>>> + }
>>> +
>>> + return dw_mipi_dsi_gen_pkt_hdr_write(dsi, hdr_val);
>>> +}
>>> +
>>> +static ssize_t dw_mipi_dsi_host_transfer(struct mipi_dsi_host *host,
>>> + const struct mipi_dsi_msg *msg)
>>> +{
>>> + struct dw_mipi_dsi *dsi = host_to_dsi(host);
>>> + int ret;
>>> +
>>> + /*
>>> + * TODO dw drv improvements
>>> + * use mipi_dsi_create_packet() instead of all following
>>> + * functions and code (no switch cases, no
>>> + * dw_mipi_dsi_dcs_short_write(), only the loop in long_write...)
>>> + * and use packet.header...
>>> + */
>>> + dw_mipi_message_config(dsi, msg);
>>> +
>>> + switch (msg->type) {
>>> + case MIPI_DSI_DCS_SHORT_WRITE:
>>> + case MIPI_DSI_DCS_SHORT_WRITE_PARAM:
>>> + case MIPI_DSI_SET_MAXIMUM_RETURN_PACKET_SIZE:
>>> + ret = dw_mipi_dsi_dcs_short_write(dsi, msg);
>>> + break;
>>> + case MIPI_DSI_DCS_LONG_WRITE:
>>> + ret = dw_mipi_dsi_dcs_long_write(dsi, msg);
>>> + break;
>>> + default:
>>> + dev_err(dsi->dev, "unsupported message type 0x%02x\n",
>>> + msg->type);
>>> + ret = -EINVAL;
>>> + }
>>> +
>>> + return ret;
>>> +}
>>> +
>>> +static const struct mipi_dsi_host_ops dw_mipi_dsi_host_ops = {
>>> + .attach = dw_mipi_dsi_host_attach,
>>> + .detach = dw_mipi_dsi_host_detach,
>>> + .transfer = dw_mipi_dsi_host_transfer,
>>> +};
>>> +
>>> +static void dw_mipi_dsi_video_mode_config(struct dw_mipi_dsi *dsi)
>>> +{
>>> + u32 val;
>>> +
>>> + /*
>>> + * TODO dw drv improvements
>>> + * enabling low power is panel-dependent, we should use the
>>> + * panel configuration here...
>>> + */
>>> + val = ENABLE_LOW_POWER;
>>> +
>>> + if (dsi->mode_flags & MIPI_DSI_MODE_VIDEO_BURST)
>>> + val |= VID_MODE_TYPE_BURST;
>>> + else if (dsi->mode_flags & MIPI_DSI_MODE_VIDEO_SYNC_PULSE)
>>> + val |= VID_MODE_TYPE_NON_BURST_SYNC_PULSES;
>>> + else
>>> + val |= VID_MODE_TYPE_NON_BURST_SYNC_EVENTS;
>>> +
>>> + dsi_write(dsi, DSI_VID_MODE_CFG, val);
>>> +}
>>> +
>>> +static void dw_mipi_dsi_set_mode(struct dw_mipi_dsi *dsi,
>>> + unsigned long mode_flags)
>>> +{
>>> + dsi_write(dsi, DSI_PWR_UP, RESET);
>>> +
>>> + if (mode_flags & MIPI_DSI_MODE_VIDEO) {
>>> + dsi_write(dsi, DSI_MODE_CFG, ENABLE_VIDEO_MODE);
>>> + dw_mipi_dsi_video_mode_config(dsi);
>>> + dsi_write(dsi, DSI_LPCLK_CTRL, PHY_TXREQUESTCLKHS);
>>> + } else {
>>> + dsi_write(dsi, DSI_MODE_CFG, ENABLE_CMD_MODE);
>>> + }
>>> +
>>> + dsi_write(dsi, DSI_PWR_UP, POWERUP);
>>> +}
>>> +
>>> +static void dw_mipi_dsi_disable(struct dw_mipi_dsi *dsi)
>>> +{
>>> + dsi_write(dsi, DSI_PWR_UP, RESET);
>>> + dsi_write(dsi, DSI_PHY_RSTZ, PHY_RSTZ);
>>> +}
>>> +
>>> +static void dw_mipi_dsi_init(struct dw_mipi_dsi *dsi)
>>> +{
>>> + /*
>>> + * The maximum permitted escape clock is 20MHz and it is derived from
>>> + * lanebyteclk, which is running at "lane_mbps / 8". Thus we want:
>>> + *
>>> + * (lane_mbps >> 3) / esc_clk_division < 20
>>> + * which is:
>>> + * (lane_mbps >> 3) / 20 > esc_clk_division
>>> + */
>>> + u32 esc_clk_division = (dsi->lane_mbps >> 3) / 20 + 1;
>>> +
>>> + dsi_write(dsi, DSI_PWR_UP, RESET);
>>> +
>>> + /*
>>> + * TODO dw drv improvements
>>> + * timeout clock division should be computed with the
>>> + * high speed transmission counter timeout and byte lane...
>>> + */
>>> + dsi_write(dsi, DSI_CLKMGR_CFG, TO_CLK_DIVIDSION(10) |
>>> + TX_ESC_CLK_DIVIDSION(esc_clk_division));
>>> +}
>>> +
>>> +static void dw_mipi_dsi_dpi_config(struct dw_mipi_dsi *dsi,
>>> + struct drm_display_mode *mode)
>>> +{
>>> + u32 val = 0, color = 0;
>>> +
>>> + switch (dsi->format) {
>>> + case MIPI_DSI_FMT_RGB888:
>>> + color = DPI_COLOR_CODING_24BIT;
>>> + break;
>>> + case MIPI_DSI_FMT_RGB666:
>>> + color = DPI_COLOR_CODING_18BIT_2 | EN18_LOOSELY;
>>> + break;
>>> + case MIPI_DSI_FMT_RGB666_PACKED:
>>> + color = DPI_COLOR_CODING_18BIT_1;
>>> + break;
>>> + case MIPI_DSI_FMT_RGB565:
>>> + color = DPI_COLOR_CODING_16BIT_1;
>>> + break;
>>> + }
>>> +
>>> + if (mode->flags & DRM_MODE_FLAG_NVSYNC)
>>> + val |= VSYNC_ACTIVE_LOW;
>>> + if (mode->flags & DRM_MODE_FLAG_NHSYNC)
>>> + val |= HSYNC_ACTIVE_LOW;
>>> +
>>> + dsi_write(dsi, DSI_DPI_VCID, DPI_VID(dsi->channel));
>>> + dsi_write(dsi, DSI_DPI_COLOR_CODING, color);
>>> + dsi_write(dsi, DSI_DPI_CFG_POL, val);
>>> + /*
>>> + * TODO dw drv improvements
>>> + * largest packet sizes during hfp or during vsa/vpb/vfp
>>> + * should be computed according to byte lane, lane number and only
>>> + * if sending lp cmds in high speed is enable (PHY_TXREQUESTCLKHS)
>>> + */
>>> + dsi_write(dsi, DSI_DPI_LP_CMD_TIM, OUTVACT_LPCMD_TIME(4)
>>> + | INVACT_LPCMD_TIME(4));
>>> +}
>>> +
>>> +static void dw_mipi_dsi_packet_handler_config(struct dw_mipi_dsi *dsi)
>>> +{
>>> + dsi_write(dsi, DSI_PCKHDL_CFG, EN_CRC_RX | EN_ECC_RX | EN_BTA);
>>> +}
>>> +
>>> +static void dw_mipi_dsi_video_packet_config(struct dw_mipi_dsi *dsi,
>>> + struct drm_display_mode *mode)
>>> +{
>>> + /*
>>> + * TODO dw drv improvements
>>> + * only burst mode is supported here. For non-burst video modes,
>>> + * we should compute DSI_VID_PKT_SIZE, DSI_VCCR.NUMC &
>>> + * DSI_VNPCR.NPSIZE... especially because this driver supports
>>> + * non-burst video modes, see dw_mipi_dsi_video_mode_config()...
>>> + */
>>> + dsi_write(dsi, DSI_VID_PKT_SIZE, VID_PKT_SIZE(mode->hdisplay));
>>> +}
>>> +
>>> +static void dw_mipi_dsi_command_mode_config(struct dw_mipi_dsi *dsi)
>>> +{
>>> + /*
>>> + * TODO dw drv improvements
>>> + * compute high speed transmission counter timeout according
>>> + * to the timeout clock division (TO_CLK_DIVIDSION) and byte lane...
>>> + */
>>> + dsi_write(dsi, DSI_TO_CNT_CFG, HSTX_TO_CNT(1000) | LPRX_TO_CNT(1000));
>>> + /*
>>> + * TODO dw drv improvements
>>> + * the Bus-Turn-Around Timeout Counter should be computed
>>> + * according to byte lane...
>>> + */
>>> + dsi_write(dsi, DSI_BTA_TO_CNT, 0xd00);
>>> + dsi_write(dsi, DSI_MODE_CFG, ENABLE_CMD_MODE);
>>> +}
>>> +
>>> +/* Get lane byte clock cycles. */
>>> +static u32 dw_mipi_dsi_get_hcomponent_lbcc(struct dw_mipi_dsi *dsi,
>>> + struct drm_display_mode *mode,
>>> + u32 hcomponent)
>>> +{
>>> + u32 frac, lbcc;
>>> +
>>> + lbcc = hcomponent * dsi->lane_mbps * MSEC_PER_SEC / 8;
>>> +
>>> + frac = lbcc % mode->clock;
>>> + lbcc = lbcc / mode->clock;
>>> + if (frac)
>>> + lbcc++;
>>> +
>>> + return lbcc;
>>> +}
>>> +
>>> +static void dw_mipi_dsi_line_timer_config(struct dw_mipi_dsi *dsi,
>>> + struct drm_display_mode *mode)
>>> +{
>>> + u32 htotal, hsa, hbp, lbcc;
>>> +
>>> + htotal = mode->htotal;
>>> + hsa = mode->hsync_end - mode->hsync_start;
>>> + hbp = mode->htotal - mode->hsync_end;
>>> +
>>> + /*
>>> + * TODO dw drv improvements
>>> + * computations below may be improved...
>>> + */
>>> + lbcc = dw_mipi_dsi_get_hcomponent_lbcc(dsi, mode, htotal);
>>> + dsi_write(dsi, DSI_VID_HLINE_TIME, lbcc);
>>> +
>>> + lbcc = dw_mipi_dsi_get_hcomponent_lbcc(dsi, mode, hsa);
>>> + dsi_write(dsi, DSI_VID_HSA_TIME, lbcc);
>>> +
>>> + lbcc = dw_mipi_dsi_get_hcomponent_lbcc(dsi, mode, hbp);
>>> + dsi_write(dsi, DSI_VID_HBP_TIME, lbcc);
>>> +}
>>> +
>>> +static void dw_mipi_dsi_vertical_timing_config(struct dw_mipi_dsi *dsi,
>>> + struct drm_display_mode *mode)
>>> +{
>>> + u32 vactive, vsa, vfp, vbp;
>>> +
>>> + vactive = mode->vdisplay;
>>> + vsa = mode->vsync_end - mode->vsync_start;
>>> + vfp = mode->vsync_start - mode->vdisplay;
>>> + vbp = mode->vtotal - mode->vsync_end;
>>> +
>>> + dsi_write(dsi, DSI_VID_VACTIVE_LINES, vactive);
>>> + dsi_write(dsi, DSI_VID_VSA_LINES, vsa);
>>> + dsi_write(dsi, DSI_VID_VFP_LINES, vfp);
>>> + dsi_write(dsi, DSI_VID_VBP_LINES, vbp);
>>> +}
>>> +
>>> +static void dw_mipi_dsi_dphy_timing_config(struct dw_mipi_dsi *dsi)
>>> +{
>>> + /*
>>> + * TODO dw drv improvements
>>> + * data & clock lane timers should be computed according to panel
>>> + * blankings and to the automatic clock lane control mode...
>>> + * note: DSI_PHY_TMR_CFG.MAX_RD_TIME should be in line with
>>> + * DSI_CMD_MODE_CFG.MAX_RD_PKT_SIZE_LP (see CMD_MODE_ALL_LP)
>>> + */
>>> + dsi_write(dsi, DSI_PHY_TMR_CFG, PHY_HS2LP_TIME(0x40)
>>> + | PHY_LP2HS_TIME(0x40) | MAX_RD_TIME(10000));
>>> +
>>> + dsi_write(dsi, DSI_PHY_TMR_LPCLK_CFG, PHY_CLKHS2LP_TIME(0x40)
>>> + | PHY_CLKLP2HS_TIME(0x40));
>>> +}
>>> +
>>> +static void dw_mipi_dsi_dphy_interface_config(struct dw_mipi_dsi *dsi)
>>> +{
>>> + /*
>>> + * TODO dw drv improvements
>>> + * stop wait time should be the maximum between host dsi
>>> + * and panel stop wait times
>>> + */
>>> + dsi_write(dsi, DSI_PHY_IF_CFG, PHY_STOP_WAIT_TIME(0x20) |
>>> + N_LANES(dsi->lanes));
>>> +}
>>> +
>>> +static void dw_mipi_dsi_dphy_init(struct dw_mipi_dsi *dsi)
>>> +{
>>> + /* Clear PHY state */
>>> + dsi_write(dsi, DSI_PHY_RSTZ, PHY_DISFORCEPLL | PHY_DISABLECLK
>>> + | PHY_RSTZ | PHY_SHUTDOWNZ);
>>> + dsi_write(dsi, DSI_PHY_TST_CTRL0, PHY_UNTESTCLR);
>>> + dsi_write(dsi, DSI_PHY_TST_CTRL0, PHY_TESTCLR);
>>> + dsi_write(dsi, DSI_PHY_TST_CTRL0, PHY_UNTESTCLR);
>>> +}
>>> +
>>> +static void dw_mipi_dsi_dphy_enable(struct dw_mipi_dsi *dsi)
>>> +{
>>> + u32 val;
>>> + int ret;
>>> +
>>> + dsi_write(dsi, DSI_PHY_RSTZ, PHY_ENFORCEPLL | PHY_ENABLECLK |
>>> + PHY_UNRSTZ | PHY_UNSHUTDOWNZ);
>>> +
>>> + ret = readl_poll_timeout(dsi->base + DSI_PHY_STATUS,
>>> + val, val & LOCK, 1000, PHY_STATUS_TIMEOUT_US);
>>> + if (ret < 0)
>>> + DRM_DEBUG_DRIVER("failed to wait phy lock state\n");
>>> +
>>> + ret = readl_poll_timeout(dsi->base + DSI_PHY_STATUS,
>>> + val, val & STOP_STATE_CLK_LANE, 1000,
>>> + PHY_STATUS_TIMEOUT_US);
>>> + if (ret < 0)
>>> + DRM_DEBUG_DRIVER("failed to wait phy clk lane stop state\n");
>>> +}
>>> +
>>> +static void dw_mipi_dsi_clear_err(struct dw_mipi_dsi *dsi)
>>> +{
>>> + dsi_read(dsi, DSI_INT_ST0);
>>> + dsi_read(dsi, DSI_INT_ST1);
>>> + dsi_write(dsi, DSI_INT_MSK0, 0);
>>> + dsi_write(dsi, DSI_INT_MSK1, 0);
>>> +}
>>> +
>>> +static void dw_mipi_dsi_bridge_post_disable(struct drm_bridge *bridge)
>>> +{
>>> + struct dw_mipi_dsi *dsi = bridge_to_dsi(bridge);
>>> +
>>> + /*
>>> + * Switch to cmd mode before panel-bridge disable & panel unprepare.
>>> + * Note: panel-bridge disable & panel disable has been called
>>> + * before by the drm framework.
>> I don't think that's exactly the case. I think the sequence should be as in the
>> call chain below.
>>
>>> + */
>>> + dw_mipi_dsi_set_mode(dsi, 0);
>>> +
>>> + /*
>>> + * TODO Only way found to call panel-bridge disable & panel unprepare
>>> + * before the dsi "final" disable... can we do better?
>> I agree, this is a problem. More below.
>>
>>> + */
>>> + drm_bridge_post_disable(dsi->panel_bridge);
>>> +
>> I'm guessing our display chain is something like:
>>
>> KMS_encoder -> DW_DSI_bridge -> Panel_bridge -> Panel
>>
>> The order in which the disable ops are called:
>>
>> drm_bridge_disable(Panel_bridge)
>> - drm_panel_disable(Panel)
>> drm_bridge_disable(DW_DSI_bridge)
>> encoder_funcs->prepare(KMS_encoder)
>> drm_bridge_post_disable(DW_DSI_bridge)
>> drm_bridge_post_disable(Panel_bridge)
>> - drm_panel_unprepare(Panel)
>>
>> Assuming that only drm_panel_unprepare() requires sending DSI commands, you could have
>> switched to command mode in DW_DSI_bridge's disable() op, and do the "final" DSI disable
>> in DW_DSI_bridge's post_disable(), but that would still result in drm_panel_unprepare()
>> being called with the DSI host dead.
>>
>> The existing call chain of consecutive bridges is the most symmetric one, and the one
>> expected to work in most cases, but it clearly doesn't work in your use case.
>>
>> We have a few options:
>>
>> - Undo the drm-panel-bridge stuff, and have the freedom of calling drm_panel ops in
>> whatever order we want.
>>
>> - Put a big TODO/HACK comment here, saying that this needs to be fixed in the drm_bridge
>> framework and the API needs to be updated to manage our own call chains. Also,
>> instead of calling "drm_bridge_post_disable(dsi->panel_bridge);" explicitly, we
>> can manually call panel_bridge->post_disable() op directly. This avoids us doing
>> things recursively.
>>
>> We would implement the TODO task in drm_bridges only when there are more people
>> desperately in the need to have customizable call chains of bridge ops for long
>> display chains, so I don't see it being implemented in the near future, but I don't
>> think there should be any problem keeping this hack in the dw dsi driver for now.
>>
>> What choice do you prefer?
>>
>> Eric, Daniel,
>>
>> Fyi, this is another case where the panel-bridge stuff doesn't work so well. Not
>> criticizing or anything, just pointing out :)
>
> I have just looked at existing panel drivers, most of them (probably all
> supporting DCS commands) sends commands to the panel in unprepare
> callback, and it looks correct.
>
> I am not sure what should be fixed in the framework, some alternatives I
> see:
> 1. change order of disable callbacks, usually it should be reverse of
> order of enable callbacks,
> but I guess it could break other devices with different requirements,
> 2. do not use call-chain, instead every bridge will be responsible to
> call attached sink's callbacks, this way dsi bridge can turn off dsi
> bus, after calling panel_bridge.post_disable,
> it looks for me the most flexible solution, but it leaves the
> responsibility to the drivers.
> 3. move DSI host power management to mipi_dsi bus, ie it should be
> enabled on dsi device request, and disabled after dsi device does not
> need power anymore.
2) seems the most flexible to me too, it would result in a lot of boilerplate
code in the bridge drivers, 90% of which work with the existing code. We could
consider converting the bridge drivers to explicitly call sink callbacks as a
long term task, though.
3) sounds like a nice idea to abstract away this issue, but would probably be
hard to get right so that it works across multiple DSI controllers.
Thanks,
Archit
--
Qualcomm Innovation Center, Inc. is a member of Code Aurora Forum,
a Linux Foundation Collaborative Project
More information about the dri-devel
mailing list