Qt Quick ウォーターポンプ

Qt Qml APIはQt 6.9で非推奨とされており、将来のバージョンで削除される予定です。

Qt Quick 「ウォーターポンプ」の例では、Qt OPC UA のQML APIを使用してOPC UAサーバーと連携し、単純な機械用のQMLベースのHMIを構築する方法を示しています。

サーバーの構築

「ウォーターポンプ」のサンプルを使用するには、まず「ウォーターポンプシミュレーションサーバー」をビルドする必要があります。QtCreatorで開いてビルドするか、通常通りターミナルからビルドすることができます。

シミュレーション

このサンプルに含まれるOPC UAサーバーは、2つのタンク、ウォーターポンプ、およびバルブを備えた機械のシミュレーションを実行します。 第1のタンクから第2のタンクへ水を汲み上げ、その後、バルブを開くことで第2のタンクから水を排出することができます。どちらの操作にも、第2のタンクへ汲み上げる量または排出する量を制御する、ユーザーが設定可能なセットポイントがあります。

サーバー上には以下のノードが存在します：

実装

この例では、値の読み書きやメソッド呼び出しに QML アイテムを使用しています。すべての操作は非同期であり、バックグラウンドで QML によって処理されます。

QML アイテムは、マシンとそのコンポーネントを表します。このアイテムにはグラフィカルなインターフェースはなく、マシンのプロパティへのアクセスのみを提供します。このマシンには 2 つのタンクがあり、それらは個別の `Tank ` コンポーネントのインスタンスです。

プロパティ

machineアイテムは、すべてのプロパティおよびサブアイテムをプロパティとして公開しています。

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

非同期ハンドラ

APIの非同期部分は、デフォルトでプロパティの変更ごとにシグナルが発行されるため、QMLによって自動的に処理されます。

たとえば、2番目のタンクをフラッシュするボタンは、バックエンドがサーバーに接続されており、機械がアイドル状態で、かつタンクのレベルが設定値を上回っている場合にのみ有効になります。クリックすると、サーバー上でflushTank2() メソッドが呼び出されます。

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

使用方法

サーバーは HMI アプリケーションによって自動的に起動されます。「Connect 」ボタンをクリックしてサーバーに接続した後、スライダーをドラッグして設定値を設定し、「Start 」をクリックして、第 1 タンクから第 2 タンクへの水の移送を開始します。第 2 タンクの現在の値よりも低い設定値を設定した後、「Flush 」をクリックすると、バルブが開きます。

水がなくなったら、「Reset simulation 」をクリックして第1タンクに水を補充してください。

サンプルプロジェクト @ code.qt.io