En esta página

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 QtNotas
Qt CoreNo se admite « QProcess ». « QLocalSocket » y « QLocalServer » solo admiten «SOCK_SEQPACKET».
Qt GUINo aplicable
Qt NetworkNo aplicable
Qt QmlNo aplicable
Qt QuickNo aplicable
Qt Quick ControlesNo aplicable
Qt Quick Cuadros de diálogoNo aplicable
Qt Quick DiseñosNo aplicable
Qt Quick PruebaNo aplicable
Qt TestNo aplicable
Qt WidgetsNo 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.

FuncionalidadNotas
DSI_DSI_KERNELNo aplicable
IPNET_COREIPNo aplicable
IPNET_DHCPCNo aplicable
SDMMC_DEVICENo aplicable
SDMMC_HOSTNo aplicable
SDMMC_SDHCNo aplicable
SDMMC_STORAGENo aplicable
SERVICE_UNNo aplicable
SOCKETNo aplicable
USB_EHCINo aplicable
USB_KEYBOARDNo aplicable
USB_MOUSENo aplicable
USB_STORAGENo aplicable
USB_TOUCHSCREENNo aplicable
EVDEVNo aplicable
EVDEV_LIBNo aplicable
EVDEV_TI_TSC2004_TSNo aplicable
EVDEV_EETI_EXC7200_TSNo aplicable
AUDIONo aplicable
GPUDEV_FSLVIVGPUEspecífico de fsl_imx6
HASHNo aplicable
OPENSSLNo aplicable
RANDOM_ENTROPY_INJECTNo aplicable
IPNET_SSHNo aplicable
USER_MANAGEMENTNo aplicable
ICUNo aplicable
DRMitl_generic específico
ITLI915itl_generic específico
LIBDRMespecífico de itl_generic
MESAitl_generic y nxp_imx8 específico

Las siguientes variables de configuración se añaden de forma implícita y debes eliminarlas:

VariableNotas
_WRS_CONFIG_EVDEV_OPTIMIZED_MODENo aplicable
_WRS_CONFIG_EVDEV_DISPLAY_POINT_TRANSLATENo aplicable
_WRS_CONFIG_MESA_MANGLEitl_generic específico

Debes añadir las siguientes variables a la configuración:

VariableValorNotas
_WRS_CONFIG_RTP_SSPyNo aplicable
_WRS_CONFIG_RTP_STACK_PROTECTORyNo aplicable
_WRS_CONFIG_MESA_GPUDEV_INTEL_GEN90yEspecífico de itl_generic
_WRS_CONFIG_EVDEV_COMPATIBLE_MODEyNecesario 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.

