Phase Template: open-valve

Open a modulating control valve to a target position (0-100 %). It is the smallest useful phase in the library: a single-action building block for composing custom recipes one device move at a time, where a purpose-built phase like charge-reactor would be overkill.

Pair with close-valve and timed-wait to build an open → wait → close sequence out of three recipe steps.

Where to find it

System endpoint → Equipment Library → Phases → select open-valve.

graph TD
    Start([initial]) --> EX["execute<br/>target_valve.CMD := position"]
    EX --> Done([done])

See Phases for the diagram conventions.

What you see when it runs

Element	Meaning
Active step	execute — the phase completes as soon as the write is issued
Parameters	position resolved from the recipe formula
Bound modules	The concrete control-module instance the target_valve role resolved to

HMI screenshot pending

An annotated capture of a running open-valve phase will be added here.

Parameters

Parameter	Type	Unit	Range	Default	Required
position	REAL	%	0-100	—	yes

Required control modules

Role	Module type	Description
target_valve	analog-control	Valve to position

Capability: reaction.

How it works

The phase has a single execute step. It writes position to target_valve.CMD and the phase completes. There is no feedback wait. The analog-control module's own deviation alarm (DEV_ALARM) is the mechanism for catching a valve that doesn't follow the command.

The holding, stopping, aborting, and resetting charts all write 0 to target_valve.CMD. Any interruption therefore leaves the valve closed. The restarting chart reopens it to position.

This is a single-action phase. It cannot fail on its own terms, but it also verifies nothing. Pair with a deviation alarm on the valve, and prefer a purpose-built phase with feedback-gated transitions when the move matters to product quality.

Used in recipes

No shipped reference recipe uses this template. It is a building block for composing your own.

Try it

1. System endpoint → Recipes → create a draft recipe with a single step referencing open-valve on a unit whose target_valve role binds to an analog-control instance (e.g. r1-solvent-valve on reactor-1)
2. Approve and start it from HMI endpoint → Batch Execution
3. Open the bound valve's faceplate on the unit detail view and watch CMD and POS move to the commanded position

Modify this template

Want to clone this and adapt it for your own equipment? Walk through Adaptation Guide for the full clone → rebind → deploy → run workflow, and Parameter Binding to understand how recipe values flow through to control-module tags.