为了点亮一块MIPI屏幕,我们除了要了解MIPI DSI的工作原理之外,大前提是要了解整个MIPI DSI图显系统的组成,更需要清楚点亮一块MIPI屏幕需要做哪些事情。
本文会捋顺各个环节所实现的功能以及基于RK3399来分析各个环节实现的原理和注意事项。
MIPI图显系统的硬件组成如下图表示,其涵盖了数据以及控制信号的数据通路。
图显处理器通过DPI接口将像素数据传输到MIPI DSI Host,MIPI D-PHY作为显示屏和DSI Host之间由物理媒介,将编码后的像素数据发送到MIPI显示屏。
对于MIPI DSI显示屏而言,无需MIPI信号转换的称之为panel,内部有数据信号转换桥片的称之为bridge。
整个MIPI图显系统除了基本的像素数据信号外,为了使整个显示系统能够正常工作,还包含其他与显示屏相关的控制信号,包括显示屏内部IC配置、显示屏背光配置、显示屏的复位和上电配置。
对于点亮一块MIPI屏幕而言,重中之重是要正确的配置显示屏参数,配置方式主要有如下3种:
通过PWM来实现MIPI屏幕的背光控制,使用GPIO完成显示屏的复位、上电的控制。
在设备树中定义MIPI DSI图显系统的联结关系。
以RK3399为例,其提供了两路MIPI DSI
通道,分别是dsi@ff960000
和dsi1: dsi@ff968000
,代表MIPI DSI host
。
2050 dsi: dsi@ff960000 {
2051 compatible = "rockchip,rk3399-mipi-dsi";
2052 reg = <0x0 0xff960000 0x0 0x8000>;
...
2083 dsi1: dsi@ff968000 {
2084 compatible = "rockchip,rk3399-mipi-dsi";
2085 reg = <0x0 0xff968000 0x0 0x8000>;
...
RK3399芯片使用了Synopsy的DPHY。控制器与DPHY之间的关系如下图所示:
MIPI DSI
设备树结点中有一个信息同MIPI显示密切相关,那就是时钟信息。可以看出MIPI DSI
需要三路时钟,分别是ref
、pclk
、phy_cfg
。
2050 dsi: dsi@ff960000 {
2051 compatible = "rockchip,rk3399-mipi-dsi";
...
2054 clocks = <&cru SCLK_DPHY_PLL>, <&cru PCLK_MIPI_DSI0>,
2055 <&cru SCLK_DPHY_TX0_CFG>;
2056 clock-names = "ref", "pclk", "phy_cfg";
pclk
是MIPI DSI host
的APB时钟,用于配置MIPI DSI host
寄存器以及中断等。ref
和phy_cfg
是MIPI DPHY所需时钟。这两路时钟由MIPI DSI host提供。其中ref
时钟用于MIPI DPHY内部PLL产生主机侧的串行发送时钟。phy_cfg
是在配置MIPI DPHY时使用。
MIPI DSI
同图显控制器vop之间在逻辑层面上的联结关系如下:
# MIPI DSI Host
dsi_in_vopb: endpoint@0 {
reg = <0>;
remote-endpoint = <&vopb_out_dsi>;
};
dsi_in_vopl: endpoint@1 {
reg = <1>;
remote-endpoint = <&vopl_out_dsi>;
};
# VOP
vopb_out_dsi: endpoint@1 {
reg = <1>;
remote-endpoint = <&dsi_in_vopb>;
};
vopb_out_dsi1: endpoint@4 {
reg = <4>;
remote-endpoint = <&dsi1_in_vopb>;
};
后文所涉及到的代码部分,均基于DRM架构实现
请注意以下几个关键的数据结构,后文的MIPI DSI初始化以及MIPI显示系统初始化均以它们为核心进行展开,包括各数据结构的例化工作和创建各数据结构之间的联结关系。
struct mipi_dsi_host
struct mipi_dsi_host {
struct device *dev;
const struct mipi_dsi_host_ops *ops;
struct list_head list;
};
该数据结构由DRM MIPI DSI提供,用以描述MIPI DSI Host,包括Host的驱动设备、Host提供的功能函数(后文会介绍具体功能),Host链表的设备注册、管理。
struct mipi_dsi_device
struct mipi_dsi_device {
struct mipi_dsi_host *host;
struct device dev;
char name[DSI_DEV_NAME_SIZE];
unsigned int channel;
unsigned int lanes;
enum mipi_dsi_pixel_format format;
unsigned long mode_flags;
};
该数据结构由DRM MIPI DSI提供,用以描述DSI设备信息,主要包括DSI设备的lane数量(最多4lane)、像素格式(由Host决定,如RGB888、RGB565等)。
struct mipi_dsi_host_ops
struct mipi_dsi_host_ops {
int (*attach)(struct mipi_dsi_host *host,
struct mipi_dsi_device *dsi);
int (*detach)(struct mipi_dsi_host *host,
struct mipi_dsi_device *dsi);
ssize_t (*transfer)(struct mipi_dsi_host *host,
const struct mipi_dsi_msg *msg);
};
该数据结构由DRM MIPI DSI提供,用以描述DSI Host所能提供的功能函数,包括DSI Host和显示屏之间创建联结关系需要使用的attach、通过DSI Host配置显示屏的transfer。
基于DRM的图显系统中,MIPI DSI子系统主要由DSI CORE与PANEL CORE组成,二者内建连接关系后注册到DRM CORE系统。
在DRM架构下,提供了drm_mipi_dsi.c
、drm_panel.c
以及drm_bridge.c
三个核心文件。用户的MIPI DSI驱动以drm_mipi_dsi.c
为核心进行代码编写,例如RK3399的MIPI驱动dw-mipi-dsi.c
。各显示屏厂商的驱动代码基于后两者进行编写,例如较为广泛使用的panel-simple.c
。
从第一章内容来看,点亮MIPI DSI屏幕并能正常的显示图像,在DRM架构下需完成如下初始化工作:
为了实现以上初始化工作,我们需要在设备树DTS文件中约定各种初始化参数,包括各个模块的功能参数以及各个模块之间的联结关系,在驱动代码中配置各IP及外设硬件,并基于DRM架构注册出各组件,从软件层面勾勒出MIPI DSI的数据流路径。
RK3399使用数据结构struct dw_mipi_dsi
描述MIPI DSI设备,该数据结构也是整个MIPI DSI图显系统的核心,囊括了系统中的各个组件。
struct dw_mipi_dsi {
struct drm_encoder encoder;
struct drm_connector connector;
struct drm_bridge *bridge;
struct device_node *client;
struct mipi_dsi_host dsi_host;
struct mipi_dphy dphy;
struct drm_panel *panel;
struct device *dev;
struct regmap *grf;
struct reset_control *rst;
struct regmap *regmap;
struct clk *pclk;
struct clk *h2p_clk;
int irq;
struct dw_mipi_dsi *master;
struct dw_mipi_dsi *slave;
struct mutex mutex;
bool prepared;
unsigned int id;
unsigned long mode_flags;
unsigned int lane_mbps; /* per lane */
u32 channel;
u32 lanes;
u32 format;
struct drm_display_mode mode;
const struct dw_mipi_dsi_plat_data *pdata;
};
DRM架构相关
基于DRM KMS架构的MIPI DSI图显系统也同样遵循其设定的组件规则,MIPI Host属于DRM encoder,D-PHY和PANEL部分属于DRM connector。在实际使用过程种你可能发现这样一个现象,就是电路板并没有连接MIPI屏幕,但是DRM connector的连接状态依然是connected,这是因为MIPI DSI无法真实的检测到物理连接关系,通过软件定义DRM connector和encoder之间的连接关系,当一切都初始化成功的时候,connector就处于connected状态了。
struct drm_encoder encoder;
struct drm_connector connector;
struct drm_bridge *bridge;
struct drm_panel *panel;
MIPI DSI主体
这里所说的主体主要包括MIPI DSI Host、D-PHY、bridge或pannel。不仅需要表示MIPI DSI图显系统的关键组成模块,也需要定义彼此之间硬件与软件层面的连接关系。
struct mipi_dsi_host dsi_host;
struct mipi_dphy dphy;
struct drm_bridge *bridge;
struct drm_panel *panel;
MIPI DSI参数
我们关心的MIPI DSI参数主要包括物理硬件定义、时钟频率、复位控制等。而物理硬件定义又包括lane数目、通道数、lane速率等。
unsigned long mode_flags;
unsigned int lane_mbps; /* per lane */
u32 channel;
u32 lanes;
u32 format;
显示参数
MIPI DSI图显系统不像HDMI、VGA那样可以通过EDID获取到显示参数,也同样不支持热插拔操作。其显示参数如分辨率均是在显示屏初始化时注册到drm_display_mode中,当我们将MIPI DSI注册进DRM系统中的时候,直接解析drm_display_mode数据结构获取显示参数。
struct drm_display_mode mode;
const struct dw_mipi_dsi_plat_data *pdata;
介绍了MIPI DSI关键数据结构之后,接下来我们看看MIPI DSI的初始化流程是什么样的。
概况来讲,MIPI DSI Host初始化包括两部分内容:初始化MIPI DSI Host/D-PHY功能、构建MIPI DSI与D-PHY、显示屏之间的联结关系。关于Host/D-PHY的配置细节,因为每一家IP的实现不尽相同,故本篇文章不做具体分析。
初始化流程如下图所示:
初始化流程解析
同所有设备驱动一样,在驱动代码的开始处解析设备树,这里只需要解析MIPI DSI结点即可。SoC厂商会实现这部分设备树的定义,我们只需要关心时钟相关的选项即可。
MIPI DSI host和D-PHY之间的初始化存在天生的联系,可以基于通用phy代码架构进行D-PHY初始化,也可以在Host代码进行D-PHY初始化。
在整个的Host初始化流程中,非常关键的一步是注册Host ops,其存在的意义是为panel或bridge提供Host控制的一种机制。例如panel通过.attach
联结Host,通过.transfer
控制DSI Host发送屏幕初始化序列的DCS包。
基于DRM架构的MIPI DSI图显系统,必须注册encoder和connector两个组件,这属于常规操作,同HDMI、VGA、LVDS等图显系统一样。此处我们需要重点关注encoder的.enable
,该函数会完成MIPI DSI Host、D-PHY的功能配置。如下图所示:
以上所有Host、D-PHY相关初始化均成功之后,构建Host与panel(bridge)之间的联结关系:
int drm_panel_attach(struct drm_panel *panel, struct drm_connector *connector)
{
if (panel->connector)
return -EBUSY;
panel->connector = connector;
panel->drm = connector->dev;
return 0;
}
本文只分析panel的初始化流程,对于bridge的初始化不做过多阐述。从原理上来讲,二者区别不大。在嵌入式领域,使用最多的是panel类型的屏幕。基于DRM架构,有专门的panel驱动,如下所示:
rk@ubuntu:~/OK3399-linux-release/kernel$ ls drivers/gpu/drm/panel/
Makefile panel-samsung-ld9040.c panel-sharp-lq101r1sx01.c panel-simple.o
Kconfig panel-lg-lg4573.c panel-samsung-s6e8aa0.c panel-simple.c
对于大多数的MIPI DSI显示屏,我们都可以基于panel-simple.c编写代码,在其中例化进我们的屏幕配置。当然,LCD、LVDS的panel驱动也在这个文件中,要按需编写。
当我们拿到一块MIPI DSI显示屏之后,首先需要确定其硬件连接关系,查看是否需要通过GPIO控制上下电、确定屏幕参数配置方式、PWM背光调节等。
通过GPIO上下电的控制方式并不多见,若存在这种需求,则需要在设备树中配置pinctrl子系统。
屏幕参数的配置方式比较灵活,在前面已经介绍过。
PWM背光调节功能是MIPI DSI屏幕的必备项,但这部分并不难,我们需要做的是挂载相应的PWM背光驱动即可。
对于panel的初始化,其流程如下图所示:
初始化流程解析
初始化的第一步是解析MIPI DSI屏幕的参数,包括上电参数、背光控制、lane数量、图显时序参数等等。这个是需要我们自己在设备树文件中补充定义的,根据自己手中的屏幕量身定制。
&dsi {
panel@0{
status = "okay";
compatible ="simple-panel-dsi";
reg = <0>;
backlight = <&dsi_backlight>;
re-delay-ms = <2>;
...
dsi,flags = <(MIPI_DSI_MODE_VIDEO | MIPI_DSI_MODE_VIDEO_BURST |
MIPI_DSI_MODE_LPM | MIPI_DSI_MODE_EOT_PACKET)>;
dsi,format = <MIPI_DSI_FMT_RGB888>;
dsi,lanes = <4>;
display-timings {
native-mode = <&timing1>;
timing1: timing1 {
clock-frequency = <45000000>;
...
pixelclk-active = <0>;
};
};
};
};
若需要通过MIPI DSI DCS配置屏幕,则还需要定义init-sequence
初始化序列,通过DCS配置屏幕时,需要注册出panel prepare函数,当MIPI DSI Host使能时回调到它,然通过MIPI DSI host的.transfer
完成DCS数据的发送。例如panel_simple_prepare()
函数:
static int panel_simple_prepare(struct drm_panel *panel)
{
struct panel_simple *p = to_panel_simple(panel);
int err;
...
if (p->on_cmds) {
if (p->dsi)
err = panel_simple_dsi_send_cmds(p, p->on_cmds);
else if (p->cmd_type == CMD_TYPE_SPI)
err = panel_simple_spi_send_cmds(p, p->on_cmds);
if (err)
dev_err(p->dev, "failed to send on cmds\n");
}
...
}
通过panel_simple_dsi_send_cmds()调用DCS发送函数:
static int panel_simple_dsi_send_cmds(struct panel_simple *panel,
struct panel_cmds *cmds)
{
...
switch (cmd->dchdr.dtype) {
case MIPI_DSI_GENERIC_SHORT_WRITE_0_PARAM:
case MIPI_DSI_GENERIC_SHORT_WRITE_1_PARAM:
case MIPI_DSI_GENERIC_SHORT_WRITE_2_PARAM:
case MIPI_DSI_GENERIC_LONG_WRITE:
err = mipi_dsi_generic_write(dsi, cmd->payload,
cmd->dchdr.dlen);
break;
case MIPI_DSI_DCS_SHORT_WRITE:
case MIPI_DSI_DCS_SHORT_WRITE_PARAM:
case MIPI_DSI_DCS_LONG_WRITE:
err = mipi_dsi_dcs_write_buffer(dsi, cmd->payload,
cmd->dchdr.dlen);
break;
default:
return -EINVAL;
}
...
return 0;
}
最后调用到MIPI DSI Host的ops函数:
static ssize_t mipi_dsi_device_transfer(struct mipi_dsi_device *dsi,
struct mipi_dsi_msg *msg)
{
const struct mipi_dsi_host_ops *ops = dsi->host->ops;
if (!ops || !ops->transfer)
return -ENOSYS;
if (dsi->mode_flags & MIPI_DSI_MODE_LPM)
msg->flags |= MIPI_DSI_MSG_USE_LPM;
return ops->transfer(dsi->host, msg);
}
当以上具体的配置工作正常结束之后,更新panel-list链表以使得DRM架构下可以找到对应的panel组件。