RK3568开发板刷机与MIPI/HDMI显示调试实战指南

RK3568这块芯片这几年在工控和开发板圈子里出镜率是真的高。我前后帮几个朋友调过RK3568的板子从到手第一步的盲刷固件到把MIPI屏点亮再改成HDMI输出外接大屏每一步都踩过不少坑。这篇文章就把我整理过的RK3568开发板刷机流程、MIPI屏调试思路、以及从MIPI切换到HDMI输出的设备树改动方案完整记录下来内容包括固件烧写工具的用法、分区烧写与整包烧写的区别、MIPI DSI屏点不亮时的排查顺序、HDMI信号接口的检查方法还有一些摄像头和系统扩展的经验适合正在折腾RK3568这块板子的朋友直接参考。1. 刷机前必须搞清楚的几件事1.1 RK3568与RK3566到底差在哪很多人第一次接触瑞芯微平台会在RK3568和RK3566之间纠结。这两颗芯片都是四核Cortex-A55NPU算力也接近但它们在接口资源上的差别其实挺大直接影响到你选开发板时能不能满足需求。RK3568相比RK3566最明显的差异是支持PCIe 3.0带双千兆网口而且内置的VPU视频编解码能力更强支持到4K 60fps的H.264/H.265编解码。RK3566则更偏向平板类产品省掉了PCIe网口通常只有一个千兆。对于做工业控制、边缘计算、网关类产品的朋友RK3568的可扩展性明显更好如果是做带屏的消费类设备、简单的人机交互界面RK3566也够用成本能压得更低。这个区别跟刷机有什么关系关系很大。网上很多固件和刷机资料是混着发的如果你拿RK3566的固件刷到RK3568的板子上启动后大概率会在内核阶段卡死因为设备树里外设配置对不上。我建议刷机前先通过芯片表面的丝印确认型号不要只看开发板外壳标签有的公版外壳贴纸印错了也不奇怪。1.2 刷机前的工具清单与版本选择给RK3568刷机最常用的工具是瑞芯微官方的RKDevTool配合Windows驱动DriverAssitant。我平时常用的组合是DriverAssitant v5.0加RKDevTool v2.96这两个版本在Win10和Win11下实测都稳定。驱动安装这一步很多人跳过了觉得插上USB就能识别结果设备管理器里看到一个带感叹号的未知设备怎么烧都失败。正确的做法是先运行DriverAssitant点击驱动安装然后把开发板以Loader模式连接到电脑。进入Loader模式的操作是先按住板上的RECOVERY键不放再插入USB线有一些板子是按住MASKROM键等电脑识别到后松开。驱动安装成功后设备管理器里会多出一个Rockusb Device设备这时候打开RKDevTool就能看到设备已经连接读取到芯片信息以及Loader版本。还需要注意一点数据线一定要用能传数据的线最好是USB 3.0的Type-C线。有些Type-C线只能充电插入后设备管理器反复报USB设备无法识别排查一圈才发现是线的问题。我踩过一次后来抽屉里专门放了一根标“D”的传数据线只用来刷机。1.3 先想清楚你的显示输出到底怎么走刷机只是第一步显示输出才是很多人真正要解决的需求。RK3568的显示链路跟不少芯片不一样它内部有VOP2Video Output Processor负责把图形合成后的画面输出到各个显示接口包括HDMI、MIPI DSI、eDP、LVDS等但同一时刻VOP2的各路port不能随便乱映射。有朋友问我接一块MIPI屏为什么板上明明有HDMI接口插上显示器却没信号因为没有在内核设备树里配置route_hdmi这条显示链路。RK3568默认固件可能把VOP2的port0分配给了MIPI DSI而HDMI需要用到另一条route。这就是为什么建议刷机前先想清楚显示输出走哪路如果只用MIPI屏固件里就要确保MIPI DSI节点被使能如果要用HDMI外接大屏就要确认HDMI的route节点状态如果两个都要同时显示那得用双显示输出配置两个接口分配到不同的vop port。这个问题如果不提前规划后面每次修改设备树、重新编译内核、再刷boot分区反复折腾浪费时间。我自己现在养成的习惯是刷机前先到板子对应的SDK文档里查一下这块板子默认的显示方案再决定刷哪个固件能省掉大半麻烦。2. 固件烧写完整流程从Loader分区到整包烧录2.1 进入Loader模式驱动安装与按键配合我先说一个最常见的失败场景板子插上USBRKDevTool一直显示“没有发现设备”。这里首先确认的是驱动其次再确认模式有没有进对。RK3568支持的烧录模式主要有Loader模式和MaskRom模式。Loader模式是通过按RECOVERY键进入的引导烧录模式使用频率最高普通出厂固件的烧写都走这个模式。MaskRom模式是Loader损坏或者设备变砖之后使用的底层模式此时设备管理器会识别到单独的Rockusb设备烧写时一般要配合短接板上的MaskRom焊盘操作。具体操作顺序可以按这个来断开开发板所有电源。按住板上的RECOVERY键有的板子叫Download键。保持按住插入USB线到电脑。等待2-3秒电脑提示安装驱动或者设备管理器出现Rockusb Device。松开按键打开RKDevTool确认设备状态。如果按了RECOVERY键还是没有设备试试短接MaskRom引脚。不同板子的短接点位置不一样参考板卡的硬件说明文档。有的板子虽然没有物理RECOVERY按键但可以通过GPIO映射到某个引脚需要用杜邦线短接因此建议买板子后先把原理图下载保存好不然遇到变砖会非常被动。2.2 RKDevTool分区烧写与整包烧写怎么选RKDevTool界面上其实提供了两种烧写方式一种是按分区烧写另一种是烧写统一固件。统一固件通常是一个update.img文件里面把parameter分区表、uboot、boot、rootfs等打包到了一起操作最简单点“升级固件”然后选文件就能烧。但整包烧写有一个问题它会把整个flash清掉所有分区都恢复到出厂状态。分区烧写则灵活得多适合日常开发。修改了内核设备树、只重新编译了boot.img就可以只烧boot分区不用重刷整个系统。这种方式尤其适合调试屏幕或摄像头因为改驱动、编译、烧写整个流程可以控制在几分钟内。分区烧写前要确保你的固件和你的分区表是对应的。RK3568的分区表在parameter.txt里定义常见的分区有uboot启动引导boot内核和设备树rootfs根文件系统recovery恢复模式misc标记启动模式如果不小心烧错了不同类型的分区比如把一个完整的update.img直接拖到boot分区烧板子基本就变砖了得重新进MaskRom模式恢复。我见过有人整包和分区烧写概念混淆把烧录工具里“导入”和“执行”按钮当成同一个功能结果分区数据被覆盖后来只能短接恢复浪费了不少时间。2.3 烧写后的第一次启动验证方法烧写完成并不代表系统一定能正常启动。我每次烧完都不急着接屏幕先接上串口调试线看启动日志。RK3568的调试串口通常位于板卡上标注UART2的位置波特率一般是15000001.5Mbps这不是常见的115200直接用115200读会出现乱码。启动日志里主要关注几个关键节点uboot版本信息、内核加载阶段的打印、rootfs挂载是否成功。如果启动卡在Starting kernel最可能的原因就是设备树和内核版本不匹配或者固件的DDR初始化参数与板子硬件不兼容此时换固件版本排查。如果串口没有输出先检查串口电平是否匹配RK3568的调试串口是3.3V TTL电平直接用USB转TTL模块连接时要确认模块也是3.3V电平接到5V的模块上可能烧坏串口引脚。不少转串口模块上有个跳帽选择3.3V或5V很多人忘记调我就在这块浪费过半个下午。系统启动后可以用以下命令快速检查显示相关状态# 查看DRM设备状态 cat /sys/kernel/debug/dri/0/state # 查看已加载的显示模块 ls /sys/class/drm/ # 查看framebuffer信息 cat /proc/fb如果/sys/class/drm/下能看到card0-HDMI-A-1或者card0-DSI-1这样的节点说明内核已经识别到了显示接口下一步就该确认信号是否真正输出。3. MIPI屏显示适配设备树、时序与常见翻车点3.1 MIPI屏不亮先分硬件还是配置问题MIPI屏不亮是RK3568开发板调显示时候最让人头疼的问题因为“不亮”这个现象太笼统了。是屏幕完全黑屏还是背光亮但无画面还是画面闪烁这三种现象对应的排查方向完全不同。我的经验是先按这个顺序过一遍背光不亮检查背光电源看背光驱动有没有使能GPIO状态对不对。背光亮但无画面基本可以判定MIPI数据通道或屏幕初始化时序有问题优先怀疑设备树参数和上电时序。画面闪烁或花屏重点查MIPI时钟频率、lane数量、分辨率时序参数。把问题归类之后再用万用表量供电用示波器抓信号效率会高很多。乱猜是解决不了问题的更不要一上来就怀疑芯片坏了MIPI屏点不亮的问题绝大多数出在配置上。3.2 设备树里MIPI DSI屏的关键参数确认方法RK3568内核通过设备树描述MIPI DSI屏的型号、时序和功耗相关配置。我以一块常见的5.5寸1080P MIPI DSI屏为例它在设备树里大致包含以下节点dsi0 { status okay; rockchip,lane-rate 891; panel0 { compatible simple-panel-dsi; reg 0; backlight backlight; reset-gpios gpio3 RK_PB4 GPIO_ACTIVE_LOW; pinctrl-names default; pinctrl-0 lcd_panel_reset; enable-gpios gpio4 RK_PA5 GPIO_ACTIVE_HIGH; dsi-lanes 4; display-timings { native-mode timing0; timing0: timing0 { clock-frequency 148500000; hactive 1080; vactive 1920; hback-porch 40; hfront-porch 80; vback-porch 10; vfront-porch 20; hsync-len 4; vsync-len 4; de-active 0; pixelclk-active 0; }; }; ports { #address-cells 1; #size-cells 0; port0 { reg 0; panel_in_dsi: endpoint { remote-endpoint dsi0_out_panel; }; }; }; }; };拿到一块新屏最麻烦的是timing参数。通常可以在屏厂给的规格书里找到时序表对照hactive、vactive、back-porch、front-porch、hsync-len这些值填进去。如果规格书给的是HTotal和VTotal也可以通过计算得出porch值hback-porch HTotal - hactive - hfront-porch - hsync-len。还有一个隐藏参数叫lane-rate表示每条MIPI lane的数据传输速率单位是MHz。计算公式可以按像素时钟来估算lane_rate pixel_clock * bits_per_pixel / dsi_lanes比如1080P RGB888屏每个像素24bit4条lane像素时钟148.5MHz计算如下lane_rate 148.5 * 24 / 4 891MHz有些屏参数里的lane-rate写得不准确内核反而会按照错误值配置PHY导致屏幕黑屏或者只有上半屏显示。这种问题用示波器抓时钟信号就能发现偏差。3.3 背光、复位、上电时序这三大坑MIPI屏最常见的三个坑分别是背光不亮、复位引脚配置错误、以及上电时序不对。背光这块RK3568一般用PWM调节亮度设备树里会有backlight节点它依赖PWM控制器。检查背光的时候先确认PWM节点是否使能、默认亮度是否为非0值。有的固件默认亮度是0结果屏幕亮不起来变量一追才发现是backlight-brightness-level初始化为0了把默认亮度改成128后正常。复位引脚的问题在于极性。屏厂的复位引脚通常低有效也就是复位引脚拉低、然后拉高完成一次复位操作。但不同屏的复位时序要求不同有的要求复位后等待10ms再初始化有的要求120ms。我在调试一块ST7701S驱动IC的屏时复位后初始化太快导致屏幕花屏后来在上电流程里加了延时问题才解决。上电时序方面MIPI DSI屏通常会要求电源、复位、初始化三者的时序关系先供电再释放复位延时后发送初始化命令。如果板上用的一颗LDO同时给屏幕和摄像头供电供电稳定时间可能不同屏幕就会出现概率性点不亮。这类问题比较隐蔽只能用示波器同时抓电源和复位波形确认时序是否符合规格书要求。3.4 用示波器看MIPI时钟信号波形MIPI DSI的信号是差分信号包括一组时钟lane和若干组数据lane。可以抓时钟lane的波形来判断MIPI输出是否正常。用示波器抓MIPI时钟波形时探头的接地线要尽量短最好用靠近探头的接地弹簧直接用长接地夹会导致高频信号失真看起来就像信号质量差。MIPI时钟lane的频率在正常输出时会稳定在一个固定值。根据前面算出来的lane_rate在DDR模式下时钟lane的实际频率是lane_rate的一半例如lane_rate是891MHz那么示波器上看到的差分时钟频率应该在445.5MHz附近。如果测出来频率差太多要么设备树里的lane-rate填错要么屏幕的初始化时序不对导致PHY没正常工作。实测中如果屏幕正常点亮D0数据lane上能看到差分波形而在黑屏状态且没有画面输出时数据lane的电压基本平行只有时钟lane在跑。这样就能快速区分MIPI控制器有没有正常工作。4. 从MIPI切换到HDMI输出显示链路调整4.1 HDMI接口信号定义与常见误区MIPI屏调试正常后很多人想把画面转到HDMI接大屏显示器。切换之前我先把HDMI接口的信号定义列一下因为排查无信号问题时要用到引脚功能说明排查要点TMDS Data0-2RGB数据通道差分信号需要示波器确认有波形输出TMDS Clock像素时钟频率随分辨率变化4K60约594MHzDDCI2C读取显示器EDIDSDA/SCL连通性电平3.3VHPD热插拔检测显示器未接入时此引脚为低电平CEC消费电子控制部分屏幕没有此功能默认悬空5V给HDMI源端供电多数开发板有输出注意别短路HDMI无信号最常见的原因不是驱动没配好而是HPD检测不到。RK3568的HDMI控制器依靠HDMI接口的HPD信号判断显示器是否接入如果HPD引脚电平不正确内核不会使能HDMI输出。用万用表量一下HDMI座子的HPD引脚对地电压正常接入显示器时应为高电平没有显示器时为0V。很多时候驱动看起来一切正常其实只是线没插好或者转换头太差信号质量不过关也会导致持续黑屏。4.2 切换HDMI输出的设备树修改示例在RK3568 SDK中显示输出的路由关系通常在内核设备树里配置。以VOP2为例如果默认配置是MIPI DSI输出现在要切换到HDMI设备树里需要使能HDMI相关节点并把route_hdmi指向对应的vop porthdmi { status okay; }; route_hdmi { status okay; connect vp0_out_hdmi; }; dsi0 { status disabled; }; route_dsi0 { status disabled; };需要特别说明MIPI DSI的节点不能同时跟HDMI抢同一个vop端口。RK3568的VOP2有多个video port例如vp0、vp1、vp2可用的连接方式需要参考SDK里对应板型的dts文件。我调试时曾同时使能了dsi0和hdmi结果两个接口都没有输出原因就是把vp0同时分配给了两个输出导致路由冲突。后来按SDK文档把dsi0停掉只启用hdmi画面才正常出来。如果确认设备树没问题但HDMI依然黑屏检查一下启动时是否有类似hwc或weston的显示合成进程占用了MIPI输出。RK3568带GPU方案的系统里显示合成器会主动读取DRM设备状态如果weston加载时选错了后端HDMI同样没画面。4.3 多路HDMI输入输出的场景怎么扩展有时候项目需求不止一路HDMI输出。比如要做视频矩阵或多屏拼接在RK3568基础上外接视频转换芯片是很常见的做法。有网友问过“4路HDMI输入1路HDMI输出的芯片怎么选”这里提一下这种场景通常需要一路支持多输入切换的HDMI切换器芯片或者通过MIPI CSI转HDMI输入的采集方案。RK3568本身只有一路HDMI TX输出要扩展成为4路HDMI输入转1路HDMI输出的信号调度系统可以使用外置的HDMI交换芯片通过I2C或SPI控制输入通道切换HDMI输出再接回RK3568的HDMI输入端口。但要注意RK3568原生没有HDMI RX输入接口如果要采集外部HDMI信号通常通过MIPI CSI接口外接HDMI转MIPI CSI的采集模块实现。这种方案的延迟和兼容性需要提前测试不同转接芯片对HDCP和时序的处理差异很大。对于只是想把RK3568接到会议室大屏这种简单需求完全不需要考虑外置芯片直接用HDMI线连接即可前提是把route_hdmi配好。5. 显示之外的高频扩展需求5.1 RK3568调试MIPI摄像头OV5695与OV8858显示调试完之后很多人会接着做摄像头。RK3568的MIPI接口不只用于显示还能接MIPI CSI摄像头像OV5695、OV8858这些常用sensor我都在RK3568上调过。调试过程中发现摄像头不出的问题往往和显示问题有相似之处第一是电源第二是MCLK第三是复位和上下电时序。RK3568给sensor提供的参考时钟MCLK一般是24MHz可以在设备树里通过pinctrl配置gpio口输出时钟。检查MCLK是否正常用示波器抓sensor的XVCLK引脚能抓到幅值约1.8V、频率24MHz的方波就说明时钟正常。如果没有波形优先确认设备树里摄像头节点是否引用对了clock ID。OV5695和OV8858都是通过I2C配置寄存器它们的I2C地址不同OV5695的地址一般是0x36OV8858是0x36或0x20视具体配置而定。I2C地址错误会导致内核日志反复报sensor not found用i2cdetect命令能快速验证设备是否在线i2cdetect -y 6如果看到对应的地址有设备编号输出说明sensor已经被正确供电和复位问题大概率出在驱动配置如果扫描不到设备就得从硬件连接和供电查起。5.2 RK3568上做EtherCAT主站的体会RK3568在网络实时通信场景中的应用也很多特别在工业控制领域不少人想在RK3568上跑EtherCAT主站。EtherCAT IGH主站依赖网卡的实时性能通常要求使用特定型号的网卡芯片比如Intel的i210/i211或者瑞昱的RTL8168系列。RK3568原生自带的GMAC接口能否直接用于EtherCAT答案是分情况。有些EtherCAT从站设备对主站网卡要求不高直接用原生千兆网口配合IGH也能跑起来但实时性和抖动性能会差一些控制周期一般只能做到1ms左右再高就稳不住。如果项目对同步性要求严苛建议用PCIe接口外接Intel网卡然后给内核打上RT补丁这样能把控制周期做到500us甚至250us以下。适配IGH时需要注意网卡驱动和实时补丁的匹配问题。IGH官方文档建议在EtherCAT主站机上使用专门打补丁的内核而不是直接用主线的PREEMPT_RT补丁。我在RK3568上实验时先给内核打上RT补丁再编译IGH然后用ethercat命令扫描从站实测成功率还是比较高的。具体步骤是编译内核时打开igb驱动配置CONFIG_IGBy然后编译安装IGH启动主站前用ethtool确认网卡工作在直通模式。5.3 在RK3568上挂载Ubuntu与桌面系统的注意点很多人拿到RK3568开发板第一步就是刷成Ubuntu系统。热词里也有“开发板挂载Ubuntu”的说法其实是指将Ubuntu的rootfs刷入或挂载到板子上。RK3568官方SDK通常会提供Ubuntu rootfs镜像可以直接整包烧写也可以用SD卡或NVMe硬盘制作独立系统启动。如果在NVMe SSD上跑Ubuntu需要注意固件里是否支持从PCIe NVMe启动。RK3568的uboot默认可能只从SD卡和eMMC加载内核需要在uboot环境变量里加上对NVMe设备的支持。设置方法是在uboot命令行下执行setenv boot_targets nvme0 mmc0 usb0 saveenv设置之后就能把Ubuntu系统装在NVMe盘里开机自动从NVMe引导实测下来读写速度比eMMC明显好很多尤其是编译内核这类大量IO的操作体感差距很明显。桌面系统还有一个常见问题是HDMI没有声音。RK3568的HDMI音频是通过I2S接口将音频数据发送到HDMI控制器再和视频一起输出。如果系统里跑的是带桌面的Ubuntu插上HDMI线后没有声音检查alsa配置文件里默认声卡是否指向了HDMI声卡以及weston或X11是否有音频后端。6. 常见问题排查速查与个人避坑总结6.1 刷机失败问题速查表我把实际操作中遇到的典型问题整理成了表格方便直接对照排查现象可能原因解决方向电脑不识别设备驱动未安装/数据线问题重装DriverAssitant换数据线RKDevTool提示设备连接超时没有进入Loader/MaskRom模式重按RECOVERY键或短接MaskRom点烧写过程中报写失败分区表与固件不匹配检查parameter.txt按官方默认分区烧写启动卡在Starting kernel设备树与内核版本不匹配换固件或重新编译适配的boot.img背光亮但无画面MIPI时序/初始化代码问题用示波器抓MIPI时钟核对timing参数HDMI黑屏HPD检测异常或route未配置量HPD引脚电压检查route_hdmi节点HDMI无声音声卡路由错误用alsamixer选择HDMI声卡设备这个表只列了高概率点实际排查时还是建议按照从硬件到软件的顺序来先把电源、信号、连接确认一遍再动软件配置会少走很多弯路。6.2 显示输出异常快速排查路线如果是显示输出完全不工作我建议按下面这个顺序过一遍最多半小时就能定位到问题。第一步看串口日志。内核启动时drm相关模块会打印VOP、HDMI、DSI的初始化状态。如果出现类似vop2 is disabled的信息先回设备树检查对应节点的status是否为okay。第二步检查内核是否识别到显示设备。执行ls /sys/class/drm/如果该有的节点没有说明驱动初始化阶段就失败了。节点存在但没有信号才进入第三步。第三步检查用户态合成进程。带GUI的系统里weston或X11会对DRM设备加锁如果它们没有正确启动HDMI即使配置正确也看不到画面。尝试杀掉显示进程直接用framebuffer输出看看是否正常。第四步硬件信号检查。用示波器量HDMI的TMDS Clock对地波形正常输出时能看到明显差分波形。如果示波器显示无信号再反向检查HDMI接口供电、HPD、DDC一连串信号。6.3 我个人总结的几条避坑经验调试RK3568这一年多有几条经验是反复验证过的写在这里给后来人参考。第一保存一份可用的干净固件。无论怎么改配置电脑里始终留一份官方出厂固件。系统玩坏了随时刷回去能节省大量调试时间。我习惯把不同版本固件按照日期和功能命名比如rk3568_hdmi_20250101.img避免过了一个月自己都分不清哪个能用。第二设备树改动要遵循最小化原则。一次只改一个变量测试通过后再改下一个不要在没有任何验证的情况下同时调整屏参、lane数、电源和复位引脚出了问题根本定位不到。第三串口调试线是必须的。用串口看日志远比通过屏幕显示反向判断问题要来得快。RK3568的调试串口波特率是1500000提前在SecureCRT或MobaXterm里配置好。没有串口日志的嵌入式调试基本等于盲人摸象。第四MIPI屏的初始化代码即屏厂给的init sequence尽量用SDK标准格式组织不要随意修改延时和命令顺序。很多屏出现暗屏、花屏、闪烁都是init sequence里某个延时过短导致的加大到屏厂建议值之后症状就消失了。这个内容后续如果要深入可以再写写RK3568在双屏异显、摄像头多路接入、以及EtherCAT实时性调优这几个方向的实战细节。我自己在实际操作中的体会是RK3568虽然资料多但真正能拿过来直接用的经验还是需要从一次次踩坑里攒希望这篇记录能帮你少走几步弯路。