UT_VALVE_3POS — Three-position valve (diverter or open/mid/closed)

For actuators with three positions:

• 3-way diverters: A / closed / B,
• spring-centred double-solenoid valves and cylinders (centre = both coils off),
• three-coil valves (one coil per position),
• motorised valves with a mid position (mid limit switch or timed).

Mode, safe position, protections and stroke count work exactly as
UT_VALVE (UT_VALVE_CORE).

Pins

Record UT_VALVE3_DATA (pin Pos3)

In the valve record Data: reversalDelay (T#500ms, motor: pause before driving the
other way), the modes, protections, cmdOpen / cmdClose / cmdStop / cmdReset
and the status.

cmdStop stops a motorised valve where it is (Hand). Faults use the shared bits:
a move toward a higher position that times out is openTimeout (bit 0), toward a
lower one closeTimeout (bit 1); two limits on → bit 2; position lost → bit 3.
lastOpenStroke / lastCloseStroke are the last measured moves up / down
(on a limit). position is 0 / 50 / 100 at positions 1 / 2 / 3.

How it works

• A motor going 1 ↔ 3 passes 2 without stopping.
• Motor to 2 with Ls2: from 1 it drives up, from 3 down, from an unknown
  position down; if it reaches end 1 first it turns round (reversal pause) and
  drives up to Ls2.
• Motor to 2 without Ls2: from a known end it runs midTime toward the
  middle; from an unknown position it first goes to end 1 (re-sync), then runs
  midTime up.
• A limit that drops again within the travel time is a flicker: the valve
  carries on. At most two legs per move, then a timeout.
• Power-up: the position comes from the limits, no false fault. Hand stays put;
  Off goes to safePos3; Auto goes to AutoPos.

Status

statusCode, faultId and statusText say the one main thing the valve is
doing, or what holds it back, so a technician can see on the HMI why it is not where
it was asked to be. The most important reason wins: configuration > fault > held /
waiting > warning > position > Off. The words hold no numbers: the target and the position are in targetPos and actualPos. The time left
(travel, a pause, a fault's recover / retry wait) is in timeLeft. The text is
rebuilt only when the status or the fault changes. Where the valve is (the rows
marked (this block)) comes from the block's last scan, so it shows one scan after
it changes. The numbers are in conventions.

<fault> is faultId, one of: UT_F_OPEN_TIMEOUT (open timeout) · UT_F_CLOSE_TIMEOUT (close timeout) · UT_F_BOTH_LIMITS (both limits) · UT_F_POS_LOST (position lost) · UT_F_NO_MOVEMENT (did not move) · UT_F_ACTUATOR (actuator fault).
<setting> with UT_ST_WARN_SETTING is one of: UT_F_SAVE_EVERY (save every) · UT_F_RETRY_WINDOW (retry window) · UT_F_MODE_SOURCE (mode source) · UT_F_SAFE_POSITION (safe position, must be 1..3); with UT_ST_CONFIG one of: UT_F_THREE_POS_TYPE (three-position type) · UT_F_MID_TIME (travel / mid time) · UT_F_REVERSAL_DELAY (reversal delay).

Bad settings

A setting that is not a number, negative or unknown never drives the valve somewhere
it could do damage. configBad is set and faultCode bit 8, and faultId names the
setting (the lowest priority). A negative saveEvery keeps nothing; a negative retryWindow
uses the default 1 h; an unknown modeSource uses the HMI (warnings).

• Refused (a fault, every output off): an unknown type3; a negative travelTime,
  midTime or reversalDelay.
• Warning: safePos3 outside 1..3 (2 is used).