PaqueteNotas
BUNDLE_POSIXEste paquete es necesario para garantizar la compatibilidad con las funcionalidades relacionadas con POSIX que requiere Qt.
BUNDLE_RTP_DEPLOYNo aplicable
BUNDLE_RTP_DEVELOPNo aplicable
BUNDLE_STANDALONE_SHELLNo aplicable
ComponenteNotas
INCLUDE_TMP_DIR INCLUDE_RAM_DISK_FORMAT_HRFSEs 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_SSINo aplicable
DRV_AUDIO_FSL_SGTL5000No aplicable
DRV_FSL_SDHC_CTRLNo aplicable
DRV_IMX_SDHC_CTRLNo aplicable
INCLUDE_EHCI_INITNo aplicable
INCLUDE_FSL_IMX6Q_SABRELITENo aplicable
DRV_MMCSTORAGE_CARDNo aplicable
DRV_SDSTORAGE_CARDNo aplicable
INCLUDE_AUDIO_LIB_CORENo aplicable
INCLUDE_AUDIO_LIB_WAVNo aplicable
INCLUDE_CUSTOM_ENTROPY_ADDNo aplicable
INCLUDE_DEBUG_AGENT_STARTNo aplicable
INCLUDE_DEFAULT_TIMEZONENo aplicable
INCLUDE_DISK_UTILNo aplicable
INCLUDE_DOSFSNo aplicable
INCLUDE_DSAPARAM_CMDNo aplicable
INCLUDE_ENDNo aplicable
INCLUDE_EVDEV_LIB_CORENo aplicable
INCLUDE_EVDEV_LIB_KBDNo aplicable
INCLUDE_EVDEV_LIB_KBD_MAP_USNo aplicable
INCLUDE_EVDEV_LIB_PTRNo aplicable
INCLUDE_EVDEV_LIB_TSNo aplicable
INCLUDE_GENDSA_CMDNo aplicable
INCLUDE_GENRSA_CMDNo aplicable
INCLUDE_GETADDRINFONo aplicable
INCLUDE_GETNAMEINFONo aplicable
INCLUDE_HRFSNo aplicable
INCLUDE_HRFS_ACCESS_TIMESTAMPNo aplicable
INCLUDE_HRFS_FORMATNo aplicable
INCLUDE_HRFS_HISPEED_WRITE_MODENo aplicable
INCLUDE_IFCONFIGNo aplicable
INCLUDE_IO_REALPATHEste componente es necesario para habilitar el uso de la función realpath, necesaria para QFileInfo
INCLUDE_IPATTACHNo aplicable
INCLUDE_IPCOM_SYSLOGD_CMDNo aplicable
INCLUDE_IPCOM_SYSVAR_CMDNo aplicable
INCLUDE_IPCOM_USE_RAM_DISKNo aplicable
INCLUDE_IPCOM_USE_TIME_CMDNo aplicable
INCLUDE_IPDHCPCNo aplicable
INCLUDE_IPDNSCNo aplicable
INCLUDE_IPD_CMDNo aplicable
INCLUDE_IPFTPCNo aplicable
INCLUDE_IPFTP_CMDNo aplicable
INCLUDE_IPIFCONFIG_CMDNo aplicable
INCLUDE_IPNETSTAT_CMDNo aplicable
INCLUDE_IPNSLOOKUP_CMDNo aplicable
INCLUDE_IPPING_CMDNo aplicable
INCLUDE_IPROUTE_CMDNo aplicable
INCLUDE_IPTRACE_ROUTE_CMDNo aplicable
INCLUDE_IPWRAP_GETHOSTBYADDRNo aplicable
INCLUDE_IPWRAP_GETHOSTBYNAMENo aplicable
INCLUDE_IPWRAP_GETNAMEINFONo aplicable
INCLUDE_IPWRAP_IFNAMENo aplicable
INCLUDE_IPWRAP_ROUTECMDNo aplicable
INCLUDE_MMAPNo aplicable
INCLUDE_PINGNo aplicable
INCLUDE_PIPESNo aplicable
INCLUDE_POSIX_MAPPED_FILESNo aplicable
INCLUDE_POSIX_PIPESNo aplicable
INCLUDE_POSIX_PTHREAD_SCHEDULERNo aplicable
INCLUDE_POSIX_SHMNo aplicable
INCLUDE_RAM_DISKNo aplicable
INCLUDE_RAM_DISK_FORMAT_HRFSNo aplicable
INCLUDE_RANDOM_NUM_GENNo aplicable
INCLUDE_ROMFSNo aplicable
INCLUDE_ROUTECMDNo aplicable
INCLUDE_SC_PIPENo aplicable
INCLUDE_SC_POSIX_PIPENo aplicable
INCLUDE_SD_BUSNo aplicable
INCLUDE_SECURITYNo aplicable
INCLUDE_SEC_KEY_STORE_CMDNo aplicable
INCLUDE_SHELLNo aplicable
INCLUDE_SSHNo aplicable
INCLUDE_STANDALONE_SYM_TBLNo aplicable
INCLUDE_STARTUP_SCRIPTNo aplicable
INCLUDE_TMP_DIRNo aplicable
INCLUDE_UN_COMPNo aplicable
INCLUDE_USB_GEN2_KEYBOARDNo aplicable
INCLUDE_USB_GEN2_MOUSENo aplicable
INCLUDE_USB_GEN2_STORAGE_INITNo aplicable
INCLUDE_USB_TOUCH_SCREENNo aplicable
INCLUDE_USB_TOUCH_SCREEN_INITNo aplicable
INCLUDE_USER_DATABASENo aplicable
INCLUDE_USER_IDENTIFICATIONNo aplicable
INCLUDE_VRFSNo aplicable
INCLUDE_VXBUS_SHOWNo aplicable
DRV_TOUCH_SCREEN_TI_TSC2004No aplicable
DRV_TOUCH_SCREEN_EETI_EXC7200No aplicable
INCLUDE_FBDEV_FSLIPU_0Específico de fsl_imx6
INCLUDE_FBDEV_SPLASHNo aplicable
INCLUDE_GPUDEV_FSLVIV_APIEspecífico de fsl_imx6
INCLUDE_GPUDEV_FSLVIV_API_INITEspecífico de fsl_imx6
INCLUDE_GPUDEV_ITLGMC_2Específico de itl_generic
INCLUDE_I915Específico de itl_generic
INCLUDE_MESA_FBDEVEspecífico de itl_generic
INCLUDE_MESA_GPUDEV_DRIEspecífico de itl_generic
INCLUDE_MESA_GPUDEV_DRI_I965específico de itl_generic

