RK3288 Android 5.1系统 Linux 3.10
mipi屏参数配置文件所在的路径:kernel/arch/arm/boot/dts/xxx_mipi.dtsi
屏参数配置文件包括四个部分:mipi host配置、屏电源控制配置、屏初始化序列和屏参。
mipi屏参数文件解析:
mipi host配置、屏电源控制配置、屏初始化序列是在 kernel/drivers/video/rockchip/screen/lcd_mipi.c 中解析。
屏参是在 kernel/drivers/video/of_display_timing.c 中解析。
1、mipi host 配置
// mipi host 配置结构 disp_mipi_init: mipi_dsi_init{ compatible = "rockchip,mipi_dsi_init"; rockchip,screen_init = <1>; rockchip,dsi_lane = <4>; rockchip,dsi_hs_clk = <1000>; rockchip,mipi_dsi_num = <1>; };
screen_init:表示屏是否需要初始化,如果需要则置为1。
dsi_lane:mipi 数据传输需要几条数据 lane,这个一般根据原理图和 mipi 屏的规格书来配置。这个指的是每个 mipi 的数据 lane 数。例如是双 mipi,每个 mipi 为 4 lane,那么此处仍然设置为4。
dsi_hs_clk:屏 ddr clk,表示一条数据 lane 的传输速率,单位为 Mbits/s。
有个大概的计算公式:100 + H_Total * V_total * fps * 3 * 8 / lanes
100 为实际的结果要比理论值大 100M 左右。
H_total,V_total 包括active,bp,fp 和 sync_len 的和。
fps 为帧率,刚调试一款屏时,fps 为 50 多帧就好,然后慢慢抬高。
3 为一个像素点为 rgb 3 个字节,8 为 8 bits。
lanes 为(dsi_lane * mipi_dsi_num)。
上面计算得到的值只是大概值并非精确的值,但是对于一般的屏都适用,对于部分屏需要微调该值。
mipi_dsi_num:单 mipi 还是双 mipi,也是根据原理图和屏幕规格书来配置的。如果是双 mipi 则置为 2,。
2、屏电源控制配置
// 屏电源控制配置 disp_mipi_power_ctr: mipi_power_ctr { compatible = "rockchip,mipi_power_ctr"; mipi_lcd_en:mipi_lcd_en { compatible = "rockchip,lcd_en"; rockchip,gpios = <&gpio7 GPIO_A3 GPIO_ACTIVE_HIGH>; rockchip,delay = <20>; }; mipi_lcd_cs:mipi_lcd_cs { compatible = "rockchip,lcd_cs"; rockchip,gpios = <&gpio7 GPIO_A4 GPIO_ACTIVE_HIGH>; rockchip,delay = <20>; }; mipi_lcd_rst:mipi_lcd_rst{ compatible = "rockchip,lcd_rst"; rockchip,gpios = <&gpio3 GPIO_D6 GPIO_ACTIVE_HIGH>; rockchip,delay = <20>; }; };
电源配置的 gpio 需要根据原理图来配置,也可能存在不需要三路电源控制的情况。
例如:rockchip,gpios = <&gpio7 GPIO_A3 GPIO_ACTIVE_HIGH>; LCD_EN 的引脚为 GPIO7_A4 引脚,高电平有效。
delay 部分是操作完后的延迟时间,这个关系到 mipi 的上电时序。在需要的时候要对延时时间进行调整。
kernel 中对应的操作函数在 kernel/driver/video/rockchip/screen/lcd_mipi.c 文件的 rk_mipi_screen_pwr_enable() 和 rk_mipi_screen_pwr_disable()。
u-boot 中对应的操作函数在 u-boot/driver/video/screen/lcd_mipi.c 文件的 rk_mipi_screen_pwr_enable() 和 rk_mipi_screen_pwr_disable()。
// dtsi文件中的lcdc配置如下 &lcdc0 { status = "okay"; rockchip,mirror =; rockchip,cabc_mode = <0>; power_ctr: power_ctr { rockchip,debug = <0>; lcd_en:lcd_en { rockchip,power_type = ; gpios = <&gpio7 GPIO_A3 GPIO_ACTIVE_HIGH>; rockchip,delay = <10>; }; lcd_cs:lcd_cs { rockchip,power_type = ; gpios = <&gpio7 GPIO_A4 GPIO_ACTIVE_HIGH>; rockchip,delay = <10>; }; lcd_rst:lcd_rst { rockchip,power_type = ; gpios = <&gpio3 GPIO_D6 GPIO_ACTIVE_HIGH>; rockchip,delay = <5>; }; }; };
kernel 中对应的操作函数在 kernel/driver/video/rockchip/rk_fb.c 文件的 rk_disp_pwr_enable() 和 rk_disp_pwr_disable()。
u-boot 中对应的操作函数在 u-boot/driver/video/rockchip_fb.c 文件的 rk_fb_pwr_enable() 和 rk_fb_pwr_disable()。
3、屏初始化序列
有的屏需要初始化,有的不需要,如果规格书上注明需要初始化,则需要屏厂提供初始化序列。
屏初始化命令在 kernel/driver/video/rockchip/screen/lcd_mipi.c 文件的 rk_mipi_screen_cmd_init() 中完成。
// 屏初始化序列结构如下 disp_mipi_init_cmds: screen-on-cmds { rockchip,cmd_debug = <0>; compatible = "rockchip,screen-on-cmds"; rockchip,on-cmds1 { compatible = "rockchip,on-cmds"; rockchip,cmd_type =; rockchip,dsi_id = <0>; rockchip,cmd = <0x15 0x25 0x55>; rockchip,cmd_delay = <2>; }; rockchip,on-cmds2 { compatible = "rockchip,on-cmds"; rockchip,cmd_type = ; rockchip,dsi_id = <0>; rockchip,cmd = <0x15 0x15 0x20>; rockchip,cmd_delay = <2>; }; ... ... ... ... };
cmd_debug:是否打开 cmd 调好,1 表示打开调试,0 表示关闭调试。
rockchip,on-cmds1结构:这是第一条初始化命令结构,一般都需要多条初始化命令,就需要多个命令结构,实际上编号可以不按顺序,只要不重复就行。
cmd_type:命令是在low power(LPDT)还是high speed(HSDT)下发送。
dsi_id:命令通过哪个 mipi 发送。0 表示在 mipi0 发送,1 表示在 mipi1 发送,2 表示双 mipi 同时发送。
因为很少出现单独使用 mipi1 的情况,所以对于单 mipi,这个值默认是 0,对于双 mipi,这个值是 2。
cmd:初始化命令,格式:命令类型(如 0x05/0x15/0x39)+指令+参数。
0x05:只有指令,没有参数
0x15:只有一个参数
0x39:有多个参数,如果参数太长,程序可能会跑飞,需要增大源码中的指令数组长度。
cmd_delay:命令发完后的延时,延时时间根据屏厂给的初始化序列来配置。
另外有一些特殊的标准命令(0x22,0x32),某些特殊屏有可能需要,这就需要修改控制器来发送,得联系RK官方修改。
如果屏幕不需要初始化,也就是mipi host 配置中 rockchip,screen_init = <0>; 的情况,不需要初始化并不是表示没有发送命令。
在不需要初始化的情况下,等 mipi host,phy 供电初始化完和屏的供电结束以后会按照 mipi 协议发送 exit_sleep_mode 和 set_display_on 命令。
dcs_exit_sleep_mode 表示退出 sleep 模式,dcs_set_display_on 表示通知显示屏开始显示图像数据,必须额外添加,而且延时特别重要。
4、屏幕参数
屏参包括屏的格式、dclk、时序等。
disp_timings: display-timings { native-mode = <&timing0>; compatible = "rockchip,display-timings"; timing0: timing0 { screen-type =; lvds-format = ; out-face = ; clock-frequency = <74000000>; hactive = <1366>; vactive = <768>; hsync-len = <56>; hback-porch = <64>; hfront-porch = <56>; vsync-len = <3>; vback-porch = <28>; vfront-porch = <1>; hsync-active = <0>; vsync-active = <0>; de-active = <0>; pixelclk-active = <1>; swap-rb = <0>; swap-rg = <0>; swap-gb = <0>; }; };
screen-type:屏幕类型,mipi 屏有两种:单 mipi(SCREEN_MIPI)、双 mipi(SCREEN_DUAL_MIPI)。
lvds-format:lvds 数据格式。对于 mipi 屏是无效参数,不用配置。
out-face:屏幕接线格式。
上述三个参数的取值在 kernel/include/dt-bindings/rkfb/rk_fb.h中定义。
clock-frequency:dclk 频率,单位为 Hz,一般屏的规格书中有,也可以通过公式计算:H*V(包括同步信号)*fps
Hactive:水平有效像素
Vactive:垂直有效像素
hback-porch/hfront-porch/hsync-len:水平同步信号
vback-porch/vfront-porch/vsync-len:水平同步信号
hsync-active、vsync-active、de-active、pixelclk-active:分别为 hync、vsync、DEN、dclk 的极性控制。置 1 将对极性进行翻转。
swap-rb、swap-rg、swap-gb:置 1 将对对应的颜色进行翻转。
5、板级文件配置
dtsi 文件配置好后,需要在板级文件中包含这个 dtsi 文件。
#include "xxx_mipi.dtsi"
在 dtsi 中,mipi host 默认是关闭的,需要在 dtsi 或者 dts 文件中开启。
&dsihost0 { status = "okay"; }; &dsihost1 { status = "okay"; };
单 mipi 只需开启对应的一个即可,双 mipi 两个都需要开启。