ZHAOXIN® KX-7000-Linux OS_x64 Driver Release Note

KX-7000-Linux OS_x64 Release Note

2026-5-12

Support Platforms

Display Support

Notice

Change History

Installing and uninstalling driver

Support Platforms

Support CHIPS:

KX-7000

Support OS: UOSv1070/KOS2403/Deepin23/Openkylin2.0/方德/RainOS/Ubuntu24.04/Kylin V11/方德Wayland /SeewoOS

Kernel Version:

5.4.18 (KOS)

4.19.0 (UOS)

6.6 (Deepin)

6.8 (Ubuntu24.04)

Driver Version:

26.00.49

Package Contents

Driver:

cx4-linux-graphics-driver-dri-glvnd_26.00.49_amd64.deb

Back to top

Display Support

Support Device:

No. | Display Interface
1 | CRT/DP3/HDMI3/eDP3
2 | DP1/HDMI1/eDP1
3 | DP2/HDMI2/eDP2

HDMI/DP 支持的最大分辨率刷新率为 4096x2160@60Hz，CRT 支持的最大分辨率刷新率为 1920x1080@60Hz. 分辨率或者刷新率超出最大范围，需要提供显示器或者 panel 详细信息进一步评估。

Muti-display Capability

output1 | output2 | output3 | output1 max Pixels | Output2 max Pixels | Output3 max Pixels
CRT | \ | \ | 1920x1080@60Hz | \ | \
DP | \ | \ | 4096x2160@60Hz | \ | \
HDMI | \ | \ | 4096x2160@60Hz | \ | \
CRT | HDMI/DP/eDP | HDMI/DP/eDP | 1920x1080@60Hz | 4096x2160@60Hz | 4096x2160@60Hz

Open API Support

1. OGL 4.6

2. OCL 1.2

Video Codec Support

² Decoding Capabilities

Format | Performance
H.265 HEVC | 1920x1080p60@100Mbps (MP) 3840x2160p60@60Mbps (MP)
H.264 AVC | 1920x1080p60@90Mbps (HP) 3840x2160p30@90Mbps (HP) 3840x2160p60@12Mbps (HP)
MPEG2 | 1920x1080p60@100Mbps (MP@HL) 3840x2160p30@100M bps (MP@HL)
MPEG4 | 1920X1080p30@30Mbps(SP/ASP)
M-JPEG | 1920x1080p30@130Mbps(M-JPEG) Baseline 8kx4k/4kx8k, 130Mpps (JPEG)
VC-1/WMV9 | 1920x1080p60@40Mbps(AP@L3.0)
AVS2 | 3840x2160p60@40Mbps

² Encoding Capabilities

Format | Performance
H.265 HEVC | 1920x1080p80fps (MP/I, Pframes/CABAC) 3840x2160p20 (MP; I/P; CABAC) -> 3840x2160p30
H.264 AVC | 1920x1080p60 (HP; I/P; CAVLC/CABAC) 3840x2160p15 (HP; I/P; CAVLC/CABAC)
MJPEG1 | 1920x1080p30@80Mbps (M-JPEG) Baseline (8kx4k/32kx1k), 142Mpps (JPEG)

Back to top

Test Notes

1. 麒麟集成的时候，覆盖掉原来的 cx4 的目录即可。

2. 测试该版本Driver的搭配：

For KX-7000： VBIOS：38.F5.00.13 GOP：V14

3. Hybrid Known Issues

1) PCIe 设置为主卡，系统优先调用的 render 是 UMA

该问题仅在通过 UEFI 启动时出现.

Ø CSM enable 时：

当设置 UMA 为主显卡时，grub 会选择 UMA 作为 active adapter。内核会注册 fb0，独显驱动随后会注册 fb1； 当设置独显为主显卡时，grub 会选择独显作为 active adapter。

Ø CSM disable 时：

无论选择 UMA 还是独显作为主显卡，BIOS 都会点亮两块显卡，但会选择首个遍历到的 GOP 驱动作为 active adapter。在测试中，UMA 始终被选为主显卡。

2) PCIe 设置为主卡，仅点亮独显接的显示器，系统严重卡顿

此时副卡帧率被强制限制为 1fps。该问题发生在 UEFI 模式下 UMA 作为主显卡时，此时两张显卡均处于启用状 态。GRUB 会将首先检测到的显卡设为主卡，导致 BIOS 设置的主卡选项失效。需要启用 CSM 功能来确保 BIOS 设 置准确生效。

Back to top

Change History

26.00.49(5/12/2026)

