Qt para VxWorks
Póngase en contacto con The Qt Company para obtener más información: https://www.qt.io/contact-us/
Licencias de Qt para VxWorks
Qt para VxWorks está disponible bajo la licencia Qt for Device Creation Professional (DCP). Para obtener más información, consulta «Precios de Qt».
Arquitecturas y versiones de VxWorks compatibles
Qt 6.10 ha sido verificado en VxWorks 25.03.
Arquitecturas compatibles:
- ARM-v7: probado en BD-SL-i.MX6. BSP utilizado: fsl_imx6
- x86_64: probado en Intel NUC6i3SYH. BSP utilizado: itl_generic
Si está interesado en versiones posteriores de Qt, póngase en contacto con los servicios profesionales de Qt.
Requisitos para VxWorks
Qt Widgets Aplicaciones
- Compatibilidad con POSIX
- Compatibilidad con C++17
Qt Quick 2 Aplicaciones
Todas las características necesarias para las aplicaciones de « Qt Widgets », además de las siguientes:
- Dispositivo GPU (GPUDEV) para OpenGL ES 2.0
Módulos compatibles
Se admiten los módulos más esenciales de Qt y algunos módulos complementarios.
Módulos esenciales compatibles
| Módulo de Qt | Notas |
|---|---|
| Qt Core | No se admite « QProcess ». « QLocalSocket » y « QLocalServer » solo admiten «SOCK_SEQPACKET». |
| Qt GUI | No aplicable |
| Qt Network | No aplicable |
| Qt Qml | No aplicable |
| Qt Quick | No aplicable |
| Qt Quick Controles | No aplicable |
| Qt Quick Cuadros de diálogo | No aplicable |
| Qt Quick Diseños | No aplicable |
| Qt Quick Prueba | No aplicable |
| Qt Test | No aplicable |
| Qt Widgets | No aplicable |
Complementos compatibles
Nota: Puedes excluir explícitamente de la compilación los módulos no compatibles o que no se utilicen mediante la opción -skip <módulo> al ejecutar la herramienta configure.
Notas sobre la plataforma
Qt está preparado para ser utilizado por aplicaciones RTP; no hay compatibilidad con DKM.
Con el lanzamiento de Qt 5.0, Qt ya no incluye su propia implementación del sistema de ventanas: QWS ya no es una plataforma compatible. Para casos de uso de un solo proceso, la abstracción de plataforma de Qt es una solución superior.
Hay un complemento que se puede utilizar en VxWorks: EGLFS. La disponibilidad de este complemento depende de la configuración de Qt.
Configuración para un dispositivo específico
Prepara tu entorno instalando el SDK de VxWorks y obteniendo la licencia de WindRiver, necesaria para el instalador y para compilar imágenes de VxWorks. Busca el instalador adecuado en {https://gallery.windriver.com/portal/products}.
La compilación de Qt para un dispositivo concreto requiere una instalación de Qt 6 en el host de compilación, una cadena de herramientas y un sysroot. Consulte «Compilación cruzada de Qt» para obtener más detalles. Además, algunos dispositivos requieren código de adaptación específico del fabricante para la compatibilidad con EGL y OpenGL 2.0.
Requisitos de la imagen de VxWorks
Qt para VxWorks requiere que se integren determinados paquetes y componentes de la imagen de VxWorks en el software base para que Qt se compile y funcione correctamente. La lista no es en absoluto exhaustiva, ya que depende de los requisitos de hardware, software y sistema de su proyecto. No obstante, la siguiente tabla recoge aquellos que son obligatorios para que funcionen determinadas funcionalidades (incluida la compatibilidad con pantallas táctiles). Ten en cuenta también que estos requisitos pueden variar según las versiones de VxWorks.
Ejemplo de configuración de VSB para los BSP fsl_imx6 e itl_generic
Debes añadir las siguientes características a VSB para que Qt funcione correctamente. Para obtener más detalles, consulta la documentación de WindRiver VxWorks.
| Funcionalidad | Notas |
|---|---|
DSI_DSI_KERNEL | No aplicable |
IPNET_COREIP | No aplicable |
IPNET_DHCPC | No aplicable |
SDMMC_DEVICE | No aplicable |
SDMMC_HOST | No aplicable |
SDMMC_SDHC | No aplicable |
SDMMC_STORAGE | No aplicable |
SERVICE_UN | No aplicable |
SOCKET | No aplicable |
USB_EHCI | No aplicable |
USB_KEYBOARD | No aplicable |
USB_MOUSE | No aplicable |
USB_STORAGE | No aplicable |
USB_TOUCHSCREEN | No aplicable |
EVDEV | No aplicable |
EVDEV_LIB | No aplicable |
EVDEV_TI_TSC2004_TS | No aplicable |
EVDEV_EETI_EXC7200_TS | No aplicable |
AUDIO | No aplicable |
GPUDEV_FSLVIVGPU | Específico de fsl_imx6 |
HASH | No aplicable |
OPENSSL | No aplicable |
RANDOM_ENTROPY_INJECT | No aplicable |
IPNET_SSH | No aplicable |
USER_MANAGEMENT | No aplicable |
ICU | No aplicable |
DRM | itl_generic específico |
ITLI915 | itl_generic específico |
LIBDRM | específico de itl_generic |
MESA | itl_generic y nxp_imx8 específico |
Las siguientes variables de configuración se añaden de forma implícita y debes eliminarlas:
| Variable | Notas |
|---|---|
_WRS_CONFIG_EVDEV_OPTIMIZED_MODE | No aplicable |
_WRS_CONFIG_EVDEV_DISPLAY_POINT_TRANSLATE | No aplicable |
_WRS_CONFIG_MESA_MANGLE | itl_generic específico |
Debes añadir las siguientes variables a la configuración:
| Variable | Valor | Notas |
|---|---|---|
_WRS_CONFIG_RTP_SSP | y | No aplicable |
_WRS_CONFIG_RTP_STACK_PROTECTOR | y | No aplicable |
_WRS_CONFIG_MESA_GPUDEV_INTEL_GEN90 | y | Específico de itl_generic |
_WRS_CONFIG_EVDEV_COMPATIBLE_MODE | y | Necesario para que Qt funcione correctamente con una pantalla táctil. |
Ejemplo de configuración VIP para los BSP fsl_imx6 e itl_generic
Para obtener más detalles, consulta la documentación de WindRiver VxWorks.
| Paquete | Notas |
|---|---|
BUNDLE_POSIX | Este paquete es necesario para garantizar la compatibilidad con las funcionalidades relacionadas con POSIX que requiere Qt. |
BUNDLE_RTP_DEPLOY | No aplicable |
BUNDLE_RTP_DEVELOP | No aplicable |
BUNDLE_STANDALONE_SHELL | No aplicable |
| Componente | Notas |
|---|---|
INCLUDE_TMP_DIR INCLUDE_RAM_DISK_FORMAT_HRFS | Es necesario incluir estos dos componentes si desea utilizar QTemporaryFile. Tenga en cuenta que también debe considerar establecer TMP_DIR_SIZE en el valor adecuado |
DRV_AUDIO_FSL_SSI | No aplicable |
DRV_AUDIO_FSL_SGTL5000 | No aplicable |
DRV_FSL_SDHC_CTRL | No aplicable |
DRV_IMX_SDHC_CTRL | No aplicable |
INCLUDE_EHCI_INIT | No aplicable |
INCLUDE_FSL_IMX6Q_SABRELITE | No aplicable |
DRV_MMCSTORAGE_CARD | No aplicable |
DRV_SDSTORAGE_CARD | No aplicable |
INCLUDE_AUDIO_LIB_CORE | No aplicable |
INCLUDE_AUDIO_LIB_WAV | No aplicable |
INCLUDE_CUSTOM_ENTROPY_ADD | No aplicable |
INCLUDE_DEBUG_AGENT_START | No aplicable |
INCLUDE_DEFAULT_TIMEZONE | No aplicable |
INCLUDE_DISK_UTIL | No aplicable |
INCLUDE_DOSFS | No aplicable |
INCLUDE_DSAPARAM_CMD | No aplicable |
INCLUDE_END | No aplicable |
INCLUDE_EVDEV_LIB_CORE | No aplicable |
INCLUDE_EVDEV_LIB_KBD | No aplicable |
INCLUDE_EVDEV_LIB_KBD_MAP_US | No aplicable |
INCLUDE_EVDEV_LIB_PTR | No aplicable |
INCLUDE_EVDEV_LIB_TS | No aplicable |
INCLUDE_GENDSA_CMD | No aplicable |
INCLUDE_GENRSA_CMD | No aplicable |
INCLUDE_GETADDRINFO | No aplicable |
INCLUDE_GETNAMEINFO | No aplicable |
INCLUDE_HRFS | No aplicable |
INCLUDE_HRFS_ACCESS_TIMESTAMP | No aplicable |
INCLUDE_HRFS_FORMAT | No aplicable |
INCLUDE_HRFS_HISPEED_WRITE_MODE | No aplicable |
INCLUDE_IFCONFIG | No aplicable |
INCLUDE_IO_REALPATH | Este componente es necesario para habilitar el uso de la función realpath, necesaria para QFileInfo |
INCLUDE_IPATTACH | No aplicable |
INCLUDE_IPCOM_SYSLOGD_CMD | No aplicable |
INCLUDE_IPCOM_SYSVAR_CMD | No aplicable |
INCLUDE_IPCOM_USE_RAM_DISK | No aplicable |
INCLUDE_IPCOM_USE_TIME_CMD | No aplicable |
INCLUDE_IPDHCPC | No aplicable |
INCLUDE_IPDNSC | No aplicable |
INCLUDE_IPD_CMD | No aplicable |
INCLUDE_IPFTPC | No aplicable |
INCLUDE_IPFTP_CMD | No aplicable |
INCLUDE_IPIFCONFIG_CMD | No aplicable |
INCLUDE_IPNETSTAT_CMD | No aplicable |
INCLUDE_IPNSLOOKUP_CMD | No aplicable |
INCLUDE_IPPING_CMD | No aplicable |
INCLUDE_IPROUTE_CMD | No aplicable |
INCLUDE_IPTRACE_ROUTE_CMD | No aplicable |
INCLUDE_IPWRAP_GETHOSTBYADDR | No aplicable |
INCLUDE_IPWRAP_GETHOSTBYNAME | No aplicable |
INCLUDE_IPWRAP_GETNAMEINFO | No aplicable |
INCLUDE_IPWRAP_IFNAME | No aplicable |
INCLUDE_IPWRAP_ROUTECMD | No aplicable |
INCLUDE_MMAP | No aplicable |
INCLUDE_PING | No aplicable |
INCLUDE_PIPES | No aplicable |
INCLUDE_POSIX_MAPPED_FILES | No aplicable |
INCLUDE_POSIX_PIPES | No aplicable |
INCLUDE_POSIX_PTHREAD_SCHEDULER | No aplicable |
INCLUDE_POSIX_SHM | No aplicable |
INCLUDE_RAM_DISK | No aplicable |
INCLUDE_RAM_DISK_FORMAT_HRFS | No aplicable |
INCLUDE_RANDOM_NUM_GEN | No aplicable |
INCLUDE_ROMFS | No aplicable |
INCLUDE_ROUTECMD | No aplicable |
INCLUDE_SC_PIPE | No aplicable |
INCLUDE_SC_POSIX_PIPE | No aplicable |
INCLUDE_SD_BUS | No aplicable |
INCLUDE_SECURITY | No aplicable |
INCLUDE_SEC_KEY_STORE_CMD | No aplicable |
INCLUDE_SHELL | No aplicable |
INCLUDE_SSH | No aplicable |
INCLUDE_STANDALONE_SYM_TBL | No aplicable |
INCLUDE_STARTUP_SCRIPT | No aplicable |
INCLUDE_TMP_DIR | No aplicable |
INCLUDE_UN_COMP | No aplicable |
INCLUDE_USB_GEN2_KEYBOARD | No aplicable |
INCLUDE_USB_GEN2_MOUSE | No aplicable |
INCLUDE_USB_GEN2_STORAGE_INIT | No aplicable |
INCLUDE_USB_TOUCH_SCREEN | No aplicable |
INCLUDE_USB_TOUCH_SCREEN_INIT | No aplicable |
INCLUDE_USER_DATABASE | No aplicable |
INCLUDE_USER_IDENTIFICATION | No aplicable |
INCLUDE_VRFS | No aplicable |
INCLUDE_VXBUS_SHOW | No aplicable |
DRV_TOUCH_SCREEN_TI_TSC2004 | No aplicable |
DRV_TOUCH_SCREEN_EETI_EXC7200 | No aplicable |
INCLUDE_FBDEV_FSLIPU_0 | Específico de fsl_imx6 |
INCLUDE_FBDEV_SPLASH | No aplicable |
INCLUDE_GPUDEV_FSLVIV_API | Específico de fsl_imx6 |
INCLUDE_GPUDEV_FSLVIV_API_INIT | Específico de fsl_imx6 |
INCLUDE_GPUDEV_ITLGMC_2 | Específico de itl_generic |
INCLUDE_I915 | Específico de itl_generic |
INCLUDE_MESA_FBDEV | Específico de itl_generic |
INCLUDE_MESA_GPUDEV_DRI | Específico de itl_generic |
INCLUDE_MESA_GPUDEV_DRI_I965 | específico de itl_generic |
Los siguientes componentes se añaden de forma implícita y debes eliminarlos:
| Capa | Notas |
|---|---|
INCLUDE_FTP | No aplicable |
INCLUDE_SHELL_SECURITY | No aplicable |
Parámetros VIP
Debes añadir los siguientes parámetros para que Qt funcione correctamente en VxWorks:
| Parámetro | Valor de ejemplo | Notas |
|---|---|---|
SEC_VAULT_KEY_ENCRYPTING_PW | '"vxTarget"' | No aplicable |
UDB_STORAGE_PATH | '"/ram/vxUserDB.txt"' | No aplicable |
UDB_HASH_KEY | '"123456789"' | No aplicable |
UDB_HASH_KEY_LEN | 9 | Valor de ejemplo, véase el anterior |
FSLVIV_RTP_COMMAND_BUFFER_QUEUE | 32 | Para la arquitectura «arm» |
SYS_CLK_RATE | 100 | No aplicable |
RTP_PTHREAD_STACK_SIZE_DEFAULT | 262144 | Requerido para que funcionen los ejemplos de qtquick3d. Se puede anular con la variable de entorno PTHREAD_STACK_SIZE_DEFAULT. |
TMP_DIR_SIZE | 614400 | Valor mínimo para superar las pruebas internas de Qt Test |
NUM_FILES | 300 | No aplicable |
RTP_FD_NUM_MAX | 300 | No aplicable |
HRFS_DEFAULT_MAX_FILES | 300 | No aplicable |
ITLGMC_FBDEV_RESOLUTION_2 | '"1024x768-32"' | Valor de ejemplo para la pantalla táctil Xenarc 706TSA conectada mediante HDMI. |
RTP_MEM_FILL | True | Por defecto, el valor es « True » y debe mantenerse como « True » para que Qt funcione correctamente. |
Compilación de Qt 6 para VxWorks
Compilación en el host
Para realizar una compilación cruzada de Qt, es necesario disponer de una compilación en el sistema host. Esto se debe a que, durante la compilación, se invocan ciertas herramientas (como moc, rcc, qmlcachegen y qsb) desde la compilación en el sistema host. Dispones de las siguientes opciones:
- Compilación de los fuentes de Qt para el host,
- Instalar la compilación del host utilizando Qt Online Installer.
Sin embargo, es recomendable asegurarse de que también se pueda compilar Qt para el destino de escritorio en el host, ya que se necesitan las mismas herramientas a la hora de compilar para VxWorks.
Ejecución del script «configure»
Los comandos para configurar, compilar e instalar Qt 6 para el host son los siguientes:
./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 .Estos comandos instalan Qt 6 para el host en <path_to_Qt 6_host_installation_dir>.
Compilación de Qt 6 para el sistema de destino
Configuración del entorno de compilación
Antes de ejecutar «configure» y compilar Qt 6, debes abrir VxWorks Development Shell en la línea de comandos.
- 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>
Preparación del archivo personalizado de la cadena de herramientas de CMake
Para incluir las bibliotecas gráficas del BSP, primero debes crear un archivo de cadena de herramientas CMake. A continuación se muestra un ejemplo de archivo de cadena de herramientas CMake para el dispositivo BD-SL-i.MX6:
# Copyright (C) 2024 The Qt Company Ltd.
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)Un ejemplo para el Intel NUC6i3SYH:
# Copyright (C) 2024 The Qt Company Ltd.
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)Ejecución de «qt 6 configure» para el dispositivo de destino
A continuación se muestra un ejemplo de configuración de compilación para la BD-SL-i.MX6. Para la mayoría de las placas VxWorks, el comando «configure» es muy similar. Por defecto, Qt 6 está configurado para utilizar bibliotecas compartidas. Para compilar Qt 6 de forma estática, añade la opción « -static » a «configure».
Asegúrate de que la variable de entorno {WIND_CC_SYSROOT} esté establecida en el directorio raíz de VSB de VxWorks.
./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/VSB/mk/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> \Se recomienda compilar Qt 6 utilizando una compilación «shadow». Consulta las opciones de configuración de Qt para obtener más información.
Advertencia: Si VxWorks está configurado con RTP_MEM_FILL como «false», entonces el comando «configure» de Qt necesita un argumento adicional: « -DCMAKE_CXX_FLAGS="-DQT_RTP_MEM_FILL=1" ».
Tras la configuración, compila e instala Qt 6 para VxWorks con estos comandos:
cd <host build directory>
cmake --build . --parallel
cmake --install .Complementos de plataforma para dispositivos VxWorks
Qt para VxWorks es compatible con el complemento de plataforma EGLFS para la sustitución nativa de ventanas. Obtén más información sobre su configuración en EGLFS.
Compilación de aplicaciones Qt
Para compilar una aplicación Qt, debe establecer QT_VXWORKS_TOOLCHAIN_FILE como variable de entorno o como definición.
Un ejemplo para compilar la demostración de Qt «clocks»:
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.10.0/demos/clocks -B <path/to/build/directory>
cd <path/to/build/directory>
cmake --build . --parallelConfiguración de variables de entorno
| Variable | Descripción |
|---|---|
| QT_QPA_FONTDIR | Ruta a las fuentes. |
| QT_QPA_EGLFS_FB | Ruta al dispositivo de búfer de fotogramas. |
| LD_LIBRARY_PATH | Ruta a las bibliotecas dinámicas. |
| ICU_DATA | Ruta a los datos de ICU. |
| QT_QPA_EGLFS_INTEGRATION | Integración de Eglfs, eglfs_viv o eglfs_kms. |
| QT_QPA_EGLFS_KMS_CONFIG | Ruta a kms.conf. |
Nota: La caché de discode QML no funciona; desactívala con la siguiente variable para evitar que el inicio se ralentice: QML_DISABLE_DISK_CACHE.
Configure las variables de entorno en un script de inicio de la siguiente manera, por ejemplo:
putgenv("QT_QPA_FONTDIR=/bd0a/fonts")
putgenv("QT_QPA_EGLFS_FB=/dev/fb0")
putgenv("LD_LIBRARY_PATH=/bd0a/lib/gfx;/bd0a/lib/llvm;/bd0a/lib/icu")
putgenv("ICU_DATA=/bd0a/icu/icudt73l.dat")
putgenv("QT_QPA_EGLFS_INTEGRATION=eglfs_kms")
putgenv("QT_QPA_EGLFS_FB=/dev/fb0")
putgenv("QT_QPA_EGLFS_KMS_CONFIG=/bd0a/kms.conf")
putgenv("QML_DISABLE_DISK_CACHE=1")El archivo « kms.conf » para el dispositivo Intel KabyLake puede tener este aspecto, por ejemplo:
{
"device": "/dev/dri/card0",
"hwcursor": false,
"pbuffers": true,
"outputs": [
{
"name": "DP",
"mode": "1920x1080"
}
]
}Ejecución de aplicaciones Qt
El siguiente ejemplo muestra cómo iniciar una aplicación utilizando el comando « rtpSp » de VxWorks:
rtpSp("<Qt 6 VxWorks application>", 200, 0x100000, 0, 0x01000000)Depuración de aplicaciones Qt
Para depurar aplicaciones Qt, debe añadir lo siguiente a su VSB de VxWorks:
vxprj vsb config -s -add "_WRS_CONFIG_TCF_GDB_RSP=y"Añade lo siguiente a tu configuración VIP de VxWorks:
"INCLUDE_DEBUG_AGENT"
"INCLUDE_DEBUG_AGENT_START"
"INCLUDE_STANDALONE_SYM_TBL"Desde la línea de comandos
- Inicia la aplicación que deseas depurar en el dispositivo a través de SSH o de la conexión serie USB:
rtpSp("<Qt 6 VxWorks application>", 200, 0x100000, 0, 0x01000000) - Inicia el depurador de VxWorks en el PC:
vxgdb <binary to debug> - Muestra la lista de procesos en ejecución en el depurador:
monitor ps - Conecta el depurador a la aplicación que ya se está ejecutando:
"attach <id from monitor>" - Utiliza los comandos de GDB para la depuración.
De Qt Creator
Para depurar desde Qt Creator, consulta Qt Creator: Depuración de aplicaciones C++ en dispositivos VxWorks.
Desde Workbench
- Crea un proyecto CMake Real Time Process.

