Qmix SDK  20200506
The software libraries for integration of all CETONI devices.
Valve Control and Status

Overview

This groups defines all functions for control of valves and for reading valve status.

+ Collaboration diagram for Valve Control and Status:

Functions

LCV_Func long LCV_CALL LCV_ActualValvePosition (dev_hdl hValve)
 Returns the actual logical valve position. More...
 
LCV_Func long LCV_CALL LCV_NumberOfValvePositions (dev_hdl hValve)
 Returns the number of valve positions. More...
 
LCV_Func long LCV_CALL LCV_SwitchValveToPosition (dev_hdl hValve, int LogicalValvePosition)
 Switches the valve to a certain logical valve position. More...
 

Function Documentation

◆ LCV_ActualValvePosition()

LCV_Func long LCV_CALL LCV_ActualValvePosition ( dev_hdl  hValve)

Returns the actual logical valve position.

Each valve position is identified by a logical valve position identifier from 0 - number of valve positions - 1. This function returns the logical valve position identifier for the current valve position.

Parameters
[in]hValveValid valve handle
Return values
>=0Actual valve position index.
<0Error code
See also
LCV_SwitchValveToPosition()
Examples:
capi_nemesys_test.cpp, and capi_nemesys_valve_test.cpp.

◆ LCV_NumberOfValvePositions()

LCV_Func long LCV_CALL LCV_NumberOfValvePositions ( dev_hdl  hValve)

Returns the number of valve positions.

Each valve has a number of available valve positions. I.e. a switching valve has two positions or a rotation valve can have 4 or even more positions.

Parameters
[in]hValveValid valve handle
Return values
>0Number of valve positions
<=0Error code
Examples:
capi_nemesys_test.cpp, and capi_nemesys_valve_test.cpp.

◆ LCV_SwitchValveToPosition()

LCV_Func long LCV_CALL LCV_SwitchValveToPosition ( dev_hdl  hValve,
int  LogicalValvePosition 
)

Switches the valve to a certain logical valve position.

Note
For some devices, like rotation valves, it may last some hundred milliseconds until device reached its final position.
Parameters
[in]hValveValid valve handle
[in]LogicalValvePositionLogical valve target position index.
Return values
ERR_NOERRindicates success
See also
LCV_ActualValvePosition();
Examples:
capi_nemesys_test.cpp, and capi_nemesys_valve_test.cpp.