Bug Fixed:

1. 修复客户麒麟系统控制面板无法调节屏幕亮度

2. 修复客户KOS 外接 HDMI 显示器，EDP 屏幕不显示问题

3. 修复客户使用 GLview7.3 进行 OpenGL 测试，出现渲染异常（色彩不准，图像不完整）问题

Influence Domain:

Display、Video、Compiler、OGL

26.00.48(4/13/2026)

Bug Fixed:

1. 按照 shadow info 的 gfx_pwm bit 决定是否生成 zx_backlight 节点

2. 修复客户HDMI 4K@60h 眼图差分电压偏大问题

Influence Domain:

Display

26.00.47(4/3/2026)

Bug Fixed:

1. 修复客户的2.8K panel KOS,UOS 下按 F2,F3 或者系统亮度进度条，拖动无法调亮度问题

Influence Domain:

Display、video、ocl、compiler、3D

26.00.46 (3/16/2026)

New Feature:

package rename：包名和版本号之间的横线修改为下划线

Bug Fix:

1. 客户笔记本关机掉电异常问题

2. <麒麟> KOS下接HDMI显示器闪屏问题

Influence Domain:

Display、Video

26.00.45（1/16/2026）

New Feature:

1. 加入客户开机优化方案

Bug Fix:

1. <麒麟> initrd启动阶段，集显驱动耗时较长问题

Influence Domain:

Display、3D Compiler

26.00.44（12/29/2025）

New Feature:

1. <麒麟> 增加带二维码 Linux Panic错误信息显示功能

2. 对特定适配的panel add Free Sync 支持

Bug Fix:

1. <麒麟>用户切换卡死在登录界面有花屏现象

2. <麒麟>demo VAAPI获取JPEG解码支持的最大宽高时返回0

3. <麒麟>demo VPP不支持解码后转换解码格式

4. <麒麟>demo调出摄像头，vpp mirror不生效

5. <麒麟>demo VPP转换YUY2无法转换为NV12

6. <麒麟>demo eglCreateImageKHR 执行时间较长

7. <麒麟>demo jpeg解码为YUY2后再转换为NV12 ，播放时花屏崩溃

8. <麒麟>V11 RC3系统任务栏崩溃

9. 客户跑AI应用评测推理时出现SegmentFault错误，优化加速推理过程第一次耗时大问题

Influence Domain:

Video、Display、3D、OCL、kmd、OGL、Compiler

26.00.43（11/25/2025）

Bug Fix:

1. 客户OPS盒子+大屏插拔USB闪屏问题

2. 客户平台进系统后Panel 黑屏问题

3. 【统信】UE4启动崩溃问题

4. 【方德】播放本地1080P视频过程中，睡眠后唤醒出现花屏

Influence Domain:

Display、Video、compiler、3D

26.00.42（11/7/2025）

New Feature/Update:

1. CSOT 2.9K panel适配，默认刷新率为60Hz

2. Feature switch 定义bit供强制走pwm背光调节

Bug Fix:

1. 客户主板gfx_pwm pin控制背光问题

2. 客户端硬解265码流出现绿屏问题

Influence Domain:

Display、Video、KMD、OGL

26.00.41（10/11/2025）

New Feature/Update:

1. 客户AUO panel适配

Bug Fix:

1. <麒麟OS>内存泄露问题

Influence Domain:

Display、Video、KMD、OGL

26.00.40（9/25/2025）

New Feature/Update:

1. 针对客户平台开放eDP panel 的DPCD/I2C Aux 接口

2. 减少 idle/全屏播放1080P视频场景时中断数量

Bug Fix:

1. <KOS> KOS 下调用 vaGetConfigAttributes 接口获取分辨率为 0

2. <KOS> 6.6 内核不生成背光节点

3. <KOS> 进行安全检测时，deb编译包存在安全编译问题

4. 客户大屏闪屏、误码率高

Influence Domain:

Display、Video、Compiler、3D、OGL、OCL

26.00.39（9/2/2025）

Bug Fix:

1. 开启 GPU 硬件加速后访问'e.seewo.com'时 cx4 发生 engine hang

2. <eDP Panel only>开机时间优化方案安全性优化 //需搭配 GOP v10

Influence Domain:

Display、Video、Compiler、OGL、OCL

26.00.38（8/6/2025）

New Feature/Update:

1. 1080p mode 下 stream threshold 调整

Bug Fix:

1. <UOSx64> 接4k 显示器，多用户登录界面切换时花屏问题

Influence Domain:

Display、2D、Compiler、OGL

