Skip to content

DTS 信创版环境测试 ​

DTS 信创版环境测试工具(DtsTestTool)用于在信创环境(国产 CPU / 国产操作系统 + 国产或 NVIDIA 显卡)中快速验证渲染环境是否可用,可用于交付前的环境自检与故障排查。

测试工具分为两个版本:

  • PS 版:带 PixelStreaming(像素流)的版本,适用于验证DTSCloud运行环境。
  • NoPS 版:不带 PixelStreaming 的版本,适用于验证DTSExplorer运行环境。

同时提供 x86_64 与 ARM64 两种架构的安装包,请根据服务器 CPU 架构选择。

一、下载测试包 ​

架构版本下载地址
x86_64PShttps://installpackages.gbim.vip/DTS/TestTools/DtsTestTool/x86_64/DtsTestTool_PS.zip
x86_64NoPShttps://installpackages.gbim.vip/DTS/TestTools/DtsTestTool/x86_64/DtsTestTool_NoPS.zip
ARM64PShttps://installpackages.gbim.vip/DTS/TestTools/DtsTestTool/arm64/DtsTestTool_PS_arm64.zip
ARM64NoPShttps://installpackages.gbim.vip/DTS/TestTools/DtsTestTool/arm64/DtsTestTool_NoPS_arm64.zip

注意: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
└── Samples

ARM64 NoPS 版:

text
DtsTestTool_NoPS_arm64/
├── DtsTestTool_NoPS
├── DtsTestTool_NoPS-AArch64.sh
├── Engine
└── Manifest_NonUFSFiles_LinuxAArch64.txt

x86_64 PS 版:

text
DtsTestTool_PS/
├── DtsTestTool_PS
├── DtsTestTool_PS.sh
├── Engine
├── Manifest_NonUFSFiles_Linux.txt
└── Samples

x86_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 PSDtsTestTool_PSDtsTestTool_PS.sh
x86_64 NoPSDtsTestTool_NoPSDtsTestTool_NoPS.sh
ARM64 PSDtsTestTool_PS_arm64DtsTestTool_PS-AArch64.sh
ARM64 NoPSDtsTestTool_NoPS_arm64DtsTestTool_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 而退出,典型报错如下:

text
LogInit: 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 等记录,并打印出视口分辨率,例如:

    text
    Resizing viewport due to setres change, 1024 x 768

    能看到分辨率信息,基本就可以判断渲染环境没有问题。

  • 若启动失败或日志中没有出现分辨率信息,请依次检查:

    1. 显卡驱动是否安装正确(可用 nvidia-smi 确认);
    2. Vulkan 运行库是否安装(参见 Explorer For Linux 安装 中的驱动与 Vulkan 安装章节);
    3. 操作系统与 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 的完整安装流程。