Skip to content

Maneuver

The Maneuver popup provides control actions for the selected object, such as switching between operating modes or setting manual values. It only appears in the Tab menu when the object has signals matching one or more of the configured suffix aliases for the Maneuver popup.

The popup comes in two variants, each with its own default suffix aliases: the Industry variant and the BMS variant. An object shows the variant whose suffix aliases match its signals.

Industry variant

Maneuver popup, Industry variant

The Industry variant (ManoverIndustry.kvie) is built for process equipment such as pumps and motors. In addition to switching mode, it lets the operator give a manual command and a manual setpoint, shows why an object cannot run, and can block an object. The rows it shows are:

  • Status — a card at the top showing the current state of the object.
  • Operating mode — switches the object between Auto and Manual.
  • Manual control — Off and On buttons for commanding the object by hand. They can only be used in Manual mode; until then the row reads "Select Manual to control".
  • Manual setpoint — the setpoint the operator sets by hand. It is greyed out while the object is in Auto or blocked.
  • Interlock — a text explaining why the object cannot run at the moment. It is shown in orange under Manual control, as "Interlock:" followed by the reason, and is absent when there is no interlock.
  • Blocking — blocks the object so that it does not run, in either Auto or Manual. The row shows whether the object is blocked. To block it, enter a cause and press Block; a cause must be entered. While the object is blocked the row shows Blocked, the cause, the user who set the block and the time, and the button changes to Unblock. Unblocking returns the object to the mode it had.
  • Status values — read-only values such as speed and power.

Blocking row of a blocked object

A control is enabled only when the user has the required privilege, the object is not blocked and, where a locking signal is configured, the object is in Manual.

The reason, the user and the time of each block are stored in the object_blocks table in the Config database.

Default suffix aliases

The following suffix aliases are configured for the Industry variant by default:

Suffix alias Suffix Writable Description
mode _MODE Yes Operating mode (Auto / Manual)
manualCommand _MANCMD Yes Manual control
manualSetpoint _MANSP Yes Manual setpoint
block _BLOCK Yes Blocking
interlock _ILKTXT No Interlock text
analogOutputValue _R No Analog output signal
isOpen _IO No Open state
RPM _RPM No Speed
Effekt _Effekt No Power

Note

The default suffix aliases can be modified and extended in Settings → Suffix → Suffix Alias - Popups. See Create Popup for more information.

BMS variant

Maneuver popup

This variant (ManoverBMS.kvie) is the layout used for building systems. It displays a Control section with the control actions available for the object. The layout depends on which suffix aliases are configured and which signals are present on the object. Typical elements include:

  • Mode buttons — buttons for switching between operating modes such as Auto, Off, and On. The currently active mode is indicated by a green status indicator above the corresponding button.
  • Status rows — read-only indicators showing the current state of a signal
  • Value rows — editable fields for entering manual values when a signal is configured as writable

Default suffix aliases

The following suffix aliases are configured for the BMS variant by default:

Suffix alias Suffix Writable Description
IO _IO Yes Off / On
manualControl _MAN Yes Manual control, digital output
manualControlAnalogOutput _MANA Yes Manual control, analog output
manualAnalogOutputValue _RMAN Yes Manual analog output signal
analogOutputValue _R No Analog output signal
commandOutput _M No Digital output signal
isOpen _IO No Open state
isClosed _IS No Closed state
isActive _IT No Active state
runningHours _DT No Running hours
runningHoursReset _DTA Yes Reset of running hours

Note

The default suffix aliases can be modified and extended in Settings → Suffix → Suffix Alias - Popups. See Create Popup for more information.