26.00.37（7/31/2025）

New Feature/Update:

1. 开机时间优化 //需搭配 GOP v09

Bug Fix:

1. 自带浏览器开启 GPU 硬件加速后访问'e.seewo.com'时 cx4 发生 engine hang

2. 客户 S3 tool 1500 loops + idle 2-6 h 后闪屏

3. 企业微信打开邮件和文档模块会显示花屏

Influence Domain:

OGL、display、compiler、kmd

26.00.36（7/23/2025）

Bug Fix:

1. 适配欧灵 panel

2. 修复客户问题，KOS下进入S4过程中，屏幕亮2到3秒再休眠

Influence Domain:

Display、Video、2D、3D、KMD、OGL

26.00.35（6/20/2025）

Bug Fix:

1. 客户平台，切换分辨率，概率出现播放音频无声问题

Influence Domain:

Display

26.00.34（6/18/2025）

Bug Fix:

1. 登录B站，首页轮播页面遮罩不透明问题

2. 基于electron 框架的应用，显示透明背景页面时，实际显示成黑色背景问题

3. 客户平台HDMI 4K 30Hz 眼图测试fail 问题

Influence Domain:

Display、3DCompiler

26.00.33（5/16/2025）

Bug Fix:

1. S3/S4 唤醒后 AC/DC 状态错误

Influence Domain:

1. KMD

26.00.32 (5/9/2025)

1. Formal release.

26.00.31 (5/7/2025)

Bug Fix:

1. 客户双大屏切找扩展、镜像模式系统卡顿//修正 ssid svid

2. 客户切换通道后卡顿 20~30S 问题//修正 ssid svid

26.00.30 (4/30/2025)

Bug Fix:

1. 客户双大屏切找扩展、镜像模式系统卡顿

2. 客户切换通道后卡顿 20~30S 问题

3. 客户3 个浏览器窗口视频循环播放 4K 视频，libcx4bec.so 崩溃

26.00.29（4/24/2025）

Bug Fix:

1. 客户笔记本播放视频，画面中闪白色亮线，一闪而过

2. 客户笔记本播放视频，画框边缘白色亮线闪烁

3. 客户播 1080p 视频时切换分辨率，视频下方出现了闪动的黑色方块

4. 客户Display mode 4k+175%缩放率+大鼠标显示时移动鼠标导致鼠标闪烁

5. <方德_x64>部分帧会重复回跳，影响流畅度

6. 客户观看安卓端视频流时会出现小视频画面花屏现象

7. 客户DP&HDMI 测试 fail

Influence Domain:

Display、Video、2D、KMD

26.00.28（4/8/2025）

Bug Fix:

1. 客户平台播放 1080p 视频，概率性出现边框亮线闪烁

2. 客户平台使用看图软件打开图片，放大/缩小过程中出现大面积白色及闪烁

26.00.27（4/1/2025）

New Feature/Update:

1. 增加客户整机平台功耗优化feature。

26.00.26（3/14/2025）

Bug Fix:

1. <UOS> S3 唤醒，特定 Type-C to HDMI dongle 无显示

2. <UOS v25>虚拟机安装镜像过程中出现安装失败

3. <KOS>登录四个新建用户账户后回到系统默认账户，系统桌面花屏问题

4. <KOS>客户整机开关机测试机率闪屏

5. <KOS>客户整机系统设置显示器关屏后，存在自动亮起问题

6. <KOS><Video>mpv vaapi 播放KOS 客户特定视频花屏

7. <UOS><Stress>Reboot 进系统后桌面随机出现小块花屏

26.00.25（2/28/2025）

Bug Fix:

1. UOS 开启摄像头会议视频显示图像异常问题

2. KOS 系统鼠标指针大小调节异常问题

3. KOS 系统下播放视频，窗口切换时画面出现残影、撕裂问题

4. 安装包含驱动镜像时花屏问题

26.00.24（2/14/2025）

Bug Fix:

1. 客户笔记本连接外接显示器，仅外接屏幕显示播放 video，会有卡顿现象

2. 客户测试出现小方块花屏

3. Type-C 在特定分辨率下不显示

4. 客户会议系统开启摄像头后崩溃退出

5. 客户会议系统开启摄像头后会导致显示卡顿

6. Lag seriously when run 奥维互动地图 with 3D mode

7. WPS 内嵌视频卡顿问题

8. 使用百度地图时左上角渲染出错会有紫色边框，顶部会有黑色的框

26.00.23（1/20/2025）

Bug Fix:

