用于 VxWorks 的 Qt

如需了解更多信息，请联系 Qt 公司： https://www.qt.io/contact-us/

Qt for VxWorks 许可

Qt for VxWorks 采用 Qt for Device Creation Professional (DCP) 许可。有关详细信息，请参阅Qt 定价。

支持的体系结构和 VxWorks 版本

Qt 6.8 已在 VxWorks 24.03 上验证。

支持的体系结构：

ARM-v7-在 BD-SL-i.MX6 上进行了测试。使用的 BSP：fsl_imx6
x86_64-已在 Intel NUC6i3SYH 上测试。使用的 BSP：itl_generic

如果您对后续 Qt 版本感兴趣，请联系Qt 专业服务。

VxWorks 要求

Qt Widgets 应用程序

支持 POSIX
支持 C++17

Qt Quick 2 应用程序

Qt Widgets 应用程序所需的所有功能，以及以下功能：

用于 OpenGL ES 2.0 的 GPU 设备 (GPUDEV)

支持的模块

支持大多数基本Qt 模块和一些附加模块。

支持的基本模块

Qt 模块	支持的功能	注释
Qt Core		不支持QProcess 。QLocalSocket 和QLocalServer 仅支持 SOCK_SEQPACKET。
Qt GUI
Qt Network
Qt Qml
Qt Quick
Qt Quick Controls
Qt Quick Dialogs
Qt Quick 布局
Qt Quick 测试
Qt Test
Qt Widgets

支持的附加组件

Qt 附加组件	注释
Qt Concurrent
Qt GRPC/Protobuf
Qt Graphs
Qt Image Formats
Qt Multimedia
Qt 本地接口
Qt OpenGL
Qt Quick 3D
Qt Quick Compiler
Qt Quick Effects
Qt SQL
Qt SVG
Qt Virtual Keyboard

注意： 在运行 configure 工具时，您可以通过 -skip <module> 选项从构建中明确排除不支持或未使用的模块。

平台注意事项

Qt 准备用于 RTP 应用程序，不支持 DKM。

Qt 5.0 发布后，Qt 不再包含自己的窗口系统实现：QWS 不再是受支持的平台。对于单进程用例，Qt 平台抽象是一种更优的解决方案。

有一个插件可以在 VxWorks 上使用：EGLFS。该插件的可用性取决于 Qt 的配置。

为特定设备进行配置

