rk3588s: linux drm mipi dsi lcd 点屏之设备树配置

rk3588s: linux drm mipi dsi lcd 点屏之设备树配置

设备树文档：
https://elixir.bootlin.com/linux/v6.8-rc5/source/Documentation/devicetree/bindings/display/dsi-controller.yaml
https://elixir.bootlin.com/linux/v6.8-rc5/source/Documentation/devicetree/bindings/display/panel/display-timings.yaml
https://elixir.bootlin.com/linux/v6.8-rc5/source/Documentation/devicetree/bindings/display/panel/panel-timing.yaml

https://blog.youkuaiyun.com/lonely_fireworks/article/details/129362860
Android画面显示流程分析(1)–LCD时序

https://cloud.tencent.com/developer/article/1867373
Linux MIPI DSI LCD设备驱动开发调试细节学习笔记(一)

https://blog.youkuaiyun.com/qq_37858386/article/details/123705548
2022-03-24 RK3566 MIPI屏 调试记录，panel-init-sequence 命令格式介绍

Rockchip_Developer_Guide_DRM_Display_Driver_CN.pdf
Rockchip_Developer_Guide_MIPI_DSI2_CN.pdf
在rockchip rk3588s android 12的源代码的RKDocs目录下有相关pdf。

驱动点屏：
1）屏幕pin引脚定义
2）panel-init-sequence初始化code
如果开启了DSC，（Display Stream Compression)需要配置的slice-width和slic-height大小
和在屏幕初始化code里面配置 pps table，(否则, kernel启动不起来，报Oops: 96000005 PREEMPT SMP)
MIPI_DSI_PICTURE_PARAMETER_SET = 0xa,
pps：PICTURE_PARAMETER_SET
3）屏幕上电时序
4）display timing

概要：clock-frequency和rockchip,lane-rate计算方法：
clock-frequency = (hback-porch + hactive + hfront-porch + hsync-len) * (vback-porch + vactive + vfront-porch + vsync-len) * freq

rockchip,lane-rate = (hback-porch + hactive + hfront-porch + hsync-len) * (vback-porch + vactive + vfront-porch + vsync-len) * freq * 3 * 8 * 10 / dsi,lanes / 9 / (DSC_EN ? 3 : 1) / 1000 Kbps

clock-frequency = (hback-porch + hactive + hfront-porch + hsync-len) * (vback-porch + vactive + vfront-porch + vsync-len) * freq
rockchip,lane-rate = (hback-porch + hactive + hfront-porch + hsync-len) * (vback-porch + vactive + vfront-porch + vsync-len) * freq * 3 * 8 * 10 / dsi,lanes / 9 / (DSC_EN ? 3 : 1)  / 1000  Kbps

显示接口有：HDMI，eDP/DP，MIPI DSI，RGB、BT1120/656，LVDS等等
在android 设备上用的比较多的是MIPI DSI。

不同的显示接口点屏，需要参考相应设备树文档进行配置。
下面以mipi dsi接口连接lcd点屏进行举例。

panel-timing.yaml内容：

hback-porch (HBP)：行信号左边沿无效信号时间范围
hfront-porch (HFP)： 行信号右边沿无效信号时间范围
hsync-len (HPW)： 行信号电子枪回扫时间 即 水平同步时间 Hsyc
vback-porch(VBP) ：帧信号上边沿无效信号时间范围
vfront-porch(VFP)：帧信号下边沿无效信号时间范围
vsync-len(VPW)：帧信号电子枪回扫时间 即垂直同步时间 Vsync
hactive(HVD)：有效像素信号纵向分辨率
vactive(VVD)：有效像素信号横向分辨率

如下LCD时序图参考文档：https://blog.youkuaiyun.com/lonely_fireworks/article/details/129362860 LCD时序

1，计算clock-frequency方法：
htotal: （一行数据）hsync水平同步信号需要的总的像素时钟周期个数
vtotal: （一列数据）vsync垂直同步s信号需要的总的像素时钟周期个数
hsync-len: hsync水平同步信号的低电平（非有效电平）持续的时间，即需要的像素时钟周期个数

clock-frequency: panel clock in Hz

htotal = (hback-porch + hactive + hfront-porch + hsync-len)
vtotal = (vback-porch + vactive + vfront-porch + vsync-len)

clock-frequency = htotal * vtotal * 刷新率
clock-frequency = (hback-porch + hactive + hfront-porch + hsync-len) * (vback-porch + vactive + vfront-porch + vsync-len) * freq

2，D-PHY下计算rockchip,lane-rate方法：
rockchip,lane-rate = htotal * vtotal * 刷新率 * 3(RGB) * 8(bit位) / dsi,lanes（lane数）/ 0.9
或者：
rockchip,lane-rate = htotal * vtotal * 刷新率 * 3(RGB) * 8(bit位) * 10 / dsi,lanes（lane数）/ 9

3(RGB)：是每一个 pixel 有 RGB 3 个分量；
0.9：是考虑 mipi 时序的传输效率；

如果开启了DSC（Display Stream Compression)，使能DSC后，链路带宽可以降到原始带宽数据的三分之一或二分之一。
DSC使能后rockchip,lane-rate需要除以3或2，一般用3，计算方法：
rockchip,lane-rate = htotal * vtotal * 刷新率 * 3(RGB) * 8(bit位) * 10 / dsi,lanes（lane数）/ 9 / 3

总结：
rockchip,lane-rate 单位可以是Kbps/Mbps

rockchip,lane-rate = htotal * vtotal * freq * 3 * 8 * 10 / dsi,lanes（lane数）/ 9 / (DSC_EN ? 3 : 1) bps
最终在除以1000或1024把 bps转为Kbps：
rockchip,lane-rate = htotal * vtotal * freq * 3 * 8 * 10 / dsi,lanes / 9 / (DSC_EN ? 3 : 1) / 1000 Kbps
或
rockchip,lane-rate = (hback-porch + hactive + hfront-porch + hsync-len) * (vback-porch + vactive + vfront-porch + vsync-len) * freq * 3 * 8 * 10 / dsi,lanes / 9 / (DSC_EN ? 3 : 1) / 1000 Kbps

例子：
clock-frequency = <57153600>; // 计算：默认andoid手机屏幕fps = 60, (5 + 5 + 720 + 5) * (2 + 1 + 1280 + 13) * 60 = (735 * 1296) * 60 = 57153600

例子：
clock-frequency = <57153600>;  // 计算：默认andoid手机屏幕fps = 60,  (5 + 5 + 720 + 5) * (2 + 1 + 1280 + 13) * 60 = (735 * 1296) * 60 = 57153600
examples:
  - |
    dsi {
   
   
        #address-cells = <1>;
        #size-cells = <0>;

        panel@0 {
   
   
            compatible = "samsung,s6e8aa0";
            reg =