Appearance
Multi-Port Valve
A smart-object symbol for a 3-way or 4-way valve, showing which ports are currently connected.
In Studio
In Studio, double-click Multi-Port Valve in the Process category of the Components panel. It is added to the open view, where you can drag it into place.
When to use
Use Multi-Port Valve for a diverter or selector valve with more than two ports — a standard Valve's single-stem body cannot represent more than two connections.
Properties
| Property | Type | Default | Description |
|---|---|---|---|
| Value | String | (none) | The overall device state — same Closed/Open/Fault contract as Valve's Value, used for the whole-symbol paint on Fault or when there is no live data. |
| Flow Path | String | (none) | Which ports are currently connected, as any text naming their port letters (e.g. AB, A,B, A/B all mean ports A and B are connected). A port named in Flow Path renders in the open color; every other port renders in the closed color. A value that names no known port renders every port closed, and an open valve with no named port is captioned NO PATH. A closed valve draws every port closed whatever Flow Path says. |
| Ports | 3, 4 | 3 | Number of ports: 3 (default) or 4. |
| Orientation (stem port) | down, right, up, left | down | Which way the stem port (C) points: down (as drawn, default), right, up, or left. The whole valve turns; the caption stays upright. |
| Label | String | Valve | The caption shown below the symbol. |
| Show Caption | true, false | true | Shows or hides the caption (the name and state word) under the symbol. Off also gives that height back to the drawing — use it when a separate label template sits beside the symbol. |
| Closed Color | Color | #808080 | The color for a port not on the current flow path. Defaults to the HMI palette's stopped-state color. |
| Open Color | Color | #FFFFFF | The color for a port on the current flow path. Defaults to the HMI palette's running-state color. |
| Fault Color | Color | #E12D39 | The whole-symbol color on Fault. Defaults to the HMI palette's priority-1 alarm color. |
| Quality Mark | standard, dim | standard | How a lost link is marked when a value this component shows has Stale or Bad quality. standard (the default) draws the quality outline and glyph over the value. dim keeps the last good value on screen, faded, with nothing drawn over it: it suits a dense panel where one lost link turns a whole column Bad. The value still reads as not live, and a binding that fails to evaluate keeps its outline either way. |
Binding
Click Bind… on the Value property and bind it to a tag or an expression to drive the live value.
This binding is read-only — the component never writes to the tag.
Flow Path is a second, independent binding — see that field. Per-port coloring only applies while the overall state is Closed or Open; a Fault or no-data state paints the whole symbol instead of per-port, since neither state has a trustworthy flow path.