通过安装 VxWorks SDK 和获取 WindRiver 许可证来准备环境，安装程序和构建 VxWorks 映像都需要 WindRiver 许可证。在 {https://gallery.windriver.com/portal/products} 中搜索相应的安装程序。

为特定设备构建 Qt 需要为编译主机安装 Qt 6、工具链和系统根。此外，某些设备还需要供应商特定的适配代码，以支持 EGL 和 OpenGL 2.0。

VxWorks 映像要求

Qt for VxWorks 需要在基础软件中嵌入特定的 VxWorks 映像捆绑包和组件，才能使 Qt 正常编译和运行。该列表并不完整，因为它取决于项目的硬件、软件和系统要求。不过，下表列出了某些功能（包括触摸屏支持）必须使用的组件。请注意，这些配置可能会随 VxWorks 版本的变化而变化。

fsl_imx6 和 itl_generic BSP 的 VSB 配置示例

要使 Qt 正常工作，您需要在 VSB 中添加以下功能。有关详细信息，请查阅 WindRiver VxWorks 文档。

特性	注释
`DSI_DSI_KERNEL`
`IPNET_COREIP`
`IPNET_DHCPC`
`SDMMC_DEVICE`
`SDMMC_HOST`
`SDMMC_SDHC`
`SDMMC_STORAGE`
`SERVICE_UN`
`SOCKET`
`USB_EHCI`
`USB_KEYBOARD`
`USB_MOUSE`
`USB_STORAGE`
`USB_TOUCHSCREEN`
`EVDEV`
`EVDEV_LIB`
`EVDEV_TI_TSC2004_TS`
`EVDEV_EETI_EXC7200_TS`
`AUDIO`
`GPUDEV_FSLVIVGPU`	fsl_imx6专用
`HASH`
`OPENSSL`
`RANDOM_ENTROPY_INJECT`
`IPNET_SSH`
`USER_MANAGEMENT`
`ICU`
`DRM`	特定于 itl_generic
`ITLI915`	特定于 itl_generic
`LIBDRM`	特定于 itl_generic
`MESA`	itl_generic specific

以下配置变量是隐式添加的，需要删除：

变量	注释
`_WRS_CONFIG_EVDEV_OPTIMIZED_MODE`
`_WRS_CONFIG_EVDEV_DISPLAY_POINT_TRANSLATE`
`_WRS_CONFIG_MESA_MANGLE`	itl_generic specific

您需要在配置中添加以下变量：

变量	值	注释
`_WRS_CONFIG_RTP_SSP`	`y`
`_WRS_CONFIG_RTP_STACK_PROTECTOR`	`y`
`_WRS_CONFIG_MESA_GPUDEV_INTEL_GEN90`	`y`	itl_generic specific
`_WRS_CONFIG_EVDEV_COMPATIBLE_MODE`	`y`	为使 Qt 能在触摸屏上正常工作而需要。

fsl_imx6 和 itl_generic BSP 的 VIP 配置示例

更多详情，请查阅 WindRiver VxWorks 文档。

软件包	注意事项
`BUNDLE_POSIX`	为兼容 Qt 所需的 POSIX 相关功能，必须使用此捆绑包。
`BUNDLE_RTP_DEPLOY`
`BUNDLE_RTP_DEVELOP`
`BUNDLE_STANDALONE_SHELL`

组件	注意事项
`INCLUDE_TMP_DIR` `INCLUDE_RAM_DISK_FORMAT_HRFS`	如果要使用QTemporaryFile ，必须包含这两个组件。请注意，您还应考虑将`TMP_DIR_SIZE` 设置为适当的值。
`DRV_AUDIO_FSL_SSI`
`DRV_AUDIO_FSL_SGTL5000`
`DRV_FSL_SDHC_CTRL`
`DRV_IMX_SDHC_CTRL`
`INCLUDE_EHCI_INIT`
`INCLUDE_FSL_IMX6Q_SABRELITE`
`DRV_MMCSTORAGE_CARD`
`DRV_SDSTORAGE_CARD`
`INCLUDE_AUDIO_LIB_CORE`
`INCLUDE_AUDIO_LIB_WAV`
`INCLUDE_CUSTOM_ENTROPY_ADD`
`INCLUDE_DEBUG_AGENT_START`
`INCLUDE_DEFAULT_TIMEZONE`
`INCLUDE_DISK_UTIL`
`INCLUDE_DOSFS`
`INCLUDE_DSAPARAM_CMD`
`INCLUDE_END`
`INCLUDE_EVDEV_LIB_CORE`
`INCLUDE_EVDEV_LIB_KBD`
`INCLUDE_EVDEV_LIB_KBD_MAP_US`
`INCLUDE_EVDEV_LIB_PTR`
`INCLUDE_EVDEV_LIB_TS`
`INCLUDE_GENDSA_CMD`
`INCLUDE_GENRSA_CMD`
`INCLUDE_GETADDRINFO`
`INCLUDE_GETNAMEINFO`
`INCLUDE_HRFS`
`INCLUDE_HRFS_ACCESS_TIMESTAMP`
`INCLUDE_HRFS_FORMAT`
`INCLUDE_HRFS_HISPEED_WRITE_MODE`
`INCLUDE_IFCONFIG`
`INCLUDE_IO_REALPATH`	需要使用该组件来启用为`QFileInfo`
`INCLUDE_IPATTACH`
`INCLUDE_IPCOM_SYSLOGD_CMD`
`INCLUDE_IPCOM_SYSVAR_CMD`
`INCLUDE_IPCOM_USE_RAM_DISK`
`INCLUDE_IPCOM_USE_TIME_CMD`
`INCLUDE_IPDHCPC`
`INCLUDE_IPDNSC`
`INCLUDE_IPD_CMD`
`INCLUDE_IPFTPC`
`INCLUDE_IPFTP_CMD`
`INCLUDE_IPIFCONFIG_CMD`
`INCLUDE_IPNETSTAT_CMD`
`INCLUDE_IPNSLOOKUP_CMD`
`INCLUDE_IPPING_CMD`
`INCLUDE_IPROUTE_CMD`
`INCLUDE_IPTRACE_ROUTE_CMD`
`INCLUDE_IPWRAP_GETHOSTBYADDR`
`INCLUDE_IPWRAP_GETHOSTBYNAME`
`INCLUDE_IPWRAP_GETNAMEINFO`
`INCLUDE_IPWRAP_IFNAME`
`INCLUDE_IPWRAP_ROUTECMD`
`INCLUDE_MMAP`
`INCLUDE_PING`
`INCLUDE_PIPES`
`INCLUDE_POSIX_MAPPED_FILES`
`INCLUDE_POSIX_PIPES`
`INCLUDE_POSIX_PTHREAD_SCHEDULER`
`INCLUDE_POSIX_SHM`
`INCLUDE_RAM_DISK`
`INCLUDE_RAM_DISK_FORMAT_HRFS`
`INCLUDE_RANDOM_NUM_GEN`
`INCLUDE_ROMFS`
`INCLUDE_ROUTECMD`
`INCLUDE_SC_PIPE`
`INCLUDE_SC_POSIX_PIPE`
`INCLUDE_SD_BUS`
`INCLUDE_SECURITY`
`INCLUDE_SEC_KEY_STORE_CMD`
`INCLUDE_SHELL`
`INCLUDE_SSH`
`INCLUDE_STANDALONE_SYM_TBL`
`INCLUDE_STARTUP_SCRIPT`
`INCLUDE_TMP_DIR`
`INCLUDE_UN_COMP`
`INCLUDE_USB_GEN2_KEYBOARD`
`INCLUDE_USB_GEN2_MOUSE`
`INCLUDE_USB_GEN2_STORAGE_INIT`
`INCLUDE_USB_TOUCH_SCREEN`
`INCLUDE_USB_TOUCH_SCREEN_INIT`
`INCLUDE_USER_DATABASE`
`INCLUDE_USER_IDENTIFICATION`
`INCLUDE_VRFS`
`INCLUDE_VXBUS_SHOW`
`DRV_TOUCH_SCREEN_TI_TSC2004`
`DRV_TOUCH_SCREEN_EETI_EXC7200`
`INCLUDE_FBDEV_FSLIPU_0`	fsl_imx6特定
`INCLUDE_FBDEV_SPLASH`
`INCLUDE_GPUDEV_FSLVIV_API`	fsl_imx6 specific
`INCLUDE_GPUDEV_FSLVIV_API_INIT`	特定fsl_imx6
`INCLUDE_GPUDEV_ITLGMC_2`	特定于 itl_generic
`INCLUDE_I915`	特定于 itl_generic
`INCLUDE_MESA_FBDEV`	特定于 itl_generic
`INCLUDE_MESA_GPUDEV_DRI`	特定于 itl_generic
`INCLUDE_MESA_GPUDEV_DRI_I965`	特定于 itl_generic

以下组件是隐式添加的，您需要将其删除：

层	注释
`INCLUDE_FTP`
`INCLUDE_SHELL_SECURITY`

VIP 参数

您需要添加以下参数才能使 Qt 在 VxWorks 上正常运行：

参数	示例值	注释
`SEC_VAULT_KEY_ENCRYPTING_PW`	`'"vxTarget"'`	示例值
`UDB_STORAGE_PATH`	`'"/ram/vxUserDB.txt"'`	示例值
`UDB_HASH_KEY`	`'"123456789"'`	示例值
`UDB_HASH_KEY_LEN`	`9`	示例值，请参见前面
`FSLVIV_RTP_COMMAND_BUFFER_QUEUE`	`32`	适用于 "arm "架构
`SYS_CLK_RATE`	`100`
`RTP_PTHREAD_STACK_SIZE_DEFAULT`	`262144`	为使 qtquick3d 示例正常工作所必需。可通过 PTHREAD_STACK_SIZE_DEFAULT 环境变量重载。
`TMP_DIR_SIZE`	`614400`	通过 Qt 内部测试的最小值
`NUM_FILES`	`300`
`RTP_FD_NUM_MAX`	`300`
`HRFS_DEFAULT_MAX_FILES`	`300`
`ITLGMC_FBDEV_RESOLUTION_2`	`'"1024x768-32"'`	通过 HDMI 连接 Xenarc 706TSA 触摸屏的示例值。

为 VxWorks 构建 Qt 6

主机构建

要交叉编译 Qt，需要有 Qt 的主机构建。这是因为在构建过程中，某些工具（如moc,rcc,qmlcachegen 和qsb ）会从主机构建中调用。您有以下选项：

为主机构建 Qt 源代码、
使用Qt Online Installer 安装主机构建。

不过，建议您确保也能在主机上为桌面目标构建 Qt，因为为 VxWorks 编译时也需要相同的工具。

运行配置脚本

为主机配置、构建和安装 Qt 6 的命令如下：

./configure \
    -cmake-generator "Ninja" \
    -extprefix <path/to/Qt6/host/installation/dir> \
    -submodules qtbase,qtdeclarative,qtquick3d,qtshadertools \
    -nomake tests \
    -nomake examples \
    -- \
    -B <host/build/directory>
cd <host/build/directory>
cmake --build . --parallel
cmake --install .

这些命令会在<path_to_Qt 6_host_installation_dir> 中为主机安装 Qt 6。

为目标机构建 Qt 6

设置构建环境

在运行 configure 和构建 Qt 6 之前，必须在命令提示符下打开VxWorks Development Shell。

Linux：

cd <VxWorks installation directory>
./wrenv.sh -p vxworks
export WIND_CC_SYSROOT=<path to VxWorks VSB directory>

Windows

cd <VxWorks installation directory>
wrenv -p vxworks
export WIND_CC_SYSROOT=<path to VxWorks VSB directory>

准备自定义 CMake 工具链文件

要从 BSP 中包含图形库，首先需要创建 CMake 工具链文件。BD-SL-i.MX6 设备的 CMake 工具链文件示例：

# Copyright (C) 2024 The Qt Company Ltd.
# SPDX-License-Identifier: BSD-3-Clause

if(QT_VXWORKS_TOOLCHAIN_FILE)
    set(_original_toolchain_file "${QT_VXWORKS_TOOLCHAIN_FILE}")
elseif(DEFINED ENV{QT_VXWORKS_TOOLCHAIN_FILE})
    set(_original_toolchain_file "$ENV{QT_VXWORKS_TOOLCHAIN_FILE}")
else()
    message(FATAL_ERROR "QT_VXWORKS_TOOLCHAIN_FILE is not set.")
endif()

if(NOT EXISTS "${_original_toolchain_file}")
    message(FATAL_ERORR "${_original_toolchain_file} doesn't exists.")
endif()

include("${_original_toolchain_file}")
unset(_original_toolchain_file)

list(APPEND CMAKE_TRY_COMPILE_PLATFORM_VARIABLES QT_VXWORKS_TOOLCHAIN_FILE)

set(_common_lib_path "${CMAKE_SYSROOT}/usr/lib/common")
set(EGL_INCLUDE_DIR ${CMAKE_SYSROOT}/usr/h/public CACHE PATH "Path to EGL include directory" FORCE)
set(EGL_LIBRARY ${_common_lib_path}/libgfxFslVivEGL.so CACHE PATH "Path to EGL lib" FORCE)
set(GLESv2_INCLUDE_DIR ${CMAKE_SYSROOT}/usr/h/public CACHE PATH "Path to GLES include directory" FORCE)
set(GLESv2_LIBRARY ${_common_lib_path}/libgfxFslVivGLESv2.so CACHE PATH "Path to GLES lib" FORCE)

set(VxWorksPlatformGraphics_DEFINES "-D_FSLVIV")
set(VxWorksPlatformGraphics_LIBRARIES_PACK
    "${_common_lib_path}/libgfxFslVivEGL.so"
    "${_common_lib_path}/libgfxFslVivGLESv2.so"
    "${_common_lib_path}/libgfxFslVivGAL.so"
    "${_common_lib_path}/libgfxFslVivGLSLC.so"
    "${_common_lib_path}/libgfxFslVivVDK.so"
    "${_common_lib_path}/libxml.so"
)

set(VxWorksPlatformGraphics_REQUIRED_LIBRARIES
    ${VxWorksPlatformGraphics_LIBRARIES_PACK}
    ${EGL_LIBRARY}
    ${GLESv2_LIBRARY}
)
unset(_common_lib_path)

用于 Intel NUC6i3SYH 的示例：

# Copyright (C) 2024 The Qt Company Ltd.
# SPDX-License-Identifier: BSD-3-Clause

if(QT_VXWORKS_TOOLCHAIN_FILE)
    set(_original_toolchain_file "${QT_VXWORKS_TOOLCHAIN_FILE}")
elseif(DEFINED ENV{QT_VXWORKS_TOOLCHAIN_FILE})
    set(_original_toolchain_file "$ENV{QT_VXWORKS_TOOLCHAIN_FILE}")
else()
    message(FATAL_ERROR "QT_VXWORKS_TOOLCHAIN_FILE is not set.")
endif()

if(NOT EXISTS "${_original_toolchain_file}")
    message(FATAL_ERORR "${_original_toolchain_file} doesn't exists.")
endif()

include("${_original_toolchain_file}")
unset(_original_toolchain_file)

list(APPEND CMAKE_TRY_COMPILE_PLATFORM_VARIABLES QT_VXWORKS_TOOLCHAIN_FILE)

set(_common_lib_path "${CMAKE_SYSROOT}/usr/lib/common")
set(EGL_INCLUDE_DIR ${CMAKE_SYSROOT}/usr/h/public CACHE PATH "Path to EGL include directory" FORCE)
set(EGL_LIBRARY ${_common_lib_path}/libgfxMesaEGL.so CACHE PATH "Path to EGL lib" FORCE)
set(GLESv2_INCLUDE_DIR ${CMAKE_SYSROOT}/usr/h/public CACHE PATH "Path to GLES include directory" FORCE)
set(GLESv2_LIBRARY ${_common_lib_path}/libgfxMesaGL.so CACHE PATH "Path to GLES lib" FORCE)

set(VxWorksPlatformGraphics_DEFINES "-D__vxworks -D__VXWORKS")
set(VxWorksPlatformGraphics_LIBRARIES_PACK
    "${_common_lib_path}/libgfxMesaEGL.so"
    "${_common_lib_path}/libgfxMesaGL.so"
    "${_common_lib_path}/libgfxMesaSw.so"
    "${_common_lib_path}/libgfxMesa.so"
    "${_common_lib_path}/libgfxMesaDriI965.so"
    "${_common_lib_path}/libgfxLibDRM.so"
    "${_common_lib_path}/libxml.so"
)

set(VxWorksPlatformGraphics_REQUIRED_LIBRARIES
    ${VxWorksPlatformGraphics_LIBRARIES_PACK}
    ${EGL_LIBRARY}
    ${GLESv2_LIBRARY}
)
unset(_common_lib_path)

为目标运行 Qt 6 配置

下面是 BD-SL-i.MX6 的构建配置示例。对于大多数 VxWorks 板，配置命令看起来非常相似。默认情况下，Qt 6 被配置为使用共享库。要静态编译 Qt 6，请在 configure 中添加-static 选项。

确保将 {WIND_CC_SYSROOT} 环境变量设置为 VxWorks VSB 根目录。

./configure \
    -cmake-generator "Ninja" \
    -icu \
    -eglfs \
    -qpa eglfs \
    -submodules "qtbase,qtdeclarative,qtmultimedia,qtquick3d,qtgraphs,qtimageformats,qtsvg,qtshadertools,qtvirtualkeyboard" \
    -- \
    -B <target/build/directory> \
    -DQT_VXWORKS_TOOLCHAIN_FILE=<path/to/BDP/toolchain.cmake> \
    -DFEATURE_vulkan=OFF \
    -DQT_QMAKE_TARGET_MKSPEC=vxworks-clang \
    -DQT_HOST_PATH=<path/to/Qt6/host/installation/dir> \
    -DCMAKE_STAGING_PREFIX:PATH=<path/to/Qt6/target/installation/dir> \
    -DCMAKE_TOOLCHAIN_FILE=<path/to/cmake/for/graphics/file/created/above> \

建议使用影子编译构建 Qt 6。有关详细信息，请参阅Qt 配置选项。

警告： 如果 VxWorks 配置为RTP_MEM_FILL 为 false，则 Qt configure 需要一个额外的-DCMAKE_CXX_FLAGS="-DQT_RTP_MEM_FILL=1" 参数。

配置完成后，使用这些命令为 VxWorks 构建并安装 Qt 6：

cd <host build directory>
cmake --build . --parallel
cmake --install .

用于 VxWorks 设备的平台插件

Qt for VxWorks 支持用于本地窗口替换的 EGLFS 平台插件。请在EGLFS 中阅读有关其配置的更多信息。

构建 Qt 应用程序

要构建 Qt 应用程序，必须将 QT_VXWORKS_TOOLCHAIN_FILE 设置为环境变量或定义。

下面是一个构建时钟 Qt 演示的示例：

export WIND_CC_SYSROOT=<path/to/VxWorks/VSB/directory>
export QT_VXWORKS_TOOLCHAIN_FILE=<path/to/the/BSP/toolchain.cmake>
<path/to/Qt6/target/installation/dir>/bin/qt-cmake -G Ninja -S ~/Qt/Examples/Qt-6.8.0/demos/clocks -B <path/to/build/directory>
cd <path/to/build/directory>
cmake --build . --parallel

运行 Qt 应用程序

下面的示例展示了如何在使用共享库构建 Qt 6 时启动应用程序。对于静态构建的 Qt 6，不需要为 Qt 库使用LD_LIBRARY_PATH 环境变量，但它需要指向 VxWorks 共享库（例如 libc 和 OpenGL ES 2.0）的位置。Qt 6 静态库则不需要。

putenv "LD_LIBRARY_PATH=/sd0:1/lib"
cd "/sd0:1"
rtpSp("<Qt 6_app>", 200, 0x100000, 0, 0x01000000)

限制

视频内存

在运行基于Qt Quick 或类（如QOpenGLWidget ）的 Qt 应用程序之前，使用固定数量专用视频内存的系统可能需要格外小心。默认设置可能无法满足此类应用程序的要求，尤其是在高分辨率（如全高清）屏幕上显示时。在这种情况下，它们可能会出现意想不到的故障。因此，建议确保至少有 128 MB 的 GPU 内存可用。对于没有为 GPU 预留固定内存量的系统，这不是问题。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.