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.

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:
| NodeId | Función |
|---|---|
| ns=2;s=Machine | La carpeta que contiene los nodos de método y variable de la máquina |
| ns=2;s=Machine.State | El estado de la máquina |
| ns=2;s=Machine.Tank1.PercentFilled | El estado actual de llenado del primer depósito |
| ns=2;s=Machine.Tank2.PercentFilled | El estado actual de llenado del segundo depósito |
| ns=2;s=Machine.Tank2.TargetPercent | El valor de consigna para el bombeo y el lavado |
| ns=2;s=Machine.Tank2.ValveState | El estado de la válvula del segundo depósito |
| ns=2;s=Machine.Designation | Una designación legible para el usuario de la máquina, con fines de visualización |
| ns=2;s=Machine.Start | Llama a este método para poner en marcha la bomba |
| ns=2;s=Machine.Stop | Llame a este método para detener la bomba |
| ns=2;s=Machine.FlushTank2 | Llama a este método para vaciar el depósito 2 |
| ns=2;s=Machine.Reset | Llama 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.tank2valveStateUso
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.
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.