Overview

Functions to query the actual pump status, flow and volume.

This groups defines all functions to read the actual pump status (pumping or stopped), the actual flow and volume from the device.

+ Collaboration diagram for Pump Status:

Functions

long LCP_GetDosedVolume (dev_hdl hPump, double *pDosedVolume)
 Get the already dosed volume. More...
 
long LCP_GetFillLevel (dev_hdl hPump, double *pFillLevel)
 Returns the actual fill level of the pump. More...
 
long LCP_GetFlowIs (dev_hdl hPump, double *pFlowRateIs)
 Read the actual flow rate. More...
 
long LCP_GetTargetVolume (dev_hdl hPump, double *pTargetVolume)
 Read the target volume. More...
 
long LCP_IsCalibrationFinished (dev_hdl hPump)
 Checks if calibration is finished. More...
 
long LCP_IsPositionSensingInitialized (dev_hdl hPump)
 Returns true, if the position sensing system is properly initialized. More...
 
long LCP_IsPumping (dev_hdl hPump)
 Check if device is currently stopped or dosing. More...
 

Function Documentation

long LCP_GetDosedVolume ( dev_hdl  hPump,
double *  pDosedVolume 
)

Get the already dosed volume.

Parameters
[in]hPumpA valid pump handle
[out]pDosedVolumeReturns the already dosed volume
Returns
Error code - ERR_NOERR indicates success
Examples:
capi_contiflow_test.cpp.
long LCP_GetFillLevel ( dev_hdl  hPump,
double *  pFillLevel 
)

Returns the actual fill level of the pump.

This function returns valid results only for pumps that support a fill level (eg. syringe pumps). Peristaltic pumps do not support fill level. For a syringe pump this function returns the current syringe fill level

Parameters
[in]hPumpA valid pump handle
[out]pFillLevelReturns the current fill level of the pump container (eg. syringe)
Returns
Error code - ERR_NOERR indicates success
Examples:
capi_nemesys_test.cpp, and capi_pressure_control_test.cpp.
long LCP_GetFlowIs ( dev_hdl  hPump,
double *  pFlowRateIs 
)

Read the actual flow rate.

Parameters
[in]hPumpA valid pump handle
[out]pFlowRateIsThe actual flow rate demand value
Returns
Error code - ERR_NOERR indicates success
Examples:
capi_contiflow_test.cpp, capi_nemesys_test.cpp, and capi_pressure_control_test.cpp.
long LCP_GetTargetVolume ( dev_hdl  hPump,
double *  pTargetVolume 
)

Read the target volume.

This function simply returns the set target volume value

Parameters
[in]hPumpA valid pump handle
[out]pTargetVolumeReturns the target volume to dose
Returns
Error code - ERR_NOERR indicates success
long LCP_IsCalibrationFinished ( dev_hdl  hPump)

Checks if calibration is finished.

The pump handle given in hPump param needs to be a syringe pump handle

Parameters
[in]hPumpA valid pump handle
Return values
0- Device is calibrating
1- Device calibration has finished
<0- Error code
See also
LCP_SyringePumpCalibrate()
Examples:
capi_contiflow_test.cpp, and capi_nemesys_test.cpp.
long LCP_IsPositionSensingInitialized ( dev_hdl  hPump)

Returns true, if the position sensing system is properly initialized.

Each pump drive tracks the actual position value (volume value) by an internal position counter / encoder. Some pumps, such as the new Nemesys S and Nemesys M pumps, have an absolute encoder. That means, this encoder always keeps its position, even if the pumps are turned of. For these pumps this function always returns true. Other pumps, like the Nemesys Low Pressure Pump, have an incremental encoder. This encoder loses its position if the pump power is turned off. That means, if such a pump gets powered on, the this function returns false, because the position of the incremental encoder is not initialized yet. To initialize the position of the encoder, you need to do a reference move via LCP_SyringePumpCalibrate() or you need to restore a previously saved encoder position via LCP_RestoreDrivePosCnt().

Parameters
[in]hPumpA valid pump handle
Return values
1Position sensing is initialized and you can start dosing
0Position sensor needs to get initialized via LCP_SyringePumpCalibrate() or by restoring a saved position via LCP_RestoreDrivePosCnt().
<0Error - negative error code
See also
LCP_SyringePumpCalibrate(), LCP_RestoreDrivePosCnt()
Examples:
capi_nemesys4_test.cpp, and Pump_CAPI_Init.cpp.
long LCP_IsPumping ( dev_hdl  hPump)

Check if device is currently stopped or dosing.

Parameters
[in]hPumpA valid pump handle
Return values
1- Device is pumping
0- Device is stopped
<0- Error code
Examples:
capi_contiflow_test.cpp, capi_nemesys_test.cpp, and capi_pressure_control_test.cpp.