在 Luckfox Lyra Plus 上驱动一块 mipi-dsi 屏幕的记录

器件
Luckfox Lyra Plus	RK3506G2	3 x Cortex A7 + 1 x Cortex-M0 & 片内集成 128MB DDR3 & 256MB SPI-NAND
GoldenMorning T397B5-C24-02	ST7701SN	480x800 2-lane mipi-dsi
WSL	Ubuntu 24.04.4 LTS

先部署一下官方提供的 SDK。官方提供的是一个网盘链接，你需要下载下来，解压到你的开发环境中。这是一个例子：

mkdir -p ~/luckfox/lyra
cd ~/luckfox
cp ~/Downloads/Luckfox_Lyra_SDK_250815.tar.gz .
tar xvf Luckfox_Lyra_SDK_250815.tar.gz -C lyra

接下来你需要根据这篇文档中的指示安装所需的依赖。官方推荐的开发用系统是 Ubuntu-22.04，所以有些包名在新版本的 ubuntu 中可能已经不存在或者改名了，你装的时候需要根据 apt 的报错信息修改一下，或者问下 ai。

SDK 编译的时候需要用到 python2。新版本的 ubuntu 已经弃用了 2.x 版本python。这里我推荐使用 pyenv 来部署 python2 环境。我用的是 zsh，这是一个使用 pyenv 安装 Python 2.7.18 例子：

curl -fsSL https://pyenv.run | bash

# 把下面这段内容添加进 ~/.zshrc
export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init - bash)"

source ~/.zshrc

pyenv install 2.7.18

安装完这个 python2 的版本之后，来到 SDK 根目录展开源码

cd ~/luckfox/lyra

pyenv local 2.7.18

.repo/repo/repo sync -l

先来谈一点硬件相关的内容，因为开发板 DSI 接口的线序跟屏幕引脚定义不同，而且体积较小的开发板上一般都没有屏幕背光驱动电路，所以我们需要画一个转接板，当然你也可以直接买一个带屏幕背光驱动转接板的屏幕。这是一个带背光驱动的转接板示例：

屏幕的接口为24pin FPC排线，定义如下：

开发板的 DSI 接口引脚定义如下：

回到软件部分，找到 kernel-6.1/arch/arm/boot/dts/rk3506-luckfox-lyra.dtsi 177 行附近的 &dsi 下的 dsi_panel: panel@0 节点，修改如下参数：

通常你可以在屏幕的规格书中找到时序参数，但是初始化序列需要厂商另外提供。

	width-mm = <52>;
	height-mm = <86>;

	panel-init-sequence = [
			39 00 06 FF 77 01 00 00 13
			15 00 02 EF 08
			39 00 06 FF 77 01 00 00 10
			39 00 03 C0 63 00
			39 00 03 C1 09 02
			39 00 03 C2 20 02
			15 00 02 CC 18
			39 00 11 B0 40 0E 51 0F 11 07 00 09 06 1E 04 12 11 64 29 DF
			39 00 11 B1 40 07 4C 0A 0E 04 00 08 09 1D 01 0E 0C 6A 34 DF
			39 00 06 FF 77 01 00 00 11
			15 00 02 B0 30
			15 00 02 B1 48
			15 00 02 B2 80
			15 00 02 B3 80
			15 00 02 B5 4F
			15 00 02 B7 85
			15 00 02 B8 23
			39 00 03 B9 22 13
			15 00 02 BB 03
			15 00 02 BC 10
			15 00 02 C0 89
			15 00 02 C1 78
			15 00 02 C2 78
			39 00 07 EF 08 08 08 4C 3F 54
			15 00 02 D0 88
			39 00 04 E0 00 00 02
			39 00 0C E1 04 00 00 00 05 00 00 00 00 10 10
			39 00 0F E2 00 00 00 00 00 00 00 00 00 00 00 00 00 00
			39 00 05 E3 00 00 33 00
			39 00 03 E4 22 00
			39 00 11 E5 03 34 AF B3 05 34 AF B3 00 00 00 00 00 00 00 00
			39 00 05 E6 00 00 33 00
			39 00 03 E7 22 00
			39 00 11 E8 04 34 AF B3 06 34 AF B3 00 00 00 00 00 00 00 00
			39 00 08 EB 02 00 40 40 00 00 00
			39 00 03 EC 00 00
			39 00 11 ED FA 45 0B FF FF FF FF FF FF FF FF FF FF B0 54 AF
			39 00 07 EF 08 08 08 45 3F 54
			39 00 06 FF 77 01 00 00 13
			39 00 03 E6 16 7C
			39 00 03 E8 00 0E
			39 00 06 FF 77 01 00 00 00
			05 78 01 11
			39 00 06 FF 77 01 00 00 13
			39 00 03 E8 00 0C
			39 00 03 E8 00 00
			39 00 06 FF 77 01 00 00 00
			15 00 02 35 00
			05 14 01 29
		];
		
		disp_timings0: display-timings {
			native-mode = <&dsi_timing0>;

			// 10inch1
			dsi_timing0: timing0 {
				clock-frequency = <31000000>;//60fps

				hactive = <480>;
				vactive = <800>;

				vsync-len = <5>;
				vback-porch = <12>;
				vfront-porch = <7>;

				hsync-len = <8>;
				hback-porch = <60>;
				hfront-porch = <80>;

				vsync-active = <1>;
				hsync-active = <1>;
				de-active = <1>;
				pixelclk-active = <0>;
			};

编译烧录

保存之后，来到 SDK 根目录，执行如下命令重新编译内核

./build.sh lunch

# 我的选择是 1 1 0，即
# RK3506G_Luckfox_Lyra_Plus
# SPI_NAND
# Buildroot

./build.sh kernel

❯ ls -lh output/firmware/boot.img
lrwxrwxrwx 1 developer developer 26 Jun 29 20:20 output/firmware/boot.img -> ../../kernel-6.1/zboot.img

你可以用如下几种方式进行烧录，看哪种比较方便适合你。

方法一：linux 设备端烧录

scp output/firmware/boot.img root@192.168.50.134:~/

# 然后在板子一侧执行，重启生效
dd if=/root/boot.img of=/dev/mtdblock1 bs=1M && sync

adb 同理

方法二：linux 主机端烧录

https://wiki.luckfox.com/zh/Luckfox-Lyra/Image-flashing#42-linuxx86_64-平台

方法二：windows 烧录

cp output/firmware/boot.img /mnt/d/

然后参考这篇文章：单独烧录内核和-rootfs，进行烧录。需要用到 RKDevTool，在官方文档的资料下载章节中下载。

一些有用的命令

关闭控制台光标闪烁

echo 0 > /sys/class/graphics/fbcon/cursor_blink

sd 卡启动烧录 boot

dd if=/root/boot.img of=/dev/mmcblk0p2 bs=1M && sync

embeddedboys