beautypg.com

1 programming interface definitions – Metrohm 846 Driver Toolbox User Manual

Page 26

background image

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)