明暗主题
DTS 信创版环境测试
DTS 信创版环境测试工具(DtsTestTool)用于在信创环境(国产 CPU / 国产操作系统 + 国产或 NVIDIA 显卡)中快速验证渲染环境是否可用,可用于交付前的环境自检与故障排查。
测试工具分为两个版本:
- PS 版:带 PixelStreaming(像素流)的版本,适用于验证DTSCloud运行环境。
- NoPS 版:不带 PixelStreaming 的版本,适用于验证DTSExplorer运行环境。
同时提供 x86_64 与 ARM64 两种架构的安装包,请根据服务器 CPU 架构选择。
一、下载测试包
注意:x86_64 与 ARM64 的包名、解压目录名和启动脚本名不同——ARM64 版带
_arm64后缀、脚本带-AArch64后缀;x86_64 版没有这些后缀。请按实际架构选择。
二、上传并解压
将测试包上传到服务器任意目录后解压,例如:
bash
unzip DtsTestTool_PS_arm64.zip四种版本解压后的一级目录结构如下(.sh 即启动脚本):
ARM64 PS 版:
text
DtsTestTool_PS_arm64/
├── DtsTestTool_PS
├── DtsTestTool_PS-AArch64.sh
├── Engine
├── Manifest_NonUFSFiles_LinuxAArch64.txt
└── SamplesARM64 NoPS 版:
text
DtsTestTool_NoPS_arm64/
├── DtsTestTool_NoPS
├── DtsTestTool_NoPS-AArch64.sh
├── Engine
└── Manifest_NonUFSFiles_LinuxAArch64.txtx86_64 PS 版:
text
DtsTestTool_PS/
├── DtsTestTool_PS
├── DtsTestTool_PS.sh
├── Engine
├── Manifest_NonUFSFiles_Linux.txt
└── Samplesx86_64 NoPS 版:
text
DtsTestTool_NoPS/
├── DtsTestTool_NoPS
├── DtsTestTool_NoPS.sh
├── Engine
└── Manifest_NonUFSFiles_Linux.txt可以看出:PS 版比 NoPS 版多一个
Samples(PixelStreaming 示例)目录;ARM64 版的清单文件带AArch64后缀,x86_64 版不带。
三、运行测试
进入解压目录,执行对应的启动脚本。四种版本的目录名与脚本名如下:
| 架构 / 版本 | 解压目录 | 启动脚本 |
|---|---|---|
| x86_64 PS | DtsTestTool_PS | DtsTestTool_PS.sh |
| x86_64 NoPS | DtsTestTool_NoPS | DtsTestTool_NoPS.sh |
| ARM64 PS | DtsTestTool_PS_arm64 | DtsTestTool_PS-AArch64.sh |
| ARM64 NoPS | DtsTestTool_NoPS_arm64 | DtsTestTool_NoPS-AArch64.sh |
命名规律:ARM64 版目录带
_arm64后缀、脚本带-AArch64后缀;x86_64 版均无后缀。PS / NoPS 体现在脚本名中。
根据是否连接显示器,有两种运行方式:
方式一:直连显示器(可直观看到渲染效果)
前提:必须是直连显示器的本地环境(有可用的 video device)。通过 SSH、远程终端等非直连显示器的方式登录时,即使服务器接了显示器,也不要用此方式——会报错,请改用方式二。
在满足前提的环境下,直接运行启动脚本,不加任何参数,即可看到飞机飞行的 3D 动态画面:
bash
# x86_64 PS 版
cd DtsTestTool_PS
./DtsTestTool_PS.sh
# x86_64 NoPS 版
cd DtsTestTool_NoPS
./DtsTestTool_NoPS.sh
# ARM64 PS 版
cd DtsTestTool_PS_arm64
./DtsTestTool_PS-AArch64.sh
# ARM64 NoPS 版
cd DtsTestTool_NoPS_arm64
./DtsTestTool_NoPS-AArch64.sh方式二:无显示器(服务器环境,离屏渲染)
服务器通常没有外接显示器,此时加 -RenderOffScreen 参数进行离屏渲染(在对应的脚本后加该参数即可):
bash
# x86_64 PS 版
cd DtsTestTool_PS
./DtsTestTool_PS.sh -RenderOffScreen
# x86_64 NoPS 版
cd DtsTestTool_NoPS
./DtsTestTool_NoPS.sh -RenderOffScreen
# ARM64 PS 版
cd DtsTestTool_PS_arm64
./DtsTestTool_PS-AArch64.sh -RenderOffScreen
# ARM64 NoPS 版
cd DtsTestTool_NoPS_arm64
./DtsTestTool_NoPS-AArch64.sh -RenderOffScreen远程终端 / SSH 等非直连显示器的场景,必须加
-RenderOffScreen。如果此时不加参数,程序会因找不到可用的 video device 而退出,典型报错如下:textLogInit: Initializing SDL. LogInit: Warning: Could not initialize SDL: No available video device LogInit: Error: FLinuxApplication::CreateLinuxApplication() : InitSDL() failed, cannot create application instance. LogCore: FUnixPlatformMisc::RequestExit(bForce=true, ReturnCode=1)反过来,如果是直连显示器却加了
-RenderOffScreen,则看不到 3D 画面。
四、GPU 综合检测脚本(可选)
除上述渲染测试外,还可使用 GPU 综合检测脚本对显卡、驱动、Vulkan 等环境做更全面的检查。脚本为只读检测,不会安装软件或修改系统配置。
1. 下载并运行
bash
wget https://installpackages.gbim.vip/DTS/TestTools/gpu_comprehensive_check.sh
sudo bash gpu_comprehensive_check.sh脚本中的
dmidecode、dmesg、详细的lspci等检测需要 root 权限,因此必须使用sudo执行,按提示输入密码即可。
2. 检测内容
脚本会依次检查:CPU 架构、启动模式(UEFI / Legacy)、物理机 / 虚拟机、BIOS 信息、内核参数、IOMMU / SMMU、PCI BAR 与 Above 4G、显卡厂商与型号、驱动模块与命令、其他厂商驱动冲突、Vulkan 基础库与 ICD 配置、环境变量污染、Resizable BAR 等。
重点支持厂商:NVIDIA、摩尔线程、砺算科技、象帝先。
输出以颜色区分状态:[PASS] 绿色、[FAIL] 红色、[WARN] 黄色、[INFO] 青色。
3. 最终结论
脚本末尾给出两项结论:
- GPU 渲染能力:需同时满足"有独立显卡、驱动就绪、libvulkan 已安装、Vulkan ICD 配置正确";
- DTS 大型场景运行:在上述基础上,进一步检查 Above 4G、Resizable BAR,以及摩尔线程 / 砺算显卡所需的
libva、libdrm。
若结论为 FAIL 或 WARN,按报告提示逐项处理;仍无法解决时,将完整输出保存后发给飞渡(见最后一节)。
五、结果判断
连接显示器时:能看到飞机飞行的 3D 动态画面,说明当前环境的显卡驱动、Vulkan 及渲染链路工作正常。
无显示器时(离屏渲染):程序没有画面输出,以日志为准。若日志中出现引擎初始化完成、加载
FlyingExampleMap等记录,并打印出视口分辨率,例如:textResizing viewport due to setres change, 1024 x 768能看到分辨率信息,基本就可以判断渲染环境没有问题。
若启动失败或日志中没有出现分辨率信息,请依次检查:
- 显卡驱动是否安装正确(可用
nvidia-smi确认); - Vulkan 运行库是否安装(参见 Explorer For Linux 安装 中的驱动与 Vulkan 安装章节);
- 操作系统与 CPU 架构是否与测试包匹配。
- 显卡驱动是否安装正确(可用
六、附加:保存日志并反馈飞渡
如测试失败或需要飞渡协助排查,请将运行时抛出的日志保存到文件,并拷贝发送给飞渡技术支持。
在运行脚本时通过重定向把标准输出和错误输出一并写入日志文件,例如 ARM64 PS 版:
bash
cd DtsTestTool_PS_arm64
./DtsTestTool_PS-AArch64.sh -RenderOffScreen > dts_test.log 2>&1其中 > dts_test.log 2>&1 表示把正常输出和错误信息都写入 dts_test.log。其他版本替换为对应的脚本名即可。
测试结束后,用 Xftp 等 SFTP 客户端连接服务器,把生成的 dts_test.log 下载到 Windows 本地,再通过微信、邮箱等方式发送给飞渡技术支持。
请同时提供以下信息,便于快速定位问题:
日志文件
dts_test.log;测试包架构与类型(x86_64 / ARM64,PS / NoPS);
操作系统信息:必须具体到版本号,并注明是服务器版还是桌面版(信创系统的服务器版与桌面版是两种不同的系统)。在银河麒麟系统上执行
nkvers获取完整版本信息,将输出一并发给飞渡,例如:text[freedo@yuan-test-01 ~]$ nkvers ############## Kylin Linux Version ################# Release: Kylin Linux Advanced Server release V11 (Swan25) Kernel: 6.6.0-32.7.v2505.ky11.aarch64 Build: Kylin Linux Advanced Server release V11 2503/(Swan25)-aarch64-Build20.01/20250715 #################################################Release中带Server即为服务器版(桌面版会显示为桌面相关版本),Build中的aarch64/x86_64表明架构。其他操作系统一般使用
cat /etc/os-release获取版本信息,将输出一并发给飞渡。CPU 型号及显卡型号。
本工具仅用于环境渲染能力自检,不替代 DTS Explorer / Cloud 的完整安装流程。