Los siguientes componentes se añaden de forma implícita y debes eliminarlos:

CapaNotas
INCLUDE_FTPNo aplicable
INCLUDE_SHELL_SECURITYNo aplicable
Parámetros VIP

Debes añadir los siguientes parámetros para que Qt funcione correctamente en VxWorks:

ParámetroValor de ejemploNotas
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_LEN9Valor de ejemplo, véase el anterior
FSLVIV_RTP_COMMAND_BUFFER_QUEUE32Para la arquitectura «arm»
SYS_CLK_RATE100No aplicable
RTP_PTHREAD_STACK_SIZE_DEFAULT262144Requerido para que funcionen los ejemplos de qtquick3d. Se puede anular con la variable de entorno PTHREAD_STACK_SIZE_DEFAULT.
TMP_DIR_SIZE614400Valor mínimo para superar las pruebas internas de Qt Test
NUM_FILES300No aplicable
RTP_FD_NUM_MAX300No aplicable
HRFS_DEFAULT_MAX_FILES300No aplicable
ITLGMC_FBDEV_RESOLUTION_2'"1024x768-32"'Valor de ejemplo para la pantalla táctil Xenarc 706TSA conectada mediante HDMI.
RTP_MEM_FILLTruePor 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:

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 . --parallel

Configuración de variables de entorno

VariableDescripción
QT_QPA_FONTDIRRuta a las fuentes.
QT_QPA_EGLFS_FBRuta al dispositivo de búfer de fotogramas.
LD_LIBRARY_PATHRuta a las bibliotecas dinámicas.
ICU_DATARuta a los datos de ICU.
QT_QPA_EGLFS_INTEGRATIONIntegración de Eglfs, eglfs_viv o eglfs_kms.
QT_QPA_EGLFS_KMS_CONFIGRuta 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

  1. 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)
  2. Inicia el depurador de VxWorks en el PC:
    vxgdb <binary to debug>
  3. Muestra la lista de procesos en ejecución en el depurador:
    monitor ps
  4. Conecta el depurador a la aplicación que ya se está ejecutando:
    "attach <id from monitor>"
  5. 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

  1. Crea un proyecto CMake Real Time Process.

    Seleccionar el proyecto CMake RTP

  2. Configura el VSB que tenga la depuración configurada.
  3. Elimina set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static") del archivo CMakeLists.txt.
  4. Añade el código de CMake relacionado con Qt al archivo CMakeLists.txt siguiendo la guía «Introducción a CMake».
  5. 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")
  6. Compila el proyecto de la aplicación.
  7. Crea una nueva conexión.

    Conexión al dispositivo

  8. Inicia el proceso RTP para depurar.

    Selecciona «Ejecutar/Depurar proceso en tiempo real»

  9. Haz clic en «Opciones avanzadas».

    Configuración de ejecución

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

    Configuración avanzada

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_PARAMETERS
  • QT_QPA_VXEVDEV_DEBUG

Además, VxTouch añade dos nuevos parámetros:

ParámetroDescripción
rangex=MIN_X,MAX_XAnula los valores mínimo y máximo del punto táctil para el eje X
rangey=MIN_Y,MAX_YAnula 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.