RK3288 mipi屏参数配置文件

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    = <>;
    rockchip,dsi_lane    = <>;
    rockchip,dsi_hs_clk    = <>;
    rockchip,mipi_dsi_num    = <>;
};

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 = <>;
    };

    mipi_lcd_cs:mipi_lcd_cs {
        compatible = "rockchip,lcd_cs";
        rockchip,gpios = <&gpio7 GPIO_A4 GPIO_ACTIVE_HIGH>;
        rockchip,delay = <>;
    };

    mipi_lcd_rst:mipi_lcd_rst{
        compatible = "rockchip,lcd_rst";
        rockchip,gpios = <&gpio3 GPIO_D6 GPIO_ACTIVE_HIGH>;
        rockchip,delay = <>;
    };
};

电源配置的 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 = <NO_MIRROR>;
    rockchip,cabc_mode = <>;
    power_ctr: power_ctr {
        rockchip,debug = <>;

        lcd_en:lcd_en {
            rockchip,power_type = <GPIO>;
            gpios = <&gpio7 GPIO_A3 GPIO_ACTIVE_HIGH>;
            rockchip,delay = <>;
        };

        lcd_cs:lcd_cs {
            rockchip,power_type = <GPIO>;
            gpios = <&gpio7 GPIO_A4 GPIO_ACTIVE_HIGH>;
            rockchip,delay = <>;
        };

        lcd_rst:lcd_rst {
            rockchip,power_type = <GPIO>;
            gpios = <&gpio3 GPIO_D6 GPIO_ACTIVE_HIGH>;
            rockchip,delay = <>;
        };
    };
};

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 = <>;
    compatible = "rockchip,screen-on-cmds";    

    rockchip,on-cmds1 {
        compatible = "rockchip,on-cmds";
        rockchip,cmd_type = <LPDT>;
        rockchip,dsi_id = <>;
        rockchip,cmd = <0x15 0x25 0x55>;
        rockchip,cmd_delay = <>;
    };

    rockchip,on-cmds2 {
        compatible = "rockchip,on-cmds";
        rockchip,cmd_type = <HSDT>;
        rockchip,dsi_id = <>;
        rockchip,cmd = <0x15 0x15 0x20>;
        rockchip,cmd_delay = <>;
    };
    ... ...      ... ...
};

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：有多个参数，如果参数太长，程序可能会跑飞，需要增大源码中的指令数组长度。

　　解决指令过长问题：https://www.cnblogs.com/lialong1st/p/11218433.html

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 = <SCREEN_MIPI>;
        lvds-format = <LVDS_8BIT_2>;
        out-face    = <OUT_P666>;
        clock-frequency = <>;
        hactive = <>;
        vactive = <>;

        hsync-len = <>;
        hback-porch = <>;
        hfront-porch = <>;

        vsync-len = <>;
        vback-porch = <>;
        vfront-porch = <>;

        hsync-active = <>;
        vsync-active = <>;
        de-active = <>;
        pixelclk-active = <>;

        swap-rb = <>;
        swap-rg = <>;
        swap-gb = <>;
    };
};

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 两个都需要开启。