1 programming interface definitions – Metrohm 846 Driver Toolbox User Manual
Page 26

3.1 Programming interface definitions
22
Dosing Interface USB Toolbox, Annex
* Move the piston to an absolute position. The full stroke of the piston is subdivided in
10000 positions.
*
* @param ifNo Dosing Interface [1... ?]
* @param msbNo Dosino at MSB [1... 4]
* @param position absolut Position [0...10000]
* @param rate Dosing rate [0.01... 166 mL/min]
* @throws DosIntFace846Exception
*/
public static final void goPos(int ifNo, int msbNo, int position, float rate) throws
DosIntFace846Exception{
int nReturnstate = DosIntFace846.callGoPos(ifNo, msbNo, position, rate);
if (nReturnstate != 0)
throw new DosInt-
Face846Exception(DosIntFace846Exception.getErrorString(nReturnstate), nReturnstate);
}
/**
* Move piston to the mechanical end position.
* This function can be used to remove any air bubbles from the cylinder.
*
* @param ifNo Dosing Interface [1... ?]
* @param msbNo Dosino at MSB [1... 4]
* @param fwdRate Dosing rate [0.01... 166 mL/min]
* @throws DosIntFace846Exception
*/
public static final void duToEnd(int ifNo, int msbNo, float fwdRate) throws DosInt-
Face846Exception{
int nReturnstate = DosIntFace846.callToEnd(ifNo, msbNo, fwdRate);
if (nReturnstate != 0)
throw new DosInt-
Face846Exception(DosIntFace846Exception.getErrorString(nReturnstate), nReturnstate);
}
/**
* Dose a specified volume via the actual port. Dosing rate, filling rate, filling port
and piston direction can be chosen.
* With reverse piston direction it is possible to aspirate a desired volume. In this case
the filling port is used as outlet port.
* The dosing can be hold, continued and stopped.
*
* @param ifNo Dosing Interface [1... ?]
* @param msbNo Dosino at MSB [1... 4]
* @param fillPort Filling port [1...4]
* @param volume Dosing volume [0... 99999.99 mL]
* @param direction Direction of piston movement [eDirection]
* @param fwdRate Dosing rate [0.01... 166 mL/min]
* @param revRate Filling rate [0.01... 166 mL/min]
* @throws DosIntFace846Exception
*/
public static final void duMakeStep(int ifNo, int msbNo, int fillPort, float volume, int
direction, float fwdRate, float revRate) throws DosIntFace846Exception{
int nReturnstate = DosIntFace846.callMakeStep(ifNo, msbNo, fillPort, volume, direc-
tion, fwdRate, revRate);
if (nReturnstate != 0)
throw new DosInt-
Face846Exception(DosIntFace846Exception.getErrorString(nReturnstate), nReturnstate);
}
/**
* Fill the cylinder from a specified port.
* Filling can be held and continued, but not stopped.
*
* @param ifNo Dosing Interface [1... ?]
* @param msbNo Dosino at MSB [1... 4]
* @param port Fill port [1..4]
* @param revRate Filling rate [0.01... 166 mL/min]
* @throws DosIntFace846Exception
*/
public static final void duFill(int ifNo, int msbNo, int port, float revRate) throws
DosIntFace846Exception{
int nReturnstate = DosIntFace846.callFill(ifNo, msbNo, port, revRate);
if (nReturnstate != 0)