- Configura el VSB que tenga la depuración configurada.
- Elimina set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static") del archivo CMakeLists.txt.
- Añade el código de CMake relacionado con Qt al archivo CMakeLists.txt siguiendo la guía «Introducción a CMake».
- Antes de «
project()», añade «unset(CMAKE_TOOLCHAIN_FILE CACHE)» y añade «CMAKE_TOOLCHAIN_FILE» apuntando al archivo de la cadena de herramientas de Qt6 y «QT_CHAINLOAD_TOOLCHAIN_FILE» al archivo de la cadena de herramientas de VSB. Por ejemplo:unset(CMAKE_TOOLCHAIN_FILE CACHE) set(CMAKE_TOOLCHAIN_FILE "/home/qtuser/VxWorks/qt/target_gdb/lib/cmake/Qt6/qt.toolchain.cmake") set(QT_CHAINLOAD_TOOLCHAIN_FILE "/home/qtuser/VxWorks/fsl_imx6_2_0_6_2_VSB_gdb/mk/toolchain.cmake") - Compila el proyecto de la aplicación.
- Crea una nueva conexión.

- Inicia el proceso RTP para depurar.

- Haz clic en «Opciones avanzadas».

- Establece el tamaño de la pila en 0x100000.

Complementos de entrada de Qt para VxWorks
VxWorks utiliza su propia implementación de libevdev, que cuenta con una API muy similar a la de Linux, pero con diferencias en cuanto a sus capacidades. Por este motivo, Qt implementa complementos de entrada independientes para VxWorks que gestionan el ratón, el teclado y la pantalla táctil, basados en {inputs-linux-device.html}{Linux evdev}, con las diferencias que se explican a continuación.
VxMouse
VxMouse utiliza el mismo esquema de configuración que EvdevMouse, salvo por una variable de entorno diferente: QT_QPA_VXEVDEV_MOUSE_PARAMETERS. Además, VxMouse ignora los parámetros nocompress, dejitter y grab.
VxKeyboard
VxKeyboard utiliza el mismo esquema de configuración que EvdevKeyboard, salvo por una variable de entorno diferente: QT_QPA_VXEVDEV_KEYBOARD_PARAMETERS.
VxTouch
VxTouch utiliza el mismo esquema de configuración que EvdevTouch, salvo por unas variables de entorno diferentes:
QT_QPA_EVDEV_TOUCHSCREEN_PARAMETERSQT_QPA_VXEVDEV_DEBUG
Además, VxTouch añade dos nuevos parámetros:
| Parámetro | Descripción |
|---|---|
rangex=MIN_X,MAX_X | Anula los valores mínimo y máximo del punto táctil para el eje X |
rangey=MIN_Y,MAX_Y | Anula los valores mínimo y máximo del punto de contacto en el eje Y |
Limitaciones
Memoria de vídeo
Los sistemas con una cantidad fija de memoria de vídeo dedicada pueden requerir una atención especial antes de ejecutar aplicaciones Qt basadas en Qt Quick o en clases como QOpenGLWidget. La configuración predeterminada podría resultar insuficiente para este tipo de aplicaciones, especialmente cuando se muestran en una pantalla de alta resolución (por ejemplo, Full HD). En este caso, podrían empezar a fallar de forma inesperada. Por lo tanto, se recomienda asegurarse de que haya al menos 128 MB de memoria de GPU disponible. Para los sistemas que no tienen una cantidad fija de memoria reservada para la GPU, esto no supone ningún problema.
© 2026 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.