En esta página

Qt Quick Bomba de agua

Interacción con un servidor OPC UA para crear una interfaz hombre-máquina (HMI) basada en QML para una bomba de agua sencilla.

La API de Qml se ha marcado como obsoleta en Qt 6.9 y se eliminará en una versión futura.

Qt Quick El ejemplo«Bomba de agua» muestra cómo utilizar una API QML de Qt OPC UA para interactuar con un servidor OPC UA y crear una interfaz HMI basada en QML para una máquina sencilla.

Aplicación de una bomba de agua con dos depósitos, controles de la bomba y panel de estado

Compilación del servidor

Antes de poder utilizar los ejemplos de la bomba de agua, debes compilar el servidor de simulación de la bomba de agua. Puedes abrirlo y compilarlo en QtCreator o desde la terminal, como de costumbre.

La simulación

El servidor OPC UA incluido en este ejemplo ejecuta una simulación de una máquina que contiene dos depósitos, una bomba de agua y una válvula. El agua se puede bombear del primer depósito al segundo y, a continuación, se puede vaciar del segundo depósito abriendo la válvula. Ambas operaciones tienen un punto de consigna configurable por el usuario que controla la cantidad de agua que se bombea al segundo depósito o que se vacía de él.

En el servidor existen los siguientes nodos:

NodeIdFunción
ns=2;s=MachineLa carpeta que contiene los nodos de método y variable de la máquina
ns=2;s=Machine.StateEl estado de la máquina
ns=2;s=Machine.Tank1.PercentFilledEl estado actual de llenado del primer depósito
ns=2;s=Machine.Tank2.PercentFilledEl estado actual de llenado del segundo depósito
ns=2;s=Machine.Tank2.TargetPercentEl valor de consigna para el bombeo y el lavado
ns=2;s=Machine.Tank2.ValveStateEl estado de la válvula del segundo depósito
ns=2;s=Machine.DesignationUna designación legible para el usuario de la máquina, con fines de visualización
ns=2;s=Machine.StartLlama a este método para poner en marcha la bomba
ns=2;s=Machine.StopLlame a este método para detener la bomba
ns=2;s=Machine.FlushTank2Llama a este método para vaciar el depósito 2
ns=2;s=Machine.ResetLlama a este método para reiniciar la simulación

Implementación

Este ejemplo utiliza elementos QML para leer y escribir valores, así como para realizar llamadas a métodos. Todas las operaciones son asíncronas y QML se encarga de gestionarlas en segundo plano.

Un elemento QML representa la máquina y sus componentes. Este elemento no tiene ninguna interfaz gráfica y solo proporciona acceso a las propiedades de la máquina. Cuenta con dos depósitos que son instancias de un componente independiente de « Tank ».

Propiedades

El elemento «machine» expone todas las propiedades y subelementos como propiedades.

    ...
    readonly property alias tank1: tank1
    readonly property alias tank2: tank2
    readonly property alias state: machineState.value
    readonly property alias tank2PercentFilled: tank2.percentFilled
    readonly property alias tank2valveState: tank2.valveState
    readonly property alias designation: designation.value
    property alias resetMethod: resetMethod
    property alias startMethod: startMethod
    property alias stopMethod: stopMethod
    property alias flushMethod: flushMethod
    ...
Manejadores asíncronos

Las partes asíncronas de la API son gestionadas automáticamente por QML, ya que, por defecto, se emiten señales ante cada cambio de propiedad.

Por ejemplo, el botón para vaciar el segundo depósito solo está habilitado si el backend está conectado al servidor, la máquina está inactiva y el nivel del depósito está por encima del punto de consigna. Al hacer clic, se llama al método flushTank2() en el servidor.

    Tank2Unit {
        flushButtonEnabled: connection.connected && machine.state === Machine.MachineState.Idle
                            && machine.tank2.percentFilled > machine.tank2.targetPercent
        percentFilled: machine.tank2.percentFilled
        valveState: machine.tank2valveState

Uso

La aplicación HMI inicia el servidor automáticamente. Tras conectarse al servidor haciendo clic en el botón « Connect », arrastre el control deslizante para establecer un valor de consigna y, a continuación, haga clic en « Start » para comenzar a bombear agua del primer depósito al segundo. Tras establecer un valor de consigna inferior al valor actual del segundo depósito, al hacer clic en « Flush » se abre la válvula.

Si no queda agua, haz clic en « Reset simulation » para rellenar el primer depósito.

Proyecto de ejemplo en code.qt.io

Véase también Bomba de agua.

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