1. KOS 播放视频卡死问题

26.00.22（1/6/2025）

Bug Fix:

1. 客户panel闪屏问题

2. 客户Panel 抖动问题

3. 客户OS拖动终端画面有割裂感

26.00.21（12/25/2024）

New Feature/Update:

1. 调整集显频率显示

26.00.20(11/28/2024)

Bug Fix:

该版driver主要改动如下:

1. Enable timeout for glmark2长时间全屏播放hang issue

2. 相机预览时，画面移动明显有Tearing和Lag bug fix

3. HDMI/DP和type C复用时，修复显示问题

26.00.19（10/30/2024）

Bug Fix:

1. <UOS_x64>客户笔记本CSOT panel can't light or total corruption

2. <UOS_x64>客户笔记本视频播放过程中切硬解码时画面异常

26.00.17（10/9/2024）

Bug Fix:

1. <Display>Type-C 直连屏幕不显示

2. 客户笔记本无法点亮Type-C转HDMI的dongle

3. 无法点亮Type-C转VGA的dongle

4. 客户笔记本AUO Panel 静置花屏

5. 客户笔记本CSOT Panel 闪屏

6. 扩展模式下，从S3唤醒异常问题

7. Type-C 口（靠近 HDMI ）和 HDMI 口同时连接 monitor, 拔插 HDMI 接口概率性出现花屏

8. Data 文件夹下多了一个“s3dxvaDump”文件夹

9. KOS deb 驱动包和 package 显示不一致问题

26.00.16（9/27/2024）

Bug Fix:

1. <UOS_x64><Type-C>S3唤醒回来，Type-C无法点亮，需开关一下显示器

2. <UOSx64><Display><Random>Type-C 口（靠近HDMI ）和HDMI 口同时连接monitor, 拔插HDMI 接口概率性出现花屏

3. <UOSx64><Display><Random>打开控制中心，全屏控制中心，点击电源管理，节能模式，降低屏幕亮度20%，在通用和使用电源之间切换，约1cm大小花屏，一闪而过

26.00.15（9/9/2024）

Bug Fix:

1. 客户多路视频解码优化 （UOS1070HWE）

2. Type c 基本功能支持

26.00.14（8/9/2024）

Bug Fix:

1. System hang during enter S4

2. Corruption when run GCBS-GPU

3. Total corruption when run Glxgears_Glmark2_Valley/Heaven

4. Lag obviously when play HEVC 8x4K /H264 4x4k/MJPEG 8kx4k by zx_mvpr

5. 跑完 Lmbench 后，右击鼠标，会有 garbage

6. 播放在线视频（720p 视频）双路 12 小时后切换 mode 再播放 1 小时左右花屏

GPU hang

26.00.13（7/5/2024）

Bug Fix:

1. DVFS/CG On.

2. Black screen/auto logout during install driver with clean OS(UOSv1060).

26.00.12（5/24/2024）

Formal 版本发布

26.00.10（4/29/2024）

New Feature/Update:

增加支持 16 路 1080p 在线视频播放

Bug Fix:

UOS S4 测试屏幕右下角花屏问题

26.00.07（3/15/2024）

New Feature:

去掉如下打印: [2.547843] snd_hda_intel 0000:00:01.1: CORB reset timeout#1, CORBRP = 0

Bug Fix:

1) S3 压力测试 fail

2) S4 压力测试 fail

3) Reboot 压力测试 fail

4) 3D + video 压力测试 fail

26.00.05（1/19/2024）

New Feature: 增加 CRT & DP 冲突解决方案

26.00.03（12/29/2023）

NewFeature/Update:

1) Gating ON

26.00.02（11/17/2023）

NewFeature/Update:

1) KX-7000 集显名称修改为C-1190

2) DVFS ON

26.00.00（09/22/2022）

Initial release for KX-7000.

Back to top

Installing and uninstalling driver

Note:

1. 进入root用户，然后进入driver包的目录下执行：

#dpkg –i cx4-linux-graphics-driver-dri-glvnd-26.00.xx_amd64.deb to install x64 driver.

2. Input command #reboot to restart the system.

3. Checking whether the driver is installed successfully Open terminal and input command #dpkg -l | grep cx4

Note: the full name and version of the driver will show: ii cx4-linux-graphics-driver-dri:amd64 26.00.xx.

//前面的 ii 表示安装正常的

4. uninstalling driver Input command in the terminal #dpkg -P cx4-linux-graphics-driver-dri:amd64 (use the full name you check in step 3)

Input command #reboot to restart the system.

Back to top